Building JBoss Portal 2.6.4 from source using Ant

Building non-clustered binary

• Check out the tag JBoss_Portal_2_6_4 from here if you are a commiter: https://svn.jboss.org/repos/portal/tags/JBoss_Portal_2_6_4/ or from here if you are not (yet): http://anonsvn.jboss.org/repos/portal/tags/JBoss_Portal_2_6_4/

• Edit the build/local.properties to suit your environment. At the least modify these two properties portal.deploy.dir, jboss.home

• Open a console window and change directory to "build".

• Call the script "build.bat" or "build.sh" (or "ant" if you have ant already installed in your environment).

• The script will get all third party libraries to /thirdparty directory and then will start the build process

• Once the build is completed with no errors, have a look at the output directory under each sub projects or modules.

• The jboss-portal.sar will be created under core/output/lib. Examine this sar and you will find only a few modules have been created within this sar

• To deploy the default "most" built modules, do "ant deploy" or "build deploy"

• To deploy all the modules you should do "ant deploy-all" or "build deploy-all"

• To deploy in exploded form you do "ant exploded-deploy".

• Note there is no "exploded-deploy-all" in build/build.xml. You can however easily create it with the help of "deploy-all" target

Building clustered binary

JBoss Portal source comes with two modules that needs its configuration to be cluster enabled. The two modules are "core" and "core-cms". Follow instructions as you would build the non-clustered binary up to the deploy step.

• Now change directory to "core" and "core-cms" and do "ant output-ha".

• This will create the -ha.sars under the respective modules.

• Notice however there is no deploy target in build.xml

• To deploy you will need to manually explode the jboss-portal-ha.sar and jboss-portal-cms-ha.sar to their appropriate folder under JBoss's deploy directory.

• It is always advisable to delete the pre-existing directories before overwriting them.

• So ideally if you explode jboss-portal-ha.sar only the "most" modules will be available which are "core", "ajax" and "server".

• After this you will need to explode the jboss-portal-cms-ha.sar and any other individual modules as needed like "workflow" etc.,

• But it is a manual process!

Hints:

You can also build the clustered binary using the following ant command "ant -buildfile distrib.xml package-ha" however you will need to check out the docs to the appropriate location and modify the following in distrib.xml

<property name="source.dir" value="../../JBoss_Portal_2_6_4"></property>
...
            <fileset dir="${docs.dir}/referenceGuide/en/"></fileset>
...
            <fileset dir="${docs.dir}/userGuide/en/"></fileset>
...
            <fileset dir="${docs.dir}/quickstartuser/en/"></fileset>
...
            <fileset dir="licences"></fileset>

The JBoss_Portal_2_6_4 docs should be checked out in the same root directory as where the sources are.

Referenced by: