Configuring an Environment Management Agent

Before you can run an environment management agent, you must ensure that it's properly configured. You configure the agent by making appropriate entries in its configuration.properties file, which is located under:

PS_HOME\PSEMAgent\envmetadata\config

The following table describes the configuration.properties parameters for the Environment Management agent:

Configuration Parameter	Description	Default Value
hubURL	The URL that contains the host name and the port number of the machine on which the Environment Management hub is running (inside a J2EE container).	http://`hostname`:`port`/PSEMHUB/hub.
agentport	A port that the agent uses for internal life cycle management.	5283.
pinginterval	The interval, in milliseconds, between two successive attempts that the peer makes to contact the hub. All peers that access this configuration file have the same ping interval.	10000 (in milliseconds for the heartbeat). Note: The minimum required pinginterval value is 1000.
windowsdrivestocrawl	On Microsoft Windows, the set of local drives or directory paths where PS_HOME, PS_CFG_HOME, PS_APP_HOME , and PIA_HOME are located. Separate the drive letters or directory paths with spaces and a pipe symbol ( \| ).	c: \| d: Note: Do not leave a trailing '/' or '\' character at the end of the path.
unixdrivestocrawl	On UNIX, the set of local drives or directory paths where PS_HOME, PS_CFG_HOME, and PIA_HOME are located. Note: The environment variable for PS_APP_HOME should be set in the application server/batch server configuration.	$HOME Note: Do not leave a trailing '/' or '\' character at the end of the path.
chunksize	Only applicable to large files, which may be chunked when sent. The chunksize represents the maximum size in bytes of each chunk.	1048576 (1 MB) (used for large file transfers).
SSL	Connects to EM Hub with HTTP or HTTPS connection. The options are: None (Allowed List)- Lets to connect with HTTP connection. When you select this option, the keystore and truststore related fields will be disabled. Server Certificates Only (Allowed List)- Lets to connect with one-way SSL. When this option is selected, keystore and keystore password fields are disabled. However, truststore related fields are enabled Client and Server Certificate- Lets to connect with EM Hub using two-way SSL.When this option is selected, keystore and truststore related fields are enabled.	None (Allowed List)
Keystore	This is the path to keystore file.	NA
Keystore password	The keystore password stored in the psvault file. The password is stored in the PSCipher format.	NA
Truststore	This is the path to truststore file.	NA
Truststore password	The password is stored in the PSCipher format.	NA
psvault	This is the psvault file location where the encrypted keystore and truststore passwords are stored.	NA

Configuring PS Agent Home

If the environment variable PS_AGENT_HOME is not set, EMF writes to PS_HOME, which restricts the ability to run multiple agents specific to each application simultaneously on a shared PS_HOME. This also poses a security concern as users under which the EM Agent runs must have write access to PS_HOME.

Set the environment variable PS_AGENT_HOME to the directory where you want to write the environment management metadata. When you launch PSEMAgent, the system will check for the PS_AGENT_HOME location and copy the necessary files to the PS_AGENT_HOME directory and log all activity in that directory.

Note: If you are using a Portable PS_HOME, you must set the PS_AGENT_HOME variable to your Portable PS Home location.