Symptom

Mass Deployment of SAP Solution Manager Diagnostics Agent with NW2007 SR3 SAP installer.

Reason and Prerequisites

The purpose of this note is to describe how to a mass deployment of the Solution Manager Diagnostics (SMD) agent on a customer system landscape. It is possible to install an SAP Solution Manager Diagnostics agent with SAPinst in unattended mode. This means you record all input parameters for one installation scenario, which you can then reuse for further installations. This SAP Note describes the additional steps you have to perform for an installation in unattended mode beyond the "standard" installation procedure that is described in the Diagnostics Agent installation guides. The Diagnostics Agent installation guide is available at http://service.sap.com/diagnostics.

Procedure
1. Since SR3 it is necessary to have 3 DVDs for the Diagnostics agent installation: the Installation Master DVD that contains the SAPinst package, the Kernel DVD that contains the executables and the Java DVD that contains the Diagnostics Agent software.

Please note that if you have not already downloaded these DVDs, (they are required for some other SAP NW System installation) you may find them at: [Kernel & Installation Master DVD] Navigate to service.sap.com/swdc Download Installations and Upgrades SAP Netweaver SAP NETWEAVER SAP NETWEAVER 7.0 Installation and Upgrade <choose operating system of managed> <choose database type>. Select the following components based on your OS and platform: BS2005 SR3 Installation Master and NW 7.0 SR3 UC-Kernel 7.00. [Java DVD with the Diagnostics Agent] If you have not already downloaded the full Java DVDs you may reduce the download size by downloading the SMDAGENTXX.SAR instead of NW 7.0 SR3 SPXX Java Based SW Comp 1,2,3,4. Navigate to service.sap.com/swdc Download Support Packages and Patches Entry by Application Group SAP Technology Components SAP SOLUTION MANAGER SAP SOLUTION MANAGER 7.0 Entry by Component -> Agents for Satellite Systems SMD Agent 7.00 #OS independent and download the SMDAGENT15_0-200xxxx.SAR 2. Download the following files from this SAP note: Inifile.xml keydb.dtd

doc.dtd 3. Modify inifile.xml: The file named inifile.xml is a template document which has to contain all required parameters to run SAPinst in unattended mode. Edit inifile.xml and modify the parameters according to your needs (within the bracket <![CDATA[TO_COMPLETE]]>).

The following table lists all the mandatory or optional parameters needed for the installation. Please change the following parameters according to your environment.

Windows platform
Parameter name
sid

Description
The SAP System ID of the system to install

Available values
Three alphanumeric characters. The first character is a letter (not a digit). Only uppercase letters. Consists of a two-digit number from 00 to 97 string true / false string string string string Windows domain or leave it blank for local installation string string 4 digits string string MSG_SRV / SRV J2EE / SLD 1 digit 1 string

Importance

Mandatory

number sapdrive unicode javaHome AgentNaming OSUser OSpassword sapDomain VirtualHost HostName SMDPort Adminpassword AdminUser ConnectionType installType AgentInstallHostValue SupportUniqueHost agentInstallHostType

Instance Number The drive to use Will this system be Unicode system? The java home directory to use for this installation. Solution Manager key used in SMSY OS user name (Monitored) OS password (Monitored) The windows domain name for the OS users hostname of the Virtual host Monitoring Host Name (Monitoring) Monitoring Port (Monitoring) Monitoring Administrator password (Monitoring) Monitoring Administrator user name (Monitoring) Monitoring connection type SMD agent connected or not to a productive SLD 4 = virtual host; 2 physical host Support Unique Host Global or Virtual host (gHost or vHost)

Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory (windows) Optional Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Do not modify Mandatory

Caution: Please pay attention that all existing values from the template inifile.xml enclosed to this Note are for information purpose only. All values like <MANDATORY> or <OPTIONAL>have to be replaced by suitable values.

UNIX platform
Parameter name
sid

Description
The SAP System ID of the system to install

