Documentazione di Oracle Cloud Infrastructure

Registrazione di un'istanza non OCI

Registrare un'istanza cloud di terze parti in locale o supportata installando i pacchetti necessari, aggiungendo un profilo di registrazione e installando il Management Agent.

Importante

La duplicazione di una VM già registrata nell'hub di gestione del sistema operativo non è supportata.

Informazioni preliminari

Prima di registrare un'istanza con l'hub di gestione del sistema operativo, è necessario effettuare le operazioni riportate di seguito.

Aggiungere il profilo di registrazione all'istanza

  1. Nella console copiare il contenuto dell'origine software, del gruppo o del profilo del ciclo di vita.
    1. In Hub di gestione del sistema operativo selezionare Profili.
    2. Selezionare il nome del profilo.
    3. Verificare le informazioni del profilo per identificare una Management Station. Ciò conferma che il profilo è destinato a istanze cloud on-premise o di terze parti.
    4. Se il tipo di profilo è corretto, selezionare Visualizza.
    5. Copiare il contenuto del profilo.
  2. Eseguire il login all'istanza come utente con privilegi sudo
  3. Creare il file /etc/osmh-profile (senza estensione file sul nome file) utilizzando un editor di testo. Esempio: 
    sudo vi /etc/osmh-profile
  4. Incollare i contenuti del profilo copiati dalla console e salvare il file.

Installazione del Management Agent

Installare il software del Management Agent nell'istanza. Il Management Agent utilizza il plugin Hub di gestione del sistema operativo per registrare le istanze con il servizio Hub di gestione del sistema operativo.

Nota

Per informazioni dettagliate sull'installazione del software Management Agent, vedere Installazione dei Management Agent.
  1. Verificare che /etc/sudoers includa /etc/sudoers.d: 
    sudo visudo

    Confermare la presenza delle seguenti righe. In caso contrario, aggiungerli e salvare il file.

    ## Read drop-in files from /etc/sudoers.d (the # here does not mean a comment)
#includedir /etc/sudoers.d
  2. Installare i pacchetti richiesti. Questo include Java 8 (minimo 1.8u281 o versione 1.8 successiva).

    Java 8 deve essere installato sull'istanza prima di installare il software Management Agent.

    Oracle Linux 9
    sudo dnf install -y java-1.8.0-openjdk chkconfig
    Oracle Linux 8 8
    sudo dnf install -y java-1.8.0-openjdk
    Oracle Linux 7 
    sudo yum install -y java-1.8.0-openjdk
  3. Impostare la variabile di ambiente JAVA_HOME per utilizzare Java 8. L'impostazione della variabile garantisce che MACS utilizzi la versione corretta di Java quando sul sistema sono presenti versioni più recenti. 
    JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk ; export JAVA_HOME
  4. Passare alla directory che contiene il file RPM del software di Management Agent scaricato ed eseguire il comando seguente per installare il file RPM:
    Oracle Linux 8 o 9
    sudo --preserve-env=JAVA_HOME dnf install -y <rpm_file_name>.rpm
    Oracle Linux 7 
    sudo --preserve-env=JAVA_HOME yum install -y <rpm_file_name>.rpm

Impostare il Management Agent

Attivare il Management Agent con il plugin Hub di gestione del sistema operativo. Al momento dell'attivazione, l'istanza si registra con il servizio Hub di gestione del sistema operativo nel compartimento specificato nella chiave di installazione e con il contenuto associato al profilo.

  1. Configurare il plugin Management Agent per l'esecuzione come root. Il plugin Hub di gestione del sistema operativo deve essere eseguito come root per applicare patch all'istanza. Esempio: 
    sudo tee /etc/sudoers.d/mgmt_agent <<EOF
## Allows Management Agent to change ownership of deployed External Plugin
mgmt_agent ALL=(ALL) NOPASSWD:/opt/oracle/mgmt_agent/agent_inst/bin/chown_recursive_ep.sh
## Allows Management Agent to run External Plugin under root user
mgmt_agent ALL=(root) NOPASSWD:SETENV: /opt/oracle/mgmt_agent/plugins/osmh/*/osmh
## Disable requiretty for Management Agent
Defaults:mgmt_agent !requiretty
EOF
  2. Impostare le autorizzazioni del file su 440. 
    sudo chmod 440 /etc/sudoers.d/mgmt_agent
  3. Nella console copiare la chiave di installazione di Management Agent da utilizzare per registrare l'istanza.
    1. Aprire il menu di navigazione e selezionare Osservabilità e gestione. In Management Agent, selezionare Download e chiavi.
    2. In Installa chiavi, individuare la chiave che si desidera utilizzare per registrare l'istanza.
    3. Selezionare il menu Azioni per il tasto e selezionare Copia chiave negli Appunti.
  4. Creare manualmente un file di risposta (input.rsp) con un editor di testo e sostituire <MACS_KEY> con la chiave di installazione copiata nel passo precedente.

    Ad esempio:

    cat >/tmp/input.rsp <<EOF
ManagementAgentInstallKey = <MACS_KEY>
Service.plugin.osmh.download = true
GatewayServerHost = <STATION_OR_LOAD_BALANCER_HOSTNAME>
GatewayServerPort = <STATION_PROXY_PORT>
EOF

    Il file input.rsp richiede i seguenti parametri obbligatori.

    • ManagementAgentInstallKey: chiave di installazione necessaria per verificare l'identità del dominio e l'autenticità dell'installazione.
    • Service.plugin.osmh.download = true: distribuisce il plugin Hub di gestione del sistema operativo (osmh) durante l'installazione dell'agente.

    Per utilizzare la stazione di gestione come proxy per tutte le comunicazioni dell'hub di gestione del sistema operativo con l'istanza, aggiungere i seguenti parametri nel file input.rsp.

    Per identificare il nome host e la porta proxy della stazione di gestione, attenersi alla procedura riportata di seguito nella console.

    1. In Hub di gestione del sistema operativo selezionare Profili.
    2. Selezionare il profilo associato all'istanza.
    3. Nella sezione Informazioni sul profilo selezionare il nome della stazione di gestione.
    4. Selezionare la scheda Configurazione.
    5. Registrare i valori Nome host e Porta di ascolto proxy da utilizzare nel file input.rsp.
  5. Configurare il Management Agent eseguendo lo script setup.sh utilizzando il file di risposta. 
    sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/tmp/input.rsp

    Una configurazione riuscita restituisce il seguente messaggio: Agent setup completed and the agent is running. L'impostazione del plugin Hub di gestione del sistema operativo può richiedere altri minuti in background.

Verifica registrazione e dettagli istanza

Verificare l'istanza registrata con l'hub di gestione del sistema operativo.

  1. In Hub di gestione del sistema operativo selezionare Istanze.
  2. In Ambito lista, selezionare il compartimento che contiene l'istanza.
  3. Verificare che l'istanza venga visualizzata nella tabella e che lo stato sia Attivo.
    Suggerimento

    Per risolvere i problemi di registrazione, vedere Registrazione non riuscita per istanza o Management Station.

  4. Selezionare il nome dell'istanza per visualizzarne i dettagli.

    In Informazioni sull'istanza è possibile visualizzare i dettagli dell'istanza, ad esempio il profilo di registrazione utilizzato per la registrazione al servizio e se si tratta di un membro di un gruppo o di un ambiente del ciclo di vita, se applicabile.

    Nota

    L'istanza potrebbe richiedere alcuni minuti per segnalare l'inventario iniziale del pacchetto e del modulo al servizio.