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

The Crowd and CrowdID WAR distributions are intended for deployment onto an existing J2EE application server. It is assumed that you already know how to deploy a web application onto your chosen application server. If not, please contact your system administrator to assist you, or consider installing the Crowd Standalone distribution instead.

The standard Crowd installation guide tells you how to install the Standalone distribution of Crowd, which includes Apache Tomcat. Instead, you may wish to deploy Crowd or CrowdID onto your own existing application server. For this purpose, we provide WAR (Webapp ARchive) distributions of the Crowd and CrowdID server applications.

Crowd supports all the application servers listed in System Requirements.

Below is a generic overview of the steps required to install the Crowd WAR distribution. You will need to perform specific configuration steps depending upon your application server. As well as the generic instructions below, we also provide specific instructions on the following pages:

Dependencies

Refer to the system requirements.
(warning) Please make sure that all dependencies are installed, otherwise Crowd will not run properly.

Overview of the Crowd WAR Installation Steps

  1. Download the Crowd WAR distribution from the Crowd download centre.
    (info) You will find the WAR archives for the Crowd and the CrowdID applications by clicking the Show advanced downloads  link. You will need to deploy each application separately. For the rest of these instructions, we assume you are deploying Crowd WAR.

  2. Please check your unzip program before extracting the downloaded archive, as some unzip programs can cause errors — see the note on the Crowd installation front page.

  3. Unzip the download archive into a directory of your choice. We'll call it CROWD in the rest of these instructions.

  4. Specify your Crowd Home directory by editing the configuration file at server/default/deploy/crowd.war/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.
  5. Create a database in your chosen database server.

  6. Copy the JDBC driver into your application server's classpath.

  7. Modify file CROWD/WEB-INF/classes/crowd.properties to point to the port of your application server. 8080 is the default, and is shown in the example below: 
    crowd.server.url=http://localhost:8080/crowd/services/
application.login.url=http://localhost:8080/crowd/console/


  8. Depending upon your application server, you may need to zip up the WAR file again before deploying it. Place the CROWD directory or the WAR file into your application server's deployment directory. Please consult the server-specific documentation on how to do this. A few Atlassian best practice guides are listed here:
  9. Restart your application server.

  10. Point a web browser at the IP address and port that your application server is running on (typically http://localhost:8080). The Crowd Setup Wizard will start.

Related Topics





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