Documentazione dell'infrastruttura Oracle Cloud

Creare un connettore Oracle Data Safe in locale

Creare un connettore in locale Oracle Data Safe per connettere Oracle Data Safe a un database Oracle in locale, un database Oracle in un'istanza di computazione, un database Oracle Cloud@Customer o un database Amazon RDS per Oracle.

Puoi creare fino a 5 connettori on-premise Oracle Data Safe per ogni area nella pagina Connettori on-premise del servizio Oracle Data Safe in Oracle Cloud Infrastructure. Un'istanza di connettore in locale può supportare fino a 192 connessioni attive.

Prerequisiti per la creazione di un connettore in locale Oracle Data Safe

Prima di creare un connettore in locale Oracle Data Safe, completare i task dei prerequisiti riportati di seguito.

  • Ottenere l'autorizzazione per la creazione di un connettore in locale Oracle Data Safe. Vedere Risorse di registrazione target.

  • Assicurarsi che gli host su cui si prevede di installare il connettore in locale Oracle Data Safe soddisfino i requisiti hardware e software.

Requisiti hardware

Oracle consiglia di installare il connettore in locale su un computer host diverso dal computer host del database. È tuttavia possibile installarlo sul computer host del database, se necessario. In un ambiente di produzione, Oracle consiglia di installare il connettore in locale su due host Linux per l'alta disponibilità. Se uno degli host è inattivo a causa di un errore o di una manutenzione del sistema, le connessioni Oracle Data Safe eseguono automaticamente il failover sul connettore in locale in esecuzione sull'altro host e le operazioni in corso di Oracle Data Safe non sono interessate.

Assicurarsi che il computer host su cui si intende installare il connettore in locale soddisfi i seguenti requisiti hardware:

  • CPU minima: 2

  • RAM minima: 16 GB

  • Storage su disco locale minimo nel file system in cui si prevede di installare il connettore in locale:

    • 5 GB (il software del connettore in locale più i log richiedono 100 MB)

    • Spazio /tmp: 100 MB

      Le raccomandazioni da 5 GB si applicano alla posizione di installazione, non necessariamente al file system root (/). Ad esempio, se il file system root ha meno di 5 GB disponibili ma un altro file system (ad esempio /home o /opt) dispone di spazio libero sufficiente, è possibile installare il connettore in tale posizione. Il software e i log del connettore richiedono circa 100 MB.

  • Larghezza di banda dell'interfaccia di rete: 1 Gbps

  • Connettività di rete:

    • Connettività in uscita a Oracle Data Safe (accesspoint.datasafe.<region>.oci.oraclecloud.com:443). Sostituire <region> con la propria area, ad esempio accesspoint.datasafe.us-ashburn-1.oci.oraclecloud.com.

    • Connettività locale agli host o alle porte del listener del database di destinazione

Requisiti software

Assicurarsi che il computer host su cui si intende installare il connettore in locale soddisfi i seguenti requisiti software:

  • Sistema operativo:

    • Oracle Linux 7 o versione successiva (Linux x86-64) oppure

    • Red Hat Enterprise Linux (RHEL) 8

  • Python 3.5 o versione successiva. Se sono installate più versioni di Python, impostare l'impostazione predefinita su Python 3.5 o versioni successive o fornire esplicitamente il percorso Python durante l'esecuzione dei comandi.

  • Java versione 7 o successiva con una home Java valida (JAVA_HOME). Prima di eseguire il programma di installazione del connettore, verificare che la variabile di ambiente JAVA_HOME sia impostata su un'installazione Java supportata (Oracle consiglia Java 11 o versioni successive). Se JAVA_HOME non è impostato, il programma di installazione non riuscirà. Ecco un esempio di Java 11:

    export JAVA_HOME=/usr/lib/jvm/java-11
export PATH=$JAVA_HOME/bin:$PATH

echo $JAVA_HOME
java -version

Nota

Nota: per istruzioni su come disinstallare, aggiornare, arrestare e mostrare lo stato, fare riferimento al file README fornito con il bundle di installazione.

