Guide d’installation du demo (Linux)

L’installation IKAN ALM Démo 5.8 Linux a été testée sous les versions actuelles de:

Cependant, l’application IKAN ALM Démo devrait fonctionner sous d’autres variantes de Linux.

Le kit de développement Java SE (JDK) V1.7.x ou 1.8 est requis.

Tous les composants IKAN ALM nécessitent au moins un Kit de développement Java (JDK) ou un Serveur Java Runtime (Serveur JRE). IKAN ALM a été testé pour fonctionner avec Oracle Java ainsi qu’avec OpenJDK. Le Java SE Server Runtime Environment (Serveur JRE) et le Kit de développement logiciel (SDK) peuvent être obtenus gratuitement via le site Web d’Oracle. Les version 32 bits et 64 bits sont toutes les deux supportées.

La dernière version de Java SE peut être téléchargée sur http://www.oracle.com/technetwork/java/javase/downloads/index.html.

Elle peut être installée en tant que super-utilisateur (root) ou en tant qu’utilisateur normal (par exemple, dans le répertoire de Base de l’utilisateur) et plusieurs versions peuvent coexister sur votre système. Vous pouvez également l’installer via le gestionnaire des paquets de votre distribution Linux. Notez que la plupart des distributions incluent par défaut OpenJDK et que les référentiels Oracle doivent être explicitement activés, par exemple, dans le cas d’Ubuntu vous devez activer le référentiel "partenaire" Canonical.

IKAN ALM s’intègre avec des outils de Contrôle de Version tels que Subversion (SVN), Git, Microsoft Team Foundation Version Control (TFVC), Concurrent Versions Systems (CVS), …​ Pour exécuter des Constructions ou pour déployer les résultats de construction, vous devez établir la connexion avec un Référentiel de Contrôle de Version (RCV) existant.

Ce Référentiel peut être installé sur le même système que la Démo IKAN ALM ou sur une Machine distante. Dans ces deux cas, vous devez spécifier les paramètres pour se connecter au Référentiel. Cela peut être fait après l’installation d’IKAN ALM.

Cette installation Démo inclut la création d’un Référentiel Subversion. Pour se connecter à ce référentiel, la version 1.8 (ou ultérieure) de Subversion doit être installée sur le système Démo IKAN ALM. Vous pouvez télécharger Subversion à partir du site Web http://subversion.apache.org.

Vous pouvez également installer Subversion en utilisant le gestionnaire des paquets de votre installation Linux. Par exemple: sous Suse Linux, avec YAST:

L’application IKAN ALM Démo 5.8 sera distribuée comme un fichier .tar.gz nommé ikanalm_trial.tar.gz. Après extraction, vous trouverez un fichier exécutable .jar, ce Guide d’installation et un fichier de licence.

Exécutez le fichier .jar en utilisant la commande suivante dans un terminal: java -jar alm_demo_5-8.jar.

La fenêtre suivante s’affichera:

Sélectionnez votre langue d’installation préférée et cliquez sur OK.

La fenêtre de bienvenue suivante s’affiche:

Cliquez sur le bouton Suivant pour continuer.

Lisez attentivement l’information "Lisez-moi" (uniquement disponible en anglais). Pour continuer, cliquez sur le bouton Suivant.

Lisez attentivement l’accord de licence (uniquement disponible en anglais), sélectionnez l’option J’accepte les termes de cet accord de licence et cliquez sur le bouton Suivant.

Dans votre système de fichiers, sélectionnez le répertoire de Base pour l’installation Démo d’IKAN ALM 5.7. Vous pouvez modifier cet emplacement en utilisant le bouton Parcourir.

Dans la suite de ce document, cet emplacement s’appellera ALM_HOME.

Cliquez sur le bouton Suivant pour continuer.

Si le répertoire existe déjà, un message d’avertissement s’affichera.

Dans la version Démo, tous les paquetages doivent être installés.

Cliquez sur le bouton Suivant pour continuer avec la sélection d’un Kit de développement Java (JDK).

Comme indiqué dans la section Kit de développement Java SE, la version 1.7 ou 1.8 du Kit de développement Java (JDK) est requise.

Si le répertoire sélectionné ne contient pas de JDK approprié, le message d’erreur suivant s’affichera:

Configurez les ports réseau utilisés par IKAN ALM. En principe, les valeurs proposées par défaut devraient être correctes. Il faut néanmoins s’assurer que ces numéros de port ne soient pas utilisés par d’autres processus.

Vous pouvez vérifier les ports utilisés avec la commande netstat: ouvrez un terminal et saisissez netstat -ltun pour afficher les ports TCP / UDP à l’écoute.

