Oracle Cloud Infrastructure Documentation

Provision and Deploy APM Java Agent on Peoplesoft

Download the APM Java Agent

For instructions, refer to Download the APM Java Agent Software.

Provision the APM Java Agent

For detailed information and instructions, refer to Provision the APM Java Agent.

Note

When running the java command to provision the agent with the mandatory arguments, review the below example as a reference:
java -jar ./apm-java-agent-installer-<version>.jar provision-agent -service-name=<Name of the Service> -destination=<Destination_Directory> -private-data-key=<Private data key generated during APM domain creation> -data-upload-endpoint=<dataUploadEndpoint URL generated during APM domain creation>
Where:

  • service-name is the service being monitored.

    For example: -service-name=PSFT_PIA

  • destination is the destination directory in which the APM Java agent will be provisioned.

  • private-data-key is the agent installation private data key used by the APM Java agent, which is generated when the APM domain is created.

  • data-upload-endpoint is the dataUploadEndpoint URL, which is generated when the APM domain is created.

Deploy the APM Java Agent

To deploy the APM Java Agent on Peoplesoft, do the following:
  1. Navigate to the PIA Domain Administration menu.
  2. From the shell prompt, start the psadmin utility with the following command:
    psadmin
  3. Select 3 for Web (PIA) Server.
  4. Select 1 to administer a domain.
  5. Select the PIA domain where to install the APM Agent.
  6. Edit the configuration files:
    1. View the list of configuration files to edit by executing command 5.
    2. Select 1 to edit the setEnv file. The setEnv file will open in a Vi editor.
    3. Search for the corresponding JAVA_OPTIONS_<Operating System> variable and add the following option:
      JAVA_OPTIONS_<Operating System>="${JAVA_OPTIONS_<Operating System} -javaagent:${DOMAIN_HOME}/oracle-apm-agent/bootstrap/ApmAgent.jar"

      Where <Operating System> is the operating system that Peoplesoft PIA runs on.

  7. Save the changes made to the setEnv file and exit the Vi editor to see the list of configuration files.
  8. Type q to exit this menu, and see the PIA Administration menu.
  9. Reboot the PIA domain:
    1. Navigate to the PIA Domain Administration menu. Refer to step 1.
    2. Select 2 to shut down the domain.
    3. Select 3 to get the status of the domain to check if it is still running.
    4. Select 1 to boot this domain to complete the restart of the PIA domain.