Modification de la configuration de la surveillance

La configuration des ressources de surveillance de pile peut être mise à jour à l'aide de la ligne de commande OCI. Utilisez la commande oci stack-monitoring resource update avec les modifications de configuration requises pour mettre à jour la configuration.

Mettre à jour la configuration de surveillance Oracle Database
Actualisation de la ressource E-Business après le remplacement du système de fichiers
Actualisation de la ressource E-Business avec l'option Edition-Based Redefinition (EBR) activée

Mettre à jour la configuration de surveillance Oracle Database

Pour modifier la configuration de la surveillance de pile, procédez comme suit :

Obtenez des propriétés existantes.

Exécutez la commande OCI suivante :

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

La sortie est affichée ci-dessous :

Sortie de commande GET

{
    "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": {}
}

Préparez un fichier d'entrée JSON pour la mise à jour.

Créez updateJson.props à l'aide de l'entrée ci-dessus.
Copiez et collez les propriétés et autres configurations qui doivent être mises à jour.

Ajoutez/modifiez/supprimez les propriétés requises.

Note

Les propriétés sont mises à jour dans leur ensemble, ce qui signifie que les propriétés spécifiées dans cette entrée JSON modifieront/supprimeront les propriétés existantes. Si aucune propriété n'est spécifiée dans cette entrée qui existe précédemment, cette propriété sera supprimée.

Pour obtenir le JSON complet pris en charge et les valeurs à mettre à jour, vous pouvez utiliser l'option generate-full-command-json-input. Exemple :

oci stack-monitoring resource update --generate-full-command-json-input

Pour plus d'informations, voir Options JSON avancées.

Exemple : Mise à jour de 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"
        }
    ]
}

Exécutez la commande update.

oci stack-monitoring resource update --from-json file://<json_input_file>

Exemple :

oci stack-monitoring resource update --from-json file://updateJson.json

Suivez le statut de la commande de mise à jour.
La sortie de la commande update ci-dessus inclut opc-workrequest-id comme indiqué ci-dessous.
```
{
  "opc-work-request-id": "ocid1.stackmonitoringworkrequest.oc1.eu-frankfurt-1.XXXXXXXX"
}
```
Utilisez la valeur opc-work-request-id ci-dessus pour suivre le statut de l'opération de mise à jour. Utilisez les commandes work-request suivantes pour suivre le statut.

Pour obtenir le statut d'un ID demande de travail indiqué :
```
oci stack-monitoring work-request get --work-request-id <opc-work-request-id>
```
Pour obtenir la liste des journaux d'un ID demande de travail indiqué :
```
oci stack-monitoring work-request list-logs --work-request-id <opc-work-request-id>
```
Pour obtenir la liste des erreurs pour un ID demande de travail indiqué :
```
oci stack-monitoring work-request list-errors --work-request-id <opc-work-request-id>
```

Actualisation de la ressource E-Business après le remplacement du système de fichiers

L'application de correctifs à E-Business Suite (EBS) est généralement effectuée à l'aide de deux systèmes de fichiers, à savoir run(fs1) et le système de fichiers patch(fs2).

Note

L'actualisation d'EBS doit être effectuée lorsque vous surveillez Oracle E-Business Suite et que vous avez basculé entre les systèmes de fichiers run(fs1) et patch(fs2).

Lors du passage d'un système de fichiers à un autre, une actualisation d'EBS dans la surveillance de pile détectera automatiquement toutes les modifications apportées aux propriétés de configuration, y compris le nouveau port d'administration WebLogic. Les ressources de domaine WebLogic seront également actualisées. Les modifications de données d'identification ne seront pas automatiquement récupérées, si nécessaire, voir Mise à jour des données d'identification de surveillance.

Note

Lors de l'exécution d'EBS 12.2 REFRESH après la mise en service, assurez-vous que l'agent peut atteindre le nouveau port du serveur d'administration Weblogic.

Actualisation de la ressource E-Business avec l'option Edition-Based Redefinition (EBR) activée

EBR permet des mises à niveau d'application en ligne avec un temps d'arrêt minimal ou nul en permettant la création et la maintenance de plusieurs versions d'objets de base de données. Elle fonctionne en permettant d'apporter des modifications aux objets de base de données dans une nouvelle édition, tandis que l'ancienne édition reste disponible pour les sessions existantes.

Si EBR est activé dans la base de données EBS et qu'il existe une nouvelle édition, l'agent de gestion conserve une connexion périmée à l'ancienne édition, ce qui entraîne l'arrêt de la collecte des mesures. L'actualisation de la ressource mettra à jour les connexions périmées et la collecte des mesures se poursuivra.

Documentation sur Oracle Cloud Infrastructure

Modification de la configuration de la surveillance