Running the Micro Focus Connect Server

You can run the Micro Focus Connect server:

  • Manually, by executing start-connect.bat
  • Automatically, by configuring a Microsoft Windows service to start the Micro Focus Connect server each time your system starts

Both of these approaches make use of the configuration file local.properties, which contains parameters needed to start the Micro Focus Connect server. This file is required if you start the server manually; it is optional if you start the server as a Microsoft Windows service. Because of this, it is considered a best practice to configure Micro Focus Connect options in the local.properties file, as described in the following section.

 

Configure local.properties

To configure local properties:

  1. In the root directory where you installed Micro Focus Connect, open local.properties.sample.
  2. Edit the following values:
    user_directory= [The slashes in this path must be forward (/). In addition, 
                     the service account under which you run the
                Micro Focus Connect server must have rights to create 
                     files in the directory you specify here.]
    
  3. Save local.properties.sample as local.properties.

Running the Micro Focus Connect Server Manually

To run the Micro Focus Connect server manually, run start-connect.bat.

This file is in the root directory where you installed Micro Focus Connect. It is also available as a desktop icon called Start Micro Focus Connect and through your Microsoft Windows Start menu, depending upon options you chose during installation.

Note: If the local.properties file is inaccessible, the Micro Focus Connect server will not start.

Configuring ConnectService.bat

If you are running the Micro Focus Connect server manually, you can skip this section. However, if you are running the Micro Focus Connect server as a Microsoft Windows service, you must first configure the ConnectService.bat file as described here.

  1. In the root directory where you installed Micro Focus Connect, open ConnectService.bat.
  2. Edit the following line by removing the REM statement and changing the value as appropriate for your environment:
    SERVICE_LOG= [the user data directory for Micro Focus Connect] 
    		  

Running the Micro Focus Connect Server as a Microsoft Windows Service

To run the Micro Focus Connect server as a Microsoft Windows service:

  1. Configure ConnectService.bat as described in the previous section.
  2. Optionally, configure the local.properties as described earlier.
  3. In the root directory where you installed Micro Focus Connect, run the ConnectService.bat file. This creates the service named EnterpriseSyncConnect. The service startup type is set to Automatic so that it starts each time the machine is re-booted.
  4. To start the Micro Focus Connect server as a service, open the Windows Services dialog and locate the EnterpriseSyncConnect service.
  5. Right-click the EnterpriseSyncConnect service and choose Start.

Note: If you want to remove the service, run uninstall-service.bat, located in the root directory where you installed Micro Focus Connect.