To download and install the PingIntelligence policy tool:

  1. Download the PingIntelligence policy tool to the /opt directory.
  2. Untar the policy tool:
    1. At the command prompt, run the following command:
      tar –zxvf <filename>

      The following example shows what this command could look like in your instance:

      tar –zxvf pi-apigee-4.1.tar.gz
    2. To verify that the tool successfully installed, run the ls command at the command prompt.

      You see the Ping Identity directories and the build .tgz file.

      The following table lists the available directories.

      Directory Description

      bin

      Contains the following scripts:

      • deploy.sh: The script to deploy the PingIntelligence policy.
      • undeploy.sh: The script to undeploy the PingIntelligence policy.
      • status.sh: Reports the deployment status and configured Apigee credentials.

      certs

      Contains the certificate ase.pem file that is shipped by default with ASE. Make sure that the certificate applied for the ASE data port matches with the certificate present in the ase.pem certificate file for self-signed certificates.

      For more information, see Prerequisites to deploying a PingIntelligence shared flow.

      client_certs

      Contains the Apigee root certificate authority (CA) certificate that is copied to this location when mutual TLS (MTLS) is enabled.

      Note:

      This feature requires ASE version 5.1.3 or later.

      lib

      .jar files and various dependencies. Do not edit the contents of this directory.

      policy

      Contains the shared flows:

      • request_shared_flow_custom.zip
      • request_shared_flow_kvm.zip
      • response_shared_flow_custom.zip
      • response_shared_flow_kvm.zip

      config

      Contains the apigee.properties file.

      logs

      Contains the log and status files.

  3. To configure the PingIntelligence policy tool after installation, edit the apigee.properties file and set the necessary properties.

    For more information, see Apigee properties file configuration.