Documentation for Crowd 1.6. Documentation for other versions of Crowd is available too.

This documentation applies to Crowd version 1.6.x. The latest Crowd documentation is available via this link.

The instructions below tell you how to install the standalone distribution of Crowd, which includes Apache Tomcat. If you wish to deploy a WAR distribution of Crowd or CrowdID on your own existing application server instead, read the instructions on the Crowd WAR distribution.

Crowd versions 1.1 and later include CrowdID. Installing Crowd, as described below, will also install CrowdID.

Hint: If you are evaluating Crowd or you are unsure which version to install, just follow the simple instructions on this page.

On this page:

1. Install Crowd (Standalone Distribution)

  1. Download Crowd.

  2. Please check your unzip program before extracting the downloaded archive – see the note on the Crowd installation front page.

  3. Unzip the download archive into a directory of your choice. Note: Do not specify directory names that contain spaces.
    (info) We'll refer to this installation directory as {CROWD_INSTALL}.

  4. Specify your Crowd Home directory by editing the configuration file at: {CROWD_INSTALL}\crowd-webapp\WEB-INF\classes\crowd-init.properties.

    The Crowd Home directory is where Crowd will store its configuration information. If you are using the embedded HSQL database, supplied for evaluation purposes, Crowd will also store its database in this directory. To specify the directory:

    • Open the crowd-init.properties file.
    • Choose the appropriate line in the file, depending upon your operating system (see below).
    • Remove the # at the beginning of the line.
    • Enter the name of the directory you want Crowd to use as its Home directory. For example,
      • On Windows: 
        crowd.home=c:/data/crowd-home
        Note: On Windows, make sure you use forward slashes as shown above, not backward slashes.
      • On Mac and Unix-based systems: 
        crowd.home=/var/crowd-home
    • Save the crowd-init.properties file.

2. Optional Prepare your Database

Hint: If you are evaluating Crowd and are happy to use the database supplied, you can skip this step.

If you wish to set up Crowd and/or CrowdID with an external database, see:

3. Start Crowd and Complete the Setup Wizard

  1. Run the start-up script, found in your {CROWD_INSTALL} directory:
    • start_crowd.bat for Windows.
    • start_crowd.sh for Mac and Unix-based systems.
  2. Point a web browser at http://localhost:8095/crowd where you will see the Crowd Setup Wizard. Follow the instructions in the Wizard. You can also read more information about the Setup Wizard.
RELATED TOPICS





Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.