nTegrate (v1.

2) Installation Guide 1

Table of Content
Copyright Notice ..................................................................................................................................... 2
1 Pre-installation Description........................................................................................................ 3
1.1 Hardware Requirements .............................................................................................. 3
1.2 Software Requirements: (**: recommended)................................................................ 3
2 Installation of JRE 1.2.2............................................................................................................. 5
3 Installation of SonicMQ 2000.1 Enterprise Edition.................................................................... 6
4 Installation of SQL Server.......................................................................................................... 7
5 Installation of Sun JSDK 2.0...................................................................................................... 8
6 Installation of Apache ................................................................................................................ 9
7 Installation of Apache Tomcat.................................................................................................. 10
8 Installation of nTegrate .............................................................................................................11
9 Customization for SonicMQ 2000.1......................................................................................... 12
9.1 Configuration .............................................................................................................. 12
9.2 SonicMQ Database Installation .................................................................................. 13
9.3 Initiation ................................................................................................................... 13
9.4 Shutdown ................................................................................................................... 15
10 Customization for SQL Server................................................................................................. 16
11 Customization for Apache........................................................................................................ 19
12 Customization for Apache Tomcat........................................................................................... 20
13 Configuration File (ntegrate.conf) Settings.............................................................................. 22
14 Configuration of nTegrate Analyzer ......................................................................................... 25
15 Configuration of nTegrate Plug-ins .......................................................................................... 26
16 Other Environment Settings .................................................................................................... 28
17 nTegrate Server Invocation ..................................................................................................... 30
18 Upgrade nTegrate.................................................................................................................... 33
Appendix A: Configuration of nTegrate Cluster .................................................................................... 35
Appendix B: Shutdown nTegrate Server Gracefully ............................................................................. 36

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

2 nTegrate (v1.2) Installation Guide

Copyright Notice

Copyright © 2000 NetEmpower Software Technologies, Inc.™, all rights reserved. Printed in U.S.A.

nSolution™, nTegrate™, nProcure™ and nSchedule™ are trademarks of NetEmpower Software

Technologies, Inc.™.

Third-Party Trademarks: All other trademarks, trade names, product names or company names
referenced herein are used for identification only and are the property of their respective owners.

No part of this publication, with the exception of the software product user documentation contained on
a CD-ROM, may be copied, photocopied, reproduced, transmitted, transcribed, or reduced to any
electronic medium or machine-readable from without prior written consent of NetEmpower.

Licenses may duplicate the software product user documentation contained on a CD-ROM, but only to
the extent necessary to support the reproduction of the documentation, regardless of whether the
documentation is reproduced in whole or in part, must be accompanied by this copyright statement in
its entirety, without modification.

No warranty

The software, documents, information, and materials in this publication are provided "as is" without
warranty of any kind, either express or implied, including, but not limited to, the implied warranties of
merchantability, fitness for a particular purpose, or non-infringement.

The contents of this publication could include technical inaccuracies or typographical errors. Changes
are periodically added to the information herein; these changes will be incorporated in new editions of
the publication. NetEmpower Software Technologies may make improvements and/or changes in the
product(s) and/or the program(s) described in this publication at any time without notice.

U.S. GOVERNMENT RESTRICTED RIGHTS. It is acknowledged that the Software and the
Documentation were developed at private expense, that no part is in the public domain, and that the
Software and Documentation are Commercial Computer Software provided with RESTRICED RIGHTS
under Federal Acquisition Regulations and agency supplements to them. Use, duplication or
disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of
The Rights in Technical Data and Computer Software clause at DFAR 252.227-7013 et. seq. or
subparagraphs (c)(1) and (2) of the Commercial Computer Software restricted Rights at FAR
52.227-19, as applicable. Contractor is NetEmpower Software Technologies, Inc., 562 Weddell Drive
Suite 8, Sunnyvale, California 94089. Rights are reserved under copyright laws of the United States
with respect to unpublished portions of the Software.

NetEmpower Software Technologies, Inc. ™

562 Weddell Drive Suite 8
Sunnyvale, California 94089

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 3

1 Pre-installation Description

This installation guide can be used in server or client installation. In server CD package, it contains
both server and client. Before you install nTegrate, you must read the hardware and software
requirements carefully to reduce installation problems. In addition, it is very important for you to read
the license agreement enclosed with CD package.

Besides, with nTegrate v1.2, it’s possible for you to construct cluster machines to work as secondary
servers. For cluster machine installation, please refer to Appendix A in this Installation Guide.

1.1 Hardware Requirements

For nTegrate: (**: recommended)

Component Server Client

CPU Pentium III-600 or above (**) Pentium III-600 or above (**)
Memory Minimum 256MB or 512MB (**) Minimum 128MB or 256MB (**)
Hard Disk Minimum 700MB Minimum 50MB
Communication Internet connection Internet connection
VGA 256 color mode or higher 256 color mode or higher

For SonicMQ: (**: recommended)

Component Server
CPU Pentium III-600 or above (**)
Memory Minimum 256MB
Hard Disk Minimum 500MB
Communication Internet connection
VGA 256 color mode or higher

