Intro Scope Version 8 Installation Guide

Introscope Version 8Installation GuideFor SAPJune 2009

Introscope Installation for SAP

Introscope® Version 8 Installation Guide for SAP (6/2/2009) Page2

ContentsContents........................................................................................................................................... 21 Installation Overview ............................................................................................................... 32 Upgrading from Previous Versions to Introscope 8................................................................... 73 Installing the Introscope Enterprise Manager .......................................................................... 104 Introscope-Enabling SAP J2EE Systems ................................................................................ 195 Workstation Installation ......................................................................................................... 326 Environment Performance Agent (De)Installation .................................................................. 347 Additional Installation Options ............................................................................................... 35



1 Installation Overview

This document covers the installation and configuration of Introscope in the followingchapters:

• Installation Overview

• Upgrading previous versions to Introscope 8

• Installing Introscope Enterprise Manager

• Introscope-enabling SAP J2EE Systems (Agent Installation)

• Optional: Installing Introscope Workstation

• Environment Performance Agent (De)installation

• Optional Configuration Steps

Introscope OverviewIntroscope is an application management solution created to manage Java Applicationperformance. Unlike development tools, Introscope is designed to scale with minimalperformance impact. This allows you to monitor and manage your application performancein live production environments.

The Right to View (RTV) version of CA-Wily Introscope is a restricted, read-only form of thefull product and is bundled with SAP Solution Manager. With the RTV version, support islimited to products that are licensed and supported by SAP. The instrumentation,dashboards, Probe Builder Directives (PBD’s), management modules, and Smartstor datacontained within the RTV version of CA-Wily Introscope as provided by SAP is theintellectual property of SAP. Use of these functions is restricted by SAP and may only beused in an unrestricted manner by licensing SAP Extended Diagnostics by CA-Wily fromSAP.



Reviewing the Installation and Configuration ProcessYou will be installing the following Introscope components:

• Introscope Enterprise Manager (server component)The Enterprise Manager is typically installed on the Solution Manager host.Alternatively, you can install the Enterprise Manager on a separate host.

The memory and CPU requirements for the Enterprise Manager depend on thenumber of Introscope Agents that you connect and on the complexity of themonitored systems. Typically, for up to ten agents, the default configuration using512MB Java heap (about 1GB main memory) will suffice. For about twentyadditional agents, add 512MB of Java heap to a total of 1024MB (allow 2GB mainmemory). More details on Enterprise Manager Sizing and self-monitoring can befound in the FAQ attached to SAP Note 797147.

• Introscope Java Agent (on the managed systems)The setup of the Java agent is typically done centrally via a setup UI in SolutionManager Diagnostics. Only in exceptional cases manual installation is necessary, asdescribed below. After activation by restarting the Java VM, the agent runs withinthe Java process of the monitored system.

• Host-Level Introscope Agent (on the managed systems)The so-called Introscope Host Agent is installed once per host. It runs as part of theSMDAgent in the SMDAgent process to collect data on operating system level, e.g.,from saposcol, GC logs, ABAP instances, and TREX. The Host Agent generates lessload on the Enterprise Manager than a normal agent. For this reason, it should notbe included in the memory sizing calculation above. The Host agent is configuredautomatically by the SMD setup wizard for managed systems.

In previous releases, the Introscope Environment Performance Agent (EPAgent)took the role of the host-level agent. The EPAgent is now replaced by the host-levelagent. The EPAgent is not supported any more.

• Optionally, you can install the Introscope Workstation on the EnterpriseManager host or any client PC. See the next section for recommendations about theUI for Introscope.

Deciding About the UI for Introscope

There are three different options to access Introscope:

1. Introscope Workstation: Swing-based client user interface, full functionality

a. Explicit installation on the client PC on which you want to use it (see Chapter5).

b. Use Java WebStart to download the Workstation on demand from theEnterprise Manager. No explicit installation of the Workstation is necessary.Requires Java 5 to be installed, default URL:http://emhost:8081/workstation. The workstation will be downloaded onlyonce and is then cached on the client PC. For every new start of theWorkstation the cached version is checked against the Enterprise Manager

http://emhost:8081/workstation



and, if the Enterprise Manager was updated, a new version is downloadedautomatically.

2. Introscope WebView: Browser-based user interface, uses the Microsoft Silverlightbrowser plugin. In some details limited functionality.

WebView is available by default on the Enterprise Manager (no installationnecessary), default URL: http://emhost:8081/webview.

In general using the Workstation should be preferred to WebView since it is more powerful.The most convenient option is to use 1b (Launch Workstation via Java Webstart). Thebinaries are then only downloaded once and after that cached on the client PC. You mayalso decide to install the workstation explicitly on your client PC (1a).

Introscope Access

After installation, you can use the following default credentials to access Introscope:

User Password Access Rights

Admin Admin89 read, run_tracer

Guest guest12 read

Furthermore, you can add live_agent_control and historical_agent_controlpermissions to the Admin user if you want. Please refer to the User Management section inChapter 7 for details.

The Installation Process

The Introscope installation process consists of the following steps:

1. Check SAP Note 797147 for latest updates to the installation procedure and to thisdocument. A list of frequently asked questions for troubleshooting the installation isalso attached to this note.

2. Download installation files from SAP Service Marketplace.

3. Install the Introscope Enterprise Manager on the central monitoring system and addthe management modules.

4. Install the Introscope Java Agents and Host Agents on managed systems.

5. Optional: Install the Introscope Workstation.

Obtain the Latest File Versions

SAP Note 797147

SAP Note 797147 is the central entry point for up to date information regarding theinstallation of Wily Introscope. Review the latest version of this note before you start theinstallation. You also find a list of frequently asked questions attached to the note.

http://emhost:8081/webview



Download Third-Party External Component Package from CA Wily

The Introscope 8.0 installer requires third-party external component package files. Beforestarting an installation or upgrade, you must download these files to your network.

To download the third-party external component package files:

1. Go to http://opensrcd.ca.com/ips/osgi/

2. Download the following files:

eula.txt

The osgiPackages archive appropriate for your system:

o osgiPackages.v1.windows.zip, for a Windows system

o osgiPackages.v1.unix.tar, for a UNIX system (including IBM i)

Save the files in the same directory as the Introscope installer executable. The installer willthen automatically locate this file during the installation process.

Note: The installer does not validate whether you have downloaded the correctarchive for your platform. Be sure you download and specify the correct archivefor your platform.

Download the Latest Updates from the Service Marketplace

Download all files listed in SAP Note 797147 from the SAP Service Marketplace. The noteexplains the exact locations of the files.

Installation Tools

Details on the used installation tools (sapcar and SDM) can be found in the “SupportPackage Stack Guide”: http://service.sap.com/instguidesNW04 -> Operations

