1
|
Installing OPA-JAVA on WINDOWS
|
2
|
|
3
|
|
4
|
|
5
|
Hardware, Operating System and Networking Requirements
|
6
|
|
7
|
* Pentium III PC with 733 MHz CPU, or higher
|
8
|
* 512 MB RAM, or higher
|
9
|
* 10 GB free hard disk space
|
10
|
* Window 2000/2003 Server Operating System
|
11
|
* Access to Internet with lease line and broadband connection
|
12
|
|
13
|
Software Prerequisites
|
14
|
|
15
|
Software Components
|
16
|
|
17
|
1. Java (tm) 2 SDK, Standard Edition - version 1.4.2 or higher.
|
18
|
Download it at: http://java.sun.com/j2se/1.4.2/download.html
|
19
|
Download and/or follow the installation instructions
|
20
|
|
21
|
2. TOMCAT 5 or higher
|
22
|
Download it from: http://jakarta.apache.org/tomcat/index.html
|
23
|
|
24
|
3. Java Web Services Developer Pack 1.5 or higher
|
25
|
Download it from: http://java.sun.com/webservices/
|
26
|
Download and/or follow the installation instructions. Use TOMCAT as the container.
|
27
|
|
28
|
4.MySQL Version 4.1.x Database Server
|
29
|
Download it at:
|
30
|
http://www.mysql.com .Download and/or follow the installation instructions.
|
31
|
|
32
|
Also download the JDBC driver(s) for MySQL - mysql-connector-java-3.0.x-stable-bin.jar -
|
33
|
where 'x' is 8,9,10,11, etc. You may have to try one or more of them to find the one that
|
34
|
works for your installation. Download all and delete those not needed later.
|
35
|
|
36
|
5. Web Browser
|
37
|
Internet Explorer Version 6.0 or higher;
|
38
|
or Netscape 7.0 or higher; or FireFox 1.0 or higher
|
39
|
|
40
|
6. Download OPA
|
41
|
There are usually two zip files: the main application file and the help file. Download both
|
42
|
|
43
|
Important: Install required software in the order shown above, except for Web Browser
|
44
|
which probably was installed with the Operating System.
|
45
|
|
46
|
|
47
|
=======================================================================================
|
48
|
OPA-JAVA Installation
|
49
|
=======================================================================================
|
50
|
|
51
|
1. Unzip the zip file to some temporary folder.
|
52
|
|
53
|
2.Copy the MySQL driver ("mysql-connector-java-3.0.x-stable-bin.jar") downloaded above
|
54
|
to <JWSDP HOME>\common\lib\
|
55
|
|
56
|
* <JWSDP HOME> is the Java Web Services Developer Pack home folder
|
57
|
|
58
|
If there is difficulty connecting to the OPA database, it may be related to the
|
59
|
version of the driver. Download and try versions until you get the one that works
|
60
|
for your installation.
|
61
|
|
62
|
|
63
|
3. Copy the archive contents as follows:
|
64
|
|
65
|
=======================================================================================
|
66
|
database\ Folder
|
67
|
=======================================================================================
|
68
|
|
69
|
This folder contains the SQL scripts for creating tables and populating those
|
70
|
needed for initial startup. To run these scripts
|
71
|
|
72
|
1. Create the OPA-JAVA database
|
73
|
|
74
|
Start DOS Command Prompt
|
75
|
Change directory to the directory <MYSQL HOME>\bin
|
76
|
Enter the command "mysql -u root -p" and hit Enter.
|
77
|
Hit Enter again without entering a password.
|
78
|
Enter "create database opa;" and hit Enter
|
79
|
Enter "use opa;" and hit Enter
|
80
|
|
81
|
a. Run the create_db.sql script
|
82
|
Enter "source /folder/create_db.sql;" where /folder/ is the path to
|
83
|
the location of the SQL scripts. Hit Enter. The database tables are created.
|
84
|
|
85
|
NOTE: If your database is not named 'opa', edit the script and substitute the proper name.
|
86
|
|
87
|
b. In similar fashion run all the scripts in \database\data_inserts folder.
|
88
|
These scripts insert initial data in the database like languages, phrases, and default values.
|
89
|
|
90
|
=============================================================================================
|
91
|
opa\ Folder
|
92
|
==============================================================================================
|
93
|
|
94
|
This folder contains the OPA application files.
|
95
|
|
96
|
Copy "opa" subdirectory and paste as a subdirectory of <JWSDP HOME>\webapps\
|
97
|
|
98
|
The OPA directory now looks like
|
99
|
\opa\
|
100
|
\opa\admin\
|
101
|
\opa\archive\
|
102
|
and so on.
|
103
|
|
104
|
|
105
|
=============================================================================================
|
106
|
Help Files
|
107
|
==============================================================================================
|
108
|
|
109
|
Unzip the help zip file to some temporary folder.
|
110
|
|
111
|
Copy its content to
|
112
|
\opa\help\html\
|
113
|
where \opa\ is your application folder.
|
114
|
|
115
|
|
116
|
=============================================================================================
|
117
|
opa.xml file.
|
118
|
=============================================================================================
|
119
|
This is the configuration file for OPA Application
|
120
|
|
121
|
Copy this file to <JWSDP HOME>\webapps\ folder.
|
122
|
Edit the file using a text editor.
|
123
|
Use the "path" and "docBase " attributes to define the path to OPA application.
|
124
|
|
125
|
Example: path="/opa" docbase="opa" if your OPA application directory root is "opa".
|
126
|
|
127
|
Edit the database connections attributes.
|
128
|
|
129
|
For example if you are hosting you application on "localhost" and your database name is
|
130
|
"opajava" and your user id is "root" and you have no password, this section will look like:
|
131
|
|
132
|
<parameter>
|
133
|
<name>url</name>
|
134
|
<value>jdbc:mysql://localhost/opajava</value>
|
135
|
</parameter>
|
136
|
<parameter>
|
137
|
<name>username</name>
|
138
|
<value>root</value>
|
139
|
</parameter>
|
140
|
<parameter>
|
141
|
<name>password</name>
|
142
|
<value></value>
|
143
|
</parameter>
|
144
|
|
145
|
Save opa.xml.
|
146
|
|
147
|
If TOMCAT does not appear to recognize your application, edit /conf/server.xml.
|
148
|
Copy the contents of opa.xml into the section between the <Logger> tag and the </Host> tag.
|
149
|
|
150
|
===========================================================================================
|
151
|
|
152
|
1. Restart your computer.
|
153
|
|
154
|
2. Start Tomcat Servlet Container and Web Server
|
155
|
|
156
|
At the DOS prompt (Assume c:>
|
157
|
|
158
|
C:> cd <JWSDP HOME>\bin <enter>
|
159
|
C:><JWSDP HOME>\bin >catalina start <enter>
|
160
|
|
161
|
This starts the services needed to serve the web pages
|
162
|
|
163
|
|
164
|
3. Start OPA as Administrator/Reviewer
|
165
|
|
166
|
Start your Web Browser (Internet Explorer, Netscape , ...)
|
167
|
|
168
|
Enter on the address line:
|
169
|
|
170
|
http://localhost:8080/opa/admin (if using localhost)
|
171
|
http://nnn.nnn.nnn.nnn:8080/opa/admin (if using IP Address nnn.nnn.nnn.nnn)
|
172
|
http://abc.com:8080/opa/admin (if using Web Address abc.com)
|
173
|
|
174
|
Start OPA as Public User
|
175
|
|
176
|
Start your Web Browser (Internet Exploree, Netscape , ...)
|
177
|
|
178
|
Enter on the address line:
|
179
|
|
180
|
http://localhost:8080/opa/(if using localhost)
|
181
|
http://nnn.nnn.nnn.nnn:8080/opa/(if using IP Address nnn.nnn.nnn.nnn)
|
182
|
http://abc.com:8080/opa/(if using Web Address abc.com)
|
183
|
|
184
|
|