Run the TeamForge connector server as a service on Windows

To run the TeamForge connector server as a service on Windows, install the service and start it.

Open a command prompt as an administrator user.
Note: On Windows Vista/7, running a command prompt while logged in as a user with administrator privileges is not enough. It's important that you follow these steps.
1. On your Windows system, click Start.
2. Type cmd in the Search box, but don't hit Enter.
3. Right-click cmd.exe and select Run as administrator.
4. If you get a User Account Control warning message, click OK.
Change to the directory where you extracted the TeamForge connector server distribution.
- cd c:\path\to\apache-tomcat-7.x.xx
Choose to have a 32-bit or 64-bit Tomcat installed.
- Install the default 32-bit Tomcat using JAVA_HOME (32 bit JVM) from the environment variable.
  Note: TeamForge connector's synchronization engines need 32 bit JVM as the Quality Center's native drivers support only 32 bit.
- Install the 64-bit Tomcat if the TeamForge connector installation is large and the heap size within a 32-bit JVM is not sufficient.
  Note: The JAVA_HOME environment variable has to point to the 32-bit JDK only.
  - Run this command to install the 64-bit Tomcat service:
    - bin\service.bat install
  - Enter the location of the 64-bit JDK. For example, C:\Program Files\Java\jdk1.7.0_71.
This will register the TeamForge connector server as a Windows service and set it up as specified in ccf.conf. If you get errors, make sure the command prompt has administrator privileges.
Note: Changes to ccf.conf will get picked up only when you re-install the service by running service.bat remove followed by service.bat install.

It is possible to run multiple instances of the TeamForge connector server on one machine.

For this, you will need to:

Configure the Apache Tomcat instances to listen on different ports. For information on how to set up the port that tomcat listens on, see the Tomcat documentation.
Set up ccf.conf to ensure that each service is on a different port.
Supply a unique name for each service instance when service.bat is called.

For example:

     <edit server.xml with settings for service 1>
	 <edit ccf.conf with settings for service 2>
	 bin\service.bat install TeamforgeConnectorServer1
	 cd \path\to\instance2
	 <edit server.xml with settings for service 1>
	 <edit ccf.conf with settings for service 2>
	 bin\service.bat install TeamForgeConnectorServer2

To run the TeamForge connector server, start the service using the Services console in Windows. Alternatively, you can run tomcat7w.exe in the bin directory to configure, start and stop the service.