1.2 Software Requirements: (**: recommended)

Component Server Client
One of the followings:
Operating NT Server 4.0, Service Pack 5 or above
NT Workstation 4.0, Service
System (OS) (e.g. SP6a, **) Pack 5 or above (e.g. SP6a, **)

Windows 98
Runtime Sun Java Runtime Environment 1.2.2 Sun Java Runtime Environment
Environment (JRE 1.3 is not applicable) 1.2.2 (JRE 1.3 is not applicable)
Data Base MS SQL 7.0 Standard Edition N/A
Apache Server 1.3.12
Web Server N/A
Jserv 1.1.2

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

4 nTegrate (v1.2) Installation Guide

Browser MS Internet Explorer 5.0 or above MS Internet Explorer 5.0 or above

Sonic MQ 2000.1 Enterprise Edition
Messaging Ware N/A
(Patch Build 1815)

Note: Copies of Apache Web Server, Java Virtual Machine, and JDK 1.2.2 may be downloaded from
Apache's and Sun's websites.

Besides the standard plug-ins provided by nTegrate, to enable business processes, the required new
application development is performed under Java Development Kit (currently JDK 1.2.2) and Java
Servlet Development Kit (currently JSDK 2.0) Environment.

The clients with the H/W and S/W requirements mentioned above can conduct system administration,
process building, and process management. Process performers who conduct just approval processes
need only a web-enabled environment (connecting to Internet) to perform the approval processes.

The hardware requirement for SonicMQ is mandatory for B2B scenario (i.e., multiple partners involved),
but is optional for the case of single company. For the former scenario, SonicMQ must be on the DMZ
(De-Militarized Zone), i.e., between firewall and Intranet, so that SonicMQ can be accessed from
Internet. Therefore, it is strongly recommended (or mandatory for customer security sake) to have
SonicMQ and nTegrate separated, i.e., SonicMQ at DMZ and nTegrate at intranet. For the later
scenario, it is fine to have nTegrate and SonicMQ on the same machine. However, because SonicMQ
requires at least 256MB memory, it is recommended to have 512 MB memory on that machine.

nTegrate server is Web-enabled to use URL for file access. Therefore, a Web server (i.e., Apache
Server 1.3.12) should be installed on the same machine as nTegrate server, especially for this release
V1.0. It is not required to have the nTegrate repository database (i.e., MS SQL 7.0 Standard Edition)
installed on the same machine.

To enable business processes, the required application programs provided by System Integration team
or in-house IT team are developed under Java Development Kit (currently JDK 1.2.2) and Java Servlet
Development Kit (currently JSDK 2.0) Environment. These application programs include Java servlets
to kick off process models and/or to perform approval activities from Web servers. These Web servers
can be located at intranet or DMZ.

The clients with the above-mentioned hardware and software requirements can conduct system
administration, process building, and process management. Those process performers, who just
conduct approval activities, only need a web-enabled environment (connecting nTegrate server via
Internet) to perform the tasks.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 5

2 Installation of JRE 1.2.2

JRE (Java Runtime Environment) 1.2.2 for Windows is freeware.

2.1 Run jre1_2_2_-006-win-i.exe to install JRE 1.2.2.

If installed with default value, it will be installed under c:\Program Files\JavaSoft\JRE\1.2. It’s
subject to change according to your change while installation. <JREInstalledLocation> will
be used later in this Installation Guide to represent where you install your JRE.

You may also install JDK 1.2.2 instead of JRE1.2.

Next, you need to relax security checking within its Java2 VM for RMI calls in nTegrate:

2.2 Add two more permission lines into c:\Program Files\JavaSoft\JRE\1.2\lib\security\java.policy

(or <JREInstalledLocation>\lib\security\java.policy ) for JRE1.2; or
<jdkInstalledLocation>\jre\lib\security\java.policy for JDK 1.2.2.:

(A) Find the following statement:

grant { permission java.security.AllPermission; };

(B) Add two lines and make it become:

grant {
permission java.security.AllPermission;
permission java.lang.RuntimePermission "modifyThread";
permission java.lang.RuntimePermission "modifyThreadGroup";
};

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

6 nTegrate (v1.2) Installation Guide

3 Installation of SonicMQ 2000.1 Enterprise

Edition

3.1 Run \SonicMQ\setup.bat

If installed with default value, it will be installed under c:\Program Files\Progress_SonicMQ. It’s
subject to change according to your change while installation. <SonicMQInstalledLocation>
will be used later to represent the really location where you install your SonicMQ.

3.2 Run \SonicMQ\Patch\setup.bat

(A) Click Next in the “Welcome” window.

(B) Click “Accept all terms of the license” and click Next in the “Agreement for Software
License” window.

(C) Enter the License Key and click Next in the “Control Number” window.

(D) Click Next in the “Product Information” window.

(E) Click Next in the “README Information” window.

(F) Click Next in the “Broker Information” window.

(G) Click Install with the same Installation Path as step 3.1 in the “Installation Directory”
window.

