Modifica della configurazione di controllo

La configurazione delle risorse di monitoraggio dello stack può essere aggiornata utilizzando la riga di comando OCI. Utilizzare il comando oci stack-monitoring resource update con le modifiche alla configurazione necessarie per aggiornare la configurazione.

Aggiorna configurazione di monitoraggio di Oracle Database

Per modificare la configurazione di Monitoraggio dello stack, effettuare le operazioni riportate di seguito.

Recupera le proprietà esistenti.

Eseguire il seguente comando OCI:

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

Di seguito è visualizzato l'output:

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

Preparare un file di input JSON per l'aggiornamento.

Creare updateJson.props utilizzando l'input sopra riportato.
Copiare e incollare le proprietà e le altre configurazioni da aggiornare.

Consente di aggiungere/modificare/eliminare le proprietà richieste.

Nota

Le proprietà vengono aggiornate nel loro complesso, il che significa che le proprietà specificate in questo input JSON modificheranno/elimineranno le proprietà esistenti. Se in questo input non viene specificata una proprietà esistente in precedenza, tale proprietà verrà eliminata.

Per ottenere la notazione JSON completa supportata e i valori per l'aggiornamento, è possibile utilizzare l'opzione generate-full-command-json-input. Ad esempio:

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

Per ulteriori informazioni, vedere Opzioni JSON avanzate.

Esempio: updateProps.json aggiornato

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

Eseguire il comando di aggiornamento.

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

Ad esempio:

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

Traccia lo stato del comando di aggiornamento.
L'output del comando update sopra riportato include opc-workrequest-id, come mostrato di seguito.
```
{
  "opc-work-request-id": "ocid1.stackmonitoringworkrequest.oc1.eu-frankfurt-1.XXXXXXXX"
}
```
Utilizzare il valore opc-work-request-id sopra riportato per tenere traccia dello stato dell'operazione di aggiornamento. Utilizzare i seguenti comandi work-request per tenere traccia dello stato.

Per ottenere lo stato di un determinato ID richiesta di lavoro:
```
oci stack-monitoring work-request get --work-request-id <opc-work-request-id>
```
Per ottenere una lista di log per un determinato ID richiesta di lavoro:
```
oci stack-monitoring work-request list-logs --work-request-id <opc-work-request-id>
```
Per ottenere un elenco di errori per un determinato ID richiesta di lavoro:
```
oci stack-monitoring work-request list-errors --work-request-id <opc-work-request-id>
```

Aggiornamento della risorsa E-Business dopo il taglio del file system

L'applicazione di patch a E-Business Suite (EBS) viene in genere eseguita utilizzando i file system doppi, ad esempio run(fs1) e il file system patch(fs2).

Nota

L'aggiornamento di EBS deve essere eseguito quando si monitora Oracle E-Business Suite e si è passati dai file system run(fs1) a patch(fs2).

Quando si passa da un file system all'altro, un aggiornamento di EBS nel monitoraggio dello stack rileverà automaticamente tutte le modifiche nelle proprietà di configurazione, inclusa la nuova porta di amministrazione WebLogic. Verranno inoltre aggiornate le risorse del dominio WebLogic. Le modifiche alle credenziali non verranno rilevate automaticamente, se necessario, fare riferimento a Aggiornamento delle credenziali di monitoraggio.

Nota

Quando si esegue EBS 12.2 REFRESH dopo il cutover, assicurarsi che l'agente possa raggiungere la nuova porta del server di amministrazione Weblogic.

Aggiornamento della risorsa E-Business con EPR (Edition-Based Redefinition) abilitata

EBR consente aggiornamenti delle applicazioni online con tempi di inattività minimi o nulli, consentendo la creazione e la manutenzione di più versioni di oggetti di database. Funziona consentendo di apportare modifiche agli oggetti di database all'interno di una nuova edizione, mentre la vecchia edizione continua a essere disponibile per le sessioni esistenti.

Se EBR è abilitato nel database EBS e vi è una nuova edizione, il Management Agent terrà una connessione non più valida alla vecchia edizione causando l'arresto della raccolta delle metriche. L'aggiornamento della risorsa aggiornerà le connessioni non più valide e la raccolta delle metriche continuerà.

Documentazione di Oracle Cloud Infrastructure

Modifica della configurazione di controllo