2.3.1 Installing Crowd WAR on JBoss

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

This page shows one example - use it as a basis for other installations This page tells you how to deploy Crowd onto a JBoss Application Server. For other application servers, refer to the generic WAR setup guide. On this page, we have used PostgreSQL as an example of a database. Crowd supports all the databases listed in the System Requirements. Refer to 2.1 Connecting Crowd to a Database for instructions on connecting Crowd to your enterprise database. This page tells you how to install the Crowd application using the WAR distribution. You can follow similar steps to install the CrowdID application.

Follow the steps below to install Crowd on JBoss 4.2.2 GA using a PostgreSQL database:

1. Download the WAR distribution from the Crowd download centre.
   You will find the WAR archives for the Crowd and the CrowdID applications. 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 – see the note on the Crowd installation front page.
3. Unzip the download archive into a directory of your choice. We'll call it server/default/deploy/crowd.war in the rest of these instructions.
4. Add file server/default/deploy/crowd.war/WEB-INF/jboss-web.xml, with the following contents:

   <jboss-web>
     <resource-ref>
       <res-ref-name>jdbc/CrowdDS</res-ref-name>
       <res-type>javax.sql.DataSource</res-type>
       <jndi-name>java:CrowdDS</jndi-name>
     </resource-ref>
   </jboss-web>
   

5. Create database crowd_db in PostgreSQL.
6. Add a datasource definition file server/default/deploy/postgres-ds.xml:

   <datasources>
     <local-tx-datasource>
       <jndi-name>CrowdDS</jndi-name>
       <connection-url>jdbc:postgresql://localhost:5432/crowd_db</connection-url>
       <driver-class>org.postgresql.Driver</driver-class>
       <user-name>postgres</user-name>
       <password>postgres</password>
     </local-tx-datasource> 
   </datasources>
   

7. Modify file server/default/deploy/crowd.war/WEB-INF/classes/jdbc.properties to use the PostreSQL dialect:

   hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
   

8. Modify file server/default/deploy/crowd.war/WEB-INF/classes/crowd.properties to point to the port of the JBoss server (8080 default):

   crowd.server.url=http://localhost:8080/crowd/services/
   application.login.url=http://localhost:8080/crowd/console/
   

9. Start JBoss with run.sh.
10. Point a web browser at http://localhost:8080/ where you will see the Crowd Setup Wizard.

Related Topics

• 1. System Requirements
  • 1.1 Setting JAVA_HOME
• 2. Installing Crowd and CrowdID
  • 2.1 Connecting Crowd to a Database
    • 2.1.1 HSQL DB
    • 2.1.2 MS SQL Server
    • 2.1.3 MySQL
    • 2.1.4 Oracle
    • 2.1.5 PostgreSQL
  • 2.2 Connecting CrowdID to a Database
    • 2.2.1 HSQL DB
    • 2.2.2 MS SQL Server
    • 2.2.3 MySQL
    • 2.2.4 Oracle
    • 2.2.5 PostgreSQL
  • 2.3 Installing Crowd and CrowdID WAR Distribution
    • 2.3.1 Installing Crowd WAR on JBoss
• 3. Running the Setup Wizard
• 4. Configuring Crowd
  • 4.1 Important Files
    • The crowd.properties File
  • 4.2 Changing the Port that Crowd uses
• 5. Installing Crowd as a Windows Service
  • 5.1 Specifying Startup Order of Windows Services
  • 5.2 Changing the User for the Crowd Windows Service
  • 5.3 Removing the Crowd Windows Service
  • 5.4 Troubleshooting Crowd as a Windows Service