Alterando a Configuração do Monitoramento

A configuração do recurso de monitoramento de pilha pode ser atualizada usando a linha de comando do OCI. Use o comando oci stack-monitoring resource update com as alterações de configuração necessárias para atualizar a configuração.

Atualizar Configuração do Oracle Database Monitoring

Para alterar a configuração do Stack Monitoring, faça o seguinte:

  1. Obter propriedades existentes.

    Execute o seguinte comando do OCI:

    oci stack-monitoring resource get --resource-id <stack-monitoring-resource-id>

    A saída é mostrada abaixo

    GET - Saída do Comando

    {
        "id": "ocid1.stackmonitoringresource.oc1.iad.<unique_ID>",
        "name": "TestDatabase",
        "displayName": "Test Database",
        "type": "oci_oracle_cdb",
        "compartmentId": "ocid1.compartment.oc1..unique_ID",
        "tenantId": "ocid1.tenancy.oc1..unique_ID",
        "hostName": "<hostname>",
        "managementAgentId": "ocid1.managementagent.oc1.iad.<unique_ID>",
        "resourceTimeZone": "UTC",
        "timeCreated": "2022-04-14T11:59:41.614Z",
        "timeUpdated": "2022-04-14T12:06:31.807Z",
        "lifecycleState": "ACTIVE",
        "properties": [
            {
                "name": "db_type",
                "value": "CDB"
            },
            {
                "name": "protocol",
                "value": "TCP"
            },
            {
                "name": "enabledDBMgmtOnDbaas",
                "value": "true"
            },
            {
                "name": "port",
                "value": "1521"
            },
            {
                "name": "dbId",
                "value": "2970651666"
            },
            {
                "name": "dbUniqueName",
                "value": "XE"
            },
            {
                "name": "serviceName",
                "value": "XE"
            },
            {
                "name": "connectorOCID",
                "value": "ocid1.externaldatabaseconnector.oc1.iad.<unique_ID>"
            },
            {
                "name": "externalDatabaseHandlerOCID",
                "value": "ocid1.externalcontainerdatabase.oc1.iad.<unique_ID>"
            }
        ],
        "databaseConnectionDetails": {
            "protocol": "TCP",
            "port": 1521,
            "connectorId": "ocid1.externaldatabaseconnector.oc1.iad.<unique_ID>",
            "serviceName": "XE",
            "dbUniqueName": "XE",
            "dbId": "2970651666"
        },
        "credentials": null,
        "aliases": null,
        "freeformTags": {},
        "definedTags": {
            "Oracle-Recommended-Tags": {
                "ResourceType": "group"
            },
            "Oracle-Tags": {
                "CreatedBy": "oracleidentitycloudservice/<user>@<domain>",
                "CreatedOn": "2022-04-14T11:59:41.183Z"
            }
        },
        "systemTags": {}
    }
  2. Prepare um arquivo de entrada JSON para a atualização.
    1. Crie updateJson.props usando a entrada acima.

    2. Copie e cole as propriedades e outras configurações que precisam ser atualizadas.

    3. Adiciona/modifica/exclui as propriedades obrigatórias.
      Observação

      As propriedades são atualizadas como um todo, o que significa que as propriedades especificadas nesta entrada JSON modificarão/excluirão as propriedades existentes. Se uma propriedade não for especificada nesta entrada que existe anteriormente, essa propriedade será excluída.
      Para obter o suporte completo ao JSON e os valores para atualização, você pode usar a opção generate-full-command-json-input. Por exemplo:
      oci stack-monitoring resource update --generate-full-command-json-input

      Para obter mais informações, consulte Opções JSON Avançadas.

      Exemplo: Atualizado em updateProps.json

      {
        "resourceId":"ocid1.stackmonitoringresource.oc1.iad.<unique_ID>"
        "displayName":"Database Updated",
        "databaseConnectionDetails":{
            "port":"1521",
            "protocol":"TCP",
            "serviceName":"testService_new"
            "dbUniqueName": "testService_new",
            "dbId": "12345678"
         },
         "credentials":{
            "name":"cred-name",
            "source":"credentialType.credentialName",
            "description":"Database Credential",
            "credentialType":"PLAINTEXT",
            "properties":[
               {
                  "name":"databaseUserName",
                  "value":"testUser"
               },
               {
                  "name":"databasePassword",
                  "value":"greatestPassword"
               },
              {
              "name": "databaseRole",
              "value": "sysdba"
            }
            ]
         },  
         "properties": [
              {
                  "name": "db_type",
                  "value": "CDB"
              },
              {
                  "name": "protocol",
                  "value": "TCP"
              },
              {
                  "name": "enabledDBMgmtOnDbaas",
                  "value": "true"
              },
              {
                  "name": "port",
                  "value": "1522"
              },
              {
                  "name": "dbId",
                  "value": "2970651666"
              },
              {
                  "name": "dbUniqueName",
                  "value": "XE"
              },
              {
                  "name": "serviceName",
                  "value": "XE"
              },
              {
                  "name": "connectorOCID",
                  "value": "ocid1.externaldatabaseconnector.oc1.iad.<unique_ID>"
              },
              {
                  "name": "externalDatabaseHandlerOCID",
                  "value": "ocid1.externalcontainerdatabase.oc1.iad.<unique_ID>"
              },
              {
                  "name": "newProperty",
                  "value": "new"
              }
          ]
      }
  3. Execute o comando update.
    oci stack-monitoring resource update --from-json file://<json_input_file>

    Por exemplo:

    oci stack-monitoring resource update --from-json file://updateJson.json
  4. Rastreie o status do comando de atualização.

    A saída do comando update acima inclui o opc-workrequest-id, conforme mostrado abaixo.

    {
      "opc-work-request-id": "ocid1.stackmonitoringworkrequest.oc1.eu-frankfurt-1.XXXXXXXX"
    }

    Use o valor opc-work-request-id acima para rastrear o status da operação de atualização. Use os comandos work-request a seguir para rastrear o status.

    Para obter o status de um determinado ID da Solicitação de Serviço:

    oci stack-monitoring work-request get --work-request-id <opc-work-request-id>

    Para obter uma lista de logs para um determinado ID de Solicitação de Serviço:

    oci stack-monitoring work-request list-logs --work-request-id <opc-work-request-id>

    Para obter uma lista de erros de um determinado ID de Solicitação de Serviço:

    oci stack-monitoring work-request list-errors --work-request-id <opc-work-request-id>

