Avant de commencer

Ce tutoriel de 15 minutes vous montre comment accéder à l'instance Cloud Manager à partir d'un ordinateur Linux ou Microsoft Windows local.

Contexte

La pile Cloud Manager inclut un script de configuration d'instance ("bootstrap") qui s'exécute dans la machine virtuelle pour l'instance Cloud Manager une fois le travail d'application Resource Manager terminé. L'instance est accessible à partir d'une machine Microsoft Windows à l'aide d'un client SSH tel que PuTTY, ou directement à partir d'une méthode Linux machine.The que vous utilisez dépend de la façon dont vous configurez le réseau cloud virtuel.

Il s'agit du onzième tutoriel de la série Install PeopleSoft Cloud Manager. Lisez les tutoriels dans l'ordre indiqué. Les tutoriels facultatifs proposent d'autres méthodes de configuration.

Connexion à la machine virtuelle d'instance Cloud Manager à partir d'un système Linux ou UNIX

Suivez ces instructions si l'instance Cloud Manager réside dans un sous-réseau public. Pour accéder à l'instance à partir d'un ordinateur Linux ou UNIX :

  1. Obtenez l'adresse IP de l'instance Cloud Manager à partir de la page de détails de l'instance à l'aide de l'une des méthodes suivantes :
    • Dans le travail d'application Resource Manager (Resource Manager > Stack > Stack Details > Job Details), sélectionnez Outputs, puis copiez cm_http_url.
    • Sur la page d'accueil d'Oracle Cloud Infrastructure, cliquez sur l'icône de menu en haut à gauche, puis sélectionnez Compute > Instances.Sélectionnez votre compartiment et affichez la page de détails de l'instance. La page d'informations sur l'instance inclut l'adresse IP publique.
  2. Entrez la commande suivante : 
    ssh -i <path_to_private_key_file>/<private_key_name> -o ServerAliveInterval=5 -o ServerAliveCountMax=1 opc@<public_ip_address_of_instance>
  3. Si vous avez fourni une phrase de passe lors de la création de votre paire de clés SSH, saisissez-la lorsque vous y êtes invité.
  4. La première fois que vous êtes connecté à votre instance, l'utilitaire SSH vous invite à confirmer la clé publique. En réponse à l'invite, entrez yes.

Connexion à la machine virtuelle d'instance Cloud Manager à partir d'un système Microsoft Windows

Suivez ces instructions si l'instance Cloud Manager réside dans un sous-réseau public. Pour accéder à l'instance à partir d'un ordinateur Microsoft Windows :

  1. Obtenez l'adresse IP de l'instance Cloud Manager à partir de la page de détails de l'instance à l'aide de l'une des méthodes suivantes :
    • Dans le travail d'application Resource Manager (Resource Manager > Stack > Stack Details > Job Details), sélectionnez Outputs, puis copiez cm_http_url.
    • Sur la page d'accueil d'Oracle Cloud Infrastructure, cliquez sur l'icône de menu en haut à gauche, puis sélectionnez Compute > Instances.Sélectionnez votre compartiment et affichez la page de détails de l'instance. La page d'informations sur l'instance inclut l'adresse IP publique.
  2. Démarrez l'utilitaire PuTTY. La fenêtre de configuration PuTTY est affichée, montrant le panneau Session.
  3. Dans le champ Nom de l'hôte (ou adresse IP), entrez l'adresse IP publique de votre instance.
  4. Dans le champ Type de connexion, sélectionnez SSH s'il n'est pas déjà sélectionné.
    Boîte de dialogue PuTTY Configuration, options de base pour la session PuTTY
    Description de cette illustration (putty_login3.png)

  5. Dans le panneau Catégorie, cliquez sur Connexion. Entrez 5 dans la zone de texte Secondes entre les connexions persistantes (0 pour désactiver).

    PuTTY Boîte de dialogue Configuration, Options contrôlant la connexion
    Description de cette illustration (putty_login4.png)
  6. Dans le panneau Catégorie, développez SSH, puis cliquez sur Authentification. Le panneau Authentification est affiché.
  7. Dans le champ du fichier de clé privée pour l'authentification, cliquez sur Parcourir et sélectionnez le fichier à clé privée que vous avez enregistré précédemment, mykey.ppk dans cet exemple.
    PuTTY Boîte de dialogue Configuration, Options contrôlant l'authentification SSH
    Description de cette illustration (putty_login6.png)
  8. Dans l'arborescence Catégorie, cliquez sur Session.

    Le panneau Session est affiché.

  9. Dans le champ Sessions sauvegardées, entrez un nom pour cette configuration, puis cliquez sur Enregistrer.
  10. Cliquez sur Open pour ouvrir la connexion.

    La fenêtre Configuration PuTTY se ferme et la fenêtre PuTTY s'affiche.

  11. Lorsque vous êtes invité à saisir un nom utilisateur, entrez opc.
  12. Entrez la phrase secrète qui vous a été fournie pour votre paire de clés SSH.
  13. La première fois que vous êtes connecté à votre instance, la fenêtre PuTTY Security Alert s'affiche et vous invite à confirmer la clé publique. Cliquez sur Oui pour continuer.

