You are on page 1of 164

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

webMethods Installation Guide Version 8.0

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 Optimize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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

webMethods Installation Guide Version 8.0

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configure Optimize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

Table of Contents

webMethods Installation Guide Version 8.0

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.

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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.

webMethods Installation Guide Version 8.0

11

About This Guide

12

webMethods Installation Guide Version 8.0

Development Environments

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14

Integration Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

14

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

15

Process Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17

Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

18

Deployer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

20

ApplinX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

20

EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

20

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

1 Development Environments

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
DatabaseComponentConfigurator
Documentation

Designer

My webMethods Server

database

Thetablebelowliststhedatabasecomponentsyoumustorcanincludeinacomposite
applicationdevelopmentenvironment.Thedatabasecomponentsareversioned
differentlythantheproducts.

webMethods Installation Guide Version 8.0

15

1 Development Environments

Product

Database Components

See

MywebMethodsServer

MywebMethodsServerv30

ProductDatabaseCom
ponentDescriptionsand
InstallationRequire
mentsonpage 25

Ifyouwantyourcompositeapplicationstocallservicesavailablethroughotherproducts
inthewebMethodsproductsuite,addthefollowing:
DesignerESBandIntegrationServerDevelopmentplugin
BlazeAdvisor
IntegrationServerwithBlazeRuleServiceSupportandMonitor
MywebMethodsuserinterfaceforBlazeandMonitor

Blaze Advisor

Integration Server

Designer

Blaze

Monitor

Monitor UI
Blaze UI

database

My webMethods Server

Product

Database Components

See

Blazeuserinterface

Blazev10

ProductDatabaseComponent
DescriptionsandInstallation
Requirementsonpage 25

IntegrationServer

ISCoreAuditLogv25
ISInternalv30
Archivev30

IntegrationServerDataStorage
onpage 22

16

webMethods Installation Guide Version 8.0

1 Development Environments

Process Design
DesignerEclipsewithBusinessProcessesDevelopmentandSimulation,Composite
ApplicationsTaskDevelopment,andESBandIntegrationServerDevelopmentplug
ins
DeveloperwithBlazeRuleServiceplugin
BlazeAdvisor
IntegrationServerwithBlazeRuleServiceSupport,Monitor,ProcessEngine,and
OptimizeSupport
MywebMethodsServerwithTaskEngine,andMywebMethodsuserinterfacefor
BlazeandMonitor
DatabaseComponentConfigurator
Documentation

Developer
Integration Server

Blaze Advisor
Designer

Process Engine

Blaze

Monitor

database

Monitor UI
Blaze UI
Task Engine
My webMethods Server

Belowareadditionaloptions.
If you want to...

Install this product...

StoreIntegrationServerkeysand
certificatessecurely

IntegrationServerPKISupportpackage

MaintainDeveloperelementsinMicrosoft
VisualSourceSafe,IBMRational
ClearCase,orCollabNetInc.Subversion

IntegrationServerVSS,ClearCase,or
SubversionSupport

webMethods Installation Guide Version 8.0

17

1 Development Environments

Thetablebelowliststhedatabasecomponentsyoumustorcanincludeinaprocess
designenvironment.Thedatabasecomponentsareversioneddifferentlythanthe
products.
Product

Database Components

IntegrationServer

ISCoreAuditLogv25
ProcessAuditLogv40
ISInternalv30
Archivev30

IntegrationServerData
Storageonpage 22

Blazeuserinterface

Blazev10

BPELplugintoDesigner

BPELv10

MywebMethodsServer

MywebMethodsServerv30

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
DatabaseComponentConfigurator
Documentation

18

webMethods Installation Guide Version 8.0

1 Development Environments

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

My webMethods 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

webMethods Installation Guide Version 8.0

MywebMethodsServerv30

19

1 Development Environments

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

webMethods Installation Guide Version 8.0

Data Storage

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

22

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

25

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

30

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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.

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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.

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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.

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

3 Software and Hardware Support and Requirements

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.

webMethods Installation Guide Version 8.0

33

3 Software and Hardware Support and Requirements

All Other Products


Product

Hard Drive Space


(MB)

InfrastructureSharedLibraries

200

BlazeAdvisor

RAM (MB)

CPUs

200

1024(2048)

webMethodsBroker

750(1250)

512(2048)

DatabaseComponentConfigurator

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)

InfrastructureDataCollector

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

webMethods Installation Guide Version 8.0

3 Software and Hardware Support and Requirements

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.

