Installing SUSE Linux Enterprise Server for SAP applications Manually Using Agama
- WHAT?
This article describes how to install SUSE Linux Enterprise Server for SAP applications using Agama. The information presented here applies to installation of the products on both bare metal and virtual machines.
- WHY?
Read this article to understand the process of installing SUSE Linux Enterprise Server for SAP applications using Agama.
- EFFORT
You may need 15 minutes to read this article.
- GOAL
Learn how to manually install SUSE Linux Enterprise Server for SAP applications using Agama.
- REQUIREMENTS
A bare metal server or a virtual machine. For server installations without any desktop environment, SUSE recommends a minimum of 1 CPU, 2 GB memory and 32 GB storage (which includes storage for Btrfs snapshots in the root partition, swap space, and storage for software packages).
An active registration code for the product you want to install. You can generate a registration code for the product and activate its subscription for your organization at the SUSE Customer Center.
Note: Optional registrationCertain images that are signed with the developer's key may allow you to skip registration before or while installation. Besides, certain images may contain all installable packages for your operating system that you can use as an offline package repository. In such cases, you may not need an active registration code before installation. However, if you use software packages from the official online repositories, SUSE recommends registering your product with the SUSE Customer Center.
1 Introduction to Agama #
This section provides a short overview of Agama, which is the default installer for SUSE Linux Enterprise Server for SAP applications 16.0 and later versions.
1.1 What is Agama? #
Agama is a flexible and powerful open source installer developed by SUSE. You can use it to perform manual or automated installation of supported SUSE Linux Enterprise Server for SAP applications versions on a variety of machine architectures. The Agama‐based installation method provides an intuitive interface for ready‐to‐use images for different use cases and workloads. In combination with Cockpit and Ansible, it substitutes YaST in SUSE Linux Enterprise Server for SAP applications.
2 Installing SUSE Linux Enterprise Server for SAP applications using Agama #
This section describes how to install SUSE Linux Enterprise Server for SAP applications using the Agama‐based ISO image file.
2.1 Introduction #
The following sections describe the Agama‐based manual installation procedure for SUSE Linux Enterprise Server for SAP applications. The information applies to installation on both bare metal and virtual machines.
2.2 Requirements #
An Agama‐based ISO image file for supported versions of SUSE Linux Enterprise Server for SAP applications. You can download it from the SUSE Customer Center and verify its checksum to ensure its integrity.
Note: Available images for productsThe Agama‐based installation image is available for SUSE Linux Enterprise Server for SAP applications 16.0 and later versions.
2.3 Manually installing SUSE Linux Enterprise Server for SAP applications for s390x using Agama #
To manually install SUSE Linux Enterprise Server for SAP applications using Agama, perform the following steps:
Download
SLES-Online-16.0-s390x-Beta4.install.isoand mount it:>sudomkdir-p/srv/ftp/agama>sudomount-o loopSLES-Online-16.0-s390x-Beta4.install.iso/srv/ftp/agama(Optional) For installation in an air-gapped environment or without registration, download
SLES-16.0-Full-s390x-Beta4.install.isoand mount it.>sudomkdir-p/srv/ftp/agama-offline>sudomount-o loopSLES-16.0-Full-s390x-Beta4.install.iso/srv/ftp/agama-offlineUse the following parmfile to start the installation:
Example 1: Example parmfile #cio_ignore=all,!condev,!0.0.01601 rd.zdev=dasd,0.0.01602 rd.zdev=qeth,0.0.0800:0.0.0801:0.0.0802,layer2=1,portno=03 ip=192.168.3.1004::192.168.3.254:245::enc800:none ip=192.168.3.100::192.168.3.254:24:SLE16-Beta2:enc800:none hostname=jupiter6 nameserver=192.168.1.1167 root=live:ftp://192.168.3.105/agama/LiveOS/squashfs.img8 live.password=linux9
Only expose the devices that the machine should be aware of
Activation of a DASD device
Activation of a qeth device
IP configuration. The different parameters are separated by colons (
:). You can omit unneeded parameters by leaving them out, meaning you get two or more subsequent colons. For a complete configuration reference, refer toman 7 dracut.cmdline.If no IP configuration is specified, it will be assigned with DHCP and the IP address will displayed on the console after boot.
Important: Multiple network interfacesIf your system has more than one network interface, IP configurations may be swapped after the installation, leaving the system unreachable.
To prevent this from happening, either bind each IP configuration to a particular interface by interface name or MAC address. If you use a MAC address, make sure to format it as
00-11-22-33-44-55instead of00:11:22:33:44:55TipAs the console is hard to read on
x3270, configuring the network in the parmfile is recommended.IP address of the gateway for the system
Host name of the system. You can also set the host name in the
ipparameter, however it is transient whereashostnamegets written to/etc/hostname.IP address of the DNS server for the system
URI of the installer ISO mounted in Step 1. For installation in an LPAR, use the ISO file directly as in:
root=live:ftp://192.168.3.105/agama/SLES-Online-16.0-s390x-Beta4.install.isoPassword for the system administrator
root. If you do not set a password, a random password will be generated and displayed on the console after boot. As the console is hard to read onx3270, setting arootpassword in the parmfile is recommended.Adjust your parmfile accordingly:
For installation in an air-gapped environment or without registration, add the
agama.install_urlto the parmfile to install from SLES-16.0-Full-s390x-Beta4.install.iso mounted in Step 2:agama.install_url=ftp://192.168.3.105/agama-offline/install
If you are using a VLAN, add the
vlanparameter. Make sure to specify the virtual device instead of the underlying physical device.ip=192.168.3.100::192.168.3.254:24::enc800.2174:none hostname=jupiter nameserver=192.168.1.116 vlan=enc800.2174:enc800
Tip:ifcfgvsipsyntaxEarlier versions of SUSE Linux Enterprise used
linuxrcusing the interface configuration (ifcfg) files, whereas SUSE Linux Enterprise 16 usesdracutwithipsyntax for NetworkManager. While Agama supports translating some options, it is recommended to use the new and more powerful syntax.Table 1:ifcfgvsip#ifcfgdracutifcfg=*=dhcp
ip=dhcp
ifcfg=eth0=dhcp
ip=eth0:dhcp
ifcfg=eth0.10=192.168.0.100/24,192.168.0.1
vlan=eth0.10:eth0 ip=192.168.0.100::192.168.0.1:24::eth0.10
ifcfg="eth0=192.168.0.33/24 10.0.0.100/24,192.168.0.1,192.168.0.1 10.0.0.1,example.com"
ip=192.168.0.33::192.168.0.1:24::eth0 nameserver=192.168.0.1 nameserver=10.0.0.1 ip=10.0.0.100:::24::eth0
For a complete list of
dracutoptions, refer toman 7 dracut.cmdline.Note: DASD alias devicesDASD alias devices are special in that they appear not operational until at least one associated DASD base device has been enabled. As a result, the Agama installer cannot determine their actual type (ECKD or FBA DASD).
As a workaround, specify
dasd-eckdas device type. This should providechzdevwith enough information to createudevrules for enabling these devices even in the absence of a working device. When the the base device is enabled later and the alias devices become operational, they will be automatically set online.Open a web browser pointing to the given IP address from the parmfile. Enter the
rootpassword and proceed with the installation.Select SUSE Linux Enterprise Server for SAP applications 16.0 for installation and accept the license to continue.
The overview with the most relevant installation settings is shown. Adjust the settings by selecting the category from the menu on the left or directly proceed with the installation.
Tip: Installer language and keyboardClick the arrow menu in the top right corner and select to change the language and keyboard layout used by the installer. The language can only be changed on local installations. If you are using a web browser for a remote installation, configure the preferred content language in the browser settings and reload the installer.
Register your product. Enter a registration code and optionally a valid email address.
Note: Optional registration for images signed with the developer's keyImages signed with the developer's key may allow you to skip registration before installation. If your product's image supports installation without registration, you may see a pop-up similar to the following:
To install without registration, select on the pop-up.
(Optional) Adjust your localization settings such as language, keyboard layout and time zone.
(Optional) Configure your network settings. To edit an existing network connection, click the three dots.
Select a storage device for installation.
Currently installations on single discs or LVM are supported. To change the disk or use LVM, click the device name button in the section.
To use DASD, iSCSI or zFCP devices, you need configure them first. Click and select the desired technology. The DASD and zFCP options are only available if the corresponding devices are attached.
To activate a DASD disk, select it from the list and click › . Once the disk is activated, you can select it for installation in the previous screen.
To activate a zFCP disk, select it from the list and activate it by clicking on the three-dot menu. If the activation status is not displayed correctly, press F5 to refresh the installer interface.
To detect an iSCSI disk, select the iSCSI initiator and click .
By default, the file systems will be allocated as new partitions on the selected device. You can change this behavior in the drop-down list labeled drop-down list in the section. The following space policies are available:
Space policies #- Delete current content
All partitions will be removed and any data on the disks will be lost.
- Shrink existing partitions
The data is kept, but current partitions will be shrinked as needed.
- Use available space
The data is kept. Only the space not assigned to any partition will be used.
- Custom
Select what to do with each partition.
To edit individual partitions, expand the section by clicking on the Optionally, you can configure Btrfs snapshots, boot options and enable full disk encryption (FDE).
(Optional) Add additional software to install such as the KVM hypervisor or Cockpit system management service.
Note: Trust the GPG key for the Package Hub repositoryIf you select the Package Hub add-on and see a popup, trust the GPG key for that repository.
Configure the authentication settings.
Important: No SSHrootaccessSSH access for
rootis disabled by default. Therefor it is strongly recommended to create a system user. The first system user is grantedsudoprivileges automatically and can also be used for accessing Cockpit.Create a non-root user. Click and enter details such as user name and password.
Configure the authentication methods for the
root. You can use a secure password, a SSH public key, or both.
Click and confirm to start the installation.
Wait for the system installation to complete. It takes around 30 minutes to complete the installation.
Tip: Installation logsYou can use the arrow menu in the top right corner of the window to view the logs and system messages.
Once the installation is complete, select .
2.4 Summary #
After successful configuration checks, product registration, installation and reboot, verify that you can log in and use your system.
3 For more information #
For information on related topics, refer to the following resources:
Documentation of the Agama open-source project: https://agama-project.github.io/docs
IBM documentation for SUSE distributions https://www.ibm.com/docs/en/linux-on-systems?topic=distributions-suse-linux-enterprise-server
4 Legal Notice #
Copyright© 2006–2025 SUSE LLC and contributors. All rights reserved.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant Section being this copyright notice and license. A copy of the license version 1.2 is included in the section entitled “GNU Free Documentation License”.
For SUSE trademarks, see https://www.suse.com/company/legal/. All other third-party trademarks are the property of their respective owners. Trademark symbols (®, ™ etc.) denote trademarks of SUSE and its affiliates. Asterisks (*) denote third-party trademarks.
All information found in this book has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither SUSE LLC, its affiliates, the authors, nor the translators shall be held liable for possible errors or the consequences thereof.














