Windows Services Application
The dm_connector_svc.exe service application is a launcher/wrapper for Documaker Connector. This application is set up to run as a Windows Service. It can perform the service installation itself or uninstall the service by being run from the command line. If run from the command line, include one of these parameters:
| install | Installs the Windows Service and terminates. |
| uninstall | Removes the Windows Service and terminates. |
| console | Runs the java application as a console application, for troubleshooting purposes. |
Here is an example:
dm_connector_svc.exe install
If the program is run without parameters, it must run as a Windows Service.
The dm_connector_svc.properties File
The application looks for a dm_connector_svc.properties file and uses the contents to load and run a java application as a service. The service configuration is read from the file:
dm_connector_svc.properties
The properties in this file and the default values provided in the case of Documaker Connector are shown in this table:
| Property Name | Description |
|---|---|
| Oracle Documaker Connector Service Wrapper Properties Property Name Prefix: service. | |
| .debugging | Set to one (1) to enable debug-level logging to the file dm_connector_svc-service.log. |
| .jvm.args.length | Count of service.jvm.args.# arguments. The properties starting with the service.jvm.args prefix define the parameters passed to the JVM when it is created. These are not the parameters passed to the main() function in Java (see the service.main prefix items). |
| .jvm.args.1 | First argument to the JVM. |
| .jvm.args.2 | Second argument to the JVM. |
| .startup.class | Path to the Java class which contains the main() function called to start the Java application. |
| .path | Directories prepended to the PATH for the service session. The main use of this is to define the JVM used to run the program. |
| .main.args.length | Count of service.main.args.# arguments. The properties starting with the service.main prefix define the parameters that are passed to the Java main function. |
| .main.args.1 | First argument to the main Java class. |
Running Multiple Services
You can set up multiple copies of the executable service program, dm_connector_svc.exe, in the same directory under different names with separate properties file names and they will not interfere with one another. The different copies can run the same or different Java programs, but in this case you would set them to run Documaker Connector. You can use this to set up multiple copies of Documaker Connector running as services for different purposes and with different configurations.
To set up multiple copies, duplicate both the executable service program, dm_connector_svc.exe, and the matching properties file, dm_connector_svc.properties.
Rename the duplicate copies with any name you like, but the two root file names, such as dm_connector_svc, must be identical. For example, name the duplicate copies myservice.exe and myservice.properties. Inside the copied properties file, (myservice.properties), change the Windows Service name and description which will be registered when the service is installed:
service.name=My Dmkr Connector
service.description=My second copy of the Documaker Connector
Also set the name of the Connector properties file that contains your configuration as the second argument to the program:
service.jvm.args.2=-Dconfig\=dmkr-ucm-conn.properties
The \= (backslash and equal sign) is required to preserve the = (equal sign) when the file is processed.