Installation de la passerelle de données distante

Installez la passerelle de données distante pour permettre à Oracle Analytics Cloud d'accéder aux données stockées dans un sous-réseau privé.

Les instructions et un lien permettant de télécharger le programme d'installation sont fournis dans la section Code de téléchargement.

Pour accéder à une base de données, le processus d'écoute de passerelle de données distante requiert à la fois un port ouvert dans un pare-feu Linux et une règle d'entrée dans la liste de sécurité du réseau cloud virtuel (VCN).

Préparation de l'installation de la passerelle de données distante

Pour vous préparer à installer la passerelle de données distante, vous devez copier le programme d'installation vers l'instance de calcul bastion et vers l'instance de calcul qui hébergera la passerelle. Vous devez également créer un fichier d'emplacement d'inventaire et un fichier de réponses du programme d'installation.

Avant de commencer les étapes ci-dessous, téléchargez le programme d'installation de la passerelle de données distante (RDG). Les instructions et un lien permettant de télécharger le programme d'installation sont fournis dans la section Code de téléchargement.

  1. Copiez l'archive du programme d'installation et la clé privée SSH que vous avez créée précédemment dans l'instance de calcul hébergeant le serveur bastion.
    Utilisez le protocole de copie sécurisée (SCP) à partir de systèmes de type Linux (ou protocole RDP (RemoteDesktop Protocol) à partir de systèmes Windows) pour copier le programme d'installation. Par exemple, à partir d'un système de type Linux où opc est l'utilisateur par défaut :
    $ scp -i <path to installer file> opc@<IP address or host name>:/tmp
  2. De même, copiez l'archive du programme d'installation et la clé privée SSH vers l'instance de calcul hébergeant la passerelle de données distante.
  3. Utilisez le shell sécurisé (SSH) pour vous connecter à l'instance hébergeant le RDG. Par exemple :
    $ ssh -i <private key path> <user>@<IP address or host name>
  4. Décompressez l'archive du programme d'installation. Par exemple, les décompresses suivantes décompressent l'archive dans le répertoire personnel de l'utilisateur en cours (opc) :
    $ cd ~ && unzip <path to the installer zip file>
  5. Créez un fichier d'emplacement d'inventaire.
    1. En tant qu'utilisateur root, utilisez un éditeur pour créer un fichier d'emplacement d'inventaire. Par exemple :
      $ sudo su -
      $ vi /etc/oraInst.loc
      inventory_loc=/home/opc/oraInventory
      inst_group=opc
      
      :wq
    2. Vérifiez le contenu du fichier, puis quittez la session utilisateur root :
       $ cat /etc/oraInst.loc 
      Inventory_loc=/home/opc/oralnventory 
      Inst_ group=opc 
      $ exit
  6. Créez un fichier de réponses du programme d'installation.
    1. Accédez au répertoire personnel :
      $ cd ~
    2. Utilisez un éditeur pour créer un fichier de réponses du programme d'installation avec un nom de fichier que vous choisissez.

      Assurez-vous de fournir le nom utilisateur et le mot de passe de l'administrateur de page d'informations d'identification. Par exemple :

      $ vi silentInstall.response
      [ENGINE]
      #DO NOT CHANGE THIS.
      Response File Version=1.0.0.0.0
      
      [GENERIC]
      ORACLE_HOME=/home/opc/Oracle/Middleware/Oracle_Home
      SELECT_RD_VERSION_RADIO_V1=false
      CREDENTIALS_PAGE_ADMIN_USERNAME=<admin user>
      CREDENTIALS_PAGE_PASSWORD=<admin password>
      
      :wq
    3. Vérifiez le contenu du fichier, puis quittez la session utilisateur root :
      $ cat silentInstall.response 
      [ENGINE]
      #DO NOT CHANGE THIS.
      Response File Version=1.0.0.0.0
      
      [GENERIC]
      ORACLE_HOME=/home/opc/Oracle/Middleware/Oracle_Home
      SELECT_RD_VERSION_RADIO_V1=false
      CREDENTIALS_PAGE_ADMIN_USERNAME=<admin user>
      CREDENTIALS_PAGE_PASSWORD=<admin password>

Installation et démarrage de la passerelle de données distante

Installez la passerelle de données distante sur l'instance de calcul à l'aide des fichiers de réponse et d'emplacement du programme d'installation.

Pour pouvoir installer la passerelle de données distante à l'aide des étapes ci-dessous, vous devez d'abord avoir copié et décompressé le programme d'installation de la passerelle et créé les fichiers de réponse et d'emplacement du programme d'installation.
  1. Accédez au répertoire personnel.
    $ cd ~
  2. Exécutez le programme d'installation "silencieusement" à l'aide des fichiers de réponse et d'emplacement du programme d'installation créés précédemment :
    $ ./datagateway-linux-105.5.bin -silent -responseFile /home/opc/silentInstall.response –invPtrLoc /etc/oraInst.loc 

    Le programme d'installation affiche les notifications de progression et un message lorsqu'il est terminé.

  3. Accédez au répertoire de base indiqué dans le fichier de réponses. Par exemple :
    $ cd /home/opc/Oracle/Middleware/Oracle_Home
  4. Démarrer la passerelle :
    $ domain/bin/startJetty.sh
  5. Exécutez la commande status et notez le port HTTP et l'URL à utiliser pour configurer la passerelle.
    $ domain/bin/status.sh

Ouvrir un port Firewall dans l'hôte de passerelle de données distante

Pour accéder à une base de données sur une machine virtuelle d'instance de calcul, le processus d'écoute de passerelle de données distante nécessite un port ouvert dans le pare-feu de l'hôte de passerelle de données distante.

Les pare-feux d'instance de calcul par défaut sont créés sans que les ports du processus d'écoute soient ouverts. Seul le port SSH (Secure Shell) 22 est ouvert.

Avant de commencer, assurez-vous que vous avez créé des règles d'entrée de liste de sécurité spécifiant le port du processus d'écoute en tant que 8080.

  1. Utilisez le shell sécurisé (SSH) pour vous connecter à l'instance de passerelle de données distante en tant qu'utilisateur opc:
    ssh -i <private_key_path> opc@<rdg_ip_or_host_name>
  2. Passez au mode Utilisateur root:
    sudo su -
  3. Pour afficher les ports ouverts, exécutez l'une ou l'ensemble des commandes suivantes :
    • Pour afficher les ports ouverts, procédez comme suit :
      firewall-cmd --list-ports
    • Si un port n'est pas répertorié, il peut être ouvert via un service. Pour afficher les services ouverts :
      firewall-cmd --list-services
    • Pour rechercher un service spécifique, tel que SSH, associé à un port, procédez comme suit :
      cat /etc/services | grep ssh
    • Pour rechercher un port spécifique, par exemple 1521:
      at /etc/services | grep 1521
  4. Pour ouvrir un port dans l'instance en cours d'exécution, procédez comme suit :
    firewall-cmd --add-port=<port>/<protocol>
    Pour indiquer que le port doit être ouvert lors des redémarrages futurs de l'instance, ajoutez l'option --permanent. Par exemple :
    firewall-cmd --permanent --add-port=8080/tcp