8-0fcs WebMethods Installation Guide

TitlePage
webMethods
Installation Guide
Version 8.0
June 2009
Copyright
& Docu
mentID
ThisdocumentappliestowebMethodsProductSuiteVersion 8.0andtoallsubsequentreleases.
Specificationscontainedhereinaresubjecttochangeandthesechangeswillbereportedinsubsequentreleasenotesorneweditions.
Copyright20052009SoftwareAG,Darmstadt,Germanyand/orSoftwareAGUSA,Inc.,Reston,VA,UnitedStatesofAmerica,and/or
theirsuppliers.Allrightsreserved.
ThenameSoftwareAG,webMethods,andallSoftwareAGproductnamesareeithertrademarksorregisteredtrademarksofSoftwareAG
and/orSoftwareAGUSA,Inc.Othercompanyandproductnamesmentionedhereinmaybetrademarksoftheirrespectiveowners.
Thissoftwareincludesportionsofthirdpartyproducts.Forthirdpartycopyrightnoticesandlicenseterms,pleaserefertoThirdParty
CopyrightandTrademarkNoticesandLicenseTerms.Thisdocumentispartoftheproductdocumentation,locatedat
http://documentation.softwareag.com/thirdpartyand/orintherootinstallationdirectoryofthelicensedproduct(s).
Document ID: WEBM-IG-80-20090629
Table of Contents
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
webMethods Central Documentation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
webMethods Advantage Bookshelf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Software AG Developer Community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
10
11
11
11
11
1. Development Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Integration Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Composite Applications Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Process Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Deployer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ApplinX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
13
14
14
15
17
18
20
20
20
2. Data Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Integration Server Data Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Embedded Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
External RDBMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Product Database Component Descriptions and Installation Requirements . . . . . . . . . . . . 25
Analysis Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Archive Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Blaze Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
BPEL Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Cross Reference, Document History, IS Internal, and IS Core Audit Database Components
26
My webMethods Server Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Process Audit Log Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Process Engine Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Process Tracker Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Staging and Reporting Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Trading Networks and Trading Networks Archive Database Components . . . . . . . . . . 29
Infrastructure Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
webMethods Installation Guide Version 8.0
Table of Contents
3. Software and Hardware Support and Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . .

Operating System Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Considerations for Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Special Considerations for webMethods Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
RDBMS Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Browser Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
JDK Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Third-party Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ApplinX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Additional Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31
32
32
32
32
32
32
33
33
33
35
4. International Operating Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Extended Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Browsers and JDK Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Proper Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
37
38
38
38
39
39
5. Preparing for Product Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

About the webMethods Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prepare for Installation on All Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prepare for Installation on a Windows System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prepare for Installation on a UNIX or Mac System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prepare to Install webMethods Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prepare to Install ApplinX and EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Prepare to Install Report Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Scripts and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
41
42
42
43
44
45
46
47
47
47
48
6. Using the Wizard to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Start the webMethods Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Start the webMethods Installer on a Windows System . . . . . . . . . . . . . . . . . . . . . . . . .
Start the webMethods Installer on a UNIX or Mac System . . . . . . . . . . . . . . . . . . . . . .
View the Welcome Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Use Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create, Install from, or Edit an Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create or Install from an Installation Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Use a Proxy Server to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Change Logging Level and File, and Add Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specify Release, User Name, and Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specify the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Select Products to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Select Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
49
50
50
50
51
52
53
53
54
55
56
57
58
59
61
Table of Contents
Configure Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Database Connection Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Trading Networks Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Optimize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Infrastructure Data Collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure webMethods Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Report Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure ApplinX and EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Review and Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
62
62
63
64
65
66
67
69
70
71
72
76
7. Using Console Mode to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Start the webMethods Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specify Release, User Name, and Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specify the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Select Products to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Select Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Database Connection Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Trading Networks Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Infrastructure Data Collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure webMethods Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure the Report Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure ApplinX and EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Review and Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
77
78
78
82
83
83
84
85
85
86
86
86
86
87
89
89
89
91
8. Creating and Dropping Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Preparing for Database Component Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
webMethods Products and Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Database Users and Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Database Administrator Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Character Set and Sort Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Page and Block Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Set Database Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Default Storage Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Download the Database Component Configurator or Database Scripts . . . . . . . . . . .
Change Environment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
93
94
94
94
95
95
97
97
98
98
99
Table of Contents
Use the Database Component Configurator Graphical User Interface . . . . . . . . . . . . . . . .

Create Database Components and Create a Database User and Storage . . . . . . . . .
Drop Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drop the Storage and Revoke Database User Permissions . . . . . . . . . . . . . . . . . . . . .
Use the Database Component Configurator Command Line . . . . . . . . . . . . . . . . . . . . . . . .
Database Component Configurator Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Use the Database Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modify Storage Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Run the Database Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create a Database User and Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drop Storage and Revoke Database User Permissions . . . . . . . . . . . . . . . . . . . . . . . .
Create Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drop Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
100
100
104
105
106
107
113
116
116
116
117
117
117
117
9. Completing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Post-Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Complete the webMethods Broker Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Make Sure Broker Server is Running and the Default Broker Exists . . . . . . . . . . . . . .
Set System and User Limits on UNIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Enable Full Core Dumps on AIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Broker Monitors to Start Automatically on UNIX Systems . . . . . . . . . . . . . .
Set Locale on UNIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Complete the EntireX Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Set Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Create Daemons and Set Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Complete the Integration Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Increase PermGen Space on UNIX and Mac Systems . . . . . . . . . . . . . . . . . . . . . . . .
Increase File Descriptors on UNIX and Mac Systems . . . . . . . . . . . . . . . . . . . . . . . . .
Change Permissions on UNIX and Mac Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Start Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drop Redundant Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Streamline Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Complete the Monitor Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Set Up Graphical Display on UNIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Complete the Optimize Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drop Redundant Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Complete the Report Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Set Up a User Account and Configure the Web Server . . . . . . . . . . . . . . . . . . . . . . . .
Create the Content Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connect Report Server to webMethods Database Components . . . . . . . . . . . . . . . . .
Configure Web Browsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Report Server and Start Report Server Services . . . . . . . . . . . . . . . . . . . . .
119
120
121
122
122
122
122
122
123
123
123
123
124
124
124
124
125
125
125
127
127
127
127
127
128
129
131
132
133
133
Table of Contents
Connect Products to Each Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Start Integration Server and My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . .
Connect Process Engines to Task Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connect Process Engine to Optimize Analytic Engine . . . . . . . . . . . . . . . . . . . . . . . . .
Connect Products to My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connect Integration Server to Default Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Connect Products to Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Database Connections for Integration Server and Hosted Products . . . . . . . . . . . . . .
Define a Connection Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Point a Function at a Connection Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installed JDKs and Product JDK Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Run-time Products to Use 64-Bit Mode on Solaris and
HP-UX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Redirect Products to Use a Non-Default JRE or JDK . . . . . . . . . . . . . . . . . . . . . . . . . .
135
135
136
137
137
139
141
141
143
146
147
10. Uninstalling Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstall ApplinX and EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstall on a Windows System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstall on a UNIX System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstall Designer Plug-ins or Eclipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstall All Other Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstall on a Windows System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Uninstall on a UNIX or Mac System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Complete the webMethods Broker Uninstallation on UNIX Systems . . . . . . . . . . . . . .
Complete the Deployer Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
153
154
155
155
155
157
157
157
158
159
159
149
149
A. Default Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Table of Contents
About This Guide

ThisguideisforuserswhowanttoinstallthewebMethodsproductslistedbelowusing
thewebMethodsInstaller.
Product
Release
webMethodsApplinX
8.1
BlazeAdvisor
6.6
webMethodsBroker
8.0
webMethodsDeployer
8.0
webMethodsDesigner
8.0
webMethodsDeveloper
8.0
webMethodsEntireX
8.1
webMethodsIntegrationServer
8.0
webMethodsMonitor
8.0
MywebMethodsServer
8.0
webMethodsProcessEngine
8.0
webMethodsOptimize
8.0
webMethodsReportServer
8.0
webMethodsSystemManagementHub
8.1
webMethodsTaskEngine
8.0
webMethodsTradingNetworks
8.0
webMethodsWebServicesStack
8.0SP1
Typically,toinstallwebMethodsproductsusingthewebMethodsInstaller,you
downloadtheinstallerand,throughtheinstaller,thefilesforeachproduct,fromthe
webMethodsAdvantageWebsiteathttp://advantage.webmethods.com.Ifyoucannot
downloadsoftware,webMethodsCustomerOperationscanprovidethewebMethods
productsforwhichyouhavepurchasedlicensesonaCDorthroughaprivateFTPsite.
ContactwebMethodsCustomerOperationsatkeymaster@webmethods.com.
Important! Informationinthisguidemighthavebeenupdatedsinceyoulast
downloadedit.GotothewebMethodsBookshelfforthelatestversionoftheguide.
IfyoumustperformcertainconfigurationtasksbeforeyoucanstartawebMethods
product,thisguidealsoexplainsthoseconfigurationtasks.Forinstructionsonstarting
productsandconfiguringthemaftertheyarestarted,seetheproductdocumentation.
About This Guide
Important! Ifyouwanttoupgradetheproductslistedabove,youmustusethe
instructionsinthewebMethodsUpgradeGuide.Theinstructionsinthisinstallation
guidedonotcoverupgrades,sofollowingtheinstructionsinthisguideforupgrades
wouldhaveunpredictableresults.
Document Conventions
Convention
Description
Bold
Identifieselementsonauserinterface.
Narrow font
IdentifiesstoragelocationsforservicesonwebMethodsIntegration
Server,usingtheconventionfolder.subfolder:service.
UPPERCASE
Identifieskeyboardkeys.Keysyoumustpresssimultaneouslyare
joinedwithaplussign(+).
Italic
Identifiesvariablesforwhichyoumustsupplyvaluesspecifictoyour
ownsituationorenvironment.Identifiesnewtermsthefirsttimethey
occurinthetext.
Monospace
font
Identifiestextyoumusttypeormessagesdisplayedbythesystem.
{}
Indicatesasetofchoicesfromwhichyoumustchooseone.Typeonly
theinformationinsidethecurlybraces.Donottypethe{}symbols.
Separatestwomutuallyexclusivechoicesinasyntaxline.Typeoneof
thesechoices.Donottypethe|symbol.
[]
Indicatesoneormoreoptions.Typeonlytheinformationinsidethe
squarebrackets.Donottypethe[]symbols.
...
Indicatesthatyoucantypemultipleoptionsofthesametype.Type
onlytheinformation.Donottypetheellipsis(...).
10
About This Guide
Additional Information
YoucanfindadditionalinformationaboutwebMethodsproductsatthelocations
describedbelow.
webMethods Central Documentation Directory

Duringproductinstallation,youcandownloadthewebMethodsproductdocumentation
toasingledirectorycalled_documentation.Thisdirectoryislocatedbydefaultunder
thewebMethodsinstallationdirectory.
webMethods Advantage Bookshelf

ThewebMethodsAdvantageWebsiteathttp://advantage.webmethods.comprovides
youwithimportantsourcesofinformationaboutwebMethodsproducts:
Troubleshooting Information.ThewebMethodsKnowledgeBaseprovides
troubleshootinginformationformanywebMethodsproducts.
Documentation Feedback.ToprovidefeedbackonwebMethodsdocumentation,goto
theDocumentationFeedbackFormonthewebMethodsBookshelf.
Additional Documentation.YoucanfinddocumentationforallwebMethodsproductson
thewebMethodsBookshelf.
Software AG Developer Community

Additionalarticles,demos,andtutorialsareavailableonthewebMethodsportionofthe
Software AGDeveloperCommunity.ThevariousDeveloperCommunitiesfeature
technicalinformation,usefulresources,andonlinediscussionforums,moderatedby
Software AGprofessionals,tohelpyoudomorewithwebMethodstechnology.
WiththeSoftware AGDeveloperCommunities,youcan:
Usetheonlinediscussionforumstoexchangebestpracticesandchatwithother
experts.
Expandyourknowledgewithproductdocumentation,codesamples,articles,online
seminarsandtutorials.
LinktoexternalsitesonopenstandardsandmanyWebtechnologytopics.
Seehowothercustomersarestreamliningtheiroperationswithtechnologyfrom
Software AG.
11
About This Guide
12
Development Environments
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14
Integration Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14
Composite Applications Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15
Process Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17
Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
18
Deployer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20
ApplinX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20
EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20
13
1 Development Environments
Overview
ThischapterdiscusseswebMethodsdevelopmentenvironments.Youcaninstall
individualwebMethodsproducts,oryoucaninstallcombinationsofwebMethods
productsthatcreateenableyoutoperformacertaintask(forexample,businessprocess
design).Thesectionsbelowliststheproductsthatmakeupthemostcomplicated
developmentenvironments.Whenyouinstall,thewebMethodsInstalleroffersthese
developmentenvironmentsastypicalinstallations(ifyouhavelicensedtheappropriate
products).
Thechapteralsoliststhedatabasecomponentsyoumustorcaninstallforeach
developmentenvironment.AwebMethodsdatabasecomponentisagroupingof
databaseobjectsthatcanbeusedbyoneormorewebMethodsproducts.
TocreatewebMethodsproductionenvironments,workwithyouradministrators,
Software AGProfessionalServices,webMethodsGEARmethodology,andwebMethods
bestpracticesdocumentation.
Note: webMethodsProductSuite8.0doesnotinteroperatewithCentraSite8.0.
Integration Development
DeveloperandTradingNetworksConsole
IntegrationServerwithTradingNetworksServerandMonitor
webMethodsBroker
MywebMethodsServer,andMywebMethodsuserinterfacesforTradingNetworks,
Monitor,andBrokerandJMS
DatabaseComponentConfigurator
Documentation
webMethods Broker
Integration Server
Developer
Trading Networks Console
TN Server
Monitor
Broker and JMS UI

Monitor UI
Trading Networks UI
My webMethods Server
database
14
Belowareadditionaloptions.
If you want to...
Install this product...
StoreIntegrationServerandTrading
Networkskeysandcertificatessecurely
IntegrationServerPKISupportpackage
MaintainDeveloperelementsinMicrosoft
VisualSourceSafe,IBMRational
ClearCase,orCollabNetInc.Subversion
IntegrationServerVSS,ClearCase,or
SubversionSupport
Thetablebelowliststhedatabasecomponentsyoumustorcanincludeinanintegration
developmentenvironment.Thedatabasecomponentsareversioneddifferentlythanthe
products.
Product
Database Components
See
IntegrationServer
ISCoreAuditLogv25
ISInternalv30
CrossReferencev11
DocumentHistoryv10
Archivev30
IntegrationServer
DataStorageon
page 22
MywebMethodsServer
MywebMethodsServerv30
TradingNetworksServer
TradingNetworksv30
TradingNetworksArchivev30
ProductDatabase
Component
Descriptionsand
Installation
Requirementson
page 25
Composite Applications Development

DesignerEclipsewithCompositeApplicationsDevelopmentandMywebMethods
ServerSupportplugins
MywebMethodsServer
Documentation
Designer
database
Thetablebelowliststhedatabasecomponentsyoumustorcanincludeinacomposite
applicationdevelopmentenvironment.Thedatabasecomponentsareversioned
differentlythantheproducts.
15
Product
Database Components
See
MywebMethodsServer
ProductDatabaseCom
ponentDescriptionsand
InstallationRequire
mentsonpage 25
Ifyouwantyourcompositeapplicationstocallservicesavailablethroughotherproducts
inthewebMethodsproductsuite,addthefollowing:
DesignerESBandIntegrationServerDevelopmentplugin
BlazeAdvisor
IntegrationServerwithBlazeRuleServiceSupportandMonitor
MywebMethodsuserinterfaceforBlazeandMonitor
Blaze Advisor
Integration Server
Designer
Blaze
Monitor
Monitor UI
Blaze UI
database
Product
Database Components
See
Blazeuserinterface
Blazev10
ProductDatabaseComponent
DescriptionsandInstallation
Requirementsonpage 25
IntegrationServer
ISCoreAuditLogv25
ISInternalv30
Archivev30
IntegrationServerDataStorage
onpage 22
16
Process Design
DesignerEclipsewithBusinessProcessesDevelopmentandSimulation,Composite
ApplicationsTaskDevelopment,andESBandIntegrationServerDevelopmentplug
ins
DeveloperwithBlazeRuleServiceplugin
BlazeAdvisor
IntegrationServerwithBlazeRuleServiceSupport,Monitor,ProcessEngine,and
OptimizeSupport
MywebMethodsServerwithTaskEngine,andMywebMethodsuserinterfacefor
BlazeandMonitor
Documentation
Developer
Integration Server
Blaze Advisor
Designer
Process Engine
Blaze
Monitor
database
Monitor UI
Blaze UI
Task Engine
Belowareadditionaloptions.
If you want to...
Install this product...
StoreIntegrationServerkeysand
certificatessecurely
IntegrationServerPKISupportpackage
MaintainDeveloperelementsinMicrosoft
VisualSourceSafe,IBMRational
ClearCase,orCollabNetInc.Subversion
IntegrationServerVSS,ClearCase,or
SubversionSupport
17
Thetablebelowliststhedatabasecomponentsyoumustorcanincludeinaprocess
designenvironment.Thedatabasecomponentsareversioneddifferentlythanthe
products.
Product
Database Components
IntegrationServer
ISCoreAuditLogv25
ProcessAuditLogv40
ISInternalv30
Archivev30
IntegrationServerData
Storageonpage 22
Blazeuserinterface
Blazev10
BPELplugintoDesigner
BPELv10
MywebMethodsServer
ProductDatabaseCom
ponentDescriptionsand
InstallationRequire
mentsonpage 25
ProcessEngine
ProcessEnginev40
TaskEngine
ProcessAuditLogv40
Monitoring
OptimizeAnalyticEngineandPredictionEngine
TocollectdataaboutwebMethodsproducts,OptimizeInfrastructureDataCollector
andwebMethodsBroker
Tocollectdataaboutcustomapplications,OptimizeWebServiceDataCollectorand
webMethodsBroker
IntegrationServerwithMonitorandOptimizeSupport
ReportServerwithMonitor,Optimize,TradingNetworks,andOptimizeforB2B
packages
MywebMethodsServer,andMywebMethodsuserinterfacesforOptimizefor
Infrastructure,OptimizeforProcess,CentralConfiguration,BrokerandJMS,
Monitor,OptimizeforB2B,andReports
Documentation
18
Prediction Engine
Infrastructure Data Collector
Analytic Engine
webMethods Broker
Web Service Data Collector
Optimize Support
OptimizeUIs
Integration Server
Monitor
Broker and JMS UI

Reporting UI
Monitor UI
Optimize for B2B UI
Report Server
database
Thetablebelowliststhedatabasecomponentsyoumustorcanincludeinamonitoring
andadministrationenvironment.Thedatabasecomponentsareversioneddifferently
thantheproducts.
.
Product
Database Components
See
OptimizeAnalyticEngine,
PredictionEngine,and
InfrastructureDataCollector
Analysisv40
ProcessTrackerv40
ProcessAuditLogv40
Archivev30
ProductDatabase
Component
Descriptionsand
Installation
Requirementson
page 25
ReportServer
Monitorreports
Stagingv20
Reportingv20
Optimizereports
Analysisv40
TradingNetworksreports
TradingNetworksv30
OptimizeforB2Breports
Analysisv40
TradingNetworksv30
MywebMethodsServer
19
Deployer
DeployerisatoolyouusetodeployitemsthatresideonsourcewebMethodsserversto
targetwebMethodsservers.Forexample,youmightwanttodeployitemsyouhave
developedonserversinadevelopmentenvironmenttoserversinatestorproduction
environment.Deployer8.0workswith8.0webMethodsBroker,Designer,Integration
Server,MywebMethodsServer,Optimize,andTradingNetworks.
DeployerisapackageyouinstallonanIntegrationServer.Ifnofirewallseparatesyour
sourceandtargetenvironments,installDeployeranditshostIntegrationServerona
machinethatcanaccessallsourceandtargetservers.Ifafirewallseparatesthe
environments,installDeployeranditshostIntegrationServeronamachineinthesource
environmentthatcanaccessallsourceserversandinthetargetenvironmentona
machinethatcanaccessalltargetservers.
ApplinX
ApplinXServer,Administration,JSPand.NETFrameworks,andVisualStudioAdd
in
DesignerEclipsewithApplinXplugin
Documentation
EntireX
EntireXCoreFiles,Broker,Administration,VisualStudioAddins(Windows),and
WebServicesRuntime
DesignerEclipsewithEntireXplugin
Documentation
20
Data Storage
Integration Server Data Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22
Product Database Component Descriptions and Installation Requirements . . . . . . . . . . . . . . . .
25
Infrastructure Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30
21
2 Data Storage
Integration Server Data Storage

IntegrationServercanpersistthesetypesofdata:
Integration Server
writes this data when...
Type of Data
Content
ISInternal
Scheduledtasks,clientcertificatemappings,
runtimedataforpub.storageservices,auditlog
ofguaranteeddeliverytransactions,andtrigger*
joins.
Youareusingthe
featureslistedinthe
Contentscolumn
ISCore
AuditLog
Error,guaranteeddelivery,service,security,
andsessionauditdata.
Loggingisenabled
(seethewebMethods
AuditLoggingGuide)
Documentsthatareindoubt,havefailed,or
haveexhaustedtrigger*retries.
Youareusing
triggers
Cross
Reference
Crossreferencingdata*forpublishandsub
scribesolutions.
Youareusingpub
lishandsubscribe
solutions
Document
History*
Documenthistorydataforexactlyonce
processing*inpublishandsubscribesolutions.
IntegrationServerusesthedatatodetectand
rejectduplicatedocuments.
Youareusing
exactlyonce
processing
*Forinformationontriggers,crossreferencing,exactlyonceprocessing,andpublishsubscribesolutions,seethe
PublishSubscribeDevelopersGuide.
WhenyouinstallIntegrationServer,theinstalleraskswhetheryouwantIntegration
ServertowritedatatoanembeddeddatabaseoranexternalRDBMS.Thesectionsbelow
explainwhenyouwouldchooseeachoption.
Embedded Database
TheembeddeddatabaseisSQLbased.Youcanusetheembeddeddatabasewhenyou:
AregoingtouseIntegrationServerasastandaloneserver(forexample,astherun
timeforwebMethodsadapters).
DonothaveanexternalRDBMS.
Arenotinstallinginaproductionenvironmentthathashightransactionvolumesor
largedatasets.
Ifyouchoosetheembeddeddatabase,IntegrationServerwillwriteISInternalandCross
Referencedatatothatdatabase,andwillwriteISCoreAuditLogdatatofiles.For
informationaboutthefiles,seethewebMethodsAuditLoggingGuide.
22
2 Data Storage
DocumentHistorydatacanonlybewrittentoanexternalRDBMS.Youareusingexactly
onceprocessinginpublishandsubscribesolutions,youmustcreatetheDocument
HistorydatabasecomponentandconfigureIntegrationServerappropriately.The
databasechaptersandConnectProductstoDatabaseComponentsonpage 141inthis
guideprovideinstructions.
IfyoulaterchoosetowriteISInternal,CrossReference,orISCoreAuditLogdatatoan
externalRDBMSinsteadoftheembeddeddatabase,youwillneedtoinstallthenecessary
databasecomponents,asdescribedinthedatabasechaptersinthisguide.Youwillthen
needtoreconfigurewhereIntegrationServerwritesISInternalandCrossReferencedata
asdescribedinthewebMethodsIntegrationServerAdministratorsGuide,andISCoreAudit
LogdataasdescribedinConnectProductstoDatabaseComponentsonpage 141.You
mustwriteISCoreAuditLogdatatoanexternalRDBMSwhentheISCoreAuditLog
includesthefollowingtypesofdata:
Ifyouareusingtriggers.Whenyouusetriggers,IntegrationServerneedstowrite
problemdocumentstotheISCoreAuditLog.Documentscanonlybewrittentoan
externalRDBMS;theycannotbewrittentofiles.
Ifyouwantservicestologtheirinputpipelines,orpostuserdefinedprogress
messages(forexample,toindicatewhethercertainpiecesofcoderansuccessfully).
Inputpipelinesanduserdefinedmessagescanonlybewrittentoanexternal
RDBMS;theycannotbewrittentofiles.
IfyouareusingMonitor.MonitorcanonlyreadfromanRDBMS.
External RDBMS
YoumustuseanexternalRDBMSifyouaregoingto:
ClusterIntegrationServers.
WriteDocumentHistorydata(thatis,useexactlyonceprocessinginpublishand
subscribesolutions).
WriteProcessAuditLogandProcessEnginedata(thatis,runbusinessprocesses).
Usetriggers;IntegrationServercanonlywriteproblemdocumentstoanexternal
RDBMS.
Haveserviceslogtheirinputpipelines,orpostuserdefinedprogressmessages(for
example,toindicatewhethercertainsegmentsofcoderansuccessfully).
UseMonitor.
Installinaproductionenvironmentwithhightransactionvolumesorlargedatasets.
WhenyouuseanexternalRDBMS,youmustcreatewebMethodsdatabasecomponents.A
webMethodsdatabasecomponentisagroupingofdatabaseobjects.Eachdatabase
componentisnamedforthetypeofdatathatiswrittentoit;forexample,thedatabase
componentforISCoreAuditLogdataiscalledtheISCoreAuditLogdatabase
component.
23
2 Data Storage
Beforeorafterinstallation,youmustcreatetheISInternalandISCoreAuditLog
databasecomponentsinyourexternalRDBMS.Youwillalsocreateotherdatabase
componentsasneeded.Forexample,ifyouareusingpublishandsubscribesolutions
andexactlyonceprocessing,youwillneedtheCrossReferenceandDocumentHistory
databasecomponents.Ifyouarerunningbusinessprocesses,youwillneedtheProcess
AuditLogandProcessEnginedatabasecomponents(seeProductDatabaseComponent
DescriptionsandInstallationRequirementsonpage 25).
WhenyouchoosetheexternalRDBMSintheinstaller,theinstallerasksyoutosupplythe
databaseconnection.Fromthisinformation,theinstallercreatesaJDBCconnectionpool
andconfiguresIntegrationServertowriteISInternal,ISCoreAuditLog,Cross
Reference,DocumentHistory,ProcessAuditLog,andProcessEnginedatatothe
externalRDBMSusingthatpool.
Note: ThisautoconfigurationofIntegrationServerisforeaseofuseonly.Youneed
notcreateallthecorrespondingdatabasecomponents;onlycreatethoseyouwill
actuallyuse.Also,inaproductionenvironment,youmightwanttocreateadditional
JDBCconnectionpoolsandreconfigureIntegrationServertowritedifferenttypesof
datausingdifferentpools.ConnectProductstoDatabaseComponentsonpage 141
providesinstructions.
IfyouareclusteringIntegrationServers,createoneofeachofthefollowingdatabase
componentsfortheclustertoshare:ISInternal,CrossReference,DocumentHistory,and
ISCoreAuditLog.
IfyouarenotclusteringIntegrationServers,createaseparateISInternaldatabase
componentforeachIntegrationServer.YoucancreateaseparateISCoreAuditLog
databasecomponent,CrossReferencedatabasecomponent,andDocumentHistory
databasecomponentforeachIntegrationServer,oryoucancreateasingleoneofeachof
thosedatabasecomponentsfortheIntegrationServerstoshare.
24
2 Data Storage
Product Database Component Descriptions and Installation

Requirements
Thissectionbrieflydescribeseachdatabasecomponentanditsinstallationrequirements.
Note: Fordetailedinformationonproductconceptsmentionedinthesectionsbelow,
seetherelevantproductdocumentation.
Analysis Database Component

IfyouinstallOptimize,youmustcreatetheAnalysisdatabasecomponent.
OptimizeAnalyticEngineswritecomputedanalyticsandprocessandmonitoringdata
receivedfromInfrastructureDataCollectorsandWebServiceDataCollectorstothe
Analysisdatabasecomponent.OptimizePredictionEnginesevaluatethedataand
generatepredictionevents.TheOptimizeuserinterfaceinMywebMethodsdisplaysthe
data.
TheReportServergeneratesOptimizereportsaboutkeyperformanceindicators(KPIs)
fromthedataintheAnalysisdatabasecomponent.TheReportinguserinterfaceinMy
webMethodsdisplaysthedata.
CreateasingleAnalysisdatabasecomponentforallOptimizeAnalyticEnginestoshare.
Archive Database Component

IfyouwanttoarchivedatafromtheISCoreAuditLogandProcessAuditLogdatabase
components(calledthesourcedatabasecomponentsinthissection),createtheArchive
databasecomponent.
TheArchivedatabasecomponentincludesacopyoftheISCoreAuditLogandProcess
AuditLogdatabasecomponents.TherequirementsfortheArchivedatabasecomponent
areasfollows:
YoumustcreatetheArchivedatabasecomponentinthesametypeofRDBMSasthe
sourcedatabasecomponents.
ForDB2,youmustcreatetheArchivedatabasecomponentonthesamedatabase
serveras,butinadifferentdatabasefrom,thesourcedatabasecomponents.
ForOracleorSQLServer,youcandoeitherofthefollowing:
CreatetheArchivedatabasecomponentonthesamedatabaseserverasthesource
databasecomponents.Inthiscase,youmustcreatetheArchivedatabase
componentinadifferentschema(Oracle)ordatabase(SQLServer)thanthe
sourcedatabasecomponents.
CreatetheArchivedatabasecomponentonadifferentdatabaseserverthanthe
sourcedatabasecomponents,andthencreateaDBlinknamefortheArchive
databasecomponenttousetolinktoeachsourcedatabasecomponent.Ifthetwo
25
2 Data Storage
sourcedatabasecomponentsareonthesamedatabaseserver,theArchive
databasecomponentcanusethesameDBLinktoconnecttobothsourcedatabase
components.ForinstructionsonspecifyingtheDBlinkname,seethewebMethods
MonitorUsersGuide.
Blaze Database Component

