Guide d’installation du demo (Windows)

L’installation IKAN ALM Démo 5.8 Windows a été testée sous:

Le kit de développement Java SE (JDK) V1.7.x ou 1.8x 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.

Si vous voulez suivre les actions avec le projet .NET Démo "Monocalendar", le Microsoft Windows SDK for Windows 7 doit être installé ainsi que le .NET Framework 4. Sinon, il sera impossible de construire et d’exécuter le projet Monocalendar.

Vous pouvez installer le Windows SDK et le .NET Framework plus tard. Il est téléchargeable à partir du site Web de Microsoft: http://www.microsoft.com/en-us/download/details.aspx?id=8279.

L’application IKAN ALM Démo Windows est distribuée sous forme d’un fichier d’archive auto-extractible 32 bits et 64 bits. La première étape de l’installation consiste à choisir le fichier d’archive approprié et de l’extraire localement sur la machine où vous voulez installer l’application IKAN ALM Démo.

Pour ce faire, double-cliquez ou exécutez le fichier d’archive (ikanalm_trial_x86.exe ou ikanalm_trial_x64.exe).

Une fenêtre semblable à celle-ci s’affichera:

Sélectionnez un répertoire Cible. Les fichiers seront extrait dans un sous-répertoire nommé "ikanalm_trial_x86" ou "ikanalm_trial_x64".

Après extraction, le répertoire devrait contenir:

Exécutez l’installateur pour la version 32 bits ou 64 bits:

L’installateur graphique d’IKAN ALM ne démarre pas! Si l’installateur IKAN ALM ne démarre pas, se référer à la section Résolution des problèmes.

Selon la version du système d’exploitation Windows utilisé, il peut y avoir des différences dans le comportement de l’installateur.

Si UAC est activé (Windows Vista et versions ultérieures), Windows demandera une confirmation avant que le programme ne puisse apporter des modifications à votre ordinateur (si vous utilisez un compte Administrateur). Si vous essayez d’installer l’application en utilisant un autre compte que le compte Administrateur, le message "The requested operation requires elevation" pourrait s’afficher.

Double-cliquez sur le fichier almdemo_install_5.8_xXX.exe. 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. Le répertoire de Base par défaut est C:\ALMDemo. 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 de 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.

Ouvrez une fenêtre de commande DOS et saisissez netstat -an pour vérifier les ports actuellement utilisés.

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 compléter l’installation IKAN ALM Démo.

Combiné avec ce Guide d’installation et l’installateur, vous devriez avoir reçu un fichier de licence nommé 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:

La fenêtre pour installer la licence s’affiche:

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. Ne modifiez ni le fichier ni le nom du fichier. Dès que la licence est installée, la fenêtre suivante s’affiche:

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

Démarrez le Serveur IKAN ALM Démo

Cela lancera un Serveur Web Tomcat et le Serveur IKAN ALM Démo (sur lequel sont exécutés le Serveur et l’Agent IKAN ALM). Si la fenêtre de commande du Serveur IKAN ALM Démo affiche un message tel que: "Successfully connected with IKAN ALM server", l’application ALM Démo a démarré complètement.

Si la fenêtre de commande du Serveur IKAN ALM Démo affiche un message tel que: "INFO : Server startup in nnn ms" , le Serveur Tomcat a démarré complètement et vous pouvez utiliser l’application Web avec votre navigateur.

Arrêter le Serveur IKAN ALM Démo

Si vous utilisez la machine sur laquelle l’application IKAN ALM Démo est installée, vous pouvez procéder comme suit:

Démarrer > Programmes > IKAN ALM Demo 5.8 > Open IKAN ALM in browser

Si vous n’avez pas installé les raccourcis de menu de démarrage, ou si vous travaillez sur une machine distante dans le même réseau auquel appartient la machine sur laquelle vous avez installé l’application IKAN ALM Démo, procédez comme suit:

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 IKAN ALM Démo comprend deux projets Démo complètement configurés incluant un Système de Contrôle de Version (Subversion), des Outils de script, des scripts, des fichiers Source, et des sections d’Administration globale et d’Administration des projets complètement configurées et prêtes pour les activités de Construction et de Déploiement.

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

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 Modifier un 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, par exemple Tortoise SVN, 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.

Modifiez 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.

Le Bureau vous permet de suivre les actions (Constructions, Déploiements) exécutées dans un projet. Quand 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 "Monocalendar".

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, ils 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 "Monocalendar" 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 Monocalendar 1-0 . Les Niveaux suivants s’affichent:

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

Pour pouvoir construire le projet "Monocalendar", il faut 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’Administrateur de projets, tels que les Utilisateurs "global" ou "projet" (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 "Monocalendar".

L’écran Informations sur le Projet s’affiche dans le contexte de l’Administration du projet "Monocalendar". 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 sous-menu, sélectionnez Aperçu des Projets pour vérifier que le bouton Verrouillé devant le Projet a disparu.

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, par exemple Tortoise SVN, et récupérez le code Source.

L’URL du Référentiel pour le projet Démo "Monocalendar" est ALM_HOME/vcr/subversion/repository/monocalendar/trunk.

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

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 (où ALM_HOME=`"C:/ALMDemo`"):

Si vous voulez utiliser l’Authentification de domaine de Windows, remplacez la configuration à fichier plat par les lignes suivantes (YOURDEMAIN étant le domaine Windows, par exemple, IKAN):

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).

Par exemple: 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

L’installateur de l’application IKAN ALM Démo ne parvient pas à localiser le fichier suivant: MSVCR71.dll. Vous trouverez plus d’informations sur ce sujet sur http://www.duckware.com/tech/java6msvcr71.html. Cependant, il n’existe pas de bonne solution. Sun propose de résoudre le problème en copiant le fichier msvcr71.dll du répertoire bin de l’installation Java dans le répertoire où se trouve le fichier java.exe, c’est-à-dire le répertoire windows\system32.

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.

Si vous lancez l’installateur IKAN ALM Démo 32 bits ou 64 bits, le message d’erreur suivant pourrait s’afficher, après lequel l’installateur IKAN ALM Démo s’arrête.

La cause la plus probable est qu’aucun environnement Java Runtime (JRE) approprié n’est installé. L’installateur 32 bits nécessite un JRE 32 bits, tandis que l’installateur 64 bits nécessite un JRE 64 bits. De plus, la version du JRE doit être 1.6 ou supérieure. La solution consiste à installer un JRE approprié.

Si, pour une raison quelconque, vous ne voulez pas installer de JRE, vous pouvez contourner cette situation en lançant l’installateur IKAN ALM avec uniquement un Kit de développement Java (JDK) ou un Serveur JRE installé. Spécifiez la variable d’environnement JAVA_HOME de sorte à ce qu’elle pointe vers le répertoire JDK ou Serveur JRE, soit globalement dans le système, soit à partir d’une fenêtre de ligne de commande, et lancez l’installateur IKAN ALM. Si vous spécifiez JAVA_HOME à partir de la fenêtre de ligne de commande, il y a deux pièges potentiels: