Documentación de Oracle Cloud Infrastructure

Aprovisionamiento y despliegue del agente Java de APM en un entorno basado en Siebel Cloud Manager

Puede aprovisionar y desplegar el agente Java de APM en un entorno basado en gestor de nube de Siebel.

Aprovisionamiento del agente Java de APM en Siebel Cloud Manager

Para aprovisionar el agente Java de APM en un entorno basado en gestor de nube de Siebel, haga lo siguiente:
  1. Confirme que Siebel CRM está configurado con Siebel Cloud Manager (SCM).
  2. Descarga del software del agente Java de APM.

    Para obtener instrucciones, consulte Download the APM Java Agent Software.

  3. Copie el instalador del agente Java de APM desde la máquina virtual de SCM y el contenedor Docker de SCM.
  4. Conéctese a SCM docker. 
    
docker exec -it cloudmanager bash
  5. Revise el entorno de SCM y obtenga la información de pod y montaje.
    1. Inicie sesión en AI Application Interface POD para averiguar la ubicación de montaje para el almacenamiento persistente.
      
## Set KUBE_CONFIG environment variable 
export KUBECONFIG=$HOME/.kube/config 

## Get the pod name of Application Interface service
bash-4.2$ kubectl get pods -n <namespace>
NAME                                       READY   STATUS      RESTARTS   AGE
configure-ws5fh                            0/1     Completed   0          10d
edge-0                                     1/1     Running     0          8h
image-builder-4pp9d                        0/1     Completed   0          10d
ingress-nginx-controller-f84fdc74d-smqcx   1/1     Running     0          10d
metacontroller-0                           1/1     Running     0          10d
postinstalldb-sxngc                        0/1     Completed   0          8h
Pod Name ==>    quantum-0                  1/1     Running     0          8h
siebel-controller-767868576f-zt9dg         1/1     Running     0          10d
siebelcgw-0                                1/1     Running     0          10d
smc-0                                      1/1     Running     0          10d
    2. Obtenga los detalles del punto de montaje para /persistent File Storage.

      Busque la sección Mounts en el siguiente comando pod: 

      
bash-4.2$  kubectl describe po/quantum-0  -n <namespace>
..
..
..
Mounts:
      /config/enterprise.yaml from enterprise (rw,path="enterprise.yaml")
      /config/gateway.yaml from gateway (rw,path="gateway.yaml")
      /config/sai_quantum.yaml from sai-quantum (rw,path="sai_quantum.yaml")
      /persistent from persist-storage (rw,path="SIEBELLAB/quantum") => This is the Mount point of /persistnet file storage
      /sfs0from sfs-storage-0 (rw,path="SIEBELLAB/FS")
      /siebel/mde/applicationcontainer_external/siebelcerts/keystore.jks from keystore (rw,path="keystore.jks")
      /siebel/mde/applicationcontainer_external/siebelcerts/truststore.jks from keystore (rw,path="truststore.jks")
      /siebel/mde/tls_certs/ca.cert.pem from keystore (rw,path="ca.cert.pem")
      /siebel/mde/tls_certs/ca.key.pem from keystore (rw,path="ca.key.pem")
      /siebel/mde/tls_certs/server.pem from keystore (rw,path="server.pem")
      /var/run/secrets/kubernetes.io/serviceaccountfrom kube-api-access-9fjz7 (ro)
  6. Revise la siguiente información necesaria para aprovisionar el agente Java de APM:

    • <installer_file_location>: ubicación del archivo jar del instalador del agente Java de APM.

      Este es el archivo que se ha descargado anteriormente.

    • <env_id> y <env_namespace>: información del entorno de Siebel CRM. Se puede obtener de la respuesta de la llamada de REST para aprovisionar Siebel CRM mediante Siebel Cloud Manager.

      • <env_id> es el valor del parámetro env_id.

      • <env_namespace> es el valor del parámetro name.
      Consulte el siguiente ejemplo para los parámetros name y env_id:
       {
    "data": {
        .
        .
        .
        "name": "siebellab",
        "size": {
            "ses_resource_limits": {
                "memory": "24Gi",
                "cpu": 4
            },
            "sai_resource_limits": {
                "memory": "15Gi",
                "cpu": 1
            },
            "node_shape_config": {
                "ocpus": 2,
                "memory_in_gbs": 20
            },
            "cgw_resource_limits": {
                "memory": "15Gi",
                "cpu": 2
            },
            "kubernetes_node_shape": "VM.Standard.E4.Flex",
            "kubernetes_node_count": 3
        },
        .
        .
        .
        "attempts": 1,
        "env_id": "7FE945"
    }

    • <nombre de servicio>: nombre del servicio que se está supervisando. Este argumento permite filtrar por servicio y ver los rastreos en la interfaz de usuario del Explorador de rastreo.

    • <private_data_key_value>: clave privada de instalación de agente utilizada por los agentes Java de APM que se genera cuando se crea el dominio de APM.

    • <dataupload_endpoint_value>: URL de datauUploadEndpoint que se genera cuando se crea el dominio de APM.

    Para obtener información sobre la obtención de la clave de datos privada y el punto final de carga de datos, consulte Obtención del punto final de carga de datos y las claves de datos.

  7. Aprovisionamiento del agente Java de APM.
    Ejecute los siguientes comandos:
    java -jar <installer_file_location> provision-agent -destination=/home/opc/siebel/<env_id>/<env_namespace>-<fs>/<ENV_NAMESPACE>/quantum/-private-data-key=<private_data_key_value> -data-upload-endpoint=<dataupload_endpoint_value> -service-name=<service name> -overwrite

    Por ejemplo:

    java -jar /tmp/apm-java-agent-installer-1.8.3326.jar provision-agent -destination=/home/opc/siebel/7FE945/siebellab-siebfs0/SIEBELLAB/quantum/-private-data-key=ABC123 -data-upload-endpoint=https://aaaa...dbc.oci.oraclecloud.com -public-data-key=EFG345 -service-name=siebelTest -overwrite

Para obtener más información sobre el aprovisionamiento, consulte Aprovisionamiento del agente Java de APM.

Despliegue del agente Java de APM en Siebel Cloud Manager

Para desplegar el agente Java de APM en el entorno basado en gestor de nube de Siebel, haga lo siguiente:

  1. Agregue APM Java Agent a CATALINA_OPTS en el gráfico de Helm de la interfaz de aplicación de Siebel.

    El cambio en el gráfico de hélice se puede realizar en el repositorio local de Siebel Cloud Manager. Vaya al repositorio local del gráfico de helm para Siebel y confirme/empuje los siguientes cambios:

    cd /home/opc/siebel/<environment>/<siebel namespace>-helmcharts/siebel 

## Add to CATALINA_OPTS value in templates/._deploy_saiprofiles.tpl
- name: CATALINA_OPTS
       value: -Djavax.net.ssl.keyStoreAlias=siebel -javaagent:/persistent/oracle-apm-agent/bootstrap/ApmAgent.jar

  2. Volcar la versión en el archivo Chart.yaml.

    Por ejemplo, de 0.1.0 a 0.1.1.

    version: 0.1.1

  3. Empuje los cambios.

    git add templates/._deploy_saiprofiles.tpl Chart.yaml
git commit -am "Adding APM java agent"
git push

  4. Vuelva a crear los pods.

    El flujo recogerá automáticamente los cambios y el pod se volverá a crear. Puede mantener una observación sobre el estado del pod mediante el siguiente comando: 

    kubectl get pods -n <namespace> --watch

Para obtener más información sobre cómo desplegar el agente de APM en el servidor Apache Tomcat, consulte Apache Tomcat Server.