http://opensrcd.ca.com/ips/osgi/

http://service.sap.com/instguidesNW04



2 Upgrading from PreviousVersions to Introscope 8

This chapter explains the options to upgrade an Introscope installation to Introscope 8. Ifyou are performing a fresh installation, please proceed to the next chapter.

Version Compatibility and Upgrade Sequence

The Introscope Enterprise Manager supports Introscope Agents of older releases. In otherwords, you can connect with agents of different versions (e.g. version 5, 6, 7.x) toEnterprise Manager Version 8 at the same time. Connecting a new version 8 agent to anolder Enterprise Manager does not work.

WebView, Workstation, and Enterprise Manager must always have the same version andpatch level. Connecting WebView and Enterprise Manager of different versions does notwork.

When using older agents with a newer Enterprise Manager, some charts on the Consolemay remain empty because the SAP customizing assumes that Agents and EnterpriseManager have the same version.

Due to this version dependency we recommend to upgrade sequence:

1. Upgrade Enterprise Manager and Workstation first. This can be done without impacton any monitored systems. Since WebView is running as part of the EnterpriseManager an explicit upgrade of WebView is not needed.

2. Then upgrade the Introscope agents in the monitored systems at your convenience.Upgrading the agents will require a restart of the monitored systems.

Enterprise Manager Upgrade

There is no tool support for an in-place upgrade of the Enterprise Manager. If you want tokeep the performance database (SmartStor) of the previous version or any otherconfiguration settings and if you want to keep the old location, the following procedure isrecommended:

• Shut down the Enterprise Manager via the Windows Services Control Panel or kill onUnix.

• Back up your Enterprise Manager directory, e.g./usr/sap/ccms/wilyintroscope. If you want to keep the historicalperformance data, move the directories /data and /traces to a new location in thefilesystem.

• Windows only: Launch the uninstaller via the Windows Start Menu, e.g. Introscope7.1 Uninstall Introscope



• Move the remaining files from the old installation to a different location, e.g. from/usr/sap/ccms/wilyintroscope to /usr/sap/ccms/wilyintroscope.old

• Perform the new installation to the same directory(/usr/sap/ccms/wilyintroscope) again using the procedure described in thenext section. Make sure you also extract the new management modules files(SAPISMM*.SAR) as described in the next section.

• Shut down the newly installed Enterprise Manager in case it was launched after theinstallation.

• Remove the subdirectories /data and /traces from the new installation if theyexist. They will only be created if the Enterprise Manager is started.

• Copy or move the old subdirectories /data and /traces to the new location. Beaware that the traces database will be migrated to a new format when theEnterprise Manager is launched. As an alternative, you may also decide to drop the/traces directory completely instead of migrating it.

• Manually transfer any custom management modules (located in/config/modules) from the old to the new location. But do not overwrite newlyinstalled standard SAP modules with older versions.

• Manually transfer any customization (Java VM parameter in file IntroscopeEnterprise Manager.lax or EMService.conf or runem.nohup.sh, otherproperties in file config/IntroscopeEnterpriseManager.properties). Donot replace the new configuration files with the old copies since you may then looseany newly introduced properties. Instead, copy and paste any customization fromyour old files.

Agent Upgrade

All agent installations and upgrades can (and should) be done centrally by theadministration tools of Solution Manager. The only manual steps are to restart themanaged systems after any configuration change and to undeploy the JmxService J2EEapplication (com.wilytech.jmxservice), which is no longer needed.

In case you want to do a manual upgrade, to get rid of any obsolete files we recommendperforming a fresh installation, e.g. by moving the old agent installation to a differentdirectory. Since some agent files are locked while the monitored system is running, themonitored system must be down for the agent upgrade.

Also for the manual upgrade, the JmxService J2EE application is no longer needed startingwith release 7.1p9 of the Introscope agent. Please undeploy the old version with SDM.

WebView Upgrade

Starting with Introscope 7.1 the Enterprise Manager already contains an embeddedWebView that is run as part of the Enterprise Manager Java process. It is no longernecessary to deploy it on NetWeaver, and support for deploying WebView on Netweaver isstopped as of Introscope release 7.2. You should undeploy the old version of WebView onNetWeaver (com.wilytech.webview). WebView running in the Enterprise Manager is by



default reached via the URL http://emhost:8081/webview. The former URLhttp://smdhost:5xx00/webview is no longer valid for this operating mode.




3 Installing the IntroscopeEnterprise Manager

To install the Introscope Enterprise Manager, you will run the installer file and add someSAP customization (management modules, scripts, etc.).

Installation User

You should run the installer with the same user account that will be used later on forrunning the Enterprise Manager. In particular, on Unix operating systems do not use theroot account to launch the installer. A common best practice is to use the sidadm user ofthe Solution Manager installation to install and run the Enterprise Manager.

Choose the Enterprise Manager Installer File

Depending on the operating system on which you want to install the Enterprise Manager,different installation files must be chosen. The first table below lists the platforms for whicha platform specific installer with a bundled Java VM is available. If you find your operatingsystem listed here, download the file SAPISEM*.SAR from the corresponding folder on theService Marketplace (see Note 797147 for the exact location). The file names listed belowmay vary slightly for patch updates to the Enterprise Manager.

Operating System Installer Filename

AIX5 64bit introscope8.0.1.1aix64SAP.bin

IBM i introscope8.0.1.1os400SAP.jar

HP-UX 11 on PA-RISC 32bitHP-UX 11 on PA-RISC 64bit*

Introscope8.0.1.1hpuxSAP.bin

HP-UX 11 on IA64 introscope8.0.1.1hpuxIA64SAP.bin

Linux on IA32 32bit introscope8.0.1.1linuxSAP.bin

Linux on x86_64 64bit introscope8.0.1.1linuxAmd64SAP.bin



Solaris on SPARC 32bitSolaris on SPARC 64bit*

introscope8.0.1.1solarisSAP.bin

Windows IA32 introscope8.0.1.1windowsSAP.exe

Windows x86_64 64bit introscope8.0.1.1windowsAMD64SAP.exe

Windows on IA64 introscope8.0.1.1windowsitanium64SAP.exe

* For Solaris SPARC and HPUX on PA RISC only 32-bit installers are available. If you wantto run the Enterprise Manager on a 64 Java VM, you can exchange the Java VM after theinstallation. See below for details. Note, however, that you will not see any benefit fromswitching to a 64-bit VM unless you have to extend the Java heap (-Xmx) to a value that isnot possible with a 32-bit VM – just the opposite: When switching to a 64 bit VM the sameEM configuration will have less capacity than before due to the 64-bit intrinsic overhead.

Platform Independent Introscope Installer

If you do not find your operating system in the table above, you can use the genericinstaller for the operating systems listed below. Installation includes one additional stepthen:

1. Install a Java 5 VM