IfyouwanttousetheBlazeuserinterfaceinMywebMethodstoeditrulescreatedin
BlazeAdvisor,createtheBlazedatabasecomponent.
BlazeAdvisorwritesmetadata,projectinformation,andrulesetsforBlazerulestothis
databasecomponent.TheBlazeuserinterfaceconnectstothisdatabasecomponentto
retrieveBlazerulesandtostoreBlazerulesafterusersmodifythem.
BPEL Database Component

IfyouinstallBPELEnginesonIntegrationServerstoorchestrateBPELprocesses,you
mustcreatetheBPELdatabasecomponent.
BPELEngineswriteprocessexecutiondataforprocessestheyorchestratetothisdatabase
component.
IfyouareclusteringBPELEngines,createasingleBPELdatabasecomponentforthe
clusteredBPELEnginestoshare.Ifyouarenotclustering,createaseparateBPEL
databasecomponentforeachBPELEngine.
Cross Reference, Document History, IS Internal, and IS Core Audit

Database Components
SeeIntegrationServerDataStorageonpage 22.
My webMethods Server Database Component

IfyouinstallMywebMethodsServer,youmustcreatetheMywebMethodsServer
databasecomponent.
Thefollowingwritetothisdatabasecomponent:
MywebMethodsServerwritesdataaboutdeployment,configuration,security,portal
pages,andruntimeoperations.ItusesthisdatatomanagetheMywebMethodsuser
interfaces(thatis,theuserinterfacesinMywebMethodsforBrokerandJMS,
Monitor,Optimize,OptimizeforB2B,Reporting,andTradingNetworks).
TheTaskEnginewritestaskstatus,taskdistribution,andbusinessdata.TheTask
EngineuserinterfaceinMywebMethodsdisplaysthedata.
IfyouareclusteringMywebMethodsServers,createasingleMywebMethodsServer
databasecomponentfortheclustertoshare.Ifyouarenotclustering,createaseparate
MywebMethodsServerdatabasecomponentforeachMywebMethodsServer.
26
2 Data Storage
Process Audit Log Database Component

IfyouinstallProcessEngines,youmustcreatetheProcessAuditLogdatabase
component.
Thefollowingwritetothisdatabasecomponent:
ProcessEngineswriteprocessauditdataforbusinessprocessesthattheyorchestrate.
TaskEngineswritetaskauditdata.
Thirdpartyproductscanwriteprocessexecutiondata.
OptimizeAnalyticEnginesreadprocessdatafromthisdatabasecomponentsotheycan
analyzecapabilitiessuchastransitiondurationandwritedataaboutanalysisenabled
processes.TheOptimizeuserinterfaceinMywebMethodsdisplaysthedata.
Ifyouaredistributingbusinessprocesssteps,youclustertheProcessEnginesthat
orchestratethesteps.CreateasingleProcessAuditLogdatabasecomponentforthe
clusteredProcessEnginestoshare.IntegrationServersthathosttheseProcessEngines
andalsotheBlazeRuleServiceSupportpackageregisterthemselvesintheshared
ProcessAuditLogdatabasecomponent.WhenusersmodifyrulesintheBlazeuser
interfaceinMywebMethods,theinterfaceredeploysthemodifiedrulestotheregistered
IntegrationServers.
Ifyouarenotdistributingbusinessprocesssteps,andthereforenotclusteringProcess
Engines,youcancreateeitheraseparateProcessAuditLogdatabasecomponentforeach
ProcessEngineorasinglesharedProcessAuditLogdatabasecomponent.
CreateasingleProcessAuditLogdatabasecomponentsforallTaskEnginestoshare.
IfyouareusingProcessEngines,TaskEngines,OptimizeAnalyticEngines,orsome
combinationofthese,createasingleProcessAuditLogdatabasecomponentforallto
share.
Process Engine Database Component

IfyouinstallProcessEnginesonIntegrationServers,youmustcreatetheProcessEngine
databasecomponent.
ProcessEngineswriteprocessexecutiondataforprocessestheyorchestratetothis
databasecomponent.
Ifyouaredistributingbusinessprocesssteps,youclustertheProcessEnginesthat
orchestratethesteps.CreateasingleProcessEnginedatabasecomponentforthe
clusteredProcessEnginestoshare.Ifyouarenotclustering,createaseparateProcess
EnginedatabasecomponentforeachProcessEngine.
27
2 Data Storage
Process Tracker Database Component

IfyouinstallOptimize,youmustcreatetheProcessTrackerdatabasecomponent.
OptimizeAnalyticEngineswritebusinessandprocessstatusdatareceivedfrom
processesthatarenotorchestratedbytheProcessEnginetotheProcessTrackerdatabase
component.TheOptimizeuserinterfaceinMywebMethodsdisplaysthedata.
CreateasingleProcessTrackerdatabasecomponentforallOptimizeAnalyticEnginesto
share.
Staging and Reporting Database Components

IfyouwanttogenerateMonitorreports,createtheStagingandReportingdatabase
components.
TheReportServergeneratesMonitorreportsfromthesedatabasecomponents,as
follows:
1
MonitorextractsbusinessprocessauditandexecutiondatafromtheProcessAudit
LogdatabasecomponentandloadsitintotheStagingdatabasecomponent.
MonitoraggregatesthedataintheStagingdatabasecomponentintodailystatistics
andloadstheaggregateddataintotheReportingdatabasecomponent.
TheReportServergeneratesMonitorreportsaboutbusinessprocessexecution
metricsfromtheaggregateddataintheReportingdatabasecomponent.The
ReportinguserinterfaceinMywebMethodsdisplaysthereports.
YoucancreatetheReportingandStagingdatabasecomponentsinthesamedatabase.
However,theMonitorservicesthataggregateandloaddataconsumelargeamountsof
theCPU.Forbestperformance,installtheReportingandStagingdatabasecomponents
onadatabaseserverthatwillnotadverselyaffecttheProcessAuditLogorProcess
Enginedatabasecomponents.
TheProcessAuditLog,Staging,andReportingdatabasecomponentshavea1to1to1
relationship.ThismeansthatyoucannotgatherdatafrommultipleProcessAuditLog
databasecomponentsintoasingleReportingdatabasecomponent.TheReportServercan
generateMonitorreportsfromonlyoneReportingdatabasecomponentatatime.
28
2 Data Storage
Trading Networks and Trading Networks Archive Database

Components
IfyouinstallTradingNetworks,youmustcreatetheTradingNetworksdatabase
component.IfyouwanttoarchiveyourTradingNetworksdata,alsocreatetheTrading
NetworksArchivedatabasecomponent.
TradingNetworksServerwritesmetadata(partnerprofiles,tradingpartneragreements,
documenttypes,processingrules,andpartnerprofilegroups)andruntimedata
(documents,documentcontentparts,attributes,anddeliveryinformation)totheTrading
Networksdatabasecomponent.TradingNetworksServeralsologsentriesabout
documentprocessingsteps.TradingNetworksConsoleandtheTradingNetworksuser
interfaceinMywebMethodsdisplaythedata.TradingNetworksarchivingfunctionality
canarchivedatafromtheTradingNetworksdatabasecomponenttotheTrading
NetworksArchivedatabasecomponent.
TheReportServergeneratesTradingNetworksreportsaboutB2Btransactionsand
tradingpartnersfromthedataintheTradingNetworksandTradingNetworksArchive
databasecomponents.TheReportServergeneratesOptimizeforB2Breportsabout
TradingNetworksdocumenttypesandattributesthataremonitoredbyOptimizefor
B2BfromthedataintheTradingNetworksdatabasecomponent.Thereportsdisplayin
thereportinguserinterfaceinMywebMethods.
IfyouareclusteringTradingNetworksServers,createasingleTradingNetworks
databasecomponentfortheclustertoshare.Ifyouarenotclustering,createaseparate
TradingNetworksdatabasecomponentforeachTradingNetworksServer.
CreatetheTradingNetworksArchivedatabasecomponentinthesamedatabaseasthe
sourceTradingNetworksdatabasecomponent.
29
2 Data Storage
Infrastructure Database Components

TheStoragedatabasecomponentcreatesdefaultwebMethodsstoragestructures,suchas
tablespacesandusercredentials,foralldatabasecomponents.
Thetablebelowlistsinfrastructuredatabasecomponentsthatareautomaticallycreated
whenyoucreateproductrelateddatabasecomponents.
Database Component
Description
CentralConfig
ContainstheconfigurationinformationenteredintheCentral
ConfigurationinterfaceinMywebMethods.ResidesintheMy
webMethodsServerdatabasecomponent.
Note: TheCentralConfigdatabasecomponentisautomatically
createdwhenyoucreatetheMywebMethodsServerdatabase
component.However,theCentralConfigdatabasecomponentis
notautomaticallydroppedwhenyoudroptheMywebMethods
Serverdatabasecomponent.Ifyouwanttodropthe
CentralConfigdatabasecomponent,youmustdosomanually.
Component
Tracker
Tracksthedatabasecomponentsthatarecreatedordropped.
DataPurge
ProvidesacommonmethodforpurgingdatafromtheAnalysis
andProcessTrackerdatabasecomponents.
Database
Management
Providescoreroutinesfordatapurgefunctionality.
Distributed
Locking
Coordinatesaccesstoresourcesacrossadistributedcollectionof
serversandprocesses.Resourcescanbelockedforexclusiveuse,
topreventanotherserverfromaccessingtheresourceasitis
beingupdated,orforshareduse,topreventanotherserverfrom
updatingtheresourceasitisbeingaccessed.
Operation
Management
Providesacommonmethodforconfiguration,logging,and
errorhandlingforanydatabasecomponent.
SuiteReporting
ContainstheconfigurationinformationenteredintheReporting
interfaceinMywebMethods.ResidesintheMywebMethods
Serverdatabasecomponent.
SuiteReporting
Common
ContainsthedatabaseobjectsforwebMethodsReporting
reports.
30
Software and Hardware Support and Requirements
Operating System Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32
RDBMS Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32
Browser Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32
JDK Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32
Third-party Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
Additional Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
35
31
3 Software and Hardware Support and Requirements
Operating System Support

ForinformationonoperatingsystemsthataresupportedbywebMethodsproducts,see
thewebMethodsSystemRequirements.
Special Considerations for Integration Server

IntegrationServersupportsWebapplicationsandJavaServerPages(JSPs)on
WindowsandSolarissystems.
IntegrationServersupportsC/C++andVisualBasiccodegenerationonOS/JVMbit
mode32/32and64/32platformsonly.
IntegrationServersonMacsystemscannotconnecttoBrokersusingSSL.
Special Considerations for webMethods Broker

OnWindowsandLinuxsystems,Software AGoffersdedicated64bitand32bit
versionsofBrokerServer.The64bitBrokerServerissupportedon64bitsystems.
The32bitBrokerServerissupportedon32bitsystems.
OnSolaris,HPUX,andAIXsystems,BrokerServerisa64bitbinaryapplication.
BeforeyouinstallBrokerServerononeofthesesystems,youmustconfigurethe
operatingsystemkerneltorunin64bitmode.
OnAIXorHPUXsystems,ifyouinstallthewebMethodsBrokerCAPI,Software AG
installs64bitand32bitversions.The64bitCAPIisinstalledinthewebMethods
Broker_directory/libdirectory.The32bitAPI(LP32ObjectCode)isinstalledinthe
webMethodsBroker_directory/lib32directory.
RDBMS Support
ForinformationonRDBMSsthataresupportedbywebMethodsproducts,seethe
webMethodsSystemRequirements.Forinformationonsupporteddatabasedrivers,see
webMethodsProductsandDatabasesonpage 94.
Browser Support
ForinformationonbrowsersthataresupportedbywebMethodsproducts,seethe
webMethodsSystemRequirements.
JDK Support
TheinstallerautomaticallyinstallsappropriateJDKsonmostoperatingsystems.For
informationontheJDKthateachwebMethodsproductusesbydefaultoneachtypeof
system,seeInstalledJDKsandProductJDKUsageonpage 147.
32
Third-party Software Requirements

ApplinX
IfyouareinstallingApplinXandwanttodevelop.NETApplinXWebapplicationsin
VisualBasicorC#,youmustinstalloneofthefollowing:
MicrosoftVisualStudio2005
MicrosoftVisualStudio2008andtheMicrosoftVisualJ#.NET2.0Redistributable
Package
Hardware Requirements
Thetablebelowliststheminimumandrecommendedhardwarerequirementsforeach
webMethodsproduct.Recommendedamountsareshowninparentheses.
Important! ThehardwarerequirementsbelowareforwebMethodsproductsonly.They
donotincluderequirementsforsupportingsoftwaresuchasRDBMSs.Youmust
determinetheoverallhardwarerequirementsforeachofyourmachinesbasedonthe
overallrequirementsofyouroperatingsystemandsoftware.
ApplinX and EntireX

Product
Hard Drive Space

(MB)
RAM (MB)
CPUs
2(4)
ApplinX
Server
100
80+300KB
peruser
Administration
75
40
JSPFramework
50
2048
C#.NETFramework
55
2048
VB.NETFramework
30
2048
VisualStudioAddIn
2048
600(Windows)
1024(2048)
EntireX*
1.3GB(UNIX)
*Includes500MBharddrivespace,1024MBRAM,and1CPUforSystemManagementHubandWeb
ServicesStack.
33
All Other Products

Product
Hard Drive Space

(MB)
InfrastructureSharedLibraries
200
BlazeAdvisor
RAM (MB)
CPUs
200
1024(2048)
webMethodsBroker
750(1250)
512(2048)
60
Developer
100(200)
128(256)
IntegrationServer
200(350)
256(512)
Monitor
NothingbeyondhostIntegrationServer.
MywebMethodsServer
300
1024(2048)
AnalyticEngine
100
2048*
(4096)
PredictionEngine
100
2048*
(4096)
300
2048(4096)
WebServiceDataCollector
100
256
Optimize
ProcessEngine
NothingbeyondhostIntegrationServer.
ReportServer
2500
TaskEngine
NothingbeyondhostMywebMethodsServer.
2048
TradingNetworks
Console
25
Server
50
128(256)
1
*1024indevelopmentenvironments.
64bitsystems.
MinimumIntelPentium42.0GHzorequivalent.
Documentation
Product
Hard Drive Space (MB)
MainProductDocumentation
600
ThirdpartyDocumentation
240
34
Additional Hardware Requirements

Thissectiondescribesadditionalrequirementsyoumustconsiderwhendetermining
actualhardwarerequirementsfortheindicatedproducts.
Product
Additional Requirements
webMethods
Broker
webMethodsBrokermightrequireadditionalharddrivespaceif
yourdocumentsarelarge,orifyourclientsusemanyguaranteed
documents.
OnaWindowssystem,youcanonlyinstallwebMethodsBrokerona
localharddrive.YoucannotinstallwebMethodsBrokerona
networkmounteddrive.
Deployer
Deployerrequiresadditionalharddrivespaceforthedeployment
projectsyoucreate.Whenallocatingspace,allowforthenumberof
projectstoincreaseovertime.
Optimize
engines
Eachenginerequires1024MBvirtualswapspaceandadisk
subsystemwith10GBavailablefreespace.Inaproduction
environment,thedisksubsystemmusthavearedundantarrayof
independentdisks(RAID5),anUltraWideSCSI,and10Kto15KRPM
drives.
Alsoinaproductionenvironment,eachenginerequiresadditional
harddrivespaceforlogfiles.Therecommendedamountis100MB;
eachenginerequires7MBofharddrivespaceforeachlogfile.
OptimizeWeb
ServiceData
Collector
EachWebServiceDataCollectorrequires128MBofvirtualswap
space.Inaproductionenvironment,eachWebServiceDataCollector
requiresadditionalharddrivespaceforlogfiles.Therecommended
amountis75MB;eachWebServiceDataCollectorrequires5MBof
harddrivespaceforeachlogfile.Moreharddrivespacemightbe
requiredifyouusedebuglevelorhigherlogging.
Trading
Networks
Touselargedocumenthandling,youneedadditionalharddiskdrive
spaceonwhichTradingNetworksServercantemporarilysave
documents(ratherthanstoretheminmemory).Theamountofspace
youneedvariesbasedonthenumberofdocumentsyouprocess
concurrentlyandthesizeofthedocumentsyouprocess.Forexample,
ifyourtypicalconcurrentdocumentloadis10,youwouldneedhard
diskdrivespacethatis10to15timesthecombinedsizeofthe
documentsbeingprocessedconcurrently.Formoreinformation,see
thewebMethodsTradingNetworksUsersGuide.
35
36
International Operating Environments
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
38
Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
38
Extended Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
38
Configure Browsers and JDK Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
39
Configure the Proper Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
39
37
4 International Operating Environments
Overview
webMethodsproductsaredesignedforuseanywhereintheworld,andenableyouto
exchangedatawithsystemsanduserswhospeaklanguagesotherthanyourown.
webMethodsproductsusetheUniversalCharacterSet(ISO/IEC106462,orUnicode)as
thecharactersetforallinternaloperations.Atminimum,theproductssupportthe
requirementsofUnicode3.0.webMethodsHTMLcontent,includingadministration
tools,usesUnicodeUTF8encoding.
Forspecificinformationonthetesting,configuration,capabilities,andlimitationsofany
webMethodsproduct,seetheproductsreadme.
Language Packs
LanguagepacksareavailableforwebMethodsBrokeronallsupportedoperating
systems.LanguagepacksareavailableforotherwebMethodsproductsonallsupported
operatingsystemsexceptMacOSX.
ThewebMethodsInstalleralwaysinstallstheU.S.Englishfilesnecessarytorun
webMethodsproducts.However,formanyproducts,youcanalsoinstalllanguagepacks
thatprovidetranslateduserinterfaces,messages,help,anddocumentation.
Mostproductssupportmultiplelanguagesatatime;youcaninstallasmanylanguage
packsasyouneed.Forproductsthatsupportmultiplelanguages,yourclientsetup(that
is,browserlanguagepreference,defaultlocaleinwhichtheproductisstarted,andlocale
selectedinyouruserprofile)willdeterminewhichlanguageyousee.Ifyouoperatea
productinalocaleforwhichlanguagepacksarenotavailableorinstalled,youwillsee
U.S.English.
Extended Character Set

ThewebMethodsInstalleroffersanextendedcharactersetthatextendsJavas
java.nio.Charsetclasstosupportadditionalinstallablecharacterencodingsandadds
morethan870customcharacterencodings.Theextendedcharactersetallowsyoutouse
customcharacterencodingssuchasEBCDICandOEMcharacterencodingswith
IntegrationServer,adapters,andservices.
38
Configure Browsers and JDK Font

SomeHTMLinterfacesforwebMethodsproductsdetectthelanguagesettingforyour
browser.IfyouhaveinstalledwebMethodslanguagepacksonyourwebMethods
products,thoseinterfacestrytosupplytheuserinterface,messages,anddatainthat
language.Youcanindicatewhichoftheinstalledlanguagestodisplayinyourbrowseras
follows:
Browser
Action
Firefox2.x
GotoTools > Options > Advanced > General. ClickEdit Languagesand

addthelanguageyouwanttousetothetopofthelist.
Firefox3.x
GotoTools > Options > Content. ClickChooseandaddthelanguage

youwanttousetothetopofthelist.
InternetExplorer
6.xand7.x
GotoTools > Internet Options.ClickLanguagesandaddthelanguage

youwanttousetothetopofthelist.
YourJavaruntimeenvironmentmightrequiremodificationtodisplaynonASCIIdata.If
youseehollowboxesorblacksquareswhereyouwouldexpecttoseenonASCII
characters,youmightneedtomodifyyourJDKsfontconfigurationfiletoprovidean
appropriatefontfordisplayingthesecharacters.Forexample,youmightinstallafull
Unicodefont,suchasArialUnicodeMS,oryoucaninstallafontforaparticular
language.Forinformationonmodifyingfontconfigurationfile,seeJ2SE5.0at
http://java.sun.com/j2se/1.5.0/docs/guide/intl/fontconfig.html
Configure the Proper Locale

IfyouaregoingtoinstallorrunwebMethodsproductsinalocaleotherthanU.S.
English,dothefollowing:
System
Steps
Windows
SettheWindowssystemlocaletotheproperlocale,asfollows:
1
OntheStartmenu,gotoControl Panel > Regional and Language Options.
ClicktheAdvanced tab.IntheLanguage for non-Unicode programsarea,

clickthelanguagetouseandclickOK.
RestartWindows.
Note: TheinstructionsaboveareforWindowsXP.Instructionsforother
Windowssystemsvaryslightly.
39
System
Steps
UNIX
SetyourshelltotheproperlocalebysettingtheLANGenvironment
variable.Runtheappropriatecommandbelow:
40
Shell
Command
sh
LANG=locale; export LANG
csh
setenv LANG locale
Preparing for Product Installation
About the webMethods Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
42
Prepare for Installation on All Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
42
Prepare for Installation on a Windows System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
43
Prepare for Installation on a UNIX or Mac System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
44
Installation Scripts and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
47
41
5 Preparing for Product Installation
About the webMethods Installer

ThewebMethodsInstallerofferstwomodes:
Mode
Description
Wizard
Note: AvailableonalloperatingsystemssupportedbywebMethods
products.UNIXsystemsmusthaveanXWindowsenvironment.Youcan
usethewizardtoinstalllocallyorremotely.
Console
YoucanuseconsolemodetoinstalllocallyorremotelyonaUNIXorMac
operatingsystem.
Theinstallerwritesanyerrorsorwarningsthatoccurduringinstallationtoafilenamed
WmInstallLog.txtinthewebMethods_directory/install/logsdirectory.Ifnecessary,youcan
changeloggingbehavior.Forinstructions,seeChangeLoggingLevelandFile,andAdd
Targetsonpage 56orpage 82.
Theinstallerwritesproduct,version,andbuildinformationtoanaudithistorylogfile
namedhistory.txtinthewebMethods_directory\install\historydirectory.
Prepare for Installation on All Systems

1
Software AGrecommendsupgradingyouroperatingsystemtothemostrecent
maintenancelevel(WindowsServicePack,AIXTechnicalLevel,HPUXQualityPatch
Bundle,SuSE/RedHatServicePack/Update)beforeinstallingwebMethodsproducts.
Exceptwherenotedelsewhereinthischapter,webMethodsproductswillworkon
anypatchlevel.
Makesurethemachineonwhichyouaregoingtoruntheinstallerhasatleast1GBof
availablevirtualmemory.
Makesurethemachinehasthefollowingamountsofavailablediskspaceinits
systemtemp(Windows)ortemporary(UNIX)directory:
42
Installation
Available Disk Space
YouarenotinstallingEntireXorthe
ReportServer,andarenotinstalling
fromaninstallationimage
100MB
Youareinstallingfroman
installationimage
100MBplusenoughadditionalavailable
diskspacetoaccommodatetheimage;for
example,iftheimageis200MB,the
directorymusthaveatleast250MBof
availablediskspace
YouareinstallingEntireX
800MB
YouareinstallingtheReportServer
4GB
Note: Ifnecessary,youcanspecifyadifferentdirectorytouseasthesystemtemp
ortemporarydirectorywhenyoustarttheinstaller(seeStartthewebMethods
Installeronpage 50andpage 78).
4
Software AGprovideslicensefilesforseveralproducts;theinstallerrequiresthem
duringinstallation.Copythelicensefilestothemachine.
WhenyouinstallApplinXorEntireX,thewebMethodsInstallerautomaticallyalso
installssomeorallofthesecomponents:SystemManagementHub,TomcatKit,and
JavaDevelopmentKit1.6.Ifyouhaveneverinstalledthesecomponentsbefore,orif
yourmachinealreadyhasinstallationsofearlierreleasesofthesecomponents,
Software AGstronglyrecommendsthatyoubackuporimageyourmachinebefore
youinstall.
Note: Inearlierreleases,TomcatKitwasknownasCommonTomcatPackage,and
JavaDevelopmentKit1.6wasknownasCommonJavaPackage.
Prepare for Installation on a Windows System

