Identification et résolution des problèmes d'installation pour Amazon Web Services

L'échec de l'installation de Maximo® Application Suite peut avoir de nombreuses causes, telles que des paramètres d'installation manquants ou non valides, des échecs de création de noeud d'amorçage ou des problèmes de création de cluster.

Points d'échec

Lorsque vous démarrez une installation Maximo Application Suite sur Amazon Web Services, le modèle de pile CloudFormation que vous avez configuré est utilisé pour créer la pile. Au cours de ce processus, un noeud d'amorçage est créé. Le noeud d'amorçage termine le reste de l'installation de Maximo Application Suite .

Pour créer le cluster Red Hat® OpenShift® , le noeud d'amorçage démarre un processus d'amorçage. Ce processus crée un noeud d'amorçage qui utilise le programme d'installation Red Hat OpenShift pour créer des noeuds maître et worker.

Une installation Maximo Application Suite peut échouer aux points suivants:

Processus de création de pile. Si l'installation a échoué au cours de ce processus, les indicateurs suivants s'appliquent :
- La pile n'est pas créée.
- Le noeud d'amorçage n'est pas créé.
- Dans la page CloudFormation-> Piles, le statut de la pile est ROLLBACK_COMPLETE.
Le processus d'amorçage. Si l'installation a échoué au cours de ce processus, les indicateurs suivants s'appliquent :
- La pile est créée.
- Le noeud d'amorçage est créé.
- Dans la page CloudFormation-> Piles, le statut de la pile est CREATE_COMPLETE.
- Dans l'onglet Sortie, le paramètre DeploymentStatus affiche un message d'erreur d'installation indiquant la cause de l'échec, par exemple : ID-aws-small-NA:FAILURE#The provided ER key is not valid. It does not have access to download the MAS images

Causes courantes de l'échec

L'installation peut échouer pour l'une des raisons suivantes :

Des paramètres d'installation obligatoires sont manquants ou des paramètres facultatifs non valides sont spécifiés.
Une région AWS non prise en charge est sélectionnée.
Le programme d'installation du cluster Red Hat OpenShift arrive à expiration après avoir attendu la création de ressources d'infrastructure virtuelle.

Paramètres d'installation manquants ou non valides

Si vous ne saisissez pas tous les paramètres obligatoires, l'installation échoue. En outre, pour les groupes de paramètres facultatifs, tels que les paramètres de configuration de base de données Maximo Manage , vous devez entrer tous les paramètres du groupe ou les laisser vides.

Le tableau suivant indique les points de défaillance pour les paramètres obligatoires manquants et les paramètres facultatifs non valides.

Paramètre / Groupe	Obligatoire/facultative	Point de la panne	Plus d'informations
Clé SSHKey	Obligatoire	Processus de création de pile
BootnodeSGIngressCidrIp	Obligatoire	Processus de création de pile
EntitledRegistryKey	Obligatoire	Processus d'amorçage
OpenShiftPullSecret	Obligatoire	Processus d'amorçage
MASLicenseUrl	Obligatoire	Processus d'amorçage
PublicHostedZone	Facultatif	Processus d'amorçage	Si vous souhaitez créer un nouveau cluster Red Hat OpenShift , vous devez fournir ce paramètre.
Détails du cluster OCP existant	Facultatif	Processus d'amorçage	Si vous souhaitez réutiliser un cluster Red Hat OpenShift existant, vous devez fournir les paramètres suivants: OpenshiftClusterApiUrl OpenShiftUser OpenShiftPassword
Détails de la configuration de la base de données Maximo Manage	Facultatif	Processus d'amorçage	Si vous souhaitez que l'application Maximo Manage utilise une base de données préconfigurée, vous devez fournir les paramètres suivants:- MASLicenseUrl MASManageDBUser MASManageDBPassword MASManageDBJdbcUrl MASManageDBCertificateUrl
Détails SLS existants	Facultatif	Processus d'amorçage	Si vous souhaitez réutiliser une instance Suite License Service existante, vous devez fournir les paramètres suivants: SLSEndpointUrl SLSRegistrationKey SLSPublicCertificateUrl
Détails IBM User Data Services existants	Facultatif	Processus d'amorçage	Si vous souhaitez réutiliser une instance User Data Services existante, vous devez fournir les trois paramètres. Si un petit nombre seulement est fourni, le déploiement échouera.

Important: Maximo Application Suite est configuré avec un Suite License Service existant et consomme des licences configurées avec Suite License Service car l'octroi de licence est géré par Suite License Service.

Remarque: MASLicenseUrl s'applique uniquement au produit AWS BYOL.

Région AWS non prise en charge