2. Launch the OS-independent installer

The operating system independent installer is contained in the file SAPISEM80.SAR of thefolder #OS independent on the Service Marketplace.

Operating System Java 5 VM Download Link

Linux on IA 64bit http://commerce.bea.com/products/weblogicjrockit/jrockit_prod_fam-bea.jspClick on JRockit 5.0, Agree to terms,Download JRockit 5.0 R27 JDK Linux (IntelItanium - 64-bit)

Linux on Power 64bit http://www.ibm.com/developerworks/java/jdk/linux/download.html, select 64-bit iSeries/pSeries incolumn J2SE 5.0

http://www.ibm.com/developerworks/java/jdk/linux/download.html




Linux on zSeries 64bit http://www.ibm.com/developerworks/java/jdk/linux/download.html, select 64-bit zSeries (S/390) incolumn J2SE 5.0

Solaris on x86_64 64bit http://java.sun.com/javase/downloads/index_jdk5.jsp,select Solaris x86 Platform and Solaris x64Platform - J2SE(TM) Development Kit 5.0 latestUpdate, accept license

Extract the Introscope Installer

Extract the SAR file with the following command:

SAPCAR –xvf SAPISEM*.SAR

As a result you will find two files: The file installer.properties which configures theinstallation procedure and one of the installer files mentioned above, depending on yourplatform.

The Introscope installer will perform an automated install of Introscope components. TheIntroscope installer is invoked from the command line and runs “silently”, getting its inputfrom the response file installer.properties. The installer runs in the background as itinstalls Introscope components, and doesn’t provide any feedback.

After installation, you can check the results in the installer logs.

When launching the installer, make sure the installer.properties file is in the samedirectory as the .exe / .bin / .jar file! If the installer.properties file does not exist, youwill get an graphical installation wizard.

Optional: Configuring the Installation Directory

The installation of the Enterprise Manager by default goes to the following directories:

• Windows: C:\usr\sap\ccms\wilyintroscope

• Unix / IBM i: /usr/sap/ccms/wilyintroscope

If you want to change this directory, e.g., because your SAP installation is located on adifferent Windows drive, use one of the following alternatives.

Note: Use slash (/) as path separator for all platforms, including Windows!

Alternative 1: Set the Installation Directory via Command Line Option

1. Open a command prompt and go to the directory where the installer file and the fileinstaller.properties are located.

2. Add the option –DUSER_INSTALL_DIR=<installation directory> to the invocation ofthe installer (see below), .e.g.,



http://java.sun.com/javase/downloads/index_jdk5.jsp



introscope8.0.1.1windows.SAP.exe–DUSER_INSTALL_DIR=d:/usr/sap/ccms/wilyintroscope.

Alternative 2: Edit installer.properties

1. Open the file installer.properties in a text editor.

2. Locate the USER_INSTALL_DIR property.

To change the install directory location, enter the desired location in theUSER_INSTALL_DIR property.

Note: The instructions in this guide will use examples relative to the defaultinstallation directory.

Add the External Component Package

Copy the External Component Package

Copy the two files that you downloaded from CA Wily’s FTP server to the directory whichcontains the installer (see Chapter 1, Download Third-Party External ComponentPackage from CA Wily). The following files should be copied:

eula.txt

The osgiPackages archive appropriate for your system:

o osgiPackages.v1.windows.zip, for a Windows system

o osgiPackages.v1.unix.tar, for a UNIX system (including IBM i)

Accept the License

Open the file eula.txt in a text editor, read the license, and modify the last line to readLGPL=accept. If the license is not accepted installation will fail.

Start the Installer

1. Launch the installer for your platform using the appropriate command:

• For Windows, double-click on the introscope8.0.1.1windows.SAP.exe, orlaunch from command-line with the following command:

Introscope8.0.1.1windows.SAP.exe

• For any other platform-dependent installer, use the command in the followingexample. You may have to set the right permission before you can launch theinstallation:

./introscope8.0.1.1solaris.SAP.bin

• For the IBM i installer you first need to determine the JDK that you will be using.Wily introscope requires a JDK 5. Depending on the operating system version youare using you should prefer IBM IT4J (J9) over the IBM Classic JVM. Here is a list of



the JAVA_HOME directories and the according IBM I product options that need to beinstalled:

IBM i 6.1: /QOpenSys/QIBM/ProdData/JavaVM/jdk50/64bit/jre (5761JV1 Opt. 9)

i5/OS V5R4: /QOpenSys/QIBM/ProdData/JavaVM/jdk50/32bit/jre (5722JV1 Opt.8)

i5/OS V5R3: /QIBM/ProdData/Java400/jdk15 (5722JV1 Opt. 7)

Then, run the following command in QSH:

<JAVA_HOME>/bin/java –Djava.version=1.5 –classpathintroscope8.0.1.1os400SAP.jar install

• For the platform independent installer that does not contain a bundled Java VM usethe following command. /some/path/java refers to the Java 5 VM that youinstalled as described above:

/some/path/java –classpath introscope8.0.1.1otherUnixSAP.jar install

Note: In any case, the configuration file installer.properties must be located inthe current directory where you launch the installer. You can avoid copying theinstallation file itself by using the complete path to the executable.

2. Verify installation using instructions in the following section, Verifying Installation.

Verifying Installation

The installer does not give confirmation of successful installation on the console. Toconfirm installation was successful:

1. Verify that the Introscope directory exists at:

• <drive>:\usr\sap\ccms\wilyintroscope (Windows)

• /usr/sap/ccms/wilyintroscope (Unix, IBM i)

OR the location you specified.

2. Open the file,/usr/sap/ccms/wilyintroscope/install/Introscope_<version>_InstallLog.log.

3. Verify that the following lines appear in the file:

Summary-------

Installation: Successful.

384 Successes0 Warnings0 NonFatalErrors0 FatalErrors

Note: The number of successes may be different than what is shown in this example.



Adapt Java VM and Java VM Parameters

Depending on the startup mode the Java VM and the Java VM parameters are adapted indifferent locations:

EMService.conf: Used when Enterprise Manager is running as Windows Service onWindows platforms. The property wrapper.java.command defines the Java VM touse. Increase the value of adapt wrapper.java.maxmemory to increase the Javaheap (corresponds to –Xmx).

Introscope_Enterprise_Manager.lax: Enterprise Manager launched with scriptIntroscope_Enterprise_Manager (typically only on Unix). Adaptlax.nl.current.vm to the full path of the VM to use (if you want to change thedefault) and use lax.nl.java.option.additional to modify Java VMparameters.

runem.sh: Used when Enterprise Manager is launched on IBM i. Adapt the JVM_ARGSenvironment variable.

The following Java VM parameter changes should be considered:

Increase the heap size (–Xmx) of the Enterprise Manager if you have more than~10 agents.