Dans le reste du présent guide, le port du Serveur d’application s’appellera désormais ALM_APPSERVER_PORT.

Cliquez sur le bouton Suivant pour afficher le résumé de l’installation.

Cliquez sur le bouton Suivant pour démarrer l’installation utilisant les paramètres spécifiés:

Une fois l’installation terminée, cliquez sur le bouton Suivant pour continuer avec la spécification du menu de démarrage.

Sélectionnez le Groupe Programme et le Nom du raccourci pour le menu de démarrage. Par défaut, IKAN ALM Demo 5.8 est utilisé pour le groupe et le nom. Vous pouvez modifier ces noms.

Cliquez sur le bouton Suivant pour terminer l’installation.

Avec le présent Guide d’installation et le fichier d’installation alm_demo_5-8.jar, vous avez reçu un fichier de licence appelé alm_license.lic.

Cette licence démo expirera après 30 jours. (Étape 2: Accord de licence). Contactez les services de support d’IKAN ALM si vous n’avez pas reçu de fichier de licence, ou si vous voulez étendre la période de licence.

Démarrez le Serveur IKAN ALM Démo

Ouvrez l’application Web IKAN ALM via un navigateur Web:

Saisissez l’URL suivant: http://MACHINE_NAME:ALM_APPSERVER_PORT/alm (Par exemple, http://ikan009:9080/alm)

S’il s’agit de votre première installation, aucune licence ne sera trouvée et une fenêtre s’affichera vous demandant d’en fournir une.

Saisissez ou sélectionnez l’emplacement du fichier alm_license.lic que vous avez reçu en utilisant le bouton "Browse" et cliquez sur le bouton Submit.

Dès que la licence est installée, la fenêtre de Connexion s’affiche. Saisissez le code Utilisateur global et le Mot de passe global pour continuer.

Le Serveur IKAN ALM Démo doit être en cours avant de pouvoir utiliser IKAN ALM.

Démarrez le Serveur IKAN ALM Démo

Arrêter le Serveur IKAN ALM Démo

Une session de navigateur Web s’ouvrira affichant la fenêtre de Connexion d’IKAN ALM.

Vous êtes prêts à utiliser l’interface Web IKAN ALM.

Il est utile d’ajouter ce lien aux favoris de votre navigateur Web.

Utilisez une des combinaisons Utilisateur-Mot de passe prédéfinies pour vous connecter à IKAN ALM.

Nous vous conseillons de démarrer avec l’Utilisateur global (Mot de passe: global) puisque cet Utilisateur à des droits d’accès complets à tous les composants de l’application IKAN ALM Démo.

Saisissez l’Utilisateur et le Mot de Passe et cliquez sur le bouton Se connecter. La page d’accueil d’IKAN ALM s’affiche et vous pouvez commencer à travailler dans IKAN ALM.

L’installation Démo IKAN ALM comprend deux projets démo complètement configurés avec un Système de Contrôle de Version (Subversion), des Outils de script, des scripts et des fichiers Source. Les sections Administration globale et Administration des projets sont complètement configurées et les Projets sont prêts pour les activités de Construction et de Déploiement.

Le Guide de l’Utilisateur IKAN ALM est disponible dans les formats suivants:

Pendant l’installation de la version Démo, un Référentiel Subversion a été créé, lequel contient les sources et les scripts du projet "Customers". Pour se connecter à ce référentiel, vous avez besoin d’un Serveur Subversion en exécution, comme mentionné dans cette section. Pour pouvoir travailler dans le projet "Customers", vous devez vous assurer qu’IKAN ALM peut se connecter au Référentiel Subversion.

Vérifiez si le Serveur IKAN ALM est en cours d’exécution et connectez-vous comme Utilisateur global (Mot de passe: global). Sélectionnez Administration globale > Référentiels de contrôle de version > Aperçu et spécifiez Subversion dans le champ Type du panneau Rechercher des Référentiels de contrôle de version.

La définition du Référentiel Subversion a été créée lors de l’installation et il y a eu une tentative pour détecter si un Serveur Subversion est installé localement. La plupart des paramètres est en ordre pour la connexion avec le Référentiel Subversion créé dans le répertoire ALM_HOME/vcr/subversion/repository. Cependant, il faudra peut-être modifier le Chemin de commande s’il n’est pas détecté lors de l’installation. Par défaut, le Référentiel ne requiert pas d’Utilisateur ni de Mot de passe.

Cliquez sur l’icône Modifier.

