JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Fusion Middleware Command-Line Usage Guide for Oracle Unified Directory 11g Release 1 (11.1.1)
search filter icon
search icon

Document Information

Preface

1.  Server Administration Commands

2.  Data Administration Commands

3.  LDAP Client Commands

4.  Other Commands

dsjavaproperties

Synopsis

Description

Options

Example

Exit Codes

Location

encode-password

Synopsis

Description

Options

Examples

Exit Codes

Location

ldif-diff

Synopsis

Description

Options

Examples

Exit Codes

Location

Related Commands

ldifmodify

Synopsis

Description

Options

Examples

Exit Codes

Location

Related Commands

ldifsearch

Synopsis

Description

Options

Examples

Exit Codes

Location

Related Commands

make-ldif

Synopsis

Description

Options

Examples

Exit Codes

Locations

Related Commands

5.  General Command-Line Usage Information

dsjavaproperties

The dsjavaproperties command specifies the JVM version and Java arguments that are used by each server command.

Synopsis

dsjavaproperties [options]

Description

The dsjavaproperties command can be used to specify the JVM version and Java arguments that are used by each server command. The JVM and Java arguments for each command are specified in a properties file, located at install-dir/config/java.properties. The properties file is not used unless you run the dsjavaproperties command. If you edit the properties file, you must run dsjavaproperties again for the new settings to be taken into account.

dsjavaproperties can be used to specify (among other arguments) whether a command runs using the JVM in -server mode or -client mode. By default, all client applications run in -client mode, and all of the server utilities run in -server mode. Generally, -server mode provides higher throughput than -client mode, at the expense of slightly longer startup times.

For certain commands (import-ldif, export-ldif, backup, and restore) you can also specify different Java arguments (and a different JVM) depending on whether the command is run in online or offline mode.

If the value of the overwrite-env-java-home property is set to false in the java.properties file, the OPENDS_JAVA_HOME environment variable takes precedence over the arguments specified in the properties file. Similarly, if the value of the overwrite-env-java-args property is set to false in the java.properties file, the OPENDS_JAVA_ARGS environment variable takes precedence over the arguments specified in the properties file.

Options

The dsjavaproperties command accepts an option in either its short form (for example, -Q) or their long form equivalent (for example, --quiet).

-Q, --quiet

Run in quiet mode. Quiet mode does not output progress information to standard output.

-?, -H, --help

Display command-line usage information for the command and exit without making any attempt to stop or restart the server.

-V, --version

Display the version information for the server and exit rather than attempting to run this command.

Example

The following example shows how to use the server commands. You can use the commands on any UNIX, Linux, or Windows system that has at least the Java SE 6 runtime environment installed on its target system. See System Requirements and Certification in Oracle Fusion Middleware Installation Guide for Oracle Unified Directory for more information.

Example 4-1 Modifying a Script

This example shows how to change the export-ldif script to use a maximum JVM heap size of 256 Mbytes when the command is run with the server online.

  1. Edit the install-dir/config/java.properties file and set the export-ldif.online arguments as follows:export-ldif.online.java-args=-client -Xms8m -Xmx256m

  2. Run the dsjavaproperties command for the change to take effect. $ dsjavaproperties The script files were successfully updated. The Oracle Unified Directory command-line utilities will use the java properties specified in the properties file install-dir/config/java.properties

Exit Codes

An exit code of 0 indicates that the operation completed successfully. A nonzero exit code indicates that an error occurred during processing.

Location