Enter the absolute path to a Java 5 VM if you want to use a Java VM that is notbundled with the installer. In particular, you have to do this in two cases:

o Enter the path of a separately installed 64 bit Java 5 VM for platforms onwhich by default only a 32 bit VM is provided:

Solaris on SPARC

HPUX on PA RISC

o Enter the path of a separately installed Java 5 VM for platforms where youused the platform independent installer.

Set the Java VM parameter –Djava.awt.headless=true for all platforms.Otherwise, the Enterprise Manager will need an X server, i.e., the DISPLAYenvironment variable must point to a valid X Windows server.

Set the Java VM parameter –Dswing.volatileImageBufferEnabled=false for allplatforms based on the Sun VM in case you see display problems with WebView.

On IBM i, set the Java heap size properties based on the JVM

o IT4J (J9): -Xms512m -Xmx512m

o IBM Classic: -Xms64m -Xmx2048m

Add the following parameters: -verbose:gc -Djava.version=1.5



Install the SAP Management Modules

Extract the file SAPISMM80_xx.SAR in the home directory of the Enterprise Managerinstallation, e.g., /usr/sap/ccms/wilyintroscope.

Example:

cd /usr/sap/ccms/wilyintroscopeSAPCAR –xvf SAPISMM80_xx.SAR

As a result you will find one or more .jar files in the subdirectory config/modules,some .js files in the subdirectory scripts, and some other files distributed over theEnterprise Manager installation.

The newly installed management modules only become active after the EnterpriseManager is (re-)started. For Windows installations the Enterprise Manager is typicallyautomatically launched as Windows Service. This means you will have to restart theWindows Service for the Enterprise Manager.

Launch Enterprise Manager as Windows Service

To launch the Enterprise Manager automatically at system restart, it is registered asWindows service (On Unix you should run it as background process). To check, perform thefollowing:

1. Open the Services Control Panel (Start Menu Control Panel Administrative ToolsServices) and check that the service “Introscope Enterprise Manager” has beencreated.

2. Start the service if it is not yet running.

Running the Enterprise Manager on UNIX

On Unix platforms a shell script is provided to start and stop the Introscope EnterpriseManager.

1. Go to the subdirectory /bin of the Enterprise Manager installation and issue thefollowing command to launch the Enterprise Manager. Make sure to use the correct useraccount when launching the EM:

./EMCtrl.sh start

The shell script launches the Enterprise Manager in background mode (via nohup). It is notnecessary to explicitly use nohup for EMCtrl.sh.

Consider launching the Enterprise Manager automatically at system startup. Typically, youwill have to hook it into one of the operating system specific init scripts.

Running the Enterprise Manager on IBM i

It is recommended to create an own subsystem for running the Wily Introscope EnterpriseManager on IBM i.



To set this up, you have to run a set of commands. This should be done ideally as the userthat the Wily Introscope Enterprise Manager will run under. If this user is not authorized forsome commands, do run the commands as user that is authorized (e.g. QSECOFR) andchange the ownership of the created objects afterwards.

This is what needs to be done:

CRTLIB LIB(WILYEM) TEXT('Wily EM library')

CRTJOBQ JOBQ(WILYEM/WILYJOBQ) TEXT('Wily EM job queue')

CRTJOBD JOBD(WILYEM/WILYJOBD) JOBQ(WILYEM/WILYJOBQ) TEXT('Wily EM jobdescription') USER(<Your User>) RQSDTA('QSH CMD(''cd/usr/sap/ccms/wilyintroscope/bin && ./EMCtrl.sh start'')')

CRTCLS CLS(WILYEM/WILYCLS) TEXT('Wily EM job class')

CRTSBSD SBSD(WILYEM/WILYSBS) POOLS((1 *BASE)) TEXT('Wily EM subsystem')

ADDRTGE SBSD(WILYEM/WILYSBS) SEQNBR(1) CMPVAL(*ANY) PGM(QSYS/QCMD)POOLID(1) CLS(WILYEM/WILYCLS)

ADDJOBQE SBSD(WILYEM/WILYSBS) JOBQ(WILYEM/WILYJOBQ) MAXACT(*NOMAX)

ADDAJE SBSD(WILYEM/WILYSBS) JOB(WILYEM) JOBD(WILYEM/WILYJOBD)

If you can not run the commands as the Wily EM user, you have to changeownerships by executing the following commands:

CHGOBJOWN OBJ(WILYEM) OBJTYPE(*LIB) NEWOWN(<Your User>)

CHGOBJOWN OBJ(WILYEM/WILYJOBQ) OBJTYPE(*JOBQ) NEWOWN(<Your User>)

CHGOBJOWN OBJ(WILYEM/WILYJOBD) OBJTYPE(*JOBD) NEWOWN(<Your User>)

CHGOBJOWN OBJ(WILYEM/WILYCLS) OBJTYPE(*CLS) NEWOWN(<Your User>)

CHGOBJOWN OBJ(WILYEM/WILYSBS) OBJTYPE(*SBSD) NEWOWN(<Your User>)

<Your User> can be any user, for example the <SID>ADM of your Solution Managersystem. This user needs to have access to the files in /usr/sap/ccms/wilyintroscope.You can ensure this by running

chown –R <Your User> /usr/sap/ccms/wilyintroscope

in QSHELL or QP2TERM.

To activate the Wily Enterprise Manager at system startup, you need to add the start ofsubsystem WILYEM/WILYSBS to your startup program (QSTRUP).



For controlling (starting/stopping) the Wily Enterprise Manager you can use the EMCtrl.shscript as in Unix. However, be aware that the Wily Enterprise Manager job will run in yourcurrent subsystem if you start it from a shell with “EMCtrl.sh start”.

Check That Introscope Is Running ProperlyAfter you have launched the Enterprise Manager, check that it is running properly.

1. Locate the Enterprise Manager log at <Introscopehome>/logs/IntroscopeEnterpriseManager.log.

2. Check that the Enterprise Manager has started. Look for the following line in thelogfile:

11/28/06 10:54:36 AM CET [INFO] [Manager] Introscope EnterpriseManager started.

3. Check the TCP port that Introscope Enterprise Manager is using for agent connections.Look for lines similar to the following in the logfile:

[INFO] [Manager.PostOfficeHub] Server listening for incoming defaultsocket connections on port 6001

In this case, the Enterprise Manager agent port is 6001 (default value).



4 Introscope-Enabling SAP J2EESystems

After you have installed the Enterprise Manager, you are ready to install and configure theIntroscope Agent and Introscope-enable your Java Applications.

Note: The recommended procedure to install and customize theIntroscope Agent is to use the setup wizard provided in SolutionManager Diagnostics. If you do not have Solution ManagerDiagnostics available follow the manual procedure described in thesecond section of this chapter below.