Creare un connettore Oracle Data Safe in locale

  1. Dal menu di navigazione in Oracle Cloud Infrastructure, selezionare Oracle AI Database, quindi in Data Safe - Sicurezza database selezionare Database di destinazione.

    Viene visualizzata la pagina Database di destinazione.

  2. A sinistra, selezionare Connettori in locale.

  3. A destra, selezionare Crea connettore in locale.

    Viene visualizzato il pannello Crea connettore in locale.

  4. Nell'elenco a discesa selezionare il compartimento in cui si desidera memorizzare il connettore in locale.

  5. Immettere un nome per il connettore in locale.

  6. (Facoltativo) Immettere una descrizione per il connettore in locale.

  7. (Facoltativo) Per configurare l'applicazione di tag, selezionare Aggiungi tag, quindi configurare una tag.

  8. Selezionare Crea connettore in locale.

    Il connettore in locale viene creato ed elencato nella tabella. Lo stato iniziale del ciclo di vita del connettore in locale è ora impostato su INACTIVE.

Scaricare il bundle di installazione per il connettore in locale Oracle Data Safe

È possibile scaricare il bundle di installazione per il connettore in locale dalla pagina Dettagli connettore nel servizio Oracle Data Safe.

  1. Dal menu di navigazione in Oracle Cloud Infrastructure, selezionare Oracle AI Database, quindi in Data Safe - Sicurezza database selezionare Database di destinazione.

    Viene visualizzata la pagina Database di destinazione.

  2. A sinistra, selezionare Connettori in locale.

  3. A destra, selezionare il connettore in locale creato.

    Viene visualizzata la pagina Informazioni sul connettore in locale.

  4. Selezionare Scarica bundle di installazione.

    Viene visualizzato il pannello Scarica bundle di installazione.

  5. Immettere una password per il bundle di installazione, confermarla, quindi selezionare Scarica.

    Tenere a portata di mano questa password perché sarà necessaria in un secondo momento quando si installa il connettore in locale su un host della rete. Il bundle di installazione viene scaricato nella posizione di download predefinita del browser.

  6. Copiare il file ZIP del bundle di installazione in un computer host nella rete.

  7. Estrarre il file e confermare di disporre dei seguenti file:

    • README - File Readme con istruzioni di installazione

    • connector.conf - File di configurazione di Connection Manager

    • downloads/orapki.zip - File ZIP contenente uno script orapki e file JAR richiesti

    • downloads/cman.zip - File ZIP contenente i file binari di Connection Manager

    • downloads/cmanora.template - Modello di configurazione di Connection Manager

    • util/datasafe_privileges.sql: script SQL per i privilegi di Oracle Data Safe. Puoi anche scaricare questo script dal servizio Oracle Data Safe in Oracle Cloud Infrastructure.

    • wallet/ewallet.p12 - Wallet P12

    • setup.py: script di impostazione Python per installare il connettore in locale

Installare un connettore Oracle Data Safe in locale

Connection Manager, nell'ambito dell'installazione del connettore in locale, stabilisce un tunnel TLS a un Connection Manager cloud. È possibile controllare il traffico in uscita dal computer host all'indirizzo IP del Connection Manager cloud, che viene ascoltato sulla porta 443. L'indirizzo di un Connection Manager cloud è accesspoint.datasafe.REGIONNAME.oci.oraclecloud.com. Ad esempio, per l'area Ashburn, l'indirizzo è accesspoint.datasafe.us-ashburn-1.oci.oraclecloud.com. È possibile ottenere l'indirizzo IP del Connection Manager cloud eseguendo una ricerca DNS.

Vengono installati anche i seguenti elementi. Per ulteriori informazioni su questi elementi, consultare il manuale Database Administrator's Guide.

  • Utility di controllo del listener (lsnrctl)

  • Utility di test della connessione (tnsping)

  1. Aprire un prompt dei comandi su un computer host in cui si desidera installare il connettore in locale.

  2. Verificare che JAVA_HOME sia configurato e punti all'installazione Java.

    echo $JAVA_HOME
