Machines
Toutes les Machines hébergeant des Environnements de Construction et/ou de Déploiement utilisés par les Projets IKAN ALM, doivent être déclarées au sein d’IKAN ALM par l’Administrateur global. Les autres Utilisateurs d’IKAN ALM peuvent vérifier si toutes les Machines utilisées pour un nouveau projet sont disponibles. Si cela n’est pas le cas, ils doivent demander à l’Administrateur global d’ajouter les définitions de la Machine. Les Constructions et les Déploiements peuvent seulement être exécutés sur une Machine sur laquelle fonctionne un Agent IKAN ALM correctement installé.
Se référer aux sections suivantes pour des informations plus détaillées:
-
Créer une définition de machine. Cette option n’est disponible que pour les Utilisateurs ayant des droits d’accès d’Administrateur global.
Créer une définition de machine
|
Cette option n’est disponible que si vous disposez de droits d’accès d’Administrateur global dans IKAN ALM. |
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Créer.
L’écran suivant s’affiche:
-
Complétez les champs dans le panneau Créer une Machine.
Les champs marqués d’un astérisque rouge doivent être obligatoirement remplis.
Champ Description Nom
Saisissez dans ce champ la dénomination de la nouvelle Machine. Ce champ est obligatoire.
Description
Saisissez dans ce champ la description de la nouvelle Machine.
Verrouillée
Indiquez si la Machine doit être verrouillée ou non pour un usage ultérieur.
Système d’exploitation
Sélectionnez, à partir du menu déroulant, le Système d’exploitation. Cette sélection est obligatoire.
DHCP activé
Indiquez si la Machine se connecte via un DHCP activé ou non.
Nom DHCP
Saisissez le nom DHCP de la Machine. Ce champ est obligatoire si la valeur du champ DHCP activé est Oui. Le Serveur IKAN ALM essaiera d’établir une connexion avec ce nom DHCP (en utilisant XML-RPC).
Adresse IP
Saisissez l’adresse IP de la Machine. Ce champ est obligatoire si la valeur du champ DHCP activé est Non. Le Serveur IKAN ALM essaiera d’établir une connexion avec cette adresse IP (en utilisant XML-RPC)
Port de l’Agent
Saisissez dans ce champ le numéro de port (entre 0 et 65536) de l’Agent IKAN ALM installé sur cette Machine qui sera utilisé pour la communication avec le Serveur IKAN ALM (en utilisant XML-RPC).
Si vous laissez ce champ vide, la valeur par défaut 20020 sera utilisée.
Si vous définissez une valeur différente de la valeur par défaut, assurez-vous de définir la même valeur que lors de l’installation de l’Agent sur cette Machine.
Port du Serveur
Saisissez dans ce champ le numéro de port (entre 0 et 65536) utilisé par le serveur IKAN ALM pour établir la communication avec les Agents IKAN ALM (utilisant XML-RPC). Ce numéro de port est défini lors d’installation initiale du Serveur IKAN ALM.
Si le Serveur IKAN ALM utilise la valeur par défaut 20021, vous pouvez laisser ce champ vide.
Protocole de transfert
Sélectionnez, à partir du menu déroulant, le protocole de transfert requis. Ce menu contient les dénominations de tous les Transporteurs définis dans IKAN ALM (FTP, FileCopy et SSH).
Ce protocole définit comment les Sources et les résultats de constructions seront transférés entre les emplacements sur le Serveur IKAN ALM (Archives des Constructions, Copie de travail, Emplacement du script de déploiement) et cette Machine.
La sélection du protocole de transfert est obligatoire.
Pour plus d’informations concernant la configuration de Transporteurs, se référer à la section Transporteurs.
Verrouillée
Sélectionnez si la Machine doit être verrouillée pour une utilisation ultérieure.
Limite Déploiements concurrents
Saisissez le nombre maximal de Déploiements pouvant être exécutés en même temps.
-
Si le nombre est établi à 0 (la valeur par défaut), il n’y aura pas de limite pour le nombre de Déploiements exécutés simultanément.
-
Si le nombre est établi à
1, tous les Déploiements seront exécutés de manière séquentielle. -
Si un nombre spécifique est saisi, seul ce nombre de Déploiements pourra être exécuté simultanément sur l’Agent connecté à la Machine. Si un Déploiement supplémentaire est demandé, celui-ci sera ajouté à la liste d’attente et il sera démarré dès qu’un des Déploiements en cours sera terminé (suivant le principe "premier entré, premier sorti' (FIFO) sur la base des OIDs des Déploiements).
-
-
Après avoir complété les champs, cliquez sur le bouton Créer.
La nouvelle définition de machine sera ajoutée à l’Aperçu des Machines dans la partie inférieure de l’écran.
Il est possible, que votre licence IKAN ALM contienne un nombre limité de Machines à ajouter. Si cette limite est dépassée, la nouvelle définition de machine ne sera pas ajoutée, et le message d’erreur suivant sera affiché:
Si vous devez commander une licence permettant la définition de plus de Machines, contactez votre fournisseur IKAN ALM.
Sujets apparentés:
Aperçu des Machines
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu.
L’écran suivant s’affiche:
-
Définissez les critères de recherche requis dans le panneau de recherche.
La liste des éléments dans l’aperçu est synchronisée automatiquement en fonction des critères sélectionnés.
Vous pouvez également:
-
cliquer sur le lien Montrer/Cacher les options avancées pour afficher ou masquer tous les critères de recherche disponibles,
-
cliquer sur le lien Rechercher pour synchroniser la liste en fonction des critères de recherche actuels,
-
cliquer sur le lien Réinitialiser la recherche pour nettoyer les champs.
-
-
Vérifiez les informations dans l’Aperçu des Machines.
Pour une description détaillée des champs, se référer à la section Créer une définition de machine.
-
En fonction de vos droits d’accès, les liens suivants peuvent être disponibles:

Modifier
Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de modifier la définition d’une Machine. Modifier la définition d’une machine

Voir les Paramètres
Cette option est disponible pour tous les Utilisateurs IKAN ALM. Elle permet d’afficher et de modifier les Paramètres d’une Machine.

Supprimer
Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de supprimer la définition d’une Machine.

Statut
Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de vérifier le statut d’une Machine.

Phases installées
Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet d’afficher et de désinstaller les Phases actuellement installées sur la Machine.

Historique
Cette option est disponible pour tous les Utilisateurs IKAN ALM. Elle permet d’afficher l’historique d’une Machine.
Les colonnes marquées de l’icône
peuvent être rangées par ordre alphabétique (ascendant ou descendant).
Modifier la définition d’une machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu.
-
Cliquez sur le lien
Modifier sur le panneau Aperçu des Machines.L’écran suivant s’affiche:
-
Si nécessaire, modifier les champs dans le panneau Modifier une Machine.
Pour une description détaillée des champs, se référer à la section Créer une définition de machine.
Le panneau Environnements connectés affiche les Environnements qui utilisent la Machine sélectionnée.
-
Cliquez sur le bouton Enregistrer pour sauvegarder vos modifications.
Les boutons suivants sont également disponibles:
-
Actualiser pour récupérer les Paramètres tels qu’ils sont enregistrés dans la base de données.
-
Précédent pour retourner à l’écran précédent sans enregistrer les modifications.
-
Afficher les Paramètres d’une Machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu.
-
Pour y accéder, cliquez sur le lien
Voir les Paramètres dans le panneau Aperçu des Machines.L’écran suivant s’affiche:
Vous pouvez également accéder à l’Aperçu des Paramètres de machine via le Menu Principal en sélectionnant
_ (Administration
globale) > Machines > Aperçu des Paramètres de machine._ -
L’écran Aperçu des Paramètres de machine permet de créer, de modifier, de supprimer et de copier des Paramètres de machine et d’en vérifier l’Historique.
Pour plus d’informations, se référer aux sections suivantes:
Supprimer une définition de machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu.
-
Cliquez sur le lien Supprimer sur le panneau Aperçu des Machines.
L’écran suivant s’affiche:
-
Cliquez sur le bouton Supprimer pour confirmer la suppression de la Machine.
Vous pouvez également cliquer sur le bouton Précédent pour retourner à l’écran précédent sans supprimer la Machine.
Note: Si vous tentez de supprimer une Machine associée à un Environnement de Construction ou de Déploiement, le message suivant s’affiche:
Vous devez d’abord lier les Environnements à une autre Machine, ou supprimer les Environnements d’IKAN ALM, avant de pouvoir supprimer la définition de la Machine.
Vérifier le statut d’une machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu.
-
Cliquez sur le lien
Statut sur le panneau Aperçu des Machines.L’écran suivant s’affiche:
L’écran Statut détaillé de la Machine affiche le statut de l’Agent fonctionnant sur la Machine.
En haut de l’écran, le panneau Informations de la Machine est affiché. Pour une description détaillée des champs, se référer à la section Créer une définition de machine.
-
Vérifiez le statut de la Machine.
Les statuts suivants sont possibles:
Statut Description
En attenteLa connexion avec l’Agent/le Serveur s’est établie correctement. Actuellement, l’Agent/le Serveur n’est pas en train d’exécuter ni de Requête de niveau, ni de Construction ni de Déploiement.
Constructions en coursLa connexion avec l’Agent s’est établie correctement. L’Agent est en train d’exécuter des Constructions.
Déploiements en coursLa connexion avec l’Agent s’est établie correctement. L’Agent est en train d’exécuter des Déploiements.
Constructions et Déploiements en coursLa connexion avec l’Agent s’est établie correctement. L’Agent est en train d’exécuter des Constructions et des Déploiements.
Requêtes de niveau en coursLa connexion avec le Serveur s’est établie correctement. Actuellement, le Serveur est en train d’exécuter des Requêtes de niveau.
Arrêt en coursLa connexion avec l’Agent/le Serveur s’est établie correctement. L’Agent/le Serveur est en train de s’arrêter.
Impossible de se connecter à l’AgentLa connexion avec l’Agent n’a pas pu s’établir, soit parce qu’actuellement l’Agent ne fonctionne pas sur la Machine, soit à cause de problèmes de réseau empêchant l’Agent de se connecter. Contactez votre Administrateur IKAN ALM.
Impossible de se connecter au ServeurLa connexion avec le Serveur n’a pas pu s’établir, soit parce qu’actuellement le Serveur ne fonctionne pas sur la Machine, soit à cause de problèmes de réseau empêchant le Serveur de se connecter. Contactez votre Administrateur IKAN ALM.
-
Vérifiez la Trace de la Machine.
Le panneau Trace de la Machine affiche les dernières 150 lignes de sortie du processus de l’Agent fonctionnant sur cette Machine.
-
Cliquez sur le bouton Précédent pour retourner à l’écran précédent.
Écran de l’Aperçu des Phases installées
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu.
-
Cliquez sur le lien
Phases installées sur le panneau Aperçu des Machines.L’écran suivant s’affiche.
L’écran Aperçu des Phases installées affiche le statut du Serveur et/ou de l’Agent fonctionnant la Machine. Il affiche également les Phases installées sur le Serveur et l’Agent, et permet de rechercher, trier et désinstaller ces Phases.
En haut de l’écran, le panneau Informations de la Machine est affiché. Pour une description détaillée des champs, se référer à la section Créer une définition de machine.
L’activité et les Phases installées sur le Serveur ne seront affichées que si la Machine a été spécifiée comme la machine "Serveur IKAN ALM" dans les Paramètres système. Paramètres du système
-
Vérifiez l'Activité actuelle du Serveur et/ou de l’Agent sur la Machine.
Pour plus d’informations concernant les statuts possibles, voir la section Vérifier le statut d’une machine.
-
Indiquez si vous voulez afficher les Phases de noyau ou non.
Les options possibles sont:
-
Oui: afficher uniquement les Phases de noyau
-
Non: afficher uniquement les Phases qui ne sont pas des Phases de noyau
-
Tout: afficher toutes les Phases
-
-
Vérifiez les informations sur les panneaux Phases Serveur installées et Phases Agent installées.
-
Le panneau Phases Serveur installées affiche toutes les Phases installées sur le Serveur de la Machine. Ce panneau n’est affiché que si la Machine a été défini comme la machine "Serveur IKAN ALM" dans les Paramètres système. Paramètres du système
-
Le panneau Phases Agent installées affiche toutes les Phases installées sur l’Agent de la Machine.
Pour chacune des Phases installées, les informations suivantes sont disponibles:
Information Description Nom
Le nom de la Phase.
Version
La version de la Phase.
Phase de noyau
Phase de noyau ou pas?
-
-
Désinstaller une Phase sur le Serveur ou l’Agent.
Pour désinstaller une Phase, cliquez sur le lien
Supprimer à droite de la Phase ou sélectionnez le lien Tout désinstaller pour désinstaller TOUTES les Phases qui ne sont pas des Phases de noyau sur le Serveur ou l’Agent.Note: Si une Phase est désinstallée, elle est supprimée sur le Serveur ou l’Agent. Cela ne signifie pas que la Phase est supprimée du Catalogue des Phases ou des Environnements connectés dans le Projet. Si une Phase d’une Requête de niveau est exécutée sur un Agent ou un Serveur mais que cette Phase n’est pas installée sur cet Agent ou ce Serveur, IKAN ALM essaiera automatiquement d’installer la Phase sur l’Agent ou le Serveur avant de l’exécuter.
-
Cliquez sur le bouton Précédent pour retourner à l’écran Aperçu des Machines.
Afficher l’historique d’une machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu.
-
Cliquez sur le lien
Historique pour afficher l’écran Aperçu de l’Historique de la Machine.Pour une description détaillée de l’Aperçu de l’Historique, se référer à la section Enregistrement de l’historique et des événements.
-
Cliquez sur le bouton Précédent pour retourner à l’écran précédent.
Gérer les Paramètres d’une Machine
A l’opposé des Paramètres de construction et de déploiement, les Paramètres de machine sont rattachés à une Machine plutôt qu’à un Environnement spécifique. Les paramètres rattachés à une Machine spécifique seront automatiquement disponibles pour tous les Environnements qui utilisent cette Machine. Cela évite de devoir (re)définir les Paramètres de construction ou de déploiement pour chaque environnement lié à cette Machine.
|
Dans le cas où un Paramètre d’environnement et un Paramètre de machine auront le même nom, le Paramètre d’environnement sera prioritaire. |
En fonction de l’Outil de script lié à l’environnement, les paramètres définis seront:
-
dans le cas de NAnt et de Maven2, ajoutés à la commande qui exécutera le Script
-
enregistrés dans un fichier spécifique nommé alm_ant.properties (dans le cas de Ant) ou gradle.properties (dans le cas de Gradle), qui sera automatiquement chargé avec l’option
–propertyfile ANT. Ce fichier de propriétés est généré au moment même dans l’Emplacement Source de l’Environnement dans le répertoire contenant le script (ceci peut être un sous-répertoire de l’Emplacement Source si l’Emplacement du script a été spécifié comme un chemin relatif). Une fois le processus de Construction/Déploiement terminé, ce fichier sera automatiquement supprimé sauf si l’option "Débogage" a été activée pour l’Environnement associé au Niveau.
L’écran Aperçu des Paramètres de machine vous permet de créer, modifier, supprimer et copier des Paramètres de machine et d’en afficher l’historique. Les actions suivantes sont possibles:
Aperçu des paramètres de machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu des Paramètres de Machine.
L’écran suivant s’affiche:
Vous pouvez également accéder à l’Aperçu des Paramètres via l’Aperçu des Machines, en sélectionnant
(Administration
globale) > Machines > Aperçu et en sélectionnant ensuite le lien
Voir
les Paramètres pour la Machine requise. -
Définissez les critères de recherche requis dans le panneau de recherche.
La liste des éléments dans l’aperçu est synchronisée automatiquement en fonction des critères sélectionnés.
Vous pouvez également:
-
cliquer sur le lien Montrer/Cacher les options avancées pour afficher ou masquer tous les critères de recherche disponibles,
-
cliquer sur le lien Rechercher pour synchroniser la liste en fonction des critères de recherche actuels,
-
cliquer sur le lien Réinitialiser la recherche pour nettoyer les champs.
-
-
Vérifiez l’information disponible dans l’Aperçu des Paramètres de machine.
L’Aperçu des Paramètres de machine affiche les Paramètres de machine définis pour chacune des Machines.
Pour la description des champs, se référer à Créer un paramètre de machine.
Les liens suivants sont disponibles:

Créer un Paramètre
Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de créer un Paramètre de machine.

Historique
Cette option est disponible pour tous les Utilisateurs IKAN ALM. Elle permet d’afficher l’historique d’un Paramètre de machine.

Modifier un Paramètre
Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de modifier un Paramètre de machine.

Supprimer un Paramètre
Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de supprimer un Paramètre de machine et (optionnellement) de supprimer les Paramètres de machine liés à d’autres Machines via la même clé.

Copier un Paramètre
Cette option est disponible pour les Utilisateurs IKAN ALM ayant des droits d’accès d’Administrateur global. Elle permet de copier un Paramètre de machine.
Les colonnes marquées de l’icône
peuvent être rangées par ordre alphabétique (ascendant ou descendant).
Créer un paramètre de machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu des Paramètres de machine.
-
Cliquez sur le lien
Créer un Paramètre à côté du nom de la machine pour afficher la fenêtre Créer un Paramètre de machine.La fenêtre suivante s’affiche:
-
Complétez les champs pour le nouveau Paramètre de machine.
Les champs suivants sont disponibles. Le champ Code est un champ obligatoire.
Champ Description Machine
Ce champ affiche la Machine actuelle.
Sécurisé
Ce champ indique si le Paramètre est sécurisé ou non.
Si vous sélectionnez l’option Oui, la fenêtre est modifiée pour permettre la saisie d’un Paramètre sécurisé:
-
Ajout du champ Valeur répétée
-
Suppression des champs Modifiable et Dynamique
Code
Saisissez dans ce champ le code (la dénomination) du Paramètre de machine.
Valeur
Saisissez dans ce champ la(les) valeur(s) du nouveau Paramètre de machine.
Les possibilités sont les suivantes:
-
une valeur fixe, si vous voulez créer un Paramètre de machine non-modifiable,
-
une valeur par défaut, si vous voulez créer un Paramètre de machine modifiable,
-
une liste de valeurs prédéfinies possibles, séparées d’un point-virgule (;), si vous voulez créer un Paramètre de machine dynamique (par exemple,
oui;non). Ensuite, ces valeurs pourront être sélectionnées à partir d’une liste déroulante lors de la création d’une Requête de Niveau.
Répéter la Valeur
Champ obligatoire pour les Paramètres de machine sécurisés: répétez la valeur sécurisée.
Description
Saisissez dans ce champ la description du Paramètre.
Obligatoire
Sélectionnez l’option Oui, si le nouveau Paramètre de machine doit être obligatoire. Lors de la création d’une Requête de Niveau, les Paramètres obligatoires seront toujours transmis au script de construction/déploiement.
Sélectionnez l’option Non, si le nouveau Paramètre de machine ne doit pas être obligatoire. Lors de la création d’une Requête de Niveau, vous pourrez décider si vous voulez communiquer le Paramètre non-obligatoire au script de construction/déploiement.
Modifiable
Sélectionnez l’option Oui, si le nouveau Paramètre de machine doit être modifiable. Lors de la création d’une Requête de Niveau, vous pouvez accepter la valeur par défaut (celle que vous saisissez dans le champ Valeur lors de la création du paramètre) ou vous pouvez vous-même définir la valeur de ce Paramètre.
Sélectionnez l’option Non, si le nouveau Paramètre de machine ne doit pas être modifiable. Lors de la création d’une Requête de Niveau, seule la valeur prédéfinie (celle que vous saisissez dans le champ Valeur lors de la création du paramètre) peut être transmise au script de construction/déploiement.
Ce champ n’est pas disponible pour les Paramètres sécurisés.
Dynamique
Sélectionnez l’option Oui, si le nouveau Paramètre de machine doit être dynamique. Lors de la création d’une Requête de Niveau, vous pouvez sélectionner une des valeurs prédéfinies à partir du menu déroulant. Ces valeurs sont définies, séparées d’un point-virgule (;), dans le champ Valeur lors de la création du paramètre. La valeur sélectionnée sera transmise au script de construction/déploiement.
Sélectionnez l’option Non, si le nouveau Paramètre de machine ne doit pas être dynamique.
Ce champ n’est pas disponible pour les Paramètres sécurisés.
-
-
Cliquez sur le bouton Créer pour confirmer la création du Paramètre de machine.
Les boutons suivants sont également disponibles:
-
Réinitialiser pour nettoyer les champs.
-
Annuler pour retourner à l’écran précédent sans enregistrer les modifications.
-
Modifier un paramètre de machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu des Paramètres de machine.
-
Dans la colonne Actions, cliquez sur le lien
Modifier un Paramètre à côté du Paramètre de machine à modifier.La fenêtre suivante s’affiche:
-
Si nécessaire, modifiez les champs dans la fenêtre Modifier un Paramètre de machine.
Pour la description des champs, se référer à la section Créer un paramètre de machine.
-
Cliquez sur le bouton Sauvegarder pour sauvegarder vos modifications.
Les boutons suivants sont également disponibles:
-
Réinitialiser pour nettoyer les champs.
-
Annuler pour retourner à l’écran précédent sans enregistrer les modifications.
-
Supprimer un paramètre de machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu des Paramètres de machine.
-
Dans la colonne Actions, cliquez sur le lien
Supprimer un Paramètre à côté du Paramètre de machine à supprimer.L’écran suivant s’affiche:
-
Optionnellement, sélectionnez des machines additionnelles. Cette option vous permet de supprimer des Paramètres ayant la même clé sur les Machines sélectionnées.
-
Cliquez sur le bouton Supprimer pour confirmer la suppression du Paramètre de machine.
Vous pouvez également cliquer sur le bouton Annuler pour retourner à l’écran précédent sans supprimer le paramètre.
Copier un paramètre de machine
Cette fonctionnalité permet de copier la définition complète d’un Paramètre de machine d’une Machine source vers une ou plusieurs Machine(s) cible(s)
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu des Paramètres de machine.
-
Dans la colonne Actions, cliquez sur le lien
Copier un Paramètre à côté du Paramètre de machine à copier.La fenêtre suivante affiche les valeurs du Paramètre que vous allez copier.
-
Indiquez si vous voulez remplacer le paramètre dans le cas où il est déjà défini sur la Machine cible.
-
Sélectionnez la(les) Machine(s) cible(s).
-
Cliquez sur le bouton Copier pour confirmer la copie du Paramètre de machine.
Les boutons suivants sont également disponibles:
-
Réinitialiser pour nettoyer les champs.
-
Annuler pour retourner à l’écran précédent sans enregistrer les modifications.
-
Afficher l’historique d’un paramètre de machine
-
Dans le contexte de l’Administration globale, sélectionnez Machines > Aperçu des Paramètres de machine.
-
Cliquez sur l’icône
Historique pour afficher l’écran Aperçu de l’Historique de la Machine.Pour une description détaillée de l’Aperçu de l’Historique, se référer à la section Enregistrement de l’historique et des événements.
-
Cliquez sur le bouton Précédent pour retourner à l’écran précédent.