Diagnostics Agent Installation in Unattended Mode with SWPM 1.0 SP5 for NetWeaver higher than 7.0x

Transcription

1 SAP Solution Manager End-to-End Root Cause Analysis Diagnostics Agent Installation in Unattended Mode with SWPM 0 SP5 for NetWeaver higher than 7.0x Document Version May-2014

2 SAP AG Neurottstraße Walldorf Germany T +49/18 05/ F +49/18 05/ Copyright 2014 SAP AG. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. SAP, R/3, mysap, mysap.com, xapps, xapp, SAP NetWeaver, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. Microsoft, Windows, Outlook, and PowerPoint are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iseries, pseries, xseries, zseries, z/os, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, and Informix are trademarks or registered trademarks of IBM Corporation in the United States and/or other countries. Oracle is a registered trademark of Oracle Corporation. UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group. Citrix, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks or registered trademarks of Citrix Systems, Inc. HTML, XML, XHTML and W3C are trademarks or registered trademarks of W3C, World Wide Web Consortium, Massachusetts Institute of Technology. Java is a registered trademark of Sun Microsystems, Inc. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. Disclaimer Some components of this product are based on Java. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java Source Code delivered with this product is only to be used by SAP s Support Services and may not be modified or altered in any way. JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. Documentation on SAP Service Marketplace You can find this documentation at service.sap.com/instguides MaxDB is a trademark of MySQL AB, Sweden.

3 Typographic Conventions Icons Type Style Represents Icon Meaning Example Text Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options. Cross-references to other documentation. Caution Example Note Recommendation Example text Emphasized words or phrases in body text, graphic titles, and table titles. Syntax EXAMPLE TEXT Technical names of system objects. These include report names, program names, transaction codes, table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE. Example text Output on the screen. This includes file and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools. Example text Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation. <Example text> Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system. EXAMPLE TEXT Keys on the keyboard, for example, F2 or ENTER.

4 Contents May 2014 Contents 1 INTRODUCTION Installation and Installation Strategy SAP Solution Manager Diagnostics Agent SAP Notes for the Installation PREPARATION Preparation Checklist Prepare the Installation Environment Modify the Input Parameters (inifile.xml) Createstart_dir.cd File Identify Product ID for Installation INSTALLATION Process Steps Examples Installation Parameters Diagnostics Agent Parameters Operating System Users for the Diagnostics Agent Operating System User for the SAP Host Agent Connectivity for the Diagnostics Agent to System Landscape Directory Connectivity for the Diagnostics Agent to Solution Manager UNINSTALLATION Prepare the Installation Environment Modify the Input Parameters (inifile.xml) Createstart_dir.cd File Identify Product ID for Uninstallation Process Steps ADDITIONAL INFORMATION How to Avoid Automatic Logoff by SAPinst (Windows) Troubleshooting with SAPinst Diagnostics Agent Installation in Unattended Mode I

5 Introduction It is possible to install the Diagnostics Agent in an unattended mode. This means you record all input parameters for an installation scenario, which you can then reuse for further installations. This guide describes how to perform for such installation or uninstallation. 1 Installation and Installation Strategy Before you continue with the unattended mode installation of Diagnostics Agents, you must have defined your installation strategy, and you must have made a decision on whether you want to use the Agents On-the-fly feature or not. Use the latest installer and read the following sections from the corresponding Installation and Setup Guide, before continuing: a. Installation Strategy b. Using Logical Host Names c. Using Virtual Host Names 2 SAP Solution Manager Diagnostics Agent The Diagnostics Agent is the remote component of the E2E Root Cause Analysis. It enables you to establish a connection between SAP Solution Manager as the managing system and the managed system(s) and then to gather information from the managed systems and pass them to the Solution Manager system. 3 SAP Notes for the Installation Before planning the installation of the Diagnostics Agents make sure to read SAP Note : Diagnostics Agent installation with SWPM. The corresponding Installation and Setup Guide contains relevant installation and post-installation information. 2 Preparation 1 Preparation Checklist This section includes the preparation steps that you have to perform. Detailed information about the steps is available in the respective sections. Prerequisites Read SAP Notes for the Installation [page 1] Identify the Installation Strategy (Direct Solution Manager Registration, SLD Registration or None) Check the Hardware Requirements Download the Installation DVDs Read How to Avoid Automatic Logoff by SAPinst (Windows) [page 12] Process Steps Prepare the Installation [page] Modify the Input Parameters (inifile.xml) according to your needs [page 3] Diagnostics Agent Installation in Unattended Mode 1

