Configuring the discovery library adapter

After installing the Rational® Asset Manager discovery library adapter (DLA), configure the discovery library adapter by editing the following properties files and also modify variables in the DLA script files.

Procedure

  1. Edit DLA_INSTALL_DIR/bin/RAM_DLA.config.properties: This file contains properties that specify how to connect to Rational Asset Manager, the directories to use when creating books, and how to perform logging and tracing. At a minimum, configure or verify the values for the following properties:
    • com.ibm.ram.ccmdb.dla.address: The value of this property specifies the host name of the server where Rational Asset Manager is installed. The default value is localhost.
    • com.ibm.ram.ccmdb.dla.port: The value of this property specifies the bootstrap address and JNDI port number of the WebSphere® Application Server environment that Rational Asset Manager is running on. The default value is 9080.
    • com.ibm.ram.ccmdb.dla.domainName: The value of this property specifies the domain of the server Rational Asset Manager is installed on. This property is used if the discovery library adapter is unable to determine the domain name portion of the host name from the environment.
    • com.ibm.ram.ccmdb.dla.securityEnabled: The value of this property specifies if the password property described below should be encoded in the properties file. If set to true, the password value is replaced with *'s and an encoded version of the password is added as the value of com.ibm.ram.ccmdb.dla.password.encoded property by the discovery library adapter. If set to false, the password value is not encoded. The supported values are true and false. The default value is true.
    • com.ibm.ram.ccmdb.dla.userid: The value of this property specifies the user name that the DLA provides when using the Rational Asset Manager API. This user must be assigned a role (either the administrator or custom defined role) that can query the desired Rational Asset Manager assets. There is no default value.
    • com.ibm.ram.ccmdb.dla.password: The value of this property specifies the password of the user specified by the com.ibm.ram.ccmdb.dla.userid property. There is no default value.
    • com.ibm.ram.ccmdb.dla.ramQuery: The value of this property specifies the query that the Rational Asset Manager DLA uses when retrieving assets. If no query is specified, then all assets in Rational Asset Manager are discovered.
    • com.ibm.ram.ccmdb.dla.url: The value of this property specifies the URL of the Rational Asset Manager server to discover the assets.
    Refer to the RAM_DLA.config.properties file for the complete list of properties and a description of each property.
  2. Edit DLA_INSTALL_DIR/bin/DLA_FileTransfer.properties. This file contains the properties that specify how to connect to the file transfer server, the directories to use when transferring books, and how to perform logging and tracing. You must configure the following properties for the discovery library adapter to perform a file transfer:
    • com.ibm.management.soa.dla.filetransfer.host: The value of this property specifies the host name or IP address of the target computer where discovery library adapter books will be sent by file transfer.
    • com.ibm.management.soa.dla.filetransfer.userid: The value of this property specifies the user name that is used to access the target computer. This user must be granted the authority to write files to the target directory. If using FTP with confirmation, the user also requires authority to read and delete files in the target directory.
    • com.ibm.management.soa.dla.filetransfer.password: The value of this property specifies the password of the user who can access the target computer.
    Changing the value of other file transfer properties might be required if you do not want to use the default values in the properties file such as the default directory on the target computer. See the DLA_FileTransfer.properties file for the complete list of properties and a description of each property.
    Note: If patches are applied, the RAM_DLA.config.properties and DLA_FileTransfer.properties files might be overwritten. If properties files are replaced, you should always use the newer version with the new version of code. You should back up the discovery library adapter properties files so you can migrate existing settings into new versions of the properties files.
  3. Edit the Rational Asset Manager DLA script files
    • For Windows, edit DLA_INSTALL_DIR\bin\RAM_DLA.bat and set WAS_BIN to the location of the WebSphere Application Server bin directory; for example, WAS_BIN=C:\Program Files\IBM\WebSphere\AppServer.
    • For Linux, AIX®, or Solaris, edit DLA_INSTALL_DIR/bin/RAM_DLA.sh and set WAS_BIN to the location of the WebSphere Application Server bin directory; for example, WAS_BIN=/opt/IBM/WebSphere/AppServer.
    If the SFTP protocol will be used to file transfer discovery library adapter books when the discovery library adapter is installed on Linux, AIX, or Solaris, you must perform the following steps to configure SSH:
    1. Ensure that SSH is installed on both the source and target computers.
    2. Log on to the source computer as the user who will run the discovery library adapter and generate public and private keys. On most systems, this can be accomplished using the ssh-keygen command. Press Enter when prompted for a passphrase for the easiest configuration.
    3. On the target computer, log on as the user that the discovery library adapter uses when accessing the target computer. Add the contents of the public key from the source computer into the ~/.ssh/authorized_keys file.
      Note: If you created the keys using a passphrase, use the ssh-agent and ssh-add commands to prevent a prompt for the passphrase. See the following URL for more information: http://www.ibm.com/developerworks/library/l-keyc2/.
    4. Check connectivity by using the sftp command on the source computer to connect to the target computer. No password or passphrase prompt should be presented. For example: sftp user@targetserver.com.
    Note: When SFTP is used, a value for the password property is still required in the DLA_FileTransfer.properties file. However, the value of the password property is not used.
    If you do not generate public and private keys as described above, the discovery library adapter cannot transfer books using the SFTP protocol.

Feedback