Modifiez le Chemin de commande de sorte qu’il pointe vers l’emplacement de la commande du Client Subversion (svn), par exemple, /usr/bin). Notez qu’il ne faut spécifier que le chemin de l’emplacement. N’incluez pas la commande elle-même!

Cliquez sur le bouton Vérifier la connexion pour vérifier la définition de Subversion. Un message informatif indiquera si la définition est correcte. Sinon, un message d’erreur indiquera le problème rencontré.

N’oubliez pas de cliquer sur le bouton Sauvegarder pour confirmer vos modifications.

Le Bureau vous permet de suivre les actions (Constructions, Déploiements) exécutées dans un projet. Si vous vous connectez pour la première fois, votre Bureau sera vide.

Dans cette section, nous créerons un élément de bureau pour le projet "Customers".

Dans la fenêtre du Bureau, cliquez sur le bouton Ajouter au Bureau.

La fenêtre Ajouter au Bureau s’affiche.

Un Projet peut avoir plusieurs Cycles de Vie. Dans IKAN ALM, ces Cycles de vie sont organisés dans des Branches. Pour pouvoir suivre l’activité dans une Branche, vous pouvez créer un élément de bureau pour la Branche.

Sélectionnez la Branche "1-0" du projet "Customers" et cliquez sur le bouton Ajouter au Bureau.

Si l’élément est ajouté correctement au Bureau, un message de confirmation s’affichera. Cliquez sur le bouton Fermer pour fermer la fenêtre Ajouter au Bureau.

Développez les Niveaux de la Branche en cliquant sur l’icône devant l’élément de bureau de la Branche Customers 1-0. Les Niveaux suivants s’affichent:

Comme vous pouvez le constater, il n’y a pas encore beaucoup d’activité dans le projet "Customers" puisque le projet est verrouillé. Dans l’étape suivante nous déverrouillerons le projet.

Pour pouvoir construire le projet "Customers", il faudra déverrouiller le projet, ainsi que les Niveaux correspondants, dans la section Administration des projets. Cette action est réservée aux Utilisateurs ayant des droits d’Administration de projets, tels que les Utilisateurs "global" ou "projet" (voir Se connecter à l’application Web IKAN ALM).

Pour commencer la procédure de déverrouillage, sélectionnez Administration des projets dans le menu principal.

Cliquez sur l’icône _Modifier _ devant le projet "Customers".

La fenêtre Informations sur le Projet s’affiche dans le contexte de l’Administration du projet "Customers". Nous n’allons pas modifier les Paramètres du Projet, mais vous pouvez vérifier l’existence du Projet dans le Référentiel Subversion en cliquant sur le bouton Vérifier le nom du Projet dans le RCV.

Dans le sous-menu, sélectionnez Auditer le projet pour vérifier la cohérence du Projet.

Avant que la fenêtre Auditer le Projet ne soit affichée, plusieurs contrôles sont effectués pour vérifier la configuration du Projet. Vous pouvez utiliser le bouton pour afficher l’aide en ligne concernant cette fonction. Pour plus d’informations, se référer au chapitre Auditer un projet dans le Guide de l’Utilisateur IKAN ALM.

Si le projet est cohérent (branches secondaires, niveaux, environnements, phases et paramètres sont valides), le lien Déverrouiller apparaîtra dans le panneau Actions. Cliquez sur ce lien pour déverrouiller le Projet et ses Niveaux.

Suite à cela, l’icône Verrouillé devant les Niveaux disparaîtra. Le projet n’est plus verrouillé. Dans le menu principal, sélectionnez Administration des Projets pour vérifier, dans l’Aperçu des Projets, qu’il n’y a plus de bouton Verrouillé devant le Projet.Dès que le Projet et ses Niveaux sont déverrouillés, quelques actions seront automatiquement exécutées dans le Projet. Passez à la section suivante pour comprendre ce qui se passe.

Vous pouvez vérifier le code Source des projets Démo et enregistrer les modifications.

Installez un client Subversion et récupérez le code Source.

L’URL du Référentiel pour le projet "Customers" est file:///ALM_HOME/vcr/subversion/repository/customers/trunk.

Modifier un fichier Source et enregistrez-le. Le Planificateur remarquera les modifications et démarrera la construction du Projet.

Au lieu d’utiliser un seul script Ant très large exécutant toutes les tâches, le déploiement de l’application "Customers" utilise plusieurs petits scripts chacun d’entre eux exécutant une tâche spécifique. Les tâches réutilisables ont été regroupées dans une Phase personnalisée dans IKAN ALM.

Plus spécifiquement, le déploiement vers le Niveau TEST exécute trois tâches:

La première tâche n’est pas assez générale pour pouvoir être réutilisée, mais pour les deux autres des Phases personnalisées ont été créées: les Phases "Update DB" et "Tomcat Deploy".

