-
SAP Note
Header Data
Symptom
You want to install or upgrade the SAP Host Agent
Other Terms
saphostexec, sapstartsrv
=======================================================================
Reason and Prerequisites
Differenciation between platforms: SAP Host Agent runs on all
SAP supported platforms. The differences in using the SAP Host
Agent are the following.
l Host Agent directories:
Unix: /usr/sap/hostctrl/exe /usr/sap/hostctrl/work
Windows: %ProgramFiles%\SAP\hostctrl\exe
%ProgramFiles%\SAP\hostctrl\work
l Host Exec Executable:
Unix: saphostexec
Windows: saphostexec.exe
l Needed user permissions:
Unix: root permissions
Windows: Administrator permissions + elevated mode
This guide will be using the Unix paths and commands as
examples. The procedure is the same for Windows.
=======================================================================
Solution
Installing SAP Host Agent
1. Download the latest SAPHost Agent 7.20 from service
marketplace http://service.sap.com/swdc
In the navigation bar, choose: -> SAP Software Download
Center -> Support Packages and Patches -> Browse our Download
Catalog -> SAP Technology Components -> SAP HOST AGENT ->
SAP HOST AGENT 7.20 ->
2. Create a temporary directory (e.g. /tmp/ha), and copy the
package SAPHOSTAGENT.SAR to this directory
1031096 - Installing Package SAPHOSTAGENT
Version 33 Validity: 26.09.2014 - active Language English
(Master)
Released On 26.09.2014 11:53:15 Release Status Released for
Customer Component BC-CCM-HAG Host Agent
BC-CCM-MON Monitoring
BC-CCM-MON-OS Operating System Monitors
Priority Recommendations / Additional Info Category Upgrade
information
Other Components
-
3. Change directory to the temporary directory (cd /tmp/ha)
4. In this directory, extract the SAPHOSTAGENT.SAR via
sapcar:
[PATH_TO_SAPCAR]/SAPCAR -xvf SAPHOSTAGENT.SAR
5. Use
./saphostexec -install
and follow the installation procedure You can now remove the
temporary directory with his content (rm -rf /tmp/ha)
=======================================================================
Upgrading SAP Host Agent To upgrade the Host Agent, follow the
steps 1 to 4 of the installation and use ./saphostexec -upgrade as
fifth step. Note: An upgrade of SAP Host Agent 720_EXT to a higher
patchlevel of SAP Host Agent 720 is already supported and also
recommended.
=======================================================================
Installation for IBM i Prerequisites
l You must be logged on as a user profile with special
authorities SECADM and *ALLOBJ, for example as user profile
QSECOFR.
l You have downloaded the SAPHOSTAGENT.SAR archive.
l Option 33 of the operating system must be installed. Use menu
GO LICPGM to check whether the option is installed and install it
if required. If option 33 of the operating system was installed
during this step, we recommend that you install the latest PTFs for
your operating system release according to SAP Note 83292.
l The system startup program (specified in system value
QSTRUPPGM) must contain the STRSBS command to start subsystem
QSYS/QUSRWRK. This is needed because SAPHOSTAGENT will be started
as an auto-start job in subsystem QSYS/QUSRWRK.
l If user profile R3GROUP does not exist on your server, it will
be created during the installation of the Host Agent. If you have
already installed SAP systems on other servers, we recommend that
you use the same group ID (GID) for all sapsys and R3GROUP groups
in the system landscape. To obtain the group ID (GID) for R3GROUP
on another IBM i server in your landscape, enter the command
DSPUSRPRF USRPRF(R3GROUP) and scroll down until you see the value
for Group ID number.
Installation
1. If it does not exist on your server, create the directory
/tmp/hostctrl and then copy or move the downloaded archive
SAPHOSTAGENT.SAR and SAPCAR to the directory /tmp/hostctrl.
2. Enter the command CALL PGM(QP2TERM) to start a PASE
interactive terminal session.
3. Make the directory that contains SAPCAR and the archive
SAPHOSTAGENT.SAR your current directory using the following
command: cd /tmp/hostctrl
4. Decompress the archive SAPHOSTAGENT.SAR with the SAPCAR tool
using the following command: [PATH_TO_SAPCAR]/SAPCAR -xvf
SAPHOSTAGENT.SAR
5. To install saphostcontrol enter the following command:
./saphostexec -install -gid
If you have already installed SAP systems on other servers, we
ecommendthat you use the same group ID (GID) for all sapsys or
R3GROUP groups in the system landscape. To do this, enter your
landscape system GID into on the above command. If user profile
R3GROUP already exists, or if you want the saphostcontrol
installation to automatically generate a new group ID, enter the
command
saphostexec -install
without the addition
-gid
.
6. Leave the PASE interactive terminal session using function
key F3.
If it did not already exist, R3GROUP was created during the
installation. Even though SAP Host Agent does not require special
authorities, we recommend that you grant the required authorities
for system API#s that need to be authorized for user profile
R3GROUP for your SAP system now. For more information, see SAP Note
175852. Note:
-
The SAPHOSTAGENT will run in QUSRWRK. Therefore you have to
activate this subsystem so that it comes up after IPL.
Validity
Support Packages & Patches
References
This document refers to:
SAP Notes
Software Component From Rel. To Rel. And Subsequent
SAPHOSTAGENT 7.10 7.10
7.11 7.11
7.2L 7.2L
7.20 7.20
7.21 7.21
7.21EXT 7.21EXT
Support Package Patches
Software Component Support Package Patch Level
SAP HOST AGENT 7.20 SP192 000192
1887279 DB2-z/OS: sapdbctrl: Prerequisites and Configuration
1881267 DB2-z/OS: SAP Host Agent problem on z/OS 1813548 Database
Migration Option (DMO) of SUM 1798556 SAP Landscape Virtualization
Management 2.0 standard edition 1783702 SAP Landscape
Virtualization Management 2.0 - Enterprise Edition 1776801
Inst.Systems Based on NW 7.0 incl. EHPs:IBM i 1738283 SAP Solution
Manager - Monitoring of database clusters 1709155 System
Provisioning with SAP Landscape Virtualization Management 1707012
IBM i: Prepare Installation Kits for Usage with DCK Kernel 1692228
The specified SAP instance does not exist on server 1687173 IBM i:
Collection of notes about the 7.20 kernel 1666481 IBM DB2 for i:
Add. Info - Software Update Manager 1.0 SP04 1656096 IBM i:
Automounting QFILESvr.400 links using SAPINIT 1651892 SAP Solution
Manager 7.1 E2E RCA Setup for IBM WebSphere 1641062 Single
component update and patch scenarios in SUM 1638811 Potential
remote code execution in SAP Startup Service 1633036 SAP Solution
Manager 7.1 E2E RCA Setup for Apache Tomcat 1632755 IBM i:
Description of command APYSIDKRN 1630050 SAP NetWeaver Landscape
Virtualization Management 1.0, standard edition 1625203
saphostagent/sapdbctrl for NewDB 1622665 IBM i: SAP Database
Performance Collector 1611933 IBM DB2 for i: Add. Info - Software
Update Manager 1.0 SP03 1581170 IBM i: Security concept on IBM i
1527538 SAP NetWeaver Landscape Virtualization Management 1.0
1502670 Support Package Stack Guide - SAP NetWeaver 7.3 1489787
Software Update Manager 1.0: IBM DB2 for i 1481805 IBM i: ST06 does
not display any hardware information 1462332 ACC 7.3 - Adaptive
Computing Controller Collect. Note 1439391 SAPOSCOL Service deleted
after SAPHostAgent Installation 1393207 Configuring SAP
BusinessObjects Edge 3.1 Monitoring 1375863 ACC 7.2 - Adaptive
Computing Controller Collect. Note 1375494 SAP system does not
start after applying SAP kernel patch 1357901 RCA: Managed System
Setup for SAP BusinessObjects Enterprise 1315499 Support Package
Stack Guide - SAP NetWeaver PI 7.1 EHP1 1306787 IBM i: Standalone
installation of CCMS agent 1250285 SAP Host Agent problems on HP-UX
with NSS LDAP 1180797 CCMS: Error messages in SM21 and SOAMANAGER
(host agent) 1153726 LiveUpdate hangs 1119595 SAP ACC with HP
Storage Essentials SRM 1119255 Support Package Stack Guide - SAP
NetWeaver PI 7.1
-
This document is referenced by:
SAP Notes (59)
1113545 Problems with SAP Host Agent 1102124 SAPOSCOL on Linux:
Enhanced function 1064968 ST06: Unable to start saposcol 1039455
AL11: DIR_CCMS and DIR_SAPHOSTAGENT 1008828 ACC 7.1 PI / Adaptive
Computing Controller Collective Note
893215 SAP Start Service on iSeries 684106 Microsoft runtime
DLLs
19227 Open newest saposcol
1625203 saphostagent/sapdbctrl for NewDB 1622665 IBM i: SAP
Database Performance Collector 1502670 Support Package Stack Guide
- SAP NetWeaver 7.3 1738283 SAP Solution Manager - Monitoring of
database clusters 1499408 IBM i: Installation Fails Due to
Incomplete Kernel Update 1064968 ST06: Unable to start saposcol
1611933 IBM DB2 for i: Add. Info - Software Update Manager 1.0 SP03
1489787 Software Update Manager 1.0: IBM DB2 for i 966719 SAP
NetWeaver Inst. Based on Kernel 7.10: IBM DB2 for i5/OS 1357901
RCA: Managed System Setup for SAP BusinessObjects Enterprise
1481805 IBM i: ST06 does not display any hardware information
1687173 IBM i: Collection of notes about the 7.20 kernel 1306787
IBM i: Standalone installation of CCMS agent 1439391 SAPOSCOL
Service deleted after SAPHostAgent Installation 1153726 LiveUpdate
hangs 1375863 ACC 7.2 - Adaptive Computing Controller Collect. Note
2104359 OS/400 SAPHOSTAGENT beendet sich nach einigen Tagen 2048156
DB2-z/OS:CCMS:HAG: CIM-Provider Enablement for Linux for System z
2047924 DB2-z/OS:CCMS:HAG: CIM-Provider Enablement for z/OS 1119595
SAP ACC with HP Storage Essentials SRM 1119255 Support Package
Stack Guide - SAP NetWeaver PI 7.1 1113545 Problems with SAP Host
Agent 2039994 Managing system landscapes with LVM Standard Edition
2039615 Managing system landscapes with LVM Enterprise Edition
1102124 SAPOSCOL on Linux: Enhanced function 1887279 DB2-z/OS:
sapdbctrl: Prerequisites and Configuration 1667731 Rapid database
migration of SAP NetWeaver BW to SAP HANA 1666481 IBM DB2 for i:
Add. Info - Software Update Manager 1.0 SP04 1008828 ACC 7.1 PI /
Adaptive Computing Controller Collective Note 1881267 DB2-z/OS: SAP
Host Agent problem on z/OS 1937227 Missing history data in ST06
1633036 SAP Solution Manager 7.1 E2E RCA Setup for Apache Tomcat
1632755 IBM i: Description of command APYSIDKRN 1630050 SAP
NetWeaver Landscape Virtualization Management 1.0, standard edition
1180797 CCMS: Error messages in SM21 and SOAMANAGER (host agent)
684106 Microsoft runtime DLLs 1462332 ACC 7.3 - Adaptive Computing
Controller Collect. Note 1709155 System Provisioning with SAP
Landscape Virtualization Management 1581170 IBM i: Security concept
on IBM i 1707012 IBM i: Prepare Installation Kits for Usage with
DCK Kernel 1453112 CCMS agent and kernel patches 1039455 AL11:
DIR_CCMS and DIR_SAPHOSTAGENT 1315499 Support Package Stack Guide -
SAP NetWeaver PI 7.1 EHP1 1692228 The specified SAP instance does
not exist on server 19227 Open newest saposcol 1636252 Installing a
7.20 kernel in SAP Web AS 7.00/7.01/7.10/7.11 1409604
Virtualization on Windows: Enhanced monitoring 1776801 Inst.Systems
Based on NW 7.0 incl. EHPs:IBM i 1862333 Common Host Agent issues
displayed in Agent Administration 1257635 DB4: DBSL Direct Drive
for DB2 for IBM i (DB2/400) 1656096 IBM i: Automounting
QFILESvr.400 links using SAPINIT 893215 SAP Start Service on
iSeries 1527538 SAP NetWeaver Landscape Virtualization Management
1.0 1651892 SAP Solution Manager 7.1 E2E RCA Setup for IBM
WebSphere 1250285 SAP Host Agent problems on HP-UX with NSS LDAP
1393207 Configuring SAP BusinessObjects Edge 3.1 Monitoring 2007530
Invalid User Authentication in Unix SAP Content Server
-
1641062 Single component update and patch scenarios in SUM
1638811 Potential remote code execution in SAP Startup Service