Si vous avez choisi une région non prise en charge lorsque vous vous êtes abonné à Maximo Application Suite dans Amazon Web Services Marketplace, l'installation échoue dans le processus de création de pile. Un message d'erreur s'affiche dans le modèle CloudFormation , tel que le message suivant: Template error: Unable to get mapping for RegionMap::us-west-1::HVM64

Délai d'attente de l'installation

Si le processus d'installation de Maximo Application Suite prend trop de temps pour créer les ressources réseau que le programme d'installation du cluster Red Hat OpenShift attend, le programme d'installation du cluster risque d'arriver à expiration. Dans ce cas, l'installation de Maximo Application Suite échoue dans le processus d'amorçage et le message d'erreur suivant s'affiche dans la console de pile CloudFormation : Failure in creating OCP cluster.

Messages de panne

Si une installation échoue dans le processus d'amorçage, le message d'échec affiché dans la page CloudFormation-> Piles-> Sortie indique la cause de l'échec. D'autres détails sur les échecs et les causes sont disponibles dans le fichier journal d'installation, qui est mas-provisioning.log. Vous pouvez extraire ce fichier de l'une des manières suivantes :

Connectez-vous au noeud d'amorçage à l'aide de Secure Shell (SSH) et extrayez le fichier du répertoire /root/mas-on-aws .
Dans le service Amazon S3 , connectez-vous au compartiment <cluster-name>-bucket-<region> et extrayez le fichier du répertoire ocp-cluster-provisioning-deployment-context . Pour plus d'informations, voir Buckets overview dans la documentation AWS .

Pour plus d'informations sur les échecs d'installation, leurs causes possibles et les étapes suivantes recommandées, voir le tableau suivant :

Message d'échec	Cause de la panne	Etapes suivantes
Panne lors de la création du cluster OCP.	Les ressources AWS dont le cluster a besoin, telles que les sous-réseaux ou les passerelles NAT, ne sont pas créées.	Ce problème est intermittent. Désinstallez , puis réinstallez Maximo Application Suite.
	Un quota de ressources est atteint. Par exemple, on ne peut plus créer d'EIP ou de passerelles NAT parce que leurs quotas de ressources sont atteints.	-Supprimez la pile Maximo Application Suite . -Augmenter les quotas de service qui s'appliquent aux ressources ou nettoyer les ressources existantes. Pour plus d'informations, voir AWS service quotas dans la documentation AWS . -Dans votre compte AWS , vérifiez que des ressources similaires ne sont pas utilisées par une installation existante ayant échoué. - réinstallez Maximo Application Suite.
	L'utilisateur ne dispose pas des droits suffisants pour installer Maximo Application Suite.	-Supprimez la pile Maximo Application Suite . -Vérifiez que l'utilisateur IAM qui installe Maximo Application Suite dispose des droits appropriés. - réinstallez Maximo Application Suite.
