Installing the Agent for SAP
This document describes the hotfix installation procedure for a SAP agent.
Should any problems arise during the installation process, see Knowledge
Base.
Ensure that the agent is closed before you
start the update installation.
Requirements (UNIX)
- The user identification AE must be set.
Supplied Files
The files are provided in the directory IMAGE:AGENTS\SAP\UNIX or IMAGE:AGENTS\SAP\WINDOWS.
Procedure
|
1.
|
Installing the Agent (UNIX) |
- Host
- Transfer
the TAR file UCXJR3X.tar.gz via FTP.
- Log in using the user AE.
- Unpack the transferred TAR file.
gzip -d UCXJR3X.tar.gz
tar xvfo UCXJR3X.tar
- If recommended in the
current Release Notes, adjust the ini file. Refer the INI
file UCXJ3RX.ORI.INI, which is supplied with the installation.
|
2. |
Installing the Agent (Windows) |
- Host
- Start the program SETUP.EXE
in the directory IMAGE:AGENTS\SAP\WINDOWS.
-
All
files must be installed on the local hard drive of the computer
because the agent runs as a service except when it is used for testing. A service does
not have access to the network resources.
- If recommended in the
current Release Notes, adjust the INI file. Refer to the INI file UCXJR3X.INI, which is supplied with the
update installation.
- Admin computer
or user computer
- Adjust HEADER.SAP, TRAILER.SAP and RESTART.SAP if necessary. See also: Job - Execution.
|
3. |
Import the AE Interface
|
- Host
-
This
installation step is only necessary if you use the AE interface.
- Copy the transport files.
- Import the transport.
|
4. |
Starting the
Agent |
- Use the following command to start the agent via the command line (UNIX and Windows):
java -jar ucxjr3x.jar
You can also use the ServiceManager to start the agent.
Note that the storage limit should be set to at least 256MB (or 512MB) when you start Java agents (Databases, RA, JMX, SAP). You can specify a value for the storage limitation of Java applications via the start parameter -XmX.
Example for a start with 256MB: java -Xmx256M -jar ucxjr3x.jar.
Specifying a value that is too low can cause the agent to crash. The default value depends on the Java version that you use.