6 Createstart_dir.cd File [page 3] Identify Product ID for Installation [page 4] Start the Installation [page 5] 2 Prepare the Installation Environment Download theinifile.xml,keydb.dtd anddoc.dtd files (attached to this SAP Note) and save them in a common directory${common_folder} Windows: c:\unattended\common Unix/IBM i: /unattended/common Thekeydb.dtd anddoc.dtd files are required for parsinginifile.xml. Create an installation directory on the host on which you want to run SAPinst in unattended mode. On Unix, make sure that: a) a user group "sapinst" is available. b) "sapinst" is assigned as an additional user group to user root. c) the installation directory is owned by user group "sapinst" and has at least permissions 775. To change the group value, proceed as follows: chgrp R sapinst<directory where the installation is executed and the location of the DVD folders> On IBM i, make sure that: a) a user group "sapinst" is available. If a user profile "sapinst" already exists, you have nothing to do. If no user profile "sapinst" exists, do the following command: CRTUSRPRF USRPRF(SAPINST) GID(*GEN) b) "sapinst" is assigned as an user group to your installation user: CHGUSRPRF USRPRF(<inst_user>) GRPPRF(SAPINST) c) the installation directory is owned by user group "sapinst" and has at least permissions 775: CALL PGM(QP2TERM) PARM('/QOpenSys/usr/bin/chmod' '-R' '775' '<directory where the installation is executed and the location of the DVD folders>') (press F3 to exit the session) Diagnostics Agent Installation in Unattended Mode 2

7 To change the group value, proceed as follows: CALL PGM(QP2TERM) PARM('/QOpenSys/usr/bin/chgrp' '-R' 'sapinst' '<directory where the installation is executed and the location of the DVD folders>') (press F3 to exit the session) 3 Modify the Input Parameters (inifile.xml) The file namedinifile.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. Only the parameters with valueto_be_defined are required to be modified. The other ones can be left as they are. You can enter passwords in plain text. At the first SAPinst 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. For details refer to chapter Installation Parameters [page 5]. After you have made the required changes, you should check the changes you have made using a "diff tool". Most problems that occur with this procedure are due to accidental changes that are made to theinifile.xml file. Double checking your changes against the originally distributed template document will protect you against problems due to accidental changes. 4 Create start_dir.cd File Create an installation directory on the host on which you want to run SAPinst in unattended mode:${exec_dir} Windows: c:\unattended\install Unix/IBM i: /unattended/install Create a file namedstart_dir.cd. It contains the paths to the Installation DVDs (Kernel DVD and Installation Master DVD) required for the unattended installation (To identify and download the Installation DVDs see section 2). Save the filestart_dir.cd in the installation directory that you created in step Edit the filestart_dir.cd. Enter the paths to the Installation Master and Kernel DVDs. A separate line is required for each DVD path. Diagnostics Agent Installation in Unattended Mode 3

8 For each DVD you have to browse until the mainlabel.asc file to identify the paths to add tostart_dir.cd. The table below lists the lines to add to start_dir.cd depending on the product and the DVD. 6. Path [Installation Master] ${DVD_LOCATION}/installation_master [Kernel] ${DVD_LOCATION}/kernel_dvd Savestart_dir.cd Identify Product ID for Installation You need to identify the Product ID for the installation service that is required for your installation scenario. Before starting SAPinst you may want to backup/delete/rename an already existing sapinst_instdir directory. Start SAPinst as described in the Installation Guide. See section a. On the "Welcome to SAP Installation" screen, choose: SAP Installation Master Generic Installation Options Diagnostics in SAP Solution Manager Install - Diagnostics Agent. b. Then press "Next". c. Stop SAPinst as soon as the next screen has appeared. SAPinst has now created a newsapinst_instdir directory structure. Go to the directory and locate and open thesapinst_dev.log file. In thesapinst_dev.log file search for the stringproduct-id. You should find a line like: Running with control file XXX version=xxx changelist=xxx product-id=xxx For SWPM 0 SP5 (for NetWeaver higher than 7.0x) the product-id should be: NW_DiagnosticsAgent:GENERIC.IND.PD This value is required to run the installation in unattended mode. This ID represents the SAP Installation Product ID parameter (SAPINST_EXECUTE_PRODUCT_ID="NW_DiagnosticsAgent:GENERIC.IND.PD") For the "Install - Diagnostics Agent with 741 kernel" installation option, the product-id you need to identify and use below, should be: NW_DiagnosticsAgent:NW740SRIND.PD 6. Before continuing you may want to backup/delete/rename the just created sapinst_instdir directory. Diagnostics Agent Installation in Unattended Mode 4