Automated Installation of the Introscope Agent via SMDThe Solution Manager Diagnostics provides an application that performs the setup of theIntroscope bytecode agent for Java automatically. This section explains the steps to runthe setup. Before you can run the Introscope agent setup, the setup wizard for themanaged system must have been executed.

1. Enable Maintenance Mode on SMD.

2. Deploy ISAGENTSMD80_xx.SCA using SDM.

3. Disable Maintenance Mode on SMD.

4. Launch the Introscope Setup application: Diagnostics Setup Managed SystemsIntroscope Agent. Your screen will look similar to the image below:



5. Check the Enterprise Manager Settings at the top of the screen. These are theconnection parameters that will be used by the agent to connect to the EnterpriseManager.

6. In the pane Introscope Agent Setttings, select the system that you want to instrumentwith the agent. Check “select all” and click “Retrieve Current Settings”. This will displaythe current status of the agent setup.

7. To initially setup or update the agents, click Setup Introscope Agent …. This will openthe setup dialog as shown below. Select the desired agent version (by default only oneavailable) and choose the profile. Next, check the desired instrumentation areas, and,in the case of AIX, review the AIX settings to match your environment (J9 or classicmode).

8. Finally, hit Apply to perform the necessary changes in the agent configuration. Agentconfig files will be adapted, an Autoprobe connector will be created if necessary, andthe Java VM parameters will be set as required for the managed system.

9. For Netweaver 7.1: You may see a dialog asking to manually set the JVM parametersvia the ConfigTool. Use the Configtool to set the parameters as described. ForNetweaver 7.11, this dialog should not show up.



10.If the setup was successful, restart the managed system at your convenience, e.g. inthe next maintenance window. After the restart, the agent will be active and shouldshow up in the Introscope UIs.

Manual Installation of the Introscope AgentThis section describes the manual configuration of Introscope bytecode agent for Java.These steps are only required if the automated installation, described in the previoussection, could not be applied. The following instructions are valid for SAP J2EE versions6.20, 6.40, 7.00, and 7.10 and higher.



The instructions in the following section work on both Windows and Unix systems, but theexamples show Windows convention (backslashes in the paths).

Note: Always use forward slashes (/) as path separators for Introscope config files and forJVM parameters on all platforms including Windows. This avoids the need to escapethe Windows path separator backslash (\) by doubling it.

The following steps are required to install and configure the Introscope Agent to reportinformation to the Enterprise Manager:

1. Extract the Introscope Agent files

2. Create the Introscope Agent autoprobe connector (not for IBM i Classic VM and Java5)

3. Introscope-enable the application code by setting Java VM parameters

Extract the Introscope Agent

To install the Introscope Agent:

1. Extract the agent installer file into the NetWeaver CCMS directory, usually:

<drive>:\usr\sap\ccms.SAPCAR –xvf ISAGENT80*.SAR

2. Confirm the Agent was installed correctly by checking for the existence of the /wilydirectory in the <drive>:\usr\sap\ccms directory.

Configuring Introscope Agent Settings

The following section details how to configure the Introscope Agent. The Agentconfiguration settings are found by default in the file/usr/sap/ccms/wily/IntroscopeAgent.profile. This guide will refer to theIntroscopeAgent.profile file as the Agent profile. Note that this file containsSAP-specific customization. Furthermore, depending on the monitored solution you needto choose different profiles:

Choose the Right Agent Profile

SAP provides two agent profiles for different use cases. For all applications running on theSAP J2EE Engine use IntroscopeAgent.profile. The second profileIntroscopeAgent_ipc.profile is intended for SAP IPC 4.0. All profiles adhere to thename pattern IntroscopeAgent*.profile. Note that the profile names have changedstarting with the 7.2.2.0 (72_02) release:

File Name Applications Covered

IntroscopeAgent.profile SAP Netweaver (Java stack)



IntroscopeAgent_ipc.profile SAP IPC (IPC 4.0 only, not VMC)

Note: For Introscope-enabling SAP IPC, please also check SAP Note 886600.

You will need to configure the host name or IP address and port of the machine where theEnterprise Manager resides.

To configure the Introscope Agent:

1. Open the agent profile, e.g. file<drive>:\usr\sap\ccms\wily\IntroscopeAgent.profile.

2. Locate the property,introscope.agent.enterprisemanager.transport.tcp.host.DEFAULT.

Enter either the host name or IP address of the machine where Enterprise Managerresides.

3. Locate the property,introscope.agent.enterprisemanager.transport.tcp.port.DEFAULT.

The value should be the port on which the Enterprise Manager listens for Agentconnections.

Default setting is 6001.

4. Save changes to the agent profile.

Choose the Right Instrumentation Packages

The instrumentation is split into several JAR packages. You can customize the list ofpackages by modifying the property introscope.autoprobe.directivesFile. By default,the following packages are active:introscope.autoprobe.directivesFile=sap_typical.jar,sap_ep.jar,sap_xi_typical.jar,sap_ep_iviews.jar

This instrumentation covers standard SAP J2EE (e.g. Servlets, database/JDBC, JCO/RFC,web services, user management, etc.), Portal, and XI functionality. There are additionalinstrumentation sections which are not active by default. You can add entries to theproperty, separated by comma:

sap_sapvm.jar SAP J2EE 7.10 and JDK5 specificinstrumentation, e.g. memoryallocation. Do not activate for Java1.4!

sap_ep_iviews_rolename.jar Re-activate metrics for eachiView/rolename combination. Activateonly one of these 2:sap_ep_iviews.jar orsap_ep_iviews_rolename.jar!



sap_duet.jar SAP Duet specific instrumentationsap_smd.jar Solution Manager self-monitoringsap_partner.jar Instrumentation for SAP partner and

acquisition products- GRC

- Redwood CPS

- …

Check the Agent Log File Location

By default, the Introscope agents write log files to the subdirectory logs of the agentinstallation (e.g. /usr/sap/ccms/wily/logs). On Unix systems, make sure that themonitored systems (user sidadm) have read and write access to this directory (writepermission for group sapsys). As an alternative, you can change the propertiesintroscope.autoprobe.logfile and log4j.appender.logfile.File to some otherdirectories where the monitored systems have write access.

Configuring JVM AutoProbe

You have to create a so-called AutoProbe connector that fits for the Java VM that you use.

This step is not required for Java 5 VMs and not for an IBM Classic Java VM running on IBMi Instead, different VM parameters are used for these platforms.

Important Note: You should re-create the AutoProbe connector everytime you update the JVM that is used for the SAP J2EE nodes, even if youjust change the patch level, e.g., from 1.4.2_04 to 1.4.2_05! For thisreason it is also important that you specify exactly the same JVM that isactually used by the SAP J2EE nodes.

The following section details how to configure JVM AutoProbe.

