Skip to content

Commit

Permalink
docs(idrac-os): added document for installing operating system using …
Browse files Browse the repository at this point in the history
…remote file share

Signed-off-by: sakethanne <[email protected]>
  • Loading branch information
Sakethanne authored and glimchb committed Nov 5, 2024
1 parent e5f876a commit 8287511
Show file tree
Hide file tree
Showing 7 changed files with 92 additions and 2 deletions.
89 changes: 89 additions & 0 deletions idrac_os_installation_steps_network.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
# OS Installation using iDRAC9 Web Interface using Remote File Share

This outlines the detailed steps to install an Operating System(OS) on a server using Dell’s iDRAC9 web interface using the Remote File Sharing method.

## Prerequisites

1. **iDRAC Login Credentials**: Ensure you have access to iDRAC9, incase you do not have the credentials, ask in the [OPI Slack group](https://join.slack.com/t/opi-project/shared_invite/zt-1ctqtrgkz-WJZrcVPp3P1ACZWjpZP2KQ).
2. **OS ISO File**: The Operating System ISO image should be available on the Network or a Remote File System and be accessible to the iDRAC system. The current Ubuntu ISO we are using is available at: `http://172.22.0.1/ubuntu-22.04.5-live-server-amd64.iso`.
3. **VPN Access**: Confirm you have a VPN connection to ensure, you can connect to the server's iDRAC interface.
4. **Supported Browsers**: Use the latest version of a supported web browser for the best experience (e.g., Chrome).

### Reference Documentation

- **Dell iDRAC9 User Guide**: [Dell iDRAC9 Documentation](https://dl.dell.com/topicspdf/44010ug_en-us.pdf)
- **Dell OS Deployment Overview**: [Dell iDRAC9 OS Deployment](https://www.dell.com/support/kbdoc/en-us/000130160/how-to-install-the-operating-system-on-a-dell-poweredge-server-os-deployment)
- **Dell iDRAC9 Remote File Sharing**: [Dell iDRAC9 Remote File Sharing OS Deployment](9_3.36.36.36_ug/deploying-operating-system-using-remote-file-share?guid=guid-fc3ef4b3-061f-44cf-b1a0-67861c7c1928&lang=en-us)

## Step-by-Step Guide

### Step 1: Access iDRAC9 Web Interface

1. Connect to the F5 VPN.
2. Open a web browser and enter the iDRAC IP address in the address bar. For example: `https://<iDRAC_IP>`.
3. Log in using the iDRAC credentials.

![Step 1 - Access iDRAC9](./images/os-install/dell/Login.png)

### Step 2: Connect the Remote File Sharing to iDRAC

1. Once you are successfully logged in to iDRAC console, Under configuration, go to **Virtual Media**.
2. Scroll down to go to **Remote File Share 1** or **Remote File Share 2**
3. Under **Remote File Share** fill out the details regarding the ISO file, like its path/address, username, password, SSL certificate (only the address is mandatory, rest are dependednt on the File Sharing system setup)
4. Once you have successfully filled out the parameters, click on connect and you will be able to see if iDRAC is able to connect or not.
5. Incase iDRAC is not able to access the ISO file, it shows an error to enter the correct details.

![Step 2.1 - Configuration / Virtual Media](./images/os-install/dell/VirtualMediaConsole.png)

![Step 2.2 - Remote File Share](./images/os-install/dell/RemoteShare.png)

![Step 2.3 - Remote File Share Success](./images/os-install/dell/RemoteSuccess.png)

![Step 2.4 - Remote File Share Error](./images/os-install/dell/RemoteError.png)

### Step 3: Launch the Virtual Console

1. From the iDRAC dashboard, navigate and launch the **Virtual Console** from the bottom right of the iDRAC dashboard and ensure you have the browser popups turned on.
2. This will open a new window with the server's user interface, and a couple of controls.

![Step 3 - Launch Virtual Console](./images/os-install/dell/Console.png)

### Step 4: Configure Boot Settings

1. In the Virtual Console window, select **Boot** from the top menu bar.
2. Under the **Boot Controls**, set the virtual CD/DVD drive as the primary boot option. This ensures that the server boots from the mounted OS ISO.

![Step 4 - Configure Boot Settings](./images/os-install/dell/BootOrder.png)

### Step 5: Reboot the Server

1. In the Virtual Console window, select **Power** from the top menu bar.
2. Select **Reset System (warm reboot)**.
3. Confirm the reboot by clicking **OK**.

![Step 5 - Reboot the Server](./images/os-install/dell/Reboot.png)

### Step 6: Boot into the OS Installer

1. During the server boot, monitor the Virtual Console window.
2. Once the server starts, it should boot into the mounted OS ISO and display the OS installation menu.

![Step 6 - Boot into OS Installer](./images/os-install/dell/OSBoot.png)

### Step 7: Follow the OS Installation Steps

1. Follow the on-screen prompts to proceed with the OS installation:

- select all default options (unless otherwise noted below).
- on disk setup: disable LVM.
- on network setup: select `DHCP` for network settings.
- on profile setup: use `opi` as the name, servername, username, and password for example purposes.
- Donot install additional packages or software like Docker or databases.
- on SSH setup: enable `install OpenSSH server`.

Detailed steps are also available [here](https://github.com/opiproject/lab/blob/main/server-setup.md).

2. Once the OS is installed, remember to **disconnect** the network file share by going into the **Virtual Media console** as mentioned in Step 2 and under **Remote File Share**, click **Disconnect**.
3. Reboot the System.

![Step 7 - OS Installation Steps](./images/os-install/dell/Installation.png)
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# OS Installation using iDRAC9 Web Interface

This outlines the detailed steps to install an Operating System(OS) on a server using Dell’s iDRAC9 web interface.
This outlines the detailed steps to install an Operating System(OS) on a server using Dell’s iDRAC9 web interface using the Virtual Media (file on your local machine).

## Prerequisites

Expand Down
Binary file added images/os-install/dell/RemoteError.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/os-install/dell/RemoteShare.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/os-install/dell/RemoteSuccess.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/os-install/dell/VirtualMediaConsole.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion server-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,8 @@ ansible-playbook -i inventory site.yml

## Manual

For more details on iDRAC Virtual media installation see [here](idrac_os_installation_steps.md)
For more details on iDRAC OS Installation using Virtual media installation see [here](idrac_os_installation_steps_virtual_media.md)
For more details on iDRAC OS Installation using Virtual media installation see [here](idrac_os_installation_steps_network.md)

* Install Ubuntu[^1] 22.04 x64 on the server. ([ubuntu-22.04.1-live-server-amd64.iso](https://releases.ubuntu.com/22.04/))
* select all default options (unless otherwise noted bellow)
Expand Down

0 comments on commit 8287511

Please sign in to comment.