Development Environment

Setup
E-PROUREMENT TECHNOLOGIES LIMITED

e-Procurement Technologies Ltd

Development Environment Setup

Table of Contents
1.

Introduction........................................................................................................4

2. Development Environment.......................................................................................4
2.1

Setup the environment...................................................................................4

2.1.1

Pre-Requisites.........................................................................................4

2.1.2

Folder Structure.......................................................................................4

2.1.3

Path Variables:........................................................................................4

2.2

JAVA.............................................................................................................5

2.2.1

Download................................................................................................5

2.2.2

Installation..............................................................................................5

2.3

NetBeans IDE................................................................................................5

2.3.1

Download................................................................................................5

2.3.2

Installation..............................................................................................5

2.4

JBoss Application Server.................................................................................6

2.4.1

Download................................................................................................6

2.4.2

Installation..............................................................................................6

2.4.3

Integration with IDE.................................................................................6

2.5

MS SQL 2008................................................................................................6

2.5.1

Download................................................................................................6

2.5.2

Installation..............................................................................................6

2.5.3

Integration with NetBeans.........................................................................7

2.6

Software Management Tool: Apache Maven.......................................................7

2.6.1

Download................................................................................................7

2.6.2

Installation:............................................................................................7

2.6.3

Maven Repository.....................................................................................7

2.6.4 Integration with IDE.....................................................................................7

2.6.5
2.7

Required Artifacts in the Repository............................................................8

SVN Server...................................................................................................8

2.7.1

Download................................................................................................8

2.7.2

Installation..............................................................................................8

2.8

SVN Client.....................................................................................................8
2

e-Procurement Technologies Ltd

Development Environment Setup

2.8.1

Download................................................................................................8

2.8.2

Installation..............................................................................................8

2.8.3

Integration of VisualSVN with TortoiseSVN:.................................................9

2.8.4

Integration with NetBeans.........................................................................9

2.9

Apache Web Sever:........................................................................................9

2.9.1

Download................................................................................................9

2.9.2

Installation..............................................................................................9

e-Procurement Technologies Ltd

Development Environment Setup

1. Introduction
This document should be considered as the initial setup step for the development
environment infrastructure for the e-GP project. The document describes the components
necessary for the development environment. There are several steps required to install and
configure these components.
Steps to install/configure the development environment:

Copy package from server to C:\workarea (NetBeans IDE, NetBeans Plugins, JBoss
Application server, Java, Maven Repository, SVN Repository).
Install JDK. Set Class Path to Environment variables.

Install NetBeans IDE with Customization.

Install/Configure Database.

Install/Configure Maven.

Install/Configure SVN.

Get project from Subversion

After executing all the steps above, the development environment should be ready to use.

2. Development Environment
a. Setup the environment
2.1.1 Pre-Requisites
1. Minimum Hardware Configuration: 50GB hard disk, 1GB Ram, P 4
2. Operating Systems: Windows XP or higher

2.1.2 Folder Structure

Various software should be located under specific folder. e.g. Program Files on Windows.
Once the installation is done, the classpath variables should be set manually.

2.1.3 Path Variables:

1. JAVA_HOME: set PATH="C:\program files\ java\jdk1.6.x.x\bin ";%PATH%
2. JBOSS_HOME: set PATH=C:\Program Files\JBoss\jboss-5.0.1 GA,%PATH%
3. Tortoise SVN: set PATH="C:\program files\ TortoiseSVN\bin";%PATH%
4. Maven: set PATH="c:\program files\apache-maven-2.0.x\bin";%PATH%

e-Procurement Technologies Ltd

Development Environment Setup

b. JAVA
The e-GP Application requires Java 1.5.x or higher can be used. For building the e-GP
application from the sources. It is preferable to use JDK 1.6.x.

2.2.1 Download
JDK can be downloaded from the Java site:
http://www.oracle.com/technetwork/java/javase/downloads/jdk6-jsp-136632.html

