ParaDM Company Limited

ParaDM
Deployment Guide for Windows

Version 3.2.3

 Copyright 2008, ParaDM Company Limited

This document, which contains confidential material, is private and confidential and is the property and
copyright of ParaDM Company Limited (the company). No part of this document may be reproduced,
stored in a retrieval system or transmitted in any form or by any means, electronic, mechanical, chemical,
photocopy, recording or otherwise without the prior written permission of the company.
 Version Control

Version Control

Document Information
Prepared By Saichu Cheng

Date Prepared 05 September 2007

Reviewed By Saichu Cheng

Date Reviewed 10 September 2007

Version History
Date Version Author Description of Changes
Number

05 September 2007 3.2 Saichu Cheng Initial Release

03 January 2008 3.2.3 Saichu Cheng Enriched Contents with Different Web Application and
Database Servers

 Copyright 2008, ParaDM Company Limited 2 of 113

 Table of Contents

Table of Contents
VERSION CONTROL ............................................................................................ 2

TABLE OF CONTENTS ........................................................................................ 3

1 OVERVIEW ..................................................................................................... 5

2 PREPARATION OF PREREQUISITE SOFTWARE ................................... 6

2.1 Java Development Kit (GPL Third-party) ............................................................. 6
2.2 Application Server (GPL Third-party) ................................................................... 6
2.3 Application Server (Licensed Third-party) ............................................................ 6
2.4 Database Server (Licensed Third-party) ................................................................ 7
2.5 ParaDM System ....................................................................................................... 7

3 PREPARATION OF FOLDER HIERARCHY .............................................. 8

4 DEPLOYMENT OF DATABASE SERVER (EITHER ONE)....................... 9

4.1 MySQL..................................................................................................................... 9
4.1.1 Installation of MySQL Database Server......................................................................................9
4.1.2 Configuration of MySQL Database Server ...............................................................................14
4.1.3 Creation of ParaDM Database in MySQL ................................................................................21
4.2 MSSQL .................................................................................................................. 25
4.2.1 Creation of User Account in MSSQL........................................................................................25
4.2.2 Creation of ParaDM Database in MSSQL ................................................................................30
4.2.3 Creation of Database Schema for ParaDM ...............................................................................32
4.3 Oracle ..................................................................................................................... 37
4.3.1 Creation of New Database Instance for ParaDM System ........................................................37
4.3.2 Creation of Database User Schema ...........................................................................................48

5 DEPLOYMENT OF JAVA DEVELOPMENT KIT (TOMCAT ONLY).... 57

6 DEPLOYMENT OF WEB APPLICATION SERVER (EITHER ONE)..... 59

6.1 Tomcat ................................................................................................................... 59
6.1.1 Installation of Tomcat Web Application Server .......................................................................59
6.2 WebLogic ............................................................................................................... 63

 Copyright 2008, ParaDM Company Limited 3 of 113

 Table of Contents

6.2.1 Establishment of Weblogic Domain for ParaDM System........................................................63

6.2.2 Configuration of JVM for ParaDM Domain .............................................................................68
6.2.3 Security Configuration for WebLogic Application Server ......................................................71

7 DEPLOYMENT OF PARADM SYSTEM .................................................... 72

7.1 Uncompressing of ParaDM System....................................................................... 72
7.2 Configuration of Java Database Connection (JDBC) ........................................... 73
7.2.1 MySQL ........................................................................................................................................73
7.2.2 MSSQL ........................................................................................................................................74
7.2.3 Oracle ...........................................................................................................................................75
7.3 Configuration of ParaDM Debug Log Destination ............................................... 78
7.4 Deployment of ParaDM Webapp (Either One) .................................................... 79
7.4.1 Tomcat .........................................................................................................................................79
7.4.1.1 Testing for ParaDM System via Tomcat ..............................................................................83
7.4.2 WebLogic ....................................................................................................................................88
7.4.2.1 Testing for ParaDM System via WebLogic..........................................................................96
7.4.3 Websphere ...................................................................................................................................98
7.4.3.1 Start the ParaDM Application .............................................................................................111

 Copyright 2008, ParaDM Company Limited 4 of 113

 Chapter 1 - Overview

1 Overview
In this document, the installation procedure of Full functions of ParaDM system
version 3.2.X with MySQL, MSSQL and Oracle database and Tomcat, WebLogic and
Websphere Web Application Server in the same Windows 32-bit server machine will
be discussed. All paths discussed in this installation guide are predefined for simplicity.
Applications are recommended to be installed in the same partition of operation system
(usually C drive) while ParaDM system and storage of database should be installed in
another partition which has a bigger storage capacity (usually D drive). Those paths may
need to be changed according to the deployment server environment. The following
installation steps will be covered.

 Preparation of Prerequisite Software.

 Preparation of Folder Hierarchy.
 Deployment of Database Server.
 Deployment of Java Development Kit.
 Deployment of Web Application Server.
 Deployment of ParaDM System.

 Copyright 2008, ParaDM Company Limited 5 of 113

 Chapter 2 - Preparation of Prerequisite Software

2 Preparation of Prerequisite Software

Java Development Kit (GPL Third-party)
Producer Sun Microsystems

Version Java 2SE SDK 1.4.X Win32

Source http://java.sun.com/j2se/1.4.2/download.html

(This URL may be different if the third-party changes it)

File j2sdk-1_4_X_XX-windows-i586-p.exe

Target Location for Installation C:\J2SE1.4

Application Server (GPL Third-party)

Producer Apache

Version Tomcat 5.0.XX Win32

Source http://tomcat.apache.org/download-55.cgi

(This URL may be different if the third-party changes it)

File jakarta-tomcat-5.0.XX.exe

Target Location for Installation C:\TOMCAT5.0

Application Server (Licensed Third-party)

Producer WebLogic, Websphere

Version WebLogic 10.0.XX

Websphere 6.1.0.13 or above

Source http://tomcat.apache.org/download-55.cgi

(This URL may be different if the third-party changes it)

File jakarta-tomcat-5.0.XX.exe