java -version

  3. Passare alla directory in cui si prevede di installare il connettore in locale ed eseguire il comando seguente per verificare che il file system disponga di almeno 5 GB di spazio su disco disponibile.

    df -h .

  4. In qualità di utente diverso dall'utente root, immettere il comando seguente per installare il connettore in locale.

    Non eseguire il programma di installazione come utente root.

    Fornire un numero di porta per il connettore in locale. L'argomento https-proxy è facoltativo. È possibile saltare l'argomento https-proxy se l'host di distribuzione dispone di accesso a Internet pubblico. Il connettore in locale non supporta un nome utente e una password proxy.

    Il proxy HTTP potrebbe non essere sufficiente a seconda della configurazione di rete e dei criteri di sicurezza dell'organizzazione. Ad esempio, alcune reti richiedono un nome utente e una password per il proxy HTTP. In questi casi, contattare l'amministratore di rete per aprire le connessioni in uscita agli host nel dominio accesspoint.oraclecloud.com utilizzando la porta 443 senza passare attraverso un proxy HTTP.

    Anche l'argomento create-osservice è facoltativo. Impostando questa opzione su Yes, il connettore in locale verrà designato come servizio del sistema operativo. Questa designazione garantirà che il connettore in locale venga riavviato automaticamente ogni volta che viene riavviato il sistema operativo del computer host. Se questo argomento non è incluso o impostato su No, il connettore in locale dovrà essere riavviato manualmente ogni volta che viene riavviato il sistema operativo del computer host.

    Lo script di installazione avvia automaticamente il connettore in locale. Questo script presuppone che Python sia aliased o symlinked per puntare a Python 3.

    $ python setup.py install --connector-port=`<port>` [--https-proxy=`<proxy:port>` --create-osservice=`<Yes or No>`]

    Esempi:

    $ python setup.py install --connector-port=1560
$ python setup.py install --connector-port=1560 --https-proxy=https://www-proxy.exampledomain.com:80 --create-osservice=Yes

  5. Al prompt, immettere la password creata al momento del download del bundle di installazione.

    Il connettore in locale viene installato nella directory corrente e avviato automaticamente. Lo stato del connettore in locale nel servizio Oracle Data Safe in Oracle Cloud Infrastructure è ora impostato su Active.

  6. (Opzionale) Per diagnosticare i problemi di installazione o eseguire comandi aggiuntivi (ad esempio disinstallazione, aggiornamento, avvio, arresto e stato), fare riferimento al file README fornito con il bundle di installazione.

Alta disponibilità di un connettore in locale

Se si desidera aumentare la resilienza del connettore in locale e renderlo altamente disponibile, installare un'altra istanza del connettore utilizzando lo stesso bundle di installazione scaricato per la prima installazione su un host o una VM diverso. È possibile avviare o installare fino a tre istanze dello stesso connettore in locale. Ogni connettore eseguirà il check-in con Oracle Data Safe e, se un'istanza del connettore non riesce o non è raggiungibile, Data Safe proverà automaticamente uno dei connettori rimanenti. È possibile che fino a tre copie del connettore siano in esecuzione contemporaneamente.

Controllare lo stato di un connettore in locale

Per controllare lo stato di un connettore in locale, immettere il comando seguente:

python setup.py status

Riavviare un connettore in locale

Per riavviare un connettore in locale, eseguire il comando seguente:

python setup.py restart

Creazione del servizio utente del sistema operativo per i connettori in locale esistenti

Designando il connettore in locale come servizio del sistema operativo, è possibile evitare che il connettore in locale richieda un riavvio manuale dopo un riavvio del sistema operativo del computer host del connettore in locale.

Per designare un connettore in locale esistente come servizio del sistema operativo, eseguire il comando seguente sul connettore in locale:

setup.py osservice --command=create

Questo comando garantirà che il connettore in locale venga riavviato ogni volta che viene riavviato il sistema operativo del computer host.

Aggiornare un connettore Oracle Data Safe in locale

È possibile aggiornare un connettore in locale di Oracle Data Safe scaricando una nuova copia del bundle di installazione e quindi eseguendo lo script di impostazione per eseguire l'aggiornamento.