1
DownloadthewebMethodsInstallerforWindowsfromthewebMethodsAdvantage
Website.
IfyouareinstallingApplinXorEntireXonaVistasystem,disableUserAccount
Control(UAC).
Important! YoumustdisableUACorinstallationwillfail.
IfyouareinstallingApplinXandwanttodevelop.NETApplinXWebapplicationsin
VisualBasicorC#,installMicrosoftVisualStudio2005,orinstallMicrosoftVisual
Studio2008andtheMicrosoftVisualJ#.NET2.0RedistributablePackage.Microsoft
VisualStudiodoesnothavetoberunningwhenyouinstallApplinX.
Important! IfyoudonotinstallMicrosoftVisualStudio,youwillnotbeableto
installtheApplinXVisualStudioAddincomponent,andtheApplinX.NET
Frameworkcomponentwillhavelimitedfunctionality;youwillnotbeableto
developcompositeWebapplications.
43
ShutdownthefollowingSoftware AGproductsiftheyarerunningonthemachine:
Products to Shut Down
Method
ApplinX,EntireX,MywebMethodsServer(andTask
Engine),OptimizeAnalyticEngineandPrediction
Engine,andReportServerwheninstalledas
applications
UseWindowsStartmenu
(Start > Programs >
Software AG > webMethods >
Stop Servers>product)
BrokerMonitor(whichstopsBrokerServers),System
ManagementHub*,andTomcatKit
UseWindowsServices
window(Software AG
webMethodsproductrelease
ApplinX,MywebMethodsServer(andTaskEngine),
OptimizeAnalyticEngineandPredictionEngine,
andReportServerwheninstalledasservices
Developer,Designer,IntegrationServer(andthe
productsithosts),andOptimizeInfrastructureData
Collector
Fromproductinterface
(seeproduct
documentation)
*SystemManagementHubservicesarenamedSoftware AGCSLayerServiceandEventLayerService.
TomcatKitservicenameisSoftware AGCommonTomcatcp8.0.
Prepare for Installation on a UNIX or Mac System

1
DownloadthewebMethodsInstallerforUNIXfromthewebMethodsAdvantage
Website.
Installa32or64bitJREorJDK1.5or1.6toruntheinstaller.ForanAIXsystem,if
youwanttoinstallaJDK1.6,youmustinstallJDK1.6SR4.
IfyouaregoingtoinstallwebMethodsproductsonaremotemachineandyouwant
toinstallusingtheinstallerwizard,aninstallationimage,oraninstallationscriptthat
usesthewizard,followthesesteps:
a
Enablethedisplayofthelocalmachineusingthecommandshownbelow,where
remote_hostistheremotemachineonwhichyouaregoingtoinstall:
xhost +remote_host
LogontotheremotemachineandsettheDISPLAYvariableontheremote
machinetopointtothelocalmachine.Forexample,ifyouareusingaBashshell,
areinstallingfromalocalmachinenamedinstallmachine,andwanttosetthe
displaytothedefaultdevice,enter:
export DISPLAY=installmachine:0.0
44
Usetheinstructionsprovidedintheproductdocumentationtoshutdownthe
Software AGproductsbelowiftheyarerunningonthemachineonwhichyouare
goingtoinstall:
ApplinX
BrokerMonitor(alsostopsBrokerServers)
EntireX
OptimizeAnalyticEngine,
PredictionEngine,and
ReportServer
IntegrationServer(andproductsithosts)
MywebMethodsServer(andTaskEngine)
SystemManagementHub
TomcatKit
Prepare to Install webMethods Broker

IfyouaregoingtoinstallwebMethodsBroker,dothefollowing:
1
InformationaboutwebMethodsBrokerinstallationsisstoredinthe
BrokerInstallations.txtfileinthe/var/opt/webMethodsdirectory.Makesureyouhave
writepermissiontothatdirectory.
TheBrokerServerforSolaris,HPUX,andAIXsystemsisa64bitbinaryapplication.
IfyouaregoingtoinstallwebMethodsBrokerononeofthesesystems,configurethe
operatingsystemkerneltorunin64bitmode.Youcannotrunthe64bitBroker
Serveronanoperatingsystemkernelthatisconfiguredtorunin32bitmode.
IfyouaregoingtoconfigureBrokerServertocreatedatafilesonanNFSmounted
partition,mountthepartitionusingthecommandbelow.Theoptionsonthe
commandhelpprotectdataintegrity.
mount -o hard,nointr,proto=tcp host:/path /mount_point
Option
Description
hard
Bydefault,iftheNFSserverdoesnotrespondtorequestsfromthe
BrokerServer,theBrokerServertriesafewtimesandthenfails.The
hardoptionforcestheBrokerServertokeepretryinguntiltheNFS
serverresponds.TheBrokerServerhangsduringthisperiod.
nointr
PreventsusersfromshuttingdowntheBrokerServerwhileitwaits
fortheNFSservertorespond.
proto=tcp
Bydefault,theNFSmountedpartitionusestheuserdatagram
protocol(UDP)protocoltocommunicatewiththeBrokerServer.The
proto=tcpoptionforcesthepartitiontousetransmissioncontrol
protocol(TCP)instead.TCPismorereliablethanUDP.
Supposethepartitionyouwanttomountisonamachinenamednetappca,thedata
directoryonthepartitioniswmbroker_data,andyouwanttomountthepartitionon
thelocalfilesystemat/var/opt/wmbroker_data.Thecommandwouldbeasfollows:
45
mount -o hard,nointr,proto=tcp netappca:/wmbroker_data /var/opt/wmbroker_data
Forinformationonotherwaystoprotectdataintegrity,seeyourNFSserver
documentation.
4
IfyouareinstallingonaSuSELinuxEnterpriseServer(x86_64)orRedHatEnterprise
LinuxServer(x86_64)system,installthecompatlibstdc++packagefromyour
operatingsystemdistributionsusingthevendorinstructions.
IfyouareinstallingonanAIXsystem,Software AGstronglyrecommendsthatyou
upgradetothemostrecentAIXTechnicalLevel(TL).Atminimum,youmusthaveTL
7forAIX5.3andTL2forAIX6.1.
Prepare to Install ApplinX and EntireX

Ifyouaregoingtoinstalloneormoreoftheseproducts,dothefollowing:
IfyouareinstallingonaSuSELinuxEnterpriseServersystemthatisconfiguredto
runinparallelbootmode,youmustdisableparallelbootmodeortherc.scriptsthat
areinstalledbytheinstallerwillnotwork.Openthefile/etc/sysconfig/bootandset
RUN_PARALLEL=no.
Important! Ifyoudonotdisableparallelbootmode,installationwillfail.Donotre
enableparallelbootmodeafterinstallation.
IfyouareinstallingonaSuSELinuxEnterpriseServerorRedHatEnterpriseLinux
Serversystem,installcompatlibstdc++,glibc,libgcc,pamandncursesRPMfrom
youroperatingsystemdistributionusingthevendorinstructions.
Duringinstallation,theinstallerwillaskwhetheryouwanttoinstallusingsudo
authentication.IfyouwanttousesudowheninstallingonSuSELinuxEnterprise
ServerorRedHatEnterpriseLinuxServersystems,youcannotusetheoption
Defaults env_reset.Openthesudoconfigurationfile/etc/sudoersanddothe
following:
On this system...
Do this...
SuSELinuxEnterpriseServer10
CommentouttheoptionDefaults env_reset.
SuSELinuxEnterpriseServer11
orRedHatEnterpriseLinux
Server5
ExplicitlysettheDefaults env_resetoption
with!(thatis,Defaults !env_reset).
Important! IfyouusetheoptionDefaults env_resetinsteadoffollowingthe

instructionsabove,youwillhavetousesuauthenticationduringinstallation.
46
Prepare to Install Report Server

IfyouaregoingtoinstalltheReportServer,dothefollowing:
Addthecurrentworkingdirectory(thatis,.)toyourPATHenvironmentvariable(for
example,PATH=.:/usr/bin)
Ona64bitsystem,addthewebMethods_directory/cognos/c8/bin64directorytothe
librarypathenvironmentvariable,asfollows:
System
Library Path Environment Variable
SolarisorLinux
LD_LIBRARY_PATH
AIX
LIBPATH
HPUX
SHLIB_PATH
Installation Scripts and Images

Theinstalleroffersadvancedoptionsforcreatingandinstallingfrominstallationscripts
andinstallationimages.
Installation Scripts
Ifyouwanttocreateidenticalinstallationsonmultiplemachines,youcancreateascript
oftheinstallationononeofthemachines,thenrunthescripttocreatethesame
installationoneachoftheothermachines.
Tocreateascript,youruntheinstaller,selecttheproductstoinstall,andspecifyallthe
installationoptions(forexample,releasenumber,usernameandpassword,andtarget
installationdirectory).Whenyourunthescript,theinstallerautomaticallydownloads
theproductsyouselectedfromthewebMethodsinstallationserverandinstallsthem
usingtheinstallationoptionsyouspecified.
Whenyoucreatethescript,theinstallerscansthetargetinstallationdirectoryyouspecify
onthelocalmachine,andusesthatasthemodelfortheothertargetmachines.Ifa
productalreadyexistsinthislocaldirectory,youwillnotbeabletoselectitforthescript.
Makesure,therefore,thatanywebMethodsproductsalreadyinstalledinthislocal
directoryarealsoalreadyinstalledinthetargetdirectoryontheothermachines.
Youcaneditascriptbyrerunningtheinstallerandmakingdifferentchoices.Youcan
savethescriptunderthesamename,orcreateanewscriptbysavingitunderanew
name.
Note: Ifyoudonotwantthescripttogooutsideyourcorporatefirewalltothe
webMethodsinstallationserver,youcancreateaninstallationimage,thencreatea
scriptofrunningtheimage.Whenyourunthescript,itdownloadsandinstallsthe
productsfromtheimageinsteadofthewebMethodsinstallationserver.
47
Installation Images
Ifyouneedtocreateinstallationsonmachinesthatcannotgooutsideyourcorporate
firewalltothewebMethodsinstallationserver,youcandownloadwebMethodsproducts
fromthewebMethodsserverintoaninstallationimage,andthenusethatimagetoinstall
thedesiredsubsetsofproductsontoeachmachine.
Youcreateeachimageforaparticularoperatingsystem,butyoucandosobyrunningthe
installeronanyoperatingsystem.Forexample,youcanruntheinstalleronaWindows
systemandcreateanimageforaSolarissystem.Youcancreateimagesmorequicklyby
retrievingproductsfromexistingimagesratherthandownloadingthemfromthe
installerserver.
Imagesdonotincludeinformationoninstallationoptionssuchastargetinstallation
directory,becausethoseoptionscanvarybymachine.Youspecifyinstallationoptionsfor
eachmachinewhenyouinstallfromtheimage.
WhenyouselectwebMethodsproductsforanimage,theinstallerlistsadditional
requiredproductsandaskswhetheryouwanttoincludethem.Useyourknowledgeof
thetargetinstallationdirectoriestodeterminewhichrequiredproductstoinclude.When
youinstallfromtheimage,thetargetdirectoriesmustcontainallrequiredproductsyou
didnotincludeintheimage.
TheexceptionisDesignerEclipse.IfyouselectDesignerpluginsfortheimage,the
installerdoesnotaskwhetheryouwantittoautomaticallyselectEclipse.Ifyouwant
toincludeEclipseintheimage,youmustselectitmanually.
Theinstallersavesimagesaszipfiles.EachzipfileincludesanHTMLfilenamedImage
Contentsthatyoucanopentoseethecontentsoftheimage.
48
Using the Wizard to Install
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
50
Start the webMethods Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
50
View the Welcome Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
52
Use Advanced Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
53
Specify Release, User Name, and Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
57
Specify the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
58
Select Products to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
59
Select Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
61
Configure Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
62
Review and Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
76
49
6 Using the Wizard to Install
Overview
ThischapterexplainshowtodothefollowingonanysystemusingthewebMethods
Installerwizard:
InstallwebMethodsproducts
CreateaninstallationscriptorimagefromwhichtoinstallwebMethodsproducts
InstallwebMethodsproductsfromaninstallationscriptorimage
Start the webMethods Installer

Start the webMethods Installer on a Windows System
ToruntheinstalleronaWindowssystem,youmusthaveWindowssystemadministrator
privileges.Theuserunderwhichyoulogontoyourmachinewillownallfilesyou
install.
Thewayyoustarttheinstallerdependsonthetaskyouwanttoperform,asindicated
below.Ifyouwanttoperformthetasksthatusethejavajarcommand,youmustfirst
downloadtheinstallerforUNIXfromthewebMethodsAdvantageWebsiteandinstalla
32bitJREorJDK1.5or1.6toruntheinstaller.
Important! IfyouwanttoruntheinstallerwizardonaHebrewWindowssystem,use
theinstructionsinStartthewebMethodsInstalleronaUNIXorMacSystemon
page 51.
Tostarttheinstallerformostuses,openWindowsExplorer,gotothedirectorythat
containstheinstaller,anddoubleclickthewebMethodsInstaller801.exefile.
Youcanrunaninstallationscriptfromthewizardorthecommandline.Tousethe
installers.exefiletorunascriptfromthecommandline,followthesesteps:
50
Openacommandwindow.
SettheenvironmentvariableZFUSION_INSTALL_ARGSto
readScriptfull_path_to_script(forexample,enterset ZFUSION_INSTALL_ARGS=
-readScript c:\myScript.txt).
Gotothedirectorythatcontainstheinstallerandenter
webMethodsInstaller801.exe.
Tousetheinstallers.jarfiletorunascriptfromthecommandline,runthis
command:
java -jar webMethodsInstaller801.{jar|zip} -console -readScript scriptfile
Tohavetheinstalleruseadifferentsystemtempdirectorythanthedefault,runthis
command:
java -Xmxamountm -Xincgc -Djava.io.tmpdir=different_directory
-jar webMethodsInstaller801.{jar|zip}
Start the webMethods Installer on a UNIX or Mac System

Logonasanonrootuser.Theuserunderwhichyoulogonwillownallfilesyouinstall.
Important! OnUNIXsystems,ifyouaregoingtoinstallApplinXorEntireX,theuser
musthavewriteaccesstothedirectoryfromwhichyoustarttheinstaller.Donotrun
theinstallerasabackgroundprocess.
below.
Note: OnUNIXsystems,youmightreceiveJavamessageswhenyoustarttheinstaller.
Forexample,youmightreceivewarningmessagesaboutsystempreferences,or
aboutunlockingconnections.Youcanignorethesemessages.
Formostuses,runthiscommand:
java -Xmx512m -Xincgc -jar webMethodsInstaller801.{jar|zip}
OnaSolarisx8664EM64Tsystem,oronaSolarisx8664AMDOpteronsystemwhen
youareusingJDK1.6toruntheinstaller,runthiscommand:
java -Xmx512m -Xincgc -Dsun.cpu.isalist=amd64
Tohavetheinstalleruseadifferenttemporarydirectorythanthedefault,runthis
command:
java -Xmx512m -Xincgc -Djava.io.tmpdir=different_temp_directory
51
View the Welcome Panel

TheinstallertakesseveralsecondstounzipandlaunchitsJVM,thendisplaysthe
welcomepanel.
Note: OnWindowssystems,iftheprogressbarontheinstallerlauncher(called
Zipfusion)stopsshowingprogress,yourantivirussoftwaremightbeinterfering.
Starttheinstallerusingthejarfileinstead(seeStartthewebMethodsInstalleron
page 50).
Youcanresizethewizard.
Ifyouwanttocreateorrunaninstallationscriptorimage,installusingaproxyserver,or
changeloggingoptions,clickAdvanced OptionsandgotoUseAdvancedOptions,
below.IfyouwanttoinstallwebMethodsproductswithoutusinganyadvancedoptions,
clickNextandgotoSpecifyRelease,UserName,andPasswordonpage 57.
52
Use Advanced Options

Whenareyoudonesettingadvancedoptions,clickOK.Theinstallerclosesthedialogbox
andreturnstothewelcomepanel,whereyoucanclickNexttocontinue.
Note: YoucanignoretheJVMtab.Itisnotusedinthisrelease.
Create, Install from, or Edit an Installation Script

Forinformationoninstallationscripts,seeInstallationScriptsandImagesonpage 47.
Youcandothefollowingfromthispanel:
To do this...
Follow these steps...
Createscriptand
install
ClickCreate script.IntheScript file namefield,enterthefullpath

tothefileinwhichtosavethenewscript.Youcanspecifyany
name,andyoudonothavetospecifyanextension.
Createscriptwithout
installing
ClickEdit script.IntheScript file namefield,enterthefullpathto

thefileinwhichtosavethescript.Youcanspecifyanyname,
andyoudonothavetospecifyanextension.
53
To do this...
Follow these steps...
Createscriptfrom
existingscript
withoutinstalling
ClickInstall from script.IntheadjacentScript file namefield,type

thefullpathtothefilethatcontainstheexistingscripttouse
asatemplateforthenewscript.
ClickCreate script.IntheadjacentScript file namefield,typethe
thefullpathtothefiletowhichtowritethenewscript.
Installfromscript
ClickInstall from script.IntheScript file namefield,typethefull

pathtothefilefromwhichtoinstall.
Iferrorsoccurwhilethescriptisrunning,installationfails.
Editscript
ClickEdit script.IntheScript file namefield,typethefullpathto

thefilethatcontainsthescripttoedit.
Create or Install from an Installation Image

Forinformationoninstallationimages,seeInstallationScriptsandImagesonpage 47.
full path to file in which

to save image (installer
adds the file extension
.zip)
system for which to

create image; can create
image for any system
from any system
full path to file that

contains image from
which to install
lists the products in the specified image
54
Use a Proxy Server to Install

IfyourcompanyconnectstotheInternetthroughanHTTPorSocksproxyserver,you
mustusethatproxyservertoinstall.Yournetworkadministratorcanprovide
informationonyourcompanysproxyservers.
host name or fully

qualified IP address
user name and
password for installer
to use to log on to
proxy server
host name or fully
qualified IP address
55
Change Logging Level and File, and Add Targets

Bydefault,theinstallerwriteserrorsandwarningsthatoccurduringinstallationtoafile
namedWmInstallLog.txtinthewebMethods_directory/install/logsdirectory.Youcan
increaseordecreasetheamountofinformationthatiswritten,specifyadifferentfile
nameanddirectory,andchoosetowritetostandardoutandstandarderrorinadditionto
thelogfile.
Verbose produces
a 10 to 200MB file
56
Specify Release, User Name, and Password
IntheReleaselist,clickwebMethods 8.x.ProvideyourwebMethodsAdvantageusername
andpassword.ClickNext.Theinstallerusestheusernameandpasswordtoconnectto
thewebMethodsserveranddownloadthewebMethodsproductsforwhichyouhave
purchasedlicenses.
57
Specify the Installation Directory
see below
Windows only
Theusernameunderwhichyouarerunningtheinstallermusthavefullreadandwrite
permissionstotheinstallationdirectoryyouspecify.
ApplinXandEntireXrequireandsharesomeorallthesesupportingcomponents:System
ManagementHub,TomcatKit,andJavaDevelopmentKit1.6.Ifthoseshared
componentsexistonthelocalmachine,donotspecifythatdirectoryhere.
Ifyouareinstallingfromaninstallationimage,specifytheinstallationdirectoryfor
whichtheimagewasdesigned.Theinstallationdirectorymustcontainrequiredproducts
thatyoudidnotincludeintheimage.Forexample,iftheimagecontainsDesignerplug
ins,theinstallationdirectorymustcontainEclipse.Formoreinformation,see
InstallationImagesonpage 48.
Important! DonotinstallproductsfromthewebMethods 8.xreleaseintoadirectorythat
containsproductsfromanyotherrelease.
ClickNext.
58
Select Products to Install
TheinstallerliststhewebMethodsproductsforwhichyouhavepurchasedlicensesand
thataresupportedonthetargetoperatingsystem.
Important! Theinstallerdoesnotdistinguishamongversions(Windows)orflavors
(UNIX)ofanoperatingsystem.Makesureyouinstallproductsonlyonsupported
operatingsystems,asspecifiedinthewebMethodsSystemRequirements.
Important! YoucannotinstallmultipleinstancesofSystemManagementHub8.xonthe
samemachine.
Thehighestlevelintheproductselectiontreeshowsproductnamesandreleases,while
thelowerlevelsshowtheitemsthatmakeuporcanbeusedwiththeproduct.Ifyouhave
alreadyinstalledaproductoriteminthespecifiedinstallationdirectory,theitemnameis
followedbythetext(Installed)andtheitemnameanditscheckboxaregrayedout.
Youcanchooseproductsusingthesemethods:
ChoosetypicaldevelopmentinstallationsfromtheTypical Installationslist.Theinstaller
automaticallyselectstheproductsanditemsinthetreethatmakeupthose
installations.
ChooseeveryproductanditeminthetreebyclickingSelect All.
59
Chooseindividualproductsinthetree.Ifachosenproductrequiresotherproducts
anditemsonthesamemachine,theinstallerautomaticallyselectsthem.Forexample,
TradingNetworksServerrequiresIntegrationServeronthesamemachine.Ifyou
selectTradingNetworksServer,theinstallerselectsIntegrationServer.
Important! Ifyouarecreatinganinstallationimage,theinstalleraskswhetheryou
wantittoautomaticallyselectadditionalrequiredproducts.Forinformationon
howtorespond,seeInstallationImagesonpage 48.
IfyouselectDesignerplugins,theinstallerdoesnotaskwhetheryouwantitto
automaticallyselecttheDesignerEclipse.IfyouwanttoincludetheDesigner
Eclipseintheimage,youmustselectitmanually.
Ifachosenproductrequiresotherproductsanditems,butnotonthesamemachine,
theinstallerdoesnotautomaticallyselectthem.Forexample,Optimizerequiresits
userinterface,butyoucaninstalltheuserinterfaceonadifferentmachine,sothe
installerdoesnotselectit.
Chooseindividualitemsonthetree.Ifachosenitemrequiresotherproductsand
itemsonthesamemachine,theinstallerautomaticallyselectsthem.
Whenyouaredone,clickNext.
60
Select Language Packs

Iflanguagepacksareavailableforproductsyouareinstallingorhavealreadyinstalled,
theinstallerdisplaysthelanguagepackspanel.
ManywebMethodsproductssupportmultiplelanguages.Youcaninstallasmany
languagepacksasyouwant,andallofthelanguagesinstalled(includingthedefault,U.S.
English)willbeavailabletousers.
Selectthelanguagepackstoinstall,andthenclickNext.
61
Configure Products
Ifyouareinstallinganyoftheproductslistedbelow,theinstallerdisplaysconfiguration
panels.
ConfigureTradingNetworksServer
ConfigureOptimize
ConfigureIntegrationServer
ConfigureInfrastructureDataCollector
ConfigurewebMethodsBroker
ConfigureDesigner
ConfigureMywebMethodsServer
ConfiguretheReportServer
ConfigureApplinXandEntireX
Database Connection Information

Someproductsrequireyoutosupplydatabaseconnectioninformation.Keepinthemind
thefollowing:
webMethodsproductsusetheDataDirectConnectJDBC4.0driver.Forinformation
aboutoptionssupportedbythisdriver,seeDataDirectConnectforJDBCUsersGuide
andReference4.0inthewebMethodsinstallationdirectory/_documentationdirectory
oronthewebMethodsBookshelf.
Foreaseofuse,thedatabaseconnectionvaluesyouenterononepanelarereflected
onthenextasyougoforwardthroughtheinstallerthefirsttime.
Ifthedatabaseuserandpassworddonotyetexist,specifythedatabaseuserand
passwordyouwillcreateafterinstallation.Youcanuseonedatabaseuserfor
multiplewebMethodsdatabasecomponents,oryoucanuseadifferentdatabaseuser
foreachdatabasecomponent.
ForDB2,iftheproductwillconnecttoaschemaotherthanthedefaultschemaforthe
specifieddatabaseuser,youmustspecifytheseconnectionoptionsintheURL:
;AlternateId=schema;InitializationString="SET CURRENT PATH=schema"
AlternateID isthenameofthedefaultschemathatisusedtoqualifyunqualified
databaseobjectsindynamicallypreparedSQLstatements.
62
Configure Trading Networks Server
connection from Trading

Networks Server to Trading
Networks database component
63
Configure Optimize
if you have multiple network

interfaces, identify the one to use;
default is default network interface
for local machine; do not use
localhost
enabled if chosen on
product selection tree
Windows only
OptimizeprovidesaCentralConfigurationuserinterfacethatallowsyoutoconfigure
Optimizecomponentsfromacentralmachine.Specifytheportyouwanttheinterfaceto
usetocommunicatewitheachOptimizecomponentyouareinstalling.Eachportmustbe
unique.Ifyouinstallmultipleinstancesofacomponentonthesamemachine,theport
foreachinstancemustbeunique.
64
Configure Integration Server
full path to Integration

Server license file
if multiple Integration Server

instances on same machine, use
unique ports for each instance
Windows only
available when External

RDMBS is selected; connection
from Integration Server to
database components
YoumustdecidewheretostoredatawrittenbyIntegrationServer.Forcomplete
information,seeIntegrationServerDataStorageonpage 22.
Important! IfyouareinstallingonaWindowssystemandwillbeusingaversion
controlsystemwithDeveloper,youmustinstallIntegrationServerasanapplication
ratherthanaservice.
65
Configure Infrastructure Data Collector
can supply at startup instead

Windows only
OptimizeprovidesaCentralConfigurationuserinterfacethatallowsyoutoconfigure
Optimizecomponentsfromacentralmachine.Specifytheportyouwanttheinterfaceto
usetocommunicatewiththeOptimizeInfrastructureDataCollector.Theportmustbe
unique.IfyouinstallmultipleinstancesoftheInfrastructureDataCollectoronthesame
machine,theportforeachinstancemustbeunique.
66
Configure webMethods Broker
if multiple Broker Monitor

unique port for each instance
Broker Server uses this port for

non-SSL and previous two ports for
SSL; if multiple Broker Server
unique ports for each instance
full path to directory for Broker

Server data; if multiple Broker
Server instances on one
machine, use different data
directory for each instance
Create a Broker Server Configuration

YouwouldnotcreatetheBrokerServerconfigurationatthistime(thatis,usingthe
installer)ifyouwanttouseadifferentstoragesizethanisofferedonthepanelorifyou
wanttocreateacombinedstoragesessionforconfigurationandruntimedata.Ifyoudo
notneedtobackupconfigurationdatawithoutshuttingdownyourBrokerServer,using
acombinedsessionmightsaveyouasmallamountofdiskspace.Ifyouchoosetonot
createtheBrokerServerconfigurationatthistime,youmustcreateitafterinstallationis
complete,usinginstructionsinthewebMethodsBrokerAdministratorsGuide.
YouwouldcreatetheBrokerServeratthistime(thatis,usingtheinstaller)ifyouwantto
useastoragesizethatisofferedonthepanelandyouwanttocreateseparatestorage
sessionsforconfiguration(metadata)andruntimedata.Usingseparatestoragesessions
minimizestheriskofcorruptionthatgoeswithacombinedstoragelocationandenables
youtobackupconfigurationdatawithouthavingtoshutdownyourBrokerServer.(For
informationaboutthewebMethodsBrokeronlineconfigurationdatabackuptool,seethe
webMethodsBrokerAdministratorsGuide.)
Important! Software AGrecommendscreatingseparatesessions.Youcannotlater
changefromacombinedsessiontoseparatesessionsorviceversa.
67
SelectapreconfiguredstoragesessionfortheBrokerServerthatcanhandleyour
expectedusageneeds,asfollows:
Files Created
Broker Server
Startup Time
When to Use
Small Configuration
32MBlogfile512MB
storagefile
IdealforrunningdevelopmentBroker
Serversorrelativelyfewproduction
integrations,lowdocumentvolumes,and
nodocumentlogging
Fastestofall
configurations
Standarddeploymentsize,fitsmorecases
thanSmall;largermaximumtransaction
sizeandtwicethestoragecapacityof
Small
Uptotwiceas
longasforSmall
Suitableforproductiondeploymentswith
manyintegrationsrunningatrelatively
highdocumentvolumes,possiblyusing
documentloggingaswell
Twotimeslonger
thanforMedium;
fourtimeslonger
thanforSmall
Medium Configuration
64MBlogfile
4GBstoragefile
Large Configuration
128MBlogfile
8GBstoragefile
*ForcompleteinformationonBrokerServerstoragesessions,seethewebMethodsBrokerAdministratorsGuide.)
Whendeterminingtheappropriatesizeforthelogfile,thefactorstobalanceareBroker
Serverstartuptimeandthedesiredmaximumtransactionsize.Thesmallerthelogfile,
thefasterthestartup;however,withalargerlogfile,youcansendlargermessages(that
is,onelargersizedsingledocumentorabatchofdocuments).Ifnecessary,youcan
removeorreplacelogfilesafterinstallation,andyoucanincreaseordecreasetheirsize.
Startuptimedoesnotdependonthesizeofthestoragefile;additionalstoragecapacity
merelypreventstheBrokerServerfromrunningoutofroom.Afterinstallation,ifthe
amountofstorageallocatedturnsouttobeinsufficient,youcanaddstoragefilesand
increasetheirsize.Youcannotremovestoragefilesordecreasetheirsize.
ThewebMethodsBrokerAdministratorsGuideprovidesinstructionsonworkingwithlog
filesandstoragefiles.
68
Configure Designer
Important! YoucaninstallDesignerpluginsofferedonthewebMethodsInstallerinto
onlytheDesignerEclipseofferedonthewebMethodsInstaller.
IfyouselectedDesignerpluginsontheproductselectiontree,andnoDesignerEclipse
existsonyourmachine,theinstallerautomaticallyinstallstheDesignerEclipsewiththe
pluginswithoutdisplayingthispanel.
IfyouselectedDesignerpluginsontheproductselectiontree,andoneormoreDesigner
Eclipsesalreadyexistonyourmachine,theinstallerdisplaysthispanelsoyoucanchoose
theDesignerEclipseintowhichtoinstall.
IfoneormoreDesignerEclipsesalreadyexistonyourmachinebutnotinthecurrent
webMethodsinstallationdirectory,theinstallerdisplaysthispanelsoyoucanchoose
eithertoinstallintoanexistingDesignerEclipseandtoinstallanewDesignerEclipse
andthepluginsinthecurrentdirectory.
69
Configure My webMethods Server
Windows only
database connection between

My webMethods Server and
database component
70
Configure the Report Server
if you have multiple network

interfaces, identify the one to use;
default is default network interface
for local machine; do not use
localhost
see below
TheReportServerusesaContentStore.TheContentStoreisanexternalRDBMS
containingdatathattheReportServerneedstooperate,suchasglobalconfigurationdata
andreportdefinitions.YoumustspecifythedatabaseconnectionbetweentheReport
ServeranditsContentStoreortheReportServerwillnotstartafterinstallation.
ThedatabaseconnectionfieldsvaryslightlybyRDBMS.Iftheservice(Oracle)or
database(SQLServerorDB2)doesnotyetexist,specifytheserviceordatabaseyouwill
createafterinstallation.FormoreinformationontheContentStore,seeCompletethe
ReportServerInstallationonpage 128.
71
Configure ApplinX and EntireX

Shared Components
ApplinXandEntireXrequireandsharesomeorallthesecomponents:System
ManagementHub,TomcatKit,andJavaDevelopmentKit1.6.
UNIX only
IntheInstallation directoryfield,ifnosharedcomponentsexistonthemachine,specifya
directoryotherthanthewebMethodsinstallationdirectory.Theusernameunderwhich
youarerunningtheinstallermusthavefullreadandwritepermissionstothedirectory
youspecify.Ifsharedcomponentsfromthisreleaseorapreviousreleaseexistonthe
machine:
OnWindows,theinstallerdisablesthefield.Ifthesharedcomponentsarefroma
previousrelease,theinstallerupgradesthecomponents.
OnUNIX,specifythedirectorythatcontainstheexistingsharedcomponents.Ifthe
sharedcomponentsarefromapreviousrelease,theinstallerupgradesthem.
Note: Ifyoudonotwanttoupgradethecomponents,seetheSystemManagement
Hubdocumentationforinstructionsonhowtocreateanewsharedcomponents
installation.
72
ForUNIX,intheSuper user commandandPasswordfieldsonthepanel,typesuandthe

rootuserpasswordorsudoandthesudopasswordoftheuserunderwhichyouare
runningthewebMethodsInstaller.Thesuperusercommandandpasswordarerequired
toinstallallproductsdiscussedinthissectionexceptApplinX.However,theproduct
fileswillbeownedbytheuserunderwhichyouarerunningthewebMethodsInstaller.
Note: Theinstallervalidatessudopasswordsonly.Ifyouspecifyanythingotherthan
sudo,theinstallercannotvalidatethepasswordduetoaJavalimitation.
Sudo for EntireX

Thepanelshownbelowappearsundertheseconditions:
YouareinstallingEntireXonaUNIXsystem.
Eitherthesharedcomponentspaneldidnotdisplayorthesharedcomponentspanel
diddisplayandyouchosesuasthesuperuser.
YoucanchoosetoinstallEntireXusingsudobyselectingthecheckboxandprovidingthe
sudopasswordoftheuserunderwhichyouarerunningthewebMethodsInstaller.
Otherwise,youmustrunascriptwithsuperuserprivilegesafterinstallation,tosetthe
necessaryfilepermissionsandcreatedaemons.Theinstructionsforrunningthescript
areinPostInstallationChecklistonpage 120.
73
ApplinX
IfyouareinstallingtheApplinXServer,theinstallerdisplaysthepanelbelow.
full path to ApplinX license file