(H) Click Yes to All in the “Copy Files” window.

(I) Select Update Existing DB in the “Install database SonicMQDB” window.

(J) Click Finish in the “Installation Complete” window.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 7

4 Installation of SQL Server

4.1 Run \SQL7.0\setup.bat to install SQL Server.

(A) Select Local Install and click Next in the “Select Install Method” window.

(B) Click Next in the “Welcome” window.

(C) Click Yes in the “Software License Agreement” window.

(D) Enter company and name and click Next in the “User Information” window.

(E) Enter the License Key and click OK in the “Setup” window.

(F) Click OK in another “Setup” window.

(G) Select Typical and click Next in the “Setup Type” window.

(H) Select your choice and click Next in the “Services Accounts” window.

(I) Click Next in the “Start Copying Files” window.

(J) Select the choices in the “Select Privilege Mode” window as follows:

(i) Click “Every Server”.

(ii) Click “Add”.

(iii) Input the number of connections. It should not be less than five (5). Ten (10) is
about the number. Click OK.

(iv) Check the agreement box. Click OK.

(v) Click Continue.

(K) Click Continue in the “Select Privilege Mode” window.

(L) Click Finish in the “Setup Complete” window.

If installed with default value, it will be installed under c:\MSSQL7. It’s subject to change
according to your change while installation. <SQLInstalledLocation> will be used later to
represent the really location where you install your SQL Server.

4.2 Re-start your computer when SQL Server Setup program prompts you to.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

8 nTegrate (v1.2) Installation Guide

5 Installation of Sun JSDK 2.0

JSDK (Java Servlet Development Kit) 2.0 is freeware.

5.1 Run JSDK20-Win32.exe to install.

(A) Click Next in the “Welcome” window.

(B) Click Next in the “Choose Destination Location” window.

(C) Click Finish in the “Setup Complete” window.

If installed with default value at step (B), it will be installed under c:\JSDK2.0. It’s subject to
change according to your change while installation. <JSDKInstalledLocation> will be used
later to represent the really location where you install your JSDK.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 9

6 Installation of Apache

Apache Server 1.3.12 is freeware.

6.1 Run Apache_1_3_12_win32.exe to install.

(A) Click Next in the “Welcome” window.

(B) Click Yes in the “Software License Agreement” window.

(C) Click Next in the “Information” window.

(D) Click Next in the “Choose Destination Location” window.

(E) Select Typical and click Next in the “Setup Type” window.

(F) Click Next in the “Select Program Folder” window.

(G) Click Finish in the “Complete” window.

If installed with default value at step (D), it will be installed under c:\Program Files\Apache
Group\Apache. It’s subject to change according to your change while installation.
<ApacheInstalledLocation> will be used later to represent the really location where you
install your Apache.

You may start Apache web server as an independent program or a service in Windows NT.

 To start Apache later after installation successfully, select Start | Program Files | Apache Web
Server and click Start Apache.

 To stop Apache, choose STOP Apache.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

10 nTegrate (v1.2) Installation Guide

7 Installation of Apache Tomcat

For using Generic Servlet, it is necessary to install Tomcat Servlet Container. Jakata-tomcat-3.2.1 is
freeware.

7.1 Extract jakarta-tomcat-3.2.1.zip to the machine where web server resides. You can find this file
in nTegrate third-party freeware CD. For example, you may extract to the C: drive, and then a
new folder \jakarta-tomcat-3.2.1\ will automatically be created.

7.2 If you install Apache as your web server, then follow the direction of the file named
tomcat-apache-howto.html. You can find this file under \jakarta-tomcat-3.2.1\doc.

If you install IIS as your web server, then follow the direction of the file named
tomcat-iis-howto.html, which is under the same directory. If you install IIS, then you need an
extra file when you're installing tomcat. You need to copy isapi_redirect.dll from CD to your
hard drive.

7.3 Use the sample registry file in CD and modify the path where isapi_redirect.dll resides. Then
double-click the registry file to add it into registry.

7.4 To start tomcat, type startup under \jakarta-tomcat-3.2.1\bin\.

To stop tomcat, type shutdown.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 11

8 Installation of nTegrate

Note: You should have installed all the necessary third-party software packages by now before you
start installing nTegrate. The necessary third-party software may be installed on a remote machine.
Configure their IPs carefully in the later chapters.

8.1 Insert your nTegrate CD into CD-ROM drive. It will automatically invoke SETUP program.

8.2 Click Next in the “Welcome” window. Click Yes in the “License Agreement” window.

8.3 Enter your name, your company name, and the serial number. Click Yes in the “Customer
Information” window.

The Serial Number is labeled on nTegrate license agreement. For Evaluation Copy, you may
enter whatever you like in the serial number column.

8.4 Click Next in the “Pre-Installation Notice” window.

8.5 Click Next in the “Hardware Information” window.

8.6 Click Next in the “Software Information” window.

8.7 Choose “Client” or “Server” and click Next in the “Setup Type” window.