Pour vérifier la définition de ces Phases, sélectionnez Administration globale > Phases > Aperçu.

Cliquez sur l’icône Modifier devant la Phase com.ikanalm.phases.ant.scripting.tomcatDeploy Phase.

Cette fenêtre affiche les informations générales sur la Phase, les Paramètres de phase qui peuvent être spécifiés pour configurer l’exécution de la Phase et les Niveaux et Environnements connectés où la Phase est utilisée.

Un des paramètres à spécifier est le paramètre “tomcat.server.url”. Il établit l’URL de base du Serveur Tomcat de l’emplacement où les applications doivent être déployées. Si une Phase est ajoutée à un Environnement (de Niveau, de Construction ou de Déploiement), ces paramètres peuvent avoir une valeur différente pour chaque environnement. Cela signifie que la même Phase peut être réutilisée dans beaucoup d’environnements différents, exécutant chaque fois une tâche différente, ce qui offre une grande flexibilité.

Comme vous pouvez le constater dans le panneau Niveaux et Environnements connectés, notre Phase de Déploiement Tomcat est actuellement utilisée à deux endroits différents:

Comme un exemple d’une utilisation plus avancée des Paramètres, prenons le Paramètre de phase "contextPath". Sa valeur par défaut est établie à /${applicationName} et cette valeur est spécifiée tant pour l’Environnement "testdeploy" que pour l’Environnement "proddeploy" (cliquez sur l’icône Modifier devant le Paramètre contextPath). Toutefois, l’application "Customers" est déployée dans deux contextes différents: "customers_test" et "customers".

Comment cela est réalisé?

La réponse se trouve dans le Paramètre de déploiement (nommé "applicationName") qui est spécifié pour les deux Environnements de déploiement .

Accédez à la section Administration des projets et modifiez le projet "Customers". Dans le menu, sélectionnez ensuite Environnements de déploiement > Paramètres de Déploiement:

Vous constaterez que pour l’Environnement "testdeploy" la valeur du Paramètre "applicationName" est "customers_test", tandis que pour l’Environnement "proddeploy" la valeur est établie à "customers". Au moment de l’exécution de la Phase de Déploiement Tomcat, la propriété ${applicationName} sera remplacée par la valeur du Paramètre de déploiement qui donnera le résultat désiré.

Pour plus d’informations concernant les Phases personnalisées et la procédure pour les créer vous-mêmes, se référer au Guide de l’Utilisateur IKAN ALM (le chapitre Administration globale, Phases) et l’appendice Phases: Informations générales), et le document Utiliser et développer des Phases personnalisées dans IKAN ALM.

L’installation IKAN ALM Démo utilise son propre fichier jaas.config qui se trouve dans ALM_HOME /system/security.

Par défaut, le fichier passwd.config est utilisé comme un fichier de sécurité plat.

L’application IKAN ALM Démo utilise cette implémentation JAAS simple par laquelle les Groupes d’utilisateurs et les Utilisateurs sont configurés dans un fichier plat. Dans le fichier de configuration JAAS, cela est spécifié comme suit (par exemple, ALM_HOME="home/ikan/ALMDemo"):

Lorsque l’on utilise la sécurité à fichier plat, le contenu du fichier passwd.config est assez simple et intuitif:

Vous pouvez générer le mot de passe encrypté en format de cryptage MD5 en utilisant un outil tel que HashCalc (http://www.slavasoft.com/hashcalc/overview.htm) (sous Windows) ou GtkHash (sous Linux).

Ajouter un Utilisateur avec comme identifiant Utilisateur "testuser" et comme Mot de passe "testuser" qui appartient au Groupes d’utilisateurs ALM User et ALM Project

Cette erreur peut se produire si l’installation de la version Démo est interrompue. Si vous essayez de ré-exécuter l’installation, le message ci-dessous s’affichera. La cause est un fichier de verrouillage dans le répertoire temp:

Recherchez le fichier nommé iz-ALMDemo.tmp et supprimez-le.

Cette erreur peut se produire lors de l’installation de la licence.

Assurez-vous que le fichier de licence n’a pas été modifié.

Assurez-vous que le fichier de licence a été correctement transféré depuis la machine de l’installation, (par exemple, la taille du fichier doit être > 500 octets).

Cause: Le Serveur IKAN ALM Démo n’est pas en cours d’exécution.

Solution:

La période d’essai de 30 jours s’est terminée. Si vous voulez étendre la période d’essai, vous devez demander une nouvelle licence en envoyant un courrier électronique à support@ikanalm.com.