Configuration de l'accès SSH à une instance de gestionnaire de cloud privé via un bastion

Si vous avez créé des ressources réseau, des sous-réseaux privés ou publics et un bastion OCI dans le cadre de l'installation de Cloud Manager, suivez ces instructions pour configurer une session SSH gérée (tunnel SSH) sur un sous-réseau privé Cloud Manager via un bastion. L'accès SSH dure jusqu'à ce que vous fermiez le shell Bash ou le shell git bash, tant que la session de bastion est active.

Pour plus d'informations sur la création et l'utilisation des bastions, reportez-vous à la documentation Oracle Cloud Infrastructure relative au service Bastion.

Vous devez fournir une clé privée SSH au format OpenSSH pour ces commandes. Si vous avez créé une clé privée SSH au format RSA dans PuTTY, convertissez-la au format OpenSSH, comme suit :

  1. Ouvrez le générateur PuTTY et chargez la clé privée en cours.
  2. Sélectionnez Conversions > Exporter la clé OpenSSH.
  3. Enregistrez le fichier et notez le chemin complet et le nom de la clé.

    Remarques :

    Pour distinguer cette clé privée de la clé privée que vous utilisez avec PuTTY, vous pouvez enregistrer le fichier sous un autre nom. Vous ne pouvez pas utiliser cette version de la clé avec PuTTY.
  4. Utilisez la nouvelle clé exportée dans la commande pour créer le tunnel SSH.

Pour configurer l'accès SSH avec le bastion, procédez comme suit :

  1. Dans la console Compute, cliquez sur l'icône de menu en haut à gauche, puis sélectionnez Compute, puis Instances.
  2. Si nécessaire, sélectionnez votre compartiment et localisez l'instance Cloud Manager.
  3. Sélectionnez l'onglet Agent Oracle Cloud et vérifiez que le module d'extension Bastion a été activé. Si elle n'est pas activée, activez-la.

    Le travail Resource Manager Apply pour l'instance Cloud Manager active le module d'extension Bastion par défaut. Si vous utilisez ces instructions pour accéder à un environnement provisionné PeopleSoft, vous devrez peut-être activer le module d'extension Bastion. Il faudra un peu de temps pour devenir actif.

    Page Détails de l'instance, onglet Agent Oracle Cloud
    Description de cette illustration (ssh_access_instance_details_bastion_enabled.png)
  4. Sélectionnez Gestionnaire de ressources, puis Piles et localisez la pile Cloud Manager.
  5. Sur la page Détails de pile de l'instance Cloud Manager, sélectionnez le travail Appliquer.
  6. Sur la page Détails du travail, sélectionnez Sorties dans la liste Ressources à gauche et notez le nom du bastion.
  7. Sélectionnez Identité et sécurité, puis Bastion et localisez le bastion.
  8. Si aucune session n'est active, cliquez sur Créer une session.
  9. Sélectionnez une session SSH gérée dans la liste déroulante Type de session.
  10. Entrez un nom pour la session ou acceptez la valeur par défaut.
  11. Entrez opc pour le nom utilisateur.
  12. Si nécessaire, modifiez le compartiment et sélectionnez l'instance Cloud Manager dans la liste déroulante des instances Compute.
  13. Indiquez la clé SSH publique en accédant au fichier de clés, en collant le texte du fichier de clés ou en générant une nouvelle paire de clés.
    Page Créer une session pour une session SSH gérée
    Description de cette illustration (ssh_access_create_managed_session.png)
  14. Cliquez sur Créer une session, puis sur
  15. Attendez que l'état de la session soit Actif. Cliquez sur l'icône Actions et sélectionnez Copier la commande SSH.
    Copier la commande SSH pour la session SSH gérée
    Description de l'image (ssh_access_copy_ssh_command.png)
  16. Collez la commande dans un éditeur de texte et remplacez <privateKey> par le chemin complet et le nom de la clé par la clé au format OpenSSH.

    Veillez à remplacer les deux instances de <privateKey> dans la commande.

  17. Dans un shell Bash (Linux) ou Microsoft Windows (git bash shell), entrez la commande modifiée pour créer la connexion SSH à l'instance Cloud Manager.

    Si vous avez créé une phrase de passe lors de la génération de la clé privée, vous êtes invité à la saisir.

    Remarques :

    Si vous ne parvenez pas à vous connecter, cela peut être dû à la version de git bash que vous utilisez. Reportez-vous à la solution à la fin de cette section.
  18. Pour vérifier le chemin en cours après avoir accédé à l'instance Cloud Manager, entrez pwd. 
    $ pwd
    
 /home/opc
  19. Pour quitter l'instance Cloud Manager et revenir à l'invite de shell Bash ou git bash, tapez exit.

