Applies to SUSE Linux Enterprise Desktop 15 SP5

7 Remote installation #

The installation of SUSE® Linux Enterprise Desktop can be performed entirely over the network. This chapter describes how to provide the required environment for booting, installing and controlling the installation via the network.

7.1 Overview #

For a remote installation you need to consider how to boot, how to control the installation, and the source of the installation data. All available options can be combined with each other, if they are available for your hardware platform.

Boot method: Depending on the hardware, several options for booting a system exist. Common options are DVD, USB drive or PXE boot. For more information about your platform, refer to Part I, “Installation preparation”.
Data source: Most commonly, DVDs or USB drives are used as a source for installing SUSE Linux Enterprise Desktop. Alternatively, installation servers can be used. In this case, use the install boot parameter to specify the source. For details, refer to Section 3.3.3, “Specifying the installation source”.
Installation methods: Instead of using a keyboard and monitor directly attached to the target machine, the installation can be performed via SSH, VNC, or by using the serial console of a machine. This is described in the sections Section 7.3, “Monitoring installation via VNC”, Section 7.4, “Monitoring installation via SSH” and Section 7.5, “Installation via serial console”.

7.2 Scenarios for remote installation #

This section introduces the most common installation scenarios for remote installations. For each scenario, carefully check the list of prerequisites and follow the procedure outlined for that scenario. If in need of detailed instructions for a particular step, follow the links provided for each one of them.

7.2.1 Installation from source media via VNC #

This type of installation still requires some degree of physical access to the target system to boot for installation. The installation is controlled by a remote workstation using VNC to connect to the installation program. User interaction is required as with the manual installation in Chapter 4, Installation steps.

For this type of installation, make sure that the following requirements are met.

Target system with a working network connection.
Controlling system with a working network connection and VNC viewer software or JavaScript-enabled browser (Firefox, Chromium, Internet Explorer, Opera, etc.).
Installation DVD or USB flash drive.

To perform this kind of installation, proceed as follows:

Boot the target system using the installation medium (USB flash drive) of the SUSE Linux Enterprise Desktop media kit.
When the boot screen of the target system appears, use the boot parameters prompt to set the VNC options and static network configuration, if required. For information about boot parameters, see Chapter 3, Boot parameters.
1. Boot parameters for a static network configuration:
```
netdevice=NETDEVICE hostip=IP_ADDRESS netmask=NETMASK gateway=IP_GATEWAY vnc=1 VNCPassword=PASSWORD
```
2. Boot parameters for a dynamic (DHCP) network configuration:
```
vnc=1 VNCPassword=PASSWORD
```
The target system boots to a text-based environment and shows the network address and display number. VNC installations announce themselves over OpenSLP, provided the firewall settings are configured appropriately. They can be found using slptool as described in Section 7.3.1, “Preparing for VNC installation”.
On the controlling workstation, open a VNC viewer or Web browser and connect to the target system using the provided network address and display number as described in Section 7.3, “Monitoring installation via VNC”.
Perform the installation as described in Chapter 4, Installation steps.

7.2.2 Network installation using VNC #

This type of installation does not require a direct interaction with the target machine. The system is booted via PXE and the installation data is fetched from a server.

To perform this type of installation, make sure that the following requirements are met.

At least one machine that can be used for installing a DHCP, NFS, HTTP, FTP, TFTP, or SMB server.
Target system capable of PXE boot, networking, and Wake on LAN, plugged in and connected to the network.
Controlling system with a working network connection and VNC viewer software or JavaScript-enabled browser (Firefox, Chromium, Microsoft Edge, Opera, etc.).

To perform this type of installation, proceed as follows.

Set up the server that contains the installation data.
Set up a DHCP and TFTP server for the network. Add the required boot parameters to enable the VNC server.
Enable PXE boot in the target machine firmware.
Initiate the boot process of the target system using Wake on LAN.
On the controlling workstation, open a VNC viewing application or Web browser and connect to the target system.
Perform the installation as described in Chapter 4, Installation steps.

7.2.3 Installation from source media via SSH #

This type of installation still requires some degree of physical access to the target system to boot for installation and to determine the IP address of the installation target. The installation itself is entirely controlled from a remote workstation using SSH to connect to the installer. User interaction is required as with the regular installation described in Chapter 4, Installation steps.

For this type of installation, make sure that the following requirements are met.

Target system with working network connection.
Controlling system with working network connection and working SSH client software.
Installation DVD or USB flash drive.

To perform this kind of installation, proceed as follows:

Set up the installation target and installation server.
Boot the target system using the installation medium (USB flash drive) of the SUSE Linux Enterprise Desktop media kit.
When the boot screen of the target system appears, use the boot parameters prompt to set the SSH options and, if required, the static network configuration. For information about boot parameters, see Chapter 3, Boot parameters.
1. Boot parameters for a static network configuration:
```
netdevice=NETDEVICE hostip=IP_ADDRESS netmask=NETMASK gateway=IP_GATEWAY ssh=1 ssh.password=PASSWORD
```
2. Boot parameters for a dynamic (DHCP) network configuration:
```
ssh=1 ssh.password=PASSWORD
```
The target system boots to a text-based environment, giving the network address under which the graphical installation environment can be addressed by any SSH client.
On the controlling workstation, open a terminal window and connect to the target system as described in Section 7.4.2, “Connecting to the installation program”.
Perform the installation as described in Chapter 4, Installation steps.

