You are on page 1of 4

Installation of Solution Manager Diagnostics Agent

with ExecuteInstallationProcedure
Introduction
Prerequisites
Automatic Installation of the Diagnostics Agent with registration to SAP Solution Manager System
Example how to execute ExecuteInstallationProcedure for installation with a parameter file remotely on MyHost:
Automatic Uninstallation of the Diagnostics Agent
Example how to execute 'ExecuteInstallationProcedure' for uninstallation with a parameter file remotely on MyHost:

Introduction
ExecuteInstallationProcedure is a WebService method capable to remotely call sapinst.

It currently support a couple of features like retry, mount/umount and asynchronous execution.
saphostctrl client usage for ExecuteInstallationProcedure
Usage: saphostctrl [generic option]... -function <Webmethod> [argument]...
saphostctrl -help [<Webmethod>]

Generic options:
-host <hostname>
-user <username> <password>
-prot tcp|pipe [Force to use TCP only or PIPE connection only]
-https|-sso
-format [flat|tree|cimobject] where supported.
-sotimeout <connect[,recv,send]> set socket timeout in second
negative values = INFINITE

Supported Webmethods:
ExecuteInstallationProcedure
-src <Source directory of the SAPInst executable>
-prodid <Product ID>
[-inifile <SAPInst ini file> | -paramfile <SAPInst parameter file>]

[-timeout <timt in sec>]


[-optargs <optional sapinst arguments> ]
[-cleanup <auto|delayNR> remove all temporary created directories,
eventually umount the mounted filesystem>]
[-retry <retry a precedentely failed execution. -home and -src are
mandatory>]
[-mountsrc <The source mount directoy>]
[-mounttgt <The local mount directoy. If the directory doesn't
exists will be created>]
[-mounttype <currently only net is supported, could be omitted>]
[-mountopt <Additionally option to be passed to mount: e.g: '-o
exec,ro'>]
[-mountusr <The user which will be used to mount the filesystem>]
[-mountpwd <The password of the user used by -mountusr>]
[-umount <umount the mounted filesystem mounted by -mountsrc on
-mounttgt>]
[-umountopt <Additionally option to be passed to umount>]
[-home <The home directory, where the whole process will be
executed>]
[-trace <SAPInst trace value.>]
[-relpath <Relative path to the source path (-src or -mounttgt)
where the executable is searched.>]
[-instenv <Comma-separated list of additional environment variables
to be set before start SAPInst.>]

Prerequisites
SAP Host Agent is installed.
Software Provisioning Manager (SWPM) and Kernel installation media are downloaded from http://support.sap.com/swdc),
for example SL Toolset 1.0 SP16 SWPM10SP10 and Package SL Toolset 1.0 SP16 Kernel 721 for SWPMSP10.
You have unpacked the SWPM10SP<Support_Package_Number>_<Version_Number>.SAR .
You have unpacked the Kernel installation package to the directory where you have also unpacked SWPM (or any of the directories in
the directory path of SWPM), because otherwise the sapinst executable does not find the required Kernel installation files

Automatic Installation of the Diagnostics Agent with registration to SAP Solution


Manager System
Product ID: NW_DiagnosticsAgent:NW731.IND.PD

Installation Parameters
NW_DiagnosticsAgent.sid=DAA
NW_DiagnosticsAgent_Instance.instanceNumber=97
NW_DiagnosticsAgent_Host.virtualHost=WDFN00297139A
NW_DiagnosticsAgent_Instance_Setup.connection_sld=no
NW_DiagnosticsAgent_Instance_Setup.connection_solman=solman
NW_DiagnosticsAgent_Instance_Setup.useSSL_solman=false
NW_DiagnosticsAgent_Instance_Setup.host_smd=wdflbmd0385.wdf.sap.corp
NW_DiagnosticsAgent_Instance_Setup.port_smd=8101
NW_DiagnosticsAgent_Instance_Setup.user_smd=SMD_ADMIN
NW_DiagnosticsAgent_Instance_Setup.passwd_smd=Abcd1234
NW_DiagnosticsAgent_Instance_Setup.connection_ms=ms
NW_DiagnosticsAgent_Instance_Setup.needHTTPS_sld=false
smdAgent.sidAdmPassword=Abcd1234
smdAgent.sapServiceSIDPassword=Abcd1234

You have to save these values to a file and provide the location of this file to ExecuteInstallationProcedure as -paramfile parameter

All parameters are examples. If you want to use this example, you have to adjust the parameters to your needs.

Example how to execute ExecuteInstallationProcedure for installation with a parameter file remotely on MyHost:

C:\Program Files\SAP\hostctrl\exe>saphostctrl.exe
-host MyHost
-user sapadm Abcd1234
-function ExecuteInstallationProcedure
-prodid NW_DiagnosticsAgent:NW731.IND.PD
-paramfile "C:\temp\smdinstallparameters"
-home C:\temp\
-src C:\temp\swpm

Automatic Uninstallation of the Diagnostics Agent


Product ID: NW_Uninstall:NW731.IND.PD
Uninstall Parameters
NW_readProfileDir.profileDir=C:\usr\sap\DAA\SYS\profile
NW_System_Uninstall.completeSystem=true
NW_System_Uninstall.removeUsers=true
NW_System_Uninstall.uninstallHostAgent=false

You have to save these values to a file and provide the location of this file to ExecuteInstallationProcedure as -paramfile parameter

All parameters are examples. If you want to use this example, you have to adjust the parameters to your needs.

Example how to execute 'ExecuteInstallationProcedure' for uninstallation with a parameter file remotely on MyHost:

C:\Program Files\SAP\hostctrl\exe>saphostctrl.exe
-host MyHost
-user sapadm Abcd1234
-function ExecuteInstallationProcedure
-prodid NW_Uninstall:NW731.IND.PD
-paramfile "C:\temp\smduninstallparameters"
-home C:\temp\
-src C:\temp\swpm

You might also like