Available values
Three alphanumeric characters. The first character is a letter (not a digit). Only uppercase letters. Consists of a two-digit number from 00 to 97 true / false string string string string sapsys Should be left empty Should be left empty Should be left empty string string string 4 digits string string MSG_SRV / SRV J2EE / SLD 1 digit 1 string

Importance

Mandatory

number unicode javaHome AgentNaming OSUser OSpassword OSGroup OSUserID OSHome OSShell sapDomain VirtualHost HostName SMDPort Adminpassword AdminUser ConnectionType installType AgentInstallHostValue SupportUniqueHost agentInstallHostType

Instance Number Will this system be Unicode system? The java home directory to use for this installation. Solution Manager key used in SMSY OS user name (Monitored) OS password (Monitored) OS group (Monitored) - For non-windows installation OS user ID OS user Home (Monitored) - For non-windows installation OS user Shell (Monitored) - For non-windows installation The windows domain name for the OS users hostname of the Virtual host Monitoring Host Name (Monitoring) Monitoring Port (Monitoring) Monitoring Administrator password (Monitoring) Monitoring Administrator user name (Monitoring) Monitoring connection type SMD agent connected or not to a productive SLD 4 = virtual host; 2 physical host Support Unique Host Global or Virtual host (gHost or vHost)

Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Do not modify Mandatory Mandatory Mandatory Mandatory Optional Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Mandatory Do not modify Mandatory

Caution: Please pay attention that all existing values within the inifile.xml attached to this SAP Note are for your information only. All information values contained within the XML such as <MANDATORY> or <OPTIONAL> need to be replaced by suitable values or removed if they are optional.

Note: You can only modify parameters that are covered throughout the provided template. You can enter encrypted values without encryption. At the first SAPinst run-time execution, your current inifile.xml will be replaced by a version with the encrypted password. For that reason please do not forget to make a copy of your original inifile.xml if you need it later. 4. Save the following files in a common directory ${COMMON_FOLDER} (e.g. Windows: c:\unattended\common or UNIX: /unattended/common ) inifile.xml keydb.dtd doc.dtd Caution: The keydb.dtd and doc.dtd files are required for parsing inifile.xml. For UNIX systems these directories need to belong to the group sapinst (chgrp R sapinst <directory where the installation is executed and the location of the DVD folders>). 5. Select a directory from which the installation will be started: ${EXEC_DIR} (e.g. Windows: c:\unattended\install or UNIX: /unattended/install) 6. Create start_dir.cd file In the ${EXEC_DIR}, create the file start_dir.cd containing the paths to the installation DVDs required for the unattended installation (Installation Master, Kernel and Java DVDs). Proceed as follows: a) Create a file named start_dir.cd and in it enter the related paths to all installation DVDs required for your unattended installation. b) Save the file start_dir.cd in the installation directory that you created in the previous step. Note: A separate line is required for each DVD path.

Because three DVDs are required several scenarios are applicable. As the DVD path will depend on the scenario chosen, the variable ${DVD_LOCATION} will be used to build each DVD path. The DVD_LOCATION variable could represent one of the following scenarios: 1. Local copy In this scenario the ${DVD_LOCATION} is a local directory like for example c:\SAP_Diagnostcs_agent_DVDs for windows or /SAP_Diagnostcs_agent_DVDs for UNIX system. 2. Drive mapping In this scenario all the DVDs are available throughout the network via some share systems. On Windows platform a share folder as for example \\SAP_Installation_Master_DVD_SR3 could be map to a drive like X: On UNIX platform a share folder could be mounted to /mnt/SAP_Installation_Master_DVD_SR3 Windows [Installation Master] Browse until the IM_<PLATFORM>_<OS> folder. This folder must contain a file named LABEL.ASC. For example: ${DVD_LOCATION}\installation_master\IM_<PLATFORM>_<OS>\LABEL.ASC You must copy into the start_dir.cd file the following line: ${DVD_LOCATION}\installation_master\IM_<PLATFORM>_<OS> [Kernel] Browse until the KU_<PLATFORM>_<OS> folder. This folder must contain a file named LABEL.ASC. For example: ${DVD_LOCATION}\kernel\KU_<PLATFORM>_<OS>\LABEL.ASC You must copy into the start_dir.cd file the following line: ${DVD_LOCATION}\kernel\KU_<PLATFORM>_<OS> [Java] Within the Java DVD, look for the LABEL.ASC file which must be at the same level as the DATA_UNITS folder. For example: ${DVD_LOCATION}\java\LABEL.ASC You must copy into the start_dir.cd file the following line: ${DVD_LOCATION}\java The start_dir.cd file must have the following content on Windows platform: ${DVD_LOCATION}\installation_master\IM_WINDOWS_<OS> ${DVD_LOCATION}\kernel\KU_WINDOWS_<OS> ${DVD_LOCATION}\java