For AIX with the IBM J9 Hybrid VM please see SAP Note 1015184—there are specialparameters to pass when creating the autoprobe connector and when launching the VM.

Creating an AutoProbe Connector

Use the CreateAutoProbeConnector.jar tool to create a connector specific to the JVMused to run the application server. There are two ways to specify the JVM:

• use the JVM that is running the tool

• pass the JVM directory on the command line to the tool

1. Change the working directory to wily\connectors.



2. Run the Create AutoProbe Connector tool using the following command:

• Make sure to specify exactly the JVM that is used for launching the J2EE node bypassing the JVM directory <java_home> on the command line:

java -jar CreateAutoProbeConnector.jar -jvm <java_home> -outputconnector.jar

Example:

java -jar CreateAutoProbeConnector.jar -jvm C:/soft/jdk14 -outputconnector.jar

3. The output is the file connector.jar in the same directory.

Activating the Agent: Set Java VM Parameters

After you have created the AutoProbe Connector, you must add three Java VM options.Typically, you will only want to activate the agent on the SAP J2EE server nodes, not ondispatchers and state controllers.

Note that for class path and directory paths, you can use forward slashes (/) on allplatforms, even on Windows. For SAP J2EE 6.40, you even cannot use backslash (\) onWindows. Furthermore, note the difference between Unix and Windows in the class path:The entries are separated by ; on Windows, but by : on Unix.

Agent Name

You should assign a unique name to each SAP J2EE node that is Introscope-enabled. Thisso-called agent name is assigned by an additional Java VM option (referred to as<AgentName> below). SAP suggests the following naming convention for the agent name.This is also generated by the automated setup via Solution Manager Diagnostics startingwith SP14:

<AgentName>=SID_Instance_Nodename

Where the placeholder mean the following:

Placeholder Explanation Example

SID SystemID EPP, EPQ, EPD

Instance Name of the instance JC00, J01, DVEBMGS00

Nodename J2EE node name / directory server0

Note: It is not necessary to integrate the host name into the agent name, since the hostname is assigned automatically to the agent.



Using a unique naming convention for all agent installations helps to group agents thatbelong to the same installation together.

Set Java VM Parameters for SAP J2EE 6.20

The procedure to add JVM options depends on the startup method for the J2EE nodes.Check SAP Note 697062 for instructions to set JVM options for your specific startupmethod. The following procedure is an example in case you use SAP J2EE startupframework for J2EE 6.20:

1. Open the file:

<drive>:\usr\sap\<J2EE_ENGINE_ID>\j2ee\j2ee_<INSTANCE>\configtool\service.ini

2. Append the following commands to JavaParameters (Windows example):

-Xbootclasspath/p:<drive>:/usr/sap/ccms/wily/connectors/connector.jar;<drive>:/usr/sap/ccms/wily/Agent.jar-Dcom.wily.introscope.agentProfile=<drive>:/usr/sap/ccms/wily/IntroscopeAgent.profile-Dcom.wily.introscope.agent.agentName=<AgentName>

Unix example:

-Xbootclasspath/p:/usr/sap/ccms/wily/connectors/connector.jar:/usr/sap/ccms/wily/Agent.jar-Dcom.wily.introscope.agentProfile=/usr/sap/ccms/wily/IntroscopeAgent.profile-Dcom.wily.introscope.agent.agentName=<AgentName>

3. Restart SAP server.

Set Java VM Parameters for NetWeaver 04 / SAP J2EE 6.40 andNetweaver2004s / SAP J2EE 7.00

1. Run the SAP J2EE Configtool.

2. Select the server to modify.

3. In the Java Parameters field, add the following new java parameters (Windowsexample):

-Xbootclasspath/p:<drive>:/usr/sap/ccms/wily/connectors/connector.jar;<drive>:/usr/sap/ccms/wily/Agent.jar



-Dcom.wily.introscope.agentProfile=<drive>:/usr/sap/ccms/wily/IntroscopeAgent.profile-Dcom.wily.introscope.agent.agentName=<AgentName>

Note: Note that for NetWeaver 6.40 on Windows, the slashes for these javaparameters must go forwards.

Unix example:

-Xbootclasspath/p:/usr/sap/ccms/wily/connectors/connector.jar:/usr/sap/ccms/wily/Agent.jar-Dcom.wily.introscope.agentProfile=/usr/sap/ccms/wily/IntroscopeAgent.profile-Dcom.wily.introscope.agent.agentName=<AgentName>

IBM i Classic VM example:

-Xbootclasspath/p:/QIBM/ProdData/Java400/jdk14/lib/instrumentation.jar:/usr/sap/ccms/wily/Agent.jar-agentlib:QJVAIAGENT=/usr/sap/ccms/wily/Agent.jar-Dos400.jvmti.force.jitc-Dcom.wily.introscope.agentProfile=/usr/sap/ccms/wily/IntroscopeAgent.profile-Dcom.wily.introscope.agent.agentName=<AgentName>

4. Click the disk button to save.

5. Repeat steps 2 - 4 for each server node.

6. Restart the SAP instance.

7. To verify that Config tool changes were made, open the file:

<drive>:\usr\sap\<SID>\<instance>\j2ee\cluster\instance.properties

8. Check for a line beginning with ID<server_id>.JavaParameters, and see if itcontains the lines you entered in the step above.

Set Java VM Parameters for NetWeaver versions based on the Java5 VM (Netweaver 7.10 and up, Netweaver CE)

For Netweaver 7.1 and up there are no node-specific Java VM parameters. For this reason,the nodename part of the agent name must be calculated dynamically by using the variable$[elem/Name]. At run time, this will be filled in with the node name. In the example below,variables are also used for the SID and the instance name. They will be replacedautomatically if you use the string exactly as written below.



Example: Enter ${SYSTEM_NAME}_${INSTANCE_NAME}_$[elem/Name] in the Configtool. For thefirst node, it will be replaced with PP1_JC00_server0.

1. Run the SAP J2EE Configtool.

2. Navigate to Instance/VM Parameters/System and enter the following new parameters(Windows example):

Name Valuecom.wily.introscope.agent.agentName ${SYSTEM_NAME}_${INSTANCE_NAME}_$[elem/Name]com.wily.introscope.agentProfile <drive>:/usr/sap/ccms/wily

/IntroscopeAgent.profile

3. Navigate to Instance/VM Parameters/Additional and enter the following new javaparameter (Windows example):

-javaagent:<drive>:/usr/sap/ccms/wily/Agent.jar

Note that for NetWeaver on Windows, the slashes for these java parameters must goforwards.

Unix example:

Instance/VM Parameters/System:Name Valuecom.wily.introscope.agent.agentName ${SYSTEM_NAME}_${INSTANCE_NAME}_$[elem/Name]com.wily.introscope.agentProfile /usr/sap/ccms/wily/IntroscopeAgent.profile

