Installing and running the QualiPSo Factory

Prerequisites

Installing the Factory

Copy the "factory-package-basic.ear" file in the JBoss deployment folder corresponding to the configuration of the server that is running (generally, in "server/default")

Configuring JBoss

You need to configure the security part of JBoss to match the security parameters of the QualiPSo Factory.

In the "conf" folder, edit the "login-config.xml" file and add the following lines:

  <application-policy name="qualipso">
    <authentication>
      <login-module code="org.jboss.security.ClientLoginModule" flag="required">
         <!-- Any existing security context will be restored on logout -->
         <module-option name="restore-login-identity">true</module-option>
      </login-module>
    </authentication>
  </application-policy>

  <application-policy name="JBossWSDigest">
   <authentication>
      <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" flag="sufficient">
        <module-option name="usersProperties">props/jbossws-users.properties</module-option>
        <module-option name="rolesProperties">props/jbossws-roles.properties</module-option>
        <module-option name="hashAlgorithm">SHA</module-option>
        <module-option name="hashEncoding">BASE64</module-option>
        <module-option name="hashUserPassword">false</module-option>
        <module-option name="hashStorePassword">true</module-option>
        <module-option name="storeDigestCallback">org.jboss.ws.extensions.security.auth.callback.UsernameTokenCallback</module-option>
        <module-option name="unauthenticatedIdentity">guest</module-option>
      </login-module>
      <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" flag="sufficient">
        <module-option name="usersProperties">props/jbossws-users.properties</module-option>
        <module-option name="rolesProperties">props/jbossws-roles.properties</module-option>
        <module-option name="unauthenticatedIdentity">guest</module-option>
      </login-module>
      <login-module code = "org.jboss.security.auth.spi.DatabaseServerLoginModule" flag = "sufficient">
        <module-option name = "unauthenticatedIdentity">guest</module-option>
        <module-option name = "dsJndiName">java:/DefaultDS</module-option>
        <module-option name = "principalsQuery">SELECT passwd FROM account WHERE login=?</module-option>
        <module-option name = "rolesQuery">SELECT roleid, 'Roles' FROM roles WHERE login=?</module-option>
      </login-module>
    </authentication>
  </application-policy>

In the "conf/props" folder, edit the "jbossws-users.properties" file and add the following lines:

kermit=thefrog
root=root

Running the Factory

Launch JBoss AS server, for example by running the bin/run.sh script.

Test that the Factory is working

To test that the factory is working, you can run the functional tests of "factory-core". Go in the "factory-core-tests" folder, and type the following command:

mvn test

If you get an indication that all tests passed without error or failure, then the Factory is running correctly.

You can also open a web browser and try to connect to following url : http://localhost:8080/factory/.

More information

More detailed information are available in the developer section