Manually editing the catdv.properties File
The operation of the server, including how many client connections are permitted, is controlled by a license key or registration code stored in the catdv.properties file. The easiest way to edit this file is using the CatDV Server Control Panel as described earlier. However, you can also edit the catdv.properties file manually if you prefer (or if you are using Linux and configuring the CatDV Server via the command line).
You will have been mailed four lines of text such as the following example. (Please contact sales@squarebox.co.uk if you do not have your registration code.)
reg.user = Trial reg.code = OGOP-JZXL-G1TD-65SI-7F7B-YZ3X-GVJD-6YQQ reg.expires = Jun 30, 2005 reg.info = Workgroup Server for MySQL (5 clients) with Live HTML Publisher
Open the catdv.properties file in the CatDV server directory with a text editor (or better still, using the CatDV Control Panel), then copy and paste these lines in to the file, replacing the example lines included in the file as distributed.
This file also contains other configuration information, most notably the connection URL for the database. You need to make sure the value of catdv.database is correct for your database. Comment out or delete the mysql line and uncomment the oracle line, editing it to include your secret password that you entered earlier.
The catdv.properties file also contains configuration for the Live HTML Publisher but you can safely ignore these lines if you do not use the HTML Publisher. If you make any changes to the catdv.properties configuration file you need to stop and restart the workgroup server for the changes to take effect.
CatDV server configuration parameters
There are two ways of specifying configuration parameters such as the database URL to use: via the catdv.properties file and by specifying a system property in the launchServer batch file with –Dproperty=value. You should avoid trying to set the same property in two different ways as that is likely to be confusing. For reference though, the system property setting takes precedence.
Normally you should use the CatDV Control Panel (see 3.6) to edit these settings and are unlikely ever to need to edit the catdv.properties file by hand.
The following properties are used:
catdv.logfile | Filename of server log file to create |
catdv.properties | Filename of properties file to load |
catdv.rmiport | Server port to use (defaults to 1099) |
java.rmi.server.hostname | The server’s own IP address (if the machine has multiple network adapters you need to specify which IP address clients will use to connect to the CatDV Server) |
catdv.server | The RMI service name |
catdv.database | Database URL to use |
catdv.debug | Set to true (and restart the server) to display additional debug information in the server.log file |
catdv.allowAnonymous | Set to true if you are using Workgroup edition clients connecting to the Enterprise server and want to allow them to create and edit catalogs in the default system group without logging on to the server. |
catdv.terminationFile | Filename of a file which, if present, signals the server should terminate |
catdv.jdbc.class | Java class name of the the JDBC driver class |
reg.user | Registered user name (license details) |
reg.code | Registration code (license details) |
reg.info | Human-readable description of license (license details) |
reg.expiry | Human-readable description of license (license details) |
reg.webuser | Registered user name (if different from reg.user) for the WebClient software license |
reg.webcode | Registration code for the WebClient software license |
preview.dir | Filename of preview root directory (HTML Publisher) |
preview.url | Corresponding URL (HTML Publisher) |
media.dir | Filename of media root director (HTML Publisher) |
media.equiv | Equivalent media path prefix (HTML Publisher) |
media.url | Corresponding URL (HTML Publisher) |
timestamp.format | How dates and times are formatted (HTML Publisher) |
web.user | Which CatDV user the web publisher uses to access Enterprise server. Determines which catalogs will be accessible via web interface (HTML Publisher) |
catdv.fields | Which field set to use (Web Client) |
catdv.useRoles | Set to true when working with CatDV 9 Enterprise clients or false when using CatDV 8 clients. |