10.1 Using iManager to Configure the Java Environment Parameters
1 Click to display the Identity Manager Administration page.
2 Open the properties for the driver set whose parameters you want to configure:
2a In the Administration list, click Identity Manager Overview.
2b If the driver set is not listed on the Driver Sets tab, use the Search In field to search for and display the driver set.
2c Click the driver set to open the Driver Set Overview page.
2d Click the Driver Set menu, then click Edit Driver Set properties.
3 Click Misc to display the property page that contains the Java environment parameters.
4 Modify the following settings as desired:
Classpath Additions: Specify additional paths for the JVM to search for package (.jar) and class (.class) files. Using this parameter is the same as using the java -classpath command.
When entering multiple class paths, separate them with a semicolon (;) for a Windows JVM and a colon (:) for a UNIX/Linux JVM.
JVM Options: Specify additional options to use with the JVM. Refer to your JVM documentation for valid options.
DHOST_JVM_OPTIONS is the corresponding environment variable. It specifies the arguments for JVM 1.2. For example:
-Xnoagent -Xdebug -Xrunjdwp: transport=dt_socket,server=y, address=8000 Each option string is separated by whitespace. If an option string contains whitespace, then it must be enclosed in double quotes.
The driver set attribute option has precedence over the DHOST_JVM_OPTIONS environment variable. This environment variable is tacked on to the end of driver set attribute option.
Initial Heap Size: Specify the initial (minimum) heap size available to the JVM. Increasing the initial heap size can improve startup time and throughput performance. Use a numeric value followed by G, M, or K. If no letter size is specified, the size defaults to bytes. Using this parameter is the same as using the java -Xms command.
DHOST_JVM_INITIAL_HEAP is the corresponding environment variable. It specifies the initial JVM heap size in decimal number of bytes. It has precedence over the driver set attribute option.
Refer to your JVM documentation for information about the JVM's default initial heap size.
Maximum Heap Size: Specify the maximum heap size available to the JVM. Use a numeric value followed by G, M, or K. If no letter size is specified, the size defaults to bytes. Using this parameter is the same as using the java -Xmx command.
DHOST_JVM_MAX_HEAP is the corresponding environment variable. It specifies the maximum JVM heap size in decimal number of bytes. It has precedence over the driver set attribute option.
Refer to your JVM documentation for information about the JVM's default maximum heap size.
5 Click OK to save your changes.
6 Restart eDirectory to apply the changes.
10.2 Using Designer to Configure the Java Environment Parameters
1 Open your project in the Modeler.
2 Right-click the driver set icon , then click Properties > Java.
3 Modify the following settings as desired:
Server: If the driver set is associated with multiple Identity Manager servers, select the server whose JVM parameters you want to configure.
Classpath Additions: Specify additional paths for the JVM to search for package (.jar) and class (.class) files. Using this parameter is the same as using the java -classpath command.
When entering multiple class paths, separate them with a semicolon (;) for a Windows JVM and a colon (:) for a UNIX/Linux JVM.
JVM Options: Specify additional options to use with the JVM. Refer to your JVM documentation for valid options.
DHOST_JVM_OPTIONS is the corresponding environment variable. It specifies the arguments for JVM 1.2. For example:
-Xnoagent -Xdebug -Xrunjdwp: transport=dt_socket,server=y, address=8000 Each option string is separated by whitespace. If an option string contains whitespace, then it must be enclosed in double quotes.
The driver set attribute option has precedence over the DHOST_JVM_OPTIONS environment variable. This environment variable is tacked on to the end of driver set attribute option.
Initial Heap Size: Specify the initial (minimum) heap size available to the JVM in bytes.
Increasing the initial heap size can improve startup time and throughput performance. Using this parameter is the same as using the java -Xms command.
DHOST_JVM_INITIAL_HEAP is the corresponding environment variable. It specifies the initial JVM heap size in decimal number of bytes. It has precedence over the driver set attribute option.
Refer to your JVM documentation for information about the JVM's default initial heap size.
Maximum Heap Size: Specify the maximum heap size available to the JVM. Use a numeric value followed by G, M, or K. If no letter size is specified, the size defaults to bytes. Using this parameter is the same as using the java -Xmx command.
DHOST_JVM_MAX_HEAP is the corresponding environment variable. It specifies the maximum JVM heap size in decimal number of bytes. It has precedence over the driver set attribute option.
Refer to your JVM documentation for information about the JVM's default maximum heap size.
Configuring Java Environment Parameters 59 4 Click OK to save your changes.
5 To deploy the changes into your Identity Vault, right-click the driver set icon , click Live >
Deploy, and follow the deployment prompts.
6 Restart eDirectory to apply the changes.
11
Reassociating a Driver Set Object with a Server 61
11
Reassociating a Driver Set Object with a Server
A driver set object is associated with a server. If the association becomes invalid for some reason, it is indicated by one of the following:
When upgrading eDirectory on your Identity Manager server, you get the error UniqueSPIException error -783.
No server is listed in the Servers tab on the driver or driver set.
A server is listed next to the driver in the Identity Manager Overview screen, but the name is garbled text.
To resolve this issue, you must disassociate the driver set object and the server, and then reassociate them:
1 In iManager, click to display the Identity Manager Administration page.
2 In the Administration list, click Identity Manager Overview.
3 In the Search in field, specify the fully distinguished name of the container where you want to start searching and then click , or click to browse for and select the container in the tree structure.
4 Click the driver set object that you want to reassociate with a server.
5 In the Overview tab, click Servers.
6 Click Remove server.
7 Click Add server.
Be aware that when you reassociate a driver set object with a server, all drivers are disabled, and all passwords are cleared.
12
Using the DirXML Command Line Utility 63
12
Using the DirXML Command Line Utility
The DirXML Command Line utility allows you to use a command line interface to manage the driver.
The primary use of this utility is to allow you to create platform-specific scripts to manage the driver.
The utility and scripts are installed on all platforms during the Identity Manager installation. The utility is installed to the following locations:
Windows: \Novell\Nds\dxcmd.bat
UNIX/Linux: /usr/bin/dxcmd
There are two different methods for using the DirXML Command Line utility:
Section 12.1, “Interactive Mode,” on page 63