Target Location for Installation C:\TOMCAT5.0

 Copyright 2008, ParaDM Company Limited 6 of 113

 Chapter 2 - Preparation of Prerequisite Software

Database Server (Licensed Third-party)

Producer MySQL, MSSQL, Oracle

Version MySQL 5.0.XX Win32

MSSQL 2005 (or MSSQL 2005 Express)
Oracle 10.2.0.1.XX

Source (MySQL only) http://dev.mysql.com/downloads/mysql/5.0.html

File (MySQL only) mysql-essential-5.0.XX-win32.msi

Target Location for Installation C:\MYSQL5.0

Remarks Please purchase a licensed copy or contact us for OEM

version.

ParaDM System
Producer ParaDM Company Limited

Version ParaDM System 3.2.X

Source CD from ParaDM Co. Ltd.

Files i. paradm-web-3.2.X.zip

ii. structure.sql, data.sql

Target Location for D:\ParaDM

Installation

 Copyright 2008, ParaDM Company Limited 7 of 113

 Chapter 3 – Preparation of Folder Hierarchy

3 Preparation of Folder Hierarchy

 Create a Root Directory “ParaDM” in D Drive.
 Create sub-directories “Backup”, “Data”, “DB”, “File" and “Log” into ParaDM.

 Create sub-directories “Archive”, “Index”, “ParaDOC”, “ParaFLOW” and

“ParaFORM” into “File”.

 The hierarchy should be like follows.

 Copyright 2008, ParaDM Company Limited 8 of 113

 Chapter 4 – Deployment of Database Server

4 Deployment of Database Server (Either One)

4.1 MySQL

4.1.1 Installation of MySQL Database Server

 Locate the “mysql-essential-5.0.XX-win32.msi” in windows explorer that you
have downloaded, and double click it. Click “Next” to proceed the installation.

 Copyright 2008, ParaDM Company Limited 9 of 113

 Chapter 4 – Deployment of Database Server

 Choose “Custom” and click “Next”.

 Click “Change” to modify the destination directory to “C:\MYSQL5.0”, and click

“Next”.

 Copyright 2008, ParaDM Company Limited 10 of 113

 Chapter 4 – Deployment of Database Server

 Click “Install” and “Next” until finishing the installation as below screens.

 Copyright 2008, ParaDM Company Limited 11 of 113

 Chapter 4 – Deployment of Database Server

 Copyright 2008, ParaDM Company Limited 12 of 113

 Chapter 4 – Deployment of Database Server

 When below windows prompts, check “Configure the MySQL Server now” in the
windows for the configuration of MySQL server. Click “Finish”.

 Copyright 2008, ParaDM Company Limited 13 of 113

 Chapter 4 – Deployment of Database Server

4.1.2 Configuration of MySQL Database Server

 Click “Next” when below windows prompts.

 Choose “Detailed Configuration” and click “Next”.

 Copyright 2008, ParaDM Company Limited 14 of 113

 Chapter 4 – Deployment of Database Server

 Choose “Server Machine” and click “Next”.

 Choose “Multifunctional Database” and click “Next”.

 Copyright 2008, ParaDM Company Limited 15 of 113

 Chapter 4 – Deployment of Database Server

 Set the InnoDB Tablespace location to be “D:\ParaDM\Data” and click “Next”.

 Choose “Online Transaction Processing (OLTP)” and click “Next”.

 Copyright 2008, ParaDM Company Limited 16 of 113

 Chapter 4 – Deployment of Database Server

 Check “Enable TCP/IP Networking” with Port Number “3306” and “Enable Strict
Mode”; then click “Next”.

 Choose “Best Support For Multilingualism” which is UTF8 by default, and click
“Next”.

 Copyright 2008, ParaDM Company Limited 17 of 113

 Chapter 4 – Deployment of Database Server

 Check “Install As Windows Service” with Service Name “MySQL”, and “Include
Bin Directory in Windows PATH”, and click “Next”.

 Check “Modify Security Settings” and provide a password for the account “root”; then
click “Next”.

 Copyright 2008, ParaDM Company Limited 18 of 113

 Chapter 4 – Deployment of Database Server

(Remember and keep secure for this password that will be used for database creation)

 Click “Execute”.

 Copyright 2008, ParaDM Company Limited 19 of 113

 Chapter 4 – Deployment of Database Server

 Click “Finish” to end the “MySQL Server Instance Configuration”.

 Copyright 2008, ParaDM Company Limited 20 of 113

 Chapter 4 – Deployment of Database Server

4.1.3 Creation of ParaDM Database in MySQL

 Go to the directory “C:\MYSQL5.0\” by windows explorer.
 Edit “my.ini” by notepad.
 Search the string “datadir” in this file, and change the directory to be
“D:/ParaDM/Data/”.
 Save and exit it.
 Copy all directories and files in “C:\MYSQL5.0\data” to “D:\ParaDM\Data”.
 Open the “Run” program in the “Start” menu; then input “services.msc” and press
“enter” button.

 Copyright 2008, ParaDM Company Limited 21 of 113

 Chapter 4 – Deployment of Database Server

 Browse the name “MySQL”, and restart this service.

 Copy “structure.sql” and “data.sql” into the directory “D:\ParaDM\DB” from

ParaDM’s CD.
 Open the “Run” program in the “Start” menu; then input “cmd” and press “enter”
button.

 Copyright 2008, ParaDM Company Limited 22 of 113

 Chapter 4 – Deployment of Database Server

 Input “mysql –u root -p”, and press “enter” button.

 Input the password which was created during installation of MySQL, press “enter”
button.

 Entered the MySQL console as follow.

 Copyright 2008, ParaDM Company Limited 23 of 113

 Chapter 4 – Deployment of Database Server

Create Database for ParaDM with the following commands except the sentence in (…).

CREATE DATABASE ParaDM;

USE ParaDM;

SOURCE D:\ParaDM\DB\structure.sql

SOURCE D:\ParaDM\DB\data.sql

-- Run this SQL if you are want to change the default physical files storage location

SET @PARADM_PATH='D:/ParaDM/file';

UPDATE SYS_PARAMETER SET PARAMETER_VALUE =