2.2.2 Installation
Please refer to installation guide provided on Java site:
http://www.oracle.com/technetwork/java/javase/index-137561.html#windows

c. NetBeans IDE
NetBeans IDE provides all the functionalities required for creating e-GP Infrastructure. It
also allows various other tools to be integrated to IDE.
e-GP system development will be carried on NetBeans IDE 6.8. The higher versions can
also be helpful.

2.3.1 Download
NetBeans IDE can be downloaded from:
http://netbeans.org/downloads/6.8/index.html
Note:
For e-GP implementation NetBeans for Java bundle is preferable (includes j2SE, J2EE, SDK
support, Application Servers). The All Bundle can also be used. But, certain features of the
same are not required.

2.3.2 Installation
Please refer to Installation guidelines on:
http://netbeans.org/community/releases/68/install.html
Note:
Installation provides all basic functionalities for the project development life cycle. The
required tools and plug-ins can be managed by Options section under Tools menu.
Development Note:
Creating project on NetBeans IDE for Java Web provides various selections of frameworks
and servers, upon selection the required libraries are imported automatically with basic
project structure created at specified location.

2.4

JBoss Application Server

The e-GP infrastructure will be deployed on JBoss-5.0.1.GA.

e-Procurement Technologies Ltd

Development Environment Setup

2.4.1 Download
http://sourceforge.net/projects/jboss/files/JBoss/JBoss-5.0.1.GA

2.4.2 Installation
Please refer to the installation notes that come with JBoss Application Server. You will
need to configure and customize your JBoss Application Server after installation. We will
refer to the installation directory as ${jboss.dir} in the following.
The detailed guideline can be found at:
http://docs.jboss.org/jbossas/docs/Installation_And_Getting_Started_Guide/5/html/index.h
tml
NOTE:
According to various other tools running on the system, application server port might need
to be changed from configuration file of the server. The default port would be 8080.

2.4.3 Integration with IDE

The IDE allows integration with various servers. JBoss Application server can be added
through Tools -> Servers-> Add Server. To add server ${jboss.dir} should be provided as
path.

2.5

MS SQL 2008

MS SQL 2008 server Enterprise edition will be used as the Database Server for the e-GP
system.
More details can be found on: http://www.microsoft.com/sqlserver/2008/en/us/

2.5.1 Download
MS SQL 2008 is a licensed project with Microsoft copyrights. It needs to be purchased with
licensing with various terms.

Purchasing Details: http://www.microsoft.com/sqlserver/2008/en/us/purchaseoptions.aspx

Trial version: http://www.microsoft.com/sqlserver/2008/en/us/try-it.aspx

2.5.2 Installation
Microsoft Corporation provides default support for the installation and configuration
maintenance.

The technical installation guide can be found at: http://technet.microsoft.com/enus/library/ms143219.aspx

2.5.3 Integration with NetBeans

NetBeans IDE allows integrating various databases to IDE.
1. Go to Services. Select New Connection.
6

e-Procurement Technologies Ltd

Development Environment Setup

2. Select driver.
3. Provide connection parameters.
http://netbeans.dzone.com/articles/netbeans-69-java-microsoft-sql explains about
NetBeans- MS SQL 2005 connection. The similar way the connection can be established.

2.6

Software Management Tool: Apache Maven

Apache Maven is a software project management and comprehension tool. Based on the
concept of a project object model (POM), Maven can manage a project's build, reporting and
documentation from a central piece of information.
e-GP infrastructure will use Maven 2.0.11.

2.6.1 Download
Maven can be downloaded from:
http://maven.apache.org/download.html

2.6.2 Installation:
Please refer to instillation guidelines provided with bundle.

2.6.3 Maven Repository

