2.3.1 Installing Crowd on JBoss

The standard Crowd installation guide tells you how to install the standalone version of Crowd, which includes Apache Tomcat. You may wish to deploy Crowd on your own existing application server instead. This page tells you how to deploy Crowd onto a JBoss Application Server.

This page shows one example - use it as a basis for other installations

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. You can install one or more of the other web applications included in the Crowd archive, by using the exploded WAR files in the relevant webapp directory.

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

Download Crowd.
Unzip the download archive into a directory of your choice.
Copy/rename the Crowd directory crowd-webapp to server/default/deploy/crowd.war.

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>

Create database crowd_db in PostgreSQL.

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>

Modify file server/default/deploy/crowd.war/WEB-INF/classes/jdbc.properties to use the PostreSQL dialect:
```
hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
```
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/
```
Start JBoss with run.sh.
Point a web browser at http://localhost:8080/ where you will see the Crowd Setup Wizard.

2.3.1 Installing Crowd on JBoss

Related Topics

Labels