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 :
-
Docker installé sur le système hôte.
Remarque : Si vous utilisez Docker pour Windows, assurez-vous qu'il utilise des conteneurs de type Linux. IBM™ UrbanCode Velocity ne prend pas en charge les conteneurs de type Windows.
-
Connexion Internet. Lors de l'installation, les fichiers et les images de conteneur sont extraits des emplacements distants. Si vous n'êtes pas en mesure d'accéder à Internet au cours de l'installation, vous pouvez télécharger les fichiers au préalable et effectuer l'installation hors ligne. IBM UrbanCode Velocity est compatible avec les navigateurs suivants : Chrome, Firefox et Edge.
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. Veillez à télécharger le fichier adéquat en fonction de votre environnement d'installation.
En plus des exigences relatives à tous les scénarios d'installation, les éléments suivants sont requis :
- Instance client OpenShift configurée. Cette rubrique utilise Minishift pour les installations d'instances locales.
- Outil de ligne de commande OpenShift, installé sur le client.
- Accès au certificat au format PEM et à la clé privée que vous pouvez utiliser pour configurer des routes OpenShift.
- Nœud maître : 2 vCPU, 8 Go de RAM, 30 Go de stockage.
- Autres nœuds : 1 vCPU, 8 Go de RAM, 15 Go de stockage.
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.
-
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
.- Linux : https://hcl-velocity-binaries.s3.amazonaws.com/velocity-se-hcl-install-latest-linux
- Windows : https://hcl-velocity-binaries.s3.amazonaws.com/velocity-se-hcl-install-latest-win.exe
- Mac OS : https://hcl-velocity-binaries.s3.amazonaws.com/velocity-se-hcl-install-latest-macos
- Exécutez le fichier exécutable téléchargé.
-
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.
-
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.
-
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.
-
Installez le modèle de service UrbanCode Velocity dans le catalogue de projets en procédant comme suit :
-
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.
-
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.
-
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.
-
-
Créez un service MongoDB pour le projet en procédant comme suit :
-
Depuis le catalogue de projets OpenShift, sélectionnez MongoDB.
-
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.
-
Cliquez sur Créer.
-
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.
-
-
Créez un service UrbanCode Velocity en procédant comme suit.
-
Depuis le catalogue de projets, sélectionnez Velocity .
La fenêtre de configuration de Velocity s'affiche.
-
Cliquez sur Suivant, puis, dans le champ Nom, saisissez un nom de service.
-
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.
-
Dans le champ Clé d'accès, collez la clé d'accès IBM UrbanCode Velocity reçue précédemment.
-
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"] )
-
Acceptez les valeurs par défaut des autres paramètres, puis cliquez sur Créer.
-
-
Créez une route en procédant comme suit :
-
Depuis le tableau de bord du projet, cliquez sur Applications > Routes > Créer une route.
-
Dans le champ Nom, entrez un nom à donner à la route.
-
Dans le champ Nom d'hôte, saisissez le nom d'hôte que vous avez indiqué précédemment pour IBM UrbanCode Velocity.
-
Dans le champ Service, sélectionnez le service
velocity-router
. -
Cochez Route sécurisée.
-
Dans la liste Résiliation TLS, sélectionnez
Edge
. -
Téléchargez votre certificat au format PEM ou, sur la liste Trafic non sécurisé, sélectionnez
Allow
. -
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.