Caution: Please pay attention to keep the same path order as described. UNIX [Installation Master] Browse until the IM_<PLATFORM>_<OS> folder. This folder must contain a file named LABEL.ASC. For example: ${DVD_LOCATION}/installation_master/IM_<PLATFORM>_<OS>/LABEL.ASC You must copy into the start_dir.cd file the following line: ${DVD_LOCATION}/installation_master/IM_<PLATFORM>_<OS> [Kernel] Browse until the KU_<PLATFORM>_<OS> folder. This folder must contain a file named LABEL.ASC. For example: ${DVD_LOCATION}/kernel/KU_<PLATFORM>_<OS>/LABEL.ASC You must copy into the start_dir.cd file the following line: ${DVD_LOCATION}/kernel/KU_<PLATFORM>_<OS> [Java] Within the Java, look for the LABEL.ASC file which must be at the same level as the DATA_UNITS folder. For example: ${DVD_LOCATION}/java/LABEL.ASC You must copy into the start_dir.cd file the following line: ${DVD_LOCATION}/java/ The start_dir.cd file must have the following content on UNIX platform: ${DVD_LOCATION}/installation_master/IM_<PLATFORM>_<OS> ${DVD_LOCATION}/kernel/KU_<PLATFORM>_<OS> ${DVD_LOCATION}/java Caution: Please pay attention to keep the same path order as described.

7.

Identify the product ID(s) for the installation service(s) that are required for your installation scenario.

Proceed as follows: a) Open the file "product.catalog" which is available on the installation master DVD in the folder IM_<PLATFORM>_<OS>. b) Search for " InstallSMD", and get the value component id. For example: <component id="d0e3460" output-dir="INST" product-dir="NW04S/WEBAS/IND/PD" name="InstallSMD" ostype="ind" os="ind" db="ind" ppms-component="NW" ppms-component-release="04S" product="ind" release="ind" table="t_smd_install"> <display-name><![CDATA[Solution Manager Diagnostics Agent Installation]]></display-name> In this example, the parameter has the following value: d0e3460 This value is mandatory to run the installation in unattended mode. This ID represents the SAP Installation Component ID parameter (c.f. SAPINST_EXECUTE_PRODUCT_ID= d0e3460). 8. On the host where you want to run SAPinst in unattended mode, proceed as follows: a) Change to the installation directory. cd ${EXEC_DIR} b) There are 3 parameters mandatory to run the SAPInst in unattended mode which are as follows: SAPINST_PARAMETER_CONTAINER_URL SAPINST_EXECUTE_PRODUCT_ID SAPINST_SKIP_DIALOGS Command line on Windows: C:\unattended\install > c:\installation_master\IM_WINDOWS_I386\sapinst.exe SAPINST_PARAMETER_CONTAINER_URL=c:\unattended\common\inifile.xml SAPINST_EXECUTE_PRODUCT_ID=d0e3460 SAPINST_SKIP_DIALOGS=true Command line on UNIX: /unattended/install > /installation_master/IM_LINUX_I386/sapinst SAPINST_PARAMETER_CONTAINER_URL=/unattended/common/inifile.xml SAPINST_EXECUTE_PRODUCT_ID=d0e3460 SAPINST_SKIP_DIALOGS=true 9. Result: SAPinst installs your agent in unattended mode. You may check the result of the installation by opening the sapinst_dev.log file within the ${EXEC_DIR} directory.