7.2.4 Installation from network via SSH #

This type of installation does not require a direct interaction with the target machine. The system is booted via PXE and the installation data is fetched from a server.

To perform this type of installation, make sure that the following requirements are met:

At least one machine that can be used for installing a DHCP, NFS, HTTP, FTP, TFTP, or SMB server.
Target system capable of PXE boot, networking, and Wake on LAN, plugged in and connected to the network.
Controlling system with working network connection and SSH viewer software.

To perform this type of installation, proceed as follows.

Set up the server that contains the installation data.
Set up a DHCP and TFTP server for the network. Add the required boot parameters to enable the SSH server.
Enable PXE boot in the target machine firmware.
Initiate the boot process of the target system using Wake on LAN.
On the controlling workstation, open an SSH client software and connect to the target system.
Perform the installation as described in Chapter 4, Installation steps.

7.3 Monitoring installation via VNC #

Using a VNC viewer, you can remotely control the installation of SUSE Linux Enterprise Desktop from virtually any operating system. This section introduces the setup using a VNC viewer or a Web browser.

7.3.1 Preparing for VNC installation #

To enable VNC on the installation target, specify the appropriate boot parameters at the initial boot for installation (see Chapter 3, Boot parameters). The target system boots into a text-based environment and waits for a VNC client to connect to the installation program.

The installation program announces the IP address and display number needed to connect for installation. If you have physical access to the target system, this information is provided right after the system booted for installation. Enter this data when your VNC client software prompts for it and provide your VNC password.

Because the installation target announces itself via OpenSLP, you can retrieve the address information of the installation target via an SLP browser. There is no need for physical access to the installation target provided your network setup and all machines support OpenSLP:

Procedure 7.1: Locating VNC installations via OpenSLP #

Run slptool findsrvtypes | grep vnc to get a list of all services offering VNC. The VNC installation targets should be available under a service named YaST.installation.suse.
Run slptool findsrvs YaST.installation.suse to get a list of installations available. Use the IP address and the port (usually 5901) provided with your VNC viewer.

7.3.2 Connecting to the installation program #

There are two ways to connect to a VNC server (the installation target in this case). You can either start a VNC viewer or connect using a JavaScript-enabled Web browser.

Using VNC, you can install a Linux system from any other operating system, including other Linux distributions, Windows, or macOS.

On a Linux machine, make sure that the package tightvnc is installed. On a Windows machine, install the Windows port of this application (see https://www.tightvnc.com/download.html).

To connect to the installer running on the target machine, proceed as follows.

Start the VNC viewer.
Enter the IP address and display number of the installation target:
```
IP_ADDRESS:DISPLAY_NUMBER
```
This opens a window displaying the YaST screen as in a regular local installation.

Instead of a VNC viewer, you can use a JavaScript-enabled browser that has JavaScript support enabled to perform the installation.

Note that the browser VNC connection is not encrypted.

To perform a VNC installation, proceed as follows.

Launch the Web browser and enter the following at the address prompt:
```
http://IP_ADDRESS_OF_TARGET:5801
```
When prompted, enter the VNC password. This opens a window with the YaST screen as in a regular local installation.

7.4 Monitoring installation via SSH #

Using an SSH client, you can perform the installation remotely via SSH.

7.4.1 Preparing for SSH installation #

In addition to installing the required software package (OpenSSH for Linux and PuTTY for Windows), you need to specify the appropriate boot parameters to enable SSH for installation. See Chapter 3, Boot parameters for details. OpenSSH is installed by default on any SUSE Linux–based operating system.

7.4.2 Connecting to the installation program #

After you have started the SSH installation, use this procedure to connect to the SSH session.

Retrieve the installation target's IP address. If you have physical access to the target machine, obtain the IP address that the installation routine provides from the console after the initial boot. Otherwise, obtain the IP address that has been assigned to the target machine in the DHCP server configuration.
Run the following command in the terminal:
```
ssh -X root@TARGET_IP_ADDRESS
```
Replace TARGET_IP_ADDRESS with the actual IP address of the installation target.
When prompted for a user name, enter root.
When prompted, enter the password that has been set with the SSH boot parameter. If the authentication is successful, you should see a command-line prompt for the installation target appear.
Enter yast to launch the installation program. This opens a window showing the YaST screen as described in Chapter 4, Installation steps.

7.5 Installation via serial console #

For this installation method, you need a computer connected by a null modem cable to the target machine where SUSE Linux Enterprise Desktop will be installed. Both machines must support the serial console. Certain firmware implementations are already configured to send the boot console output to a serial console. In this case, no additional configuration is required.

If the firmware does not use the serial console for the boot console output, set the following boot parameter for the installation: console=TTY,BAUDRATE. For further information, see Chapter 3, Boot parameters.

BAUDRATE needs to be replaced by the baud rate for the interface. Valid values are 115200, 38400, or 9600. TTY needs to be replaced by the name of the interface. On most computers, there is one or more serial interfaces. Depending on the hardware, the names of the interfaces may vary:

ttyS0 for APM
ttyAMA0 for Server Base System Architecture (SBSA)
ttyPS0 for Xilinx

For the installation, you need a terminal program like minicom or screen. To initiate the serial connection, launch the screen program in a local console by entering the following command:

> screen /dev/ttyUSB0 115200

This means that screen listens to the first serial port with a baud rate of 115200. From this point on, the installation proceeds similarly to the text-based installation over this terminal.