Changing the system-wide properties by using the file

You can set persistent system-wide properties in a text file called, which must be placed in the directory specified by the derby.system.home property.

There is one file per system, not one per database. The file must be created in the system directory. In a client/server environment, that directory is on the server. (For more information about a Derby system and the system directory, see Derby system.)

Derby does not:

Instead, you must create, write, and edit this file yourself.

The file should be in the format created by the method.

The following is the text of a sample properties file:

Properties set this way are persistent for the system until changed, until the file is removed from the system, or until the system is booted in some other directory (in which case Derby would be looking for in that new directory). If a database is removed from a system, system-wide properties do not "travel" with the database unless explicitly set again.

Related concepts
Changing the system-wide properties programmatically
Verifying system properties