Windows only
see below
if multiple ApplinX Server

unique ports for each instance;
see Appendix A, Default Ports
for port information
IfapreviousversionofApplinXisinstalledonthelocalmachine,youcaneitherhavethe
webMethodsInstallermigratethedatafromthatinstallationtothenewinstallationnow,
oryoucanmigratethedataafterinstallation.Ifyouwanttheinstallertomigratethedata
now,selecttheMigrate data from existing ApplinX installationcheckboxandspecifythe
installationlocation.
TheinstallerinstallstheApplinXcomponentsinthewebMethodsinstallationdirectory.
74
EntireX
full path to EntireX license file

user name to use to connect to
System Management Hub
Important! IfyouareinstallingonaWindowssystemandyouwanttheEntireXadmin
usertobeauserfromtheActiveDirectory,youmustalsospecifythedomaininthe
EntireX admin user field.Forinstructionsonspecifyingthedomain,seetheEntireX
documentation.
TheinstallerinstallstheEntireXcomponentsinthewebMethodsinstallationdirectory.
75
Review and Install
Reviewthelistofproductsanditemsyouhaveselectedforinstall.Ifthelistisnotcorrect,
clickBackuntilyoureachthepanelonwhichyouchosetheproductstoinstallandcorrect
thechoices.Ifthelistiscorrect,clickNext.Theinstallerinstallstheproductsandrelated
items,thendisplaystheinstallationcompletepanel.ClickClose.
76
Using Console Mode to Install
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
78
Start the webMethods Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
78
Specify Release, User Name, and Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
82
Specify the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
83
Select Products to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
83
Select Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
84
Configure Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
85
Review and Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
91
77
7 Using Console Mode to Install
Overview
ThischapterexplainshowtodothefollowingonaUNIXorMacsystemusing
webMethodsInstallerconsolemode:
InstallwebMethodsproductsfromtheinstaller
CreateaninstallationscriptorimagefromwhichtoinstallwebMethodsproducts
InstallwebMethodsproductsfromaninstallationscriptorimage.
Start the webMethods Installer

Logonasanonrootuser.Theuserunderwhichyoulogonwillownallfilesyouinstall.
Important! IfyouaregoingtoinstallApplinXorEntireX,theusermusthavewrite
accesstothedirectoryfromwhichyoustarttheinstaller.Donotruntheinstallerasa
backgroundprocess.
below.
Note: YoumightreceiveJavamessageswhenyoustarttheinstaller.Forexample,you
mightreceivewarningmessagesaboutsystempreferences,oraboutunlocking
connections.Youcanignorethesemessages.
Formostuses,runthiscommand:
java -Xmx512m -Xincgc -jar webMethodsInstaller801.{jar|zip} -console
OnaSolarisx8664EM64Tsystem,oronaSolarisx8664AMDOpteronsystemwhen
youareusingJDK1.6toruntheinstaller,runthiscommand:
java -Xmx512m -Xincgc -Dsun.cpu.isalist=amd64
-jar webMethodsInstaller801.{jar|zip} -console
Tohavetheinstalleruseadifferenttemporarydirectorythanthedefault,runthis
command:
java -Xmx512m -Xincgc -Djava.io.tmpdir=different_temp_directory
-jar webMethodsInstaller801.{jar|zip} -console
78
Youcanrunthecommandwiththeoptionsdescribedbelowinanyorderbeforethe
-consoleoption:
For this option...
See...
Useaninstallationscript
Create,Installfrom,orEditanInstallationScript
onpage 79
Useaninstallationimage
CreateorInstallfromanInstallationImageon
page 80
Installusingaproxyserver
UseaProxyServertoInstallonpage 81
Changeinstallerlogging
behavior
ChangeLoggingLevelandFile,andAddTargets
onpage 82
Youcanretrieveproductsfromexistinginstallationimages,insteadofmoreslowly
downloadingtheproductsfromtheinstallerserver.Youcanusethisoptionwhen
installingorwhencreatinganimage.Forinstructions,seethe-existingImageoption
inCreateorInstallfromanInstallationImageonpage 80.
Youcanlistallavailablecommandlineoptionsbyrunningthiscommand:
java -Xmx512m -Xincgc -jar webMethodsInstaller801.{jar|zip} -help -console
Create, Install from, or Edit an Installation Script

Option
Variables
Create a script and install

-writeScript
script_file
Fullpathtothefileinwhichtosavethescript.
Create a script without installing

-editScript
script_file
Fullpathtothefileinwhichtosavethescript.
Create a script from an existing script without installing

-readScript
script_file
Fullpathtothefilethatcontainstheexistingscripttouse
asatemplate.
-writeScript
script_file
Fullpathtothefileinwhichtosavethenewscript.
Edit a script
-editScript
script_file
Fullpathtothefilethatcontainsthescripttoedit.
79
Option
Variables
Install from a script

-readScript
script_file
Fullpathtothefilethatcontainstheinstallationscriptfrom
whichtoinstall.
Important! Ifanyerrorsoccurwhileaninstallationscriptis
running,theinstallationfails.
Create or Install from an Installation Image

Option
Variables
Create an image
80
-writeImage
image_file
Fullpathtothefileinwhichtosavetheinstallationimage.
Theinstalleraddsthefileextension.zip.
-imagePlatform
system
Systemforwhichyouarecreatingtheimage.Youcan
createanimageforanysystemfromanysystem.Valid
valuesareaslistedbelow.Thedefaultisthesystemon
whichyouarerunningtheinstaller.
System
Value
Windowsx86
WNT
Windowsx8664(EM64T,AMD64)
W64
SolarisSPARC
SOL
Solarisx8664(EM64T,AMDOpteron)
SOLAMD64
HPUXPARISC
HP11
HPUXItanium2
HP11IT
IBMAIX
AIX
Linuxx86
LNX
Linuxx8664(EM64T,AMD64)
LNXAMD64
LinuxIBMzSeries
LNXS390X
MacOSX
OSX
Option
Variables
Install from an image

-readImage
image_file
Fullpathtothefilethatcontainstheinstallationimage
fromwhichtoinstall.
-existingImages
image_files
Existingimagesfromwhichtoretrieveproducts,insteadof
moreslowlydownloadingtheproductsfromtheinstaller
server.Youcanspecifyanyimage,regardlessofthe
operatingsystemtheimagewascreatedfor.
Youcanusethisoptionwheninstallingorwhencreating
animage.Whencreatinganimage,alsospecifythe
-writeImageand-imagePlatformoptions.
Note: IfalaterbuildofaproductexistsonthewebMethods
server,theinstallerdownloadsthatproductinsteadof
retrievingitfromthespecifiedsourceimages.
Youcanidentifythesourceimagesasfollows:
Specifyfullpathstosourceimages.Forexample:
-existingImages
C:\IS_HPUX.zip,C:\Designer_Solaris.zip
Specifyadirectoryforsourceimages.Forexample:
-existingImages C:\MyImages
Listsourceimagesinatextfile.Forexample:
C:\IS_HPUX.zip
C:\Designer_Solaris.zip
C:\MwS_Windows.zip
Thenspecifythefile.Forexample:
-existingImages C:\listofimages.txt
Use a Proxy Server to Install

IfyourcompanyconnectstotheInternetthroughanHTTPorSocksproxyserver,you
mustusethatproxyservertoinstall.Yournetworkadministratorcanprovide
informationonyourcompanysproxyservers.
Option
Variables
Use an HTTP proxy server to install

-proxyHost host
HostnameorfullyqualifiedIPaddressfortheproxyserver.
-proxyPort port
Portusedbytheproxyserver.
81
Option
Variables
-proxyUser user
Usernamefortheinstallertousetologontotheproxy
server.
-proxyPass password
Passwordforuser.
Use a Socks proxy server to install

-socksProxyHost
host
HostnameorfullyqualifiedIPaddressfortheproxyserver.
-socksProxyPort
port
Portusedbytheproxyserver.Thedefaultisthesystemon
whichyouarerunningtheinstaller.
Change Logging Level and File, and Add Targets

Bydefault,theinstallerwriteserrorsandwarningsthatoccurduringinstallationtoafile
namedWmInstallLog.txtinthewebMethods_directory/install/logsdirectory.Youcan
increaseordecreasetheamountofinformationthatiswritten,specifyadifferentfile
nameanddirectory,andchoosetowritetostandardoutandstandarderrorinadditionto
thelogfile.
Option
Variables
-debugLvl number
Amountofinformationtolog.Validvaluesareasfollows:
Amount of information to log
Value
None
0ornone
Errorsonly
5orerror
All(verbose);producesa
10to200MBfile
10orverbose
-debugFile
debug_file
Fullpathtothefiletocontainthelogginginformation.
-debugOut
Writeslogginginformationtostandardoutaswellastofile.
-debugErr
Writeslogginginformationtostandarderroraswellastofile.
-debug number
Shorthandwaytospecify -debugErr -debugLvl number.
Specify Release, User Name, and Password

ChoosetoinstallfromthewebMethods8.xrelease.
ProvideyourwebMethodsproductsuiteAdvantageusernameandpassword.The
installerusestheusernameandpasswordtoconnecttotheinstallerserverand
downloadthewebMethodsproductsforwhichyouhavepurchasedlicenses.
82
Specify the Installation Directory

Theusernameunderwhichyouarerunningtheinstallermusthavefullreadandwrite
permissionstotheinstallationdirectoryyouspecify.
ManagementHub,TomcatKit,andJavaDevelopmentKit1.6.Ifthoseshared
componentsexistonthelocalmachine,donotspecifythatdirectoryhere.
Ifyouareinstallingfromaninstallationimage,specifytheinstallationdirectoryfor
whichtheimagewasdesigned.Theinstallationdirectorymustcontainrequiredproducts
thatyoudidnotincludeintheimage.Forexample,iftheimagecontainsMonitor,the
installationdirectorymustcontainIntegrationServer.Formoreinformation,see
InstallationImagesonpage 48.
Important! DonotinstallproductsfromthewebMethods8.xreleaseintoadirectory
thatcontainsproductsfromanyotherrelease.
Select Products to Install

Theinstallerliststheproductsforwhichyouhavepurchasedlicensesandthatare
supportedonthetargetoperatingsystem.
Important! Theinstallerdoesnotdistinguishamongflavorsofanoperatingsystem.
Makesureyouinstallproductsonlyonsupportedoperatingsystems,asspecifiedin
thewebMethodsSystemRequirements.
Important! YoucannotinstallmultipleinstancesofSystemManagementHub8.xonthe
samemachine.
Thehighestleveloftheproductselectiontreeshowsproductnamesandreleases,while
thelowerlevelsshowtheitemsthatmakeuporarerelatedtotheproduct.Ifyouhave
alreadyinstalledaniteminthespecifiedinstallationdirectory,theitemnameisfollowed
byaletterI.
Theinstallercandisplayonlyalimitednumberoflinesinthetreeatatime.Topage
forwardthroughthetree,enteraplussign(+).Topagebackwardthroughthetree,enter
aminussign().Tosearchforaspecificproductoritem,enterS,thenenterthenameof
theproductoritem.EnterSagaintofindthenextoccurrenceoftheproductoritem.
Youcanchooseproductsusingthemethodsbelowinanycombination.Theinstallerputs
anXinthetreenexttoselectedproductsanditems.
ChoosetypicaldevelopmentinstallationsfromtheTypicalInstallationslistby
enteringtheappropriatenumbers.Theinstallerautomaticallyselectstheproducts
anditemsinthetreethatmakeupthoseinstallations.
83
Note: Youmightnotseetheselectionsuntilyoupageforwardthroughthetree.
Theproductsanditemsthatmakeupeachtypicalinstallationarelistedin
Chapter 1,DevelopmentEnvironments.
Chooseindividualproductsbyenteringthenumbersnexttotheproductheadings
(forexample,enterthenumberforIntegrationServer).Entereachnumberona
separateline.Ifachosenproductrequiresotherproductsanditemsonthesame
machine,theinstallerautomaticallyselectsthem.Forexample,TradingNetworks
ServerrequiresIntegrationServeronthesamemachine.IfyouselectTrading
NetworksServer,theinstallerselectsIntegrationServer.
Important! Forinstallationimages,theinstalleraskswhetheryouwantitto
automaticallyselectadditionalrequiredproducts.Forinformationonhowto
respond,seeInstallationImagesonpage 48.
Ifachosenproductrequiresotherproductsanditems,butnotonthesamemachine,
theinstallerdoesnotautomaticallyselectthem.Forexample,Optimizerequiresits
userinterfaces,butyoucaninstalltheuserinterfacesonadifferentmachine,sothe
installerdoesnotselectthem.
Chooseindividualitemsbyenteringthenumbersnexttothem(forexample,enterthe
numberforPKISupportunderIntegrationServer).Entereachnumberonaseparate
line.Ifachosenitemrequiresotherproductsanditemsonthesamemachine,the
installerautomaticallyselectsthem.
Whenyouaredone,pressENTERtwice.
Select Language Packs

Iflanguagepacksareavailableforproductsyouareinstallingorhavealreadyinstalled,
theinstallerpromptsyoutochooselanguagepackstoinstall.
webMethodsproductssupportmultiplelanguages;youcaninstallasmanylanguage
packsasyouwant,andallofthelanguagesinstalled(includingthedefault,U.S.English)
willbeavailabletousers.
84
Configure Products
Ifyouareinstallinganyoftheproductslistedbelow,theinstallerpromptsfor
configurationinformation.
ConfigureTradingNetworksServer
ConfigureOptimize
ConfigureIntegrationServer
ConfiguretheInfrastructureDataCollector
ConfigurewebMethodsBroker
ConfigureMywebMethodsServer
ConfiguretheReportServer
ConfigureApplinXandEntireX
Database Connection Information

Someproductsrequireyoutosupplydatabaseconnectioninformation.Ifthedatabase
userandpasswordyouwanttousedonotyetexist,specifythedatabaseuserand
passwordyouwillcreateafterinstallation.Youcanuseonedatabaseuserformultiple
webMethodsdatabasecomponents,oryoucanuseadifferentdatabaseuserforeach
databasecomponent.
webMethodsproductsusetheDataDirectConnectJDBC4.0driver;sampleURLformats
forthatdriverareshownbelow.Forinformationaboutoptionssupportedbythisdriver,
seeDataDirectConnectforJDBCUsersGuideandReference4.0inthewebMethods
installationdirectory/_documentationdirectoryoronthewebMethodsBookshelf.
RDBMS
Sample URL Format for DataDirect Connect JDBC 4.0 Driver
Oracle
jdbc:wm:oracle://server:{1521|port};serviceName=service
[;option=value]...
Oracleconfigured
forRAC
;AlternateServers=(server:{1521|port};)
;ConnectionRetry=value; ConnectionDelay=value
;LoadBalancing=value [;option=value]...
SQLServer
jdbc:wm:sqlserver://server:{1433|port}
;databaseName=database [;option=value]...
DB2forLinux,
UNIX,Windows*
jdbc:wm:db2://server:{50000|port};databaseName=database
[;option=value]...
85
RDBMS
Sample URL Format for DataDirect Connect JDBC 4.0 Driver
DB2foriSeries*
jdbc:wm:db2://server:{446|port};locationName=location
[;option=value]...
*Iftheproductwillconnecttoaschemaotherthanthedefaultschemaforthespecifieddatabaseuser,youmustspecify
theseconnectionoptionsintheURL:;AlternateId=schema;InitializationString=SETCURRENTPATH=schema
AlternateID isthenameofthedefaultschemathatisusedtoqualifyunqualifieddatabaseobjectsindynamically
preparedSQLstatements.
Configure Trading Networks Server

DefinethedatabaseconnectionforTradingNetworksServertousetoconnecttothe
TradingNetworksdatabasecomponent.Ifyoudonotdoso,TradingNetworkswillnot
startafterinstallation.
Configure Optimize
1
Ifyouhavemultiplenetworkinterfaces,identifytheonetousefortheOptimize
componentsyouareinstalling.Donotuselocalhost.
OptimizeoffersaCentralConfigurationuserinterfacethatallowsyoutoconfigure
Optimizecomponentsfromasinglemachine.Specifytheportyouwanttheinterface
tousetocommunicatewitheachOptimizecomponentyouareinstalling.Eachport
mustbeunique.Ifyouinstallmultipleinstancesofacomponentonthesame
machine,theportforeachinstancemustbeunique.
Configure Integration Server

1
SpecifythefullpathtoyourIntegrationServerlicensefile.
YoucanspecifytheporttouseforIntegrationServer.Ifyouinstallmultipleinstances
ofIntegrationServeronthesamemachine,specifyuniqueportsforeachinstance.
YoumustdecidewheretostoredatawrittenbyIntegrationServer(seeIntegration
ServerDataStorageonpage 22).
Note: IfyouselecttheexternalRDBMSbutdonotprovidetheconnection
information,IntegrationServerwillusetheembeddeddatabase.
Configure the Infrastructure Data Collector

1
YoucanprovidetheInfrastructureDataCollectorlicensekeynow,oryoucanprovide
itafteryoustartInfrastructureDataCollector.
YoucanspecifytheprimaryanddiagnosticsportstouseforInfrastructureData
Collector.
86
OptimizeprovidesaCentralConfigurationuserinterfacethatallowsyouto
configureOptimizecomponentsfromacentralmachine.Specifytheportyouwant
theinterfacetousetocommunicatewiththeOptimizeInfrastructureDataCollector.
Theportmustbeunique.IfyouinstallmultipleinstancesoftheInfrastructureData
Collectoronthesamemachine,theportforeachinstancemustbeunique.
Configure webMethods Broker

1
YoucanspecifytheporttouseforBrokerMonitor.IfyouinstallmultipleBroker
Monitorsonthismachine,specifyadifferentportforeach.
Bydefault,BrokerMonitorwillbindtoallIPaddressesonthelocalmachine.If
necessary,bindBrokerMonitortoaspecificIPaddressinstead.
IndicatewhetheryouwanttocreatetheBrokerServer.
YouwouldnotcreatetheBrokerServerconfigurationatthistime(thatis,using
theinstaller)ifyouwanttouseadifferentstoragesizethanisofferedonthepanel
orifyouwanttocreateacombinedstoragesessionforconfigurationandruntime
data.Ifyoudonotneedtobackupconfigurationdatawithoutshuttingdown
yourBrokerServer,usingacombinedsessionmightsaveyouasmallamountof
diskspace.IfyouchoosetonotcreatetheBrokerServerconfigurationatthistime,
youmustcreateitafterinstallationiscomplete,usinginstructionsinthe
webMethodsBrokerAdministratorsGuide.
YouwouldcreatetheBrokerServeratthistime(thatis,usingtheinstaller)ifyou
wanttouseastoragesizethatisofferedonthepanelandseparatestorage
sessionsforconfiguration(metadata)andruntimedata.Usingseparatestorage
sessionsminimizesthegreaterriskofcorruptionthatgoeswithacombined
storagelocation,andenablesyoutobackupconfigurationdatawithouthavingto
shutdownyourBrokerServer.(ForinformationaboutthewebMethodsBroker
onlineconfigurationdatabackuptool,seethewebMethodsBrokerAdministrators
Guide.)IfyouchoosetocreatetheBrokerServeratthistime,followthesteps
below.
Important! Software AGrecommendscreatingseparatesessions.Youcannot
laterchangefromacombinedsessiontoseparatesessionsorviceversa.
1
EnteryourwebMethodsBrokerlicensefile.
IdentifytheportonwhichtoruntheBrokerServer;BrokerServerusesthis
portfornonSSLandtheprevioustwoportsforSSL.Thedefault(nonSSL)
portis6849(and,forSSL,6848and6847).Ifyouinstallmultipleinstancesof
BrokerServeronthesamemachine,specifyuniqueportsforeachinstance.
ProvidethefullpathtothedatadirectoryinwhichtostoreBrokerServer
data.IfyouinstallmultipleinstancesofBrokerServeronthesamemachine,
specifyauniquedatadirectoryforeachinstance.
87
SelectapreconfiguredstoragesessionfortheBrokerServerthatisadequateforyour
expectedusageneeds.
Files Created
Broker Server
Startup Time
When to Use
Small Configuration
32MBlogfile512MB
storagefile
IdealforrunningdevelopmentBroker
Serversorrelativelyfewproduction
integrations,lowdocumentvolumes,
andnodocumentlogging
Fastestofall
configurations
Standarddeploymentsize,fitsmore
casesthanSmall;largermaximum
transactionsizeandtwicethestorage
capacityofSmall
Uptotwiceas
longasforSmall
Suitableforproductiondeployments
withmanyintegrationsrunningat
relativelyhighdocumentvolumes,
possiblyusingdocumentloggingas
well
Twotimeslonger
thanforMedium;
fourtimeslonger
thanforSmall
Medium Configuration
64MBlogfile
4GBstoragefile
Large Configuration
128MBlogfile
8GBstoragefile
*ForcompleteinformationonBrokerServerstoragesessions,seethewebMethodsBroker
AdministratorsGuide.
Whendeterminingtheappropriatesizeforthelogfile,thefactorstobalanceare
BrokerServerstartuptimeandthedesiredmaximumtransactionsize.Thesmaller
thelogfile,thefasterthestartup;however,withalargerlogfile,youcansendlarger
messages(thatis,onelargersizedsingledocumentorabatchofdocuments).If
necessary,youcanremoveorreplacelogfilesafterinstallation,andyoucanincrease
ordecreasetheirsize.
Startuptimedoesnotdependonthesizeofthestoragefile;additionalstorage
capacitymerelypreventstheBrokerServerfromrunningoutofroom.After
installation,iftheamountofstorageallocatedturnsouttobeinsufficient,youcan
addstoragefilesandincreasetheirsize.Youcannotremovestoragefilesordecrease
theirsize.
ThewebMethodsBrokerAdministratorsGuideprovidesinstructionsonworkingwith
logfilesandstoragefiles.
88
Configure My webMethods Server

1
YoucanspecifytheporttouseforMywebMethodsServer.
DefinethedatabaseconnectionforMywebMethodsServertousetoconnecttothe
MywebMethodsServerdatabasecomponent.Ifyoudonotdoso,MywebMethods
Serverwillnotstartafterinstallation.
Configure the Report Server

1
Ifyouhavemultiplenetworkinterfaces,identifytheonetousefortheReportServer.
Donotuselocalhost.
YoucanspecifytheporttousefortheReportServer.
ProvidethelocationofMywebMethodsServer.
TheReportServerusesaContentStore.TheContentStoreisanexternalRDBMS
containingdata,suchasglobalconfigurationdataandreportdefinitions,thatthe
ReportServerneedstooperate.Youmustspecifythedatabaseconnectionbetween
theReportServerandtheContentStoreortheReportServerwillnotstartafter
installation.
ThedatabaseconnectionfieldsvaryslightlybyRDBMS.Iftheservice(Oracle)or
database(SQLServerorDB2)forwhichyouareprompteddoesnotyetexist,specify
theserviceordatabaseyouwillcreateafterinstallation.Formoreinformationonthe
ContentStore,seeCompletetheReportServerInstallationonpage 128.
Configure ApplinX and EntireX

Thesuperusercommandandpasswordarerequiredtoinstallallproductsdiscussedin
thissectionexceptApplinX.However,theproductfileswillbeownedbytheuserunder
whichyouarerunningthewebMethodsInstaller.
Shared Components
ManagementHub,TomcatKit,andJavaDevelopmentKit1.6.
1
Ifnosharedcomponentsexistonthemachine,theinstallerpromptsforinformation
aboutwheretoinstallthesharedcomponents.Specifyadirectoryotherthanthe
webMethodsinstallationdirectory.Theusernameunderwhichyouarerunningthe
installermusthavefullreadandwritepermissionstothedirectoryyouspecify.
Ifsharedcomponentsfromthisreleaseorapreviousreleaseexistonthemachine,
specifythedirectorythatcontainstheexistingsharedcomponents.Iftheshared
componentsarefromapreviousrelease,theinstallerupgradesthem.
89
Note: Ifyoudonotwanttoupgradethecomponents,seetheSystemManagement
Hubdocumentationforinstructionsonhowtocreateanewsharedcomponents
installation.
2
Forthesuperusercommandandpassword,typesuandtherootuserpasswordor
sudoandthesudopasswordoftheuserunderwhichyouarerunningthe
webMethodsInstaller.
Note: Theinstallervalidatessudopasswordsonly.Ifyouspecifyanythingother
thansudo,theinstallercannotvalidatethepasswordduetoaJavalimitation.
Sudo for EntireX

Thepanelaboveappearsundertheseconditions:
YouareinstallingEntireX.
Eithertheinstallerdidnotpromptforsharedcomponentsinformationortheinstaller
didpromptforsharedcomponentsinformationandyouchosesuasthesuperuser.
YoucanchoosetoinstallEntireXusingsudobyprovidingthesudopasswordoftheuser
underwhichyouarerunningthewebMethodsInstaller.Otherwise,youmustruna
scriptwithsuperuserprivilegesafterinstallation,tosetthenecessaryfilepermissions
andcreatedaemons.TheinstructionsforrunningthescriptareinPostInstallation
Checklistonpage 120.
ApplinX
IfyouchosetoinstalltheApplinXServer,dothefollowing:
1
SpecifythefullpathtoyourApplinXlicensefile.
IfapreviousversionofApplinXisinstalledonthelocalmachine,youcanchooseto
havethewebMethodsInstallermigratethedatafromthatinstallationtothenew
installationnow.Otherwise,youwillhavetomigratethedataafterinstallation.
YoucanspecifytheportstouseforApplinXServer.Ifyouinstallmultipleinstances
ofApplinXServeronthesamemachine,specifyuniqueportsforeachinstance.For
informationaboutApplinXports,seeAppendix A,DefaultPorts.
TheinstallerinstallstheApplinXcomponentsinthewebMethodsinstallationdirectory.
EntireX
1
SpecifythefullpathtoyourEntireXlicensefile.
SpecifytheusernametousetoconnecttotheSystemManagementHub.
TheinstallerinstallstheEntireXcomponentsinthewebMethodsinstallationdirectory.
90
Review and Install

Reviewthelistofproductsyouhavechosentoinstall.Ifthelistiscorrect,pressENTER.
Theinstallerinstallstheproductsandrelateditems.
91
92
Creating and Dropping Database Components
Preparing for Database Component Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
94
Use the Database Component Configurator Graphical User Interface . . . . . . . . . . . . . . . . . . . .
100
Use the Database Component Configurator Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . .
106
Use the Database Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
116
93
8 Creating and Dropping Database Components
Preparing for Database Component Configuration

webMethods Products and Databases
webMethodsproductsuseJavaDatabaseConnectivity(JDBC)tointeractwithdatabases;
specifically,toqueryandupdatedatainwebMethodsdatabasecomponents.A
webMethodsdatabasecomponentisagroupingofdatabaseobjectsthatcanbeusedby
oneormorewebMethodsproducts.Forexample,IntegrationServerswriteprocessstatus
datatotheProcessAuditLogdatabasecomponent;MywebMethodsServerreadsthe
datafromtheProcessAuditLogdatabasecomponentandpassesittoMywebMethods
todisplay.
webMethodsproductsusetheDataDirectConnectJDBC4.0driver.AllwebMethods
productscomewiththeclientcomponentofthisdriver;itisaType4JDBCnative
protocoldriverthatdoesnothaveaservercomponent.Theproductsusethedriverto
convertJDBCrequestsfromJavaprogramsdirectlyintothevendorspecificdatabase
protocolthateachtypeofRDBMScanunderstand.webMethodsproductsexecuteDDL
commandsatinstalltimeandsometimesdesigntimeforeachRDBMSwithwhichthey
interact.Forinformationaboutthedriver,seeDataDirectConnectforJDBCUsersGuide
andReference4.0inthewebMethodsinstallationdirectory/_documentationdirectoryor
onthewebMethodsBookshelf.
ToenablewebMethodsproductstointeractwithadatabasecomponent,youprovide
databaseconnectionparameters,usuallyduringproductinstallation,andthe
webMethodsInstallerusestheparameterstoconfigureJDBCconnectionpools.After
productinstallationanddatabasecomponentcreationiscomplete,yousetupthe
productstousetheappropriateconnectionpools.Forsomeproducts,suchasOptimize,
youconfiguretheJDBCconnectionpoolsafterproductinstallation.Tasksyouperform
afterproductinstallationarecoveredinChapter 9,CompletingtheInstallation.
ForthelistofRDBMSssupportedbythewebMethodsproductsuite,seethewebMethods
SystemRequirements.
Note: IfyouwantwebMethodsproductstoexchangedatawithnonwebMethods
databases,youcanusethewebMethodsJDBCAdapter.Formoreinformation,seethe
webMethodsJDBCAdapterdocumentation.
Database Users and Storage

