DIPC: Agent installation

This note is about installing the DIPC agent on an OCI Compute server. All steps are well documented.

#1 Provision a compute with OL6.10

#2 Download and install Java 8 with root, for example on /opt/java

#3 Create the oracle user. That user will be used for the agent installation

#4 Download the agent from the DIPC Console

Unzip the compressed file under /u01/app/oracle/product/dipc

#5 Install the certificate in the java truststore

That certificate can be downloaded from the browser, when logged in to the DIPC Console.

export JAVA_HOME=/opt/java/jdk1.8.0_161
export CERT=<cert>
$JAVA_HOME/bin/keytool -import -alias ${CERT} -keystore "$JAVA_HOME/jre/lib/security/cacerts" -file ${CERT}.cer

When run from oracle, temporarily update the properties of the cacerts file

chmod 777 $JAVA_HOME/jre/lib/security/cacerts

then set it back

chmod 644 $JAVA_HOME/jre/lib/security/cacerts

#6 Install the agent

Run similar command:

export JAVA_HOME=/opt/java/jdk1.8.0_161
cd /u01/app/oracle/product/dipc/dicloud
 ./dicloudConfigureAgent.sh <instance> \
  -recreate                          \
  -debug=true                        \
  -dipchost=<host>.adipc.ocp.oraclecloud.com               \
  -dipcport=443 -user=<user> -password="<password>"        \
  -authType=OAUTH2                                         \
  -idcsServerUrl=https://idcs-<id>.identity.oracleclo
 ud.com \
  -agentIdcsScope="https://<id>.adipc.ocp.oraclecloud
 .com:443urn:opc:resource:consumer::all" \
  -agentClientId=<id> \
  -agentClientSecret="<value>"

The 3 last parameters values can be found in the Configuration section of the secured application created for the purpose of this installation

#7 Setup the proxy

Optionally, update the file agent/<instance>/conf/agent.properties to specify the proxy

agentUseProxy=true

proxyHost=x.x.x.x

proxyPort=80

#8 start the agent

/u01/app/oracle/product/dipc/dicloud/agent/<instance>/bin/startAgentInstance.sh

#9 Check the DIP Console

The agent should now be listed in the DIPC Console.