9 3. 3 Installation 3.1 Process Steps On the host on which you want to run SAPinst in unattended mode, proceed as follows: Change to the installation directory cd ${EXEC_DIR} Start SAPinst with the following parameters (you get an overview of all SAPinst parameters by executionsapinst -p) SAPINST_PARAMETER_CONTAINER_URL=${COMMON_FOLDER}/inifile.xml SAPINST_EXECUTE_PRODUCT_ID=<Product ID> SAPINST_SKIP_DIALOGS=true The command line to execute is as the following one: ${EXEC_DIR} # ${DVD_LOCATION}/installation_master/sapinst SAPINST_PARAMETER_CONTAINER_URL=${COMMON_FOLDER}/inifile.xml SAPINST_EXECUTE_PRODUCT_ID=<Product ID> SAPINST_SKIP_DIALOGS=true Result: SAPinst installs your agent in unattended mode. You may check the result of the installation by opening thesapinst_dev.log file within the${exec_dir}. If you need to start SAPinst with SAPinst GUI, do not specify the SAPINST_SKIP_DIALOGS option. 3.2 Examples Windows C:\unattended\install> c:\installation_master\sapinst.exe SAPINST_PARAMETER_CONTAINER_URL=c:\unattended\common\inifile.xml SAPINST_EXECUTE_PRODUCT_ID="NW_DiagnosticsAgent:GENERIC.IND.PD" SAPINST_SKIP_DIALOGS=true Unix / IBM i /unattended/install> /installation_master/sapinst SAPINST_PARAMETER_CONTAINER_URL=/unattended/common/inifile.xml SAPINST_EXECUTE_PRODUCT_ID="NW_DiagnosticsAgent:GENERIC.IND.PD" SAPINST_SKIP_DIALOGS=true 3.3 Installation Parameters The following tables list all the mandatory or optional parameters needed for the installation. For parameters that are not mandatory, you can leave their value empty: SAPinst will set the value to a default value. Diagnostics Agent Parameters [page 6] Operating System Users for the Diagnostics Agent [page 6] Operating System User for the SAP Host Agent [page 7] Diagnostics Agent Installation in Unattended Mode 5

10 Connectivity for the Diagnostics Agent to System Landscape Directory [page 8] Connectivity for the Diagnostics Agent to Solution Manager [page 8] For more details, please refer to the Installation Guide (See section 2) Diagnostics Agent Parameters Name Description Mandatory sid instancenumber virtualhost System ID<DASID> of Diagnostics Agent SAPinst sets the system ID of Diagnostics Agent,<DASID>, todaa by default. Instance Number of the Diagnostics Agent The instance number is set automatically to the next free and valid instance number (from 98 down to00) that has not yet been assigned to the SAP system. Logical Host Name By default the installer sets the host name to the physical host name. If you want to install a Diagnostics Agent on the physical host, you can leave the virtualhost parameter empty. This is also the recommended way to install a Diagnostics Agent to be used with the Agents On-the-fly feature. You can set the host name to a logical host name if you plan to manage systems running on a logical host. Do not use the FQDN, use the short host name. NO NO NO Operating System Users for the Diagnostics Agent The Diagnostics Agent user<dasid>adm is used to manage the Diagnostics Agent system. Unix/IBM i Before starting to modify the parameters, make sure that you are modifying the correct element: the attributename of its parent element table must not contain the stringnw_saphostagent in its value. Name Description Mandatory SIDAdm_Password OS User password for user<dasid>adm YES if user does not exist SIDAdm_ID User ID for user<dasid>adm NO SIDAdm_Home Home directory for user<dasid>adm NO SIDAdm_Shell Login shell for user<dasid>adm NO Diagnostics Agent Installation in Unattended Mode 6

