Installation en tant qu'application OpenShift#

L'ID que vous utilisez pour installer le produit doit être capable d'apporter des modifications à l'environnement hôte. Les outils requis par tous les scénarios d'installation comprennent les éléments suivants :

Remarque : Les fichiers d'installation utilisés pour l'installation en ligne sont différents de ceux utilisés pour l'installation connectée à Internet. Assurez-vous de télécharger le fichier adéquat pour votre environnement d'installation.

En plus des exigences relatives à tous les scénarios d'installation, les éléments suivants sont requis :

Obtenez une clé. La clé vous permet de terminer l'installation. Rendez-vous sur le portail Web HCL Accelerate afin d'obtenir votre clé. Une fois le formulaire complété, vous recevrez un e-mail de confirmation avec une clé d'accès. Stockez la clé à un emplacement facilement accessible, car vous allez l'utiliser lors de l'installation.

Vous allez installer HCL Accelerate dans un projet OpenShift. Lors de l'installation, vous configurez une base de données MongoDB pour votre projet, ajoutez le service HCL Accelerate à votre catalogue de projets OpenShift, puis créez une route qui rend l'application HCL Accelerate accessible au public.

Si vous devez modifier les paramètres du projet, modifiez le fichier velocity-se-<version number>-openshift.yaml. HCL Accelerate utilise ce fichier pour configurer le projet OpenShift. Le fichier velocity-se-<version number>-openshift.yaml est copié dans votre environnement local lors de l'installation.

  1. Téléchargez le fichier d'installation correspondant à votre environnement.

    Remarque : Pour les installations macOS et Linux, définissez les droits appropriés avant d'exécuter le fichier : sudo chmod +x.

    Accédez au centre de téléchargement FlexNet et sélectionnez le fichier correspondant à votre environnement. Vous pouvez également télécharger directement le fichier d'installation depuis les URL suivantes :

  2. Lorsque l'invite Veuillez saisir votre clé d'accès Velocity s'affiche, entrez votre clé d'accès la version de SE.

    Si vous avez déjà installé une version de SE, la clé déjà configurée est la valeur par défaut.

    Remarque : Assurez-vous d'avoir entré la clé correspondant à la version adéquate.

    1. Pour appliquer des limites aux ressources, définissez les valeurs des indicateurs de ressource pour tous les conteneurs et utilisez l'indicateur customConfigFile pour définir le chemin du fichier JSON qui contient les valeurs spécifiées pour les services individuels.

      Voici un exemple de commande d'installation utilisant les nouveaux indicateurs :

      /velocity-ibm-install-1-5-5-macos --resourcesRequestsCpu 60m --customConfigFile resources.json

      Vous pouvez utiliser les indicateurs suivants dans la commande :

      • resourceLimitsMemory
      • resourceLimitscpu
      • resourceRequestMemory
      • resourceRequestcpu
      • customConfigFile Remarque : Voici un exemple de code resources.json.

      { "resources": { "limits": { "memory": { "default": "1Gi", "application-api": "3Gi" }, "cpu": { "application-api": "2" }, }, "requests": { "memory": { "release-events-ui": "256Mi" }, "cpu": { "multi-app-pipeline-api": "45m", "release-events-ui": "55m" } } } }

  3. Terminez l'installation locale en répondant aux invites décrites dans la procédure suivante.

    Lorsque le script démarre, vous êtes invité à accepter la licence. Vous pouvez explicitement accepter la licence sans l'afficher, en joignant le paramètre suivante à la commande :

    ./<accelerate-installation-file\> **--license=accept**

    1. Lorsque l'invite Entrez votre clé de chiffrement ou laissez vide pour utiliser la valeur par défaut. La clé doit comprendre au moins 8 caractères s'affiche, entrez votre clé de chiffrement ou laissez vide pour utiliser la clé de chiffrement par défaut.

      Remarque : La clé de chiffrement doit comprendre au moins 8 caractères. Enregistrez la clé de chiffrement afin de l'utiliser pour d'autres mises à niveau.

    2. Lorsque l'invite Choisissez la plateforme s'affiche, sélectionnez OpenShift.

    3. Lorsque l'invite Veuillez saisir votre clé d'accès HCL Accelerate s'affiche, indiquez où placer les fichiers d'installation.

    4. Lorsque l'invite Nom de projet Openshift s'affiche, saisissez le nom du projet créé précédemment.

    5. Lorsque l'invite Nom de l'utilisateur de l'installation s'affiche, saisissez votre ID OpenShift.

    6. Lorsque l'invite Choisissez-en un s'affiche, sélectionnez Installer une nouvelle instance.

      Si vous effectuez une mise à niveau, voir Mise à niveau des installations OpenShift.

    Les fichiers que vous utilisez pour terminer l'installation sont copiés vers le répertoire spécifié.

  4. Dans le répertoire dans lequel vous avez installé les fichiers de produit, exécutez oc apply -f pre-install-for-cluster.yaml, puis oc apply -f pre-install-for-namespace.yaml.

    Remarque : L'utilisateur doit être autorisé à créer des ressources au niveau du cluster pour pouvoir exécuter oc apply -f pre-install-for-cluster.yaml. L'utilisateur doit être autorisé à créer des ressources au niveau de l'espace de nom pour exécuter oc apply -f pre-install-for-namespace.yaml.

    La propriété user dans le fichier pre-install-for-cluster.yaml et pre-install-for-namespace.yaml est 'admin' par défaut. Assurez-vous que la propriété user contient l'identifiant utilisateur OpenShift correct.

  5. Depuis le tableau de bord OpenShift, créez un projet pour HCL Accelerate.

    Lorsque le projet est créé, dans la zone Mes projets, sélectionnez le projet, puis cliquez sur Parcourir le catalogue.

  6. Installez le modèle de service HCL Accelerate dans le catalogue de projets en procédant comme suit :

    1. Depuis le catalogue de projets OpenShift, utilisez la commande Ajouter au projet > Importer YAML/JSON, puis importez le fichier velocity-se-<version number>-openshift.yaml.

      Le fichier yaml a été installé à l'étape précédente.

    2. Sélectionnez Créer, désélectionnez la case Traiter le modèle, puis cochez Sauvegarder le modèle.

      Après avoir actualisé le navigateur, le service HCL Accelerate s'affiche dans le catalogue de projets OpenShift.

  7. Créez un service MongoDB pour le projet en procédant comme suit :

    1. Depuis le catalogue de projets OpenShift, sélectionnez MongoDB.

    2. Sur la page de configuration de MongoDB, cliquez sur Suivant, puis, dans le champ Mot de passe Admin MongoDB, saisissez un mot de passe pour l'utilisateur Admin.

      Vous pouvez accepter les valeurs par défaut pour les autres paramètres.

      Remarque : L'utilisateur doit être un utilisateur Admin et non l'utilisateur de MongoDB.

    3. Cliquez sur Créer.

    4. Sur la page La base de données MongoDB a été créée, copiez la chaîne Connection URL et stockez-la à un emplacement facile d'accès, puis fermez la fenêtre de configuration.

      Vous utilisez la chaîne de connexion pour configurer votre projet HCL Accelerate.

  8. Créez un service HCL Accelerate en procédant comme suit.

    1. Depuis le catalogue de projets, sélectionnez Velocity Catalogue OpenShift.

      La fenêtre de configuration de Velocity s'affiche.

    2. Cliquez sur Suivant, puis, dans le champ Nom, saisissez un nom de service.

    3. Dans le champ Nom d'hôte, entrez le nom de l'hôte du service.

      Le nom d'hôte doit se rapporter à un nom sur votre serveur DNS ou dans le fichier hosts du serveur. Sous Linux, l'emplacement du fichier est etc/hosts, et C:\Windows\System32\drivers\etc\hosts sous Windows.

      Remarque : Le nom d'hôte ne peut pas être une adresse IP.

    4. Dans le champ Clé d'accès, collez la clé d'accès HCL Accelerate reçue précédemment.

    5. Dans le champ URL Mongo, collez la chaîne de connexion MongoDB correspondant au service MongoDB.

      N'utilisez pas le nom d'utilisateur ou de base de données par défaut. Utilisez l'utilisateur Admin et le mot de passe créés pour l'administrateur. Par exemple :

      mongodb://admin:password@mongodb

      Remarque : Lorsque vous copiez l'exemple de code de connexion, veillez à supprimer la partie sampleDB du code copié.

      Si vous vous connectez à une base de données MongoDB authentifiée, vous pouvez utiliser authSource pour spécifier la base de données dans laquelle les utilisateurs authentifiés sont définis. Par exemple, si l'utilisateur admin est défini dans la base de données admin, vous pouvez utiliser mongodb://root:password@velocity-mongo-mongodb?authSource=admin. Si vous ne souhaitez pas utiliser l'utilisateur Admin, connectez-vous à la base de données MongoDB et utilisez une commande similaire à celle-ci pour accorder des droits Admin à l'utilisateur :

      db.grantRolesToUser( "mongo", ["readWriteAnyDatabase", "dbAdminAnyDatabase", "clusterAdmin"] )

    6. Acceptez les valeurs par défaut des autres paramètres, puis cliquez sur Créer.

  9. Créez une route en procédant comme suit :

    1. Depuis le tableau de bord du projet, cliquez sur Applications > Routes > Créer une route.

    2. Dans le champ Nom, entrez un nom à donner à la route.

    3. Dans le champ Nom d'hôte, saisissez le nom d'hôte que vous avez indiqué précédemment pour HCL Accelerate.

    4. Dans le champ Service, sélectionnez le service velocity-router.

    5. Cochez Route sécurisée.

    6. Dans la liste Résiliation TLS, sélectionnez Edge.

    7. Téléchargez votre certificat au format PEM ou, sur la liste Trafic non sécurisé, sélectionnez Allow.

    8. Cliquez sur Créer.

    La nouvelle route est répertoriée sur la page Routes.

Lorsque l'installation est terminée, ouvrez HCL Accelerate en cliquant sur le lien du nom de la route. Le nom d'utilisateur par défaut est admin et le mot de passe par défaut est admin.

Sujet parent : Installation