Downloading the Master Installer for APM Java Agent

Download the master installer to a shared directory that can be accessed by all the managed servers in the application server domain where APM Java Agents will be deployed.

To download the master installer:
  1. Sign in to My Services (http://cloud.oracle.com/sign_in), and go to the Dashboard page.
  2. Click Launch APM.
  3. Review the information in this page to understand how to set up Application Performance Monitoring by deploying the APM Java Agent in your data center.
  4. Click Next to proceed.
  5. To start downloading the installer to a local or shared directory in your data center, click Download Master Installer.
    The master installer is a ZIP file that contains the following:
    • AgentInstall.sh: The installation script used to install and deploy the APM Java agent. You can see a list of supported parameters and their definitions in Running the AgentInstall Script.

    • Read Me file: A file containing instructions about how to use the AgentInstall.sh script to install agents on your target hosts.

  6. Create a registration key that will be used during the time of installing a new agent. Oracle Application Performance Monitoring Cloud Service verifies this key before accepting any data sent by APM Java Agent deployed on your on-premises hosts. For more information about creating a registration key, see Creating a Registration Key.
  7. Click Done after the download is complete.

    Note:

    During the download, some browsers may change the name of the installer. Ensure that you use the file that is currently downloaded for installation. For example, if your directory already contained a file named AgentInstall.zip, the browser might rename the newly downloaded file to AgentInstall(1).zip. Ensure that you use the file AgentInstall(1).zip.
  8. Extract the contents of the master installer ZIP file.
  9. From the local or shared directory where you have extracted the contents of the master installer ZIP file, run the following command to download the software:
    ./AgentInstall.sh AGENT_TYPE=apm_java_as_agent STAGE_LOCATION=${STAGE_DIR} AGENT_REGISTRATION_KEY=${REG_KEY} -download_only

    Note:

    1. If you’re deploying the APM Java Agent over a proxy server, ensure that you perform the steps listed in Preparing to Deploy APM Java Agent and then run AgentInstall.sh as below:
      ./AgentInstall.sh AGENT_TYPE=apm_java_as_agent STAGE_LOCATION=${STAGE_DIR} AGENT_REGISTRATION_KEY=${REG_KEY} -download_only 
    2. If you’re deploying the APM Java Agent to use Gateway, include the following parameters before running AgentInstall.sh as below:
      ./AgentInstall.sh AGENT_TYPE=apm_java_as_agent STAGE_LOCATION=${STAGE_DIR} AGENT_REGISTRATION_KEY=${REG_KEY} -download_only GATEWAY_HOST=${GW_HOST} GATEWAY_PORT=${GW_PORT} 
If you need to download the master installer again at a later date, see Optional: Downloading the Master Installer on Demand.