11 SAPSys_ID Group ID for groupsapsys NO On IBM i the groupsapsys is converted to the groupr3group. Windows Name Description Mandatory sapdomain Domain for the Diagnostics Agent OS Users. SAPinst sets the domain to local by default. NO sidadmpassword OS User password for user<dasid>adm YES sapservicesidpassword sapdrive OS User password for user SAPService<DASID> Base directory for the Diagnostics Agent Modifiable only if thesaploc share does not exist but there are several hard disks on this machine. YES NO but recommended Operating System User for the SAP Host Agent If the SAP Host Agent is already installed on the host, this part is skipped. The SAP Host Agent usersapadm is used for central monitoring services. Unix/IBM i Before starting to modify the parameters, make sure that you are modifying the correct element: the attributename of its parent element table must contain the string NW_SAPHostAgent in its value. Name Description Mandatory SIDAdm_Password OS User password for usersapadm YES if SAP Host Agent not already installed SIDAdm_ID User ID for usersapadm NO SIDAdm_Home Home Directory for usersapadm NO SIDAdm_Shell Login Shell for usersapadm NO SAPSys_ID Group ID for groupsapsys NO On IBM i the groupsapsys is converted to the groupr3group. Diagnostics Agent Installation in Unattended Mode 7

12 Windows Name Description Mandatory sapdomain Domain for the SAP Host Agent OS User SAPinst set the domain to local by default. NO sidadmpassword OS User password for usersapadm YES if SAP Host Agent not already installed Connectivity for the Diagnostics Agent to System Landscape Directory You have identified your Installation Strategy and want to register your Diagnostics Agent in an existing System Landscape Directory (SLD). Name Description Mandatory connection_sld host_sld port_sld SLD Registration Type To register your Diagnostics Agent in an SLD you have to set this parameter to: sld Managing Host HTTP host of the SAP system with the SLD that is assigned to the managed system on which the Diagnostics Agent is being installed Port HTTP port of the SAP system with the SLD that is assigned to the managed system on which the Diagnostics Agent is being installed YES put sld or no YES if connection_sld!= no YES if connection_sld!= no user_sld User YES if connection_sld!= no passwd_sld Password YES if connection_sld!= no needhttps_sld If SSL is used for the SLD connection: true Otherwise: false YES if connection_sld!= no Connectivity for the Diagnostics Agent to Solution Manager You have identified your Installation Strategy and want to do a direct Solution Manager registration. You can choose to directly connect to the Solution Manager system even if you registered it into the SLD during the previous step. Name Description Mandatory connection_solman Connection of the Diagnostics Agent to Solution Manager You can choose between the following options: solman (Configure connection: the YES Diagnostics Agent Installation in Unattended Mode 8

13 Diagnostics Agent is connected to the Solution Manager system) none (Do not configure connection: the Diagnostics Agent is not connected to the Solution Manager system) connection_ms If you choose this option the values of the parameters below are not taken into account. Solution Manager Connection Type You can choose between the following options: ms (P4 Connection via SCS message server) YES if connection_sol man!= none p4 (Direct P4 Connection via Java EE Dispatcher Node) ms_ssl (P4 SSL Connection via SCS message server) p4_ssl (Direct P4 SSL Connection via Java EE Dispatcher Node) host_smd port_smd user_smd Managing Host The fully-qualified host name of the SMD Server Depending on the connection type you have to specify either the HTTP SCS Message Port, or the Dispatcher P4 Port, or the Dispatcher P4 SSL Port of the Java stack in your SAP Solution Manager system. User As of SAP Solution Manager 7.10 SP10 we recommend to use thesmd_agt user of your SAP Solution Manager system. For earlier releases thesmd_admin user is still recommended. YES if connection_sol man!= none YES if connection_sol man!= none YES if connection_sol man!= none passwd_smd Password YES if connection_sol man!= none usessl_solman route Depending on the parameter connection_ms: If SSL is used: true Otherwise: false Route string describing the stations of a connection required between the Diagnostics Agent and Solution Manager. The route string contains a substring for each SAProuter without the target server such as: /H/host/S/service/W/pass /H/ indicates the host name YES if connection_sol man!= none NO Diagnostics Agent Installation in Unattended Mode 9