REPLACE(PARAMETER_VALUE,'D:/ParaDM/file',@PARADM_PATH) WHERE
PARAMETER_VALUE LIKE 'D:/ParaDM/file%';

UPDATE DMS_LOC_MASTER SET LOC_PATH=CONCAT(@PARADM_PATH,'/ParaDOC');

Grant privileges of the created database to a new user account as follow.

grant all privileges on ParaDM.* to 'paradm'@'localhost' identified by 'password';

(The above strings marked as RED colours may be different according to the
favourites from End User)
 ParaDM.* – refers to the database created above
 'paradm'@'localhost' – refers to the database granted to a user
“paradm” who can log on the MySQL in this local machine only
 'password' – refers to the logon password of the user “paradm”

 Copyright 2008, ParaDM Company Limited 24 of 113

 Chapter 4 – Deployment of Database Server

4.2 MSSQL

4.2.1 Creation of User Account in MSSQL

 Locate the “SQL Server Management Studio Express” under [All
Programs\Microsoft SQL Server 2005\] as follows.
(This version of database client is MSSQL 2005 Express)

 Copyright 2008, ParaDM Company Limited 25 of 113

 Chapter 4 – Deployment of Database Server

 Input the database server IP address or fully qualified domain name (FQDN)
and log on as system administrator.

 Click mouse right-button on “Logins” under Security and choose “New Login”.

 Copyright 2008, ParaDM Company Limited 26 of 113

 Chapter 4 – Deployment of Database Server

 Input “paradmuser” as Login name with the password under “SQL Server
authentication”, then check and uncheck “Enforce password policy” and “Enforce
password expiration” respectively as follows.
(The Login name can be any other you like, and remember this user account that
will be used later)

 Copyright 2008, ParaDM Company Limited 27 of 113

 Chapter 4 – Deployment of Database Server

 Click the “Server Roles” in the navigation panel in left-hand-side.

 Choose “sysadmin” for this user account to have full privileges.
(This example granted sysadmin right to allow deploy efficiently, or you may grant
less privileges to it if you are highly concerned)
 Click “OK” to finish the user account creation.

 Copyright 2008, ParaDM Company Limited 28 of 113

 Chapter 4 – Deployment of Database Server

 You can see the new user account is in the summary tab of details panel.

 Click “File” and “Disconnect Object Explorer” to disconnect this connection.

 Copyright 2008, ParaDM Company Limited 29 of 113

 Chapter 4 – Deployment of Database Server

4.2.2 Creation of ParaDM Database in MSSQL

 Click “New Query” to connect the database server.

 Input the created account information to log on.

 Copyright 2008, ParaDM Company Limited 30 of 113

 Chapter 4 – Deployment of Database Server

 Right Click “Databases” in “Object Explorer” and choose “New Database”.

 Type “ParaDM” as “Database name” and assign “paradmuser” (created before) to

be the owner of this database.
 Change the path for physical database storage (other than the same partition of OS
located).

 Click “Options” in navigation panel.

 Choose “Latin1_General_CI_AS”, “Simple”, “SQL Server 2005 (90)” to be
“Collation”, “Recovery model” and “Compatibility level” respectively.
 Click “OK” to finish.

 Copyright 2008, ParaDM Company Limited 31 of 113

 Chapter 4 – Deployment of Database Server

4.2.3 Creation of Database Schema for ParaDM

 Locate the database – ParaDM in “Object Explorer”.

 Right click the root directory of ParaDM database and choose “New Query”.

 Copyright 2008, ParaDM Company Limited 32 of 113

 Chapter 4 – Deployment of Database Server

 Copy “structure.sql” and “data.sql” into the directory “D:\ParaDM\DB”

from ParaDM’s CD.
 Use notepad to open the structure.sql in D:\ParaDM\DB\.
 Copy all contents from structure.sql, and paste onto the query analyser.

 Click “Execute” to create the database schema for ParaDM system.

 Copyright 2008, ParaDM Company Limited 33 of 113

 Chapter 4 – Deployment of Database Server

 Ensure no error message(s) shown on the message panel.

 Use notepad to open the data.sql in D:\ParaDM\DB\.

 Copy all contents from data.sql, and paste onto the SQL Query Analyser.
(filename may be different according to what product you purchased)
 Click “Execute” to insert data into the tables of the schema.

 The successful results show as follows.

 Copyright 2008, ParaDM Company Limited 34 of 113

 Chapter 4 – Deployment of Database Server

 Copy the following SQL statements into SQL Query Analyser for the update the
file location.
(The value of the path may be different if your folder hierarchy for the ParaDM
system is different to this document)

-- Run this SQL if you are want to change the default physical files storage
location
DECLARE @PARADM_PATH VARCHAR(100);
SET @PARADM_PATH = 'D:/ParaDM/file';
UPDATE SYS_PARAMETER SET PARAMETER_VALUE = REPLACE(PARAMETER_VALUE,
'D:/ParaDM/file', @PARADM_PATH) WHERE PARAMETER_VALUE LIKE
'D:/ParaDM/file%';

UPDATE DMS_LOC_MASTER SET LOC_PATH= @PARADM_PATH + '/ParaDOC'

 Copyright 2008, ParaDM Company Limited 35 of 113

 Chapter 4 – Deployment of Database Server

 Click “Execute” to update the physical file storage location of the ParaDM System.

 The successful results show as follows.

 Copyright 2008, ParaDM Company Limited 36 of 113

 Chapter 4 - Deployment of Database Server

4.3 Oracle

4.3.1 Creation of New Database Instance for ParaDM System

 Start the Oracle “Database Configuration Assistant”

 A Database Configuration Assistant Welcome page should then be shown up.

Click on the “Next” button to continue.

 Copyright 2008, ParaDM Company Limited 37 of 113

 Chapter 4 - Deployment of Database Server

 Select the “Create a Database” radio button and then click on the “Next” button.

 Select the “General Purpose” radio button and then click on the “Next” button.

 Copyright 2008, ParaDM Company Limited 38 of 113

 Chapter 4 - Deployment of Database Server

 Specify the new database details as follow:

