HR-CRM-CLIENT - Installation

This guide will demonstrate how to install the HR-CRM-CLIENT application and how to use it.

Requirements

  • Java SE 6.0
  • GlassFish v2 Application Server
  • Maven2

Download

Checkout the whole maven package from the repository with your favourite svn client.
svn checkout https://hr-crm-client.svn.sourceforge.net/svnroot/hr-crm-client

Or download the source distribution in the download section here .

Configuration

  • 1. Set the property ${glassfish_home} to your GlassFish installation directory in the main pom.xml
  • 2. Copy our keystore.jks and cacert.jks certificate files into your GlassFish installation directory
  • 3. Add hr-crm user to GlassFish
  • 4. Set the path to the trusted certificates for the hr-crm_client module
  • 5. Set the path to the keystore file in the hr-crm_server module

1. Set the property ${glassfish_home} to your GlassFish installation directory in the main pom.xml

Now we need to make some modifications in the pom.xml file. You must specify the location of your GlassFish server. Open the root pom.xml file and change these lines according to your GlassFish installation directory and settings: 

<glassfish_home>C:\Program Files\GlassFish</glassfish_home>

2. Copy our keystore.jks and cacerts.jks certificate files into your GlassFish installation directory

For the security mechanism to work, we need to replace the keystore and cacerts files. Please download cacerts.jks and keystore.jks and put them into <GLASSFISH_HOME>/domains/domain1/config/. You can of course create the keys and certificates yourself. In that case, follow the instructions in the WSIT documentation here

Note: These digital certificates are self-signed and are intended for use in a development environment; they are not intended for production purposes. For production purposes, generate your own certificates and have them signed by a CA.

3. Add hr-crm user to GlassFish

Create a user "hr-crm" with password "hr-crm" and grouplist "wsit" in you GlassFish server. Please follow the instructions here .

4. Set the path to the trusted certificates for the hr-crm_client module

The next step is to set the paths for the trusted certificates in the hr-crm_server module. In the file <CheckoutDirectory>\hr-crm_client\src\main\java\META-INF\PartyServer.xml, please change the location of the cacerts.jks file. 


    <sc1:CallbackHandlerConfiguration wspp:visibility="private">
     <sc1:CallbackHandler default="hr-crm" name="usernameHandler"/>
     <sc1:CallbackHandler default="hr-crm" name="passwordHandler"/>
    </sc1:CallbackHandlerConfiguration>
	<sc1:TrustStore wspp:visibility="private" location="C:\Program Files\GlassFish\domains\domain1\config\cacerts.jks" 
	type="JKS" storepass="changeit" peeralias="xws-security-server"/>

5. Set the path to the keystore file in the hr-crm_server module

Please edit the following line in the file <CheckoutDirectory>\hr-crm_server\src\main\webapp\WEB-INF\wsdl\Party.wsdl 


<sc:KeyStore wspp:visibility="private" location="C:\Program Files\GlassFish\domains\domain1\config\keystore.jks" type="JKS" 
storepass="changeit" alias="xws-security-server"/>

Installation

Now we are ready to run the application. Run mvn install in the directory of the main pom.xml. Then execute in both submodules mvn glassfish:deploy and both war files should be deployed into your GlassFish server. If the deployment fails, you can try to deploy the war files manually. If the deployment was successfull, than you should see a contact list here http://localhost:8080/hr-crm_client/contacts.jsf