8.8 Click Next in the “Choose Destination” window.

You may change the destination location by clicking Browse.

8.9 Click Next in the “Select Program Folder” window.

8.10 Click Next in the “Please check your setup settings” window.

8.11 Click Finish in the “InstallShield Wizard Complete” window.

It will automatically invoke NOTEPAD to open the README file.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

12 nTegrate (v1.2) Installation Guide

9 Customization for SonicMQ 2000.1

9.1 Configuration
9.1.1 Open the file c:\Program Files\Progress_SonicMQ\broker.ini (or
<SonicMQInstalledLocation>\broker.ini ).

(A) Enable the security by changing:

ENABLE_SECURITY=false
into

ENABLE_SECURITY=true

(B) Uncomment the following SSL encryptions by removing the semi-colon (;) in front of
each line and becoming:

SSL_CERTIFICATE_CHAIN=certs/serverCertChain.chain
SSL_PRIVATE_KEY=certs/serverKey.pkcs8
SSL_PRIVATE_KEY_PASSWORD=Pass Phrase

(C) Comment out the setting of DEFAULT_SOCKET_TYPE by insert a semi-colon at the

beginning of that line, as

;DEFAULT_SOCKET_TYPE=tcp
;DEFAULT_SOCKET_TYPE=http
;DEFAULT_SOCKET_TYPE=ssl

(D) Add the following statements:

NUM_ACCEPTORS=3
;
IP_OR_HOST_1=192.168.0.23
DEFAULT_SOCKET_TYPE=tcp
PORT=2506
;
IP_OR_HOST_2=192.168.0.23
SOCKET_TYPE_2=ssl

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 13

PORT_NUMBER_2=2507
;
IP_OR_HOST_3=192.168.0.23
SOCKET_TYPE_3=http
PORT_NUMBER_3=2508

192.168.0.23 is the IP address. Type ipconfig at MS-DOS prompt to find out your own
IP address. Replace all the “192.168.0.23” in the above example with your own IP.

For nTegrate server, the following three protocols and ports are supported as default:
port 2506 for TCP, port 2507 for SSL, and port 2508 for HTTP. It is recommended to
use those default settings. If you plan to change the settings, please make sure
nTegrate administrators are well informed.

(E) Save and exit the broker.ini file.

9.2 SonicMQ Database Installation

Under a MS-DOS window, go to c:\Program Files\Progress_SonicMQ\bin> (or
<SonicMQInstalledLocation>\bin> ), type the following commands, and press ENTER after
each.

c:\Program Files\Progress_SonicMQ> set path bin;

c:\Program Files\Progress_SonicMQ\bin> dbtool /d basic
c:\Program Files\Progress_SonicMQ\bin> dbtool /cs basic
c:\Program Files\Progress_SonicMQ\bin> dbtool /c security

9.3 Initiation
9.3.1 Click Start | Program Files | Progress SonicMQ | Start broker.

9.3.2 Click Start | Program Files | Progress SonicMQ | Explorer.

9.3.3 Click the Message Brokers folder in the left pane. In the right pane:

(A) At Broker Host, enter x.x.x.x:2506.

Note: x.x.x.x represents your own IP address. It can be found by typing ipconfig under
a DOS prompt.

(B) At Connect ID, type a name for naming the connection (for example, your name).
(C) At User, type "Administrator". At Password, type ”Administrator”. Click Connect.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

14 nTegrate (v1.2) Installation Guide

Note: The User and Password fields are case-sensitive.

(D) Double-click the “Message Brokers” folder in the left pane to expand. Click Users in
the left pane.

(E) In the User Maintenance group on the right, click New, enter “nTegrate” in all the three
boxes, and click Update when finished.

Note: User name and password are case-sensitive.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 15

9.4 Shutdown
(A) Click Message Brokers in the left pane,

(B) Click the row in the lower right area to highlight the row (as shown in the figure in Step
C).

(C) Click Shutdown. Click Yes to confirm.

It takes around 30 seconds to bring down SonicMQ.

Note: Do not abort it by pressing Control-C.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

16 nTegrate (v1.2) Installation Guide

10 Customization for SQL Server

You are recommended to create two databases, “nTegrate” and “nTegrateBackup”. So that your
nTegrate Administrator can backup data in “nTegrate” to “nTegrateBackup” periodically. Section 11.1
shows the steps of creating the database “nTegrate”.

10.1 Login to the SQL Server 7.0, and then add a new database “nTegrate”:

(A) Click Start | Program Files | Microsoft SQL Server 7.0 | Enterprise Manager.
(B) In the left pane of following Console Root window, double-click “Microsoft SQL
Servers”, double-click “SQL Server Group”, double-click the site name where your
SQL Server resides. You might need to wait for a while to get connected.
(C) Right-click Databases and select New Database.

(D) Type “nTegrate” in the Name box and click OK.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 17

10.2 Run scripts to install all nTegrate meta tables in the newly-created database “nTegrate”:

(A) On the Tools menu, select SQL Server Query Analyzer.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

18 nTegrate (v1.2) Installation Guide

