Chapter 14. Starting a remote installation by using the Remote Desktop Protocol


You can start remote installation by using the Remote Desktop Protocol.

14.1. Performing a remote RHEL installation with an RDP client

You can perform a remote RHEL installation by using an RDP client directly connecting to the target system that is being installed with RHEL. The system with the RDP viewer is referred to as the remote system. You are prompted by the RHEL installation program to initiate the connection from the RDP viewer on the remote system to the target system.

Note

You can use a RDP client of your choice (such as GNOME Connections). Specific instructions for other viewers might differ, but the general principles apply.

Prerequisite

  • You have installed a RDP viewer on a remote system as a root user.

Procedure

  1. From the RHEL boot menu on the target system, press the e key on your keyboard to edit the boot options.
  2. Append the inst.rdp option to the end of the command line.

    You can also use the inst.rdp.username and inst.rdp.password boot options to set the RDP credentials. For example,

    inst.rdp inst.rdp.username=my_username inst.rdp.password=my_password
  3. Press CTRL+X or F10 to start the installation. The target system initializes the installation program and starts the necessary services. When the system is ready, a message is displayed providing the IP address of the system.
  4. Provide username and password details, if not provided earlier by using the boot options.
  5. Open the RDP viewer on the remote system.
  6. Enter the IP address into the RDP server field.
  7. Click Connect.
  8. Enter the RDP username and password and click OK.

    A new window opens with the RDP connection established, displaying the RHEL installation menu. From this window, you can install RHEL on the target system by using the graphical user interface.

14.2. Performing a remote RHEL installation by using RDP on IBM Z

After the Initial Program Load (IPL) of the Anaconda installation program is complete, connect to the 64-bit IBM Z system from a local machine, as an install user by using an ssh connection. You need to connect to the installation system to continue the installation process. Use the RDP mode to run a GUI-based installation or use the established connection to run a text mode installation.

Prerequisite

  • You booted the installation media
  • The initial program boot is complete on the 64-bit IBM Z system, and the command prompt displays:
Starting installer, one moment…
Please ssh install@my-z-system (system ip address) to begin the install.

You can set the RDP username and password by using the inst.rdp.username and inst.rdp.password boot parameters.

Procedure

From a local machine, run the steps below to set up a remote connection with the 64-bit IBM Z system.

  1. On the command prompt, run the following command:

    $ssh install@_my-z-system-domain-name_

    or

    $ssh install@_my-z-system-IP-address_
  2. Depending on whether or not have you configured the inst.rdp parameter, the ssh session displays the following output:

    1. When just the inst.rdp parameter is configured:

      Starting installer, one moment...
      RDP Username and Password
      Please provide RDP user name & password.
      You will have to type the password twice.

      After entering the username and password, the network address for RDP client access will be shown:

    2. When just the inst.rdp, inst.rdp.username and inst.rdp.password parameters are configured:

      The network address is shown:

      GNOME remote desktop RDP IP: _system-ip-address_
      GNOME remote desktop RDP host name: _system-host-name_
    3. When inst.rdp parameter is not configured:

      Starting installer, one moment...
      Graphical installation is not available. Starting text mode.
      =============
      Text mode provides a limited set of installation options.
      It does not offer custom partitioning for full control
      over the disk layout. Would you like to use remote graphical access via the RDP protocol instead?
      1) Use graphical mode via Remote Desktop Protocol
      2) Use text mode
      Please make your choice from above ['q' to quit | 'c' to continue | 'r' to refresh]:

      If you have configured the inst.rdp parameter, proceed to step 4.

  3. Enter 1 to start RDP.
  4. Enter RDP username and password, if you have not set these values previously via inst.rdp.username and inst.rdp.password boot options.
  5. Use an RDP client to connect to the provided network address.

You will be asked to provide the username and password you have set in the previous steps.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.