La procedura di download per la creazione e l'aggiornamento dei connettori in locale è la stessa e il bundle include lo stesso set di file. Tuttavia, nella procedura di aggiornamento è necessario decomprimere i file bundle nella stessa directory in cui è già installato il connettore, sovrascrivendo i file esistenti. Inoltre, per eseguire un aggiornamento, passare l'argomento update allo script setup.py anziché all'argomento install.

Nota

Nota: durante l'aggiornamento, il connettore in locale non è in grado di connettersi ai database di destinazione che potrebbero utilizzarlo. La connessione viene ristabilita al termine dell'aggiornamento.

  1. Scaricare il bundle di installazione nel computer locale dalla pagina Informazioni sul connettore in locale nel servizio Oracle Data Safe.

    Per le istruzioni di download, vedere Scaricare il bundle di installazione per Oracle Data Safe On-Premises Connector.

  2. Caricare il bundle nell'host in cui si desidera aggiornare il connettore.

  3. Decomprimere il bundle nella directory in cui è installato il connettore in locale. Questa operazione sovrascrive i file correnti.

  4. Come utente diverso da root, eseguire setup.py con l'argomento update.

    $ python setup.py update

  5. Immettere la password del bundle quando richiesto.

    Enter bundle password:

Dovresti vedere i seguenti messaggi:

Data Safe on-premises connector update in progress...
Updating wallet...
Data Safe on-premises connector successfully updated

L'aggiornamento del connettore in locale viene completato.

In caso di errori durante l'aggiornamento, vedere Risoluzione dei problemi di installazione o aggiornamento.

Disinstallare un connettore in locale di Oracle Data Safe

È possibile utilizzare lo script setup.py per disinstallare un connettore in locale di Oracle Data Safe.

  1. Eseguire il login all'host in cui è installato il connettore in locale.

  2. Andare alla directory in cui è installato il connettore in locale. Individuare lo script setup.py.

  3. Eseguire setup.py con l'argomento uninstall come utente diverso da root.

    $ python setup.py uninstall

    Al prompt, confermare che si desidera disinstallare il connettore:

    This will remove the Data Safe on-premises connector, please confirm (Yes/No): yes

Data Safe on-premises connector successfully uninstalled

Trovare i file di log per un connettore in locale

I log di configurazione e gestione di un connettore in locale sono disponibili all'indirizzo:

`<script_directory>`/log/

Il log di runtime di un connettore in locale è disponibile all'indirizzo:

`<script_directory>`/oracle_cman_home/log/diag/netcman/<hostName>/cust_cman/trace/cust_cman.log

Risoluzione dei problemi di installazione o aggiornamento

  1. Messaggio di errore: Failed to create the tunnels to Data Safe connection manager - for more details check <log file name>

    Dopo l'installazione o l'aggiornamento, il connettore in locale di Oracle Data Safe tenta di connettersi (o riconnettersi) a Oracle Data Safe Connection Manager. Questo messaggio potrebbe non indicare un errore effettivo. Può apparire se la creazione del tunnel è lenta. Per verificare che il connettore funzioni, eseguire il comando show tunnels. Se esistono uno o più tunnel (connessioni), il connettore in locale può comunicare con Connection Manager ed è possibile ignorare questo messaggio.

    $ ./oracle_cman_home/bin/cmctl show tunnels -c cust_cman
    CMCTL for Linux: Version 20.0.0.0.0 - Production on 09-OCT-2021
    10:45:34
Copyright (c) 1996, 2020, Oracle. All rights reserved.
Current instance cust_cman is already started
Connecting to (address_list=(address=(protocol=TCPS)(host=localhost)(port=1520)))

Number of connections: 12.
The command completed successfully.

  2. Se si verifica un errore durante un comando update (ad esempio se show tunnels indica che non esistono tunnel), provare a rieseguire il comando update. Eseguire uninstall e quindi rieseguire install solo se update non riesce di nuovo. Questo perché dopo aver eseguito uninstall potrebbe essere necessario reimportare i certificati del database se la configurazione TCPS faceva parte dell'installazione originale.