webMethods Installation Guide Version 8.0

35

3 Software and Hardware Support and Requirements

36

webMethods Installation Guide Version 8.0

International Operating Environments

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

38

Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

38

Extended Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

38

Configure Browsers and JDK Font . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

39

Configure the Proper Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

39

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

4 International Operating Environments

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.

webMethods Installation Guide Version 8.0

39

4 International Operating Environments

System

Steps

UNIX

SetyourshelltotheproperlocalebysettingtheLANGenvironment
variable.Runtheappropriatecommandbelow:

40

Shell

Command

sh

LANG=locale; export LANG

csh

setenv LANG locale

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

5 Preparing for Product Installation

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.

webMethods Installation Guide Version 8.0

43

5 Preparing for Product Installation

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

webMethods Installation Guide Version 8.0

5 Preparing for Product Installation

Usetheinstructionsprovidedintheproductdocumentationtoshutdownthe
Software AGproductsbelowiftheyarerunningonthemachineonwhichyouare
goingtoinstall:
ApplinX
BrokerMonitor(alsostopsBrokerServers)
EntireX

OptimizeAnalyticEngine,
PredictionEngine,and
InfrastructureDataCollector
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:

webMethods Installation Guide Version 8.0

45

5 Preparing for Product Installation

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

webMethods Installation Guide Version 8.0

5 Preparing for Product Installation

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.

webMethods Installation Guide Version 8.0

47

5 Preparing for Product Installation

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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

49

6 Using the Wizard to Install

Overview
ThischapterexplainshowtodothefollowingonanysystemusingthewebMethods
Installerwizard:
InstallwebMethodsproducts
CreateaninstallationscriptorimagefromwhichtoinstallwebMethodsproducts
InstallwebMethodsproductsfromaninstallationscriptorimage
Theinstallerwritesanyerrorsorwarningsthatoccurduringinstallationtoafilenamed
WmInstallLog.txtinthewebMethods_directory/install/logsdirectory.Ifnecessary,youcan
changeloggingbehavior.Forinstructions,seeChangeLoggingLevelandFile,andAdd
Targetsonpage 56orpage 82.
Theinstallerwritesproduct,version,andbuildinformationtoanaudithistorylogfile
namedhistory.txtinthewebMethods_directory\install\historydirectory.

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.

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

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.
Thewayyoustarttheinstallerdependsonthetaskyouwanttoperform,asindicated
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
-jar webMethodsInstaller801.{jar|zip}

Tohavetheinstalleruseadifferenttemporarydirectorythanthedefault,runthis
command:
java -Xmx512m -Xincgc -Djava.io.tmpdir=different_temp_directory
-jar webMethodsInstaller801.{jar|zip}

webMethods Installation Guide Version 8.0

51

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

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.

webMethods Installation Guide Version 8.0

53

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

55

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

Specify Release, User Name, and Password

IntheReleaselist,clickwebMethods 8.x.ProvideyourwebMethodsAdvantageusername
andpassword.ClickNext.Theinstallerusestheusernameandpasswordtoconnectto
thewebMethodsserveranddownloadthewebMethodsproductsforwhichyouhave
purchasedlicenses.

webMethods Installation Guide Version 8.0

57

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

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.

webMethods Installation Guide Version 8.0

59

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

Select Language Packs


Iflanguagepacksareavailableforproductsyouareinstallingorhavealreadyinstalled,
theinstallerdisplaysthelanguagepackspanel.

ManywebMethodsproductssupportmultiplelanguages.Youcaninstallasmany
languagepacksasyouwant,andallofthelanguagesinstalled(includingthedefault,U.S.
English)willbeavailabletousers.
Selectthelanguagepackstoinstall,andthenclickNext.

webMethods Installation Guide Version 8.0

61

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

Configure Trading Networks Server

connection from Trading


Networks Server to Trading
Networks database component

webMethods Installation Guide Version 8.0

63

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

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.

webMethods Installation Guide Version 8.0

65

6 Using the Wizard to Install

Configure Infrastructure Data Collector

can supply at startup instead


Windows only

OptimizeprovidesaCentralConfigurationuserinterfacethatallowsyoutoconfigure
Optimizecomponentsfromacentralmachine.Specifytheportyouwanttheinterfaceto
usetocommunicatewiththeOptimizeInfrastructureDataCollector.Theportmustbe
unique.IfyouinstallmultipleinstancesoftheInfrastructureDataCollectoronthesame
machine,theportforeachinstancemustbeunique.

66

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

