Installation Guide | PUBLIC Software Provisioning Manager 1.0 SP32 Document Version: 1.9 – 2021-06-21 Installation of SAP Host Agent on UNIX - Using Software Provisioning Manager 1.0 company. All rights reserved. All rights company. affiliate THE BEST RUN 2021 SAP SE or an SAP SE or an SAP SAP 2021 © Content 1 SAP Host Agent as a Separate Installation - Using Software Provisioning Manager 1.0........4 2 Accessing the SAP Library.....................................................5 3 Installing the SAP Host Agent Separately..........................................7 3.1 Downloading and Extracting the Software Provisioning Manager 1.0 Archive...................11 3.2 Downloading the SAPHOSTAGENT Archive..........................................12 3.3 Prerequisites for Running the Installer..............................................13 3.4 Running the Installer..........................................................15 Useful Information about the Installer........................................... 18 3.5 Running zscsinst on z/OS......................................................20 4 Uninstalling the SAP Host Agent Separately.......................................25 Installation of SAP Host Agent on UNIX - Using Software Provisioning Manager 1.0 2 PUBLIC Content Document History Note Before you start reading, make sure you have the latest version of this installation guide, which is available at https://support.sap.com/sltoolset System Provisioning Install a System using Software Provisioning Manager Installation Option of Software Provisioning Manager 1.0 SP <Current Number> . The following table provides an overview on the most important document changes: Version Date Description 1.9 2021-06-21 Updated version for Software Provisioning Manager 1.0 SP32 (SL Toolset 1.0 SP32) 1.8 2021-02-15 Updated version for Software Provisioning Manager 1.0 SP31 (SL Toolset 1.0 SP31) 1.7 2020-10-05 Updated version for Software Provisioning Manager 1.0 SP30 (SL Toolset 1.0 SP30) 1.6 2020-06-08 Updated version for Software Provisioning Manager 1.0 SP29 (SL Toolset 1.0 SP29) 1.5 2020-01-20 Updated version for Software Provisioning Manager 1.0 SP28 (SL Toolset 1.0 SP28) 1.4 2019-09-16 Updated version for Software Provisioning Manager 1.0 SP27 (SL Toolset 1.0 SP27) 1.3 2019-05-27 Updated version for Software Provisioning Manager 1.0 SP26 (SL Toolset 1.0 SP26) 1.2 2019-01-21 Updated version for Software Provisioning Manager 1.0 SP25 (SL Toolset 1.0 SP25) 1.1 2018-09-17 Updated version for Software Provisioning Manager 1.0 SP24 (SL Toolset 1.0 SP24) 1.0 2017-04-23 Initial version for Software Provisioning Manager 1.0 SP23 (SL Toolset 1.0 SP23) Installation of SAP Host Agent on UNIX - Using Software Provisioning Manager 1.0 Document History PUBLIC 3 1 SAP Host Agent as a Separate Installation - Using Software Provisioning Manager 1.0 This installation guide describes how to install SAP Host Agent using Software Provisioning Manager 1.0 SP32 - the “installer” for short. Software Provisioning Manager 1.0 SP32 is part of Software Logistics Toolset 1.0 SP30. SAP Host Agent is an agent that can accomplish several life-cycle management tasks, such as operating system monitoring, database monitoring, system instance control and provisioning. When you install a new SAP system or instance, the SAP Host Agent is in most cases installed automatically on the SAP system or instance host. It is only required to install the SAP Host Agent separately if one of the following is true: ● There is no SAP system or instance on the host. ● The SAP system or instance running on the host has a kernel release lower than SAP kernel 7.20 and the host does not yet have an SAP Host Agent. During the installation of new SAP instances with SAP kernel 7.20 or higher, the SAP Host Agent is installed automatically (integrated installation). ● You have upgraded your SAP system to a release with a kernel release lower than SAP kernel 7.20 and the host of the upgraded system or instance does not yet have an SAP Host Agent. Section Installing the SAP Host Agent Separately [page 7] describes how to perform the installation using Software Provisioning Manager 1.0 . Installing the SAP Host Agent Without Using Software Provisioning Manager You can also install SAP Host Agent by downloading the SAPHOSTAGENT.SAR archive and running the installation from the command line. For more information, see the SAP Host Agent Implementation Documentation at: https://help.sap.com/viewer/product/hostagent Installation of SAP Host Agent on UNIX - Using Software Provisioning Manager 1.0 4 PUBLIC SAP Host Agent as a Separate Installation - Using Software Provisioning Manager 1.0 2 Accessing the SAP Library The references to SAP NetWeaver Library documentation in this installation guide always refer to the following on SAP Help Portal: Product and Release SAP Library Path SAP systems based on SAP NetWeaver 7.0x http://help.sap.com/nw SAP NetWeaver Platform SAP NetWeaver 7.0 <Including Enhancement Package> Application Help SAP NetWeaver by Key Capability SAP systems based on SAP NetWeaver 7.1x ● SAP NetWeaver Mobile 7.1: http://help.sap.com/nwmobile71 : (Out of Maintenance, see SAP Note 2980160 ) Application Help ● SAP NetWeaver Mobile 7.1 EHP1: http://help.sap.com/nwmobile711 : Application Help ● SAP NetWeaver Process Integration 7.1: http://help.sap.com/nwpi71/ Application Help SAP Library SAP NetWeaver Process Integration Library ● SAP NetWeaver Process Integration 7.1 EHP1: http://help.sap.com/ nwpi711/ Application Help SAP Library SAP NetWeaver Process Integration Library SAP systems based on SAP NetWeaver 7.2 SAP NetWeaver Composition Environment 7.2: http://help.sap.com/ (Out of Maintenance, see SAP Note 2980160 nwce72 Application Help SAP Library ) SAP systems based on SAP NetWeaver 7.3x ● SAP NetWeaver 7.3: http://help.sap.com/nw73 Application Help SAP NetWeaver Library: Function-Oriented View ● SAP NetWeaver 7.3 EHP1: http://help.sap.com/nw731 Application Help SAP NetWeaver Library: Function-Oriented View SAP systems based on SAP NetWeaver 7.4 http://help.sap.com/nw74 Application Help SAP NetWeaver Library: Function-Oriented View Installation of SAP Host Agent on UNIX - Using Software Provisioning Manager 1.0 Accessing the SAP Library PUBLIC 5 Product and Release SAP Library Path SAP systems based on SAP NetWeaver 7.5x ● SAP NetWeaver 7.5: http://help.sap.com/nw75 Application Help SAP NetWeaver Library: Function-Oriented View ● SAP NetWeaver Application Server for ABAP 7.51 innovation package: https://help.sap.com/nw751abap Application Help SAP NetWeaver Library: Function-Oriented View ● SAP NetWeaver AS for ABAP 7.52: https://help.sap.com/nw752abap Application Help SAP NetWeaver Library: Function-Oriented View Installation of SAP Host Agent on UNIX - Using Software Provisioning Manager 1.0 6 PUBLIC Accessing the SAP Library 3 Installing the SAP Host Agent Separately This procedure tells you how to install an SAP Host Agent separately. Context The SAP Host Agent is installed automatically during the installation of new SAP instances with SAP kernel 7.20 or higher (integrated installation). This procedure is only for hosts with no SAP Host Agent running on them, due to the following reasons: ● There is no SAP system or instance on the host. ● The SAP system or instance running on the host has a kernel release lower than SAP kernel 7.20 and the host does not yet have an SAP Host Agent. ● You have upgraded your SAP system to a release with a kernel release lower than SAP kernel 7.20 and the host of the upgraded system or instance does not yet have an SAP Host Agent. SAP Host Agent has the following executable programs and services: ● The SAPHostExec service ● The sapstartsrv service SAPHostControl ● The operating system collector saposcol Note The installed programs are automatically started when the host is booted. The automatic start is ensured by the startup script sapinit, which starts the required executables. To install an SAP Host Agent on z/OS, use the zscsinst tool. For more information, see Running zscsinst on z/OS [page 20]. The following procedure describes the steps you have to perform on the host where you install the SAP Host Agent separately. Procedure 1. Make sure that the sapadm user is created. During the installation, the installer checks all required accounts (users, groups) and services on the local machine. The installer checks whether the required users and groups already exist. If not, it creates new users and groups as necessary. Installation of SAP Host Agent on UNIX - Using Software Provisioning Manager 1.0 Installing the SAP Host Agent Separately PUBLIC 7 User and Groups of the SAP Host Agent User Primary Group Additional Group Comment sapadm sapsys – SAP Host Agent administrator Note If sapadm does not exist, it is created during the SAP Host Agent installation using /bin/ false shell. Make sure that /bin/false can be used as a login shell. Only valid for 'Platform': AIX AIX: Add /bin/false to the list of valid login shells (attrib­ ute shells) in /etc/ security/login.cfg. End of 'Platform': AIX Groups and Members of the SAP Host Agent User Groups Members sapsys sapadm sapinst sapadm 2. Set up the required file system for the SAP Host Agent and make sure that the required disk space is available for the directories to be created during the installation. Installation of SAP Host Agent on UNIX - Using Software Provisioning Manager 1.0 8 PUBLIC Installing the SAP Host Agent Separately The SAP Host Agent has only local directories as shown in the following figure: Directory Structure for the SAP Host Agent Directories Description Required Disk Space /usr/sap/hostctrl Contains the following directories: 100 MB ○ exe Contains the profile host_profile ○ work Working directory of the SAP Host Agent 3. Download and unpack the Software Provisioning Manager 1.0 archive on the host where you want to install the SAP Host Agent as described in Downloading and Extracting the Software Provisioning Manager 1.0 Archive [page 11].