Installation de IBM UrbanCode Velocity à l'aide de Docker Compose#
Installez IBM™ UrbanCode Velocity dans un orchestrateur de conteneurs Docker Compose
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 pour des systèmes Docker Compose :
- Docker Compose version 17.09.0-ce, génération afdb6d4 et ultérieure
- UC avec plus de 4 cœurs.
- 8 Go de RAM
- 8 Go de stockage
- Si vous optez pour l'installation hors ligne, vous avez besoin d'un espace libre de 4 Go dans votre répertoire
/tmp
ou\temp
. - Si vous installez le produit sur Red Hat Enterprise Linux®, vous avez besoin de RHEL 7 ou version ultérieure.
Remarque : Sous Linux, le démon Docker s'exécute en tant qu'utilisateur root
. Si vous ne souhaitez pas utiliser sudo
avec la commande docker
, créez un groupe Linux intitulé docker
. Assurez-vous que l'utilisateur qui installe le produit fait partie de ce groupe. Reportez-vous à la documentation de Docker pour de plus amples informations à propos de la gestion de Docker en tant qu'utilisateur non superutilisateur.
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.
Les instructions d'installation décrivent l'installation du produit sur tous les systèmes d'exploitation pris en charge. Le fichier exécutable téléchargé vous permet de suivre le processus d'installation et de définir vos paramètres d'installation.
-
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é.
-
Terminez l'installation 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 :
./<velocity-installation-file\> **--license=accept**
-
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 Choisissez la plateforme s'affiche, sélectionnez
Docker Compose
. -
Lorsque l'invite Entrez l'emplacement où les fichiers Velocity vont être installés s'affiche, entrez l'emplacement où vous souhaitez installer les fichiers du produit.
Les fichiers sont copiés vers le répertoire spécifié dans un sous-répertoire intitulé
product_version_number
. -
Lorsque l'invite Veuillez saisir le nom d'hôte où vous allez exécuter Velocity s'affiche, saisissez le nom d'hôte où les utilisateurs peuvent accéder à l'interface Web.
La valeur par défaut est
localhost
.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.
-
Lorsque l'invite Entrez le port sur lequel vous souhaitez que Velocity s'exécute s'affiche, saisissez le numéro de port de l'interface Web.
La valeur par défaut est
443
. -
Si vous effectuez une installation hors ligne, lorsque l'invite Sélectionnez le mode de réception des images de Docker hors ligne pour Velocity s'affiche, sélectionnez l'une des options suivantes.
- Système de fichiers local. Copiez des images vers le système de fichiers et chargez-les manuellement dans le registre Docker local.
- Registre Docker local. Chargez des images dans le registre Docker local. Cela nécessite le client Docker sur l'hôte pour lequel le script d'installation est en cours d'exécution.
- Registre Docker distant. Chargez des images dans le registre Docker local, puis balisez les images et transférez-les vers un registre Docker distant. Cela nécessite le client Docker sur l'hôte pour lequel le script d'installation est en cours d'exécution. Les images sont chargées dans l'hôte local.
-
-
Terminez l'installation en modifiant le répertoire dans lequel vous avez installé le produit, puis démarrez Docker Compose. Par exemple :
~/projects/velocity-se/ docker-compose up -d
Les images IBM UrbanCode Velocity sont extraites de Docker Hub et configurées pour Docker Compose.
Accédez à l'interface Web IBM UrbanCode Velocity. L'URL est https://hostname:port, où hostname
et port
sont les valeurs que vous avez définies lors de l'installation. Le nom d'utilisateur initial est admin et le mot de passe par défaut est admin.
Les propriétés d'installation sont stockées dans le fichier [installation_folder]/docker-compose/.env. Vous pouvez éditer les propriétés qui conviennent à votre environnement. Le fichier env contient une description pour toutes les propriétés d'installation, y compris les suivantes :
-
Access_Key
Clé d'accès au produit obtenue précédemment.
-
NGINX_HOST
Domaine de l'URL que les utilisateurs utiliseront pour accéder à Velocity. La valeur correspond généralement au nom d'hôte de la machine virtuelle sur laquelle s'exécute Docker Compose.
Pour terminer l'installation, remplacez le certificat public SSL et la clé privée fournis par vos propres copies. Vous pouvez utiliser OpenSSL pour générer votre propre clé à l'aide d'une commande similaire à l'exemple suivant :
openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certifcate.pem
Placez votre certificat et votre clé autogénérés dans le dossier [velocity-install-folder/product_version_number/conf/ssl.
Après avoir acheté le produit, vous recevez une clé d'accès permanente et une clé de licence.
Sujet parent : Installation