(B) Select “nTegrate” in the DB list.

(C) Open c:\nTegrate\dbscript\Mssql\nTegrate_Install.sql. (or
<nTegrateInstalledLocation>\dbscript\Mssql\nTegrate_Install.sql ).

(D) Run it by clicking the green triangle-arrow button.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 19

11 Customization for Apache

11.1 nTegrate uses Apache internally as a file server. There are two Aliases in
c:\nTegrate\ntegrate.conf, which need to be set before it can work correctly. These two Aliases
point to the real file system directories where the business document DTDs and JavaScripts
are stored. They are

negrate.bdocmgr.bdocDtdBase c:\\nTegrate\\bdoctypes
and

ntegrate.jsmgr.JSBase c:\\nTegrate\\javascripts

Note: The double backslash is needed on Windows NT to escape the special meaning of
backslash.

11.2 Another set of properties in the nTegrate.conf specifies how nTegrate should use Apache as
the file server; in other words, what prefix should nTegrate use to form the URLs for the
resources it need. These should be consistent with the Apache configuration file changes as
described below. For example,

negrate.bdocmgr.bdocURLBase 192.168.0.12/bdocs
and

ntegrate.jsmgr.JSURLBase 192.168.0.12/javascripts

Note: The words “bdocs” and “javascripts” here are the aliases that need to be defined in
Apache’s configuration file, as described below.

11.3 Add the following lines into the Alias section of c:\program_files\Apache
Group\Apache\conf\httpd.conf (or <ApacheInstalledLocation>\conf\httpd.conf ):

Alias /bdocs/ "c:/ntegrate/bdoctypes/”

Alias /javascripts/ “c:/ntegrate/javascripts/”

Note: The alias names “bdocs” and “javascripts” must match exactly, including cases, with
the URLBase names described previously. The leading and ending “/”s are also required.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

20 nTegrate (v1.2) Installation Guide

12 Customization for Apache Tomcat

Modify c:\Program Files\tomcat\bin\tomcat.bat (or <TomcatInstalledLocation>\bin\tomcat.bat ).

12.1 Insert the following lines at the beginning of the file.

set JAVA_HOME=F:\jdk1.2.2

set TOMCAT_HOME=F:\Program Files\tomcat

and make it like:

set JAVA_HOME=F:\jdk1.2.2
set TOMCAT_HOME=F:\Program Files\tomcat

set _CP=%CP%
set _TOMCAT_HOME=%TOMCAT_HOME%
set _CLASSPATH=%CLASSPATH%

F:\jdk1.2.2 is subject to where you install your JDK in Chapter 2.

F:\Program Files\tomcat is subject to where you installed your tomcat in Chapter 7.

12.2 Modify Classpath to use Apache’s XML Parser Xerces by inserting the following lines under
the :dynClasspath label.

set _LIBJARS=%_LIBJARS%;D:\nTegrate\lib\xerces.jar

and make it like:

:dynClasspath

set _LIBJARS=%_LIBJARS%;D:\nTegrate\lib\xerces.jar

for %%i in (%TOMCAT_HOME%\lib\*.jar) do call

%TOMCAT_HOME%\bin\cpappend.bat %%i

12.3 Under \nTegrate, gnumake all to generate nTegrate\tools\ntegrateWebApp.war. Copy it to

Tomcat\webapps\.

12.4 For the first time, when start Tomcat, a folder Tomcat\webapps\ntegrateWebApp\ will be
generated. Beneath it, there will be the following files or folders existing.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 21

Tomcat\webapps\ntegrateWebApp\util.js
Tomcat\webapps\ntegrateWebApp\webapp_approval.properties
Tomcat\webapps\ntegrateWebApp\WEB-INF
Tomcat\webapps\ntegrateWebApp\WEB-INF\classes
Tomcat\webapps\ntegrateWebApp\WEB-INF\classes\com
Tomcat\webapps\ntegrateWebApp\WEB-INF\lib
12.5 Copy the following files to Tomcat\webapps\ntegrateWebApp\WEB-INF\lib\
jgo.jar
ntegrate.jar
ntegrateMesgs.jar
xalan.jar
xerces.jar
12.6 For Windows Platform,

<nTegrateInstalledLocation>\samples\webapps\approval\> compileapp.bat

-or-
For Unix PlatForm, execute compileapp.sh .
12.7 Copy \nTegrate\samples\webapps\approval\*.class to
Tomcat\webapps\ntegrateWebApp\WEB-INF\classes\
12.8 Re-start Tomcat
12.9 Re-start Apache Web Server

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

22 nTegrate (v1.2) Installation Guide

13 Configuration File (ntegrate.conf) Settings

Use Notepad to open c:\nTegrate\ntegrate.conf (or <nTegrateInstalledLocation>\ntegrate.conf if you

didn’t install with default location value.)

13.1 The value of “ntegrate.serialNumber” is the serial number of your nTegrate package. It is
generated automatically. Don't modify it.

13.2 Change the property value of “ntegrate.mqLocalIP” (x.x.x.x) to your SonicMQ IP address.

