Mise à niveau des installations 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 :

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 UrbanCode Velocity afin d'obtenir votre clé. Après avoir rempli le formulaire, vous pouvez copier la clé d'accès. Stockez la clé à un emplacement facilement accessible, car vous allez l'utiliser lors de l'installation.

Remarque : Veillez à sélectionner une clé adaptée à la version du produit que vous souhaitez installer. Les clés pour la Standard Edition ne fonctionnent pas avec la Community Edition, et vice versa.

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

  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.

  3. Lorsque l'invite Entrez l'emplacement où les fichiers Velocity vont être installés s'affiche, indiquez où il convient de placer les fichiers d'installation.

  4. Depuis le tableau de bord OpenShift, créez un projet pour UrbanCode Velocity.

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

  5. Installez le modèle de service UrbanCode Velocity dans le catalogue de projets en procédant comme suit :

    1. Si cela n'a pas encore été fait, procédez à l'extraction du fichier yaml depuis l'archive, velocity-se-<version number>-openshift.tar.gz, que vous avez installée précédemment.

      Le nom du yaml est velocity-se-<version number>-openshift.yaml.

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

      Le service est ajouté au catalogue.

    3. 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 UrbanCode Velocity s'affiche dans le catalogue de projets OpenShift.

  6. 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 UrbanCode Velocity.

  7. Créez un service UrbanCode Velocity 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.

    4. Dans le champ Clé d'accès, collez la clé d'accès IBM UrbanCode Velocity 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 :

      mongo://admin:password@mongodb

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

      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.

  8. 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 IBM UrbanCode Velocity.

    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 IBM UrbanCode Velocity 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.