Global Database Name: paradm
SID: paradm

Click on the “Next” button to continue.

 Select the “Configure the Database with Enterprise Manager” checkbox and select
the “Use Database Control for Database Management” radio button. Leave the
“Enable Email Notifications” and “Enable Daily Backup” checkboxes as blank.
Click on the “Next” button to move on.

 Copyright 2008, ParaDM Company Limited 39 of 113

 Chapter 4 - Deployment of Database Server

 Select the “Use the Same Password for All Accounts” radio button and enter your
password (Note: remember this password which will be used to login to the Oracle
Enterprise Manager).

 Select the “File System” radio button and then click on the “Next” button.

 Copyright 2008, ParaDM Company Limited 40 of 113

 Chapter 4 - Deployment of Database Server

 Select the “Use Common Location for All Database Files” radio button and enter
“D:\Oracle\Data” as the database files location. This means that all the ParaDM
database file will go into this directory.

 Select the “Specify Flash Recovery Area” checkbox and keep the default setting
for the “Flash Recovery Area” and “Flash Recovery Area Size” values. Click on
the “Next” button.

 Copyright 2008, ParaDM Company Limited 41 of 113

 Chapter 4 - Deployment of Database Server

 On the Sample Schemas tab, leave the “Sample Schemas” as blank. On the Custom
Scripts tab, select the “No Scripts to run” radio button and then click on the “Next”
button.

 Copyright 2008, ParaDM Company Limited 42 of 113

 Chapter 4 - Deployment of Database Server

 Keep every thing as the default values expect the “Character Sets” tab. Click on
the Character Sets” tab and specify the character sets as follow:

Select the “Use Unicode (AL32UTF8)” radio button

National Character Set: UTF8 – Unicode 3.0 UTF-8 Universal character set,
CESU-8…
Default Language: English
Default Date Format: United Kingdom

Click on the “Next” button to continue.

 Copyright 2008, ParaDM Company Limited 43 of 113

 Chapter 4 - Deployment of Database Server

 Copyright 2008, ParaDM Company Limited 44 of 113

 Chapter 4 - Deployment of Database Server

 Click on the “Next” button to continue.

 Copyright 2008, ParaDM Company Limited 45 of 113

 Chapter 4 - Deployment of Database Server

 Select the “Create Database” checkbox and leave the “Save as Database Template”
and “Generate Database Creation Scripts” as blank. Click on the “Finish” button to
move on.

 Click on the “OK” button to confirm the configuration and begin the creation.

 Copyright 2008, ParaDM Company Limited 46 of 113

 Chapter 4 - Deployment of Database Server

 Now the ParaDM Database instance is being created.

 Once its completed, a summary page will be shown up. Click on the “Exit” to
complete the creation.

 Copyright 2008, ParaDM Company Limited 47 of 113

 Chapter 4 - Deployment of Database Server

4.3.2 Creation of Database User Schema

 Start the Oracle Database Control of “paradm” instance.

 Copyright 2008, ParaDM Company Limited 48 of 113

 Chapter 4 - Deployment of Database Server

 Once you login, click on the “Administration” tab.

 Click on the “Users” action link under the “User & Privileges” section.

 Click on the “Create” button at top right hand corner,

 Enter the user details as follow:

Name: PARADM
Profile: DEFAULT
Authentication: Password
Enter Password: {Provide your own password}

 Copyright 2008, ParaDM Company Limited 49 of 113

 Chapter 4 - Deployment of Database Server

Confirm Password: {Provide your own password again}

Default Tablepsace: USERS
Temporary Tablespace: TEMP
Status: Unlocked

 Click on the “Roles” tab to modify the user roles. Select the “DBA” from the
Available Roles list and then click on the “Move” arrow to add to the Selected Roles
list.

 Copyright 2008, ParaDM Company Limited 50 of 113

 Chapter 4 - Deployment of Database Server

 Click on the “OK” button to confirm the modification. The DBA role should now be
shown in the User Roles list.

 Click on the “OK” to confirm the user creation.

 User “PARADM” should now be shown in the user list.

 Still in the Oracle Database Control of “orcl”. Under the “Administration” tab, click on
the “iSQLPlus” action link.

 Copyright 2008, ParaDM Company Limited 51 of 113

 Chapter 4 - Deployment of Database Server

 Select the Connect as “Normal” radio button and then click the “Continue” button.

 Login as “PARADM” user and keep the Connect Identifier as it is.

 Copyright 2008, ParaDM Company Limited 52 of 113

 Chapter 4 - Deployment of Database Server

 You should now be login to the “orcl” workspace.

 Copy the “structure.sql” from the database folder and then paste it into the text area.
Click on the “Execute” button to execute the SQL statement.

 Copyright 2008, ParaDM Company Limited 53 of 113

 Chapter 4 - Deployment of Database Server

 Once its executed, click on the “Clear” button to clean up the text area.

 Copy the “data.sql” from the database folder and then paste it into the text area. Click on
the “Execute” button to execute the SQL statement.

 Copyright 2008, ParaDM Company Limited 54 of 113

 Chapter 4 - Deployment of Database Server

 Once its executed, click on the “Clear” button to clean up the text area.

 Now update the file location by copy and paste the following command into the text
area. Click on the “Execute” button to execute the update.
-- Run this SQL if you are want to change the default physical files storage
location
DEFINE PARADM_PATH='D:/ParaDM/file';
UPDATE SYS_PARAMETER SET PARAMETER_VALUE = REPLACE(PARAMETER_VALUE,
'D:/ParaDM/file', '&PARADM_PATH') WHERE PARAMETER_VALUE LIKE
'D:/ParaDM/file%';
UPDATE DMS_LOC_MASTER SET LOC_PATH= CONCAT('&PARADM_PATH','/ParaDOC');

 Copyright 2008, ParaDM Company Limited 55 of 113

 Chapter 4 - Deployment of Database Server

 Now the ParaDM database has successfully been created.

 Copyright 2008, ParaDM Company Limited 56 of 113

 Chapter 5 - Deployment of Java Development Kit