13.3 For MQ ThinLayer configuration, change the following default values

ntegrate.MQType SonicMQ
#ntegrate.MQType SwiftMQ

to

#ntegrate.MQType SonicMQ
ntegrate.MQType SwiftMQ

13.4 For nTegrate performance tuning, you may change three parameters:

ntegrate.maxExecPerEngine 20
ntegrate.heartBeatInterval 30000
ntegrate.engineReportTime 10000

“ntegrate.maxExecPerEngine” is to adjust how many process model instances can be run per
engine. If you want very high fault tolerance, set it to 1.

“ntegrate.heartBeatInterval” is to tell the process engine manager how often to check for
engine failures. The value is in milliseconds. Recommended value is 3 times the value of
engineReportTime.

“ntegrate.engineReportTime” is to tell the process engine how often to report to the process
engine manager that it is alive. The value is in milliseconds.

13.5 Change ntegrate.emulation to OFF unless you want to enable the process emulation. The
default value is ON.

13.6 Change the property value of “ntegrate.bdocmgr.bdocDtdBase” to c:\\ntegrate\\bdoctypes (or

<nTegrateInstalledLocation>\\bdoctypes ). Don’t forget to use double backslash.

ntegrate.bdocmgr.bdocDtdBase c:\\ntegrate\\bdoctypes

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 23

13.7 Change the property value of "ntegrate.jsmgr.JSBase" to c:\\ntegrate\\javascripts (or

<nTegrateInstalledLocation>\\ javascripts ). Don’t forget to use double backslash.

ntegrate.jsmgr.JSBase c:\\ntegrate\\javascripts

13.8 If you will choose "Certificate Request Form" when you create company profile later, you need
to enable the function now. Put the comment character "#" in front of the "SUNKeyTool" line
and remove the "#" at the beginning of the "RSAKeyTool" line.

#ntegrate.securitymgr.keystore.module SUNKeyTool
ntegrate.securitymgr.keystore.module RSAKeyTool

13.9 Change the property value of "dbmgr.ntegrate.maxconns" if you want more connections
between nTegrate and the database.

13.10 For "dbmgr.ntegrate.url jdbc:JTurbo://192.168.0.0:1433/ntegrate/sql70=true/charset=Cp950",

change the IP (x.x.x.x) to your SQL Server IP address.

13.11 Change the property values of “ntegrate.plugin.dominoserver” and "ntegrate.plugin.dominodb".

This is a plug-in which enables nTegrate to communicate with Lotus Domino Server. If you
have this module, you have to modify it.

13.12 For “ntegrate.plugin.ldap.url ldap://192.168.0.0:389/”, change the IP (x.x.x.x) to your LDAP IP

address.

13.13 For "ntegrate.plugin.smtpServer", change the IP (x.x.x.x) to your Email server's IP address.

13.14 Change the property value of "ntegrate.plugin.smtpSender"

([email protected]) to the email address of the person in your company who
is responsible for business process design.

13.15 For SAP plug-in agent, the default lines are as follow:

netflow.plugin.SAPClient 800
netflow.plugin.SAPUserName wuming
netflow.plugin.SAPPassword demo
netflow.plugin.SAPSystemNumber 00
netflow.plugin.SAPHost 0.0.0.0
netflow.plugin.SAPLanguage en

The default value of the parameter "ntegrate.plugin.SAPClient", 800, is the internal port
number used by SAP itself.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

24 nTegrate (v1.2) Installation Guide

For "ntegrate.plugin.SAPUserName" and "ntegrate.plugin.SAPPassword", type username and

password used to access SAP system.

"ntegrate.plugin.SAPSystemNumber" is the number of SAP server for nTegrate to access.

Change the value of "ntegrate.plugin.SAPHost" (x.x.x.x) to your of SAP server IP address.

"ntegrate.plugin.SAPLanguage" is the language you may use. "en" (English) is the default
value.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 25

14 Configuration of nTegrate Analyzer

nTegrate Analyzer is a component of nTegrate. If you would utilize nTegrate Analyzer, a new feature in
nTegrate v1.2, to analyze your nTegrate server status directly from web server, you need to configure
first.

14.1 Install Apache Tomcat first if you didn’t when go through the Installation in Chapter 8.

14.2 Open \nTegrate\tools\Analyzer\nTegrateAnalyzer.conf and edit the following parameters.

You need to edit this file only when nTegrate server is not on the same machine as web server.

ntegrate.host 127.0.0.1
ntegrate.dbmgr.url jdbc:JTurbo://127.0.0.1:1433/ntegrate
ntegrate.dbmgr.username sa
ntegrate.dbmgr.password

nTegrate.host is the nTegrate server IP address. nTegrate.dbmgr.url specifies where the

database is. You have to change 127.0.0.1 to the correct IP address.
nTegrate.dbmgr.username and nTegrate.dbmgr.password are the account which nTegrate
needs to access to the database.