Instance/VM Parameters/Additional:Name-javaagent:/usr/sap/ccms/wily/Agent.jar

4. Click the disk button to save.

5. Repeat steps 2 - 4 for each instance.

6. Restart the SAP instance.

7. To verify that Config tool changes were made, open the file:

<drive>:\usr\sap\<SID>\<instance>\j2ee\cluster\instance.properties

8. Check for a line beginning with ID<server_id>.JavaParameters, and see if itcontains the lines you entered in the step above.

Set Java VM Parameters for SAP IPC

The procedure to add JVM options for the IPC to enable Introscope is described in SAP Note886600. Note that Introscope does not support IPC running in the VM container (VMC) asit is delivered for SAP CRM 5.0.



Set Java VM Parameters for SAP xMII 11.5

You have to modify the .bat file that launches the servlet engine. A typical location for thefile is C:\servletExec AS\se-LHCMS\StartServletExec.bat. Add the followingJava VM parameters:

-Xbootclasspath/p:<drive>:/usr/sap/ccms/wily/connectors/connector.jar;<drive>:/usr/sap/ccms/wily/Agent.jar-Dcom.wily.introscope.agentProfile=<drive>:/usr/sap/ccms/wily/IntroscopeAgent.profile-Dcom.wily.introscope.agent.agentName=<AgentName>

Further information on integrating xMII into Solution Manager Diagnostics can be found inSAP Note 903825.

Checking that the Agent is Running

1. Check that the SAP J2EE nodes start up correctly after the restart and that the J2EEapplications are available as before.

2. Search for an Agent log file in the logs subdirectory of the Introscope agent directory,e.g., in the directory /usr/sap/ccms/wily/logs. The file will be namedIntroscopeAgent.<AgentName>.log, where <AgentName> is the name that youassigned via the JVM parameter above. Open the text file with a text editor and checkthe last lines. You will probably find warnings that the connection to the EnterpriseManager failed – since you have not yet started the Enterprise Manager.

EXAMPLE

The last few lines of the agent log file should similar to the following:

12/06/06 01:41:46 PM PST [INFO] [IntroscopeAgent.IsengardServerConnectionManager]

Connected Agent to the Introscope Enterprise Manager atlocalhost:6001,com.wily.isengard.postofficehub.link.net.DefaultSocketFactory. Host ="emhost", Process = "SAP Netweaver", Agent Name = "xxx_server0".

Check that the Agent is RunningLaunch the Introscope Workstation to check if the data provided by the agent arrivesat the Enterprise Manager. For this purpose, launch the Workstation in a browser:


