Registrazione di una stazione di gestione

Registrare una stazione di gestione con l'hub di gestione del sistema operativo utilizzando il profilo per la stazione di gestione e installando il Management Agent.

Dopo la registrazione, l'hub di gestione del sistema operativo allega le origini software minime richieste all'istanza della stazione (Oracle Linux 8 BaseOS e Oracle Linux 8 Appstream). Ciò garantisce che l'hub di gestione del sistema operativo possa fornire aggiornamenti all'istanza che funge da stazione.

Informazioni preliminari

Per registrare correttamente una stazione di gestione con il servizio Hub di gestione del sistema operativo, effettuare le operazioni riportate di seguito.

Installa package richiesti

La stazione di gestione viene eseguita come applicazione server Apache nel suo ruolo di proxy di rete e mirror yum locale per il servizio Hub di gestione del sistema operativo. È necessario installare il server Web Apache richiesto e avviare e abilitare il servizio httpd.

Se la stazione di gestione utilizza SELinux, è necessario installare anche il pacchetto policycoreutils-python-utils, che fornisce le utility necessarie per la gestione di SELinux.

  1. Eseguire il login all'istanza come utente con privilegi sudo.
  2. Installare i pacchetti Apache necessari.
    sudo dnf install -y httpd mod_ssl openssl
  3. Avviare e abilitare il servizio httpd.
    sudo systemctl start httpd
    sudo systemctl enable httpd
  4. Installare il pacchetto SELinux richiesto ed eventuali dipendenze.
    sudo dnf install -y policycoreutils-python-utils
    

Aggiungere il profilo postazione all'istanza

Aggiungere il profilo della stazione all'istanza. Il profilo identifica l'istanza come stazione di gestione. Il profilo può essere utilizzato per registrare una sola stazione di gestione. Impossibile riutilizzare i profili delle stazioni di gestione.
  1. Nella console copiare il contenuto del profilo della stazione di gestione.
    1. In Hub di gestione del sistema operativo selezionare Stazioni di gestione.
    2. Selezionare il nome della stazione di gestione di cui si desidera utilizzare il profilo.
    3. Selezionare Visualizza profilo.
    4. 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 Management Agent nell'istanza della stazione di gestione. Hub di gestione del sistema operativo richiede l'installazione di un Management Agent nell'istanza e fornisce un plugin del servizio al servizio Management Agent.
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.

    sudo dnf 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:
    sudo --preserve-env=JAVA_HOME dnf install -y <rpm_file_name>.rpm

Impostare il Management Agent

Creare il file di risposta del Management Agent nell'istanza della stazione di gestione e configurare il file di risposta in modo che utilizzi il Management Agent con il plugin del servizio Hub di gestione del sistema operativo per registrare l'istanza 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. 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. Assicurarsi di aver creato la chiave di installazione di Management Agent.
  4. 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.
  5. 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
    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.
  6. 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.

  7. Configurare il firewall e le impostazioni SELinux per consentire il traffico e l'accesso.

    La stazione di gestione utilizza le porte definite durante l'impostazione per sincronizzare il mirror yum e gestire il traffico proxy in OCI.

    È possibile aggiornare manualmente le regole del firewall e le impostazioni SELinux oppure utilizzare lo script station-setup.sh.

    Lo script station-setup.sh configura il firewall e le impostazioni SELinux per consentire il traffico sulle porte specificate nella configurazione proxy nella stazione di gestione e nel server Web Apache HTTP per servire i pacchetti dal percorso nella configurazione del mirror. Lo script gestisce il firewall e la configurazione SELinux per i mirror utilizzando il file system xfs, ext4, btrfs o nfs.

    Importante

    Per comodità, lo script station-setup.sh è disponibile per configurare le impostazioni del firewall e SELinux. Prima di eseguire lo script nell'ambiente di produzione, controllare lo script e comprendere le modifiche apportate dallo script alle impostazioni del firewall e SELinux.
    sudo /opt/oracle/mgmt_agent/plugins/osmh/stateDir/station-setup.sh
    Nota

    Se si riceve un messaggio di errore command not found o No such file, attendere alcuni minuti per il completamento dell'impostazione del plugin Hub di gestione del sistema operativo e rendere disponibile lo script station-setup.sh. Se il problema persiste, la registrazione potrebbe aver avuto esito negativo. Vedere Registrazione non riuscita per l'istanza o la stazione di gestione.
  8. Se non è stato eseguito lo script station-setup.sh, riavviare il server Web Apache HTTP.
    sudo systemctl restart httpd

Verifica registrazione e dettagli Management Station

Verificare che la stazione di gestione sia registrata con l'hub di gestione del sistema operativo come istanza ed sia disponibile per il mirroring e la distribuzione del contenuto alle istanze nel data center.

  1. In Hub di gestione del sistema operativo selezionare Stazioni di gestione.
  2. Selezionare il compartimento contenente la stazione di gestione.
  3. Verificare che la stazione di gestione sia elencata nella tabella e che il relativo stato sia Attivo.
    Suggerimento

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

  4. Selezionare il nome della stazione di gestione per visualizzarne i dettagli.
    Importante

    L'elenco delle origini software in mirroring rimarrà vuoto finché non si crea un profilo che utilizza la stazione. Vedere Quali origini software vengono sottoposte a mirroring?

Passaggi successivi

Dopo aver registrato la stazione di gestione, i passi successivi potrebbero includere: