The com.tivoli.pd.jcfg.PDJrteCfg utility configures the Java™ Runtime Environment component
for Tivoli® Access Manager.
This utility enables Java applications
to use the Tivoli Access
Manager policy and authorization servers.
Purpose
Important: If you are
using the WebSphere® Application Server, Network Deployment product, run the pdjrtecfg utility first
on the deployment manager. Then, run the script on the other nodes
in the cell.
Steps
To run the pdjrtecfg
script, perform the following steps:
- Log into your system with a user profile and the all object (*ALLOBJ)
authority.
- On the command line, enter the Start Qshell (STRQSH) command.
- Change to the /bin subdirectory of WebSphere Application Server. For example:
cd app_server_rootND/bin
- Run the script. For example:
pdjrtecfg -action config -profileName myprofile
-host mypolicy.mycompany.com -config_type full
The previous
example was split onto multiple lines for illustrative purposes only.
Syntax
The following
syntax diagram shows the usage of the pdjrtecfg script:
pdjrtecfg
-action config
-profileName profile_name
-host policy_server_name
-config_type { full | standalone }
-cfgfiles_path configuration_file_path
-action unconfig
-profileName profile_name
Parameters
- -action {config|unconfig}
- Specifies the 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.
- -cfgfiles_path
- Specifies where the generated configuration files will be placed.
Note: This parameter is required.
- -config_type {full|standalone}
- Specifies the configuration type of Java Runtime
Environment for Tivoli Access
Manager. Specify full or standalone with this argument.
This option is required.
- -host policy_server_host
- Specifies the 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
- Notifies Tivoli Access
Manager Runtime for Java that
the WebSphere Application Server version is being configured so it is not necessary to perform
certain steps such as copying the Java security
jar files and PD.jar file since they were already placed in the appropriate
directory by the WebSphere Application Server installer.
- -profileName
- Specifies the name of the WebSphere Application Server profile. If not specified, the default profile is used.
- Specifies the fully qualified path to the Java runtime (such as the directory ending in
jre). If this parameter is not specified, the home directory for the
jre in the PATH statement is used. If the home directory for the jre
is not in the PATH statement, this utility can create an incorrect
parameter in the output files.
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.
You can install
more than one Java Runtime Environment
(JRE) on a given machine. The pdjrtecfg command can be used
to configure the Tivoli Access
Manager Java Runtime Environment
component independently for each of the JRE configurations.