Software Logistics
Page tree
Skip to end of metadata
Go to start of metadata

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.
  • Verify the "Hosts File" format has correctly been define following the Mandatory Standard. See https://wiki.scn.sap.com/wiki/x/i4IjIQ
  • 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
  • No labels