14 /S/ is used for specifying the service (port); it is an optional entry, the default value is 3299 /W/ indicates the password for the connection between the predecessor and successor on the route and is also optional (default is"", no password) The route between the Diagnostics Agent and Solution Manager can be such as: /H/hostname.sap.com/S/3199 passwd_route Password NO Uninstallation On the host on which you want to run SAPinst in unattended mode, proceed as follows: Prepare the Installation [page 10] Modify the Input Parameters (inifile.xml) according to your needs [page 10] Createstart_dir.cd [page 11] Identify Product ID for Uninstallation [page 11] Execute the Process Steps [page 11] 4.1 Prepare the Installation Environment For the uninstallation theinifile.xml is not provided. You need to create it as follows: Start SAPinst as described in the Installation Guide. See section a. On the "Welcome to SAP Installation" screen, choose: Generic Installation Options Diagnostics in SAP Solution Manager Uninstall - Diagnostics Agent b. On the screen "General SAP System Parameters", select the profile directory of the Diagnostics Agent that you want to uninstall: /usr/sap/<dasid>/sys/profile c. Follow the instructions in the SAPinst input dialogs. Stop SAPinst after the "Parameter Summary" screen has appeared. SAPinst creates theinifile.xml in the installation directory. Copy theinifile.xml,keydb.dtd anddoc.dtd files from the installation directory of the "original" installation and save them in${common_folder}. 4.2 Modify the Input Parameters (inifile.xml) Editinifile.xml and modify the parameters according to your needs. Note that you can only modify the parameters which were covered by the input dialogs you went through in step 4. Diagnostics Agent Installation in Unattended Mode 10

15 4.3 Create start_dir.cd File Create an installation directory on the host on which you want to run SAPinst in unattended mode:${exec_dir} Windows: c:\unattended\uninstall Unix/IBM i: /unattended/uninstall Create a file namedstart_dir.cd. It contains the path to the Installation Master DVD Save the file start_dir.cd in the installation directory that you created in step 1: ${EXEC_DIR}. Edit the filestart_dir.cd. Enter the path to the Installation Master DVD. The table below lists the line to add tostart_dir.cd. Path [Installation Master] ${DVD_LOCATION}/installation_master Savestart_dir.cd. 4.4 Identify Product ID for Uninstallation You need to identify the Product ID for the installation service that is required for your uninstallation. Open the filesapinst_dev.log which is available in the installation directory where you created the fileinifile.xml in step 4. Get the value of the Product ID which is named: product-id= 4.5 Process Steps On the host on which you want to run SAPinst in unattended mode, proceed as follows: Change to the installation directory cd ${EXEC_DIR} For Unix and IBM i systems these directories need to belong to thesapinst group and have at least permissions Start SAPinst with the following parameters SAPINST_PARAMETER_CONTAINER_URL=${COMMON_FOLDER}/inifile.xml SAPINST_EXECUTE_PRODUCT_ID=<Product ID> SAPINST_SKIP_DIALOGS=true The command line to execute is as the following one: Diagnostics Agent Installation in Unattended Mode 11

16 4. ${EXEC_DIR}# ${DVD_LOCATION}/installation_master/sapinst SAPINST_PARAMETER_CONTAINER_URL=${COMMON_FOLDER}/inifile.xml SAPINST_EXECUTE_PRODUCT_ID=<Product ID> SAPINST_SKIP_DIALOGS=true Result: SAPinst uninstalls your agent in unattended mode. You may check the result of the uninstallation by opening thesapinst_dev.log file within the${exec_dir} directory. 5 Additional Information 5.1 How to Avoid Automatic Logoff by SAPinst (Windows) Please refer to the respective section in the Diagnostics Agent Setup Guide for matching Software Provisioning Manager 0 Service Pack. 5.2 Troubleshooting with SAPinst This section tells you how to proceed when errors occur during the installation with SAPinst. If an error occurs, SAPinst: Stops the installation Displays a dialog informing you about the error Procedure Check the log files of SAPinst in the installation directory ${EXEC_DIR}. Diagnostics Agent Installation in Unattended Mode 12