Installing Crowd as a Windows Service

If you are trying to set up Crowd as a Windows Service on a 64 bit machine, you should ensure that Crowd uses 64-bit Tomcat binaries. See the Crowd installation guide for more details.

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).

Installing Crowd as a Windows Service

  1. Open a DOS Command prompt as Administrator (search for "cmd" in the start menu/screen, right click and "Run as Administrator").
  2. 'cd' to your Crowd directory, and then the Tomcat bin subdirectory, e.g. {CROWD_INSTALL}\apache-tomcat\bin
  3. 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\..).
  4. Ensure the JAVA_HOME variable is set to the JDK base directory. Use echo %JAVA_HOME% to confirm this.
  5. 次のコマンドを実行します。

    service.bat install Crowd

    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

  6. Run the following command, to have the Crowd service start automatically when the server starts:

    tomcat8w //US//Crowd --Startup auto

    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.


If you wish to run the service as a non-administrator user for security, or if you are using network drives for backups, attachments, or indexes, you can run the service as another user.

To run the service as another user:
  1. Open the Apache Tomcat Crowd properties.
  2. Select the Log On tab.
  3. Enter the required username and password.
  4. Go to Windows Control Panel > User Accounts and confirm that the user has write permissions for the {CROWD_INSTALL} and {CROWD_HOME} directories and all subfolders.

    Note that any network drives must be specified by UNC and not letter mappings (eg. \\backupserver\crowd not z:\crowd).

Additional Crowd Setup Options (Optional)

  • To increase the maximum memory Crowd can use (the default will be 256MB), run:

    tomcat8w //US//Crowd --JvmMx 512
  • If you are running Crowd with Jira and/or Confluence in the same JVM, increase the MaxPermSize to 512 MB:

    tomcat8w //US//Crowd ++JvmOptions="-XX:MaxPermSize=512m"
  • 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

      tomcat8w //US//Crowd ++JvmOptions="-Xloggc:path\to\logs\atlassian-gc.log"
    • The path (denoted by \path\to) refers to the directory in which Crowd is currently installed. For example:

      tomcat8w //US//Crowd ++JvmOptions="-Xloggc:c:\crowdinstall\logs\atlassian-gc.log"
  • In order to check all the configurations for the service, you can access:

    HKEY_LOCAL_MACHINE -> SOFTWARE -> Apache Software Foundation -> Procrun 2.0 -> Crowd -> Parameters -> Java -> Options
  • If you are using HSQL as your database server: after installing Crowd as a Windows service, you will need to copy your database files.
    1. Create a folder called c:\windows\system32\database
    2. Copy over the database files from your atlassian-crowd-1.1.2/database.
      (warning) We recommend strongly that you use an external database server rather than the HSQL database supplied with Crowd for evaluation purposes.

      Refer to the Tomcat documentation for further service options.


最終更新日 2021 年 6 月 15 日


Powered by Confluence and Scroll Viewport.