c-treeACE Windows Service

Windows Server 2003/XP/Vista supports background processes known as services that are handled somewhat differently by the operating system. Services may be configured to start automatically at system startup or to start manually by a user. Services typically have no user interface and can continue to run even when no users are logged on to the system. The operating system automatically terminates services at system shutdown or a user can manually terminate them.

Windows service support consists of three components: the Windows Service Control Manager (SCM), the service executable, and the service control program (SCP). Windows Server 2003/XP/Vista provides access to the SCM from the Services Control Panel applet. Application vendors provide the service executable and SCP.

FairCom has developed a version of the c-treeACE Server that runs as a Windows Service. The c-treeACE Server Service consists of the following components:

• ctreesql.exe or ctsrvr.exe - The c-treeACE Server Service executables
• ctntinst.exe - The c-treeACE Server Service Control Program (SCP)

The c-treeACE service features all of the capabilities and advantages of Windows services described above. As with any service, the c-treeACE service can be configured to start automatically when the machine comes up, can run invisibly no matter which users are logged on or if no user is logged on, and will shut down automatically when the host machine shuts down.

Use the c-treeACE Server SCP command-line utility to install, configure, and control the c-treeACE Server Service. The following command-line options are available:

ctntinst [executableName] option [-u <username> [-p <password>]] [serviceName]

• executableName is the file name of the desired c-treeACE Server executable.
• option is a single entry selected from the table below:

  -install	Install the c-treeACE Service.
  -remove	Uninstall the c-treeACE Service.
  -auto	Set service to start up automatically.
  -demand	Set service to start up on demand.
  -showconfig	Show service settings.
  -status	Show current status of service.
  -start	Start the c-treeACE Service.
  -stop	Stop the c-treeACE Service.

• username is the name of the account under which the service should run. Use an account name in the form: DomainName\UserName. The service process logs on as this user. If the account belongs to the built-in domain, specify .\UserName. If the -u option is not specified, the service runs under the LocalSystem account.
• password is the password for the account name specified by the username option. If the account has no password or if the service runs under the LocalService, NetworkService, or LocalSystem accounts, omit the -p option.
• serviceName is an optional service name used to provide a unique service name. This is required if more than one c-treeACE service is to be executed on the same physical machine. See "Installing Multiple Instances of the c-treeACE Server" for additional details on starting multiple c-treeACE services. serviceName defaults to “c‑treeServer” if not specified.