From 2083b177d408627f79858ff82f21439756e9214c Mon Sep 17 00:00:00 2001 From: nishaaaaaant Date: Mon, 25 Mar 2024 13:20:42 -0400 Subject: [PATCH] #1867 fix markdown violation on installtion.md --- docs/guides/installation.md | 92 ++++++++++++++++++------------------- 1 file changed, 44 insertions(+), 48 deletions(-) diff --git a/docs/guides/installation.md b/docs/guides/installation.md index 0f241a81e2..42c91c0957 100644 --- a/docs/guides/installation.md +++ b/docs/guides/installation.md @@ -13,19 +13,17 @@ This is a detailed guide for installing a 64-bit version of the Rocky Linux dist Download the ISO to use for this installation of Rocky Linux. You can download the latest ISO image for the version of Rocky Linux for this installation here: -``` -https://www.rockylinux.org/download/ -``` + To download the ISO directly from the command line on an existing Linux based system use the `wget` command: -``` +```bash wget https://download.rockylinux.org/pub/rocky/9/isos/x86_64/Rocky-9.3-x86_64-minimal.iso ``` Rocky Linux ISOs follow this naming convention: -``` +```text Rocky-.--.iso ``` @@ -43,19 +41,19 @@ If you've downloaded the Rocky Linux ISO(s) on an existing Linux distribution, y 1. While still in the folder that contains the downloaded Rocky Linux ISO, download the checksum file for the ISO, type: - ``` + ```bash wget -O CHECKSUM https://download.rockylinux.org/pub/rocky/9.3/isos/x86_64/CHECKSUM ``` 1. Use the `sha256sum` utility to verify the integrity of the ISO file against corruption or tampering. - ``` + ```bash sha256sum -c CHECKSUM --ignore-missing ``` - + This checks the integrity of the ISO file downloaded previously, provided that it is in the same directory. The output should show: - ``` + ```text Rocky-9.3-x86_64-minimal.iso: OK ``` @@ -69,22 +67,22 @@ If the computer is setup to boot from the media that has the ISO file, we can be 1. Insert and boot from the installation medium (optical disk, USB flash drive, and so on). -1. Once the computer has booted you see the Rocky Linux 9 welcome splash screen. +2. Once the computer has booted you see the Rocky Linux 9 welcome splash screen. ![Rocky Linux installation splash screen](images/install_9_3_01.png) -1. If you do not press any key, the installation program starts a countdown, after which the installation process automatically executes the default, highlighted, option: +3. If you do not press any key, the installation program starts a countdown, after which the installation process automatically executes the default, highlighted, option: `Test this media & install Rocky Linux 9.3` - You can also press Enter at any time to start the process immediately. + You can also press ++enter++ at any time to start the process immediately. -1. A quick media verification step takes place. +4. A quick media verification step takes place. This media verification step can save you the trouble of starting the installation only to find out halfway through that the installation program has to stop because of bad installation media. -1. After the media check runs to completion and the media is successfully verified to be usable, the installation program automatically continues to the next screen. +5. After the media check runs to completion and the media is successfully verified to be usable, the installation program automatically continues to the next screen. -1. Select the language you want to use to perform the installation in this screen. For this guide, we select *English (United States)*. Then click the Continue button. +6. Select the language you want to use to perform the installation in this screen. For this guide, we select *English (United States)*. Then click the ++"continue"++ button. ## Installation Summary @@ -92,7 +90,7 @@ The *Installation Summary* screen is an all-in-one area where you make the impor The screen is roughly divided into the following sections: -- *LOCALIZATION* +- *LOCALIZATION* - *SOFTWARE* - *SYSTEM* - *USER SETTINGS* @@ -107,23 +105,23 @@ This section is used for customizing items related to the geographic locality of On our demo system in this guide, we accept the default value (*English US*) and make no changes. -However, if you need to make any changes here, from the *Installation Summary* screen, click the Keyboard option to specify the keyboard layout of the system. Using the + button, you can add additional keyboard layouts if you need to in the ensuing screen and even specify your preferred order. +However, if you need to make any changes here, from the *Installation Summary* screen, click the ++"keyboard"++ option to specify the keyboard layout of the system. Using the ++plus++ button, you can add additional keyboard layouts if you need to in the ensuing screen and even specify your preferred order. -Click Done when you are finished with this screen. +Click ++"done"++ when you are finished with this screen. #### Language Support -The Language Support option on the *Installation Summary* screen enables you to specify support for additional languages. +The `Language Support` option on the *Installation Summary* screen enables you to specify support for additional languages. -We will accept the default value - **English (United States)** and make no change, click Done. +We will accept the default value - **English (United States)** and make no change, click ++"done"++. #### Time & Date -Click the Time & Date option on the main *Installation Summary* screen to bring up another screen that will allow you to select the time zone in which the machine is located. Scroll through the list of regions and cities and select the area closest to you. +Click the ++"Time & Date"++ option on the main *Installation Summary* screen to bring up another screen that will allow you to select the time zone in which the machine is located. Scroll through the list of regions and cities and select the area closest to you. -Depending on your installation source, the *Network Time* option could be set to *ON* or *OFF* by default. Accept the default *ON* setting; this allows the system to automatically set the correct time using the Network Time Protocol (NTP). +Depending on your installation source, the *Network Time* option could be set to *ON* or *OFF* by default. Accept the default *ON* setting; this allows the system to automatically set the correct time using the Network Time Protocol (NTP). -Click Done after making any changes. +Click ++"done"++ after making any changes. ### Software Section @@ -139,14 +137,14 @@ Because the installation uses a Rocky Linux 9 ISO image, you will notice that *L #### Software Selection -Clicking the Software Selection option on the main *Installation Summary* screen presents you with the section of the installation where you can pick the exact software packages that get installed on the system. The software selection area is divided into: +Clicking the ++"Software Selection"++ option on the main *Installation Summary* screen presents you with the section of the installation where you can pick the exact software packages that get installed on the system. The software selection area is divided into: - **Base Environment**: Minimal Install and Custom operating system - **Additional software for Selected Environment**: Selecting a Base Environment on the left side presents a variety of related additional software to install for the given environment on the right side. Note that this is only applicable if you were installing from a full Rocky Linux 9.2 DVD or if you have additional repositories configured. Select the *Minimal Install* (Basic functionality) option. -Click Done at the top of the screen. +Click ++"done"++ at the top of the screen. ### System Section @@ -154,15 +152,15 @@ The System section of the *Installation Summary* screen is used for customizing #### Installation Destination -From the *Installation Summary* screen, click the Installation Destination option. This takes you to the corresponding task area. +From the *Installation Summary* screen, click the ++"Installation Destination"++ option. This takes you to the corresponding task area. You will see a screen displaying all the candidate disk drives that you have available on the target system. If you have only one disk drive on the system, as on our sample system, you see the drive listed under *Local Standard Disks* with a check mark beside it. Clicking the disk icon will toggle on or off the disk selection check mark. Keep it checked to select the disk. Under the *Storage Configuration* section: -1. Select the Automatic radio button. +1. Select the ++"Automatic"++ radio button. -2. Click Done at the top of the screen. +2. Click ++"done"++ at the top of the screen. 3. Once the installation program determines that you have a usable disk, it returns to the *Installation Summary* screen. @@ -172,11 +170,11 @@ The next important task of the installation procedure under the System area deal !!! Note - After you click on the Network & Hostname option, all correctly detected network interface hardware (such as Ethernet, wireless network cards, and so on) will be listed in the left pane of the network configuration screen. Depending on your specific hardware setup, Ethernet devices in Linux have names similar to `eth0`, `eth1`, `ens3`, `ens4`, `em1`, `em2`, `p1p1`, `enp0s3` and so on. + After you click on the ++"Network & Hostname"++ option, all correctly detected network interface hardware (such as Ethernet, wireless network cards, and so on) will be listed in the left pane of the network configuration screen. Depending on your specific hardware setup, Ethernet devices in Linux have names similar to `eth0`, `eth1`, `ens3`, `ens4`, `em1`, `em2`, `p1p1`, `enp0s3` and so on. For each interface, you can either configure it using DHCP or manually set the IP address. If you choose to configure manually, be sure to have all the required information ready, such as the IP address, netmask, and so on. -Clicking the Network & Hostname button in the main *Installation Summary* screen opens the corresponding configuration screen. Among other things, you have the option to configure the hostname of the system. +Clicking the ++"Network & Hostname"++ button in the main *Installation Summary* screen opens the corresponding configuration screen. Among other things, you have the option to configure the hostname of the system. !!! Note @@ -195,7 +193,7 @@ The configurable properties of the selected network adapter appear in the right Verify the switch of the device you want to configure is flipped to the `ON` (blue) position in the right pane. We'll accept all the defaults in this section. -Click Done to return to the main *Installation Summary* screen. +Click ++"done"++ to return to the main *Installation Summary* screen. !!! Warning @@ -210,15 +208,14 @@ This section can be used for creating a password for the `root` user account and 1. Click the *Root Password* field under *User Settings* to start the *Root Password* task screen. !!! Warning - - The root superuser is the most privileged account on the system. Therefore, if you choose to use or enable it, it is crucial that you protect this account with a strong password. -1. In the *Root Password* text box, set a strong password for the root user. + The root superuser is the most privileged account on the system. Therefore, if you choose to use or enable it, it is crucial that you protect this account with a strong password. -1. Enter the same password again in the *Confirm* text box. +2. In the *Root Password* text box, set a strong password for the root user. -1. Click Done. +3. Enter the same password again in the *Confirm* text box. +4. Click ++"done"++. #### User Creation @@ -228,15 +225,15 @@ To create a user: This task area allows you to create a privileged or non-privileged (non-administrative) user account on the system. !!! Info - + Creating and using a non-privileged account for day-to-day tasks on a system is a good system administration practice. We’ll create a regular user that can invoke superuser (administrator) powers when needed. -1. Complete the fields in the *Create User* screen with the following information: - +2. Complete the fields in the *Create User* screen with the following information: + - **Full name**: - `rockstar` + `rockstar` - **Username**: `rockstar` - **Make this user administrator**: @@ -248,18 +245,17 @@ This task area allows you to create a privileged or non-privileged (non-administ - **Confirm password**: `04302021` -1. Click Done. +3. Click ++"done"++. ## Installer Phase Once you are satisfied with your choices for the various installation tasks, the next phase of the installation process will begin the installation proper. - ### Start the Installation -Once you are satisfied with your choices for the various installation tasks, click the Begin Installation button on the main *Installation Summary* screen. +Once you are satisfied with your choices for the various installation tasks, click the ++"Begin Installation"++ button on the main *Installation Summary* screen. -The installation will begin, and the installation program will show the progress of the installation. +The installation will begin, and the installation program will show the progress of the installation. After the installation begins, various tasks will begin running in the background, such as partitioning the disk, formatting the partitions or LVM volumes, checking for and resolving software dependencies, writing the operating system to the disk, and so on. !!! Note @@ -270,7 +266,7 @@ After the installation begins, various tasks will begin running in the backgroun After the installation program has run its course, you see a final installation progress screen with a complete message. -Finally, complete the entire procedure by clicking the Reboot System button. The system restarts. +Finally, complete the entire procedure by clicking the ++"Reboot System"++ button. The system restarts. ### Log In @@ -280,11 +276,11 @@ The system is now set up and ready for use. You will see the Rocky Linux console To log onto the system: -1. Type `rockstar` at the login prompt and press Enter. +1. Type `rockstar` at the login prompt and press ++enter++. -1. At the Password prompt, type `04302021` (rockstar’s password) and press Enter (the password will ***not*** be echoed to the screen, that is normal). +2. At the Password prompt, type `04302021` (rockstar’s password) and press ++enter++ (the password will ***not*** be echoed to the screen, that is normal). -1. Run the `whoami` command after login. +3. Run the `whoami` command after login. This command shows the name of the currently logged in user. ![Login Screen](images/installation_9.0_F03.png)