Configure webMethods Broker

if multiple Broker Monitor


instances on same machine, use
unique port for each instance

Broker Server uses this port for


non-SSL and previous two ports for
SSL; if multiple Broker Server
instances on same machine, use
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.

webMethods Installation Guide Version 8.0

67

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

Configure Designer
Important! YoucaninstallDesignerpluginsofferedonthewebMethodsInstallerinto
onlytheDesignerEclipseofferedonthewebMethodsInstaller.
IfyouselectedDesignerpluginsontheproductselectiontree,andnoDesignerEclipse
existsonyourmachine,theinstallerautomaticallyinstallstheDesignerEclipsewiththe
pluginswithoutdisplayingthispanel.
IfyouselectedDesignerpluginsontheproductselectiontree,andoneormoreDesigner
Eclipsesalreadyexistonyourmachine,theinstallerdisplaysthispanelsoyoucanchoose
theDesignerEclipseintowhichtoinstall.
IfoneormoreDesignerEclipsesalreadyexistonyourmachinebutnotinthecurrent
webMethodsinstallationdirectory,theinstallerdisplaysthispanelsoyoucanchoose
eithertoinstallintoanexistingDesignerEclipseandtoinstallanewDesignerEclipse
andthepluginsinthecurrentdirectory.

webMethods Installation Guide Version 8.0

69

6 Using the Wizard to Install

Configure My webMethods Server

Windows only

database connection between


My webMethods Server and
My webMethods Server
database component

70

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

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.

webMethods Installation Guide Version 8.0

71

6 Using the Wizard to Install

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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

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.

webMethods Installation Guide Version 8.0

73

6 Using the Wizard to Install

ApplinX
IfyouareinstallingtheApplinXServer,theinstallerdisplaysthepanelbelow.

full path to ApplinX license file


Windows only
see below

if multiple ApplinX Server


instances on same machine, use
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

webMethods Installation Guide Version 8.0

6 Using the Wizard to Install

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.

webMethods Installation Guide Version 8.0

75

6 Using the Wizard to Install

Review and Install

Reviewthelistofproductsanditemsyouhaveselectedforinstall.Ifthelistisnotcorrect,
clickBackuntilyoureachthepanelonwhichyouchosetheproductstoinstallandcorrect
thechoices.Ifthelistiscorrect,clickNext.Theinstallerinstallstheproductsandrelated
items,thendisplaystheinstallationcompletepanel.ClickClose.

76

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

77

7 Using Console Mode to Install

Overview
ThischapterexplainshowtodothefollowingonaUNIXorMacsystemusing
webMethodsInstallerconsolemode:
InstallwebMethodsproductsfromtheinstaller
CreateaninstallationscriptorimagefromwhichtoinstallwebMethodsproducts
InstallwebMethodsproductsfromaninstallationscriptorimage.
Theinstallerwritesanyerrorsorwarningsthatoccurduringinstallationtoafilenamed
WmInstallLog.txtinthewebMethods_directory/install/logsdirectory.Ifnecessary,youcan
changeloggingbehavior.Forinstructions,seeChangeLoggingLevelandFile,andAdd
Targetsonpage 56orpage 82.
Theinstallerwritesproduct,version,andbuildinformationtoanaudithistorylogfile
namedhistory.txtinthewebMethods_directory\install\historydirectory.

Start the webMethods Installer


Logonasanonrootuser.Theuserunderwhichyoulogonwillownallfilesyouinstall.
Important! IfyouaregoingtoinstallApplinXorEntireX,theusermusthavewrite
accesstothedirectoryfromwhichyoustarttheinstaller.Donotruntheinstallerasa
backgroundprocess.
Thewayyoustarttheinstallerdependsonthetaskyouwanttoperform,asindicated
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

webMethods Installation Guide Version 8.0

7 Using Console Mode to Install

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.

webMethods Installation Guide Version 8.0

79

7 Using Console Mode to Install

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

webMethods Installation Guide Version 8.0

7 Using Console Mode to Install

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.

webMethods Installation Guide Version 8.0

81

7 Using Console Mode to Install

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

webMethods Installation Guide Version 8.0

7 Using Console Mode to Install

Specify the Installation Directory


Theusernameunderwhichyouarerunningtheinstallermusthavefullreadandwrite
permissionstotheinstallationdirectoryyouspecify.
ApplinXandEntireXrequireandsharesomeorallthesesupportingcomponents:System
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.

webMethods Installation Guide Version 8.0

83

7 Using Console Mode to Install

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

