Standalone EPAgent as a UNIX Daemon

You can install the Standalone EPAgent as a UNIX daemon using either a 32-bit or 64-bit Java Virtual Machine (JVM). 
apmdevops106
Install the Standalone EPAgent as a UNIX Daemon
You can install the Standalone EPAgent as a UNIX daemon using either a 32-bit or 64-bit Java Virtual Machine (JVM). 
The Standalone EPAgent deliverable file contains the bin/EPACtrl.sh and conf/EPAService.conf files. 
Follow these steps:
  1. Extract the StandaloneEPAgent deliverable tar file using a suitable tool.
  2. Navigate to the 
    <
    EPAHome>/conf directory and open the EPAService.conf file as root in a text editor.
  3. Set the JAVA_HOME variable.
    1. Look for the line that sets the JAVA_HOME variable. 
    2. Obtained the JAVA_HOME variable by running this command at a command line:
      echo $JAVA_HOME
    3. Edit the line to point to your JAVA_HOME and uncomment the line. For example:
      set.JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-amd64
    4. Save the file.
  4. Navigate to the 
    <
    EPAHome>/bin directory and execute the following command to install and launch the EPAgent as a daemon.
    ./EPACtrl.sh install
    Once installed, the EPAgent daemon starts automatically every time the system boots.
  5. Use 
    ./EPACtrl.sh
     without arguments to obtain help about other supported commands.
Choice of JVM
By default, the JVM that is used is derived from the value of the JAVA_HOME environment variable. The EPAgent can run in either a 32-bit or a 64-bit JVM. Ensure the JAVA_HOME points to a valid Java installation path of the version required (32-bit or 64-bit). You must set this variable in the computer system environment to be accessible by the process and a JVM running in the service context.
Do not use quotation marks before and after the JAVA_HOME path. When quotation marks are used, it is likely that the JVM fails to launch because the wrapper adds more quotation marks.
Correct example:
set JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-amd64
Incorrect example:
set JAVA_HOME="/usr/lib/jvm/java-1.8.0-openjdk-amd64"
The Java service wrapper uses the platform-appropriate wrapper binary, and for a 64-bit platform either a 64-bit or 32-bit JVM can be used.
Configure EPAgent Wrapper Properties
You can change or add several properties that are defined in the wrapper configuration. The EPAService.conf properties include:
  • wrapper.java.command=%JAVA_HOME%/bin/java
    Java Binary location
  • wrapper.app.parameter.1=../lib/EPAgent.jar
    EPAgent.jar being passed as a wrapper parameter
  • wrapper.java.additional.1=-Dcom.wily.introscope.epagent.properties="../IntroscopeEPAgent.properties"
    IntroscopeEPAgent.properties is getting passed as a JVM argument
  • wrapper.logfile=../logs/EPAgentService.log
    Log file location
You can set properties such as the JVM heap size values, in wrapper.java.additional.* properties. We provide commented examples in the .conf file.