Conseil :

Dans le shell Bash ou git bash, en cas d'erreur, utilisez CTRL+c pour terminer une commande.

Remarques :

Pour vérifier la connexion au tunnel SSH, vous pouvez utiliser la commande suivante et rechercher "tunnel" dans la sortie :

ps -ef | grep ssh

Avec certaines versions de git bash, un message d'erreur tel que "Impossible de négocier avec <port number>" peut s'afficher lorsque vous entrez la commande de création de la connexion SSH. Suivez ces étapes pour éviter l'erreur.

  1. Notez l'hôte du bastion à partir de la commande SSH que vous avez copiée après la création de la session (étape 15). Dans cet exemple de commande, il s'agit du texte en gras commençant par host.bastion.
    ssh -i <privateKey> -o ProxyCommand="ssh -i <privateKey> -W %h:%p -p 22 ocid1.bastionsession.oc1.us-ashburn-1.xxxxxxxxxx@host.bastion.us-ashburn-1.oci.oraclecloud.com" -p 22 opc@xx.x.x.xx
  2. Dans le shell git-bash, accédez au répertoire personnel de l'utilisateur :
    $ cd ~
  3. Créez un nouveau répertoire nommé ".ssh" sous le répertoire personnel :
    $ mkdir .ssh
  4. Accédez au répertoire .ssh.
    $ cd .ssh
  5. Créez un fichier nommé config, par exemple en utilisant vi ou un autre éditeur :
    $ vi config

    Conseil :

    Vérifiez l'utilisation avec vi --help.
  6. Ajoutez ces contenus au fichier et enregistrez. 
    Host <bastion host>
    User opc
    PubkeyAcceptedAlgorithms +ssh-rsa
    HostkeyAlgorithms +ssh-rsa

    Pour <bastion host>, saisissez les informations de la commande SSH ; par exemple :

    Host host.bastion.us-ashburn-1.oci.oraclecloud.com
    User opc
    PubkeyAcceptedAlgorithms +ssh-rsa
    HostkeyAlgorithms +ssh-rsa
  7. Entrez la commande SSH pour accéder à l'instance Cloud Manager.

Vous pouvez également créer le répertoire .ssh et le fichier de configuration dans l'Explorateur de fichiers Windows avant de les utiliser dans le shell git-bash.

  1. Notez l'hôte du bastion à partir de la commande SSH que vous avez copiée après la création de la session (étape 15). Dans cet exemple de commande, il s'agit du texte en gras.
    ssh -i <privateKey> -o ProxyCommand="ssh -i <privateKey> -W %h:%p -p 22 ocid1.bastionsession.oc1.us-ashburn-1.xxxxxxxxxx@host.bastion.us-ashburn-1.oci.oraclecloud.com" -p 22 opc@xx.x.x.xx
  2. Dans le shell git-bash, accédez au répertoire personnel de l'utilisateur.
    $ cd ~
  3. Déterminez le répertoire personnel de l'utilisateur.
    $ pwd
    /c/Users/username

    Le chemin /c/Users/username dans le shell git-bash correspond à C:\Users\username dans l'explorateur de fichiers Windows.

  4. Dans l'Explorateur de fichiers Windows, accédez à C:\Users\username et créez le répertoire .ssh.
  5. Accédez au répertoire C:\Users\username\.ssh.
  6. A l'aide du Bloc-notes ou d'un autre éditeur de texte, créez le fichier de configuration avec ces contenus et enregistrez-le.
    Host <bastion host>
    User opc
    PubkeyAcceptedAlgorithms +ssh-rsa
    HostkeyAlgorithms +ssh-rsa
    Pour <bastion host>, saisissez les informations de la commande SSH ; par exemple :
    Host host.bastion.us-ashburn-1.oci.oraclecloud.com
    User opc
    PubkeyAcceptedAlgorithms +ssh-rsa
    HostkeyAlgorithms +ssh-rsa
  7. Accédez au shell git-bash et exécutez la commande SSH pour accéder à l'instance Cloud Manager.