5 Deployment of Java Development Kit (Tomcat Only)

 Locate the “j2sdk-1_4_X_XX-windows-i586-p.exe” in windows explorer that you
have downloaded, and double click it to proceed the setup.
 Choose “I accept the terms in the license agreement” and click “Next”.

 Click “Change…” to set the destination to be “C:\J2SE1.4\”, and click “Next”.

 Copyright 2008, ParaDM Company Limited 57 of 113

 Chapter 5 - Deployment of Java Development Kit

 Check “Microsoft Internet Explorer”, and click “Install”.

 Click “Finish” to complete the installation.

 Copyright 2008, ParaDM Company Limited 58 of 113

 Chapter 6 - Deployment of Web Application Server

6 Deployment of Web Application Server (Either One)

6.1 Tomcat

6.1.1 Installation of Tomcat Web Application Server

 Locate the “jakarta-tomcat-5.0.XX.exe” in windows explorer that you have downloaded,
and double click it.
 Click “Next” and “I Agree” to proceed the setup like below.

 Copyright 2008, ParaDM Company Limited 59 of 113

 Chapter 6 - Deployment of Web Application Server

 Choose “Custom” as the installation type and check “Service”; then click “Next”.

 Set the “Destination Folder” to be “C:\TOMCAT5.0”, and click “Next”.

 Copyright 2008, ParaDM Company Limited 60 of 113

 Chapter 6 - Deployment of Web Application Server

 Set “8080” for HTTP Connector Port, and the information for “Administrator Login”.
(Remember and keep highly secure for this password)

 Choose the “Java Virtual Machine” location as “C:\J2SE1.4”, and click “Install”.

 Copyright 2008, ParaDM Company Limited 61 of 113

 Chapter 6 - Deployment of Web Application Server

 Uncheck both “Run Apache Tomcat” and “Show Readme”; then click “Finish” to complete the
installation.

 Copyright 2008, ParaDM Company Limited 62 of 113

 Chapter 6 - Deployment of Web Application Server

6.2 WebLogic

6.2.1 Establishment of Weblogic Domain for ParaDM System

 In Weblogic Server, locate and click “Configuration Wizard” under [All Programs\BEA
Products\Tools] as follows.

 Copyright 2008, ParaDM Company Limited 63 of 113

 Chapter 6 - Deployment of Web Application Server

 Choose “Create a new WebLogic domain” and click “Next”.

 Choose “Generate a domain configured automatically to support the following BEA

products:” and uncheck “Workshop for WebLogic Platform”. Click “Next”.

 Copyright 2008, ParaDM Company Limited 64 of 113

 Chapter 6 - Deployment of Web Application Server

 Create an administrative account for the administration of this domain.

(This example used “weblogic” as username), and click “Next”.

 Choose “Production Mode” as “WebLogic Domain Startup Mode”, and “Sun SDK
1.X.X@C:\bea\jdk1XX_XX” as default JDK for this domain.(Version may be different to
the following figure), then click “Next”

 Copyright 2008, ParaDM Company Limited 65 of 113

 Chapter 6 - Deployment of Web Application Server

 Choose “No” and click “Next”.

 Input “ParaDM” as “Domain name” and “C:\bea\user_projects\domains” as “Domain

location”. Click “Create”.

 Copyright 2008, ParaDM Company Limited 66 of 113

 Chapter 6 - Deployment of Web Application Server

 Uncheck “Start Admin Server” and click “Done”.

 Copyright 2008, ParaDM Company Limited 67 of 113

 Chapter 6 - Deployment of Web Application Server

6.2.2 Turn off BASIC Authentication with Unsecured

Resources
 In order to enable WebDAV in Weblogic 9.2 or above, you need to turn off the application
server BASIC authentication.
 Add the <enforce-valid-basic-auth-credentials> element to config.xml within the
<security-configuration> element.

<security-configuration>
<enforce-valid-basic-auth-credentials>false</enforce-valid-basic-auth-cr
edentials>
</security-configuration>

 Start or restart all of the servers in the domain.

6.2.3 Configuration of JVM for ParaDM Domain

 Edit “setDomainEnv.cmd” in “C:\bea\user_projects\domains\ParaDM\bin” by notepad.
 Search “512” and find out the following statement.

set MEM_ARGS=-Xms256m -Xmx512m

 Change the statement as follows.

set MEM_ARGS=-Xms1024m –Xmx1024m

 Save and Exit the notepad.

 Start the Admin Server for ParaDM domain in WebLogic under
[All Programs\BEA Products\User Projects\ParaDM\Start Admin Server for WebLogic
Server Domain] as follows.

 Copyright 2008, ParaDM Company Limited 68 of 113

 Chapter 6 - Deployment of Web Application Server

 Copyright 2008, ParaDM Company Limited 69 of 113

 Chapter 6 - Deployment of Web Application Server

 The JVM heap size for ParaDM Domain showed as follows.

 Copyright 2008, ParaDM Company Limited 70 of 113

 Chapter 6 - Deployment of Web Application Server

6.2.4 Security Configuration for WebLogic Application Server

 In order to configure ParaDM System to work with the WebLogic security policy, the
following modifications have to be set.

i. Enable Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy in

Weblogic Sun JDK.
A. Make sure the Weblogic server is fully stopped.
B. Backup the local_policy.jar and US_export_policy.jar files from the “{Weblogic
Root Folder}\jdk150_11\jre\lib\security” directory
C. Copy the local_policy.jar and US_export_policy.jar from the “{ParaDM Webapp
Folder}\lib\weblogic” directory to “{Weblogic Root
Folder}\jdk150_11\jre\lib\security” directory
D. Copy the bcprov-jdk15-135.jar from the “{ParaDM Webapp Folder}\lib\weblogic”
directory to “{Weblogic Root Folder}\jdk150_11\jre\lib\ext” directory

ii. Modify Java Security File