Atualizando o recurso do E-Business após a interrupção do sistema de arquivos

A aplicação de patch no E-Business Suite (EBS) geralmente é feita usando sistemas de arquivos duplos, ou seja, run(fs1) e o sistema de arquivos patch(fs2).

Observação

A atualização do EBS deve ser feita quando você estiver monitorando o Oracle E-Business Suite e tiver alternado entre os sistemas de arquivos run(fs1) e patch(fs2).

Ao alternar entre sistemas de arquivos, uma atualização do EBS no monitoramento de Pilha detectará automaticamente todas as alterações nas propriedades de configuração, incluindo a nova Porta de Administração WebLogic. Isso também atualizará os recursos do Domínio WebLogic. As alterações de credenciais não serão selecionadas automaticamente, se necessário, consulte Atualizando Credenciais de Monitoramento.

Observação

Ao executar o EBS 12.2 REFRESH após a transferência, certifique-se de que o agente possa acessar a nova porta do servidor de Administração do Weblogic.

Atualizando o recurso E-Business com a Redefinição Baseada em Edição (EBR) ativada

O EBR permite atualizações de aplicativos on-line com mínimo ou nenhum tempo de inatividade, permitindo a criação e a manutenção de várias versões de objetos de banco de dados. Ele funciona permitindo que alterações nos objetos de banco de dados sejam feitas em uma nova edição, enquanto a edição antiga continua disponível para sessões existentes.

Se o EBR estiver ativado no banco de dados do EBS e houver uma nova edição, o agente de gerenciamento manterá uma conexão desatualizada com a edição antiga, fazendo com que as métricas deixem de ser coletadas. A atualização do recurso atualizará as conexões desatualizadas, e a coleta de métricas continuará.