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
- 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.
- 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.
- 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 :
- Assurez-vous que SSH est installé à la fois sur l'ordinateur source et l'ordinateur cible.
- 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).
- 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/.
- 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.