YoucancreateonedatabaseuserformultiplewebMethodsdatabasecomponents,oryou
cancreateadifferentdatabaseuserforeachdatabasecomponent.Youcancreateall
databasecomponentobjectsinthesamestorageoryoucancreatetheobjectsforeach
databasecomponentinitsownstorage.Thefollowingchaptersprovideinstructionsfor
creatingdatabaseusersandstorage.
94
Database Administrator Account

YouneedDBAaccessonlyifyouwanttousethewebMethodsDatabaseComponent
Configuratortocreatethenecessarydatabaseusersandstorageobjects.
webMethodsproductsaredesignedtousethedatabaseusersyoucreateforthedatabase
components.
Character Set and Sort Order

webMethodsproductsareglobalizedandsupportUnicode.Software AGstrongly
recommendschoosingaUnicodeencodingforyourdatabaseandthemostappropriate
sortorderforyourenvironment.Adatabasecharactersetdetermineswhichlanguagesa
databasecanrepresent.Databasesortorderdeterminescollationandcomparison
behavior.
ThesectionsbelowlistthemostappropriateUnicodecharacterencodingandsortorder
foreachRDBMSthatthewebMethodsproductsuitesupports.Ifyouwanttousea
differentcharactersetorsortorderthanrecommendedbelow,consultyourdatabase
administratorandyourRDBMSvendorsdocumentationsoyoucancarefullychoosea
databasecharactersetthatsupportsthelanguagesyourdataisin.
IfyouusethewebMethodsDatabaseComponentConfiguratortocreateyourdatabase
components,youcancheckwhethertheselectedRDBMSisconfiguredfortheUnicode
characterset.IftheRDBMSdoesnotsupportUnicode,theconfiguratorliststhecharacter
settheRDBMSdoessupport.
Important! YoumustsetcharactersetandsortorderbeforecreatingwebMethods
storage.
Oracle
webMethodsdatabaseschemasforOracleusecharacterdatatypes.Forcharacterdata
types,OraclesupportstheUTF8andAL32UTF8Unicodeencodings.WhileUTF8is
CESU8compliantandsupportstheUnicode3.0UTF8Universalcharacterset,
AL32UTF8conformstotheUnicode3.1orhigherUTF8Universalcharacterset.For
nchardatatypes,OraclesupportstheAL32UTF8andAL16UTF16Unicodeencodings.
ThesupportedUnicodeversionforAL32UTF8dependsontheOracledatabaseversion.
webMethodsOracledatabaseschemasdonothavelinguisticindexes.Software AG
recommendsthesecharactersetsandsortorder:
For...
Software AG recommends...
Characterset
AL32UTF8
Ncharcharacterset
AL16UTF16
Sortorder
Binary
Youcancheckdatabaseconfigurationandsessionsettingsbyviewingthe
SYS.NLS_DATABASE_PARAMETERSorV$NLS_PARAMETERSparameter.
95
SQL Server
webMethodsdatabaseschemasforSQLServerusenchardatatypes.SQLServer
providessupportforUTF16throughitsnchardatatypes.Sincenchardatatypesare
alwaysinUTF16,youdonothavetoperformanyspecialdatabaseconfigurationandcan
choosethemostappropriatecodepageforyourenvironmentasadatabasecharacterset.
Software AGrecommendsthesecharactersetsandsortorder:
For...
Characterset
Theappropriateencodingforthelanguagesyourdataisin.
Ncharcharacterset
UTF16
Sortorder
Anycaseinsensitivecollationtype.
Important! Ifyoudonotchooseacaseinsensitivesortorder,
youwillnotbeabletocreatesomedatabasecomponentsin
SQLServer.
Youcancheckthedatabaseconfigurationusingthesp_helpdbdatabasestoredprocedure.
DB2
webMethodsdatabaseschemasforDB2usecharacterdatatypes.DB2supportsUTF8for
characterdatatypesandUTF16forgraphicdatatypes.Software AGrecommendsthese
charactersetsandsortorder:
For...
Characterset
CCSID1208(UTF8)
Note: MywebMethodsServerrequiresthischaracterset.
GraphicCharacterSet
UTF16
Sortorder
IDENTITY_16BIT
Note: Thissortorderensuresthesamesortingresultforboth
characterandgraphicdatatypes.Thisoptionisonly
availableforDB2forLinux,Unix,Windows(LUW).ForDB2
foriSeries,sortorderisalwaysbinaryorderwhenthe
databasecharactersetisUTF8.
Youcancheckthedatabaseconfigurationbyusingthefollowing:
RDBMS
Use...
DB2forLUW
GETDATABASECONFIGURATIONcommand
DB2foriSeries
DSPFDcommandtocheckthedatabasefiledescription
96
Page and Block Size

UsethepageandblocksizesspecifiedbelowforeachtypeofRDBMS.
RDBMS
Required Page and Block Size
Default
Oracle
8kpage/blocksize
8k
SQLServer
8kpage/blocksize
8k
DB2
32kpagesize
4k
Set Database Options

Oracle
ForwebMethodsproductstofunctionproperly,youmustsetthe
NLS_LENGTH_SEMANTICSinitializationparametertoBYTE.
Important! webMethodsusesBYTEratherthanCHARsemanticsbecauseBYTEisthe
defaultconfigurationofOracledatabaseandisusedbymostOracleusers.Ifyoutry
tousewebMethodsproductswithCHARsemantics,unexpectedresultsmightoccur.
Forexample,sinceCHARsemanticsallowstorageoflongerdatathanBYTE
semantics(forJapanese,varchar(12byte)takesfourcharactersinUTF8while
varchar(12char)takes12),usingCHARsemanticscouldcausethebufferinsome
productstooverflow.
SQL Server
ThefollowingdatabasesettingsarerequiredforwebMethodsproductstofunction
properly:
ALTER DATABASE database_name SET ALLOW_SNAPSHOT_ISOLATION ON;
ALTER DATABASE database_name SET READ_COMMITTED_SNAPSHOT ON;
Inaddition,enableNamedPipesandTCP/IPprotocolsusingtheSQLServer
ConfigurationManager.
Bydefault,SQLServerusescaseinsensitivecollations.IfyoucreatetheMywebMethods
Serverdatabasecomponent,donotchangethisoptionfromthedefault;MywebMethods
Serverdoesnotsupportcasesensitivecollations.
97
Default Storage Convention

Bydefault,allwebMethodsdatabasecomponentsfollowthisstorageconvention:
RDBMS
Data Storage Unit
Index Storage Unit
BLOB Storage Unit
Oracletablespaces
WEBMDATA
WEBMINDX
WEBMDATA
SQLServerfilegroups
Primary
Primary
Primary
DB2forLUWtablespaces
WEBMDATA
WEBMINDX
WEBMBLOB
DB2foriSeries
Default
Default
Default
Youcanuseadifferentstorageconventionwhenyoucreatedatabasecomponents.For
instructions,seeChapter 8,CreatingandDroppingDatabaseComponents.
Download the Database Component Configurator or Database Scripts

TheDatabaseComponentConfiguratoranddatabasescriptsareavailablethroughthe
webMethodsInstaller.Forcompleteinstructionsonusingtheinstaller,seeprevious
chaptersinthisguide.
1
DownloadthewebMethodsInstallerfromthewebMethodsAdvantageWebsiteto
theappropriatemachine,asfollows:
If you are going to create database
components...
Download the webMethods Installer to...
Automatically,usingtheDatabase
ComponentConfigurator
Anymachineonthesamenetworkasyour
databaseserver
Manually,usingdatabasescripts
Amachineequippedwiththedatabaseclient
foryourtypeofRDBMS
StartthewebMethodsInstaller.
Intheproductselectionlist,selectDatabase Configuration > Database ScriptsorDatabase

Component Configurator,asappropriate.
98
Change Environment Settings

TheDatabaseComponentConfiguratorhasthedefaultenvironmentsettingsshown
below.Ifnecessary,youcanchangethemasdescribedbelow.
1
GotothewebMethods_directory\common\db\bindirectory.
OpenthesetEnv.{bat|sh}fileinthetexteditorandeditthefieldsasnecessary.
Setting
Determines whether the Database Component

Configurator...
Default
DtermOutOn
Writesexecutioninformationtothe
console.
true
DspoolOn
Logsexecutioninformation.
true
DlogLevel
SetsthelogleveltoINFO(highlevel
information)orDEBUG(moredetailed
information,includinginternal
processingandSQLcalls).
INFO
Dlog.dir
Thissettingspecifiesthefullpathtothe
directoryinwhichtostorethelogfiles.
Makesureyouhavepermissiontowrite
tothisdirectory.
webMethods_directory\
common\db\logs
Saveandclosethefile.
99
Use the Database Component Configurator Graphical User

Interface
ThissectionexplainshowtousetheDatabaseComponentConfiguratorgraphicaluser
interfacetocreateordropadatabaseuserandstorage,andtocreateordropwebMethods
databasecomponents.Eachrunoftheconfiguratoroperatesonasingleschema.
TheconfiguratorwritesexecutioninformationtotheResultstabandtoalogfilenamed
dcc_yyyymmddHHMMssinthewebMethods_directory\common\db\logsdirectory.
Create Database Components and Create a Database User and

Storage
YoucanusetheconfiguratortocreateadatabaseuserandstorageinOracle,SQLServer,
andDB2forLUW.ForDB2foriSeries,youmustcreatethedatabaseuserandstorage
usingscripts(seeUsetheDatabaseScriptsonpage 116).
Important! WhenyoucreatedatabasecomponentsinDB2usingtheDatabase
ComponentConfigurator,theconfiguratorcreatestheschemanameinalluppercase
letters.SinceDB2iscasesensitiveforschemanames,youmustusealluppercase
lettersfortheschemanameswhenyoutypetheminURLsforJDBCconnectionpools,
oryouwillexperienceproblems.
100
OntheStartmenu,gotoPrograms > Software AGwebMethods > Tools > Database

Component Configurator 8.0.
Initially,someofthefieldsontheInputstabshowvaluesyouenteredforthesame
fieldsinthewebMethodsInstallerduringproductinstallation.Youcanchangethese
valuesandspecifyotherfieldvalues.
2
IntheAction Typelist,clicktheactiontoperform,asfollows:
Option
Action
create
CreatesthedatabasecomponentsyouselectintheDatabase
componentlist,andletsyoucreateadatabaseuserandstorage.
recreate
Dropsandthenrecreatesthedatabasecomponentsyouselectin
theDatabase componentlist.
catalog
DisplaysexistingdatabasecomponentsontheResultstab.
checkEncoding
CheckswhetheryourRDBMSisUnicodeenabledanddisplays
theanswerontheResultstab.
101
SpecifytheconnectionfortheconfiguratortousetoconnecttotheRDBMS.
a
IntheRDBMSlist,clicktheRDBMSinwhichtocreatethedatabasecomponents.
IntheURLfield,providetheURLfortheRDBMS.(SampleURLformatsforthe
DataDirectConnectJDBC4.0driveraredisplayed.)Belowisadditional
informationforcompletingthisfield.
ForOracle,ifyouaregoingtocreatestorageandtheDataPurgedatabase
component,youmustspecifythesysLoginRoleconnectionoptionontheURL
(forexample,;sysLoginRole=sysdba).
ForDB2,ifyouaregoingtocreatedatabasecomponentsinaschemaother
thanthedefaultschemaforthespecifieddatabaseuser,youmustspecify
theseconnectionoptionsintheURL,whereAlternateID isthenameofthe
defaultschemausedtoqualifyunqualifieddatabaseobjectsindynamically
preparedSQLstatements:
;AlternateId=schema;InitializationString="SET CURRENT PATH=schema"
102
ForinformationaboutoptionssupportedbytheDataDirectConnectJDBC4.0
driverusedbywebMethodsproducts,seeDataDirectConnectforJDBCUsers
GuideandReference4.0inthewebMethodsinstallation
directory/_documentationdirectoryorat
http://documentation.softwareag.com/webmethods.
IntheUser IDandPasswordfields,yourentriesdependonthetaskyouaregoingto
perform,asfollows:
If you are...
Specify...
Creatingadatabaseuser
andstorageinOracleor
SQLServer
Thedatabaseuserandpasswordtocreate.
Important! ForOracle,donotusetheSYSTEMuser
tocreatethedatabasecomponentsinthe
SYSTEMschema.
Creatingadatabaseuser
andstorageinDB2for
LUW
TheOSusertowhichtograntpermissions,and
thepasswordforthatuser.
Creatingdatabase
componentsorperforming
thecatalogaction
Anexistingdatabaseuserandpassword.
Performingthe
checkEncodingaction
Anexistingdatabaseuserthathascreatesession
andcreatetableprivileges,andthatdatabase
userspassword.
IfyouselectedcreateintheAction Typelist,dothefollowing:
a
intheDatabase Componentlist,selectonedatabasecomponenttocreate,chooseto
createalldatabasecomponents,orselectaproductwhosedatabasecomponents
tocreate.Theproductoptionsmaptothedatabasecomponentslistedbelow,and
toanyrequiredsupportingdatabasecomponentlistedinInfrastructure
DatabaseComponentsonpage 30.
This product option...
Maps to these database components...
IntegrationServer
ISCoreAuditLog,ISInternal,ProcessAudit
Log,ProcessEngine,DocumentHistory,Cross
Reference,Staging,Reporting,Blaze,andBPEL
MywebMethodsServer
MywebMethodsServer
Optimize
Analysis,ProcessTracker,andProcessAuditLog
TradingNetworks
TradingNetworks,TradingNetworksArchive
SelectfromtheVersionlistasfollows:
If you selected...
Click this in the Version list...
Adatabasecomponent
Thecorrectversionforyourproduct(see
Chapter 1,DevelopmentEnvironments).
ALL
Latest.Theconfiguratorwillcreatethelatest
versionofallthewebMethodsdatabase
components.
Aproduct
8.0.
Ifyouwanttocreateadatabaseuserandstorage,followthesesteps:
1
SelecttheCreate Tablespaces checkbox.

Note: ThischeckboxislabeledCreate Database and Database UserforSQL
Server,andCreate Tablespaces and Grant Permissions to OS UserforDB2.
IntheAdmin ID field,identifythedatabaseuseroroperatingsystemuserthat
hasdatabaseadministratorcredentialstocreatethedatabaseuserandstorage.
SupplythepasswordfortheuserintheAdmin Passwordfield.
ThenextfieldandyourentrydependonyourRDBMS.
RDBMS
Field and Entry
Oracleor
DB2forLUW
IntheTablespace Directoryfield,identifythedirectoryin
whichtocreatethetablespaces.ForOracle,usethisfield
onlyiftheDB_CREATE_FILE_DESTparameterisnotset
foryourOracleinstance.
SQLServer
IntheDatabasefield,specifythedatabasetocreate.
103
ForOracleorDB2forLUW,youcanselecttheUse Custom Tablespace Namescheck

boxandspecifycustomtablespacenamesinthefields.
ForOracle,thecustomtablespacenameswillreplacethedefaults
WEBMDATAandWEBMINDX.
ForDB2forLUW,thecustomtablespacenameswillreplacethedefaults
WEBMDATA,WEBMINDX,andWEBMBLOB.Youcanalsospecifyacustom
nametouseforthewebMethodsbufferpool(WEBMBUFFbydefault).
Note: ThewebMethodsproductsuitesupportsalltablespaceconfigurations
deployedbycustomers.
Ifyouintendtoruntheconfiguratormorethanonce,youcansetthecurrentfield
valuesasthedefaultsforsubsequentrunsbyclickingSave Settings as Default.Youcan
alsoexportfieldvaluesto.xmlfilesbyclickingExport,thenlaterimportthevalues
fromafilebyclickingImport Configuration.Ineachcase,thevaluesforthetwoPassword
fieldsarenotsaved.
ClickExecute.TheexecutioninformationisdisplayedontheResultstabandiswritten
tothelogfiledcc_yyyymmddHHMMssinthewebMethods_directory\common\db\logs
directory.
Drop Database Components

1
ShutdownallwebMethodsproductsthatareconnectedtothedatabasecomponents
youwanttodrop,andbackupthedatabasecomponents.

IntheActionlist,clicktheactiontoperform,asfollows:
104
Value
Action
drop
DropsthedatabasecomponentsyouselectintheDatabase component
list.
catalog
ListsexistingdatabasecomponentsontheResultstab.
IntheConnectionarea,specifytheconnectionfortheconfiguratortousetoconnectto
theRDBMS,asfollows:
Field
Do this...
RDBMS
ClicktheRDBMSfromwhichtodropthedatabasecomponents.
URL
TypetheURLfortheRDBMS.(SampleURLformatsforthe
DataDirectConnectJDBC4.0driveraredisplayed.)
User IDand
Password
Specifythedatabaseuserandpasswordtousetoconnecttothe
RDBMS.
IntheDatabase Componentlist,selectonedatabasecomponenttodrop,choosetodrop
alldatabasecomponents,orselectaproductwhosedatabasecomponentstodrop.
SelectfromtheVersionlistasfollows:
If you selected...
Click this in the Version list...
Adatabasecomponent
Theproperversionforyourproduct(seeChapter 1,
DevelopmentEnvironments).
ALL
Latest.
Aproduct
8.0.
directory.
Drop the Storage and Revoke Database User Permissions

Ifyouhavedroppedalldatabasecomponentsinaschema,youcandropthestorageand
revokethedatabaseuserpermissions.
YoucanusetheDatabaseComponentConfiguratortodropthestorageforOracle,SQL
Server,andDB2forLUW.ForDB2foriSeries,youmustdropthedatabaseuserand
storageusingascript(seeUsetheDatabaseScriptsonpage 116).
1

IntheActionlist,clickdrop.
IntheDatabase componentlist,clickALL.
IntheConnectionarea,specifytheconnectionfortheconfiguratortousetoconnectto
theRDBMS,asfollows:
Field
Do this...
RDBMS
ClicktheRDBMSfromwhichtodropthedatabasecomponents.
URL
TypetheURLfortheRDBMS.(SampleURLformatsforthe
DataDirectConnectJDBC4.0driveraredisplayed.)
User IDand
Password
Specifythedatabaseuserandpasswordtousetoconnecttothe
RDBMS.
105
SelecttheDrop tablespaces and database usercheckbox.

a
IntheAdmin ID field,identifythedatabaseuseroroperatingsystemuserthathas
databaseadministratorcredentialstodropthedatabaseuserandstorage.Supply
thepasswordforthedatabaseuserintheAdmin passwordfield.
ThenextfielddependsonyourRDBMS.
RDBMS
Fields and Entries
DB2forLUW
andOracle
IntheTablespace directoryfield,identifythedirectorythat
containsthetablespacestodrop.Ifyouspecifiedcustom
tablespacenames,supplythosenamesintheTablespacesarea.
SQLServer
IntheDatabasefield,specifythedatabasethatcontainsthe
storage.
directory.
Use the Database Component ConfiguratorCommand Line

ThissectionexplainshowtouseDatabaseComponentConfiguratorcommandlinemode
tocreateordropadatabaseuserandstorage,andtocreateordropwebMethods
databasecomponents.Eachrunoftheconfiguratoroperatesonasingleschema.
CommandlinemodeletsyoucreateadatabaseuserandstorageinOracle,SQLServer,
andDB2forLUW.ForDB2foriSeries,youmustcreatethedatabaseuserandstorage
usingscripts(seeUsetheDatabaseScriptsonpage 116).
Important! WhenyoucreatedatabasecomponentsinDB2usingtheDatabase
ComponentConfigurator,theconfiguratorcreatestheschemanameinalluppercase
letters.SinceDB2iscasesensitiveforschemanames,youmustusealluppercase
lettersfortheschemanameswhenyoutypetheminURLsforJDBCconnectionpools,
oryouwillexperienceproblems.
Beforedroppinganydatabasecomponent,shutdownallwebMethodsproductsthatare
connectedtothedatabasecomponent.
Ifyouhavedroppedallthedatabasecomponentsfromaschema,youcandropthe
storageandrevokethedatabaseuserpermissions.Youcanusethecommandlinetodrop
storageforOracle,SQLServer,andDB2forLUW.ForDB2foriSeries,youmustdrop
storageusingscripts(seeUsetheDatabaseScriptsonpage 116).
106
Database Component Configurator Command

Youcanperformanactionononedatabasecomponentoronalldatabasecomponents,or
onthedatabasecomponentsforonewebMethodsproduct,usingthecommandbelow.
YourunthecommandfromthewebMethods_directory\common\db\bindirectory.
dbConfigurator.{bat|sh} {-a|--action} action
{-d|--dbms} {oracle|sqlserver|db2luw|db2i}
{{-c|--component} db_component {-v|--version} version|
{-pr|--product} product {-v|--version} release}
{-l|--url} RDBMS_URL
{-u|--user} db_user {-p|--password} password
[{-au|--admin_user} db_admin_user {-ap|--admin_password} password]
Additional Parameters:
[-r|--runCatalog]
[{-tsdata|--tablespacefordata} data_tspace_name]
[{-tsindex|--tablespaceforindex} index_tspace_name]
[{-tsblob|--tablespaceforblob} BLOB_tspace_name]
[{-b|--bufferpool} buffer_pool_name]
[-t|--tablespacedir]
[-n|--dbname]
[-h|--help]
[-ab|--about]
[-pa|--printActions] [-pd|--printDatabase] [-pc|--printComponents]
[-pp|--printProducts] [-pe]
[{-e|--export|-i|--import} {-dir|--configdir} directory
{-file|--configfile} file]
Parameter
Entry
{-a|--action} action
Actiontoperform.
Value
Action
catalog
Displaysexistingdatabasecomponents.
create
Createsdb_componentorthedatabase
componentsforproduct.
drop
Dropsdb_componentorthedatabase
componentsforproduct.
recreate
Dropsdb_componentorthedatabase
componentsforproduct,thencreates
db_componentorthedatabasecomponents
forproduct.
checkEncoding
CheckswhetheryourRDBMSisUnicode
enabledanddisplaystheanswer.
107
Parameter
Entry
{-d|--dbms} {oracle|
sqlserver|db2luw|db2i}
RDBMSonwhichtoperformaction.
{-c|--component}
db_component
{-v|--version} version
108
Value
DBMS
oracle
Oracle
sqlserver
SQLServer
db2luw
DB2forLUW
db2i
DB2foriSeries
Databasecomponentversionforwhichtoperformaction.
Fordb_component,youcanspecifythedatabasecomponent
codeorname.
Code
Name
ALL
ANL
ARC
BLZ
BPL
CCS
CTR
XRF
DTP
DBM
DSL
IDR
ISC
ISI
MWS
OPM
PRA
PRE
PTR
PRP
PST
STR
SRP
SRC
TNS
TNA
All database components

Analysis
Archive
Blaze
BPEL
CentralConfiguration
ComponentTracker
CrossReference
DataPurge
DatabaseManagement
DistributedLocking
DocumentHistory
ISCoreAudit
ISInternal
MywebMethodsServer
OperationManagement
ProcessAudit
ProcessEngine
ProcessTracker
Reporting
Staging
Storage
SuiteReporting
SuiteReporting-Common
TradingNetworks
TradingNetworksArchive
Parameter
Entry
Forversion,youcanspecifythesevalues.
Value
Description
latest
Ifyouspecifiedonedatabasecomponent
fordb_component,performactionforthe
latestversionofdb_component.
IfyouspecifiedALLfordb_component,you
mustspecifylatestfor
db_component_version.Theconfiguratorwill
createthelatestversionofeachdatabase
component.
version
{-pr|--product} product
{-v|--version} release
Ifyouareperformingaction onadatabase
componentotherthanStorage,specifythe
versionofthedatabasecomponent(see
Chapter 1,DevelopmentEnvironments).
Productreleaseforwhosedatabasecomponentstoperform
action.
Forproduct,youcanspecifytheproductcodeorname.Each
productmapstothedatabasecomponentslistedbelow,andto
anyrequiredsupportingdatabasecomponentlistedin
InfrastructureDatabaseComponentsonpage 30.
Code or Product
Maps to These Database Components
ISor
Integration
Server
ISCoreAuditLog,ISInternal,Process
AuditLog,ProcessEngine,Document
History,CrossReference,Staging,
Reporting,Blaze,andBPEL
MWS orMy
webMethods
Server
MywebMethodsServer
OPTI or
Optimize
Analysis,ProcessTracker,andProcess
AuditLog
TN or Trading
Networks
TradingNetworks
109
Parameter
Entry
Forrelease,youcanspecifythevaluesbelow.
{-l|--url} RDBMS_URL
Value
Description
latest
Performactiononthedatabasecomponents
forthelatestreleaseofproduct.
release
Releaseoftheproductforwhosedatabase
componentstoperformaction.The
configuratorwillcreatethecorrectversions
ofthedatabasecomponentsforthe
specifiedrelease.
URLfortheRDBMS.Forinformationaboutoptions
supportedbytheDataDirectConnectJDBC4.0driverused
bywebMethodsproducts,seeDataDirectConnectforJDBC
UsersGuideandReference4.0inthewebMethodsinstallation
directory/_documentationdirectoryoronthewebMethods
Bookshelf.
Important! Whenworkingwithdatabasecomponentson
UNIXsystems,youmustenclosetheURLindoublequotes.
RDBMS
Sample Format for DataDirect Connect Driver
Oracle
jdbc:wm:oracle://server:{1521|port}
;serviceName=service [;option=value]...
Important! Ifaregoingtocreatestorageand
theDataPurgedatabasecomponent,you
mustspecifythesysLoginRoleconnection
optionontheURL(forexample,
;sysLoginRole=sysdba).
110
SQLServer
jdbc:wm:sqlserver://server:{1433|port}
DB2forLinux,
UNIX,
Windows
jdbc:wm:db2://server:{50000|port}
DB2foriSeries
jdbc:wm:db2://server:{446|port}
;locationName=location [;option=value]...
Parameter
Entry
Important! ForDB2,ifyouaregoingtocreatedatabase
componentsinaschemaotherthanthedefaultschemafor
thespecifieddatabaseuser,youmustspecifythese
connectionoptionsintheURL:
;AlternateId=schema;InitializationString="SET CURRENT
PATH=schema"
AlternateID isthenameofthedefaultschemausedto
qualifyunqualifieddatabaseobjectsindynamicallyprepared
SQLstatements.
{-u|--user} db_user
{-p|--password}
password
Yourentryheredependsontheactionyouareperforming.
If you are...
Specify...
Creatinga
databaseuser
andstoragein
OracleorSQL
Server
Thedatabaseuserandpasswordtocreate.
Creatinga
databaseuser
andstoragein
DB2forLUW
Important! ForOracle,donotusethe
SYSTEMusertocreatethedatabase
componentsintheSYSTEMschema.
TheOSusertowhichtograntpermissions.
Performingthe Anexistingdatabaseuserthathascreate
checkEncoding sessionandcreatetableprivileges,andthat
action
databaseuserspassword.
Performing
anyother
action
[{-au|--admin_user}
db_admin_user
{-ap|--admin_password}
password]
Anexistingdatabaseuserandpassword.
Ifyouaregoingtocreateadatabaseuserandstorage,ordrop
storageandrevokethedatabaseuserpermissions,specifythe
databaseuseroroperatingsystemuserandpasswordthat
hasthenecessarydatabaseadministratorcredentials.
111
Parameter
Entry
Additional Parameters
[-r|--runCatalog]
Runsthecatalogactionattheendofeveryexecution.
[{-tsdata|
--tablespacefordata}
data_tspace_name]
[{-tsindex|
--tablespaceforindex}
index_tspace_name]
[{-tsblob|
--tablespaceforblob}
BLOB_tspace_name]
[{-b|--bufferpool}
buffer_pool_name]
IfyouaregoingtocreatedatabasecomponentsinOracleand
DB2forLUW,youcanspecifycustomtablespacenames.
ForOracle,thecustomtablespacenameswillreplacethe
defaultsWEBMDATAandWEBMINDX.
ForDB2forLUW,thecustomtablespacenameswill
replacethedefaultsWEBMDATA,WEBMINDX,and
WEBMBLOB.Youcanalsospecifyacustomnametouse
forthewebMethodsbufferpool(WEBMBUFFby
default).
Note: ThewebMethodsproductsuitesupportsalltablespace
configurationsdeployedbycustomers.
Ifyouaregoingtodropstorageandrevokethedatabaseuser
permissionsforOracleorDB2forLUW,andyouspecified
customtablespacenames,providethosenames.
[-t|--tablespacedir]
Ifyouaregoingtocreateadatabaseuserandstorage,and
wanttocreateatablespacedirectoryforDB2forLUWor
Oracle,providethefullpathtothedirectory.ForOracle,use
thisparameteronlyiftheDB_CREATE_FILE_DEST
parameterisnotsetforyourOracleinstance.
permissionsorDB2forLUWorOracle,identifythedirectory
thatcontainsthetablespacestodrop.
[-n|--dbname]
IfyouaregoingtocreateadatabaseuserandstorageinSQL
Server,nameofthetargetdatabase.
permissionsinSQLServer,identifythedatabasethat
containsthestorage.
[-h|--help]
Printscommandlinehelp.
[-ab|--about]
PrintsinformationabouttheDatabaseComponent
Configurator.
[-pa|--printActions]
Liststheactionsyoucanperform,likecreateordrop.
[-pd|--printDatabase]
PrintsRDBMStheconfiguratorsupports.
[-pc|--printComponents]
Printsdatabasecomponentstheconfiguratorsupports.
[-pp|--printProducts]
PrintswebMethodsproductstheconfiguratorsupports.
[-pe]
Printscommandlineexamples.
112
Parameter
Entry
{-e|--export}
{-dir|--configdir}
directory
{-file|--configfile}
file
Exportsvaluesforallrequiredparametersexceptthe
passwordparameterstoan.xmlfile.
{-i|--import}
{-dir|--configdir}
directory
{-file|--configfile}
file
Importsvaluesforallparametersfroman.xmlfile.
Note: Passwordparametersarenotsaved,soyoumustspecify
themonthecommand.
Examples
Important! OnUNIXsystems,youmustenclosetheRDBMSURLinyourcommandsin
doublequotes.
Create a Database User and Storage