Échec lors de la configuration du cluster OCP.	Le cluster Red Hat OpenShift n'est pas configuré en raison d'une erreur. Par exemple, la configuration du cluster échoue car le catalogue des opérateurs IBM est inaccessible.	- Connectez-vous à Bootnode à l'aide de Secure Shell (SSH) et extrayez le fichier `mas-provisioning.log` du répertoire `/root/mas-on-aws `. Ou à partir du compartimentS3.-Contactez le support IBM
Panne lors de la création de l'hôte Bastion.	L'hôte bastion n'est pas créé dans le cluster Red Hat OpenShift en raison d'une erreur. Par exemple, la création de l'hôte bastion échoue car votre compte AWS atteint ses limites de service.	- Connectez-vous à Bootnode à l'aide de Secure Shell (SSH) et extrayez le fichier `mas-provisioning.log` du répertoire `/root/mas-on-aws `. Ou à partir du compartimentS3.- Contactez le IBM Maximo Application Suite.
Échec de l'exécution du livre de lecture Ansible.	Une erreur se produit lorsque le noeud d'amorçage utilise l'automatisation Ansible pour déployer les prérequis Maximo Application Suite ou Maximo Application Suite lui-même dans le cluster Red Hat OpenShift .	- Connectez-vous à Bootnode à l'aide de Secure Shell (SSH) et extrayez le fichier `mas-provisioning.log` du répertoire `/root/mas-on-aws `. Ou à partir du compartimentS3. - Contactez le support IBM Maximo Application Suite
Cette région n'est pas prise en charge pour le déploiement MAS.	Dans la page de configuration Maximo Application Suite sur AWS, dans la zone Region, vous avez sélectionné une région non prise en charge.	-Supprimez la pile Maximo Application Suite . -Lorsque vous réinstallez Maximo Application Suite, dans la page de configuration, sélectionnez une région prise en charge. Pour obtenir la liste des régions prises en charge, voir la rubrique Préparation de l'installation de Maximo Application Suite sur Amazon Web Services .
La clé ER fournie n'est pas valide. Il n'a pas accès aux images MAS.	Les images Maximo Application Suite ne peuvent pas être téléchargées depuis IBM Entitled Registry en utilisant la clé fournie dans le paramètre d'installation `EntitledRegistryKey`.	-Supprimez la pile Maximo Application Suite . -Vérifiez que votre clé ER est autorisée à télécharger les images Maximo Application Suite à partir du registre. Vous pouvez exécuter une commande docker pour extraire l'image de l'opérateur de la version Maximo Application Suite que vous souhaitez installer pour effectuer les tests. Par exemple, si vous souhaitez installer Maximo Application Suite version 8.8.0, exécutez les commandes docker suivantes: `docker login cp.icr.io -u cp - p <er-key>` `docker pull icr.io/cpopen/ibm-mas:8.8.0` - Réinstallez Maximo Application Suite.
Veuillez fournir un code d'extraction OCP.	Lorsque vous utilisez l'option IPI ou UPI de Red Hat OpenShift, si le paramètre d'installation `OpenShiftPullSecret` n'est pas spécifié.	- Supprimez la pile de la Maximo Application Suite. - Lorsque vous réinstallez la Maximo Application Suite, indiquez le secret d'extraction dans le paramètre d'installation `OpenShiftPullSecret`.
Veuillez fournir une URL de licence MAS valide.	Dans le paramètre d'installation MASLicenseUrl, l'emplacement HTTP ou S3 du fichier de licence Maximo Application Suite n'est pas fourni.	- Supprimez la pile de la suite d Maximo Application Suite. - Lorsque vous réinstallez la Maximo Application Suite, indiquez l'emplacement HTTP ou S3 du fichier de licence de la Maximo Application Suite dans le paramètre d'installation MASLicenseUrl
Veuillez fournir toutes les entrées pour utiliser le SLS existant.	Des paramètres non valides sont fournis pour une instance SLS existante.	-Supprimez la pile Maximo Application Suite . -Lorsque vous réinstallez Maximo Application Suite, indiquez tous les paramètres du groupe ` Détails SLS existants ` ou laissez-les vides. Si vous laissez tous ces paramètres vides, une nouvelle instance SLS est créée dans le cluster.
Veuillez fournir toutes les entrées pour utiliser l'OCP existant.	Des paramètres non valides sont fournis pour un cluster Red Hat OpenShift existant.	-Supprimez la pile Maximo Application Suite . -Lorsque vous réinstallez Maximo Application Suite, indiquez tous les paramètres du groupe de détails du cluster OCP existant ou laissez tous les paramètres vides. Si vous laissez tous ces paramètres vides, un nouveau cluster Red Hat OpenShift est créé.
La zone hébergée fournie n'est pas une zone hébergée par le public. Veuillez fournir une zone hébergée par le public.	Lorsque vous utilisez l'option IPI de Red Hat OpenShift, dans le paramètre d'installation `PublicHostedZone`, une zone hébergée privée est sélectionnée.	- Supprimez la pile Maximo Application Suite. - Lorsque vous réinstallez la Maximo Application Suite, sélectionnez une zone hébergée publiquement dans le paramètre d'installation `PublicHostedZone`.
Les détails de JDBC pour Maximo Manage sont manquants ou non valides.	Les paramètres de configuration de la base de données Maximo Manage ne sont pas fournis ou les paramètres fournis ne sont pas valides.	-Supprimez la pile Maximo Application Suite . -Indiquez des paramètres JDBC valides pour la connexion à la base de données Maximo Manage . A l'aide d'un outil de connectivité à la base de données, tel que dbeaver, et de vos données d'identification de configuration de base de données Maximo Manage , vérifiez que vous pouvez vous connecter à la base de données. - réinstallez Maximo Application Suite.
Une erreur se produit lors de l'exécution du script de désinstallation (`cleanup-mas-deployment.sh`), lors de l'exécution à l'aide de la commande suivante: `./cleanup-mas-deployment -s <stack name> -r <region>` Le message d'erreur affiché est le suivant: `...line 79: ${SUPPORTED_REGIONS,,}: bad substitution.`	La version bash installée est affichée après la version requise.	Mettez à jour votre version bash et réessayez.
Une erreur se produit après l'arrêt du cluster dans les 24 heures suivant la création, puis le redémarrage après ce délai:`Unable to connect to the server: EOF` pendant `oc login`.	Le certificat de noeud est arrivé à expiration sur les noeuds maître.	Renouvelez le certificat de noeud maître. Pour plus d'informations, voir https://access.redhat.com/solutions/5953441.

Remarque : l' URL la licence MAS ne s'applique qu'au produit BYOL AWS.