Skip to content

Commit 64a5ae3

Browse files
andrewlukoshkoandrewlukoshko
authored
Merge pull request #804 from yuravk/elevate-cockpit-docs
elevate: move Cockpit Web UI report steps to quickstart guide
2 parents a5d4d4a + f6771b1 commit 64a5ae3

5 files changed

Lines changed: 51 additions & 25 deletions

File tree

docs/.vuepress/public/images/ELevateNGCockpitUI.webp renamed to docs/.vuepress/public/images/ELevateCockpitUI.webp

File renamed without changes.

‎docs/elevate/ELevate-NG-testing-guide.md‎

Lines changed: 5 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -267,6 +267,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
267267
In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
268268
:::
269269

270+
:::tip
271+
You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
272+
:::
273+
270274
- The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems:
271275

272276
```bash
@@ -388,10 +392,6 @@ After these preparations are completed, you can upgrade your AlmaLinux 9 machine
388392
These steps can also be used to perform the upgrade from CentOS Stream 9 to CentOS Stream 10. The only difference is the `leapp-data` package.
389393
:::
390394

391-
:::tip
392-
Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` extension (see the optional steps below) to inspect the upgrade report in a browser.
393-
:::
394-
395395
- Install ELevate NG version repo config for AlmaLinux 9:
396396

397397
```bash
@@ -419,24 +419,6 @@ Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` ex
419419

420420
:::
421421

422-
- Install Cockpit and Leapp in-place upgrade Cockpit UI packages (optional):
423-
424-
```bash
425-
sudo yum install -y cockpit cockpit-leapp
426-
```
427-
428-
- Start the Cockpit Web Service Socket, if not running (optional):
429-
430-
```bash
431-
sudo systemctl start cockpit.socket
432-
```
433-
434-
- Log into Cockpit Web UI at `http://<your_ip_address>:9090`.
435-
436-
:::tip
437-
Make sure the 9090 port is accessible.
438-
:::
439-
440422
- Start a preupgrade check. In the meanwhile, the Leapp utility creates a special _/var/log/leapp/leapp-report.txt_ file that contains possible problems and recommended solutions. No rpm packages will be installed at this phase.
441423

442424
:::warning
@@ -456,9 +438,7 @@ Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` ex
456438
:::
457439

458440
:::tip
459-
If you installed the `cockpit-leapp` UI extension, you can review the preupgrade report directly in the Cockpit Web UI, as shown below:
460-
461-
![Cockpit Web UI showing the Leapp preupgrade report](/images/ELevateNGCockpitUI.webp)
441+
You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
462442
:::
463443

464444
- Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 Beta goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0 Beta, please check the [known issues](#known-issues) section.

‎docs/elevate/ELevate-quickstart-guide.md‎

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -135,6 +135,36 @@ sudo curl -o /etc/yum.repos.d/CentOS-Base.repo https://el7.repo.almalinux.org/ce
135135
cat /var/log/leapp/leapp-upgrade.log
136136
```
137137
138+
## Inspecting the upgrade report in Cockpit Web UI
139+
140+
Optionally, you can install the Cockpit Web UI along with the `cockpit-leapp` extension to inspect the Leapp upgrade report in a browser instead of reading _/var/log/leapp/leapp-report.txt_ directly.
141+
142+
:::tip
143+
Cockpit is available when upgrading from AlmaLinux 8 or AlmaLinux 9.
144+
:::
145+
146+
- Install Cockpit and the Leapp in-place upgrade Cockpit UI packages:
147+
148+
```bash
149+
sudo yum install -y cockpit cockpit-leapp
150+
```
151+
152+
- Start the Cockpit Web Service Socket, if not running:
153+
154+
```bash
155+
sudo systemctl start cockpit.socket
156+
```
157+
158+
- Log into Cockpit Web UI at `http://<your_ip_address>:9090`.
159+
160+
:::tip
161+
Make sure the 9090 port is accessible.
162+
:::
163+
164+
- After running `leapp preupgrade`, you can review the preupgrade report directly in the Cockpit Web UI, as shown below:
165+
166+
![Cockpit Web UI showing the Leapp preupgrade report](/images/ELevateCockpitUI.webp)
167+
138168
### Demo Video
139169
140170
Here we have provided a demo of a CentOS 7.x to AlmaLinux 8.x upgrade using the AlmaLinux ELevate Project.

‎docs/elevate/ELevate-testing-guide.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -232,6 +232,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
232232
In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
233233
:::
234234

235+
:::tip
236+
You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
237+
:::
238+
235239
- The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems:
236240

237241
```bash
@@ -413,6 +417,10 @@ The only difference is the `leapp-data` package.
413417
In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
414418
:::
415419
420+
:::tip
421+
You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
422+
:::
423+
416424
- Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0, please check the [known issues](#known-issues) section.
417425
418426
:::tip

‎docs/elevate/ELevating-CentOS7-to-AlmaLinux-10.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -224,6 +224,10 @@ When successfully upgraded to AlmaLinux 8 OS, consider performing these steps to
224224
In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
225225
:::
226226

227+
:::tip
228+
You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
229+
:::
230+
227231
- The following fixes from _the /var/log/leapp/leapp-report.txt_ file are the most popular fixes for RHEL8-based operating systems:
228232

229233
```bash
@@ -400,6 +404,10 @@ The only difference is the `leapp-data` package.
400404
In certain configurations, Leapp generates _/var/log/leapp/answerfile_ with true/false questions. Leapp utility requires answers to all these questions in order to proceed with the upgrade.
401405
:::
402406
407+
:::tip
408+
You can also inspect the upgrade report in the Cockpit Web UI. See [Inspecting the upgrade report in Cockpit Web UI](/elevate/ELevate-quickstart-guide#inspecting-the-upgrade-report-in-cockpit-web-ui).
409+
:::
410+
403411
- Currently, the direct upgrade from Almalinux OS 9 to AlmaLinux OS 10.0 goes smoothly. If there is a progressive upgrade from CentOS 7 to AlmaLinux OS 10.0, please check the [known issues](#known-issues) section.
404412
405413
:::tip

0 commit comments

Comments
 (0)