1. Local repository exists on developers machine and is maintained by the developer. It
is in sync with the maven repositories defined in the settings.xml in their .
{maven.dir}/.m2 folder. If no private remote internal repository is setup and listed in
the pom.xml file or settings.xml file, then this local repository on developers machine is
synchronized with the public maven repository.
2. Private Remote Internal Repository This repository which we will setup. We will change
the maven pom.xml or settings.xml to use this repository.
3 Public remote external repository This is the public external repository. By default,
maven synchronizes with this repository. Java.net, NetBeans and Maven provides such
kind of public repositories for global synchronization.

2.6.4 Integration with IDE

NetBeans IDE provides seamless integration facility with Maven tool. To integrate the
Maven, following procedure needs to be followed:
1. Select the Miscellaneous category in the Options window and click the Maven tab.
2. Specify the location of your local Maven installation.
3. Check that the location of the local Maven repository is correct.
4. Update and synchronize the Maven Local Repository with Central repository provided my
Maven.

2.6.5 Required Artifacts in the Repository

Basic framework libraries will be provided by the NetBeans upon project creation. Along with
that, the following libraries will be required in the repository for project development:
Library Name

Jar Name
7

e-Procurement Technologies Ltd

MS SQL Server 2008
Spring AOP
Spring Security
Hibernate Validator
Hibernate cache
Apache Commons

JSF Facelets
RichFaces
Log4j

Development Environment Setup

sqljdbc4.jar
aspectjweaver.jar
spring-security.jar
hibernate-validator-3.0.0.ga.jar
ehcache-1.2.3.jar
common-dbcp-1.3.jar
commons-collections-2.1.1.jar
commons-logging-1.0.4.jar
commons-pool.jar
commons-beanutils-1.8.0.jar
jsf-facelets-1.1.15.jar
richfaces-api-3.3.3-SNAPSHOT.jar
richfaces-impl-jsf2-3.3.3-SNAPSHOT.jar
richfaces-ui-3.3.3-SNAPSHOT.jar
log4j-1.2.16.jar
Table 1: External Libraries

Note:
After project import from SVN, the user will need to build the project which will also import
all the artifacts into the local repository via synchronization as required.

2.7

SVN Server

VisualSVN 2.1.3 will be used a Subversion Server tool.

2.7.1 Download
VisualSVN can be downloaded from:
http://www.visualsvn.com/server/download/

2.7.2 Installation
VisualSVN installation guide can be found on:
http://accidentaltechnologist.com/programming/simple-subverison-repository-setup-withvisualsvn-server/

2.8

SVN Client

e-GP development infrastructure will use TortoiseSVN 1.6.10 or higher as a Subversion

Client.

2.8.1 Download
TortoiseSVN can be downloaded from:
http://tortoisesvn.net/downloads

2.8.2 Installation
Please refer installation guidelines on :
http://www.shokhirev.com/nikolai/programs/SVN/svn.html#SubversionInstallation

2.8.3 Integration of VisualSVN with TortoiseSVN:

VisualSVN provides integration facility with Tortoise SVN client. The integration can be
performed as described at: http://rajibmahmud.wordpress.com/2009/01/09/work-withvisual-svn-server-tortoise-svn/
8

e-Procurement Technologies Ltd

Development Environment Setup

2.8.4 Integration with NetBeans

NetBeans allows integrating TortoiseSVN as default subversion client for the IDE. Integration
can be performed from: Team-> Subversion menu of NetBeans.
The other details of SVN IDE collaboration can be found at:
http://wiki.netbeans.org/TutorialUsingSVNLocalRepository

2.9

Apache Web Sever:

The Apache HTTP Server Project is a robust, commercial-grade and freely-available source
code implementation of an HTTP (Web) server.

For establishment of e-GP system Apache 2.2.16 will be used as the web server.

2.9.1 Download
Apache Web Server can be downloaded from:
http://httpd.apache.org/download.cgi#apache22

2.9.2 Installation
Please refer installation guidelines on:
http://httpd.apache.org/docs/current/install.html