webMethods Installation Guide Version 8.0

7 Using Console Mode to Install

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

jdbc:wm:oracle://server:{1521|port};serviceName=service
;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]...

webMethods Installation Guide Version 8.0

85

7 Using Console Mode to Install

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

webMethods Installation Guide Version 8.0

7 Using Console Mode to Install

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.

webMethods Installation Guide Version 8.0

87

7 Using Console Mode to Install

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

webMethods Installation Guide Version 8.0

7 Using Console Mode to Install

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
ApplinXandEntireXrequireandsharesomeorallthesesupportingcomponents:System
ManagementHub,TomcatKit,andJavaDevelopmentKit1.6.
1

Ifnosharedcomponentsexistonthemachine,theinstallerpromptsforinformation
aboutwheretoinstallthesharedcomponents.Specifyadirectoryotherthanthe
webMethodsinstallationdirectory.Theusernameunderwhichyouarerunningthe
installermusthavefullreadandwritepermissionstothedirectoryyouspecify.
Ifsharedcomponentsfromthisreleaseorapreviousreleaseexistonthemachine,
specifythedirectorythatcontainstheexistingsharedcomponents.Iftheshared
componentsarefromapreviousrelease,theinstallerupgradesthem.

webMethods Installation Guide Version 8.0

89

7 Using Console Mode to Install

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

webMethods Installation Guide Version 8.0

7 Using Console Mode to Install

Review and Install


Reviewthelistofproductsyouhavechosentoinstall.Ifthelistiscorrect,pressENTER.
Theinstallerinstallstheproductsandrelateditems.

webMethods Installation Guide Version 8.0

91

7 Using Console Mode to Install

92

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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.

webMethods Installation Guide Version 8.0

95

8 Creating and Dropping Database Components

SQL Server
webMethodsdatabaseschemasforSQLServerusenchardatatypes.SQLServer
providessupportforUTF16throughitsnchardatatypes.Sincenchardatatypesare
alwaysinUTF16,youdonothavetoperformanyspecialdatabaseconfigurationandcan
choosethemostappropriatecodepageforyourenvironmentasadatabasecharacterset.
Software AGrecommendsthesecharactersetsandsortorder:
For...

Software AG recommends...

Characterset

Theappropriateencodingforthelanguagesyourdataisin.

Ncharcharacterset

UTF16

Sortorder

Anycaseinsensitivecollationtype.
Important! Ifyoudonotchooseacaseinsensitivesortorder,
youwillnotbeabletocreatesomedatabasecomponentsin
SQLServer.

Youcancheckthedatabaseconfigurationusingthesp_helpdbdatabasestoredprocedure.

DB2
webMethodsdatabaseschemasforDB2usecharacterdatatypes.DB2supportsUTF8for
characterdatatypesandUTF16forgraphicdatatypes.Software AGrecommendsthese
charactersetsandsortorder:
For...

Software AG recommends...

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

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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.

webMethods Installation Guide Version 8.0

97

8 Creating and Dropping Database Components

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

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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.

webMethods Installation Guide Version 8.0

99

8 Creating and Dropping Database Components

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

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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.

webMethods Installation Guide Version 8.0

101

8 Creating and Dropping Database Components

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.

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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.

webMethods Installation Guide Version 8.0

103

8 Creating and Dropping Database Components

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.

OntheStartmenu,gotoPrograms > Software AGwebMethods > Tools > Database


Component Configurator 8.0.

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.

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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.

ClickExecute.TheexecutioninformationisdisplayedontheResultstabandiswritten
tothelogfiledcc_yyyymmddHHMMssinthewebMethods_directory\common\db\logs
directory.

Drop the Storage and Revoke Database User Permissions


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

OntheStartmenu,gotoPrograms > Software AGwebMethods > Tools > Database


Component Configurator 8.0.

IntheActionlist,clickdrop.

IntheDatabase componentlist,clickALL.

IntheConnectionarea,specifytheconnectionfortheconfiguratortousetoconnectto
theRDBMS,asfollows:
Field

Do this...

RDBMS

ClicktheRDBMSfromwhichtodropthedatabasecomponents.

URL

TypetheURLfortheRDBMS.(SampleURLformatsforthe
DataDirectConnectJDBC4.0driveraredisplayed.)

User IDand
Password

Specifythedatabaseuserandpasswordtousetoconnecttothe
RDBMS.

webMethods Installation Guide Version 8.0

105

8 Creating and Dropping Database Components

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.

