The Tivoli Access Manager com.tivoli.pd.jcfg.PDJrteCfg utility
Purpose
Configures the Access Manager Java Runtime Environment component, which allows Java applications to use Tivoli Access Manager security.
Syntax
java com.tivoli.pd.jcfg.PDJrteCfg -action {config | unconfig} \ -cfgfiles_path configuration_file_path \ -host policy_server_host \ -was [-java_home jre_path]
Parameters
- -action {config|unconfig}
- Action to be performed. Actions include:
- config
- Use to configure the Access Manager Java Runtime Environment component.
- unconfig
- Use to reconfigure the Access Manager Java Runtime Environment component.
- -host policy_server_host
- Policy server host name.
Valid values for policy_server_host include any valid IP host name.
Examples include:
host = libra
host = libra.dallas.ibm.com
- -java_home jre_path
- Fully-qualified path to the JDK to be configured or reconfigured. If -java_home is not specified, the current (default) JDK is used.
For example: -java_home /usr/lpp/java/J1.3
- -was
- Specifies to configure in a WAS environment (as opposed to a Tivoli Access Manager environment).
The following examples demonstrate correct syntax. Node1 is the name by which the node that contains the administrative server is administered.
- Import operation
- XMLConfig -adminNodeName Node1 -import import.xml
- Full export operation
- XMLConfig -adminNodeName Node1 -export export.xml
- Partial export operation
- XMLConfig -adminNodeName Node1 -export export.xml -partial imput.xml
Comments
This command copies Tivoli Access Manager Java libraries to a library extensions directory that exists for a Java runtime that has already been installed on the system.
Using this command does not overwrite JAR files that already exist in the jre_home\lib\ext directory, except the PD.jar file, which is overwritten if the file exists.
You can install more than one JRE on a given machine. The pdjrtecfg command can be used to configure the Access Manager Java Runtime Environment component independently to each of the JREs.
Example
${JAVA_HOME}/bin/java -Dfile.encoding=ISO8859-1 \ -Dws.output.encoding=CP1047 \ -Xnoargsconversion \ -Dpd.home=${WAS_HOME}/java/jre/PolicyDirector \ -cp ${WAS_HOME}/java/jre/lib/ext/PD.jar \ com.tivoli.pd.jcfg.PDJrteCfg -action config \ -cfgfiles_path ${WAS_HOME}/java/jre \ -host gary.us.ibm.com \ -was