Platform-Specific Notes

This is additional server-related information that is specific to certain operating systems.

Windows

The web server is installed as a Windows Service.  This means the server starts up automatically when the machine boots up, and no user needs to be logged in.  The service can be started and stopped manually and even remotely.

The default installation is for the service to start automatically upon system startup using the default service user.  All of these settings can be changed by the administrator after installation using Microsoft's standard service configuration control panel.

Warning:  If you change the user under which the service runs, make sure the installation directory is still both readable and writable by the new user.

Warning:  If Code Collaborator is located on the same machine as the database, and if the Code Collaborator service starts up before the database service, Code Collaborator might fail to start up.  The work-around is to restart the Code Collaborator service, but the fix is to use service dependencies to tell Windows that the Code Collaborator service is dependant on the database service.  This is a standard Windows service feature.

Linux / Solaris

The web service is not automatically installed such that it will run automatically when the system starts up.  However this is easy to set up.

The installation directory contains a file ccollab_server.sh that can accept the usual start and stop commands.  Create a symbolic link to this file from your standard installation directory (e.g. /etc/rc3.d or /etc/rc.local) to cause the server to start automatically upon system startup.

Warning:  If Code Collaborator is located on the same machine as the database, make sure it starts up later in the start-up process than the database server.  Otherwise, Code Collaborator will fail to start up.