The dsj.properties file contains settings for the both
the DSJ client and the DSJ server. All properties have unique names and
are case-sensitive. If only the server is running, the client settings
are ignored. The properties may appear in any order.
The install program creates a file named dsj.defaults,
which contains the default settings. It then makes a copy of that file
named dsj.properties, which is the file that is actually
used by the DSJ client and/or server. If you want to revert to the
default settings, you can copy dsj.defaults over
dsj.properties. The server software also has the same
defaults hard-coded into it, in case any of the properties are missing
from the dsj.properties file.
You may specify an alternate properties file using the command line
option DSJpropertyfile. For example:
dsjserver /DSJpropertyfile=c:\somedir\someother.properties
You may specify any of the properties in the
dsj.properties file on the command line by preceding it
with a slash or hyphen. Specifying a property value during startup
overrides the same property in the dsj.properties file.
In the file, all leading white space (spaces and tabs) are ignored. Lines that begin with a semicolon are considered comments and ignored.
Each property is followed by the equal sign (=) and its value, if any, on a single line. Spaces around the equal sign are ignored.
By default, subdirectories are designated using the dot to reference the current directory, for example:
.\somedir
This is equivalent to just simply:
somedir
You may use either notation.
The following properties are recognized by the DSJ server:
(For information on the DSJ client properties, see dsj.properties Client Reference.)
The directory that contains the .app files which
describe the applications installed on the server. DSJ server looks in
this directory at startup, and processes any .app files it
finds (for more information, see DSJ
server startup). When adding an application, this is the directory
in which the .app file is created.
This property is set through the server Preferences dialog box (see Setting DSJ server preferences).
A subdirectory of the DSJ install directory:
.\applications
The directory that contains the files that comprise the package database:
| File | Description |
|---|---|
| dsj.data | Package database data |
| dsj.toc | Table of contents for package database |
This property is set through the server Preferences dialog box (see Setting DSJ server preferences).
A subdirectory of the DSJ install directory:
.\db
A true/false setting that determines
whether the server starts disabled. When the server starts disabled,
everything is processed during startup as usual, but when that is
finished, the server does not look for client connections. You can
enable the server by going to the Connections page of the server console
and clicking the Allow New Connections button.
By default, Disable is false; the server allows
client connections at startup.
The directory that contains subdirectories which contain installed JREs. For more information, see Installing JREs.
This property is set through the server Preferences dialog box (see Setting DSJ server preferences).
A subdirectory of the DSJ install directory:
.\jres
Whether to limit the number of simultaneous connections to the number specified by the MaximumConnections property.
This property is set through the server Preferences dialog box (see Setting DSJ server preferences).
By default, LimitConnections is false;
connection are unlimited.
The maximum number of simultaneous connections allowed, if
LimitConnections is true. If
LimitConnections is false, this value is ignored.
This property is set through the server Preferences dialog box (see Setting DSJ server preferences).
When connections are limited, the default maximum allowed number of connected is 100.
The maximum recommended number of restarts. Because the server restarts itself by chaining a new process, a stacked process stub is left in memory every time it restarts. Eventually, these stubs will degrade performance.
The server keeps a count of the number of times it has been restarted. Once that number exceeds the maximum recommended number, you will get a warning message when you attempt to restart, advising you that you have exceeded the maximum.
The default maximum recommended number of restarts is 6.
A number that controls how many events are displayed in the Console page of the server console. Each event may have more than one line describing it.
The number does not precisely limit the number of events that are displayed. Instead, the server allows more than the number specified; when the number of events exceeds a certain percentage of the specified value, the server will reduce the display to that number, showing the most recent events.
The default number is 500.
A number that controls how many events are displayed in the Events page of the server console.
The number does not precisely limit the number of events that are displayed. Instead, the server allows more than the number specified; when the number of events exceeds a certain percentage of the specified value, the server will reduce the display to that number, showing the most recent events.
The default number is 500.
The TCP/IP port number the DSJ server listens to for DSJ client requests. The only reason to change this from the default is if you are already using the default port for some other function. Each client must have its DSJServerPort property (see DSJServerPort) match the serverÆs Port setting.
This property is set through the server Preferences dialog box (see Setting DSJ server preferences).
The default port is a registered Well Known Port: 707.
When running on Unix, the Well Known Ports may be restricted to root processes, which means that you must have root privileges to run the DSJ server. (These restrictions do not apply to the client.) If you do not have the necessary privileges, you will have to use another port number, above 1024. The DSJ clients will have to be configured to match.
(For information on port usage and registering ports for your own purposes, visit the Internet Assigned Numbers Authority at http://www.isi.edu/div7/iana/.)
Packages required by the version of the DSJ client that matches the current DSJ server. When the DSJ client contacts the server, it checks the version number of the client, which must match. If they donÆt match, the server will send the required client packages to the client (which the server stores for this purpose) and the client will restart itself.
You should not alter this property.
borland.jax.client;borland.jax.util;borland.jax.protocol;borland.jax.protocol.jax
The directory that contains server group files.
This property is set through the server Preferences dialog box (see Setting DSJ server preferences).
A subdirectory of the DSJ install directory:
.\servers
The directory that contains password and user group files.
This property is set through the server Preferences dialog box (see Setting DSJ server preferences).
A subdirectory of the DSJ install directory:
.\users