ClickExecute.TheexecutioninformationisdisplayedontheResultstabandiswritten
tothelogfiledcc_yyyymmddHHMMssinthewebMethods_directory\common\db\logs
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

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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.

webMethods Installation Guide Version 8.0

107

8 Creating and Dropping Database Components

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

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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

webMethods Installation Guide Version 8.0

109

8 Creating and Dropping Database Components

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}
;databaseName=database [;option=value]...

DB2forLinux,
UNIX,
Windows

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

DB2foriSeries

jdbc:wm:db2://server:{446|port}
;locationName=location [;option=value]...

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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.

webMethods Installation Guide Version 8.0

111

8 Creating and Dropping Database Components

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.
Ifyouaregoingtodropstorageandrevokethedatabaseuser
permissionsorDB2forLUWorOracle,identifythedirectory
thatcontainsthetablespacestodrop.

[-n|--dbname]

IfyouaregoingtocreateadatabaseuserandstorageinSQL
Server,nameofthetargetdatabase.
Ifyouaregoingtodropstorageandrevokethedatabaseuser
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

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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
-l jdbc:wm:oracle://DBserver:1521;serviceName=myservicename
-au adminuser -ap adminpass -u webmuser -p w3bmpass -t tablespace_dir
-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

webMethods Installation Guide Version 8.0

113

8 Creating and Dropping Database Components

ThiscommandcreatesthewebMethodsbufferpoolandtablespaceswithcustomnames,
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
-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
-l jdbc:wm:oracle://DBserver:1521;serviceName=myservicename
-au adminuser -ap adminpass -u webmuser -p w3bmpass -t tablespace_dir

ThiscommanddropsthetwowebMethodstablespaceswithcustomnamesforOracle:
dbConfigurator.bat -a drop -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
-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
-l jdbc:wm:db2://vmxpdb01:50000;databaseName=amol -u webmuser
-au adminuser -ap admin_password -t tablespace_dir

ThiscommanddropsthewebMethodsbufferpoolandtablespaceswithcustomnames,
andrevokespermissionsforDB2:
dbConfigurator.bat -a drop -d db2luw -c storage -v latest
-l jdbc:wm:db2://vmxpdb01:50000;databaseName=amol -u webmuser
-au adminuser -ap admin_password -t tablespace_dir
-tsdata MYDATA -tsindex MYINDEX -tsblob MYBLOB -b MYBUFF

114

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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

Drop Database Components


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

webMethods Installation Guide Version 8.0

115

8 Creating and Dropping Database Components

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

webMethods Installation Guide Version 8.0

8 Creating and Dropping Database Components

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:
dbConfigurator.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i}
-c storage -v latest

Create Database Components


Createtheproperversionsofthedatabasecomponentsforyourproduct(seeChapter 1,
DevelopmentEnvironments).
Tolistthescriptsforcreatingindividualdatabasecomponents,oralldatabase
components,runthiscommand:
dbConfigurator.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i}
-c db_component -v db_component_version

TolistthescriptsforcreatingthedatabasecomponentsforacertainwebMethods
product,runthiscommand:
dbConfigurator.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i}
-pr product -v product_release

Drop Database Components


Beforedropping,shutdownallwebMethodsproductsthatareconnectedtothedatabase
componentandbackupthedatabasecomponent.
Tolistthescriptsfordroppingindividualdatabasecomponents,oralldatabase
components,runthiscommand:
dbConfigurator.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i}
-c db_component -v db_component_version

webMethods Installation Guide Version 8.0

117

8 Creating and Dropping Database Components

TolistthescriptsfordroppingthedatabasecomponentsforacertainwebMethods
product,runthiscommand:
dbConfigurator.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i}
-pr product -v product_release

118

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

121

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

123

9 Completing the Installation

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}

Saveandclosethefile.

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

125

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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).

webMethods Installation Guide Version 8.0

127

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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:

webMethods Installation Guide Version 8.0

129

9 Completing the Installation

#
# 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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

131

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

133

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

135

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

137

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

139

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

141

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

143

9 Completing the Installation

Field

Entry

Database
URL

