'\" t
.\"     Title: dsjavaproperties
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: April, 2013
.\"    Manual: Tools Reference
.\"    Source: OpenDJ 2.5.0
.\"  Language: English
.\"
.TH "DSJAVAPROPERTIES" "1M" "April, 2013" "OpenDJ 2.5.0" "Tools Reference"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dsjavaproperties \- apply OpenDJ Java home and JVM settings
.SH "SYNOPSIS"
.ad l
.hy 0
.HP \w'\fBdsjavaproperties\fR\ 'u
\fBdsjavaproperties\fR [\-Q] [\-V] [\-H] [\fIproperties_file\fR]
.ad
.hy
.SH "DESCRIPTION"
.PP
This utility can be used to change the Java arguments and Java home that are used by OpenDJ server commands and tools\&.
.PP
If
\%\%\fIproperties_file\fR
is given and denotes a regular file readable by the user ldapd, it gets copied to
\%\fI$INSTANCE_ROOT\fR\%/config/java\&.properties\&. It allows users, which have the "OpenDJ Admin" profile assigned, to change the content of the file, even if they are not allowed to explicitly
\fBsu\fR(1M)
to the owner of the
\%\fI$INSTANCE_ROOT\fR
or change the ACLs of this file\&.
.PP

\%\fBdsjavaproperties\fR
reads
\%\fI$INSTANCE_ROOT\fR\%/config/java\&.properties
and persists all changes, so that other OpenDJ utilities are able to use them\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.PP
Changes are
\fInot\fR
propagated to tools already running\&.
.sp
.RE
.PP
The file is a simple
\fBJava property file\fR\& [1]\&. All honored keys or key patterns are explained in the
\%\fI$INSTALL_ROOT\fR\%/tmpl_instance/config/java\&.properties
example\&.
.SH "OPTIONS"
.PP
The following options are supported\&.
.PP
\%\fB\-Q, \-\-quiet\fR
.RS 4
Use quiet mode (do not write progress information to standard output)\&.
.RE
.PP
\%\fB\-V, \-\-version\fR
.RS 4
Display version information\&.
.RE
.PP
\%\fB\-H, \-\-help\fR
.RS 4
Display usage information\&.
.RE
.SH "EXAMPLES"
.sp
.if n \{\
.RS 4
.\}
.nf
$ \%\fBdsjavaproperties\fR
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
  
The operation was successful\&.  The server commands will use the java 
arguments and java home specified in the properties file located in
$INSTANCE_ROOT/config/java\&.properties
.fi
.if n \{\
.RE
.\}
.SH "ENVIRONMENT VARIABLES"
.PP
See
\fBopendj\fR(5)\&.
.SH "EXIT STATUS"
.PP
\%\fB0\fR
.RS 4
The command completed successfully\&.
.RE
.PP
\%\fB> 0\fR
.RS 4
An error occurred\&.
.RE
.SH "FILES"
.PP
\%\fI$INSTANCE_ROOT\fR\%/config/java\&.properties
.RS 4
Contains the properties to persist\&.
.RE
.PP
\%\fI$INSTALL_ROOT\fR\%/tmpl_instance/config/java\&.properties
.RS 4
An example of a java\&.properties file incl\&. documentation and examples\&.
.RE
.SH "SEE ALSO"
.PP

\fBopendj\fR(5)\&.
.SH "NOTES"
.IP " 1." 4
Java property file
.RS 4
\%\%http://docs.oracle.com/javase/7/docs/api/java/util/Properties.html#load%28java.io.Reader%29
.RE