Applies to SUSE Linux Enterprise Micro 5.5

13 Remote installation #

The installation of SUSE® Linux Enterprise Micro 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.

13.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 Micro. Alternatively, installation servers can be used. In this case, use the install boot parameter to specify the source. For details, refer to Section 11.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 13.3, “Monitoring installation via VNC”, Section 13.4, “Monitoring installation via SSH” and Section 13.5, “Installation via serial console”.

AutoYaST can be used to fully automate the installation process. For further information, refer to AutoYaST Guide.

13.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.

13.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 12, 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:

Important: No access via VNC after the installation is complete.

After the installation of SLE Micro is finished, you will no longer be able to log in to the system using VNC.

Boot the target system using the installation medium (USB flash drive) of the SUSE Linux Enterprise Micro 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 11, 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 13.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 13.3, “Monitoring installation via VNC”.
Perform the installation as described in Chapter 12, Installation steps.

13.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.

Important: No access via VNC after the installation is complete.

After the installation of SLE Micro is finished, you will no longer be able to log in to the system using VNC.

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 12, Installation steps.

13.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 12, 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 Micro 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 11, 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 13.4.2, “Connecting to the installation program”.
Perform the installation as described in Chapter 12, Installation steps.

13.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 12, Installation steps.

13.3 Monitoring installation via VNC #

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

13.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 11, 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 13.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.

13.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.

13.4 Monitoring installation via SSH #

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

13.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 11, Boot parameters for details. OpenSSH is installed by default on any SUSE Linux–based operating system.

13.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 12, Installation steps.

13.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 Micro 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 11, 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.