Installing and Configuring the eFORMz Service on Windows

Overview

The eFORMz service is named eFORMz_Service Manager_64. This service runs the eFORMz Director processes and the eFORMz web server, if eFORMz is configured to receive web service requests. This service is not automatically installed with eFORMz.

Requirements

Before installing the eFORMz service, you must have successfully installed eFORMz. You must also have Java 1.8 or later installed.

Procedure

Install the eFORMz Service

Complete the following steps to install the eFORMz service:

1. Open a Command Prompt window as Administrator.
2. Go to:
   1. C:\Minisoft\eFORMz_6
3. Enter the following command:

   1. jsl_64.exe -install jsl_ServiceManager_64.ini

Notes on Running eFORMz as a Service

1. Running eFORMz as a service:

   1. Director processes start automatically and run in the background.
   2. Operates like other Windows services (e.g., Print Spooler).

2. Running the Director from Director Toolkit:

   1. Does not require service installation.
   2. All processing stops when the Director Toolkit window is closed.

Authenticate the eFORMz Service

1. Default Authentication:

   1. The eFORMz service authenticates to Windows as Local System by default.

2. Using Network Resources:

   1. If eFORMz interacts with network resources (e.g., network folders, remote databases, email servers), update the service properties to authenticate as Network Service.

3. Built-in Authentication:

   1. Both Local System and Network Service are built-in Windows authentications.

4. Security Policies:

   1. Some environments may require eFORMz to run under a specific ID, configurable in the Service Properties window.

Configure Startup Parameters

Director Configuration File:

1. The Director runs a configuration .cfg file specifying:
   1. Queues to watch for data to process.
   2. The associated eFORMz .efz files, to process them with.
   3. How to output the results.
2. Default configuration file: LocalPM.cfg.

Steps to Define while Configuration File the eFORMz service automatically starts: 

1. 1. Open a Command Prompt window and navigate to
      1. C:\Minisoft\eFORMz_6.
   2. Run Director_Configure.exe and log in using:
      1. ID: minisoft
      2. Password: password.
   3. Click Configure Startup Parameters.
   4. Enter the desired configuration file:
      1. Example for a single file: LocalPM.cfg.
      2. Example for multiple files: LocalPM.cfg File2.cfg (separate file names with a space).
      3. To make a file accessible via web requests, prefix it with -ac:
         1. Example: LocalPM.cfg -ac accessible.cfg.
   5. Click OK > Exit > Yes.
   6. Close all eFORMz windows and restart the eFORMz service to apply changes.

Confirm the Service is Running

Confirming Service Status in Director Toolkit:

1. If the service is running:
   1. "The Director is running under the Service Manager" is displayed on the Director tab.
2. If the service is not running:
   1. "The Director is running" indicates that processing will stop if the Director Toolkit is closed.
   2. "The Director is not running" indicates no active processing.

Warning: The following situations produce unpredictable results:

1. Starting the Service with Director Already Running:
   1. Produces unpredictable results.
   2. Always close the Director Toolkit before starting or restarting the eFORMz service.
2. Multiple Instances of eFORMz:
   1. Running multiple eFORMz instances under one or more IDs on the same system can cause issues.
3. Shared Data Files:
   1. Accessing the same data files with multiple instances of eFORMz across different systems leads to unpredictable results.

Assistance

If any further assistance is needed, please contact our Support team.

Related Articles