14.3 Run mkAnalyzer.bat under \nTegrate\. You have to set the correct path, or you may not run this
file. This file is located in \nTegrate\tools\. After running this batch file, a new file ntegrate.war
will be generated under \nTegrate\tools\.

14.4 Copy ntegrate.war to \tomcat\webapps\.

14.5 Start Tomcat by issuing startup under the DOS prompt. (To shut down, issue shutdown.)

14.6 Start nTegrate Analyzer by connecting http://localhost:8080/ntegrateAnalyzer/ with your

browser. The localhost is the IP address of your web server. Please refer to our nTegrate
User’s Guide for more information on how to utilize nTegrate Analyzer.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

26 nTegrate (v1.2) Installation Guide

15 Configuration of nTegrate Plug-ins

 For SOAP Plug-in:

15.1 Before you start to use SOAP plug-in, install Apache web server and Apache Tomcat. Then
extract soap-bin-2.0.zip and nepsoap.zip into two different folders on your local drive.

15.2 Under the Apache web server folder, find a configuration file httpd.conf and insert the
paragraph in the following:

Include "d:\tomcat1\conf\tomcat-apache.conf"
alias /soap "d:/tomcat1/webapps/soap"
<Directory "d:/tomcat1/webapps/soap">
Options FollowSymLinks
AllowOverride None
</Directory>
ApJServMount /soap/servlet /soap
<Location "soap/WEB-INF">
AllowOverride None
deny from all
</Location>
<Directory "d:/tomcat1/webapps/soap/WEB-INF">
AllowOverride None
deny from all
</Directory>
<Location "soap/META-INF">
AllowOverride None
deny from all
</Location>
<Directory "d:/tomcat1/webapps/soap/META-INF">
AllowOverride None
deny from all
</Directory>

Notice that d:\tomcat1 should be the folder where you install Apache Tomcat. Modify it to the
appropriate folder name.

15.3 Under \tomcat\bin, locate a file tomcat.bat and find a "Set Up The Runtime Classpath"
segment around line 68. The original part should be like this:

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 27

:setClasspath
set CP=%TOMCAT_HOME%\classes

Modify the second line. The modified classpath should be like this:

set
CP=d:\tomcat1\webapps\soap\WEB-INF\classes;d:\ntegrate\lib\nte
grate.jar;d:\ntegrate\lib\soap.jar;d:\ntegrate\lib\xerces.jar;
%TOMCAT_HOME%\classes

15.4 Under \tomcat\conf, find a file server.xml and add serveral lines starting from line 299:

<Context path="\soap"
docBase="\webapps\soap"
debug="1"
reloadable="true">
</Context>

15.5 Create a folder called SOAP under \tomcat\webapps\. Then copy all the files from
soap-bin-2.0\soap-2_0\webapps\soap\*.* to \tomcat\webapps\soap\.

15.6 Create two folders: tomcat\webapps\soap\WEB-INF\classes and

tomcat\webapps\soap\WEB-INF\lib. Then copy all the JAR files from \nTegrate\lib\ to
tomcat1\webapps\soap\WEB-INF\lib\.

15.7 Under \tomcat\webapps\soap\WEB-INF\classes\, create a folder structure:

com\netempower\ntegrate\soap. Then copy \nepsoap\*.* to
\tomcat\webapps\soap\WEB-INF\classes\com\netempower\ntegrate\soap.

15.8 Set an environmental variable:

TOMCAT_HOME X:\tomcat

The "X" is the disk drive where you install Apache Tomcat.

15.9 Finally, run deployall.bat.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

28 nTegrate (v1.2) Installation Guide

16 Other Environment Settings

16.1 Select Control Pane | System | Environment, and set the Path:

(A) Set the path of JRE (for example, c:\JRE\1.2\bin).

This path must be set before C:\WINNT\system32, which might contain the default
JVM for NT.

(B) Set the path of nTegrate (for example, c:\nTegrate\bin).

C) Press SET when you finish editing the path.

Note: Press OK directly without pressing SET first, will not modify the path.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 29

16.2 For configuring a computer with OS of Win 98 as your nTegrate client, you need to
(A) Open nmc.bat file under X\bin\, whereby X is the nTegrate inhabiting location.
(B) Merge the two paragraphs of the first block into one paragraph of the second block.

set
CLASSPATH=.;%NTEGRATE_HOME%;%NTEGRATE_LIB%\ntegrate.jar;%
NTEGRATE_LIB%\ntegrateMesgs.jar;%NTEGRATE_LIB%\resource.j
ar;%NTEGRATE_LIB%\jh.jar;%NTEGRATE_LIB%\jgo.jar;%NTEGRATE
_LIB%\lamasoft.jar;%NTEGRATE_LIB%\symbeans.jar;%NTEGRATE_
LIB%\sfc.jar;%NTEGRATE_LIB%\xerces.jar;%NTEGRATE_LIB%\xal
an.jar

java -DNTEGRATE_HOME=%NTEGRATE_HOME% %SECURITY_PLOICY%

-cp %CLASSPATH%
com.netempower.ntegrate.gui.admin.frame.Netlog