Surveiller le processus de configuration de Cloud Manger et consulter les fichiers journaux

Surveillez le statut du processus de configuration en consultant le fichier journal /home/opc/bootstrap/CloudManagerStatus.log.

  1. Accédez à l'instance Cloud Manager dans une fenêtre de terminal Linux ou avec PuTTY.
  2. Pour afficher la fin du fichier journal, entrez la commande suivante : 
    $ tail /home/opc/bootstrap/CloudManagerStatus.log
  3. Si vous souhaitez consulter d'autres fichiers journaux, utilisez ces commandes pour naviguer.

    Entrez pwd pour vérifier le répertoire actuel.

    $ pwd
    /home/opc
  4. Accédez au répertoire /home/opc/bootstrap.
    $ cd bootstrap
  5. Pour afficher les fichiers et répertoires dans /home/opc/bootstrap, entrez ls.
    $ ls

Le processus de configuration prend plusieurs minutes. Une fois le traitement terminé, le même fichier journal inclut l'URL du gestionnaire cloud pour se connecter à PeopleSoft Pure Internet Architecture (PIA) dans un navigateur.

Les autres fichiers journaux sont les suivants :

  • /home/opc/bootstrap/CloudManagerStatus.log : journaux d'entrée de l'assistant Configuration d'instance Cloud Manager
  • /home/opc/bootstrap/psft_oci_setup.log : journal de provisionnement du gestionnaire cloud
  • /home/opc/bootstrap/cmpatch/logs/cmpatch_apply.log : contient des détails sur les étapes du processus de téléchargement des fichiers de patch de mise à jour de Cloud Manager.
  • /home/psadm2/psft/data/cloud/cmlogs/BOOTSTRAP_LOGS/* : journaux de l'administrateur cloud PeopleSoft liés à des processus tels que la création de serveur de fichiers
  • /opt/oracle/psft/dpks/setup/psft_dpk_setup.log : journal Puppet détaillé pour l'installation de Cloud Manager.

Pour plus d'informations, reportez-vous à PeopleSoft Cloud Manager for Oracle Cloud Infrastructure, Journaux Cloud Manager. Sélectionnez Aide en ligne (HTML) ou PeopleBooks (PDF) sur la page PeopleSoft Cloud Manager d'Oracle Help Center.

Copier les fichiers journaux de la machine virtuelle vers un ordinateur Windows (facultatif)

Si vous souhaitez copier les fichiers journaux sur un ordinateur Microsoft Windows, utilisez une copie sécurisée ou un utilitaire FTP sécurisé tel que ceux associés à Putty.

Par exemple, pour transférer les fichiers à l'aide de l'utilitaire PSCP dans PuTTY :

  1. Créez une session enregistrée dans PuTTY pour vous connecter à l'instance Linux Cloud Manager.
  2. Notez le chemin d'accès à votre installation Putty sur votre ordinateur portable (par exemple, C:\Program Files (x86)\PuTTY).
  3. Notez le chemin sur la machine virtuelle Linux avec les fichiers que vous souhaitez copier et le chemin sur votre ordinateur portable où vous souhaitez les enregistrer.
  4. Ouvrez une invite de commande et notez la variable d'environnement PATH.

    Pour répertorier les variables d'environnement, entrez la commande set. Copiez le contenu de PATH dans le Bloc-notes ou ailleurs en tant que sauvegarde.

  5. Dans l'invite de commande, ajoutez le chemin d'accès à l'installation PuTTY au début du chemin. Exemple : 
    set PATH=C:\Program Files (x86)\PuTTY;%PATH%

    Remarques :

    Ce paramètre de variable d'environnement ne dure que jusqu'à la fermeture de la fenêtre de commande.

  6. Utilisez cette commande pour vous connecter à la session avec l'utilisateur opc et copier les fichiers de la machine virtuelle Linux source vers l'ordinateur Microsoft Windows cible :

    pscp –l <user> <session name>:<source> <target>

  7. Entrez la phrase de passe de la clé SSH à l'invite.

    >pscp -l opc cm-oci-infodev:/home/opc/bootstrap/psft_oci_setup.log C:\user\CloudManager\target
    Passphrase for key "rsa-key-psft":
    psft_oci_setup.log        | 1142 kB | 1142.5 kB/s | ETA: 00:00:00 | 100%

Etapes suivantes

Spécifier les paramètres du gestionnaire de cloud

En savoir plus