A. Open the java.security file
(“{Weblogic Root Folder}\jdk150_11\jre\lib\security”) in edit mode
B. Add the following line right after the last segment of security provider
security.provider.7=org.bouncycastle.jce.provider.BouncyCastleProvider
(Note: security.provider.# will depend on the configuration)

Reference links:
http://www.mail-archive.com/[email protected]/msg01562.html
http://www.wso2.org/library/880 (Security Provider Configuration section)

 Copyright 2008, ParaDM Company Limited 71 of 113

 Chapter 7 - Deployment of ParaDM System

7 Deployment of ParaDM System

7.1 Uncompressing of ParaDM System
 Locate the “paradm-web-3.2.X.zip” from CD given by ParaDM Co. Ltd.
 Double click “paradm-web-3.2.X.zip” and uncompress it to the directory
“D:\ParaDM\Webapp”.

 Copyright 2008, ParaDM Company Limited 72 of 113

 Chapter 7 - Deployment of ParaDM System

7.2 Configuration of Java Database Connection (JDBC)

7.2.1 MySQL
 Edit the “struts-config.xml” by notepad located at
“D:\ParaDM\Webapp\WEB-INF” for the modification of the database connection
string.
 Search “<!-- MySQL Data Source -->”, and locate the following paragraph under
the string.

<set-property property="password"

value="1"/>

<set-property property="url"

value="jdbc:mysql://localhost:3306/eip?useUnicode=true&amp;characterEncoding=UTF-
8&amp;autoReconnect=true"/>

<set-property property="username"

value="root"/>

 Modify the values as follows; then save and exit the file.

<set-property property="password"

value="password"/>

<set-property property="url"

value="jdbc:mysql://localhost:3306/ParaDM?useUnicode=true&amp;characterEncoding=
UTF-8&amp;autoReconnect=true"/>

<set-property property="username"

value="paradm"/>

(The above four strings (values) marked as RED Colours are dependent on during
the creation of MySQL database and privileges of user account; therefore, the
values may be different.)

 Copyright 2008, ParaDM Company Limited 73 of 113

 Chapter 7 - Deployment of ParaDM System

7.2.2 MSSQL
 Edit the “struts-config.xml” by notepad located at
“D:\ParaDM\Webapp\WEB-INF” for the modification of the database connection
string.
 Search the following statements and ensure their sub-tabs are all commented.
<!-- MySQL Data Source -->
<!-- MS SQL Data Source using JTDS jdbc driver -->
<!-- Oracle Data Source -->
 Search the following statement and ensure its sub-tab is uncommented.
<!-- MS SQL Data Source using Microsoft jdbc driver -->
 Find the following statements under
<!-- MS SQL Data Source using Microsoft jdbc driver -->
<set-property property="password"
value="password"/>
<set-property property="url"

value="jdbc:sqlserver://localhost:1433;databaseName=paradm;selectMethod=cursor"/>
<set-property property="username"
value="ParaDM_User"/>
 Modify the values as follows; then save and exit the file.
<set-property property="password"
value="pass1234"/>
<set-property property="url"

value="jdbc:sqlserver://192.168.0.233:1433;databaseName=paradm;selectMethod=cursor"/>
<set-property property="username"
value="paradmuser"/>
(The above four strings (values) marked as RED Colours are dependent on the location and
the user account of MSSQL database server; therefore, the values may be different.)

 Copyright 2008, ParaDM Company Limited 74 of 113

 Chapter 7 - Deployment of ParaDM System

7.2.3 Oracle
 Edit the “struts-config.xml” by notepad located at
“D:\ParaDM\Webapp\WEB-INF” for the modification of the database connection
string.
 Comment out the default database connection. Search “<!-- MySQL Data Source
-->” and modify as following
<!-- MySQL Data Source -->

<!--

<data-source type="org.apache.commons.dbcp.BasicDataSource">

<set-property property="defaultAutoCommit"

value="false"/>

<set-property property="defaultReadOnly"

value="false"/>

<set-property property="description"

value="MySQL Data Source Configuration"/>

<set-property property="driverClassName"

value="com.mysql.jdbc.Driver"/>

<set-property property="maxActive"

value="60"/>

<set-property property="maxIdle"

value="3"/>

<set-property property="maxWait"

value="5000"/>

<set-property property="poolPreparedStatements"

value="true"/>

 Copyright 2008, ParaDM Company Limited 75 of 113

 Chapter 7 - Deployment of ParaDM System

<set-property property="maxOpenPreparedStatements"

value="500"/>

<set-property property="password"

value=""/>

<set-property property="url"

value="jdbc:mysql://localhost:3306/eip320?useUnicode=true&amp;characterEnc
oding=UTF-8&amp;autoReconnect=true"/>

<set-property property="username"

value="root"/>

<set-property property="logAbandoned"

value="true"/>

<set-property property="removeAbandoned"

value="true"/>

<set-property property="testWhileIdle"

value="true"/>

<set-property property="validationQuery"

value="SELECT NULL"/>

</data-source>

-->

 Uncomment the oracle database connection section. Search “<!-- Oracle Data
Source -->” and remove the comment tag “<!--" and “-->”.
 Locate the following paragraph under the string.

<set-property property="password" value="password"/>

<set-property property="url" value="jdbc:oracle:thin:@//127.0.0.1:1521/orcl"/>

<set-property property="username" value="paradm320"/>

 Copyright 2008, ParaDM Company Limited 76 of 113

 Chapter 7 - Deployment of ParaDM System

 Modify the values as follows; then save and exit the file.

<set-property property="password" value="password"/>

<set-property property="url"
value="jdbc:oracle:thin:@//127.0.0.1:1521/paradm"/>

<set-property property="username" value="paradm"/>

(The above four strings (values) marked as RED Colours are dependent on during the
creation of Oracle database and privileges of user account; therefore, the values may be
different.)

 Copyright 2008, ParaDM Company Limited 77 of 113

 Chapter 7 - Deployment of ParaDM System

7.3 Configuration of ParaDM Debug Log Destination

 Locate “D:\ParaDM\Webapp\WEB-INF\classes” in windows explorer, and use
notepad to edit “log4j.xml”; then find the following contents.
<appender name="ROLLING_FILE"
class="org.apache.log4j.DailyRollingFileAppender">

<param name="Threshold" value="INFO"/>

<param name="File" value="DebugLog.txt"/>

<param name="Append" value="true"/>

<param name="DatePattern" value="'.'yyyy-MM-dd"/>

<layout class="org.apache.log4j.PatternLayout">

<param name="ConversionPattern" value="%d %-5p [%c] %m%n"/>

</layout>

</appender>

<appender name="ROLLING_FILE"
class="org.apache.log4j.DailyRollingFileAppender">

<param name="Threshold" value="INFO"/>

<param name="File" value="D:/ParaDM/Log/DebugLog.txt"/>

<param name="Append" value="true"/>

<param name="DatePattern" value="'.'yyyy-MM-dd"/>

<layout class="org.apache.log4j.PatternLayout">

<param name="ConversionPattern" value="%d %-5p [%c] %m%n"/>

</layout>

</appender>

 Copyright 2008, ParaDM Company Limited 78 of 113

 Chapter 7 - Deployment of ParaDM System

7.4 Deployment of ParaDM Webapp (Either One)

7.4.1 Tomcat
 Open the “Configure Tomcat” program in the “All programs” from “Start”
menu.

 Make sure the value of “Startup type” is “Automatic”.

 Copyright 2008, ParaDM Company Limited 79 of 113

 Chapter 7 - Deployment of ParaDM System

 Press the tab “Java”, and input “1024” into both “Initial memory pool” (IMP) and
“Maximum memory pool” (MMP) respectively; then press “OK”.
(Value of MMP should be half of physical memory and cannot exceed 1024 in
Win32 System.)

 Open “notepad” by the “Run” program in the “Start” menu.

 Copyright 2008, ParaDM Company Limited 80 of 113

 Chapter 7 - Deployment of ParaDM System

 Copy the following contents into the notepad opened above.

<?xml version='1.0' encoding='utf-8'?>

<!-- This is a context path for ParaDM -->

<Context docBase="D:/ParaDM/Webapp" path="/ParaDM" reloadable="false">

</Context>

 Click “Save as…” to save this file into another destination.

 Copyright 2008, ParaDM Company Limited 81 of 113

 Chapter 7 - Deployment of ParaDM System

 Browse “C:\TOMCAT5.0\conf\Catalina\localhost” as destination, and type

“paradm.xml” as File name; then select “All Files” as “Save as type”. Click “Save”
and exit it.

 Go to “C:\TOMCAT5.0\conf”, and edit “server.xml” by notepad.

 Search the string “Define a non-SSL Coyote HTTP/1.1 Connector” in this file, and
locate the following paragraph under the string.

<Connector port="8080" maxThreads="150" minSpareThreads="25"

maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100"
debug="0" connectionTimeout="20000" disableUploadTimeout="true" />

 Append the string “URIEncoding="UTF-8"” at the end of the paragraph as follows.

Afterwards, Save and exit the file.

<Connector port="8080" maxThreads="150" minSpareThreads="25"

maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100"
debug="0" connectionTimeout="20000" disableUploadTimeout="true"
URIEncoding="UTF-8"/>

 Copyright 2008, ParaDM Company Limited 82 of 113

 Chapter 7 - Deployment of ParaDM System

7.4.1.1 Testing for ParaDM System via Tomcat

 Open the “Run” program in the “Start” menu, and input “services.msc”; then press
“enter” button.

 Locate and Start “Apache Tomcat” Service.

 Copyright 2008, ParaDM Company Limited 83 of 113

 Chapter 7 - Deployment of ParaDM System

 Open a browser and type

“http://{computer_name}:8080/ParaDM/admin/RefreshSysTableKey.do” into the
address bar. Press “enter” button to refresh all primary keys to correct values.
For instance, if the computer name is SV-017, type
http://SV-017:8080/ParaDM/admin/RefreshSysTableKey.do to open the page.
Sometimes, the following windows may prompt when using Internet Explorer (IE).
Click “Add” to allow the IE to access this web site.

 Click “Add” to put this Universal Resource Locator (URL) as a trusted web site.

 Copyright 2008, ParaDM Company Limited 84 of 113

 Chapter 7 - Deployment of ParaDM System

 Click “Close”.

 Copyright 2008, ParaDM Company Limited 85 of 113

 Chapter 7 - Deployment of ParaDM System

 Input “administrator” as “Login Name” and “password” as “Password” to login.

(Never disclose this username and password to Non-admin user(s). Remember to
change the password and keep this information highly secure after first
login.)

 After login, the contents should be like follows.

 Copyright 2008, ParaDM Company Limited 86 of 113

 Chapter 7 - Deployment of ParaDM System

 Type “http://{computer_name}:8080/ParaDM” and input administrator’s information

to login again.

 Once you find the following page prompts, the deployment finishes.

 Copyright 2008, ParaDM Company Limited 87 of 113

 Chapter 7 - Deployment of ParaDM System

7.4.2 WebLogic
 Be sure the following contents already into weblogic.xml (create this file if it is
unavailable) in D:\ParaDM\Webapp\WEB-INF
(In the following tab, the value in context-root will represent the context path of the
URL for ParaDM)

<weblogic-web-app>

<container-descriptor>

<prefer-web-inf-classes>true</prefer-web-inf-classes>

</container-descriptor>

<context-root>/ParaDM</context-root>

</weblogic-web-app>

 Open “Admin Server Console” in [All Programs\BEA Products\User

Projects\ParaDM]

 Copyright 2008, ParaDM Company Limited 88 of 113

 Chapter 7 - Deployment of ParaDM System

 Input the weblogic user account created above and click “Log In”.

 Copyright 2008, ParaDM Company Limited 89 of 113

 Chapter 7 - Deployment of ParaDM System

 Click “Deployments” under “Domain Structure”.

 Click “Lock & Edit”.

 Click “Install” button in the right-hand-side panel.

 Copyright 2008, ParaDM Company Limited 90 of 113

 Chapter 7 - Deployment of ParaDM System

 Choose the Location that stored the ParaDM Webapp in D:\ParaDM\.

 Select the radio named “Webapp” and click “Next”.

 Copyright 2008, ParaDM Company Limited 91 of 113

 Chapter 7 - Deployment of ParaDM System

 Choose “Install this deployment as an application” and click “Next”.

 Provide the Name “ParaDM” for this deployment, and click “Finish”.

 Copyright 2008, ParaDM Company Limited 92 of 113

 Chapter 7 - Deployment of ParaDM System

 Click “Activate Changes” in the left-hand-side panel.

 This deployment is activated.

 Copyright 2008, ParaDM Company Limited 93 of 113

 Chapter 7 - Deployment of ParaDM System

 Go back to “Deployments” and start its service by click “Serving all requests”.

 Copyright 2008, ParaDM Company Limited 94 of 113

 Chapter 7 - Deployment of ParaDM System

 Click “Yes” to confirm to start deployment.

 The “State” shows “Active” when the service is started.

 Copyright 2008, ParaDM Company Limited 95 of 113

 Chapter 7 - Deployment of ParaDM System

7.4.2.1 Testing for ParaDM System via WebLogic

 Open a browser and type
“http://{computer_name}:7001/ParaDM/admin/RefreshSysTableKey.do” into the
address bar. Press “enter” button to refresh all primary keys to correct values.
For instance, if the computer name is SV-017 or IP is 192.168.0.50, type
http://192.168.0.50:7001/ParaDM/admin/RefreshSysTableKey.do to open the page.

 Input “administrator” as “Login Name” and “password” as “Password” to login.

(Never disclose this username and password to Non-admin user(s). Remember to
change the password and keep this information highly secure after first login.)

 Copyright 2008, ParaDM Company Limited 96 of 113

 Chapter 7 - Deployment of ParaDM System

 Type “http://{computer_name}:7001/ParaDM” and input administrator’s

information to login again.

 Once you find the following page prompts, the deployment finishes.

 Copyright 2008, ParaDM Company Limited 97 of 113

 Chapter 7 - Deployment of ParaDM System

7.4.3 Websphere
 Important Notes: there is a critical bugs in Websphere version 6.1.0, please make
sure you have apply the latest patch to upgrade the Websphere to version 6.1.0.13 or
above.
 Create a war file. Add the ParaDM webapp to archive and name it “webapp.war”.

 Copyright 2008, ParaDM Company Limited 98 of 113

 Chapter 7 - Deployment of ParaDM System

 Start up the “Administrative Console” from your WebSphere application server

profile.

 Login as WebSphere application server administrator.

 Copyright 2008, ParaDM Company Limited 99 of 113

 Chapter 7 - Deployment of ParaDM System

 Copyright 2008, ParaDM Company Limited 100 of 113

 Chapter 7 - Deployment of ParaDM System

 Click on the “Install New Application” action link under the “Applications” panel.

 Copyright 2008, ParaDM Company Limited 101 of 113

 Chapter 7 - Deployment of ParaDM System

 Select the “Local file system” radio button and locate the “webapp.war” file you
have just created. In this case, the webapp.war file is in the D:\ParaDM\Webapp\
folder. Enter “ParaDM into the “Context root” text box and select the “Prompt me
only when additional information is required” radio button. Click on the “Next” to
continue the installation

 Copyright 2008, ParaDM Company Limited 102 of 113

 Chapter 7 - Deployment of ParaDM System

 In the “Select installation option” page, keep the setting as it is and only enter
“ParaDM” into the “Application name” text box. Click on the “Next” button to
continue.

 Copyright 2008, ParaDM Company Limited 103 of 113

 Chapter 7 - Deployment of ParaDM System

 In the “Map modules to servers” page, keep the setting as it is. Click on the “Next”
button to continue.

 In the “Map virtual hosts for web modules” page, keep the setting as it is. Click on
the “Next” button to continue.

 Copyright 2008, ParaDM Company Limited 104 of 113

 Chapter 7 - Deployment of ParaDM System

 Click on the “Finish” button to start the installation.

 Copyright 2008, ParaDM Company Limited 105 of 113

 Chapter 7 - Deployment of ParaDM System

 The status page is then shown up. Once the installation is done, your page should be
be the same as the following figure. Click on the “Manage Applications” action link
to configure the ParaDM application.

 Copyright 2008, ParaDM Company Limited 106 of 113

 Chapter 7 - Deployment of ParaDM System

 Click on the ParaDM application. Note: do not click on the “Save” button yet, we
will do so once the ParaDM application is well configured.

 Click on the “Class loading and update detection” action link under the Detail
Properties section.

 Copyright 2008, ParaDM Company Limited 107 of 113

 Chapter 7 - Deployment of ParaDM System

 Enter the setting as follow:

Polling interval for updated files: 10 Seconds
Class loader order: classed loaded with application class loader first
WAR class loader for application: Single class loader for application

Click on the “OK” button to confirm the setting.

 Copyright 2008, ParaDM Company Limited 108 of 113

 Chapter 7 - Deployment of ParaDM System

 Now the ParaDM application is well configuration. Click on the “Save” action link
to save the configuration.

 Copyright 2008, ParaDM Company Limited 109 of 113

 Chapter 7 - Deployment of ParaDM System

 Once the configuration is saved, a little red cross will be shown in the Application
Status column under the ParaDM application.

 Copyright 2008, ParaDM Company Limited 110 of 113

 Chapter 7 - Deployment of ParaDM System

7.4.3.1 Start the ParaDM Application

 Still in the “Administrative Console”, click on the “Enterprise Application” action
link under the “Applications” panel.

 Select the “ParaDM” checkbox and then click on the “Start” button to startup the
application.

 Copyright 2008, ParaDM Company Limited 111 of 113

 Chapter 7 - Deployment of ParaDM System

 Once its started, the Application Status will be changed to a green arrow.

 To test the application, open up the Internet Explorer and enter the following URL:
http://{Server IP Address}:9080/ParaDM
Note: by default, WebSphere will run the enterprise application under 9080 port.

 Copyright 2008, ParaDM Company Limited 112 of 113

 Chapter 7 - Deployment of ParaDM System

 Login as administrator, your screen should now be the same as the

following figure.

 Copyright 2008, ParaDM Company Limited 113 of 113