Configurer l'application du serveur Rational Asset Manager

Pour terminer la configuration de l'application serveur IBM® Rational Asset Manager, exécutez les étapes de cette section.

Avant de commencer

Si vous utilisez IBM WebSphere Application Server ainsi que l'application de configuration du serveur, vous pouvez utiliser cette dernière pour configurer le référentiel. Pour plus d'informations, voir Déployer et configurer des fichiers d'application à l'aide de l'application de configuration du serveur.

Remarque : Les exemples de valeurs de cette section correspondent à un environnement autonome de base. Pour une installation plus complexe, l'administrateur du serveur devra les personnaliser.

Le ou les serveurs d'applications hébergeant les applications serveur Rational Asset Manager et Rational Team Concert doivent être démarrés avant de terminer cette procédure.

Procédure

  1. Vérifiez que tous les serveurs de référentiels sont définis aux mêmes date, heure et fuseau horaire courants.
  2. Accédez à l'application serveur Rational Asset Manager en utilisant l'adresse URL appropriée :
    • Sous IBM WebSphere Application Server intégré :
      http://nom_machine:numéro_port/Racine_contexte_Rational_Asset_Manager/home.faces
      numéro_port (port de transport HTTP ou WC_defaulthost) est 13080 par défaut et Racine_contexte_Rational_Asset_Manager (racine de contexte pour l'application Rational Asset Manager) est ram par défaut.
      Par exemple, entrez :
      http://localhost:13080/ram/home.faces

      Pour vérifier le numéro de port (WC_defaulthost), ouvrez le fichier emplacement d'installation\ram\ewas\profiles\profile1\properties\portdef.props dans un éditeur de texte et regardez la valeur de wc_defaulthost, emplacement d'installation étant l'emplacement d'installation de Rational Asset Manager.

    • Sous WebSphere Application Server :
      http://nom_machine:numéro_port/Racine_contexte_Rational_Asset_Manager/home.faces
      numéro_port (port de transport HTTP ou WC_defaulthost) est 9080 par défaut et Racine_contexte_Rational_Asset_Manager (racine de contexte pour l'application Rational Asset Manager) est ram par défaut.
      Par exemple, entrez :
      http://www.exemple.com:9080/ram/home.faces

      Pour vérifier la valeur WC_defaulthost, ouvrez la console d'administration de WebSphere Application Server et cliquez sur Serveurs > Types de serveur > Serveurs d'applications WebSphere > nom_serveur > Ports.

    • Sur Apache Tomcat :
      http://nom_machine:8080/ram/home.faces
      Par exemple, entrez :
      http://localhost:8080/ram/home.faces
  3. Connectez-vous en tant qu'administrateur du serveur d'applications :
    • Pour WebSphere :Pour WebSphere Application Server, l'ID utilisateur et le mot de passe par défaut sont admin.
    • Pour Apache Tomcat, l'ID utilisateur par défaut est admin et le mot de passe par défaut est blanc.
  4. La première fois que vous accéderez à Rational Asset Manager, une page Erreur de configuration doit apparaître. Cliquez sur le lien ici et entrez l'ID utilisateur et le mot de passe de l'administrateur. La page Configuration s'ouvre.
  5. Dans la section Licence et version, indiquez le chemin du serveur de licences et sélectionnez le type de licence que ce référentiel doit utiliser :
    1. Dans la section Licence et version, dans la zone Emplacement du serveur de licence, entrez le numéro de port, puis le nom complet du serveur de licences. Séparez le numéro et le nom par un signe @. Par exemple, 27000@chemin_serveur_licences.

      Si vous avez plusieurs serveurs de licences dans votre environnement, séparez les entrées correspondantes par des virgules. Vous devez fournir trois serveurs. Par exemple, 27000@premier.exemple.com,27000@deuxième.exemple.com,27777@troisième.exemple.com.

      Si vous avez plusieurs serveurs de licences sur des réseaux distincts et avec des licences différentes :
      • Windows : séparez les adresses par des points-virgules (;). Par exemple, 27000@main.example.com;27000@backup.example.com.
      • Linux, AIX ou Linux for zSeries : séparez les adresses par des deux-points (:). Par exemple, 27000@main.example.com:27000@backup.example.com.
    2. Pour configurer le type de licences pour le référentiel à utiliser, sous Type de licence, sélectionnez Editions standard ouEdition d'entreprise.
  6. Dans la section Base de données, vérifiez que l'utilisateur indiqué dans la zone Utilisateur dispose d'un accès total aux bases de données Rational Asset Manager et Rational Team Concert. Si ce n'est pas le cas, entrez l'ID et le mot de passe d'un utilisateur disposant d'un accès complet aux bases de données.
  7. Indiquez le chemin des services Web :
    1. Sous Chemin des services Web, entrez :
      http://nom_hôte:numéro_port/Racine_contexte_services_Web_Rational_Asset_Manager
      nom_hôte est le nom d'hôte du serveur d'applications, numéro_port est le port de transport HTTP et Racine_contexte_services_Web_Rational_Asset_Manager est la racine de contexte de l'application de services Web de Rational Asset Manager.

      Si vous utilisez un équilibreur de charge, indiquez son nom. Si vous utilisez un serveur de proxy Web sans équilibreur de charge, indiquez son nom. Si vous utilisez IPV6, utilisez le nom d'hôte IPV6 ; une adresse IPV6 ne fonctionnera pas.

      Par exemple, entrez :
      http://www.exemple.com:9080/ram.ws
  8. Dans la section Chemin interne de Rational Team Concert, indiquez les informations de chemin d'accès et de connexion pour IBM Rational Team Concert :
    1. Dans la zone Chemin, entrez le chemin sécurisé du serveur Rational Team Concert. Par exemple, https://www.exemple.com:9443/jazz. Si vous utilisez IPV6, utilisez le nom d'hôte IPV6 ; une adresse IPV6 ne fonctionnera pas.
    2. Dans les zones Utilisateur et Mot de passe, entrez le nom d'utilisateur et le mot de passe de l'administrateur de la zone de projet "Cycles de vie RAM" dans Rational Team Concert. Dans les installations simples, il s'agit généralement de l'administrateur de Rational Team Concert et du serveur d'applications.
  9. Dans la section Registre d'utilisateurs personnalisé, si vous avez configuré votre serveur Web en vue de l'utilisation d'une authentification LDAP, vous pouvez configurer Rational Asset Manager afin d'utiliser le registre LDAP pour effectuer une authentification d'utilisateur, extraire des informations utilisateur ou optimiser des liaisons entre des groupes :
    1. Si vous prévoyez d'utiliser une classe d'utilisateur personnalisée, cochez la case Utiliser un registre d'utilisateurs personnalisé et entrez le chemin complet de la classe dans la zone Classe. Sinon, conservez la valeur indiquée par défaut dans cette zone.
    2. Dans la zone ID administrateur, entrez l'ID de connexion d'un utilisateur du registre ayant des droits d'administrateur de référentiel pour Rational Asset Manager. Vous devez fournir un administrateur de référentiel valide pour pouvoir vous connecter à Rational Asset Manager sous ce rôle afin de configurer l'application de manière plus approfondie.
    3. Cliquez sur Configurer et entrez les informations suivantes pour configurer la relation entre Rational Asset Manager et le registre LDAP. Si vous laissez une valeur à blanc, sa valeur par défaut est rétablie. Si vous voulez qu'une valeur reste non définie (null), entrez un espace (" ").
      Tableau 1. Options de configuration du registre LDAP
      Zone de configuration LDAP Description
      URL du serveur LDAP URL du serveur LDAP ; par exemple, ldap://nom_hôte:389. Pour une communication sécurisée, voir ldaps://nom_hôte:636.
      Nom distinctif de l'utilisateur Nom d'utilisateur permettant de se connecter au registre afin d'y accéder. Entrez le nom distinctif de l'utilisateur, par exemple uid=123456,c=fr,ou=exempleorganisation,o=exemple.com.
      Mot de passe de l'utilisateur Mot de passe de l'utilisateur ci-dessus.
      Propriété d'ID unique de l'utilisateur Nom de la propriété de l'instance objectClass pour l'utilisateur représentant l'ID unique. Par exemple : la propriété serialNumber de (objectClass) person ou la propriété sAMAccountName de (objectClass) user.
      Propriété ID de connexion de l'utilisateur Propriété (objectClass) utilisée par un utilisateur pour se connecter. Même s'il est courant que l'ID unique et l'ID de connexion soient identiques, il est possible que le registre soit configuré de sorte qu'un utilisateur se connecte avec un autre ID (par exemple, avec une adresse électronique). Notez que la propriété ID de connexion doit être la même que celle de l'ID de connexion de l'utilisateur d'administration à l'étape 9.b.
      Propriété Numéro de téléphone de l'utilisateur Propriété (objectClass) représentant le numéro de téléphone de l'utilisateur. Par exemple : la propriété telephonenumber de (objectClass) person.
      Propriété Adresse électronique de l'utilisateur Propriété de (objectClass) représentant l'adresse électronique de l'utilisateur. Par exemple : la propriété mail de (objectClass) person.
      Propriété de nom d'affichage de l'utilisateur Propriété (objectClass) représentant le nom de l'utilisateur à afficher dans l'interface. Par exemple : la propriété (objectClass) person'scn.
      Point de départ de la recherche d'un utilisateur dans LDAP Pour éviter des recherches dans des parties du registre ne contenant pas d'objets utilisateur, entrez la valeur du chemin de la racine depuis l'endroit où débute la recherche. Par exemple, ou=exempleorganisation,o=exemple.com.
      Filtre de recherche d'utilisateur Modèle à utiliser lors de la recherche d'un utilisateur. La variable %v représente le terme recherché qui a été entré dans un champ de texte. La recherche a lieu comme si un caractère générique était ajouté à la suite du terme recherché. Le modèle de recherche par défaut est constitué de manière à trouver toutes les classes d'objet (objectClass) person dont la propriété mail ou la propriété name est identique au terme recherché.
      Point de départ de la recherche d'un groupe dans LDAP Semblable à une recherche de base, il s'agit d'une recherche de base pour la recherche de groupes. Par exemple, ou=listemembre,ou=groupes,o=exemple.com.
      Filtre de recherche de groupe Semblable à un filtre basé sur un utilisateur, il s'agit du filtre pour la recherche de groupes. Par défaut, le terme entré par l'utilisateur est recherché dans groupOfUniqueNames (groupe statique), groupOfNames (groupe LDAP statique), groupOfUrls (groupe LDAP dynamique) et group (groupe défini par Active Directory).
      Modèle d'URL des images Il est courant que les photos des utilisateurs soient stockées ailleurs que dans le registre LDAP. Vous pouvez extraire une image d'un utilisateur à l'aide d'une adresse URL en configurant ce canevas afin que l'image soit extraite en même temps que les informations utilisateur du registre. Dans le canevas, ${propriété} représente une propriété objectClass LDAP de l'objet utilisateur qui va être remplacée au moment de l'extraction de l'image. Par exemple, pour un utilisateur avec uid property=123456, le modèle par défaut https://ImageServer_url/photo/${uid}.jpg donne l'URL https://ImageServer_url/photo/123456.jpg.
    Remarque : Si vous utilisez une authentification LDAP et qu'un nom d'hôte LDAP unique est mappé vers plusieurs adresses IP dans votre configuration réseau, vous devez utiliser la console d'administration WebSphere Application Server pour appliquer la propriété de configuration appropriée et empêcher de possibles arrêts du compte utilisateur LDAP si des utilisateurs se connectent à Rational Asset Manager avec des droits d'accès non valides.

    Une connexion non valide entraîne la validation de l'utilisateur par le serveur avec chaque adresse IP, ce qui peut causer plusieurs échecs. Si vous avez défini un nombre maximal de tentatives de connexion, une tentative non valide peut verrouiller votre compte LDAP. Pour empêcher que cet incident ne se produise, suivez les étapes décrites ici : http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg1PK42672

  10. (Facultatif) Pour configurer Rational Asset Manager afin d'exécuter certains traitements au moyen un exécutable Java distant, dans le but d'améliorer les performances, consultez Configurer des processus distants. Sinon, sélectionnez Utiliser le JRE du serveur Web.
  11. Dans la section Stockage sur disque, configurez un stockage sur disque pour des actifs et des fichiers d'index :
    Remarque : Pour Windows :Pour WebSphere : Si vous utilisez un serveur de fichiers distant ou un cluster WebSphere Application Server, le même compte utilisateur Windows (nom d'utilisateur et mot de passe) doit pouvoir se connecter à chaque machine utilisée par Rational Asset Manager. Dans le cas contraire, Rational Asset Manager ne peut pas enregistrer de fichiers sur différents serveurs de fichiers.
    1. Dans la liste Type de persistance, sélectionnez le mode de stockage des actifs.
    2. Si vous utilisez le système de fichiers comme moyen de stockage des actifs, entrez l'emplacement souhaité dans la zone Dossier de persistance. Par exemple, d:\StockageRAM. Sur un cluster, le dossier de persistance doit se trouver sur une unité partagée à laquelle tous les serveurs du cluster ont accès.
    3. Dans la zone Dossier local, saisissez le chemin complet du dossier où vous souhaitez stocker les données temporaires utilisées par l'application Web ; par exemple, e:\RAMlocalfolder. Ce dossier doit se trouver sur un disque dur local du serveur, et en aucun cas sur une unité partagée. En cas d'installation sur un cluster, chaque noeud du cluster doit avoir son propre dossier de stockage local, non partagé avec les autres noeuds. En cas d'installation de plusieurs serveurs sur le même noeud physique, les serveurs doivent tous utiliser le même dossier de stockage local physique.
    4. Dans la zone Dossier d'index, tapez le chemin complet du dossier où vous souhaitez stocker les index de recherche. Ce dossier doit se trouver sur un disque dur local du serveur, et en aucun cas sur une unité partagée.
    Pour améliorer les performances, vous devez installer les trois dossiers sur des unités physiques différentes.
  12. Indiquez le chemin du serveur Web :
    1. Sous Chemin du serveur Web, entrez :
      http://nom_machine:numéro_port/Racine_contexte_Rational_Asset_Manager
      nom_machine est le nom d'hôte du serveur d'applications, numéro_port est le port de transport HTTP et Racine_contexte_Rational_Asset_Manager est la racine de contexte de l'application Rational Asset Manager.

      Si vous utilisez un équilibreur de charge, indiquez son nom. Si vous utilisez un serveur de proxy Web sans équilibreur de charge, spécifiez le nom du serveur Web. Si vous utilisez IPV6, utilisez le nom d'hôte IPV6 ; une adresse IPV6 ne fonctionnera pas.

      Par exemple, entrez :
      http://www.exemple.com:9080/ram
  13. Indiquez le chemin de documentation :
    1. Dans la zone Chemin du centre de documentation, cochez la case Utiliser la valeur par défaut, si l'application Web d'aide et de documentation se trouve sur le même serveur que l'application de serveur. Sinon, désélectionnez la case Utiliser la valeur par défaut et saisissez l'URL de l'endroit où l'application Web d'aide est installée ; par exemple, http://www.example.com:9080/ram.help. Si vous utilisez IPV6, utilisez le nom d'hôte IPV6 ; une adresse IPV6 ne fonctionnera pas.
    2. Sous Chemin du processus de développement à base d'actifs, si l'application Web de documentation du développement à base d'actifs et du processus de gouvernance se trouve sur le même serveur que l'application de serveur, cochez la case Utiliser la valeur par défaut. Sinon, désactivez la case Utiliser la valeur par défaut et saisissez l'URL de l'endroit où l'application Web est installée ; par exemple, http://www.example.com:9080/ram.process. Si vous utilisez IPV6, utilisez le nom d'hôte IPV6 ; une adresse IPV6 ne fonctionnera pas.
  14. Dans la section Plannings des travaux, configurez la fréquence d'exécution de certains travaux répétitifs :
    • Planning de génération de l'index de statistiques. Il s'agit du planning de mise à jour des informations visibles sur la page Statistiques du référentiel, la page Statistiques (d'un actif) et la page d'accueil.
    • Le planning de traitement des abonnements est le planning de traitement des abonnements à la notification par courrier électronique. En général, il doit s'agir d'une planification pour une exécution une fois par jour.
    • Planning de mise à jour des informations sur les utilisateurs/groupes. Il s'agit du planning déterminant la fréquence de mise à jour des informations à partir du répertoire utilisateur ou de leur écriture dans ce répertoire. Les informations qui figurent dans un registre LDAP ne sont pas mises à jour via ce processus ; toutefois, les mises à jour récentes de ces informations effectuées dans un registre LDAP sont reportées dans les informations utilisateur de Rational Asset Manager.
    • Planning de notification des processus de révision. Il s'agit du planning de traitement des alertes envoyées aux réviseurs pour les avertir que la révision d'un actif leur a été confiée. Par exemple, si vous choisissez un intervalle d'une heure, les notifications concernant tous les nouveaux actifs créés au cours de la dernière heure seront envoyées une fois cette heure écoulée.
    • Planning d'actualisation du cache des artefacts. Il s'agit du planning de régénération du cache des artefacts qui ont été téléchargés.
  15. Pour chaque travail de la section Plannings des travaux, éditez la fréquence des travaux. Cliquez sur Editer, puis faites votre sélection parmi les options suivantes :
    1. Pour exécuter un travail selon un intervalle donné en heures ou minutes, sélectionnez Planifier l'exécution du travail dans un intervalle, entrez un nombre, puis dans la liste déroulante, sélectionnez Minutes ou Heures.
    2. Pour exécuter le travail une fois par jour ou une fois par semaine, sélectionnez Planifier l'exécution du travail à une heure précise, sélectionnez Tous les jours ou un jour donné de la semaine, puis sélectionnez une heure dans la liste déroulante.
  16. Configurer des options de performance :
    1. Dans la section Options de performance, si vous ne voulez pas que Rational Asset Manager génère automatiquement des miniatures d'artefacts que vous attachez à des actifs, désactivez la case cocher Créer automatiquement un contenu présenté à la soumission d'un actif. Cela peut améliorer les performances lors de la soumission des actifs au référentiel. Si cette option est sélectionnée, lorsque vous soumettez un actif, des images d'aperçu sont automatiquement créées pour trois artefacts maximum qui contiennent les extensions suivantes : .doc, .ppt, .pdf, .odt, .odp et .otp.
    2. Pour que la popularité des actifs ne soit pas prise en compte par le moteur de recherche, désélectionnez la case à cocher Activer l'indexation de la popularité. Le fait de désélectionner cette case peut améliorer les performances dans les référentiels de grande taille. En revanche, le moteur de recherche n'utilisera pas des facteurs tels que les téléchargements et les vues de page pour fournir des résultats plus pertinents.
    3. Dans la zone Nombre maximal de sessions par utilisateur, entrez le nombre maximum de sessions qu'un même utilisateur peut ouvrir.
    Ceci peut affecter les performances de votre serveur. Pour plus d'informations, consultez le Guide d'optimisation des performances.
  17. En bas de la page, cliquez sur Sauvegarder.
  18. Redémarrez votre serveur d'applications.
  19. Cliquez sur le lien Aide. (Si l'aide ne s'ouvre pas, vérifiez que vous avez inclus le composant Aide et documentation lorsque vous avez installé le serveur Rational Asset Manager.
  20. Dans le panneau de navigation de l'aide, accédez à Configurer > Configurer Rational Asset Manager > Configuration facultative. Selon votre configuration, vous devriez avoir à configurer d'autres aspects de Rational Asset Manager.

Que faire ensuite

Pour que Rational Asset Manager envoie des notifications par courrier électronique, voir Configuration des paramètres de messagerie électronique.

Si vous utilisez Tomcat, vous pouvez le configurer pour l'authentification LDAP. Pour plus d'informations, voir Configurer l'authentification LDAP pour Tomcat.


Vos commentaires