This page last changed on Mar 03, 2010 by rbattaglin.
For long-term use, you should configure Crowd to restart automatically when the operating system restarts. For Windows servers, this means configuring Crowd to run as a Windows service.
Running Crowd as a Windows service has other advantages. When Crowd is started manually, a console window opens - there is a risk that someone may accidentally shut down Crowd by closing the window. Also, the Crowd logs are properly managed by the Windows service (reliably found in \atlassian-crowd.log in the root Crowd directory, and rotated by file size).
 | Note for 64-bit Windows If you are running 64-bit Windows, please note that Apache Tomcat cannot run as a Windows service if you are using a 64-bit JDK. Please ensure that you are using a 32-bit JDK. For more information, please refer to CONF-12293 for a workaround if you intend to continue using the 64-bit JDK. |
Installing Crowd as a Windows Service
- Open a DOS prompt.
- 'cd' to your Crowd directory, and then the Tomcat bin subdirectory, e.g. {CROWD_INSTALL}\apache-tomcat\bin
- If a directory in the path has spaces (e.g. C:\Program Files\..), please convert it to its eight-character equivalent (e.g. c:\Progra~1\..).
- Ensure the JAVA_HOME variable is set to the JDK base directory. Use echo %JAVA_HOME% to confirm this.
- Run the following command:
Screenshot: Installing Crowd as a Windows Service

Crowd should now have been installed as a service, and will be visible in the Windows Services console.
Screenshot: Windows Services Console

- Run the following command, to have the Crowd service start automatically when the server starts:
The Crowd service will automatically start up the next time the server reboots.
 |
- You can manually start the Crowd service with the command net start Crowd, and stop it with net stop Crowd.
- To see what parameters the Crowd service is starting with, go to Start -> Run and run regedt32.exe. There should be an entry at HKEY_LOCAL_MACHINE -> SOFTWARE -> Apache Software Foundation -> Procrun 2.0 -> Crowd.
|
Additional Crowd Setup Options (Optional)
- To increase the maximum memory Crowd can use (the default will already be 256MB), run:
- If you are running Crowd with JIRA and/or Confluence in the same JVM, increase the MaxPermSize to 512 MB:
- Occasionally, it may be useful to view Crowd's Garbage Collection information. This is especially true when investigating memory issues.
- To turn on the Verbose GC (garbage collection) logging, execute the following command in the command prompt
- The path (denoted by \path\to) refers to the directory in which Crowd is currently installed. For example:
- If you are using HSQL as your database server: after installing Crowd as a Windows service, you will need to copy your database files.
- Create a folder called c:\windows\system32\database
- Copy over the database files from your atlassian-crowd-1.1.2/database.
We recommend strongly that you use an external database server rather than the HSQL database supplied with Crowd for evaluation purposes.
RELATED TOPICS
|