java -DNTEGRATE_HOME=%NTEGRATE_HOME% %SECURITY_PLOICY%

-cp .;%NTEGRATE_HOME%;%NTEGRATE_LIB%\ntegrate.jar;%NTEGRA
TE_LIB%\ntegrateMesgs.jar;%NTEGRATE_LIB%\resource.jar;%NT
EGRATE_LIB%\jh.jar;%NTEGRATE_LIB%\jgo.jar;%NTEGRATE_LIB%\
lamasoft.jar;%NTEGRATE_LIB%\symbeans.jar;%NTEGRATE_LIB%\s
fc.jar;%NTEGRATE_LIB%\xerces.jar;%NTEGRATE_LIB%\xalan.jar
com.netempower.ntegrate.gui.admin.frame.Netlog

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

30 nTegrate (v1.2) Installation Guide

17 nTegrate Server Invocation

17.1 Select Start | Programs | Progress SonicMQ | Start Broker to start SonicMQ Broker.

17.2 Select Start | Programs | Apache Web Server | Start Apache to start Apache Server.

17.3 Select Start | Programs | nTegrate | Plug-In Agent. Wait for the prompt “nTegrate plug-in
agent is ready. Please start nTegrate server now.”

17.4 Click Start | Program Files | nTegrate | nTegrate to start nTegrate server.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 31

If there is any error message, recheck the environmental variables in Control Panel.

If nTegrate server has been rebooted or SonicMQ Broker has been closed, please restart
Broker and run SonicMQ Explorer to set connection again.

17.5 For the first-time running, nTegrate Management Console program will prompt you to enter the
IP address of nTegrate server:

Enter the correct IP and click OK to connect to nTegrate server.

nTegrate Management Console will automatically generate nTegrateGUI.conf to indicate the IP

address of nTegrate server.

If your nTegrate server's IP address is changed, you have to modify the nTegrateGUI.conf file
to tell the console program the correct IP address, at the following locations:

under %USERPROFILE%, C:\WINNT\Profiles\.... for Windows NT 4.0

under C:\Windows for Win98

under C:\Documents And Settings\<username> for Win2000

under $HOME, the login home directory, for UNIX.

17.6 Click Start | Program Files | nTegrate | nTegrate Management Console to invoke nTegrate
GUI client, which will connect to nTegrate Server with a welcome window.

A pair of default case-sensitive user-name/password are “Administrator”/“Administrator”.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

32 nTegrate (v1.2) Installation Guide

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 33

18 Upgrade nTegrate

18.1 Run Setup program, it will automatically detect the old version of nTegrate and run a full
update installation. If there is a need to proceed with installation maintenance, go to Control
Panel, select Add/Remove Programs, and select nTegrate to enter maintenance mode.

18.2 Select Modify when you want to add or remove components installed.

 If you choose "Server" when you install nTegrate, all of the components will be
installed.

 If you choose "Client" when you install nTegrate, then the components ended with
"_client" will be installed on your system. You don't have to specify components ended
with "_client" when you install nTegrate server.

-or-

Select "Repair" to reinstall the components which are incidentally deleted in your system.

Select "Remove" to remove itself from your system. But for safety, your scripts and logs will
not be removed.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

34 nTegrate (v1.2) Installation Guide

18.3 There is minor change in Database structure. You have to run a SQL script called
"dbmigrate2V11.sql" under the Dbscript folder in CD. This script is only for database migration.

18.4 After upgrading nTegrate, you may have to reset configuration files under \BIN folder, such as
nTegrate.conf.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 35

Appendix A: Configuration of nTegrate Cluster

nTegrate allows users to construct several server machines to form a cluster.

(A) For the cluster machines, setup the machine as a server machine, including drivers for the
database (installing Oracle client or SQL depending on your choice of database).

(B) Configure the following two parameters in ntegrate.conf on the cluster machine.

ntegrate.mainIP x.x.x.x
ntegrate.launcherIP x.x.x.x

ntegrate.mainIP is the IP of the main ntegrate machine. ntegrate.launcherIP is the

IP of the current cluster machine. Please substitute x.x.x.x with your IP.

(C) To start the engine launcher, type under MS-DOS prompt, for example

c:\> ntegratecluster

This will start the engine launcher and it will find the master server and make itself known to
the master server that it is ready.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

36 nTegrate (v1.2) Installation Guide

Appendix B: Shutdown nTegrate Server Gracefully

Here’s the way to shutdown your nTegrate Server gracefully.

Instead of using Ctrl - C in the MS-DOS window that executes ntegrate, you may open another
MS-DOS window and type the following commands:

ntegrate -stop

The server will wait for all process models to finish, then free resources and shut down.

or

ntegrate -abort

The server will be shut down immediately; unfinished processes will be recovered when
nTegrate restarted.

Once the stop or abort command issued, no new model instance can be activated.

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.

 nTegrate (v1.2) Installation Guide 37

nTegrate (v1.2) Installation Guide

generated 2001/7/18

Copyright © 2001 NetEmpower Software Technologies, Inc., all rights reserved.