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
- 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.
- 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.
- 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:- Ensure that SSH is installed on both the source and target computers.
- 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.
- 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.
- 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.