ThiscommandcreatesthedatabaseuserandthetwowebMethodstablespaceswiththe
defaultnamesforOracle:
dbConfigurator.bat -a create -d oracle -c storage -v latest
-l jdbc:wm:oracle://DBserver:1521;serviceName=myservicename
-au adminuser -ap adminpass -u webmuser -p w3bmpass -t tablespace_dir
ThiscommandcreatesthedatabaseuserandthetwowebMethodstablespaceswith
customnamesforOracle:
dbConfigurator.bat -a create -d oracle -c storage -v latest
-tsdata MYDATA -tsindex MYINDEX
ThiscommandcreatesthewebMethodsdatabaseanddatabaseuserforSQLServer:
dbConfigurator.bat -a create -d sqlserver -c storage -v latest
-l jdbc:wm:sqlserver://DBserver:1433;databaseName=master -u webmuser
-p w3bmpass -au sa -ap sa_password -n webmdb
ThiscommandcreatesthewebMethodsbufferpoolandtablespaceswiththedefault
names,andgrantspermissionsforDB2:
dbConfigurator.bat -a create -d db2luw -c storage -v latest
-l jdbc:wm:db2://vmxpdb01:50000;databaseName=amol -u webmuser
-au adminuser -ap admin_password -t tablespace_dir
113
ThiscommandcreatesthewebMethodsbufferpoolandtablespaceswithcustomnames,
andgrantspermissionsforDB2:
dbConfigurator.bat -a create -d db2luw -c storage -v latest
-tsdata MYDATA -tsindex MYINDEX -tsblob MYBLOB -b MYBUFF
Drop the Storage and Revoke Database User Permissions

Ifyoudropalldatabasecomponentsinaschema,youcandropthestorageandrevoke
thedatabaseuserpermissions.
YoucanusetheconfiguratortodropthestorageforOracle,SQLServer,andDB2for
LUW.ForDB2foriSeries,youmustdropthedatabaseuserandstorageusingascript
(seeUsetheDatabaseScriptsonpage 116).
ThiscommanddropsthetwowebMethodstablespaceswithdefaultnamesforOracle:
dbConfigurator.bat -a drop -d oracle -c storage -v latest
ThiscommanddropsthetwowebMethodstablespaceswithcustomnamesforOracle:
dbConfigurator.bat -a drop -d oracle -c storage -v latest
-tsdata MYDATA -tsindex MYINDEX
ThiscommanddropsthewebMethodsdatabaseforSQLServer:
dbConfigurator.bat -a drop -d sqlserver -c storage -v latest
-l jdbc:wm:sqlserver://DBserver:1433;databaseName=master -u webmuser
-p w3bmpass -au sa -ap sa_password -n webmdb
ThiscommanddropsthewebMethodsbufferpoolandtablespaceswithdefaultnames,
andrevokespermissionsforDB2:
dbConfigurator.bat -a drop -d db2luw -c storage -v latest
ThiscommanddropsthewebMethodsbufferpoolandtablespaceswithcustomnames,
andrevokespermissionsforDB2:
dbConfigurator.bat -a drop -d db2luw -c storage -v latest
-tsdata MYDATA -tsindex MYINDEX -tsblob MYBLOB -b MYBUFF
114
Create Database Components

ThiscommandcreatesProcessAuditLogv40inOracle:
dbConfigurator.bat -a create -d oracle -c processaudit -v 40
-l jdbc:wm:oracle://DBserver:1521;serviceName=myservicename -u webmuser
-p w3bmpass
Thiscommandrecreates(dropsandthencreates)thelatestversionsofalldatabase
componentsinSQLServer:
dbConfigurator.bat -a recreate -d sqlserver -c all -v latest
-l jdbc:wm:sqlserver://DBserver:1433;databaseName=webmdb -u webmuser -p w3bmpass
ThiscommanddisplaysthedatabasecomponentsthatcurrentlyexistinDB2forLUW:
dbConfigurator.bat -a catalog -d db2udb
-l jdbc:wm:db2://DBserver:50000;databaseName=webmdb -u webmuser -p w3bmpass
ThiscommandcreatesthelatestdatabasecomponentsinDB2whencreatingin
ALTSCHEMAratherthanthedefaultschemaforthespecifieddatabaseuser:
dbConfigurator.bat -a create -d db2luw -c all -v latest
-l jdbc:wm:db2://DBserver:50000;databaseName=webmdb
;AlternateId=ALTSCHEMA;InitializationString=\SET CURRENT PATH=ALTSCHEMA\
-u webmuser -p w3bmpass

Beforedropping,shutdownallwebMethodsproductsthatareconnectedtothedatabase
componentandbackupthedatabasecomponent.
YoucannotdroptheComponentTrackerdatabasecomponentusingtheconfigurator;
youmustuseascript.Forinstructions,seeUsetheDatabaseScriptsonpage 116.
ThiscommanddropsProcessAuditLogv40fromOracle:
dbConfigurator -a drop -d oracle -c processaudit -v 40
-l jdbc:wm:oracle://myserver:1521;serviceName=myservicename -u webmuser
-p w3bmpass
ThiscommanddropsthelatestversionsofalldatabasecomponentsfromSQLServer:
dbConfigurator.bat -a drop -d sqlserver -c core -v latest
-l jdbc:wm:sqlserver://myserver:1433;databaseName=webmdb -u webmuser -p w3bmpass
ThecommanddropsthelatestversionoftheAnalysisdatabasecomponentfromDB2for
LUW:
dbConfigurator.bat -a drop -d db2luw -c analysis -v latest
-l jdbc:wm:db2://DBserver:50000;databaseName=webmdb -u webmuser -p w3bmpass
115
ThiscommanddropsthelatestversionoftheAnalysisdatabasecomponentfromDB2
whendroppingfromALTSCHEMAratherthanthedefaultschemaforthespecified
databaseuser:
dbConfigurator.bat -a drop -d db2luw -c analysis -v latest
-l jdbc:wm:db2://DBserver:50000;databaseName=webmdb;AlternateId=ALTSCHEMA
;InitializationString="SET CURRENT PATH=ALTSCHEMA" -u webmuser -p w3bmpass
Use the Database Scripts

ThissectionexplainshowtousedatabasescriptsprovidedbywebMethodstocreatea
databaseuserandstorage,dropstorageandrevokethedatabaseuserpermissions,andto
createordropwebMethodsdatabasecomponents.
Modify Storage Convention

Bydefault,allwebMethodsdatabasecomponentsfollowthisstorageconvention:
RDBMS
Data Storage Unit
Index Storage Unit
BLOB Storage Unit
Oracletablespaces
WEBMDATA
WEBMINDX
WEBMDATA
SQLServerfilegroups
Primary
Primary
Primary
DB2forLUWtablespaces
WEBMDATA
WEBMINDX
WEBMBLOB
DB2foriSeries
Default
Default
Default
Ifyouwanttouseadifferentstorageconventionwhenyoucreatedatabasecomponents,
dothefollowing:
1
GotothewebMethods_directory\common\db\scriptsdirectory.
CopythecreationscriptsforyourRDBMStoanotherdirectory.
Modifythevalueslistedinthetableaboveinthecreationscripts.
Note: Commercialandpublicdomainutilitiesprovidesearchandreplace
functionalityacrosssubdirectories.ThewebMethodsproductsuitesupportsall
tablespaceconfigurationsdeployedbycustomers.
Run the Database Scripts

Yourunthedatabasescriptsfromyourdatabaseclient.Bydefault,thescriptsarestored
inthewebMethods_directory\common\db\scriptsdirectory.Ifyoumodifiedthestorage
conventions,thecreationscriptsarestoredinthedirectorytowhichyoucopiedthem.
Todeterminewhichscriptstorun,gotothewebMethods_directory\common\db\bin
directoryandruntheappropriatecommandbelow.Theorderinwhichthescriptsare
116
listedistheorderinwhichyoushouldrunthem.Forexplanationsofthefieldsinthe
commandsbelow,seeDatabaseComponentConfiguratorCommandonpage 107.
Create a Database User and Storage

Tolistthescriptsforcreatingadatabaseuserandstorage,runthiscommand:
dbConfigurator.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i}
-c storage -v latest
Drop Storage and Revoke Database User Permissions

Ifyouhavedroppedalldatabasecomponentsfromaschema,youcandropthedatabase
userandstorage.
Tolistthescriptsfordroppingstorageandrevokingdatabaseuserpermissions,runthis
command:
-c storage -v latest
Create Database Components

Createtheproperversionsofthedatabasecomponentsforyourproduct(seeChapter 1,
DevelopmentEnvironments).
Tolistthescriptsforcreatingindividualdatabasecomponents,oralldatabase
components,runthiscommand:
-c db_component -v db_component_version
TolistthescriptsforcreatingthedatabasecomponentsforacertainwebMethods
product,runthiscommand:
-pr product -v product_release

Beforedropping,shutdownallwebMethodsproductsthatareconnectedtothedatabase
componentandbackupthedatabasecomponent.
Tolistthescriptsfordroppingindividualdatabasecomponents,oralldatabase
components,runthiscommand:
-c db_component -v db_component_version
117
TolistthescriptsfordroppingthedatabasecomponentsforacertainwebMethods
product,runthiscommand:
-pr product -v product_release
118
Completing the Installation
Post-Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
120
Configure Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
121
Complete the webMethods Broker Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
122
Complete the EntireX Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
123
Complete the Integration Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
124
Complete the Monitor Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
127
Complete the Optimize Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
127
Complete the Report Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
128
Connect Products to Each Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
135
Connect Products to Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
141
Installed JDKs and Product JDK Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
147
119
9 Completing the Installation
Post-Installation Checklist
Thechecklistbelowidentifiestasksyoumustperformtomakeaninstallationof
webMethodsproductsoperational.Thechecklistalsoidentifiestasksyoumightwantto
performbeforestartingwebMethodsproducts.
Important! Thischapterdescribesonlythosetasksyoumustorcanperformbefore
startingwebMethodsproducts.Forinstructionsonstartingproductsandconfiguring
themaftertheyarestarted,seetheproductdocumentationat
http://documentation.softwareag.com/webmethods.
Product
Task
Page
ApplinX
OnUNIX,sourcetheSoftware AGenvironment
fileapxenvtosettheenvironmentvariable
APPLINX_ROOT,orsetthevariable
permanentlybycopyingthesettingfromthe
apxenvfileintoyourprofile.Theapxenvfileis
locatedintheApplinXinstallationdirectory.
OnWindowsVista,reenableUserAccount
Control(UAC).
webMethods
Broker
EntireX
MakesuretheBrokerServerisrunningandthe
defaultBrokerexists.
122
OnUNIX,setsystemanduserlimits.
122
OnAIX,enablefullcoredumps.
122
OnUNIX,configureBrokerMonitortostart
automaticallywhenyoustartthesystem.
122
OnUNIX,ifyouaregoingtorunwebMethods
BrokerinalocaleotherthanU.S.English,setthe
BrokerServertorunusingthatlocale.
123
OnUNIX,setenvironmentvariables.
123
OnUNIX,ifyoudidnotusesudotoinstall
EntireX,createdaemonsandsetpermissions.
123
OnWindowsVista,reenableUserAccount
Control(UAC).
Integration
Server
120
OnUNIXandMac,ifyouareusingaSunJDK,
increasePermGenspace.
124
OnUNIXandMac,increasefiledescriptors.
124
(Optional)OnUNIXandMac,change
permissions.
124
Product
Task
Page
IfyouinstalledtheIntegrationServerand
Optimizedatabasecomponentsintwodifferent
schemasusingtheDatabaseComponent
Configurator,dropredundantdatabase
components.
125
(Optional)StreamlineIntegrationServer(for
example,becauseyouwanttouseitonlytohost
webMethodsadapters).
125
Monitor
OnUNIX,ifyouarenotusingSVG,setupthe
graphicaldisplay.
127
Optimize
ConfigureOptimize.Forinstructions,seethe
webMethodsCentralConfigurationandDeployment
Guide.
IfyouinstalledtheOptimizeandIntegration
Serverdatabasecomponentsintwodifferent
schemasusingtheDatabaseComponent
Configurator,dropredundantdatabase
components.
127
ReportServer
Completeallpostinstallationtasks
128
Mostproducts
Connectproductstoeachother.
135
Note: Ifyouinstalledallproductsatthesame
time,anddidnotchangeanyportsettingsor
defaultpasswordsafterinstallation,manyof
theseconnectionsareconfiguredautomatically.
Mostproducts
ConnectproductstowebMethodsdatabase
components.
141
Mostproducts
(Optional)Redirectproductstousenondefault
JREorJDK.
149
Configure Logging
YoucanlogauditdataforIntegrationServererrors,sessions,services,security,
documents,andguaranteeddeliverytransactions.Youcanalsologauditdatafor
businessprocesses,tasks,andintegrationprocesses.Fordetailedinformationand
instructionsonsettingupauditlogging,seethewebMethodsAuditLoggingGuide.
121
Complete the webMethods Broker Installation

