Configurer l'adaptateur de bibliothèque de reconnaissance

Après avoir installé l'adaptateur de bibliothèque de reconnaissance (DLA) de Rational Asset Manager, configurez-le en éditant les fichiers de propriétés suivants et en modifiant les variables dans les fichiers script DLA.

Procédure

  1. Editez REP_INSTALL_DLA/bin/RAM_DLA.config.properties : Ce fichier contient les propriétés qui spécifient comment se connecter à Rational Asset Manager, les répertoires à utiliser lors de la création des livres et la méthode de journalisation et de traçage. Vous devez au minimum configurer ou vérifier les valeurs des propriétés suivantes :
    • com.ibm.ram.ccmdb.dla.address : la valeur de cette propriété spécifie le nom d'hôte du serveur où Rational Asset Manager est installé. La valeur par défaut est localhost.
    • com.ibm.ram.ccmdb.dla.port : la valeur de cette propriété spécifie l'adresse d'amorce et le numéro de port JNDI de l'environnement WebSphere Application Server dans lequel s'exécute Rational Asset Manager. La valeur par défaut est 9080.
    • com.ibm.ram.ccmdb.dla.domainName : la valeur de cette propriété spécifie le domaine du serveur sur lequel Rational Asset Manager est installé. Elle est utilisée si l'adaptateur de bibliothèque de reconnaissance ne parvient pas à déterminer la partie nom de domaine du nom d'hôte à partir de l'environnement.
    • com.ibm.ram.ccmdb.dla.securityEnabled : la valeur de cette propriété spécifie si la propriété password décrite plus bas doit être codée dans le fichier de propriétés. Si elle est 'true', la valeur de la propriété password est remplacée par une série d'astérisques et la version codée du mot de passe est ajoutée comme valeur de la propriété com.ibm.ram.ccmdb.dla.password.encoded par l'adaptateur de bibliothèque de reconnaissance. Si elle est 'false', la valeur de la propriété password n'est pas codée. Les valeurs admises sont true et false. La valeur par défaut est true.
    • com.ibm.ram.ccmdb.dla.userid : la valeur de cette propriété spécifie le nom d'utilisateur que l'adaptateur DLA fournit lors de l'utilisation de l'API Rational Asset Manager. Cet utilisateur doit recevoir un rôle (administrateur ou rôle personnalisé) l'autorisant à interroger les actifs souhaités dans Rational Asset Manager. Il n'y a pas de valeur par défaut.
    • com.ibm.ram.ccmdb.dla.password : la valeur de cette propriété spécifie le mot de passe de l'utilisateur indiqué par la propriété com.ibm.ram.ccmdb.dla.userid. Il n'y a pas de valeur par défaut.
    • com.ibm.ram.ccmdb.dla.ramQuery : la valeur de cette propriété spécifie la requête utilisée par l'adaptateur DLA de Rational Asset Manager lors de l'extraction d'actifs. Si aucune requête n'est spécifiée, tous les actifs gérés dans Rational Asset Manager sont découverts.
    • com.ibm.ram.ccmdb.dla.url : la valeur de cette propriété spécifie l'URL du serveur Rational Asset Manager utilisé pour la découverte des actifs.
    Consultez le fichier RAM_DLA.config.properties pour obtenir la liste complète des propriétés et leur description.
  2. Editez REP_INSTALL_DLA/bin/DLA_FileTransfer.properties. Ce fichier contient les propriétés qui spécifient comment se connecter au serveur de transfert de fichiers, les répertoires à utiliser lors du transfert des livres et la méthode de journalisation et de traçage. Vous devez configurer les propriétés suivantes pour que l'adaptateur de bibliothèque de reconnaissance puisse effectuer un transfert de fichiers :
    • com.ibm.management.soa.dla.filetransfer.host : la valeur de cette propriété spécifie le nom d'hôte ou l'adresse IP de l'ordinateur cible du transfert de fichiers (l'ordinateur auquel seront envoyés les livres de l'adaptateur de bibliothèque de reconnaissance).
    • com.ibm.management.soa.dla.filetransfer.userid : la valeur de cette propriété spécifie le nom d'utilisateur permettant d'accéder à l'ordinateur cible. Cet utilisateur doit bénéficier du droit d'écriture sur les fichiers dans le répertoire cible. En cas d'utilisation de FTP avec confirmation, l'utilisateur doit aussi bénéficier du droit de lire et de supprimer les fichiers dans le répertoire cible.
    • com.ibm.management.soa.dla.filetransfer.password : la valeur de cette propriété spécifie le mot de passe de l'utilisateur qui a accès à l'ordinateur cible.
    Il est possible que vous deviez changer d'autres valeurs dans le fichier de propriétés de transfert de fichiers si certaines valeurs par défaut (par exemple, le répertoire sur l'ordinateur cible) ne vous conviennent pas. Consultez le fichier DLA_FileTransfer.properties pour obtenir la liste complète des propriétés et leur description.
    Remarque : Si des correctifs sont appliqués, il est possible que les fichiers RAM_DLA.config.properties et DLA_FileTransfer.properties soient remplacés. Dans ce cas, vous devez toujours utiliser la version la plus récente avec la nouvelle version du code. Pensez à faire une sauvegarde des fichiers de propriétés de l'adaptateur de bibliothèque de reconnaissance afin de transférer ensuite vos réglages existants dans les nouvelles versions de ces fichiers.
  3. Editez les fichiers script DLA Rational Asset Manager.
    • Dans le cas de Windows, éditez REP_INSTALL_DLA\bin\RAM_DLA.bat et, pour la variable WAS_BIN, spécifiez l'emplacement du répertoire bin de WebSphere Application Server ; par exemple, WAS_BIN=C:\Program Files\IBM\WebSphere\AppServer.
    • Dans le cas de Linux, AIX ou Solaris, éditez REP_INSTALL_DLA/bin/RAM_DLA.sh et, pour la variable WAS_BIN, spécifiez l'emplacement du répertoire bin de WebSphere Application Server ; par exemple, WAS_BIN=/opt/IBM/WebSphere/AppServer.
    S'il est prévu d'utiliser le protocole SFTP pour le transfert des livres de l'adaptateur de bibliothèque de reconnaissance lorsque celui-ci est installé sur Linux, AIX ou Solaris, effectuez les étapes suivantes afin de configurer SSH :
    1. Assurez-vous que SSH est installé à la fois sur l'ordinateur source et l'ordinateur cible.
    2. Connectez-vous à l'ordinateur source en utilisant comme identité le nom d'utilisateur prévu pour exécuter l'adaptateur de bibliothèque de reconnaissance, puis générez les clés publique et privée. Sur la plupart des systèmes, vous pouvez utiliser la commande ssh-keygen à cet effet. Appuyez sur Entrée lorsque vous êtes invité à entrer une phrase de passe (afin de simplifier la configuration).
    3. Sur l'ordinateur cible, connectez-vous avec le nom d'utilisateur que l'adaptateur de bibliothèque de reconnaissance doit utiliser lorsqu'il accède à cet ordinateur. Ajoutez le contenu de la clé publique de l'ordinateur source dans le fichier ~/.ssh/authorized_keys.
      Remarque : Si vous avez créé les clés en utilisant une phrase de passe, utilisez les commandes ssh-agent et ssh-add pour éviter qu'elle ne soit demandée. Consultez l'URL suivante pour plus d'informations : http://www.ibm.com/developerworks/library/l-keyc2/.
    4. Vérifiez la connectivité en utilisant la commande sftp sur l'ordinateur source pour vous connecter à l'ordinateur cible. Aucune demande de mot de passe ou de phrase de passe ne doit s'afficher. Par exemple : sftp user@serveurcible.com.
    Remarque : Lorsque SFTP est utilisé, une valeur est toujours requise pour la propriété password dans le fichier DLA_FileTransfer.properties. Cependant, cette valeur n'est pas utilisée.
    Si vous ne générez pas les clés publique et privée selon les instructions qui précèdent, l'adaptateur de bibliothèque de reconnaissance ne pourra pas transférer les livres en utilisant le protocole SFTP.

Commentaires