Installation sur Linux

Exigences relatives au serveur

Avant de commencer, sachez que vous pouvez exécuter votre instance d’orchestrateur sur le serveur de votre choix, qu’il s’agisse d’un serveur sur site ou d’un fournisseur d’infrastructure en nuage public tel qu’Azure, AWS ou GCP.

• Système d’exploitation :
  • Linux : RHEL 7.7 ou supérieur, CentOS 7
• Disque dur : 10 Go (minimum)
• Mémoire : 8 Go (minimum)
• ports types requis : 22 (SSH/SCP), 3389 (Windows Remote Desktop), 443, 80
• Accès racine ou administrateur (pour l’installation et la configuration)
• L’orchestrateur d’identité Maverics s’exécute en tant qu’utilisateur maverics sous systemd (Linux).
• Sortie du réseau depuis l’hôte de l’orchestrateur vers le système d’accès en nuage de votre choix

Vérifiez le RPM

Obtenez le dernier paquet Maverics RPM. Installez le paquet sur le système dans lequel vous souhaitez installer Maverics.

Une règle de sécurité consiste à vérifier un RPM avant de l’installer.

Téléchargez la clé GPG publique de Strata :

curl --silent https://ops.strata.io/strata-pub-key.gpg --output strata-pub-key.gpg

Importez la clé dans RPM :

sudo rpm --import strata-pub-key.gpg

Vérifiez l’installation de la clé en exécutant :

rpm --query --install gpg-pubkey-ad3f5520-* --queryformat '%{name}-%{version}-%{release} --> %{summary}\n'

Vérifiez le RPM :

rpm --checksig -v maverics.rpm

Installez le RPM

Pour installer le paquet Maverics, exécutez la commande suivante en remplaçant le nom de fichier par maverics.rpm.

sudo rpm --upgrade --verbose --file maverics.rpm

Par défaut, le binaire Maverics est installé dans le répertoire /usr/local/bin . Le fichier de configuration maverics.yaml par défaut est créé dans le répertoire /etc/maverics.

Après l’installation de Maverics, il sera exécuter en tant que service sous systemd. Pour vérifier que le service Maverics est en cours d’exécution, exécutez la commande suivante.

sudo systemctl status maverics

Si votre orchestrateur est installé avec succès, un message similaire à celui-ci devrait s’afficher.

Redirecting to /bin/systemctl status maverics.service
● maverics.service - Maverics
   Loaded: loaded (/etc/systemd/system/maverics.service; enabled; vendor preset: disabled)
   Active: active (running) since Thu 2020-08-13 16:48:01 UTC; 24h ago
 Main PID: 330772 (maverics)
    Tasks: 5 (limit: 11389)
   Memory: 14.0M
   CGroup: /system.slice/maverics.service
           └─330772 /usr/local/bin/maverics --config /etc/maverics/maverics.yaml

Si le service Maverics ne démarre pas, exécutez la commande suivante pour identifier le problème :

journalctl --identifier=maverics --reverse

L’entrée de journal la plus récente apparaîtra au début de la sortie.

Configuration du service

Fichier de configuration local

Créez un fichier maverics.yaml dans le répertoire /etc/maverics et ajoutez-y la configuration d’orchestrateur souhaitée.

Pour utiliser un fichier de configuration se trouvant dans un emplacement différent ou portant un nom différent, utilisez la variable d’environnement MAVERICS_CONFIG pour remplacer l’emplacement par défaut. Indiquez le chemin d’accès complet à votre fichier de configuration (par exemple, MAVERICS_CONFIG=/opt/orchestrator/custom.yaml).

Fichier de configuration à distance

Consultez la section Configuration à distance et rechargement automatique pour découvrir comment configurer l’orchestrateur pour le stockage partagé à distance.

Démarrage du service

Le service maverics est géré par Systemd à l’aide de la configuration définie dans /etc/systemd/system/maverics.service. Ce dernier extrait les variables d’environnement du fichier /etc/maverics/maverics.env.

Reportez-vous à la section Variables d’environnement de l’orchestrateur pour consulter les variables d’environnement pouvant être définies dans ce fichier.

Installation dans un emplacement différent

Le programme d’installation RPM prend en charge l’option --relocate pour installer le binaire et la configuration de maverics dans un emplacement personnalisé. Par exemple, procédez comme suit pour installer le binaire dans opt et la configuration dans /home/maverics :

sudo rpm --upgrade --verbose --file --relocate /usr/local/bin=/opt --relocate /etc/maverics=/home/maverics maverics.rpm

L’installation avec l’option --relocate permet de créer des fichiers de service systemd qui référencent correctement les emplacements personnalisés.

Installation avec un utilisateur/groupe personnalisé

Si vous devez exécuter l’orchestrateur sous un utilisateur ou un groupe spécifique, définissez les variables d’environnement MAVERICS_USER et MAVERICS_GROUP avant l’installation. Par exemple :

export MAVERICS_USER=maverics-service-acct
export MAVERICS_GROUP=id_services
sudo --preserve-env rpm --upgrade --verbose --file maverics.rpm

L’utilisateur et le groupe doivent être existants avant le début de l’installation, et les variables devront être réglées sur les mêmes valeurs lors de la mise à niveau. Si les variables ne sont pas définies, un utilisateur et un groupe maverics par défaut sont créés et utilisés.

Si vous constatez des erreurs liées à l’utilisateur ou au groupe pendant ou après l’installation, ou si un service ne démarre pas en affichant un message d’erreur tel que Failed to start maverics.service: Unit maverics.service has a bad unit file setting., désinstallez avec la commande sudo rpm --erase --noscripts maverics puis réinstallez en utilisant des noms d’utilisateurs et de groupes valides.

Mise à jour

Si vous devez mettre à jour votre instance d’orchestrateur pour utiliser la dernière version du logiciel, procédez comme suit :

Obtenez le dernier paquet Maverics RPM. Installez le paquet sur le système dans lequel Maverics sera mis à jour.

Pour mettre le paquet Maverics à jour, exécutez la commande suivante en remplaçant le nom de fichier par maverics.rpm.

sudo rpm --upgrade --verbose --file maverics.rpm

sudo mv /etc/systemd/system/maverics.service.rpmnew /etc/systemd/system/maverics.service
sudo systemctl daemon-reload
sudo systemctl restart maverics

Pour vérifier que le service Maverics est en cours d’exécution, exécutez la commande suivante.

sudo systemctl status maverics

Désinstallation

Si vous souhaitez désinstaller votre instance d’orchestrateur de votre machine, procédez comme suit :

Pour désinstaller le paquet Maverics, exécutez la commande suivante.

sudo rpm --erase maverics

Pour vérifier que le service n’existe plus, exécutez la commande suivante.

sudo systemctl status maverics

Si votre orchestrateur a été désinstallé avec succès, un message similaire à celui-ci devrait s’afficher.

Unit maverics.service could not be found.