How to update JBoss AS 7 to newer versions of PicketLink

Objective

 

     This article describes how to update the JBoss AS 7 to newer versions of PicketLink.

     In this article we will show you how to update the PicketLink bundled module (version 2.0.2) to use the 2.1.6 version.

 

Downloads

 

     Before you start download the following file:

 

 

     This article consider that you already have a functional JBoss AS 7 installation.

 

Configuring the module org.picketlink with the newer version of PicketLink

 

     The JBoss AS 7 is shipped with a PicketLink's module. This module is located in:

 

               ${jboss.home.dir}/modules/org/picketlink

 

     This directory contains another one called main, related with the default PicketLink's configuration and jar files used by the JBoss AS.

 

     To update the PicketLink's module version to 2.1.6 do the following:

 

          1) Backup first the ${jboss.home.dir}/modules/org/picketlink/main directory;

 

          2) cd ${jboss.home.dir}/modules/org/picketlink/main;

 

          3) Delete all files in this directory, except the module.xml file.

 

          4) Copy the latest jar files of PicketLink to the ${jboss.home.dir}/modules/org/picketlink/main directory (this files are inside the latest distribution package of PicketLink that you downloaded before):

 

      • picketlink-core-2.1.6.Final.jar
      • picketlink-jbas7-2.1.6.Final.jar

 

          5) Edit the module.xml file like this:

 

                    <module xmlns="urn:jboss:module:1.1" name="org.picketlink">

                             <resources>

                                      <resource-root path="picketlink-core-2.1.6.Final.jar"/>

                                      <resource-root path="picketlink-jbas7-2.1.6.Final.jar"/>

                             </resources>

                             <dependencies>

                                  ...        

                             </dependencies>

                    </module>

 

     That is it. Now we have the org.picketlink module configured with the latest version of Picketlink libraries.

 

PicketLink module configuration for JBoss AS 7.1.1.Final

 

To use PicketLink with JBoss AS 7.1.1.Final you need to update the PicketLink module definition with the following content:

 

                <module xmlns="urn:jboss:module:1.1" name="org.picketlink">

                        <resources>

                                <resource-root path="picketlink-jbas7-2.1.6.Final.jar" />

                                <resource-root path="picketlink-core-2.1.6.Final.jar" />

                        </resources>

 

 

                        <dependencies>

                                <module name="org.jboss.staxmapper" />

                                <module name="org.jboss.as.controller" />

                                <module name="org.jboss.as.server" />

                                <module name="org.jboss.modules" />

                                <module name="org.jboss.msc" />

                                <module name="org.jboss.logging" />

                                <module name="org.jboss.vfs" />

                                <module name="org.jboss.metadata" />

                                <module name="javax.security.auth.message.api" />

                                <module name="javax.security.jacc.api" />

                                <module name="javax.transaction.api" />

                                <module name="javax.xml.bind.api" />

                                <module name="javax.xml.stream.api" />

                                <module name="javax.servlet.api" />

                                <module name="org.jboss.common-core" />

                                <module name="org.jboss.logging" />

                                <module name="org.jboss.as.web" />

                                <module name="org.jboss.security.xacml" />

                                <module name="org.picketbox" />

                                <module name="javax.xml.ws.api" />

                                <module name="org.apache.log4j" />

                                <module name="org.apache.santuario.xmlsec" />

                                <module name="javax.api" />

                                <module name="org.jboss.ws.api"/>

                                <module name="org.jboss.ws.spi"/>

                                <module name="org.apache.cxf"/>

                        </dependencies>

                </module>

 

For versions superior than 7.1.1.Final the module is already updated.

 

We strongly recommend that you use the PicketLink Installer to configure your JBoss AS distribution. Follow the instructions here:

 

 

Backward compatibility with older versions

 

     Please follow the instructions described in https://community.jboss.org/wiki/HowToConfigureJBossAS71xToBackwardCompatibilityWithOlderVersions.