Scribd
Upload
66 views6 pages

Environmental Setup Document

The document provides steps to set up the environment for an e-Tax project including installing necessary components like Apache HTTPD server, JBoss application server, MySQL, and configuring them. Key steps include downloading and installing Java, MySQL, Apache HTTPD server, JBoss, configuring ports and properties files, building and deploying the e-Tax application code and starting the servers.

Uploaded by

Linkss Mk
Copyright
© Attribution Non-Commercial (BY-NC)
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOC, PDF, TXT or read online on Scribd
66 views6 pages

Environmental Setup Document

The document provides steps to set up the environment for an e-Tax project including installing necessary components like Apache HTTPD server, JBoss application server, MySQL, and configuring them. Key steps include downloading and installing Java, MySQL, Apache HTTPD server, JBoss, configuring ports and properties files, building and deploying the e-Tax application code and starting the servers.

Uploaded by

Linkss Mk
Copyright
© Attribution Non-Commercial (BY-NC)
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as DOC, PDF, TXT or read online on Scribd
You are on page 1/ 6

Environmental Setup

Document

e-Tax Project

Author:
Kulanthai Velu Sankaran
1. Components/exe required for setup:
a. Apache HTTPD server version 2.2.10
b. Jboss Application Server 4.0.5 GA
c. Apache-Jboss/Tomcat Connector 1.2.27
d. MySQL 5.0
e. MySQL Connector/J 5.0 for Java
f. Apache-Ant Build Tool

2. Steps:
The following steps will try to configure the components required in the path: C:\etax\.

a. Create a folder named “etax” in drive C:\


b. Download JDK 1.5.0_16 from the following URL:
JDK 1.5.0_16 download
c. Install JDK and JRE. Please do not change the default installation path that comes
with setup.
d. Download the MySQL 5.0 from the following URL:
MySQL 5.0 Server Download
Click on “No thanks, just take me to the downloads!”. Pick a mirror and
download the setup file.
e. Download the MySQL 5.0 GUI Tools from the following URL:
MySQL 5.0 GUI Tools
Click on “No thanks, just take me to the downloads!”. Pick a mirror and
download the setup file.
f. Install the above downloaded MySQL components in the path C:\etax\MySQL.
(After installation, MySQL 5.0 server will be installed in the path
C:\etax\MySQL\MySQL 5.0\ and the MySQL GUI Tools will be installed in the path
C:\etax\MySQL\MySQL 5.0 GUI Tools\
g. The configuration of MySQL server should be given as follows:
i. Port No : 3308 (non-prod env mysql port)
ii. Password for root : root
Please note that new user setup for application is still under progress and hence
root user will be used to access the db from application.
h. If the DB setup sql is attached, please follow the below procedure to setup data:
i. Initial setup requires DB creation.
ii. Goto Start -> Programs -> MySQL -> MySQL Server 5.0 -> MySQL
Command Line Client
iii. Provide password as “root”.
iv. Execute the following line:
create database etax;
v. Goto MySQL Administrator in Start -> Programs -> MySQL -> MySQL
Adminitrator.
vi. Connection parameters:
1. Host : localhost/the IP of the machine
2. Port : 3308
3. UserName : root
4. Password : root
vii. Click on “Restore” on the left navigation panel.
viii. Click on “Open backup file” in the right navigation panel.
ix. Browse and locate the latest sql file provided.
x. Click on “Start restore”.
i. Download Apache 2.2.10 from the following URL:
Apache 2.2.10 download
j. After download, install apache. Please choose to install as a manual service at
port 8080. Select custom installation and provide the install path as
C:\etax\apache\Apache_2.2.10\
k. After installation, we should change the port no to 22299 as one of jboss services
listen at 8080. Steps to change port #:
i. Edit the file C:\etax\apache\Apache_2.2.10\conf\httpd.conf
ii. Modify the below line:
Listen 8080
iii. Modify as:
Listen 22299
l. Download mod_jk 1.2.27 (connection file for apache and jboss/tomcat) from the
following URL:
i. mod_jk 1.2.27 download
ii. The file downloaded will have the filename as mod_jk-1.2.27-httpd-
2.2.10.so
iii. Rename the file as mod_jk.so and copy the file in the location
C:\etax\apache\Apache_2.2.10\modules\
m. Drop the following files at location C:\etax\apache\Apache_2.2.10\conf:

workers.properties mod-jk.conf uriworkermap.properties


n. The above property files contain connectivity parameters for connecting apache
with jboss and also configured to serve static files such as HTMLs, images and
CSS from webserver itself instead of loading the app server.
o. We need to initialize the httpd.conf to boot up the modjk during startup. Incluse
the following two lines at the very bottom of httpd.conf file.
# Include mod_jk configuration file
Include conf/mod-jk.conf

p. Copy the images and styles folder from latest release to


C:\etax\apache\Apache_2.2.10\htdocs\etax\

The folder structure should look like below:

q. Download jboss 4.0.5 GA from the following URL:


Jboss 4.0.5 GA download
r. Unzip and copy the jboss files to below location:
C:\etax\jboss\jboss-4.0.5.GA\
After copy, the folder structure should look like below:
Note that we might miss some JARs required for running our app. Please cross
check whether the attached jars are present at location C:\etax\jboss\jboss-
4.0.5.GA\lib\.

s. To make sure that jboss accepts connections from apache, modify the Engine
element of C:\etax\jboss\jboss-4.0.5.GA\server\default\deploy\jbossweb-
tomcat55.sar\server.xml as below:
<Engine name="jboss.web" defaultHost="localhost" jvmRoute="node1">

t. Locate the file C:\etax\jboss\jboss-4.0.5.GA\server\default\deploy\jbossweb-


tomcat55.sar\META-INF\jboss-service.xml file. Modify the attribute UseJK to
true by modifying the XML:
<attribute name="UseJK">true</attribute>

u. Download the MySQL connectivity jar from the following URL:


i. Download the complete ZIP file from: MySQL Conn Zip Download (Choose
any of the mirror provided)
ii. Unzip the file and locate the file “mysql-connector-java-5.0.8-bin.jar”.
iii. Copy the file to location

3. Let us now deploy the ear file (assuming the fact that ear is already in hand else we
would have to build one). Copy the etax.ear to location C:\etax\jboss\jboss-
4.0.5.GA\server\default\deploy\. Below are the steps to build and deploy the code:
a. Unzip the codebase zip sent and extract in the folder c:\etax\etax_ws
b. The folder structure looks like below:

c. Download the Apache-ant tool from the following location:


Apache-Ant Tool Download
d. Unzip the file in the location C:\etax\. The folder structure should look like
below:
e. Please make sure that build.properties in the location C:\etax\etax_ws\build\
contains the following attributes correctly set:
project.home=C:/etax/etax_ws
jboss.node1.home=C:/etax/jboss/jboss-4.0.5.GA

f. Open command prompt and enter the following commands one by one.
set path=%path%;C:\etax\apache-ant-1.7.1\bin;
cd C:\etax\etax_ws\build\
ant

4. Start the apache server by opening the httpd.exe file at location


C:\etax\apache\Apache_2.2.10\bin\httpd.exe
5. Create a file by the name startJBOSS.bat and copy the following lines to the bat file:
@echo off
set JAVA_HOME=C:\Program Files\Java\jdk1.5.0_16
set JBossHome=C:\etax\jboss\jboss-4.0.5.GA
set Path=%JAVA_HOME%\bin;%Path%
cd "%JBossHome%\bin"
run.bat
6. Run the file startJBOSS.bat and wait for the server to startup.
7. Hit the URL:
http://localhost:22299/etax/

You might also like