The first step is to setup the default data for the portal, this is done in 2 steps. First you have to execute the content of the file setup.ddl in the database.

>mysql -u portal -p
mysql> use jbossportal
Database changed
mysql> source setup.ddl
Query OK, 0 rows affected, 1 warning (0.06 sec)
...
Query OK, 1 row affected (0.00 sec)
mysql> exit
Bye

Then you should populate the database to create two users, one with login user and password user who is a regular user and one administrator with admin as username and admin as password. To do so type the following command:

root# mysql -u portal -p jbossportal < jboss-portal-2.0\core\output\resources\setup\setup.sql

The second step is to unarchive the content of the file cms-content.zip into the directory $JBOSS_HOME/server/default/data, this setup the default content of the CMS. If this is the first time you use that JBoss instance, the directory data may not exist, in that case you have to create it. You should have the following structure for the CMS:

$JBOSS_HOME/server/default/data
 +-portal
  +-webdav
   +-store
   +-work

Now we deploy the rest in JBoss. Just copy the files portal-core.sar and portal-ds.xml into the directory $JBOSS_HOME/server/default/deploy

First define which database you want to use by specifying it in $PORTAL_HOME/build/local.properties. By changing the value of portal.database JBoss Portal will be ready to use the specified one. As of today only mySQL and postreSQL are accepted values but to add any Hibernate supported database you just need to add a file into $PORTAL_HOME/build/etc with your database information. (See below)

Check and modify if needed the file corresponding to your database in $PORTAL_HOME/build/etc. Here is what it looks like for mySQL:

hibernate.dialect=net.sf.hibernate.dialect.MySQLDialect
portal.datasource.driver=org.gjt.mm.mysql.Driver
portal.datasource.url=jdbc:mysql://localhost:3306/jbossportal?useServerPrepStmts=false
portal.datasource.username=portal
portal.datasource.password=portalpassword

Adding another database would be as easy as adding such a file, specifying the Hibernate dialect, the datasource url, the username and the password. A list of supported Hibernate dialects can be found here.

Now is time to build the sources, go to jboss-portal-2.0/build and type sh build.sh, you should read BUILD SUCCESSFUL at the end of the operation.

Now you will need to build the DDL file to be able to create the required tables in your database. To do so go to jboss-portal-2.0/core and type sh build.sh ddl. It will create the file jboss-portal-2.0\core\output\resources\setup\setup.ddl.

To feed your database just type the following line and enter portalpassword as password when asked (or whatever you used while setting up your database):

C:\mysql\bin> mysqladmin -u portal -p jbossportal < jboss-portal-2.0\core\output\resources\setup\setup.ddl

Then you should populate the database to create two users, one with login user and password user who is a regular user and one administrator with admin as username and admin as password. To do so type the following command:

root# mysql -u portal -p jbossportal < jboss-portal-2.0\core\output\resources\setup\setup.sql

Before you deploy the application by itself, you will need to have the database deployment descriptor (portal-ds.xml) in the $JBOSS_HOME\server\default\deploy directory. To do so copy in that directory the file $PORTAL_HOME\core\output\resources\setup\portal-ds.xml.

You will also need to put the jar file of your database connector in $JBOSS_HOME\server\default\lib.