You should get a login prompt as shown below. Use login credentials from the table inChapter 1 to authenticate. As an alternative, you can also launch a Workstation thatyou explicitly installed or WebView (http://emhost:8081/webview).





Open the Investigator (Workstation menu New Investigator) to display a tree of allconnected hosts and agents. Click the plus signs to open subtrees. For each connectedagent, you should find a subtree host SAP Netweaver AgentName in theInvestigator that looks similar to the screenshot below. Depending on the type of themanaged system, some tree nodes may be missing.

Please check the following:

If your managed system is running SAP J2EE, you should at least have SAPJ2EE.

CPU is only available on some Windows, Solaris, and Linux platforms, so thismay indeed be missing.

Some nodes will only appear after first use. For example, Servlets will onlyappear after the first servlet has been executed.



5 Workstation Installation

If you decide to explicitly install the Introscope Workstation on Client PCs, proceed asdescribed in this section. Note that the workstation can always be downloaded on demandfrom the Enterprise Manager using Java WebStart, as described in Chapter 1.

Installers are available for the following platforms:

Windows 32bit

Windows x86_64

Linux IA32

Linux x86_64

The installation is described here for Windows. If you want to install it on Linux, rememberto set the DISPLAY before launching the installer.

1. Extract the downloaded Workstation installer:sapcar –xvf SAPISWS80.SAR

2. Copy the two files that you downloaded from CA Wily’s FTP server to the directorywhich contains the installer (see Chapter 1, Download Third-Party External ComponentPackage from CA Wily). These are the same files that were used for the EnterpriseManager installation. The following files should be copied:

a. eula.txt

b. The osgiPackages archive appropriate for your system:

i. osgiPackages.v1.windows.zip, for a Windows system

ii. osgiPackages.v1.unix.tar, for a UNIX system

3. Launch the installer. If you keep the file installer.properties in the directory whereyou launch the installer, the installation will proceed silently.Alternatively, remove the file installer.properties. Then you will be guidedthrough the installation by a wizard.

a. (Silent installation) By default, the installation will be placed in the folderc:\Introscope80. If desired, pass a different target directory as a command lineparameter:IntroscopeWorkstation8.0.1.1windowsSAP.exe–DUSER_INSTALL_DIR=d:/usr/sap/some/dir

b. (installation with wizard) Select a target installation directory of your choice. KeepNo for Configure VM Settings and enter the host name of the Enterprise Manager inthe field Workstation Default Host. Finally, click Install to launch the installation.



4. Launch the Workstation:

a. via the Start Menu: ´CA Wily Introscope 8.0.1.1 Introscope Workstation

b. by directly starting the file Introscope Workstation.exe in the installation directory.



6 Environment PerformanceAgent (De)Installation

Note: Starting with SP13 of Solution Manager Diagnostics (LMSERVICE13_0), theIntroscope HostAgent takes over the role of the former EPAgent. The HostAgent is part ofthe SMDAgent process and centrally administered via the SMD. Please remove any existingmanual EPAgent installations from the monitored systems.

Remove the EPAgent1. Windows only: If the EPAgent was set up to run as Windows Service, call the batch file

DeregisterEPAService.bat which is located in the installation directory of the EPAgent.This will stop the Windows service and remove the service.

2. Unix only: Search for the Java process hosting the EPAgent and kill the process.

3. Remove the complete installation directory of the EPAgent.

Activate the HostAgent4. After upgrading Solution Manager Diagnostics to SP13, run the managed systems

setup wizard for all managed systems. This will enable and configure the host agent,including the configuration of appropriate plugins to monitor the managed system.



7 Additional InstallationOptions

This chapter covers additional customizing steps of the Introscope Installation:

• Changing the Agent port from 6001 to other values

• Uninstalling Introscope

• Setting up domains

• User Management

• Enable Single Sign On from Solution Manager

• Activating Leak Hunter

• Enterprise Manager Cluster Setup

Change the Agent PortThe Enterprise Manager by default listens on TCP port 6001 for agent connections. You canchange this value to any desired port:

1. Open the file, config/IntroscopeEnterpriseManager.properties.

2. Change the value of property introscope.enterprisemanager.port.channel1to the desired port.

3. Save changes and close the file.

4. Remember to change the property in the IntroscopeAgent.profile to the sameport.

Uninstalling Introscope

Uninstalling Introscope Agents

5. Remove the Java VM options for Introscope from the J2EE nodes that you instrumentedbefore. The following options should be removed:

a. -Xbootclasspath/p: <some path>/wily/connectors/connector.jar: <somepath>/wily/Agent.jar (Java 1.3, 1.4 only)

b. -Dcom.wily.introscope.agentProfile=<somepath>/wily/IntroscopeAgent.profile

c. -Dcom.wily.introscope.agent.agentName=<AgentName>

d. -javaagent:<some path>/wily/Agent.jar (Java 5 only)



6. Use SDM to undeploy the JmxService helper application (com.wilytech.jmxservice)in case it is still present from previous Introscope versions.

7. Restart the affected J2EE instances for the changes to become effective.

8. Delete the directory <some path>/wily (or wherever you put the agent files).

Uninstalling Environment Performance Agents

1. On Windows only: Call the script DeregisterEPAService.bat to stop and unregister theWindows service.

2. On other platforms: Stop the Java VM containing the EPAgent.

3. Delete the complete directory containing the EPAgent installation.

Uninstalling the Enterprise Manager

1. Windows only: Call the batch file DeRegisterEMservice.bat to remove the WindowsService

2. Windows only: Call the wizard to uninstall Introscope: Start Control Panel Add orRemove Programs; Select Introscope and click change/remove to launch the Wizard.Click Next to continue the uninstall.

3. Remove any remaining files from /usr/sap/ccms/wilyintroscope.

Uninstalling WebView on Netweaver

1. Use SDM to undeploy the application com.wilytech.webview if you still have a copyof WebView deployed on NetWeaver.

Setting up Introscope DomainsIntroscope agents can be organized into so-called domains. You can use this feature togroup agents which are correlated, e.g. belonging to the same domain.

Domains are defined in the Enterprise Manager by the configuration fileconfig/domains.xml. By default, there is only one domain, the SuperDomain, whichcontains all agents. SAP recommends defining one domain for each solution or eachsystem. You can pick agents for a domain based on the host name and on the agent name.Too many domains may, however, impact the Enterprise Manager performance since themanagement modules are replicated for each domain. For this reason, make sure you donot have more than 10 domains.

Example: Assume you want to create two domains EPP and EPQ for the productive and theQA Enterprise Portal. Your agent names contain the System id (also EPQ, EPP).

Step 1: Adapt the domains.xml file on the Enterprise Manager:



Step 2: Replicate the management modules:

Step 2a: In the directory config/modules, create one subdirectory for each domain. Thefolder name must be the domain name (in the example, folders EPP, EPQ).

Step 2b: copy all management modules from config/modules to each subdirectory.

Step 3: Restart the Enterprise Manager to activate the changes.

Step 4: Check the Explorer in Workstation or WebView to see if the domains appear and ifthe agents are assigned to the right domain.

Note that the SuperDomain must always be the last entry in the domains file.

Note that currently the Introscope Host Agent and the Netweaver agent for some systemmust always be in the same domain. If the Host Agent remains in the SuperDomain andNetweaver agents are moved to some custom domain, the SAP GC metrics will be missingin the Netweaver agent.

User ManagementUser accounts must be maintained in the file users.xml, located in the subdirectoryconfig/ of the Enterprise Manager. Permissions are controlled by the file domains.xml inthe same directory. To create a new user X with password Y, proceed as follows:

1. Generate the MD5-encoded password by the script MD5Encoder:

MD5Encoder Y

Y:57cec4137b614c87cb4e24a3d03a3e0



2. Add a new line to users.xml before the final </users> line, using the generatedpassword string (the part after :) as password:

<user name="X" password="57cec4137b614c87cb4e24a3d03a3e0" />

3. Add permissions for the user to the Superdomain in the domains.xml file:<grant user="X" permission="read" /><grant user="X" permission="run_tracer" /><grant user="X" permission="historical_agent_control" /><grant user="X" permission="live_agent_control" />

Note: If you do not have a full license for Introscope, you cannot use permission=”full” or“write“ here!

Enable Single Sign On from Solution ManagerStarting with Introscope Enterprise Manager release 7.2.2 (SAP release 72_02), theEnterprise Manager web server can accept single sign on tickets from Solution Managersystems. To enable this feature, the certificates from the ABAP / Java stack of the SolutionManager system must be copied to the directory sap/TrustedCerts in the EnterpriseManager. Currently, no automated procedure is available to perform these steps. Forjump-in from Solution Manager Diagnostics, only the Java certificate must be exported.

Copy the Certificate from the Java Stack

1. Open the Visual Administrator

2. Navigate to Server Services Key storage

3. Choose TicketKeystore in the Views menu.

4. Choose the export button. Please choose the cert format.

Copy the Certificate from the ABAP Stack

1. Call transaction STRUST

2. Double click the “Own Certificate” in the System PSE part of the screen such that itappears in the Certificate pane.

3. Click export to save the certificate as <hostname>.der.

Add the Certificates to the Enterprise Manager

Copy the exported certificates to the Enterprise Manager directory sap/TrustedCerts. Norestart is required. All authenticated users will be mapped to the Introscope user Admin.

Enterprise Manager Cluster SetupIf the scalability limit of a single Enterprise Manager is reached, you have to set upadditional EMs. You can either keep each EM isolated and connect it to Solution Manager,or connect multiple EMs to a cluster, appearing virtually as one EM. In this cluster, an



additional EM acts as “Manager of Managers” (MoM). Only the MoM accepts Workstationand Solution Manager connections, whereas the other EMs in the cluster act as “Collectors”.Only collectors accept agent connections. To configure an EM cluster, proceed as follows:

1. Make sure the prerequisites are met:

a. Strict clock synchronization between all involved hosts (e.g. via NTP).

b. Fast LAN connection between all EMs

2. Configure the collector EMs. In config/IntroscopeEnterpriseManager.properties, set

introscope.enterprisemanager.clustering.collector.enable=true

3. Configure the MoM. In config/IntroscopeEnterpriseManager.properties, set

introscope.enterprisemanager.clustering.manager.enable=true

List connection data for all collector Ems, e.g.

introscope.enterprisemanager.clustering.login.em1.host=myhost1introscope.enterprisemanager.clustering.login.em1.port=6001introscope.enterprisemanager.clustering.login.em1.publickey=internal/server/EM.publicintroscope.enterprisemanager.clustering.login.em2.host=myhost2introscope.enterprisemanager.clustering.login.em2.port=6001introscope.enterprisemanager.clustering.login.em2.publickey=internal/server/EM.public

Intro Scope Version 8 Installation Guide

Documents

Transcript of Intro Scope Version 8 Installation Guide