URLforthedatabaseserver.Belowaresampleformatsforthe
DataDirectConnectJDBC4.0driver.
Oracle
jdbc:wm:oracle://server:{1521|port};serviceName=service
[;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.

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

145

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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.

webMethods Installation Guide Version 8.0

147

9 Completing the Installation

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

webMethods Installation Guide Version 8.0

9 Completing the Installation

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

Saveandclosethefile.
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

Saveandclosethefile.

GototheMywebMethodsServer_directory/bindirectoryand
openthesetenv.shfileinatexteditor.

Locatetheline{rem|#}JAVA_D64=d64anduncomment,as
follows:
JAVA_D64=-d64

Saveandclosethefile.

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.

webMethods Installation Guide Version 8.0

149

9 Completing the Installation

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,
thensaveandclosethefile.

webMethods Installation Guide Version 8.0

9 Completing the Installation

Product

Steps to Redirect to a Non-Default JRE or JDK

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.

webMethods Installation Guide Version 8.0

151

9 Completing the Installation

Development Products
Product

Steps to Redirect to a Non-Default JRE or JDK

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,
thensaveandclosethefile.
RequiresJRE1.6or1.5.
GototheTradingNetworksConsole_directory\bindirectoryand
opentheconsole.batfileinatexteditor.EdittheJAVA_ROOT
parametertopointtotheJREinstallationdirectory,thensaveand
closethefile.
Note: WhenyoulaunchDeveloperfromTradingNetworks
Console,DeveloperrunsinthesameJVMasTradingNetworks
Console.IfyoudecidetouseadifferentJREforTradingNetworks
Console,theJREmustbesuitableforDeveloperaswellasTrading
NetworksConsole.

152

webMethods Installation Guide Version 8.0

10

Uninstalling Products

Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

154

Uninstall ApplinX and EntireX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

155

Uninstall Designer Plug-ins or Eclipse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

157

Uninstall All Other Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

157

webMethods Installation Guide Version 8.0

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

webMethods Installation Guide Version 8.0

10 Uninstalling Products

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.

webMethods Installation Guide Version 8.0

155

10 Uninstalling Products

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.

ThewebMethodsUninstallerdoesnotdeletefilesthatwerecreatedafteryou
installedthecomponent(forexample,usercreatedorconfigurationfiles),nordoesit
deletethedirectorystructurethatcontainsthefiles.Ifyoudonotwanttosavethese
filesanddirectories,deletethecomponentinstallationdirectory.

156

webMethods Installation Guide Version 8.0

10 Uninstalling Products

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.

webMethods Installation Guide Version 8.0

157

10 Uninstalling Products

Ontheproductselectiontree,choosetheproductstouninstall.
Important! Whenyouchooseaproduct,thewebMethodsUninstalleraskswhether
itshouldalsouninstallallproductsthatdependontheproduct.Readthe
messagescarefullytoavoidaccidentallyuninstallingproductsyouwanttokeep.

ThewebMethodsUninstallerdoesnotdeletefilesthatwerecreatedafteryou
installedtheproduct(forexample,usercreatedorconfigurationfiles),nordoesit
deletethedirectorystructurethatcontainsthefiles.Ifyoudonotwanttosavethese
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

webMethods Installation Guide Version 8.0

10 Uninstalling Products

Choosetheproductstouninstall.
Important! Whenyouchooseaproduct,thewebMethodsUninstalleraskswhether
itshouldalsouninstallallproductsthatdependontheproduct.Readthe
messagescarefullytoavoidaccidentallyuninstallingproductsyouwanttokeep.

ThewebMethodsUninstallerdoesnotdeletefilesthatwerecreatedafteryou
installedtheproduct(forexample,usercreatedorconfigurationfiles),nordoesit
deletethedirectorystructurethatcontainsthefiles.Ifyoudonotwanttosavethese
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.

webMethods Installation Guide Version 8.0

159

10 Uninstalling Products

160

webMethods Installation Guide Version 8.0

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.

webMethods Installation Guide Version 8.0

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

CentralConfigurationport

15003

HTTP/HTTPS

InternalWebserviceregistryport

12513

HTTP

CentralConfigurationport

15001

HTTP/HTTPS

InternalWebserviceregistryport

12603

HTTP

6666

HTTP

CentralConfigurationport

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

My webMethods Server

Optimize
Analytic Engine

Prediction Engine

Web Service Data Collector

Infrastructure Data Collector

Report Server
System Management Hub

*SSLauthentication.

Oneway,serveronly,SSLauthentication.
Twoway,clientandserver,SSLauthentication.
**SSLenabled.

162

webMethods Installation Guide Version 8.0

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.

Oneway,serveronly,SSLauthentication.
Twoway,clientandserver,SSLauthentication.
**SSLenabled.

webMethods Installation Guide Version 8.0

163

A Default Ports

164

webMethods Installation Guide Version 8.0