My favorites | Sign in
Project Logo
esn
                
Search
for
Updated Sep 24, 2007 by xtremebytes
Labels: Phase-Deploy, Featured
Contributor_Setup_Instructions  
Setup instructions for code contributors and testers. Edit this page to reflect any special requirements/deployment criteria that may be necessary.

Requirements

Download, develop, test and contribute

Downloading source code and preparing

Checkout the current source from SVN. Follow the URL mentioned below. This project does not use the usual trunk, tags, branches concepts of SVN.

svn checkout https://esn.googlecode.com/svn/source/ esn --username <username>

It will contain a directory called core, which is the Eclipse project for the core of ESN. The project depends on a JBoss EJB 3.0 libraries configuration reference called JBoss 4.2.0. Create a new JBoss 4x configuration for your current JBoss 4.2.0 installation using the JBossIDE plug-in and name it JBoss 4.2.0. Reference this from the project to resolve the dependency problem.

Deployment

Make sure MySQL Connector/J (mysql-connector-java-5.0.6-bin.jar) is in the path server/default/lib relative to your JBoss installation. Edit server/default/deploy/mysql-ds.xml to add a local-tx-datasource entry as follows.

<local-tx-datasource>
	<jndi-name>ESNCoreDS</jndi-name>
	<connection-url>jdbc:mysql://localhost:3306/esncore</connection-url>
	<driver-class>com.mysql.jdbc.Driver</driver-class>
	<user-name>esn_admin</user-name>
	<password>admin</password>
</local-tx-datasource>

Start MySQL server. Login to MySQL console as root and execute the following SQL.

create database esncore;
grant all on esncore.* to esn_admin identified by 'admin';

On Linux, you may have to use grant all on esncore.* to 'esn_admin'@'localhost' identified by 'admin'; instead of grant all on esncore.* to esn_admin identified by 'admin';.

Edit the file server/default/conf/login-config.xml to add a new application-policy as follows.

<application-policy name="esn-core">
	<authentication>
		<login-module code="org.jboss.security.auth.spi.DatabaseServerLoginModule" flag="required">
			<module-option name="unauthenticatedIdentity">guest</module-option>
			<module-option name="dsJndiName">java:/ESNCoreDS</module-option>
			<module-option name="principalsQuery">SELECT passwordDigest FROM UserAuthentication WHERE userId=?</module-option>
			<module-option name="rolesQuery">SELECT role, 'Roles' FROM UserRole WHERE userId=?</module-option>
			<module-option name="hashAlgorithm">SHA-1</module-option>
			<module-option name="hashEncoding">hex</module-option>
			<module-option name="ignorePasswordCase">false</module-option>
		</login-module>
	</authentication>
</application-policy>

Deploy (copy to) target/esn-core.ear from the project to server/default/deploy relative to JBoss. While MySQL is still running, start up JBoss on the default server. JBoss should be running using Sun Java 1.5 JRE.

Contributing

Check in new code through SVN.


Sign in to add a comment
Hosted by Google Code