# Installation

iView Monitor uses the standard JVMPI and needs therefore a shared library, which will be attached to the JVM at runtime. The user interface is available as portal iView and as servlet, which runs in the same JVM as the profiled program.

## Parts

- Operating system dependend shared library
- Portal iView archive

## Requirements

- Servlet engine: J2EE 6.20 or 6.40
- Operating system: Win2000, Solaris Linux, AIX or HP-UX
- Portal EP6
- JRE 1.3 or 1.4

## Tasks

- Install the shared library
- Install the default properties file
- Modify JVM parameter
- Deploy iView Monitor as portal application

## Installation of Shared Library

Select the link for your operating system with the right mouse and select "save target as...". In the dialog box choose the directory /usr/sap/sherlok/.

Add the directory /usr/sap/sherlok/ to the environment variable shown in the last column using the syntax of the PATH environment variable.

Win2000 | sherlok.dll | PATH
Solaris | libsherlok.so | LD_LIBRARY_PATH
HP-UX (64Bit) | libsherlok.sl | SHLIB_PATH
AIX (64bit) | libsherlok.so | LIBPATH
Linux | libsherlok.so | LD_LIBRARY_PATH

## Installation of Properties file

Select the link with the right mouse and select "save target as...". In the dialog box choose the directory /usr/sap/sherlok/

default.skp | Default properties for portal namespace
default.customer.skp | Default properties excluding portal namespace

## Modify JVM Parameters

Use the Java command line parameter -Xrun to attach iView Monitor to the JVM.. In your J2EE installation open the go script in

- subfolder .../server in a cluster environment or
- subfolder .../alone in a stand alone environment

Replace the environment variable DEBUG_PARAMS in the go script by the following entry. For UNIX systems you have to set quotation marks.

set DEBUG_PARAMS=-Djava.compiler=NONE -Xdebug -Xnoagent -Xrunsherlok:ConfigPath=/usr/sap/sherlok set LD_LIBRARY_PATH=/usr/sap/sherlok

## Deploy Monitor

- Download TestBench iView as "com.sap.portals.sherlok.par"
- Start J2EE server with the modified go script
- Change to PortalAnywhere.default, browse to the par file and press the Upload button
  URL = /irj/servlet/prt/portal/prtroot/PortalAnywhere.default

## Start SherlokMonitor

- Change to PortalAnywhere.Go
  URL = /irj/servlet/prt/portal/prtroot/PortalAnywhere.Go
- Select Go button of the TestBench: com.sap.portals.sherlok.Monitor