Make Sure Broker Server is Running and the Default Broker Exists
Afterinstallation,BrokerMonitorstartsautomaticallyandthenstartstheBrokerServer,
whichbeginsrunningwithadefaultBroker.MakesuretheBrokerServerisrunningand
thedefaultBrokerexistsbyrunningthiscommand:
broker_status [Broker #1@]Broker Server_host[:Broker Server_port]
Set System and User Limits on UNIX Systems

BrokerMonitorandBrokerServerrequirecertainminimumsystemanduserlimitson
UNIXsystems.Askyoursystemadministratortosetthefollowingvaluesforeach
process:
Limit
Value
Maximumthreads
512
Maximumopenfiles
8192
Coredumpsize
unlimited
Enable Full Core Dumps on AIX Systems

OnAIXsystems,youmustenablefullcoredumps.UsingtheAIXSystemManagement
InterfaceTool(SMIT),runthecommandsmitty chgsysandsetEnable full CORE dumpto
true.
Configure Broker Monitors to Start Automatically on UNIX Systems

Bydefault,BrokerMonitorsrunasapplicationsthatyoustartandshutdownmanually.If
youinstalledwebMethodsBrokeronaUNIXsystem,andyouwantyourBroker
Monitorstostartandshutdownautomaticallywhenyoursystemstartsandshutsdown,
youmustconfiguretheBrokerMonitorstorunasdaemons.
1
GotothewebMethodsBrokerinstallationdirectory.
CopyeachBrokerMonitorstartupscriptaw_broker80totheappropriateUNIX
startupdirectory.
Replacetheawinaw_broker80withSnumber,wherenumberistherun,or
prioritylevel(forexample,S45broker80).IfyouconfiguremultipleBrokerMonitors
torunasdaemons,makethenameforeachBrokerMonitorstartupscriptunique
amongthestartupscriptsintheUNIXstartupdirectory(forexample,S45broker80_1,
S45broker80_2,andsoon).
122
Set Locale on UNIX Systems

IfyouaregoingtorunwebMethodsBrokerinalocaleotherthanU.S.English,youset
yourshelltotheproperlocalebeforeinstallation.However,thissettingonlyaffectsthe
waythewebMethodsInstallerstartsyourBrokerServerduringinstallation.Whenyou
restarttheBrokerServer,theBrokerServerwillusethedefaultlocale,U.S.English.On
UNIXsystems,ifyouwanttosettheBrokerServertorunusingadifferentlocale,setthe
environmentvariablesLC_ALLandLANGtothatlocale.
Complete the EntireX Installation

Set Environment Variables
OnUNIXsystems,youmustsettheEXXDIRenvironmentvariabletotheEntireX
installationdirectory,andsetthePATHandLD_LIBRARY_PATHenvironmentvariables
toincludetheEntireXinstallationdirectory.
Todoso,sourcetheEntireXenvironmentscriptexxenv.cshorexxenv,dependingonthe
shellyouareusing.ThescriptislocatedintheEntireX_directory/INSTALLdirectory.
SourcetheSoftware AGenvironmentscriptsagenv.newusingtheshellcommand
. $SAG/sagenv.Thescriptislocatedintheinstallationdirectorythatcontainstheshared
components.Bydefault,thatdirectoryis/opt/softwareag.
Create Daemons and Set Permissions

OnUNIXsystems,ifyoudidnotusesudotoinstallEntireX,youmustcreatedaemons
andsetpermissionsmanually.GototheEntireX_directory/INSTALLdirectoryandrunthe
install_etbsrv_deamonandexxssxsbit.bshscriptswithsudoprivileges.OnLinux
systems,alsoruntheexbinst.bshscriptwithsudoprivileges.
123
Complete the Integration Server Installation

Increase PermGen Space on UNIX and Mac Systems
IfyouareusingaSunJDKwithIntegrationServer,youmustincreasethepermanent
generation(PermGen)spacefromthedefaultof64MBtoatleast128MB.Bydefault,the
webMethodsInstallerinstallsaSunJDKforIntegrationServer8.0onLinuxandSolaris
systems.IfyouareusingthedefaultJDKonthosesystems,orifyouareusingyourown
SunJDKononeofthosesystems,anotherUNIXsystem,oranMacsystem,completethe
stepsbelow.
Note: Ifyoureceivejava.lang.OutOfMemoryError:PermGenspaceexceptionswhen
runningIntegrationServer,setthePermGenspacehigherthan128MB.
1
GototheIntegrationServer_directory/bindirectoryandopentheserver.shfileinatext
editor.
Uncommenttheselinesbyremovingthepoundsign(#):
#JAVA_MAX_PERM_SIZE=128M
#JAVA_PERM_SIZESET=-XX:MaxPermSize=${JAVA_MAX_PERM_SIZE}
Increase File Descriptors on UNIX and Mac Systems

OnUNIXandMacsystems,IntegrationServersabilitytohandletrafficisconstrainedby
thenumberoffiledescriptorsavailabletotheIntegrationServerprocess.Onmost
systems,64filedescriptorsareavailabletoeachprocessbydefault.webMethods
recommendsthatyouaskyoursystemadministratortoincreasethenumberoffile
descriptorsavailabletotheIntegrationServerprocesstoatleast1024.
Important! Youmighthavetoincreasethisnumberdependingonthenumberoffiles
IntegrationServerneedstohaveopenatonetime.Itisdangeroustosetthe
rlim_fd_maxvaluehigherthan1024becauseoflimitationswiththeselectfunction,so
ifIntegrationServerrequiresmorefiledescriptors,askthesystemadministratorto
setthesetrlimitvaluedirectly.
Change Permissions on UNIX and Mac Systems

IfyouinstalledIntegrationServeronaUNIXorMacsystemandnonrootuserswillbe
runningIntegrationServer,youmightwanttochangetheownershipoftheinstalledfiles
toallowasinglenonrootusertorunIntegrationServer(chown),changethefilegroupto
thegroupofuserswhowillrunIntegrationServer(chgrp),orchangefilepermissionsto
allowalluserstorunIntegrationServer(chmod).
124
Start Integration Server

ThetasksbelowrequireyoutostartIntegrationServer.
System
Action
Windows
application
OntheStartmenu,gotoPrograms > Software AGwebMethods > Start Servers

> Start ESB and Integration Server 8.0.
Windows
service
GototheServiceswindowandstarttheservicewebMethodsIntegration
Server8.0.
Allother
systems
GototheIntegrationServer_directory/bindirectoryandruntheserver.sh
script.
OpenIntegrationServerAdministratorineitheroftheseways:
OntheWindowsStartmenu,gotoPrograms > Software AGwebMethods > Administration >
ESB and Integration Server Administrator 8.0.
EntertheURLbelowinanInternetbrowser.ThedefaultportforIntegrationServeris
5555.
http://Integration Server_host:Integration Server_port
Loginunderthedefaultusernameandpassword,Administratorandmanage.
Drop Redundant Database Component

IfyouusedtheDatabaseComponentConfiguratortoinstalldatabasecomponents,and
youinstalledtheIntegration ServerdatabasecomponentsandtheOptimizedatabase
componentsintwodifferentschemas,youwillhavetwoinstancesoftheProcessAudit
Logdatabasecomponent.ConfigureIntegrationServerandOptimizetopointtothe
sameinstanceusinginstructionsinConnectProductstoDatabaseComponentson
page 141andthewebMethodsCentralConfigurationandDeploymentGuide,respectively.
Youcanthendroptheotherinstance(seethedatabasechaptersinthisguide).
Streamline Integration Server

Bydefault,IntegrationServermightbeequippedwithseveralpackagesthatprovide
differenttypesoffunctionality.IfyouwanttostreamlineIntegrationServer(forexample,
becauseyouareusingitonlytohostwebMethodsadapters),youcandisablemanyof
thesepackages.
125
Reviewthetablebelowanddeterminewhichpackagesyoucansafelydisable.
Package
Contents
WmART
ServicesthatrunwebMethodsadaptersthatareversion6.5
orlater.
Important! Donotdisablethispackageunlessyouarealso
goingtodisableWmARTExtDC,orWmARTExtDCwillnot
load.
WmAssetPublisher
ServicesthatextractandpublishmetadataaboutIntegration
ServerassetstoCentraSite.
ServicesthatInfrastructureDataCollectorinvokesto
discoverandmonitor:
WmISExtDC
TheIntegrationServer.
WmTNExtDC
TradingNetworksServer,ifinstalled.
WmARTExtDC
Adapters,ifinstalled.
Important! DonotdisabletheWmISExtDCpackageunless
youarealsogoingtodisableWmTNExtDCand
WmARTExtDC,orthosepackageswillnotload.
WmFlatFile
Servicesthatprocessflatfilesandusefilepollingports.
WmPRT,
WmDesigner,
WmTaskClient
Servicesthatsupportbusinessprocessesandtasks.
WmOptimize
ServicesthatsendKPI,business,andoperationaldatafor
unorchestratedbusinessprocesses(thatis,processes
executedbymeansotherthantheProcessEngine)to
Optimize.
WmTomcat
Servicesthatsupporttheservlet2.4andJSP2.0
specifications.
WmVCS
ServicesthatstoreDeveloperelementsinasourcecontrol
system.
WmXSLT
ServicesthatenableyoutowriteXSLTservices.
StartIntegrationServerandopenIntegrationServerAdministrator(seeIncreaseFile
DescriptorsonUNIXandMacSystemsonpage 124).
GotothePackages > Managementpageanddisableeachpackageyoudonotneed.To

doso,locatetherowforthepackageinthetable,thenclickYesintheEnabledcolumn
inthatrow.TheYeschangestoNo.
Important! NeverdisabletheWmRootorWmPublicpackage.
126
Complete the Monitor Installation

Set Up Graphical Display on UNIX Systems
MonitorcontainsJavaSwingandAWTcomponentsthatrequireagraphicaldisplay
utilitytoload.IfyouinstalledMonitoronaUNIXsystemandyouarenotusingSVG,you
mustdooneofthefollowing:
UseautilitysuchasanXServeroravirtualXServersuchasXvfb.TheUNIXsystem
musthaveaccesstothegraphicaldisplayutility,andyoumustsetthemachines
DISPLAYsettingtoidentifythehostmachineonwhichtheutilityisrunning.
ModifyIntegrationServersstartupfiletousetheDjava.awt.headlessoption,as
follows:
a
GototheIntegrationServer_directory/bindirectoryandopentheserver.shfileina
texteditor.
Locatethisline:
JAVA_MEMSET="-ms${JAVA_MIN_MEM} -mx${JAVA_MAX_MEM}"
Addtheargumentshownbelowtotheline:
JAVA_MEMSET="-Djava.awt.headless=true -ms${JAVA_MIN_MEM} -mx${JAVA_MAX_MEM}
Note: IftheJAVA_MEMSETlinealreadyincludestheserveroption,addthe
Djava.awt.headlessoptionaftertheserveroption.
Complete the Optimize Installation

Configure Optimize
YoumustconfigureOptimizeusingitsCentralConfigurationuserinterfaceinMy
webMethods.Forinstructions,seethewebMethodsCentralConfigurationandDeployment
Guide.
Drop Redundant Database Component

IfyouusedtheDatabaseComponentConfiguratortoinstalldatabasecomponents,and
youinstalledtheIntegration ServerdatabasecomponentsandtheOptimizedatabase
componentsintwodifferentschemas,youwillhavetwoinstancesoftheProcessAudit
Logdatabasecomponent.ConfigureIntegrationServerandOptimizetopointtothe
sameinstanceusinginstructionsinConnectProductstoDatabaseComponentson
page 141andthewebMethodsCentralConfigurationandDeploymentGuide,respectively.
Youcanthendroptheotherinstance(seethedatabasechaptersinthisguide).
127
Complete the Report Server Installation

ThissectionexplainshowtosetupabasicReportServerinstallation.Forinformationon
morecomplexReportServerinstallations,seeIBMCognos8BusinessIntelligence
InstallationandConfigurationGuide8.4.
AbasicReportServerinstallationincludesthesecomponents:
ReportServerandreportpackagesthatcontainpredefinedreportformatsfordata
fromwebMethodsproductssuchasMonitor,OptimizeforInfrastructure,Optimize
forProcess,TradingNetworks,andOptimizeforB2B,dependingonyourlicense.
webMethodsdatabasecomponentsthatcontainreportdataforwebMethods
productssuchasthoselistedabove,dependingonyourlicense.
DatabaseclientstoconnectReportServertowebMethodsdatabasecomponents.
ContentStore,anexternalRDBMScontainingdatathatReportServerneedsto
operate,suchasglobalconfigurationdataandreportdefinitions.
Webserver.
Bydefault,ReportServerbundlestheTomcatapplicationserver,butyoucanuseother
applicationserversinstead.Foralistofsupportedapplicationserversandinstructionson
howtoconfigurethem,seeIBMCognos8BusinessIntelligenceInstallationandConfiguration
Guide8.4.
ThetasksyoucompletetosetupabasicReportServerinstallationareasfollows:
SetUpaUserAccountandConfiguretheWebServer
CreatetheContentStore
ConnectReportServertowebMethodsDatabaseComponents
ConfigureWebBrowsers
ConfigureReportServerandStartReportServerServices
128
Set Up a User Account and Configure the Web Server

ReportServermustrununderauseraccountandyoumustsetupyourWebserverto
workwiththeaccount.
Set Up the User Account

TheuseraccountReportServerrunsundermusthaveaccesstoallrequiredresources,
suchasprintersandWebservers.Forexample,toprintreportsusinganetworkprinter,
theaccountmusthaveaccesstothenetworkprinter,oryoumustassignalogonaccount
totheReportServerservices.
OnaWindowssystem,theuseraccountmustbelongtothelocaladministratorgroup.If
youinstalledReportServerasaWindowsservice,theuseraccountmusthaverightsto
logonasaserviceandactaspartoftheoperatingsystem.GototheWindowsServices
windowandassignalogonaccounttotheReportServerservice,anddefineanyother
useraccountproperties.
OnaUNIXsystem,createanewUNIXgroupnamedsagrpt8.Thisgroupmustinclude
theuserthatownstheReportServerfiles.ChangethegroupownershipoftheReport
Serverfilestothesagrpt8groupandchangethefilepermissionsforallReportServerfiles
toGROUPREADABLE/WRITABLE/EXECUTABLE.
Configure the Web Server

ThissectionexplainshowtoconfiguretheApacheWebserverforusewithReportServer.
ForinstructionsonhowtoconfigureanduseotherWebserversinstead,seeIBMCognos8
BusinessIntelligenceInstallationandConfigurationGuide8.4.
ConfiguretheApacheWebserverbycreatingvirtualdirectories,oraliases,souserscan
connecttoReportServer.Youmustalsosetthecontentexpiryfortheimagesdirectoryin
yourWebserversoyourWebbrowserdoesnotcheckimagestatusafterthefirstaccess.
1
OnUNIX,theaccountunderwhichtheWebserverrunsmusthavereadaccesstothe
cogstartup.xmlfileinthewebMethods_directory/cognos/c8/configurationdirectory.By
default,thecogstartup.xmlfilehasreadpermissionforothers.IfyourunyourWeb
serverunderaspecificgroup,youcanchangethecogstartup.xmlfilepermissionsto
makesurethefilebelongstothesamegroupastheWebserver.Youcanthenremove
thereadpermissionforothers.
Createthesevirtualdirectories:
Alias
Location
Permission
cognos8/cgibin
webMethods_directory/cognos/c8/cgibin
Execute
cognos8
webMethods_directory/cognos/c8/webcontent
Read
GototheApache_directory/confdirectoryandopenthehttpd.conffileinatexteditor.
Definethecognos8/cgibinaliasasaScriptAlias,andplaceitbeforethecognos8alias
inthefile.Forexample:
129
#
# ScriptAlias: This controls which directories contain server scripts.
# ScriptAliases are essentially the same as Aliases, except that
# documents in the realname directory are treated as applications and
# run by the server when requested rather than as documents sent to the client.
# The same rules about trailing "/" apply to ScriptAlias directives as to
# Alias.
#
ScriptAlias /cgi-bin/ "C:/Program Files/Apache Group/Apache2/cgi-bin/"
#
# "C:/Program Files/Apache Group/Apache2/cgi-bin" should be changed to whatever
your ScriptAliased
# CGI directory exists, if you have that configured.
#
<Directory "C:/Program Files/Apache Group/Apache2/cgi-bin">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>
# ==============================================================================
# Cognos 8 Settings BEGIN
=
# ==============================================================================
ScriptAlias /cognos8/cgi-bin/ "webMethods_directory/cognos/c8/cgi-bin/"
ScriptAlias /cognos8/cgi-bin "webMethods_directory/cognos/c8/cgi-bin"
<Directory "webMethods_directory/cognos/c8/cgi-bin">
Options ExecCGI Indexes FollowSymlinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
Alias /cognos8/help/ "webMethods_directory/cognos/c8/webcontent/documentation/"
<Directory "webMethods_directory/cognos/c8/webcontent/documentation/">
Options Indexes FollowSymlinks
Allow from all
AllowOverride None
Order allow,deny
</Directory>
Alias /cognos8/ "webMethods_directory/cognos/c8/webcontent/"
Alias /cognos8 "webMethods_directory/cognos/c8/webcontent"
<Directory "webMethods_directory/cognos/c8/webcontent/">
Options Indexes FollowSymlinks
AllowOverride None
Order allow,deny
Allow from all
</Directory>
#
================================================================================
# Cognos 8 Settings END
=
# ==============================================================================
130
Create the Content Store

ThissectionexplainshowtocreatetheContentStoredatabaseinaOracleorSQLServer
RDBMSs(seewebMethodsSystemRequirementsforsupportedversions).
ReportServerusesasinglesortorderthatspecifiestherulesusedbytheContentStore
databasetointerpret,collect,compare,andpresentcharacterdata.Forexample,asort
orderdefineswhethertheletterAislessthan,equalto,orgreaterthantheletterB;
whetherthecollationiscasesensitive;andwhetherthecollationisaccentsensitive.For
moreinformationaboutcollationandcollationsequences,seeyourRDBMS
documentation.
Create the Content Store in Oracle

SettheparameterforthedatabaseinstancecompatibilityleveloftheContentStore
databaseto9.0.1orhigher.YoucanchecktheCOMPATIBLEinitializationparameter
settingbyissuingtheSQLstatementbelow.Forinstructionsonchanginganinstance
configurationparameter,seeyourOracledocumentation.
select name, value, description FROM v$parameter WHERE name='compatible';
DeterminewhetherthedatabaseisUnicodebyissuingthisSQLstatement:
select * from NLS_DATABASE_PARAMETERS
IftheresultsetreturnsanNLS_CHARACTERSETthatisnotUnicode,createanew
databaseandspecifyAL32UTF8forthedatabasecharactersetparameters.
CreatetheContentStoredatabaseuserandstorageusingtheDatabaseComponent
Configurator.Forinstructions,seeChapter 8,CreatingandDroppingDatabase
Components.
ConnectReportServertotheContentStoreusingTCP/IP.Gotothe
ORACLE_HOME/jdbc/libdirectory.ForJava1.5,copytheojdbc5.jardriverfiletothe
webMethods_directory/cognos/c8/webapps/p2pd/WEBINF/libdirectory.Ifthe
directorycontainstheclasses12.jarfile,deleteit.Youcandownloadthedriverfile
fromtheOracletechnologyWebsite.
Create the Content Store in SQL Server

YouwillconnectReportServertotheContentStorewhenyouconfiguretheReport
Server(seeConfigureReportServerandStartReportServerServicesonpage 133).
Makesurethecollationsequenceiscaseinsensitive.InaCustominstallation,you
chooseacollation,whichincludescharactersetsandsortorder,duringtheSQL
Serversetup.InaTypicalinstallation,theinstallationusesthelocaleidentifiedbythe
installationprogramforthecollation.Youcannotchangethissettinglater.
CreatetheContentStoredatabaseuserandstorageusingtheDatabaseComponent
Configurator.Forinstructions,seeChapter 8,CreatingandDroppingDatabase
Components.
131
Connect Report Server to webMethods Database Components

Install the Database Client
InstalltheappropriatedatabaseclientforthewebMethodsdatabasecomponentsthat
containreportdataontheReportServerhostmachine.Usenativedatabaseconnectivity.
Forinstructions,seeyourRDBMSdocumentation.
Set Database Environment Variables for Oracle (UNIX Systems)

IfwebMethodsdatabasecomponentsthatcontainreportdataareinOracleRDBMSson
UNIXsystems,youmustspecifydatabaseenvironmentvariables.ReportServeruses
thesedatabasevariablestoconnecttothewebMethodsdatabasecomponents.Theproper
syntaxforcreatingdatabaseenvironmentvariablesisshelldependent.
Set Oracle Database Environment Variables
OnewaytosetdatabaseenvironmentvariablesinOracleistoincludethecommandsthat
settheminthe.profileor.loginscriptoftheuserwhostartstheReportServerservices.
ThetablebelowdescribesenvironmentvariablesforOracledatabases.Askyourdatabase
ornetworkadministratorforthecorrectvaluesforyoursystem.
Database Environ
ment Variable
Description
ORACLE_
HOME
Topleveldirectorythatcontainsthedatabaseclientsoftwareorthe
entiredatabaseinstallation(forexample,/usr/oracle).
YoumightbeabletouseanOraclescripttocreatetheenvironment
variables(forexample,/usr/local/bin/coraenv).Formore
information,seetheOracledocumentation.
TNS_ADMIN
Directorythatcontainsthetnsnames.orafile,whichallowscallsto
theOracledatabasetodeterminetherequiredserverconnections
(forexample,$ORACLE_HOME/network/admin).
PATH
Variabletolocateexecutablefiles(forexample,
$PATH:$ORACLE_HOME/bin).
libraryPATH
Loadlibrarypath.Makesurethe32bitOraclelibrariesareinthe
librarysearchpath,whichisusuallythe$ORACLE_HOME/libor
the$ORACLE_HOME/lib32directoryifyouinstalleda64bitOracle
client.
System
Examples
Solaris
LD_LIBRARY_PATH=$ORACLE_HOME/
lib:$LD_LIBRARY_PATH
LD_LIBRARY_PATH=$ORACLE_HOME/
lib32:$LD_LIBRARY_PATH
132
Database Environ
ment Variable
Description
AIX
LIBPATH=$ORACLE_HOME/lib:$LIBPATH
LIBPATH=$ORACLE_HOME/lib32:$LIBPATH
HPUX
SHLIB_PATH=$ORACLE_HOME/lib:$SHLIB_PATH
SHLIB_PATH=$ORACLE_HOME/lib32:$SHLIB_PATH
NLS_LANG
LocaledependentbehaviorofReportServer.Errormessages,sort
order,date,time,monetary,numeric,andcalendarconventions
automaticallyadapttothenativelanguageandlocale.
Configure Web Browsers

Enablethesettingsinthetablebelow.
Browser
Setting to Enable
InternetExplorer
AllowCookies,ActiveScripting,AllowMETAREFRESH
Netscape
AllowCookies,JavaScript
Firefox
AllowCookies,EnableJava,EnableJavaScript
Configure Report Server and Start Report Server Services

TheCognosConfigurationtoolconfiguresReportServercomponentsandcreatesthe
ContentStoredatabasetables.TheconfiguratoralsostartsandstopstheReportServer
services.
1
Openacommandwindow,gotothewebMethods_directory/cognos/c8/binorbin64
directory,asappropriateforyoursystem,andstarttheconfiguratorbytyping
./cogconfig.{bat|sh}.ForWindows,youcanalsostarttheconfiguratorfromtheStart
menu(Start > Tools > IBM Cognos Configurator).
DuringReportServerinstallation,youwereaskedtospecifytheconnectionfromthe
ReportServertotheReportServerContentStore.Ifyoudidnotspecifythe
connection,orneedtochangeitforsomereason,seeSetDatabaseConnection
PropertiesfortheContentStoreinIBMCognos8BusinessIntelligenceInstallationand
ConfigurationGuide8.4.TheReportServercannotstartwithoutavalidconnectionto
theContentStore.
ClickSavetosavetheconfigurationyouspecifiedduringReportServerinstallation.
GototheActionsmenuandclickTest.Theconfiguratorcheckscommonsymmetric
keys(CSK)availability,teststhenamespaceconfiguration,andteststheconnections
betweenReportServerandtheContentStore.Ifthetestfails,reconfiguretheaffected
propertiesandtestagain.
133
GototheActionsmenuandclickStarttostarttheReportServerservices.The
configuratorcreatesthenecessarydatabasetablesintheContentStoreRDBMS.Ifyou
areonaWindowssystem,theconfiguratoralsocreatestheReportServerWindows
service.
TesttheReportServerinstallationandconfigurationasfollows:
134
OpenaWebbrowser.
MakesuretheContentStorewassuccessfullycreatedandtheReportServer
servicecalledtheContentManagerstartedbytypingtheURLhttp://Report
Server_host:ReportServer_port/p2pd/servlet.Iftheresponseincludesthestring
State: Running,theContentManagerisavailable.
MakesuretheReportServerservicecalledthedispatcherisavailablebytyping
http://ReportServer_host:ReportServer_port/p2pd/servlet/dispatch.Iftheresponse
includesthestringState: Running,thedispatcherisavailable.
MakesureyourinstallationisworkingbyconnectingtotheIBMCognos8portal.
Inabrowser,typetheURLhttp://host:port/cognos8(cognos8isthevirtual
directoryyoucreatedwhenyouconfiguredtheWebserver).Itmighttakeafew
minutesfortheWebpagetoopen.IfyouseetheWelcomepageintheIBM
Cognos8portal,yourinstallationisworking.
Connect Products to Each Other

Thissectionexplainshowtodothefollowing:
ConnectProcessEnginestoTaskEngine
ConnectProcessEnginetoOptimizeAnalyticEngine
ConnectProductstoMywebMethodsServer
ConnectIntegrationServertoDefaultBroker
Note: Ifyouinstalledallproductsatthesametime,anddidnotchangeanyport
settingsordefaultpasswordsafterinstallation,manyoftheseconnectionsare
configuredautomatically.
ForinstructionsonconnectingDesignertootherproducts,seetheDesigneronlinehelp.
Start Integration Server and My webMethods Server

Tocreatetheconnections,youneedIntegrationServerandMywebMethodsServer.
StartIntegrationServerandopenIntegrationServerAdministrator(seeIncreaseFile
DescriptorsonUNIXandMacSystemsonpage 124).
StartMywebMethodsServerasfollows:
System
Action
Windows
application
OntheStartmenu,gotoPrograms > Software AGwebMethods > Start Servers

> Start My webMethods Server 8.0.
Windows
service
GototheServiceswindowandstarttheservicewebMethodsMy
webMethods Server8.0.
Allother
systems
GotothewebMethods_directory/MywebMethodsServer_instance/bin
directoryandrunthiscommand:
mws -s default start
MywebMethodsServertakesaboutfiveminutestoinitializethefirsttimeyoustartit.
OpenMywebMethodsineitheroftheseways:
OntheWindowsStartmenu,gotoPrograms > Software AGwebMethods >Administration >
My webMethods 8.0.
EntertheURLbelowinanInternetbrowser.ThedefaultportforMywebMethods
Serveris8585.
http://My webMethods Server_host:My webMethods Server_port
Loginunderthedefaultusernameandpassword,Administratorandmanage.
135
Important! AfteryoufinishconnectingMywebMethodsServertotheotherweb
Methodsproducts,youwillhavetorestartitbeforeyoucanstartusingit.
Connect Process Engines to Task Engine

TheProcessEnginemustconnecttotheTaskEnginesotheTaskEnginecanprovide
resultsofprocessstepsthatrequiredhumaninterventiontorunningprocesses.
Note: IfyouinstallmultipleProcessEnginesinaProcessEnginecluster,allProcess
EnginesintheclustershareaBroker,thesamedatabasecomponent,orboth,sothe
TaskEngineneedonlyconnecttooneProcessEnginetoconnecttoall.
IfyouaregoingtoclusterTaskEngines,seetheMywebMethodsServerAdministrators
Guideforconnectioninstructions.
1
136
IdentifytheProcessEnginestotheTaskEngineasfollows:
a
OntheMywebMethodsServerthathoststheTaskEngine,gototheNavigate >
Applications > Administration > My webMethods > System Settings > Task Enginepage.
IntheIntegration Server (Process Engine) Hostrow,identifythehostmachineforan

IntegrationServerthathostsaProcessEngineinyourProcessEnginecluster.The
defaultportforIntegrationServeris5555,buttheportmighthavebeenchanged
duringorafterinstallation.
IfMywebMethodsServershoulduseSSLtocommunicatewiththeIntegration
Server,selecttheUse SSLcheckbox.
IfyouwanttocheckwhethertheIntegrationServeriscurrentlyrunning,click
Check Server Status.
ClickSave.
IdentifytheTaskEnginetotheProcessEnginesasfollows:
a
IntheIntegrationServerAdministratorforanIntegrationServerthathostsa
ProcessEngineinyourProcessEnginecluster,gotothePackages > Management
pageandclick fortheWmTaskClientpackage.
IntheTask Server URLfield,typetheURLoftheMywebMethodsServerthathosts

theTaskEngine(forexample,http://myserver:8585).
IntheTask Server Usernameand Task Server Passwordfields,acceptthedefault

valuesAdministratorandmanage.
ClickSave.
ReloadtheWmTaskClientpackagebyreturningtothePackagesManagement
pageandclicking intheWmTaskClientrow.
Connect Process Engine to Optimize Analytic Engine

Ifprocessesareenabledforanalysis,theProcessEnginemustconnecttotheOptimize
AnalyticEnginesoMywebMethodscandisplayprocessmetrics.
Bydefault,theURLprovidedtotheProcessEnginesforthisBrokeris
broker://localhost:6849/Broker#1/analysis.IftheBrokerisnotonthesamemachineasa
ProcessEngine,ortheporttheBrokerisusingisnot6849,ortheBrokersnameisnot
Broker#1,youmustmodifythisURL.
Note: IfyouinstallmultipleProcessEnginesinaProcessEnginecluster,allProcess
EnginesintheclustersharetheBroker.
1
InIntegrationServerAdministratorforanIntegrationServerthathostsaProcess
Engine,gotothePackages > Managementpageandclick fortheWmPRTpackage.
IntheBroker URLfield,changelocalhosttothecorrecthost,theporttothecorrect
port,andBroker #1tothecorrectBrokername.
Important! Donotchangethebroker://or/analysispartsoftheURL.
Ifyouneedtoeditanyoftheotherfields,seethewebMethodsProcessEngineUsers
Guide.
ClickSubmit.
RepeatthesestepsfortheWmOptimizepackage.Ifyouneedtoeditanyoftheother
fields,seethewebMethodsOptimizeAdministratorsGuide.
Connect Products to My webMethods Server

Monitor,theReportServer,theOptimizeAnalyticEngine,TradingNetworksServer,and
IntegrationServermustconnecttotheMywebMethodsServerthathoststheiruser
interfacessoMywebMethodscandisplayeachproductsdata.Thissectionexplainshow
toconnecttheseproductstoMywebMethodsServer.
Note: IfyouaregoingtoclusterMywebMethodsServers,seetheMywebMethods
ServerAdministratorsGuideforconnectioninstructions.
Connect Monitor to My webMethods Server

1
IdentifyMonitortoMywebMethodsServerasfollows:
a
OntheMywebMethodsServerthathoststheMonitoruserinterface,gotothe
Navigate > Applications > Administration > My webMethods > System Settingspage.
IntheIntegration Server (Monitor) Hostrow,identifythehostmachineforan

IntegrationServerthathostsMonitor.ThedefaultportforIntegrationServeris
5555,buttheportmighthavebeenchangedduringorafterinstallation.
137
IfMywebMethodsServershoulduseSSLtocommunicatewiththeIntegration
Server,selecttheUse SSLcheckbox.
IfyouwanttocheckwhethertheIntegrationServeriscurrentlyrunning,click
Check Server Status.
ClickSave.
IdentifyMywebMethodsServertoMonitorasfollows:
a
InIntegrationServerAdministratorfortheIntegrationServerthathostsMonitor,
gotothePackages > Managementpageandclick fortheWmMonitorpackage.
IftheMywebMethodsServerisnotonthesamemachineastheIntegration
Server,edittheMWS HostandMWS PortfieldstoidentifytheMywebMethods
Serverhostmachineandport.
IntheMWS UsernameandPasswordfields,typetheusernameandpasswordfor
MonitortousetoconnecttotheMywebMethodsServerthathoststheMonitor
userinterface.Thepassworddefaultismanage.
Ifyouneedtoeditanyotherfields,seethewebMethodsMonitorUsersGuide.
ClickSubmit.
ReloadtheWmMonitorpackagebyreturningtothePackagesManagementpage
andclicking intheWmMonitorrow.
Connect Report Server to My webMethods Server

1
OntheMywebMethodsServerthathoststheReportinguserinterface,gotothe
Navigate > Applications > Administration > System-wide > Report Configurationpage.
IntheReport Server Host and Port fields,identifythehostmachinefortheReport

Server.ThedefaultportforReportServeris9300,buttheportmighthavebeen
changedduringorafterinstallation.
IntheAdmin User and Admin Password fields,acceptthedefaultvaluesAdministrator

andmanage.
IntheWeb Server HostandPortfields,identifytheWebserveryouinstalledforuse

withtheReportServer.
ClickSave.
138
Connect Optimize Analytic Engines to My webMethods Server

Note: IfyouinstallmultipleAnalyticEngines,allwillsharethesamedatabase
components,soMywebMethodsServerneedonlyconnecttoonetoconnecttoall.
1
IdentifyanAnalyticEnginetoMywebMethodsServerasfollows:
a
OntheMywebMethodsServerthathoststheOptimizeuserinterfaces,gotothe
Navigate > Applications > Administration > My webMethods > System Settingspage.
IntheAnalytic Engine Hostrow,identifythehostmachineforanAnalyticEngine.

ThedefaultportforAnalyticEnginesis12503.
IfMywebMethodsServershoulduseSSLtocommunicatewiththeAnalytic
Engine,selecttheUse SSLcheckbox.
ClickSave.
IfyouconfiguredOptimizeusingtheCentralConfigurationuserinterfaceinMy
webMethods,youalreadyidentifiedtheMywebMethodsServerthathoststhe
OptimizeuserinterfacestoyourAnalyticEngines.Ifnot,dosousingtheinstructions
inthewebMethodsCentralConfigurationandDeploymentGuide.
Connect Trading Networks Server to My webMethods Server

1
OntheMywebMethodsServerthathoststheTradingNetworksuserinterface,goto
theApplications > Administration > Integration > B2B Settings > Administrative Preferences
page.
IntheTrading Networks Serverarea,identifytheIntegrationServerthathostsTrading

NetworksServer.ThenclickSave.
Connect Integration Server to Default Broker

1
InIntegrationServerAdministrator,gototheSettings > Messaging > Broker Settings

pageandclickEdit Broker Settings.
ClickConfiguredontheleftsideofthepageandcompletethefieldsasshownbelow.
Field
Setting
Broker Host
Name(DNSname:portorIPaddress:port)ofthemachinethat
hoststheBrokerServer.
Broker Name
NameoftheBrokertowhichIntegrationServershould
connect,asdefinedonBrokerServer.ThedefaultBrokeris
Broker#1.
Client Group
BrokerServerclientgrouptowhichIntegrationServershould
connect.Ifthespecifiedclientgroupdoesnotexist,Integration
ServercreatesitwhenitconnectstotheBroker.
139
Field
Setting
Client Prefix
StringthatidentifiesIntegrationServertotheBroker.By
default,IntegrationServerusesitslicensekeyfortheprefix.
Youcandefineyourown,shorter,prefix.IftheIntegration
Serverispartofacluster,allIntegrationServersinthecluster
mustusethesameclientprefix.
MywebMethodsdisplaysthisprefixforeachclientitcreates
forIntegrationServer.(TheBrokercreatesmultipleclientsfor
eachIntegrationServerthatconnectstoit.)
Note: IfthisIntegrationServerbelongstoacluster,makesureit
usesthesameclientprefixastherestofthecluster.
Use SSL
140
IndicateswhethertouseSSLtocommunicatewiththeBroker.
Keystore
FullpathtoIntegrationServerskeystorefile.
Keystore Type
Filetypeofthekeystorefile(PKCS12orJKS).
Truststore
FullpathtoIntegrationServerstruststorefile.
Truststore Type
Filetypeofthetruststorefile(JKS).
Password
PasswordtousetoaccesstheSSLcertificateinIntegration
Serverskeystorefile.
Encryption
WhethertoencrypttheconnectionbetweenIntegrationServer
andtheBroker.
ClickSave Changes,thenrestartIntegrationServer.
Connect Products to Database Components

Thissectionexplainshowtodefinethefollowingdatabaseconnections:
FromIntegrationServertotheISInternal,ISCoreAuditLog,Archive,BPELEngine,
CrossReference,DocumentHistory,ProcessAuditLog,ProcessEngine,and
ReportingandStagingdatabasecomponents.
FromIntegrationServertothecentralusersfeatureinMywebMethodsServer.This
featureallowsMywebMethodsServeruserstoaccessIntegrationServer,enables
IntegrationServertodelegateusermanagementtoMywebMethodsServer,and
enablesMywebMethodsServersuserinterfacestocallIntegrationServerservices.
FromTradingNetworksServertotheTradingNetworksdatabasecomponent.
Forinstructionsondefiningthedatabaseconnectionforotherproducts,seethe
following:
Product
See
My
webMethods
Server
MywebMethodsServerAdministratorsGuide
Note: ThewebMethodsInstallerpromptedyoutodefinethis
databaseconnectionduringMywebMethodsServerinstallation.
Optimize
webMethodsCentralConfigurationandDeploymentGuide
Designer
Designeronlinehelp
ReportServer
ConnectReportServertowebMethodsDatabaseComponentson
page 132
Database Connections for Integration Server and Hosted Products

YouuseIntegrationServerAdministratortoconnectIntegrationServertodatabase
components,asfollows:
YoudefineJDBCdatabaseconnectionpoolsinIntegrationServerAdministratorfor
IntegrationServertousetoconnecttodatabasecomponents.Eachpoolspecifiesthe
connectiontoadatabaseserverthathostsdatabasecomponents.
IntegrationServerAdministratorprovidesafunctionthatcorrespondstoeach
databasecomponent(forexample,ISCoreAuditLogfunction,aCrossReference
function,andsoon).Youdirecteachfunctiontowritetothecorrespondingdatabase
componentbypointingthefunctionattheappropriateconnectionpool.
DuringIntegrationServerinstallation,ifyouchoseanexternalRDBMSforthe
IntegrationServerdatabasecomponentsandsuppliedthedatabaseconnection
parameters,thewebMethodsInstallercreatedadefaultconnectionpoolfromthose
parameters.TheinstallerautomaticallypointedtheISInternal,ISCoreAuditLog,Cross
Reference,DocumentHistory,ProcessAuditLog,andProcessEnginefunctionsatthat
pool.Youcaneditthedefaultpoolusingtheinstructionsinthissection,oryoucancreate
141
separatepoolsandredirectindividualfunctionstousethem.Atruntime,Integration
Servercreatesaseparateinstanceoftheappropriateconnectionpoolforeachdatabase
component.
Note: WhenyousupplythedatabaseconnectionparametersforanexternalRDBMS
duringIntegrationServerinstallation,thewebMethodsInstallerautomatically
configuresIntegrationServertowritetotheexternalRDBMS.Youdonothavetoset
anyIntegrationServerproperties.
YoualsouseIntegrationServerAdministratortoconnectotherproductstodatabase
components,asfollows:
DuringTradingNetworksServerinstallation,yousuppliedthedatabaseconnection
parametersfortheTradingNetworksdatabasecomponent.ThewebMethods
InstallercreatedaconnectionpoolfromthoseparametersandpointedtheTrading
Networksfunctionatthatpool.YoucanedittheconnectionusingIntegrationServer
Administratorandtheinstructionsbelow.
IntegrationServercanauthenticateclientsusinginternallydefineduserandgroup
information,oritcanusetheMywebMethodsServercentralusermanagement
feature.Tousethelatter,IntegrationServermusthaveaconnectionpoolthatpoints
totheMywebMethodsServerdatabasecomponent,andtheCentralUsersfunctionin
IntegrationServermustpointatthatconnectionpool.
IfyouinstalledMywebMethodsServerinthesamedirectoryasIntegrationServer,
thewebMethodsInstallercreatedaconnectionpoolfromtheMywebMethodsServer
databaseparametersyousuppliedandpointedtheCentralUsersfunctionatthat
pool.IfyouinstalledMywebMethodsServerinadifferentdirectoryfrom
IntegrationServer,youmustcreatetheconnectionpoolandpointtheCentralUsers
functionatthatpoolusingIntegrationServerAdministratorandtheinstructions
below.
IfyoucreatedtheArchive,BPEL,andReportingandStagingdatabasecomponents,
youmustpointthosefunctionsatconnectionpools.
142
Define a Connection Pool

1
StartIntegrationServerandopenIntegrationServerAdministrator(seeStart
IntegrationServeronpage 125).
GototheSettings > JDBC Poolspage.
MostwebMethodsproductsusetheDataDirectConnectJDBC4.0driver.TheBPEL
databasecomponent,however,requiresotherdrivers.Dothefollowing:
a
DownloadthejarfilesindicatedbelowfromatrustedInternetsitetothe
IntegrationServer_directory\lib\jarsdirectory.
RDBMS
Driver
jar Files
Oracle
OracleDatabase10gRelease2
JDBCDrivers10.2.0.2.0
ojdbc14.jar
SQLServer
JTDSJDBCDriver1.2
JTDS1.2.jar
OntheSettings > JDBC Poolspage,clickCreate a new Driver Alias Definitionand

completethefieldsasfollows:
Field
Alias Name
Nametouseforthedriver.Thenamecanincludeany
charactersthatarevalidforafilenameinyouroperating
system.
Alias Description
Descriptionforthedriver.
Driver Class
Name
Classnameindicatedbelow.
RDBMS
Entry
Oracle
oracle.jdbc.driver.OracleDriver
SQLServer
net.sourceforge.jtds.jdbc.Driver
OntheSettings > JDBC Poolspage,clickCreate a new Pool Alias Definitionandcomplete

thefieldsasfollows:
Field
Entry
Alias Name
Namefortheconnectionpool.Thenamecanincludeanycharacters
thatarevalidforafilenameinyouroperatingsystem.
Alias
Description
Descriptionforthepool.
Associated
Driver Alias
Databasedrivertouse.FortheBPELdatabasecomponent,choose
thedriveraliasnameyoucreatedinthepreviousstep.
143
Field
Entry
Database
URL
URLforthedatabaseserver.Belowaresampleformatsforthe
DataDirectConnectJDBC4.0driver.
Oracle
[;option=value ]
Oracle configured for RAC

jdbc:wm:oracle://server:{1521|port};serviceName=service;
AlternateServers=(server:{1521|port};,);
ConnectionRetry=value; ConnectionDelay=value;
LoadBalancing=value [;option=value ]
SQL Server
jdbc:wm:sqlserver://server:{1433|port};databaseName=database
[;option=value ]
DB2 for Linux, UNIX, Windows

jdbc:wm:db2://server:{50000|port};databaseName=database
[;option=value ]
DB2 for iSeries

jdbc:wm:db2://server:{446|port};locationName=location
[;option=value ]
Important! ForDB2,ifIntegrationServerwillconnecttoaschema
otherthanthedefaultschemaforthespecifieddatabaseuser,you
mustspecifytheseconnectionoptionsintheURL:
AlternateId=schema;InitializationString="SET CURRENT
PATH=schema"
AlternateIDisthenameofthedefaultschemathatisusedtoqualify
unqualifieddatabaseobjectsindynamicallypreparedSQL
statements.
144
User Id
DatabaseuserforIntegrationServertousetocommunicatewiththe
database.
Password
Passwordforthedatabaseuser.
Field
Entry
Minimum
connections
Minimumnumberofconnectionsthepoolmustkeepopenatall
times.
Ifyouusethispoolaliasformorethanonefunction,eachpool
instancekeepsthespecifiednumberofconnectionsopen.For
example,ifyouspecifykeepingatleast3connectionsopen,andthe
ISCoreAuditLogandtheDocumentHistorydatabasecomponents
bothusethispool,thepoolkeepsatotalof6connectionsopen3
fortheISCoreAuditLogpoolinstanceand3fortheDocument
Historypoolinstance.
Ifyourloggingvolumehassuddenspikes,youcanimprove
performancebymakingsuretheconnectionsneededtohandlethe
increasedvolumeopenquickly.Youcanminimizeconnection
startuptimeduringspikesbysettingthisvaluehigher,sothatmore
connectionsremainopenatalltimes.
Maximum
connections
Maximumnumberofconnectionsthepoolscanhaveopenatone
time.
Calculatethisvalueaspartofthetotalpossiblenumberof
connectionsthatcouldbeopenedsimultaneouslybyallfunctions
andapplicationsthatwritetothedatabase.Makesurethetotal
numberdoesnotexceedthedatabasesconnectionlimit.Ifoneof
theapplicationsopensmoreconnectionsthanthedatabaseallows,
thedatabasewillrejectsubsequentrequestsforconnectionsfrom
anyapplication.
However,ifTradingNetworksalsowritestothedatabaseandhasa
poolthatcouldopenupto5connections,youcouldspecifyonly17
asthemaximumnumberofconnectionsforthecurrentpool.TheIS
CoreAuditLogpoolinstancecoulduseupto17connections,and
theDocumentHistorypoolinstancecouldusetheremaining5
connections.
Youmustcoordinatethevalueforthetemporarystoreproperty
watt.server.auditMaxPoolwiththisvalue.Forinstructions,seethe
webMethodsAuditLoggingGuide.
Idle Timeout
Periodoftime,inmilliseconds,thepoolcankeepanunused
connectionopen.Afterthespecifiedperiodoftime,thepoolcloses
unusedconnectionsthatarenotneededtosatisfytheMinimum
connectionsvalue.
MakesureIntegrationServercanconnecttothedatabasebyclickingTest Connection.
ClickSave Settings.
145
Point a Function at a Connection Pool

1
InIntegrationServerAdministrator,gototheSettings > JDBC Poolspage.
IntheFunctional Alias Definitionsarea,clickEditintheEdit Associationcolumnfora

function.
IntheAssociated Pool Aliaslist,clickthepoolyouwantthefunctiontopointto.
ClickSave Settings.IntegrationServerAdministratorreturnstotheSettings > JDBC

Poolspage.
Initializetheconnectionpool.Todoso,intheFunctional Alias Definitionsarea,click

RestartintheRestart Functioncolumnforthefunction.
MakesureIntegrationServercanconnecttothedatabase.Todoso,intheTestcolumn
forthefunction,testtheconnectionbyclicking .
IfyoucreatedaconnectionpoolfortheMywebMethodsServerdatabasecomponent
andpointedtheCentralUsersfunctionatit,gototheSettings > Resourcespageand
makesuretheMWS SAML Resolver URLfieldispointingtoyourMywebMethods
Serverhostandport.
RestartIntegrationServer.
146
Installed JDKs and Product JDK Usage

ApplinX and EntireX
ThewebMethodsInstallerinstallsaJavaDevelopmentKit1.6fortheseproducts.Donot
switchtoanyotherJDK.OnlyapplyJDKmaintenanceupdatesthatareprovidedby
Software AG.
All Other Products

ThetablebelowlistsJDKsthatareinstalledbytheinstalleroneachoperatingsystem
witheachwebMethodsproduct.
64 Bit
Servers
IntegrationServer
(andhosted
products),*
MywebMethods
Server
webMethods
BrokerJavaand
JMSAPIs
Optimizeengines
andWebService
DataCollector
Infrastructure
DataCollector,
ReportServer
Windows
Linux
64bitSun
1.6_13and
1.5_18
32bit
Sun
1.6_13
and
1.5_18
64bitSun
1.6_13
Solaris
32 Bit
HP-UX
AIX
Windows, Linux
32bitSun
1.6_13and
1.5_18with
64bit
extension
64bitHP
1.6_2and
1.5_15
64bit
IBM
1.6
SR4
and
1.5
SR9
32bitSun
1.6_13and
1.5_18
32bitSun
1.6_13with
64bit
extension
64bitHP
1.6_3
64bit
IBM
1.6
SR4
32bitSun
1.6_13
64bitHP
1.5_15
64bit
IBM
1.5
SR9
32bitSun
1.5_18
64bitSun1.5_18
*IntegrationServeralsosupports64bitMacsystems.TheinstallerdoesnotinstallaJDKonthesesystems.
However,youinstalledanappropriateJDKtoruntheinstaller,andtheinstallerautomaticallyconfigured
theproductstousethatJDK.
Bydefault,thisJDKrunsin32bitmode.Youcanswitchto64bitmode.Forinstructions,seeConfigure
RuntimeProductstoUse64BitModeonSolarisandHPUXSystemsonpage 149.
147
Tools
Windows 64 Bit
BlazeAdvisor,Designer
Developer,TradingNetworksConsole
64bitSun1.6_13and
1.5_18
Windows 32 Bit
32bitSun1.6_13
and1.5_18
Bydefault,theproductsusetheinstalledJavaDevelopmentKit1.6.Youcanredirectany
producttousetheinstalledJDK1.5,oranotherJREorJDK.Forinstructions,see
RedirectProductstoUseaNonDefaultJREorJDKonpage 149.
Important! YoushouldapplymaintenanceupdatestothewebMethodsInstallerJDK
fromtheappropriatevendoronaregularbasis,asyouwouldforJDKsyouinstall
yourself.
TheinstalledJDKscontainJavaCryptographyExtension(JCE)LimitedStrength
JurisdictionPolicyFiles5.0.IfyouwantyourwebMethodsproductstobeabletorunin
FIPSmode,orusealgorithmssuchas256bitAES,yourJVMmustuseJCEUnlimited
StrengthJurisdictionPolicyFiles5.0.DownloadthosefilesfromtheWebsiteslisted
belowandinstallthefilesusingtheinstructionsinthevendordocumentation.
JDK
Web Site
SunandHP
http://java.sun.com/javase/downloads/index_jdk5.jsp
http://java.sun.com/javase/downloads/index.jsp
IBM
http://www.ibm.com/developerworks/java/jdk/security/index.html
148
Configure Run-time Products to Use 64-Bit Mode on Solaris and

HP-UX Systems
On64bitSolarisfortheproductslistedbelow,theinstallerinstallsa32bitJDKwitha64
bitextension.Bydefault,thisJDKrunsin32bitmode.Youcanswitchto64bitmode.
Run-time Product
Steps
Integration
Server(and
hostedproducts)
GototheIntegrationServer_directory/bindirectoryandopen
theserver.shfileinatexteditor.
Locatetheline#JAVA_D64=d64anduncommentit,as
follows:
JAVA_D64=-d64
3
Optimizeengines 1
andWebService
DataCollector
2
GototheOptimize_directory/
{analysis|prediction|dataCollector}/bindirectoryandopen
thestartup{Analytic|Prediction|DataCollector}Engine.shfile
inatexteditor.
LocatethelineGLUE_OPTS=$GLUE_OPTSXss256kand
addd64,asfollows:
GLUE_OPTS="$GLUE_OPTS d64 -Xss256k"
MywebMethods
Server
GototheMywebMethodsServer_directory/bindirectoryand
openthesetenv.shfileinatexteditor.
Locatetheline{rem|#}JAVA_D64=d64anduncomment,as
follows:
JAVA_D64=-d64
Redirect Products to Use a Non-Default JRE or JDK

Bydefault,eachwebMethodsproductusestheJDKindicatedinInstalledJDKsand
ProductJDKUsageonpage 147.YoucanredirecteachproducttouseanondefaultJRE
orJDK.IfyouwanttoswitchtotheJDK1.5installedbytheinstaller,itislocatedinthe
webMethods_directory\jvmdirectory.
Note: Software AGtestswebMethodsproductsonlywiththeJDKsinstalledbythe
webMethodsInstaller.
149
Run-time Products
Product
Steps to Redirect to a Non-Default JRE or JDK
webMethods
BrokerJavaand
JMSAPIs
RequireJDK1.6or1.5.
Inthestepsbelow,commandisanycommandotherthanawbroker,
awbrokermon,server_config,orserver_qsck.
webMethods Broker_directory\bin\command -DJAVA_HOME
=JDK_path host:port
OnaWindowssystem,thecommandmightlooklikethis:
C:\Program Files\webMethods8\Broker\bin\broker_status
-DJAVA_HOME=C:\jdk1.5 localhost
OnaUNIXsystem,thecommandmightlooklikethis:
/opt/webMethods8/Broker/bin/broker_status
-DJAVA_HOME=/opt/java1.5 localhost
Integration
Server(and
hostedproducts)
Infrastructure
DataCollector
MywebMethods
Server
150
RequiresJRE1.6or1.5.IfyouareusingIntegrationServerwith
Developer,IntegrationServerrequiresJDK1.5.
GototheIntegrationServer_directory\bindirectoryandopenthe
server.batorserver.shfileinatexteditor.EdittheJAVA_DIR
parametertopointtotheJREorJDKinstallationdirectory,then
saveandclosethefile.
RequiresJRE1.5.
GototheInfrastructureDataCollector_directory\bindirectoryand
opentheserver.batorserver.shfileinatexteditor.Editthe
JAVA_DIRparametertopointtotheJREinstallationdirectory,
thensaveandclosethefile.
RequiresJDK1.6or1.5.
GototheMywebMethodsServer_directory\bindirectoryandopen
thesetenv.batorsetenv.shfileinatexteditor.Editthe
JAVA_HOMEparametertopointtotheJDKinstallationdirectory,
Product
Optimizeengines RequiresJDK1.6or1.5.
andWebService
1 Logontothehostmachineforthecomponent.
DataCollector
2 GototheOptimizedirectory\component\bindirectoryandopen
thekenobiEnv.batorkenobiEnv.shfileinatexteditor.
ReportServer
EdittheJAVA_HOMEparametertopointtotheJDK
installationdirectory,thensaveandclosethefile.
IftheengineswereinstalledasWindowsServices,dothe
followingforeach:
a
GototheOptimizedirectory\component\bindirectoryand
openthewrapper.conffileinatexteditor.
Editthewrapper.java.commandpropertytopointtothe
JDK_directory/bin/javaexecutable.
Editthewrapper.java.classpath.1propertytopointtothe
JDK_directory/lib/tool.jarlibrary.
Saveandclosethefile
RuntheuninstallNTsvc.batprogram.
RuntheinstallNTsvc.batprogram.
RequiresJRE1.5.
GotothewebMethods_directory\cognos\c8\binorbin64directory,
asappropriateforyoursystem,andopenthestartup.bator
startup.shfileinatexteditor.EdittheJAVA_HOMEparameterto
pointtotheJREinstallationdirectory,thensaveandclosethefile.
151
Development Products
Product
BlazeAdvisor
RequiresJRE1.6or1.5.Youcannotredirectitfromthedefault.
Designer,
Developer(and
plugins)
RequireJRE1.6or1.5.
Trading
Networks
Console
Gotothe{Designer|Developer}_directory\bindirectoryandopen
the{designer|developer}.batfileinatexteditor.Editthe
JAVA_DIRparametertopointtotheJREinstallationdirectory,
RequiresJRE1.6or1.5.
GototheTradingNetworksConsole_directory\bindirectoryand
opentheconsole.batfileinatexteditor.EdittheJAVA_ROOT
parametertopointtotheJREinstallationdirectory,thensaveand
closethefile.
Note: WhenyoulaunchDeveloperfromTradingNetworks
Console,DeveloperrunsinthesameJVMasTradingNetworks
Console.IfyoudecidetouseadifferentJREforTradingNetworks
Console,theJREmustbesuitableforDeveloperaswellasTrading
NetworksConsole.
152
10
Uninstalling Products
Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
154
Uninstall ApplinX and EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
155
Uninstall Designer Plug-ins or Eclipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
157
Uninstall All Other Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
157
153
10 Uninstalling Products
Before You Begin

ShutdowntheSoftware AGproductsbelowiftheyarerunningonthemachine.
OnaWindowssystem,shutdowntheproductsasfollows:
Products to Shut Down
Method
ApplinX,EntireX,MywebMethodsServer(and
TaskEngine),OptimizeAnalyticEngineand
PredictionEngine,ReportServerwheninstalled
asapplications
UseWindowsStartmenu
(Start > Programs > Software AG >
webMethods > Stop Servers>
product)
BrokerMonitor(whichstopsBrokerServers),
SystemManagementHub*,TomcatKit,andJava
DevelopmentPackage1.6
UseWindowsServices
window(Software AG
webMethodsproductrelease
ApplinX,MywebMethodsServer(andTask
Engine),OptimizeAnalyticEngineand
PredictionEnginewheninstalledasservices
ReportServerwheninstalledasservice
Runscript(seeproduct
documentation)
Developer,Designer,IntegrationServer(andthe
productsithosts),InfrastructureDataCollector
Fromproductinterface(see
productdocumentation)
*SystemManagementHubservicesarenamedSoftware AGCSLayerServiceandEventLayerService.
TomcatKitservicenameisSoftware AGCommonTomcatPackage8.0.
JavaDevelopmentPackageservicenameisSoftware AGcommonJavaPackage1.6.
OnaUNIXsystem,shutdowntheproductslistedaboveusingthecommands
providedintheproductdocumentation.
AlsoshutdownallnonSoftware AGapplicationsthatarerunningonthemachine.
Important! IfyoudonotshutdowntheSoftware AGproductslistedaboveandnon
Software AGapplications,theuninstallerwillnotbeabletoremovekeyfilesthatare
lockedbytheoperatingsystem.
154
Uninstall ApplinX and EntireX

Uninstall on a Windows System
1
OpentheWindowsAdd or Remove Programsutility.UninstalltheSoftware AGEntireX

MiniRuntimeand,ifpresent,thewebMethodsEntireX.NETWrapperWizardand
webMethodsEntireXDCOMWrapperVisualStudioAddin.
UninstallApplinXandEntireXusingtheinstructionsinUninstallAllOther
Productsonpage 157.
WhenApplinXandEntireXnolongerexistonthemachine,youcanuninstalltheir
sharedcomponents.Uninstallthecomponentsintheordertheyarelistedbelow,
usingtheindicatedmethod.
a
UninstallWebServicesStackusingtheinstructionsinUninstallAllOther
Productsonpage 157.
OpentheWindowsAdd or Remove Programsutility.UninstallSystemManagement

Hub,thenuninstallTomcatKit,andthenuninstallJavaDevelopmentKit.
Important! Youmustuninstallthecomponentsintheindicatedorder,oryou
willexperienceunpredictableresults.
CleanupspaceconsumingfilesbyrunningthewebMethodsUninstallerand
selectingSystemManagementHub,TomcatKit,andJavaDevelopmentKit.For
instructions,seeUninstallAllOtherProductsonpage 157.
ThewebMethodsUninstallerdoesnotdeletefilesthatwerecreatedafteryou
installedthecomponents(forexample,usercreatedorconfigurationfiles),nordoesit
deletethedirectorystructurethatcontainsthefiles.Ifyoudonotwanttosavethese
filesanddirectories,deletethecomponentinstallationdirectory.
Uninstall on a UNIX System

1
IfyouarenotgoingtorunthewebMethodsUninstallerwithsudoprivileges,you
mustremovetheEntireXdaemonmanually.Todoso,gotothe
EntireX_directory/INSTALLdirectoryandrunthescriptuninstall_etbsrv_deamon
withsudoprivileges.OnLinux,alsodeletethe/etc/ssxsrv.pamdfile.
Note: Youdonothavetoresetthesbit;therelevantfilesaredeletedduring
uninstallation.
UninstallApplinXandEntireXusingtheinstructionsinUninstallAllOther
Productsonpage 157.
155
WhenApplinXandEntireXnolongerexistonthemachine,youcanuninstalltheir
sharedcomponents.Uninstallthecomponentsintheordertheyarelistedbelow,
usingtheindicatedmethod.
a
UninstallWebServicesStackusingtheinstructionsinUninstallAllOther
Productsonpage 157.
UninstallSystemManagementHub,TomcatKit,andJavaDevelopmentKit1.6as
follows:
1
OpenaBourneshell.
Setthe$SAGenvironmentvariabletopointtotheinstallationdirectorythat
containsthesharedcomponents.Bydefault,thisdirectoryis/opt/softwareag.
SourcetheSoftware AGenvironmentscriptsagenv.newusingtheshell
command. $SAG/sagenv.new.Thescriptislocatedintheinstallationdirectory
thatcontainsthesharedcomponents.Bydefault,thatdirectoryis
/opt/softwareag.
RuntheSoftware AGuninstallationutility,sagrm,touninstallSystem
ManagementHub.
RunsagrmtouninstallTomcatKit(CommonTomcatPackage).
RunsagrmtouninstallJavaDevelopmentKit1.6(CommonJavaPackage
v16).
Important! Youmustuninstallthecomponentsintheindicatedorder,oryou
willexperienceunpredictableresults.
CleanupspaceconsumingfilesbyrunningthewebMethodsUninstallerand
selectingSystemManagementHub,TomcatKit,andJavaDevelopmentKit1.6.For
instructions,seeUninstallAllOtherProductsonpage 157.
installedthecomponent(forexample,usercreatedorconfigurationfiles),nordoesit
filesanddirectories,deletethecomponentinstallationdirectory.
156
Uninstall Designer Plug-ins or Eclipse

IfyouwanttouninstallspecificDesignerpluginswithoutuninstallingyour
Software AGsupportedEclipse,usetheEclipseUpdateManager.
Important! DonotuninstallDesignerpluginsthatarerequiredbyotherDesigner
plugins,orthedependentDesignerpluginswillstopworking.Toview
dependencies,runthewebMethodsInstaller,selectyourpluginsontheproduct
selectiontree,andobservewhichotherpluginsareautoselectedbytheinstaller.
IfyouwanttouninstallyourSoftware AGsupportedEclipse,usetheinstructionsin
UninstallAllOtherProductsonpage 157andselectDesigner>Eclipseontheproduct
selectiontree.Afteruninstallationiscomplete,gotoyourSoftware AGinstallation
directoryanddeletetheEclipsefolder.
Uninstall All Other Products

YouuninstallmostwebMethodsproductsusingthewebMethodsUninstaller.The
webMethodsUninstallerwasautomaticallydownloadedwiththewebMethodsInstaller.
Youcanruntheuninstallerusingdifferentmodes,asfollows:
System
Mode
Windows
Wizard
UNIXorMac
Wizard*orconsolemode
*TouninstallusingthewizardonaUNIXsystem,yoursystemmusthaveanXWindowsenvironment.
Iferrorsorwarningsoccurduringtheuninstallation,thewebMethodsUninstallerwrites
themtoafilenamedWmUninstallLog.txtandstoresthefileinthewebMethods_directory/
install/logsdirectory.Ifyouareusingconsolemode,youcanchangeloggingbehavior;
seeChangeLoggingLevelandFile,andAddTargetsonpage 56orpage 82for
instructions.
Uninstall on a Windows System

TouninstallwebMethodsproductsonaWindowssystem,youmusthaveWindows
systemadministratorprivileges.
1
ThewebMethodsUninstallerwilldeleteallfilesexceptthewebMethodsInstaller
maintainedhistory.txtfilefromthewebMethods_directory/installand/jvm
subdirectories.Ifyouhavestoredyourownfilesineitherofthosesubdirectoriesand
wanttokeepthem,movethosefilestoanonwebMethodsdirectory.
OpentheWindowsAdd or Remove ProgramsutilityandselectSoftware AG

webMethods8.0installationdirectory.ThewebMethodsUninstallerstarts;itlooks
almostidenticaltothewebMethodsInstaller.
157
Ontheproductselectiontree,choosetheproductstouninstall.
Important! Whenyouchooseaproduct,thewebMethodsUninstalleraskswhether
itshouldalsouninstallallproductsthatdependontheproduct.Readthe
messagescarefullytoavoidaccidentallyuninstallingproductsyouwanttokeep.
installedtheproduct(forexample,usercreatedorconfigurationfiles),nordoesit
filesanddirectories,deletetheproductinstallationdirectory.
Uninstall on a UNIX or Mac System

1
LogonasthesameuserthatinstalledthewebMethodsproducts.
IfthewebMethodsproductsyouareuninstallingarelocatedonaremotemachine
andyouwanttousethewebMethodsUninstallerwizard,followthesesteps:
a
Enablethedisplayofthelocalmachineusingthecommandshownbelow,where
remote_hostistheremotemachinefromwhichtouninstall:
xhost +remote_host
LogontotheremotemachineandsettheDISPLAYvariableontheremote
machinetopointtothelocalmachine.Forexample,ifyouareusingaBashshell,
areuninstallingfromalocalmachinenameduninstaller,andwanttosetthe
displaytothedefaultdevice,enter:
export DISPLAY=uninstaller:0.0
IfyouaregoingtouninstallallwebMethodsproductsfromthelocalmachine,the
webMethodsUninstallerwilldeleteallfilesexceptthewebMethodsInstaller
maintainedhistory.txtfilefromthewebMethods_directory/installand/jvm
subdirectories.Ifyouhavestoredyourownfilesineitherofthosesubdirectoriesand
wanttokeepthem,movethosefilestoanonwebMethodsdirectory.
GotothewebMethods_directory/bindirectoryandentertheappropriatecommand,as
follows:
Uninstall Mode
Command
Wizard
uninstall
Consolemode
uninstall -console
ThewebMethodsUninstallerstarts;itlooksalmostidenticaltothewebMethods
Installer.
158
Choosetheproductstouninstall.
Important! Whenyouchooseaproduct,thewebMethodsUninstalleraskswhether
itshouldalsouninstallallproductsthatdependontheproduct.Readthe
messagescarefullytoavoidaccidentallyuninstallingproductsyouwanttokeep.
installedtheproduct(forexample,usercreatedorconfigurationfiles),nordoesit
filesanddirectories,deletetheproductinstallationdirectory.
Complete the webMethods Broker Uninstallation on UNIX Systems

OnaUNIXsystem,ifyouconfiguredyourBrokerMonitortorunasadaemonsoit
wouldstartandshutdownautomaticallywhenyoursystemstartsandshutsdown,you
movedtheBrokerMonitorstartupscripttotheappropriateUNIXstartupdirectory.The
scriptisnamedSnumberbroker80(forexample,S45broker80).Ifyouconfiguredmultiple
BrokerMonitorstorunasdaemons,youmovedmultiplestartupscripts,andthenames
willhaveanadditionalcharacterattheendtomakethemunique(forexample,
S45broker80_1,S45broker80_2,andsoon).YoucandeletethesescriptsfromtheUNIX
startupdirectories.
Complete the Deployer Uninstallation

IfyouuninstalledDeployer,uninstalltheDeployercommunicationscomponentfromthe
DeployerssourceandtargetIntegrationServersandProcessModelservers.Ifthe
IntegrationServerisnotrunning,gototheIntegrationServer_directory/packagesdirectory
anddeletetheWmDeployerResourcedirectory.IftheIntegrationServerisrunning,open
IntegrationServerAdministrator,gotothePackages > Managementpage,anddeletethe
WmDeployerResourcepackage.
159
160
Default Ports
Product
Default Port
Protocol
ServerportsforcommunicationswithDesigner,
ApplinXJavaand.NETframeworksbasedobjects,
andApplinXJavaand.NETprocedureclientsfor
SOA.
2323
23443*
TCP
SecuredTCP
HTTPserverportforcommunicationwithclients
2380
HTTP
InternalAdministrationport
2305
TCP
InternalAJPport
2309
AJP/1.3
BrokerServerports
6849
6848
6847
TCP
DefaultBrokerport
6849
TCP
BrokerMonitorport
6850
TCP
1600016025
HTTP
EntireXDefaultBrokerport
1971
TCP
EntireXDefaultBrokerSSLport
1958
TCP
EntireXBrokeragentadministrationport
3000
TCP
EntireXBrokeradministrationserviceport
57707
57708**
TCP
TCP
Primaryport
5555
HTTP
Diagnosticsport
9999
HTTP
Dataportforcommunicationamongclustered
IntegrationServers
24547
Proprietary
binaryoverTCP
ApplinX Server
webMethods Broker
Central Configuration
EntireX
Integration Server and all packages
*SSLauthentication.
Oneway,serveronly,SSLauthentication.
Twoway,clientandserver,SSLauthentication.
**SSLenabled.
161
A Default Ports
Product
Default Port
Protocol
Javadebuggerport(availablewhenMy
webMethodsServerisstartedwith
doption)
5000
TCP
JettyHTTPWebserverport(forcommunication
betweenwebMethodsproductandtheiruser
interfacesonMywebMethodsServer,andfor
usersandclientstocallWebservices)
8585
HTTP
CommunicationwithCentralConfiguration
15002
HTTP
CentralConfigurationport
15000
HTTP/HTTPS
InternalWebserviceregistryport
12503
HTTP
15003
HTTP/HTTPS
12513
HTTP
15001
HTTP/HTTPS
12603
HTTP
6666
HTTP
15005
HTTP/HTTPS
Diagnosticsport
6699
HTTP
9300
HTTP
Tomcatshutdownport
49983
Tomcat
CommunicationwithCentraSiteControlandall
otheruserinterfacepluginstoSystem
ManagementHub
49982
49981
HTTPS
HTTP
CSLayerports
49900
49901
49903
Proprietary
HTTP
SNMP
Optimize
Analytic Engine
Prediction Engine
Web Service Data Collector
Infrastructure Data Collector
Report Server
System Management Hub
*SSLauthentication.
**SSLenabled.
162
A Default Ports
Product
Default Port
Protocol
EventLayerports
49902
49904
Proprietary
SNMP
MiLayerport
49992
SNMP
WSstackWebapplication(Axis2servlet).Usesthe
HTTPandHTTPSconnectorsconfiguredforthe
containerbydefault.Defaultcontaineris
Software AGTomcat.
49981
49982
HTTP
HTTPS
SimpleHTTPServer.Canbeusedasstandalone
hostforWebServicesStackservices;typicallyused
whenaWebserviceisinvokedasynchronously
andtheresponserequiresaseparatetransport
listener.Disabledbydefault.
8080
HTTP
JMStransportlistener;Javanamingproviderused
byJMS.Disabledbydefault.
61616
TCP
TCPtransportlistener.Disabledbydefault.
6060
TCP
NonblockingHTTPtransportbasedon
HttpCore+NIOextensions.Disabledbydefault.
9000
HTTP
NonblockingHTTPStransportbasedon
HttpCore+SSLNIOextensions.Disabledby
default.
9002
HTTPS
Web Services Stack
*SSLauthentication.
**SSLenabled.
163
A Default Ports
164

8-0fcs WebMethods Installation Guide

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

8-0fcs WebMethods Installation Guide

Încărcat de

Drepturi de autor:

Formate disponibile

TitlePage

Document ID: WEBM-IG-80-20090629

webMethods Installation Guide Version 8.0

3. Software and Hardware Support and Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . .

4. International Operating Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5. Preparing for Product Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6. Using the Wizard to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

webMethods Installation Guide Version 8.0

7. Using Console Mode to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8. Creating and Dropping Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

webMethods Installation Guide Version 8.0

Use the Database Component Configurator Graphical User Interface . . . . . . . . . . . . . . . .

9. Completing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

webMethods Installation Guide Version 8.0

Connect Products to Each Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10. Uninstalling Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

A. Default Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

webMethods Installation Guide Version 8.0

webMethods Installation Guide Version 8.0

About This Guide

webMethods Installation Guide Version 8.0

About This Guide

webMethods Installation Guide Version 8.0

About This Guide

webMethods Central Documentation Directory

webMethods Advantage Bookshelf

Software AG Developer Community

webMethods Installation Guide Version 8.0

About This Guide

webMethods Installation Guide Version 8.0

Composite Applications Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

webMethods Installation Guide Version 8.0

Broker and JMS UI

webMethods Installation Guide Version 8.0

Install this product...

Composite Applications Development

webMethods Installation Guide Version 8.0

webMethods Installation Guide Version 8.0

Install this product...

webMethods Installation Guide Version 8.0

webMethods Installation Guide Version 8.0

Broker and JMS UI

webMethods Installation Guide Version 8.0

webMethods Installation Guide Version 8.0

Integration Server Data Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Product Database Component Descriptions and Installation Requirements . . . . . . . . . . . . . . . .

Infrastructure Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

webMethods Installation Guide Version 8.0

Integration Server Data Storage

webMethods Installation Guide Version 8.0

webMethods Installation Guide Version 8.0

webMethods Installation Guide Version 8.0

Product Database Component Descriptions and Installation

Analysis Database Component

Archive Database Component

webMethods Installation Guide Version 8.0

Blaze Database Component

BPEL Database Component

Cross Reference, Document History, IS Internal, and IS Core Audit

My webMethods Server Database Component

webMethods Installation Guide Version 8.0

Process Audit Log Database Component

Process Engine Database Component

webMethods Installation Guide Version 8.0