You are on page 1of 148

Title Page

webMethods
Installation Guide

Version 7.1.x

January 2008

webMethods

Copyright
&  Docu‐
ment ID

This document applies to webMethods Product Suite Version 7.1.x  and to all subsequent releases. 
Specifications contained herein are subject to change and these changes will be reported in subsequent release notes or new editions.
© Copyright Software AG 2005‐2008.
All rights reserved.
The name Software AG and/or all Software AG product names are either trademarks or registered trademarks of Software AG. Other 
company and product names mentioned herein may be trademarks of their respective owners.
Document ID: WEBM-IG-71x-20080128

Table of Contents

About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

1. Development Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Integration Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Process Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Portlet and Web Application Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Monitoring and Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Deployer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

2. Software and Hardware Support and Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Operating Systems, JDKs, Browsers, RDBMSs, and Drivers . . . . . . . . . . . . . . . . . . . . . . . 20
Standard Product Hardware Support and Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Special Product Hardware Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
webMethods Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Deployer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Optimize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Trading Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3. International Operating Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Extended Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Browsers and JDK Font Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

4. Using the Wizard for Simple Product Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Specify Release, User Name, and Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Specify the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Select Products to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Configure Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

5. Preparing for Advanced Product Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Prepare for Installation on a Windows System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Prepare for Installation on a UNIX, IBM i5, or Mac System . . . . . . . . . . . . . . . . . . . . . . . . . 38
Prepare for Installation on a Remote Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Prepare the Machine on Which to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Prepare to Install webMethods Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

webMethods Installation Guide Version 7.1.x 3

. . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Start the Installer . . . . . . 62 Configure Infrastructure Data Collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 Specify the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . 47 Start the Installer and Specify a Different Temporary Directory . . . . . . . . . . . . . . . . . . . 69 Overview . . . 47 After You Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Configure Metadata Library . . . . . . . . . . . . . . and Add Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Configure Optimize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Install from. . . . . . . . . 71 Start the Installer Using Advanced Options . . . . . . . . . . . . . . . . . . . . 67 Review and Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Overwrite Products . 65 Configure My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 Installation Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 Select Language Packs . . . . . . . . . . . . . . . . . . . . . . 58 Configure Products . . . . . . . . . . . . . . 41 6. .Table of Contents Installation Scripts and Images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Specify the Installation Directory . 64 Configure webMethods Broker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using the Wizard for Advanced Product Installation . . . . . . . 46 Start the Installer on a UNIX. . . 41 Installation Scripts . . . . . 71 Start the Installer and Specify a Different Temporary Directory . 60 Configure Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IBM i5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 Complete Product Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Console Mode for Advanced Product Installation . . . . . . . . . . . . . . . . . . . . . 53 Specify Release. . . . . . . . . . . . . . . . . 56 How to Choose Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 4 webMethods Installation Guide Version 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 After You Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Specify Release . . . . . . User Name. . . . . . . . . . . . . . . . . . . . . . 59 Configure Trading Networks Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Use Advanced Options . . . . . . . . . . 49 Create. . . . . . . . . . . . . . 74 Specify User Name and Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 Start the Installer . . . . . . . . . . . . . . . . . 70 Start the Installer . . . . . . . . . . . . . . 44 Start the Installer on a Windows System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Start the Installer and Specify a Different System Temp Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . and Password . . . . . . . . . . . . . . . . . . . . . . . 51 Change Logging Level and File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . or Edit an Installation Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 Start the Installer . . . . . . . . . . . . 49 Create or Install from an Installation Image . .1. 50 Use a Proxy Server to Install . . . or Mac System . . . . . . . . . . 55 Select Products to Install . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . 91 Metadata Reasoner and Metadata Repository Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Configure webMethods Broker . . . . . . . . . . . 91 Archive Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 Review and Install . . . . . . . . . . 85 SQL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 How to Select Products . . . . . . . . . . . Preparing for Database Component Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 8. . IS Internal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 SQL Server . . . . . . . . . . . . . . . 92 Analysis and Process Tracker Database Components . . . . . . . . . . . . . . 79 Configure My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 Configure Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Configure Optimize . . . . . . . . . . . . . . . . . . . . . . . . . . . . and IS Core Audit Log Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Change Environment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Set Database Options . . . . . . . . . . . . . . . . . . . . . . . 77 Configure Trading Networks Server . . . . . . . 87 Oracle . . . . . . . 91 Process Engine Database Component . . . . . . . . . . . . . 85 Character Set and Sort Order . . 92 Trading Networks and Trading Networks Archive Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table of Contents Select Products to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 Infrastructure Database Components . . . . . . 87 Download the Database Scripts and Database Component Configurator . . . . . . 78 Configure Metadata Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. . 86 DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 Complete Product Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Database Component Descriptions and Installation Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 My webMethods Server Database Component . . . . 77 Configure Integration Server . . . . . . . . . . . . . . . . . . . 86 Page and Block Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 Configure the Infrastructure Data Collector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document History. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 Process Audit Log Database Component . . . .x 5 . . 89 Default Storage Convention . . . . . 83 webMethods Products and Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93 webMethods Installation Guide Version 7. . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Database Users and Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 Staging and Reporting Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 Oracle . . . . . . . . . . . . . 90 Cross Reference. . . . . . . . 76 Select Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Database Administrator Account . . . . . . . . . . .

. . . . . 121 Configure Optimize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . and Mac Systems . . . . . . . . . . . . . . . . . . . . . . . . 117 Start Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Connect Products to Each Other . . . . . . . . . . 121 Complete the Optimize Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Create a Database User and Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 Drop Redundant Database Component . . . . . . . . . . 116 Increase File Descriptors and Change Permissions on UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . 125 Connect Integration Server to webMethods Broker and Metadata Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Drop Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 Drop Storage and Revoke Database User Permissions . . . . . . . . . . . . . . 120 Set up JDK on AIX Systems . . . . . . . . . . 113 Post-Installation Checklist . . . . . . . 102 Examples . . . . . . . . . . . .1. . . . . . . . . . . . . . . 97 Drop Database Components . . . . . . . . . . . . . . . 110 Create Database Components . 116 Increase PermGen Space on UNIX. . . . . 115 Make Sure the Broker Server is Running and the Default Broker Exists . . 123 Connect Process Engines to Task Engine . . 118 Streamline Integration Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95 Use the Graphical User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 Drop Redundant Database Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 Configure Logging . . . . . 100 Use the Command Line . . . . . . . . . . . . 96 Create Database Components and Create a Database User and Storage . . . . . . . 116 Complete the Integration Server Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Configure Broker Monitors to Start Automatically on UNIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111 10. . . . . . .x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . and Mac Systems . . . IBM i5. 114 Complete the webMethods Broker Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Connect Optimize Analytic Engines to My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Creating and Dropping Database Components . . 101 Database Component Configurator Command . . . . . . . . . . 125 6 webMethods Installation Guide Version 7. . . . . . . . . . 115 Adjust Per-Process Thread Limit and Set Per-Process and Kernel Limit on HP-UX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 Connect Process Engines to Optimize Analytic Engines . . . . . . . . . . . 120 Configure Metadata Library . . . . 121 Set Up Graphical Display on UNIX Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 Prevent Memory Problems on IBM i5 Systems . . . . . . 107 Use Database Scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 Set Locale on UNIX Systems . . . . . . . . . . . . . . . Completing the Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120 Complete the Metadata Library Installation . . . . . . . . . . . . . . . . . . . . . . . . 120 Complete the Monitor Installation . . . . . .Table of Contents 9. . . . . . . . . . . IBM i5. . . . . . . . . . . . . . . . . . . . 116 Enable Full Core Dumps on AIX Systems . . . . . . . . . . . . . 99 Drop the Storage and Revoke Database User Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . 128 Connect Designer to Other Products . . . . . . . . . . . 132 Installed JDKs and Product JDK Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Define a Connection Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 Uninstall on a Windows System . . . Default Ports . . . . . . . . . . . 133 Configure Products to Use 64-Bit Mode on Solaris and HP-UX Systems . .1. . 146 webMethods Installation Guide Version 7. . . . . . . . . . . . 144 Complete the Deployer Uninstallation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129 Database Connections for Integration Server and Trading Networks Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . or Mac System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 A. . . . . . . . . . . . . . . . 127 Connect Trading Networks Server to My webMethods Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Table of Contents Connect Monitor to My webMethods Server . . . . . . . . . . . . . . . . . . . . . . 128 Connect Deployer to Source and Target webMethods Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IBM i5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135 Complete the Installation for Other Products . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Complete the Uninstallation . . . . . . . . . . . . . . . . . . . 130 Point a Function at a Connection Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128 Connect Products to Database Components . . . . . . . . . . . . . . .x 7 . . . . 142 Uninstall on a UNIX. . . . . . . . . . . Uninstalling Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 11. . . . . . . . . . . . . . . . . 145 Default Ports . . . . . . . . . . . . . . . . . . . . . . . . . . 134 Redirect Products to Use a Non-Default JRE or JDK . . . . . . . . . . . . . . . 141 Overview . . . 144 Complete the webMethods Broker Uninstallation on UNIX Systems .

Table of Contents 8 webMethods Installation Guide Version 7.x .1.

 For  instructions on installing and uninstalling webMethods products that are not covered in  this guide.com. you download the webMethods Installer and  the files for each product from the webMethods Advantage Web site at  http://advantage.1.1 webMethods Developer 7.1 webMethods Optimize  7. so following the instructions in this guide for upgrades would have  unpredictable results.1.1 Infrastructure Data Collector webMethods Trading Networks 7. If you must perform certain configuration tasks before you can start a webMethods  product.1. see the documentation for those products.1 webMethods Designer 7. see the product documentation. If you want to upgrade these products. For information on starting  products and configuring them after they are started.5.1.1.x 9 . If you cannot download software.     Product Release Fair Isaac Blaze Advisor 6. webMethods Installation Guide Version 7.1 Typically. Go to the webMethods Bookshelf for the latest version of the guide.About This Guide This guide is for users who are installing or uninstalling the webMethods products  below.1.1. to install webMethods products.1 My webMethods Server 7.1.webmethods. this guide also explains those configuration tasks. webMethods  Customer Operations can provide the webMethods products for which you have  purchased licenses on a CD or through a private FTP site.1 webMethods Optimize 7.    Important! Information in this guide might have been updated since you last  downloaded it. The instructions in this installation guide do not  cover upgrades. you must use the instructions in the  appropriate upgrade procedure.1 webMethods Monitor 7.com.1 webMethods Integration Server 7.3 webMethods Broker 7.1 webMethods Metadata Library 7. Contact webMethods Customer  Operations at custops@webmethods.

Typewriter Identifies characters and values that you must type exactly or  font messages that the system displays on the console. UPPERCASE Identifies keyboard keys. To provide feedback on webMethods documentation. go to  the Documentation Feedback Form on the webMethods Bookshelf.” located by default under the webMethods installation directory. Also identifies service input and output  variables.1. you have the option of downloading the  documentation during product installation to a single directory called  “_documentation. 10 webMethods Installation Guide Version 7. Additional Information The webMethods Advantage Web site at http://advantage.0.subfolder:service. „ Additional Documentation.webmethods. Narrow font Identifies storage locations for services on the webMethods  Integration Server using the convention folder. Identifies terms the first  time they are defined in text.x . Do not type the [ ]  symbols in your own code. Keys that you must press simultaneously are  joined with the “+” symbol. \ Directory paths use the “\” directory delimiter unless the subject is  UNIX‐specific.com provides  you with important sources of information about webMethods products: „ Troubleshooting Information.About This Guide Document Conventions Convention Description Bold Identifies elements on a screen.  In addition.  „ Documentation Feedback. Starting with 7. Italic Identifies variable information that you must supply or change based  on your specific situation or environment. The webMethods Knowledge Base provides  troubleshooting information for many webMethods products. [ ] Optional keywords or values are enclosed in [ ]. you can find documentation for all webMethods products on the  webMethods Bookshelf.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 „ Integration Development . . . . 14 „ Portlet and Web Application Development . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 „ Process Design . .1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 „ Deployer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Development Environments „ Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x 11 . . . . . . . . . . . . . . . . . . . . . . . . . 17 webMethods Installation Guide Version 7. . . 15 „ Monitoring and Administration .

1 Development Environments Overview This chapter lists the webMethods products to install to create various webMethods  environments. For information on the products that write to or read  from each database component. A  webMethods database component is a grouping of database objects that can be used by  one or more webMethods products. simply install the ones you have. and the contents of each database component. webMethods GEAR methodology. Each section in this chapter lists the superset of products you can install. see  “Database Component Descriptions and Installation Requirements” on page 90. if  you have not purchased licenses for all of the products.  Software AG Professional Services. The chapter also lists the database components to install for each environment.x . Trading  Networks. Integration Development „ Developer and Trading Networks Console „ Integration Server with Trading Networks Server and Monitor „ webMethods Broker „ My webMethods Server. To design your webMethods production environments. and My webMethods user interfaces for Monitor. work with your administrators. and Broker and JMS „ Database Component Configurator „ Documentation webMethods Broker Integration Server Developer Broker and JMS interface Trading Networks Console TN Server Monitor Monitor interface Trading Networks interface My webMethods Server database 12 webMethods Installation Guide Version 7.1. and webMethods  best practices documentation.

  embedded IS Internal database.   IS Internal v20 (required if not using the  IS Core Audit Log v11. Install this product. if you are not using  the embedded IS Internal database) Document History v10 (required when  using exactly‐once document processing  in publish‐and‐subscribe solutions) Note: For information on cross referencing  and exactly‐once processing. My webMethods  My webMethods Server v20 Server Trading  Trading Networks v20 Trading Networks  Networks Server Archive v20 webMethods Installation Guide Version 7. see “Database Component  Descriptions and Installation Requirements” on page 90.x 13 .1.  If you want to. 1 Development Environments Below are additional options. see the  Publish‐Subscribe Developer’s Guide.. The database components are versioned differently than the  products. Optional Database Com- Product Required Database Components ponents Integration  IS Core Audit Log v11... For descriptions of database components. see  and Process Audit Log  “Configure Integration Server” on  v30) page 61) Cross Reference v10 (required when  using cross referencing in publish‐and‐ subscribe solutions.. Process Audit Log  Archive v20 (with  Server v30 Operation  Management v15. Log webMethods Broker documents Integration Server Logging Utility Store Integration Server and Trading  Integration Server PKI Support package Networks keys and certificates securely Maintain Developer elements in  Integration Server VSS Support or Microsoft Visual Sourcesafe or IBM  Integration Server ClearCase Support Rational ClearCase Monitor your run times Optimize for Infrastructure (see  “Monitoring and Administration” on  page 16) The table below lists the database components you must or can include in an integration  development environment.

  If you want to. Install this product. and Broker and JMS „ Database Component Configurator „ Documentation Blaze Advisor webMethods Broker Developer Integration Server Blaze Designer Process Monitor Engine Monitor interface Broker and JMS interface Central Configurator interface Metadata Library Task Engine My webMethods Server database Below are additional options... and Process Engine „ For collaboration among developers. and My webMethods user interfaces for  Central Configurator.1 Development Environments Process Design „ Designer (all components) „ Blaze Advisor „ Developer with Blaze Rule Service Plug‐in „ Integration Server with Blaze Rule Service Support... Metadata Library „ webMethods Broker „ My webMethods Server with Task Engine. Monitor. Store Integration Server keys and  Integration Server PKI Support package certificates securely Maintain Developer elements in Microsoft  Integration Server VSS Support or Visual Sourcesafe or IBM Rational  Integration Server ClearCase Support ClearCase Monitor your business processes Optimize for Process (see “Monitoring  and Administration” on page 16) 14 webMethods Installation Guide Version 7.1. Monitor.x .

  IS Core Audit Log v11. see “Configure Integra‐ Reporting v10.x 15 . For descriptions of database components. The database components are versioned differently than the  products. and IS Internal v25 (required if not  Process Audit Log v30) using the embedded IS Internal  database. Product Required Database Components My webMethods Server My webMethods Server v20 webMethods Installation Guide Version 7. Metadata  Reasoner v30 My webMethods  My webMethods Server v20 Server Process Engine Process Engine v30. see “Database Component  Descriptions and Installation Requirements” on page 90. Process  Archive v20 (with Opera‐ Server Audit Log v30 tion Management v15. see “Database  Component Descriptions and Installation Requirements” on page 90. Staging v10 tion Server” on page 61) Metadata Library Metadata Repository v30. The database components are versioned  differently than the products. Optional Database Product Required Database Components Components Integration  IS Core Audit Log v12. Process Audit  Log v30 Task Engine Process Audit Log v30 Portlet and Web Application Development „ Designer Composite Applications Development and My webMethods Server Support „ My webMethods Server „ Database Component Configurator „ Documentation Designer My webMethods Server database The table below lists the database components you must or can include in a portlet and  Web application development environment.1. 1 Development Environments The table below lists the database components you must or can include in a process  design environment. For descriptions of database components.

 Optimize Infrastructure Data Collector  and webMethods Broker „ To collect data about custom applications. and My webMethods user interfaces for  Optimize for Infrastructure. Broker and  JMS. Optimize for Process.x .1 Development Environments Monitoring and Administration „ Optimize Analytic Engine and Prediction Engine „ To collect data about webMethods products. and Optimize for B2B „ Database Component Configurator „ Documentation  Prediction Engine Infrastructure Data Collector Analytic Engine webMethods Broker Web Service Data Collector Optimize and Central Configurator interfaces Broker and JMS interface Monitor interface Optimize for B2B interface Task Engine My webMethods Server Integration Server Monitor database 16 webMethods Installation Guide Version 7.1. Optimize Web Service Data Collector and  webMethods Broker „ Integration Server with Monitor „ My webMethods Server with Task Engine. Central Configurator. Monitor.

 and Process Audit Log v30) My webMethods  My webMethods Server v20 Server Deployer Deployer is a tool you use to deploy items that reside on source webMethods servers to  target webMethods servers. If a firewall separates the  environments.1 webMethods Broker. Optional Database Product Required Database Components Components Optimize Analytic  Analysis v30 (with Distributed  Engine. For example. you might want to deploy items you have  developed on servers in a development environment to servers in a test or production  environment. Prediction  Locking v20 and Operation  Engine.x 17 . Integration  Server.  IS Core Audit Log v11.1. My webMethods Server. see “Database Component  Descriptions and Installation Requirements” on page 90 . Deployer 7. install Deployer and its host Integration Server on a machine in the source  environment that can access all source servers and in the target environment on a  machine that can access all target servers. webMethods Installation Guide Version 7. install Deployer and its host Integration Server on a  machine that can access all source and target servers. If no firewall separates your   source and target environments. For descriptions of database components. 1 Development Environments The table below lists the database components you must or can include in a monitoring  and administration environment. Designer. and Trading Networks. Optimize. The database components are versioned differently  than the products. and  Management v15) Data Purge v15 Infrastructure Data  Process Tracker v30 (with Opera‐ Collector tion Management) Process Audit Log v30 Archive v20 (with Opera‐ tion Management v15. Deployer is a package you install on an Integration Server.1 works with 7.

1.1 Development Environments 18 webMethods Installation Guide Version 7.x .

. . . . . . . .x 19 . . . . . . . . . . . . . .1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 webMethods Installation Guide Version 7. . and Drivers . . . Browsers. . . . . RDBMSs. . . . . . . . . . . . . . .2 Software and Hardware Support and Requirements „ Operating Systems. . . . . . . . . 20 „ Standard Product Hardware Support and Requirements . . . . JDKs. . . . . . . . . . . . 20 „ Special Product Hardware Considerations . . . . .

 or if your clients use many  guaranteed documents. and database drivers that are  supported by the webMethods product suite. JDKs. and Drivers For information on operating systems. browsers.1. For information on the JDK each webMethods product uses by default on each  type of system. Browsers. RDBMSs.2 Software and Hardware Support and Requirements Operating Systems. Standard Product Hardware Support and Requirements The table below lists the minimum and recommended hardware requirements for each  webMethods product.x . such  200 as JDKs) Blaze Advisor 200 1024 (2048) 1 webMethods Broker 750 (1250)* 512 (2048) 1 Database Component Configurator 60 Designer 700 1024 (2048) 1 Developer 100 (200) 128 (256) 1 Documentation Adapters and eStandards  60 Modules Core Product Guides 160 readmes 1 Integration Server 200 (350) 256 (512) 1 Metadata Library 100 (500)** 512 (2048) 1024 1 Monitor Nothing beyond the host Integration Server. see the webMethods System Requirements. **More hard drive space might be required if you use debug level or higher logging. Hard Drive Virtual/ Product Space (MB) RAM (MB) Swap (MB) CPUs Infrastructure (shared code. see “Installed JDKs and Product JDK Usage” on page 133. RDBMSs. The webMethods Installer automatically installs appropriate JDKs on most operating  systems. 20 webMethods Installation Guide Version 7. They  do not include requirements for supporting software such as databases. Important! The hardware requirements below are for webMethods products only. Recommended amounts are shown in parentheses. You must  determine the overall hardware requirements for each of your machines based on the  overall requirements of your operating system and software. *More hard drive space might be required if your documents are large.

1.x 21 . you can only install webMethods Broker on a local hard drive. allow for the number of projects to increase over time. Deployer Deployer requires additional hard drive space for the deployment projects you create. or if your clients use many  guaranteed documents. Special Product Hardware Considerations This section describes special requirements you must consider when determining actual  hardware requirements for the indicated products. webMethods Broker On a Windows system. **More hard drive space might be required if you use debug level or higher logging. Task Engine Nothing beyond the host My webMethods Server. Trading Networks Console 25 128 (256) Server 50 1 *More hard drive space might be required if your documents are large. 2 Software and Hardware Support and Requirements Hard Drive Virtual/ Product Space (MB) RAM (MB) Swap (MB) CPUs My webMethods Server 300 1024 (2048) 1 Optimize Analytic Engine 500 1024 (2048) 1024 1 Prediction Engine 500 1024 (2048) 1024 1 Infrastructure Data Collector 300 2048 (4096) 1024 1 Web Service Data Collector 100** 128 (256) 128 1 Process Engine Nothing beyond the host Integration Server. webMethods Installation Guide Version 7.  You cannot install webMethods Broker on a network‐mounted drive.  When allocating space.

 you need at least two Infrastructure Data Collectors. each engine has these hardware requirements:  Hard Drive Virtual/ Space (MB) RAM (MB) Swap (MB) CPUs Disk Subsystem 100 1000 1000 Intel Pentium III  10GB available free  processor 400MHz  space or higher Additional Hardware Information for Web Service Data Collectors In a production environment. Software AG recommends that each Infrastructure Data Collector manage  no more than 3500 objects. 22 webMethods Installation Guide Version 7.000 objects. 4 Increase the physical memory available for the Infrastructure Data Collector to 4GB. do the following: 1 Go to the Infrastructure Data Collector_directory\bin directory and open the  server.x . Each engine requires additional hard drive space for log files. When managing  larger environments. Additional Hardware Information for the Infrastructure Data Collector Each Infrastructure Data Collector supports up to 5000 objects.{bat|sh} file in a text editor. 2 Increase the Infrastructure Data Collector’s heap space. and 10‐to‐15K RPM  drives. Software AG  recommends using three. In a development environment. If you plan for the Infrastructure Data Collector  to manage close to the 5. To manage an environment with 3500 objects or less. The recommended amount  is 75MB. an  Infrastructure Data Collector requires at least 2GB of RAM. Each engine requires 7MB of hard drive space for each log file. For more information about scaling Infrastructure Data Collectors to manage a larger  number of objects. 3 Save and close the file. The recommended  amount is 100MB. Locate the JAVA_MAX_MEM  parameter and set it to JAVA_MAX_MEM=1536M. but for optimal  performance. each Web Service Data Collector requires additional hard  drive space for log files. the Infrastructure Data Collector needs greater heap space and  physical memory to function optimally. To manage an environment  with 10. see the webMethods Optimize for Infrastructure Administrator’s Guide.1.2 Software and Hardware Support and Requirements Optimize Additional Hardware Information for the Analytic Engine and Prediction Engine In a production environment.000‐object limit. Each Infrastructure Data Collector should run on a separate  machine that satisfies the hardware requirements. each engine’s disk subsystem requirements are a  redundant array of independent disks (RAID 5). Each Web Service Data  Collector requires 5MB of hard drive space for each log file. an UltraWide SCSI. The default heap space for the Infrastructure Data Collector is 512MB.

2 Software and Hardware Support and Requirements

Trading Networks
The hard drive space listed in “Standard Product Hardware Support and Requirements” 
on page 20 identifies only the amount of space Trading Networks Server requires for 
normal processing. It does not account for the space required to temporarily save large 
documents during processing. To use large document handling, you must define hard 
disk drive space on which Trading Networks Server can temporarily save documents 
(rather than store them in memory). The amount of space you need to temporarily save 
documents varies based on the number of documents you process concurrently and the 
size of the documents you process. For example, if your typical concurrent document 
load is 10, you would need hard disk drive space that is 10 to 15 times the combined size 
of the documents being processed concurrently. For more information, see the 
webMethods Trading Networks User’s Guide.

webMethods Installation Guide Version 7.1.x 23

2 Software and Hardware Support and Requirements

24 webMethods Installation Guide Version 7.1.x

3 International Operating Environments

„ Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
„ Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
„ Extended Character Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
„ Browsers and JDK Font Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

webMethods Installation Guide Version 7.1.x 25

 and documentation.S. and enable you to  exchange data with systems and users who speak languages other than your own. adapters. Language Packs The webMethods Installer always installs the U. and services. For products that support multiple languages. your client setup (that  is. webMethods HTML content. webMethods products use the Universal Character Set (ISO/IEC 10646‐2.0. Extended Character Set The webMethods Installer offers an extended character set that extends Javaʹs  java. English.nio. If you operate a  product in a locale for which language packs are not available or installed. and limitations of any  webMethods product. configuration.3 International Operating Environments Overview webMethods products are designed for use anywhere in the world.1. The extended character set allows you to use   custom character encodings such as EBCDIC and OEM character encodings with  Integration Server. and locale  selected in your user profile) will determine which language you see. At minimum. you can also install language packs  that provide translated user interfaces. see the product’s readme. for many products. you will see  U. For specific information on the testing. the products support the  requirements of Unicode 3. capabilities. uses Unicode UTF‐8 encoding.S. or Unicode) as  the character set for all internal operations. Language  packs are available for webMethods products on all operating systems that the  webMethods product suite supports except IBM i5 and Mac. Most products support multiple languages at a time. default locale in which the product is started. help. English files necessary to run  webMethods products. browser language preference. However.Charset class to support additional installable character encodings and adds  more than 870 custom character encodings. 26 webMethods Installation Guide Version 7. you can install as many language  packs as you need. messages. including administration  tools.x .

Internet Explorer 6. see J2SE 5. you might install a full  Unicode font. If  you see hollow boxes or black squares where you would expect to see non‐ASCII  characters.0/docs/guide/intl/fontconfig. you might need to modify your JDKʹs font configuration file to provide an  appropriate font for displaying these characters.html webMethods Installation Guide Version 7. Click Languages and add the  and 7. You can indicate which of the installed languages to display in your browser as  follows: Browser Action Firefox 1. or you can install a font for a particular   language. such as Arial Unicode MS.com/j2se/1. 3 International Operating Environments Browsers and JDK Font Configuration Some HTML interfaces for webMethods products detect the language setting for your  browser.5. Your Java run‐time environment might require modification to display non‐ASCII data.x 27 .1. For information on modifying font configuration file. If you have installed webMethods language packs on your webMethods  products. Click Edit Languages  and add the language you want to use to the top of the list.x and 2. messages.x language you want to use to the top of the list.x  Go to ToolsInternet Options.x Go to ToolsOptionsAdvancedGeneral. those interfaces try to supply the user interface.0 at   http://java. For example.sun. and data in that  language.

3 International Operating Environments 28 webMethods Installation Guide Version 7.x .1.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 „ Specify the Installation Directory . . . . 35 „ Configure Products . . . . .1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 webMethods Installation Guide Version 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 „ Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 „ Start the Installer . . . . . . . . . . . . . . . . . . . . . User Name. . . . . . . . . . . . . . . . . . . . . . . . . .x 29 . .4 Using the Wizard for Simple Product Installation „ Overview . . . . . . . . . . . . 31 „ Specify Release. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 „ Select Products to Install . . . . . . . . . . . . . . . and Password . . . . . . . . . . . . . . . . . . .

 and build information to an audit history log file  named history.x .text in the webMethods_directory\install\history\history.4 Using the Wizard for Simple Product Installation Overview This chapter explains how to install webMethods products locally using the webMethods  Installer wizard on any supported system in a U. b Install a JRE or JDK 1.  webMethods7). or if you  need complete information on any topic mentioned here. the installer  experiences display problems. 30 webMethods Installation Guide Version 7. see the chapters on advanced  product installation. the installer will automatically  configure the webMethods products you install to use the JRE or JDK you  install to run the installer. While these display problems will not adversely affect  the installation process.5 of the bit mode indicated below to run the webMethods  Installer: System JRE or JDK Bit Mode UNIX 32 or 64 IBM i5 64 Mac 32 or 64 Important! On IBM i5 and Mac systems. If  errors or warnings occur during installation.  Note: When you run the webMethods Installer on an IBM i5 system. To support the wizard.txt directory. see “Redirect Products to Use a Non‐Default JRE or JDK” on  page 135. The installer writes product.  UNIX systems must have an X Windows environment.1. the installer writes them to a file named  WmInstallLog.S. Before You Begin 1 Prepare your machine as follows: a Make sure the machine has about 100MB of available disk space in its system  temp directory (Windows) or temporary directory (all other systems) and about  256MB of available virtual memory. Software AG strongly recommends that you minimize the  problems by running the installer from an IBM i5 client for Windows rather than  from a telnet client. For information on whether products require a JRE  or a JDK. English locale.txt and stores the file in the main installation directory (by default. If you want to install using any other options than those covered in this chapter. version.

 HP‐UX. and AIX systems is a 64‐bit binary application.jar webMethods Installation Guide Version 7.exe file. then download the installer for Windows or UNIX. Start the Installer 1 If you are installing on a Windows system. If you are installing on a UNIX system. log in as the non‐root user.x 31 . 2 The Broker Server for Solaris.1. If you do not want the  software to scan the files. Go to the webMethods Advantage Web site  and log in. as appropriate. This scan can take a long time. the software will scan all the files  the installer downloads. d If the machine is running anti‐virus software. Other Run this command: java -Xmx512m -Xincgc -jar webMethodsInstaller7. 4 Using the Wizard for Simple Product Installation c Download the webMethods Installer. you must  configure the operating system kernel to run in 64‐bit mode. shut down the anti‐virus software. you must have Windows system  administrator privileges. You cannot run the 64‐ bit Broker Server on an operating system kernel configured to run in 32‐bit mode. e Shut down all webMethods products that are running on the machine. 2 Go to the directory that contains the webMethods Installer and start the installer as  follows: System Action Windows Double‐click the webMethodsInstaller7.  If you are going to install webMethods Broker on one of these systems.

x .4 Using the Wizard for Simple Product Installation The installer takes several seconds to unzip and launch its JVM. You can resize the wizard as necessary. then displays the  welcome panel.1. Click Next. 32 webMethods Installation Guide Version 7.

 Provide the requested user name and password.x and higher. click 7. webMethods Installation Guide Version 7.x 33 .  Click Next. and Password In the Release list. User Name.1. The installer connects to the webMethods server to download the  webMethods products for which you have purchased licenses. 4 Using the Wizard for Simple Product Installation Specify Release.1.

4 Using the Wizard for Simple Product Installation Specify the Installation Directory Windows only Provide the requested information and then click Next. 34 webMethods Installation Guide Version 7.1.x .

 Trading  Networks Server depends on Integration Server. The products and items in each role are  listed in Chapter 1. „ Choose every product and the minimum recommended set of items for each of those  products by clicking Select Defaults. When you choose a product. the installer always automatically chooses other products  and items that the selected product requires on the same machine. the installer automatically chooses the minimum recommended set  of items for that product. webMethods Installation Guide Version 7. „ Choose individual products and items directly from the product tree. You can choose the products to install using these methods: „ Choose one or more development desktop installations from the Role list. If you select Trading Networks Server. For example. When you  choose a product.1. The  installer  automatically selects the appropriate products and items for that role in the  tree.x 35 . 4 Using the Wizard for Simple Product Installation Select Products to Install The installer lists the webMethods products for which you have purchased licenses and  that are supported on the target operating system. “Development Environments”. The highest level shows product  names and releases and the lower levels show the items that make up or can be used with  the product. You can also choose additional items.  the installer automatically selects Integration Server.

 the installer displays the language packs panel. Optimize. Go to “Configure  Products” on page 59. Click Next. Integration Server. If language packs are available for products you are installing or have already  installed. go to “Review and Install” on page 68.x . Configure Products If you are installing Trading Networks Server. If you are not installing any of these products. webMethods Broker. 36 webMethods Installation Guide Version 7.1. select the check box and click Next. Read the license agreement.4 Using the Wizard for Simple Product Installation Click Next. Metadata Library. or My  webMethods Server. If you accept the terms. the installer displays configuration panels. and then remain in that chapter to complete the installation.  Infrastructure Data Collector.

. . . . or Mac System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 webMethods Installation Guide Version 7. . . . . . . . . . . . . . . . . .1. . . . . .x 37 . . . . . . . . . . . .5 Preparing for Advanced Product Installation „ Prepare for Installation on a Windows System . . . 38 „ Installation Scripts and Images . . . . . . . . . . . . . . . . 38 „ Prepare for Installation on a UNIX. . . . . . . . . IBM i5. . . . . . . . . . . . . . . .

 or using an  installation script that uses the wizard. the software will scan all the files the  installer downloads. or Mac System Prepare for Installation on a Remote Machine If you are going to install webMethods products on a remote machine and you want to  install using the webMethods installer wizard. 3 If the machine is running anti‐virus software.S.0 38 webMethods Installation Guide Version 7. using an installation image.1. 3 Set the DISPLAY variable on the remote machine to point to the local machine. set the  Windows system locale to the proper locale. IBM i5. if you are using a bash shell and are installing from a local machine named  installmachine and want to set the DISPLAY to the default device. enter:   export DISPLAY=installmachine:0. click the  language to use. shut down the anti‐virus software.5 Preparing for Advanced Product Installation Prepare for Installation on a Windows System Prepare the machine on which you are going to install as follows: 1 Download the webMethods Installer. a On the Start menu. or if you are going to  install webMethods Broker and run it in a locale other than U. go to Control PanelRegional and Language Options. c Restart Windows. Go to the webMethods Advantage Web site and  log in. If you do not want the software to  scan the files. In the Language for non-Unicode programs area.S. b Click the Advanced tab. Click OK. For  example. follow these steps: 1 Enable the display of the local machine using the command shown below. Prepare for Installation on a UNIX. English. Instructions for other Windows  systems vary slightly. 4 Shut down all webMethods products that are running on the machine. 2 If you are going to install in a locale other than U.    Note: The instructions below are for Windows XP. English. where  remote_host is the remote machine on which you are going to install:   xhost +remote_host 2 Log on to the remote machine. This scan can take a long time.x . then download the installer for Windows.

 shut down the anti‐virus software. For information on whether products require a JRE or a JDK. Go to the webMethods Advantage Web site and  log in. the installer will automatically configure  the webMethods products you install to use the JRE or JDK you install to run the  installer. 2 Install a JRE or JDK 1. the software will scan all the files the  installer downloads.5 of the bit mode indicated below to run the webMethods  Installer: System JRE or JDK Bit Mode UNIX 32 or 64 IBM i5 64 Mac 32 or 64 Important! On IBM i5 and Mac systems. set your  shell to the proper locale by setting the LANG environment variable as follows:  Shell Commands sh LANG=locale.x 39 . then download the installer for UNIX.S. webMethods Installation Guide Version 7. see  “Redirect Products to Use a Non‐Default JRE or JDK” on page 135. 5 Preparing for Advanced Product Installation Prepare the Machine on Which to Install Prepare the machine on which you are going to install as follows: 1 Download the webMethods Installer. This scan can take a long time.S. 5 Shut down all webMethods products that are running on the machine. If you do not want the software to  scan the files. English. 3 If you are going to install in a locale other than U. or if you are going to  install webMethods Broker and run it in a locale other than U. export LANG csh setenv LANG locale 4 If the machine is running anti‐virus software.1. English.

HP-UX. the NFS‐mounted partition uses the user datagram protocol  (UDP) protocol to communicate with the Broker Server. The hard  option forces the Broker Server to keep retrying until the NFS server  responds. or AIX System The Broker Server for Solaris. If  you are going to install webMethods Broker on one of these systems. NFS-Mounted Partition If you are going to configure Broker Server to create data files on an NFS‐mounted  partition. and AIX systems is a 64‐bit binary application.nointr. HP‐UX.5 Preparing for Advanced Product Installation Prepare to Install webMethods Broker Install on a UNIX System On UNIX systems. the data  directory on the partition is wmbroker_data.proto=tcp host:/path /mount_point Suppose the partition you want to mount is on a machine named netappca. The options on the command  help protect data integrity.x . The proto=tcp  option forces the partition to use transmission control protocol (TCP)  instead. mount -o hard. see your NFS server   documentation. 40 webMethods Installation Guide Version 7. nointr Prevents users from killing the Broker Server while it is hung waiting for  the NFS server to respond. Make sure you have  write permission to the /var/opt/ directory. you must configure  the operating system kernel to run in 64‐bit mode. You cannot run the 64‐bit Broker  Server on an operating system kernel configured to run in 32‐bit mode.txt file in the /var/opt/webMethods directory. The command would be as follows: mount -o hard.1. Install on a Solaris. if the NFS server does not respond to requests from the  Broker Server. proto=tcp By default.nointr. information about the webMethods Broker installations is stored in  the BrokerInstallations. TCP is more reliable than UDP. For information on other ways to protect data integrity. The Broker Server hangs during this period. mount the partition using the command below. and you want to mount the partition on the  local file system at /var/opt/wmbroker_data. the Broker Server tries a few times and then fails.proto=tcp netappca:/wmbroker_data /var/opt/wmbroker_data Option Description hard By default.

webMethods Installation Guide Version 7. You can choose to actually  create the desired installation on the current machine as you create the script. To create a script.1. you select the webMethods products to install and specify all  installation options (for example. For example. If you later find that a script requires a change. 5 Preparing for Advanced Product Installation Installation Scripts and Images The webMethods Installer offers advanced options you can use to create and install from  installation scripts and images. You can create each image for  any type of system. target installation directory). because those options can vary by machine.x 41 . you can download webMethods  products into an installation image. then run the script to create the same installation on  each of the other machines. Installation Scripts If you need to create identical installations on multiple machines. Images do not include information on installation options such as target installation  directory. you can create an image for a  Solaris system from a Windows system. from any type of system. You can also create  a script by editing an existing script and saving it under a new name. When you run the script. you can create a script  of the installation on one machine. it automatically downloads and installs the webMethods  products you selected and uses the installation options you specified. You specify installation options for  each machine when you install from the image. and then use that image to install the desired subsets  of products onto each machine. or vice versa. Each image is designed for one type of operating system. you can edit the script. Installation Images If you need to create installations on machines that cannot go outside your corporate  firewall to the webMethods Advantage Web site. or you can  create the script without creating the installation.

x .5 Preparing for Advanced Product Installation 42 webMethods Installation Guide Version 7.1.

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 „ Specify Release. .x 43 . . . . . . . . . . . 58 „ Configure Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 „ Review and Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 „ Start the Installer on a UNIX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . or Mac System . . . . . . and Password . . . . 47 „ Use Advanced Options . . . . . . . . . . 44 „ Start the Installer on a Windows System . . . 55 „ Select Products to Install . . . . . . . . . . . . . . . 56 „ Select Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . User Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IBM i5. . . . . . . . . . . . . . . . 68 webMethods Installation Guide Version 7. . . . . . . . 54 „ Specify the Installation Directory . . . . . . . . . . . . . . . . . .1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6 Using the Wizard for Advanced Product Installation „ Overview . . . . . . . . . . . . .

When you run the webMethods Installer on an AIX system. and build information to an audit history log file  named history. You can change logging behavior.x . see “Change Logging  Level and File. The installer writes product. you might receive Java  messages during installation.1. To support the wizard. the installer writes them to a file named  WmInstallLog. the installer  experiences display problems. You can ignore these messages.6 Using the Wizard for Advanced Product Installation Overview This chapter explains how to do the following on any system using the webMethods  Installer wizard: „ Install webMethods products „ Create an installation script or image from which to install webMethods products „ Install webMethods products from an installation script or image You can use the wizard to install locally or remotely. While these display problems will not adversely affect  the installation process.txt and stores the file in the main installation directory (by default. Software AG strongly recommends that you minimize the  problems by running the installer from an IBM i5 client for Windows rather than  from a telnet client. Note: When you run the webMethods Installer on an IBM i5 system.text in the webMethods_directory\install\history\history. If  errors or warnings occur during installation. version. and Add Targets” on page 52. UNIX  systems must have an X Windows environment. 44 webMethods Installation Guide Version 7. for instructions.  webMethods7).txt directory.

 while the  ‐Xincgc option enables incremental garbage collection. Open Windows Explorer. because you are creating an image). when you start the installer using the webMethodsInstaller7.x 45 . where amount is greater than 512:  java -Xmxamountm -Xincgc -jar webMethodsInstaller7. while the ‐Xincgc option enables  incremental garbage collection. if you are going to create an  installation image for a different type of system. If you are going to install many products or create an installation image for a  Windows system. increase the amount you  specify on the ‐Xmx option.  and enter this command. the  directory must have at least 250MB of available disk space. and enter this command:  java -Xmx512m -Xincgc -Djava. If  you are going to install from an image. the installer needs more memory.jar Start the Installer and Specify a Different System Temp Directory To run the installer on a Windows system. the  installer launches with the JVM options ‐Xmx512m and ‐Xincgc. you must have Windows system administrator  privileges.1. then go to the webMethods Advantage Web site. If necessary.jar The ‐Xmx option allows Java to use more memory than it uses by default. If you want to allow Java to use more memory (for  example. because you are creating an image).5.5. log in. then go to the   webMethods Advantage Web site.exe file. if the image is 200MB. go to the directory to which you downloaded the installer.io. log in. If you want to allow Java to use  more memory (for example. you can specify a  different directory to use as the system temp directory when you start the installer (see  “Start the Installer and Specify a Different System Temp Directory” on page 45) Start the Installer To run the installer on a Windows system. download the webMethods Installer for UNIX. you must have Windows system administrator  privileges. webMethods Installation Guide Version 7. the directory must have enough additional  available disk space to accommodate the image. The machine’s system temp directory must have about 100MB of available disk space. The ‐Xmx option  specifies the amount of memory to allow Java to use. For example. and  double‐click the webMethodsInstaller7.tmpdir=/different_directory -jar webMethodsInstaller7.exe file. Install a 32‐bit JRE or JDK 1. 6 Using the Wizard for Advanced Product Installation Start the Installer on a Windows System The machine on which you are installing must have about 256MB of available virtual  memory. the installer needs still more memory.  download the webMethods Installer for UNIX. By default. install a 32‐bit JRE or JDK 1.

 or  change logging options. User Name. If you want to install using a proxy server. 46 webMethods Installation Guide Version 7. You can resize the wizard as necessary. then displays the  welcome panel.6 Using the Wizard for Advanced Product Installation After You Start the Installer The installer takes several seconds to unzip and launch its JVM.1. and Password” on page 54. click Next and go to “Specify Release.x . If you want to install webMethods products without using any advanced  options. click Advanced Options and go to “Use Advanced Options” on  page 49. create or run an installation script or image.

jar -console webMethods Installation Guide Version 7. Open a command window. because you are creating an image). go to the directory to which you  downloaded the installer. and start the installer by entering this command:  java -Xmx512m -Xincgc -Djava.jar -console Start the Installer and Specify a Different Temporary Directory Log in as the non‐root user. IBM i5. go to the directory to which you  downloaded the installer.tmpdir=/different_directory -jar webMethodsInstaller7. The commands shown below use the JVM options ‐Xmx512m and ‐Xincgc. 6 Using the Wizard for Advanced Product Installation Start the Installer on a UNIX.x 47 . increase the amount you specify on the  ‐Xmx option. For example.io. while the ‐Xincgc option  enables incremental garbage collection. or Mac System To run the installer. the directory must have enough additional  available disk space to accommodate the image.1. The machine’s temporary directory must have about 100MB of available disk space. you can specify a  different directory to use as the temporary directory (see “Start the Installer and Specify a  Different Temporary Directory” on page 47). If necessary. the  directory must have at least 250MB of available disk space. If you want to allow Java to use more memory  (for example. Open a command window. Start the Installer Log in as the non‐root user. If you are going to install many products or create an  installation image for the same type of system on which you are running the installer. the  installer needs more memory. the installer needs still more memory. The ‐Xmx  option specifies the amount of memory to allow Java to use. the machine on which you are installing must have about 80MB of  available virtual memory. and start the installer by entering this command: java -Xmx512m -Xincgc -jar webMethodsInstaller7. If you are going to create an installation image for a  different type of system. If  you are going to install from an image. if the image is 200MB.

 and Password” on page 54. User Name. 48 webMethods Installation Guide Version 7.1. or  change logging options.x . create or run an installation script or image.  If you want to install using a proxy server. You can resize the wizard as necessary.  click Next and go to “Specify Release. click Advanced Options and go to “Use Advanced Options”. If you want to install webMethods products without using any advanced options.6 Using the Wizard for Advanced Product Installation After You Start the Installer The installer takes several seconds to unzip and launch its JVM. then displays the  welcome panel.  below.

Create. enter the fully  install qualified name of the file in which to save the new script. 6 Using the Wizard for Advanced Product Installation Use Advanced Options When are you done setting advanced options.1. click OK. You can  specify any name. webMethods Installation Guide Version 7. Install from. and you do not have to specify an  extension.. Follow these steps.x 49 . Note: You can ignore the JVM tab. enter the fully  installing qualified name of the file in which to save the script. see “Installation Scripts and Images” on page 41. It is not used in this release. In the Script file name field. The installer closes the dialog box  and returns to the welcome panel. You  can specify any name. Create script without  Click Edit script.. and you do not have to specify an  extension. Create script and  Click Create script. where you can click Next to continue... or Edit an Installation Script For information on installation scripts. In the Script file name field. You can do the following from this panel: To do this.

can create image for any system from any system fully qualified name of file that contains image from which to install 50 webMethods Installation Guide Version 7. Create script from  Click Install from script.  fully qualified name of file in which to save image (no file name extension required. Edit script Click Edit script. see “Installation Scripts and Images” on page 41.. type the  the fully qualified name of the file to which to write the new  script. Click Create script.x . In the Script file name field. In the Script file name field.6 Using the Wizard for Advanced Product Installation To do this. In the adjacent Script file name field. Create or Install from an Installation Image For information on installation images. type the fully  qualified name of the file from which to install.. In the adjacent Script file name field.. Install from script Click Install from script.. type  existing script  the fully qualified name of the file that contains the existing  without installing script to use as a template for the new script. type the fully  qualified name of the file that contains the script to edit.1. installer creates it system for which to create image. Follow these steps. installation  fails. if file does not exist. Note: If errors occur while the script is running.

 Your network administrator can provide  information on your company’s proxy servers. you  must use that proxy server to install.x 51 .1. 6 Using the Wizard for Advanced Product Installation Use a Proxy Server to Install If your company connects to the Internet through an HTTP or Socks proxy server.  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 7.

 the installer writes errors and warnings that occur during installation to a file  named WmInstallLog. the file name. and Add Targets By default.6 Using the Wizard for Advanced Product Installation Change Logging Level and File.  You can increase or decrease the amount of information that is written. webMethods7). Verbose produces a 10 to 20MB file 52 webMethods Installation Guide Version 7. and can choose to also write to standard out and standard error. or  the file location.1.x .txt in the main installation directory (by default.

  webMethods Installation Guide Version 7. copy them to a different  directory before using this option. you can replace the products by overwriting them.x 53 . Never use this option to upgrade any product. If you want to save files you have created or customized. Overwriting not only  overwrites a product. 6 Using the Wizard for Advanced Product Installation Overwrite Products If one or more of your webMethods products has been corrupted. Important! Only overwrite products in the most extreme cases. or if you accidentally  deleted some product files. then move the files back after the overwrite is  complete. it overwrites all related files you have created or customized for  the product.1.

1. The installer connects to the webMethods server to download the  webMethods products for which you have purchased licenses.6 Using the Wizard for Advanced Product Installation Specify Release. User Name.  Click Next.x . and Password In the Release list. click 7.x and higher Provide the requested user name and password. 54 webMethods Installation Guide Version 7.1.

6 Using the Wizard for Advanced Product Installation Specify the Installation Directory Windows only Provide the requested information and then click Next.1. webMethods Installation Guide Version 7.x 55 . the userid under which you are logged in must have full read and write  permissions to the directory you specify (for example. your home directory). If you are installing on a UNIX system as a non‐root user and are installing webMethods  Broker.

 The highest level shows product  names and releases and the lower levels show the items that make up or can be used with  the product.x . „ Choose every product and the minimum recommended set of items for each of those  products by clicking Select Defaults.6 Using the Wizard for Advanced Product Installation Select Products to Install The installer lists the webMethods products for which you have purchased licenses and  that are supported on the target operating system. The installer  automatically selects the appropriate products and items for that task area in the  product tree. The products and  items in each task area are listed in Chapter 1. Choose the webMethods products to install. How to Choose Products You can choose products using these methods: „ Choose one or more development installations from the Roles list. If you have already installed a product or item in the specified installation  directory. 56 webMethods Installation Guide Version 7. “Development Environments”. the item name is followed by the text (Installed) and the item name and its  check box are grayed out. You can then unselect items and choose other items.1.

 or My  webMethods Server. For  example. The installer does not automatically select these  required products and items. You must select them when you are installing on the proper  machine.  Infrastructure Data Collector. For example. if  those products and items do not already exist in the specified installation directory. the installer displays the language packs panel.x 57 . Integration Server. Trading Networks Server depends on Integration Server. you can unselect products and items that you are sure  already exist on the target machine.  If you are installing Trading Networks Server. If language packs are available for products you are  installing or have already installed. When you  choose a product. Optimize. and Integration Server does not already exist in the specified  installation directory. Some products require other products and items but not necessarily on the same  machine. click Next.1. if you  want to install one or more. Complete Product Selection When you are done. the installer automatically chooses the minimum recommended set  of items for that product. If you accept the terms. the installer always automatically chooses other  products and items that the selected product or item requires on the same machine. If you select Trading  Networks Server. select the check box and click Next. the installer displays configuration panels. Metadata Library. Go to “Configure  Products” on page 59 for instructions on completing the panels. webMethods Installation Guide Version 7. If no language packs are available or you do not want to install any. read the license  agreement that displays next. you might install user interfaces  and My webMethods Server on a machine other than the machines that host the products  to which the user interfaces belong. If you are  creating an installation image. If you are not installing  any of these products. 6 Using the Wizard for Advanced Product Installation „ Choose individual products and items directly from the product tree. in a production environment. webMethods Broker. the installer automatically selects Integration Server. go to “Select Language Packs”. below. go to “Review and Install” on page 68. When you choose a product or item.

1. You can install as many language  packs as you want. or My  webMethods Server.6 Using the Wizard for Advanced Product Installation Select Language Packs webMethods products support multiple languages. and then click Next.S. below. Integration Server. Optimize. go to “Review and Install” on page 68. U. Metadata Library. If you are not installing any  of these products.  Infrastructure Data Collector. and all of the languages installed (including the default. for instructions on completing the panels.x . Go to “Configure  Products”. If you accept the terms. webMethods Broker. If you are installing Trading Networks Server. English)  will be available to users. select the check box and click Next. 58 webMethods Installation Guide Version 7. the installer displays configuration panels.  Read the license agreement. Select the language packs to install.

x 59 . the values you enter on one  panel will be reflected on the next as you go forward through the installer the first time. if the  product will connect to a schema other than the default schema for the specified database  user. the installer displays configuration  panels.InitializationString="SET CURRENT PATH=schema" AlternateID is the name of the default schema that is used to qualify unqualified  database objects in dynamically prepared SQL statements. you must specify these connection options in the URL: . Some products require you to supply database connection information. „ Configure Trading Networks Server „ Configure Integration Server „ Configure Optimize „ Configure Infrastructure Data Collector „ Configure Metadata Library „ Configure webMethods Broker „ Configure My webMethods Server For panels that include database connection parameters. webMethods Installation Guide Version 7.AlternateId=schema.1. 6 Using the Wizard for Advanced Product Installation Configure Products If you are installing any of the products listed below. For DB2.

1.6 Using the Wizard for Advanced Product Installation Configure Trading Networks Server database connection from Trading Networks Server to Trading Networks database component 60 webMethods Installation Guide Version 7.x .

 but you can switch  Integration Servers that you installed as applications to services after installation. click External RDBMS and define the  database connection. as a reverse  HTTP gateway or as the run time for an adapter). If you are going to use Integration Server as a standalone server (for example.  you can install only one of the Integration Servers as a service. can be supplied at startup If you are installing on a Windows system and will be using a version control system  with Developer.1. you must install Integration Server as an application rather than a  service. You can install multiple Integration Servers on the same machine. If you are going to cluster Integration Servers. “Development Environments”). Document History. Process Audit Log. For  instructions. webMethods Installation Guide Version 7. 6 Using the Wizard for Advanced Product Installation Configure Integration Server start/shut down automatically when start/shut down manually (Windows only) start/shut down system (Windows only) optional. or you do not have an external RDBMS. see the webMethods Integration Server Administrator’s Guide.  or you want to get Integration Server up and running quickly.x 61 . you can click Internal database. or Process Engine database  component (see Chapter 1. if you need to create the IS Core  Audit Log. or if you want to use an  external RDBMS for all Integration Server data. On a Windows system.

 see the webMethods Integration Server  Administrator’s Guide. the port  for each instance must be unique. default is default network interface for local machine. Provide the port you want the central configurator  to use to communicate with each Optimize component you are installing.1. do not use localhost 62 webMethods Installation Guide Version 7.  if you have multiple network interfaces. Configure Optimize Optimize provides a central configurator that allows you to configure Optimize  components from a central machine.6 Using the Wizard for Advanced Product Installation Note: You can switch from the embedded internal database to an external RDBMS  later if necessary. For instructions. If you install multiple instances of a component on the same machine. Each port must  be unique.x . identify the one to use.

can be supplied at startup Broker for Infrastructure Data Collector to use to communicate with Optimize Analytic Engine webMethods Installation Guide Version 7. 6 Using the Wizard for Advanced Product Installation Configure Infrastructure Data Collector optional.x 63 .1.

64 webMethods Installation Guide Version 7. the Database user and Password are  required.6 Using the Wizard for Advanced Product Installation Configure Metadata Library start/shut down automatically when start/shut down manually (WIndows only) start/shut down system (Windows only) database connection from Metadata Library to Metadata Reasoner. Metadata Repository database components Important! If you specify the database connection.x .1.

 Using separate storage sessions  minimizes the risk of corruption that goes with a combined storage location and enables  you to back up configuration data without having to shut down your Broker Server. you must use create it after installation  is complete. You cannot later  change from a combined session to separate sessions or vice versa. using instructions in the webMethods Broker Administrator’s Guide. webMethods Installation Guide Version 7. If you do  not need to back up configuration data without shutting down your Broker Server. If you choose to not  create the Broker Server configuration at this time.)  Important! Software AG recommends creating separate sessions. using the  installer) if you want to use a different storage size than is offered on the panel or if you  want to create a combined storage session for configuration and run‐time data. use different port for each full path to directory for Broker Server data. using the installer) if you want to  use a storage size that is offered on the panel and you want to create separate storage  sessions for configuration (metadata) and run‐time data. use different port for each if multiple Broker Servers on this machine. using  a combined session might save you a small amount of disk space.x 65 . if multiple Broker Servers on one machine.1. see the  webMethods Broker Administrator’s Guide. 6 Using the Wizard for Advanced Product Installation Configure webMethods Broker if multiple Broker Monitors on this machine. (For   information about the webMethods Broker online configuration data backup tool. You would create the Broker Server at this time (that is. use different data directory for each Create a Broker Server Configuration You would not create the Broker Server configuration at this time (that is.

  the faster the startup. you can add storage files and  increase their size. if the  amount of storage allocated turns out to be insufficient. one larger‐sized single document or a batch of documents). If necessary. Startup time does not depend on the size of the storage file. The webMethods Broker Administrator’s Guide provides instructions on working with log  files and storage files. additional storage capacity  merely prevents the Broker Server from running out of room. 66 webMethods Installation Guide Version 7. with a larger log file.x . you can  remove or replace log files after installation.   high document volumes.6 Using the Wizard for Advanced Product Installation Select a preconfigured storage session for the Broker Server that can handle your  expected usage needs. you can send larger messages (that  is.) When determining the appropriate size for the log file. possibly using  four times longer  document logging as well than for Small *For complete information on Broker Server storage sessions. low document volumes. After installation. fits more cases  Up to twice as  4GB storage file than Small. the factors to balance are Broker  Server startup time and the desired maximum transaction size. and  no document logging Medium Configuration 64MB log file  Standard deployment size. larger maximum transaction  long as for Small size and twice the storage capacity of   Small Large Configuration 128MB log file  Suitable for production deployments with  Two times longer  8GB storage file many integrations running at relatively  than for Medium. The smaller the log file. and you can increase or decrease their size.1. You cannot remove storage files or decrease their size. however. see the webMethods Broker Administrator’s Guide. as follows:  Broker Server Files Created When to Use Startup Time Small Configuration 32MB log file 512MB  Ideal for running development Broker  Fastest of all    storage file Servers or relatively few production  configurations integrations.

1.x 67 . 6 Using the Wizard for Advanced Product Installation Configure My webMethods Server start/shut down automatically when start/shut down manually (WIndows only) start/shut down system (Windows only) database connection between My webMethods Server and My webMethods Server database component webMethods Installation Guide Version 7.

 If the list is correct. If the list is not correct. then displays the installation complete panel.  click Back until you reach the panel on which you chose the products to install and correct  the choices. click Next.1.x . 68 webMethods Installation Guide Version 7. Click Close.6 Using the Wizard for Advanced Product Installation Review and Install Review the list of products and items you have selected for install. The installer installs the products and related  items.

. . . . . . . . 76 „ Configure Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 „ Specify User Name and Password . . . . . . . . . . . . . . . . . . . . . . . . 77 „ Review and Install . . . . . . . . . . . . . . . . . . . . . . . . .7 Using Console Mode for Advanced Product Installation „ Overview . . 74 „ Select Products to Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 „ Specify the Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. . . . . . . . . . . 75 „ Select Language Packs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 „ Specify Release . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 webMethods Installation Guide Version 7. . . .x 69 . . . . . . . . . . . . . . . . . . 70 „ Start the Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

The installer writes product. If necessary.  Start the Installer To run the installer. the  directory must have at least 250MB of available disk space. the installer writes them to a file named  WmInstallLog. The ‐Xmx  option specifies the amount of memory to allow Java to use. the machine on which you are installing must have about 80MB of  available virtual memory.text in the webMethods_directory\install\history\history. Note: When you run the webMethods Installer on an AIX system. If  you are going to install from an image.7 Using Console Mode for Advanced Product Installation Overview This chapter explains how to do the following on a UNIX. If  errors or warnings occur during installation. If you are going to install many products or create an  installation image for the same type of system on which you are running the installer.txt and stores the file in the main installation directory (by default. or  locally on a Mac system. You can change logging behavior. If you are going to create an installation image for a  different type of system. and build information to an audit history log file  named history. the installer needs still more memory. for instructions.  webMethods7).x . while the ‐Xincgc option  enables incremental garbage collection. The machine’s temporary directory must have about 100MB of available disk space. You can ignore these messages. the  installer needs more memory. 70 webMethods Installation Guide Version 7.1. you can specify a  different directory to use as the temporary directory (see “Start the Installer and Specify a  Different Temporary Directory” on page 71). increase the amount you specify on the  ‐Xmx option. IBM i5. version. If you want to allow Java to use more memory  (for example. For example. see “Start the Installer  Using Advanced Options” on page 71. the directory must have enough additional  available disk space to accommodate the image. You can use console mode to install locally or remotely on a UNIX or IBM i5 system. if the image is 200MB. you might receive  Java messages during installation. because you are creating an image).txt directory. or Mac system using  webMethods Installer console mode: „ Install webMethods products from the webMethods Installer „ Create an installation script or image from which to install webMethods products „ Install webMethods products from an installation script or image. The commands shown below use the JVM options ‐Xmx512m and ‐Xincgc.

 Open a command window. Create. Edit a script -editScript script_file Fully qualified name of the file that contains the  script to edit.jar. go to the directory to which you  downloaded the installer. see “Installation Scripts and Images” on page 41. Create a script from an existing script without installing -readScript script_file Fully qualified name of the file that contains the  existing script to use as a template. webMethods Installation Guide Version 7.1. go to the directory to which you  downloaded the installer.jar -console Start the Installer and Specify a Different Temporary Directory Log in as the non‐root user. and start the installer by entering this command:  java -Xmx512m -Xincgc -Djava. -writeScript script_file Fully qualified name of the file in which to save the  new script. Create a script without installing -editScript script_file Fully qualified name of the file in which to save the  script.io.tmpdir=/different_directory -jar webMethodsInstaller7. Install from. 7 Using Console Mode for Advanced Product Installation Start the Installer Log in as the non‐root user. Open a command window. or Edit an Installation Script For information on installation scripts. Parameter Variables Create a script and install -writeScript script_file Fully qualified name of the file in which to save the  script.x 71 .jar -console Start the Installer Using Advanced Options You can add the parameters listed below in any order after ‐jar webMethodsInstaller7. and start the installer by entering this command: java -Xmx512m -Xincgc -jar webMethodsInstaller7.

  SOLAMD64 Solaris for Intel x86 IBM AIX AIX HP‐UX PA‐RISC HP11 HP‐UX Itanium 2 HP11IT Linux x86 LNX Linux AMD64.7 Using Console Mode for Advanced Product Installation Parameter Variables Install from a script -readScript script_file Fully qualified name of the file that contains the  installation script from which to install.x . the installation fails. The  default is the system on which you are running the  installer. see “Installation Scripts and Images” on page 41. Create or Install from an Installation Image For information on installation images. EM64T LNXAMD64 IBM i5 AS400 Mac OSX Install from a image -readImage image_file Fully qualified name of the file that contains the  installation image from which to install. You  can create an image for any system from any  system. Important! If any errors occur while an installation  script is running. -imagePlatform system System for which you are creating the image. 72 webMethods Installation Guide Version 7. Parameter Variables Create an image -writeImage image_file Fully qualified name of the file in which to save the  installation image. Valid values are as listed below. System Value Windows x86 WNT Window AMD64.1. EM64T W64 Solaris SPARC SOL Solaris AMD Opteron.

x 73 . or  the file location. webMethods Installation Guide Version 7. Valid values are as  follows: Amount of information to log Value None 0 Errors only 5 All (verbose). -proxyPass password Password for user.  You can increase or decrease the amount of information that is written. -debugOut Writes logging information to standard out as well as to  file. the installer writes errors and warnings that occur during installation to a file  named WmInstallLog. The default is the system on which you are  running the installer. and can choose to also write to standard out and standard error. the file name.  Parameter Variables Use an HTTP proxy server to install -proxyHost host Host name or fully qualified IP address of the  proxy server. Use a Socks proxy server to install -socksProxyHost host Host name or fully qualified IP address of the  proxy server. -socksProxyPort port Port used by the proxy server. webMethods7).1. -proxyUser user User name for the installer to use to log on to the  proxy server.  Parameter Variables -debugLvl number Amount of information to log.  produces a 10 to  10 20MB file -debugFile debug_file Fully qualified name of the file to contain the logging  information. -proxyPort port Port used by the proxy server. you  must use that proxy server to install. Change Logging Level and File. Your network administrator can provide  information on your company’s proxy servers. and Add Targets By default.txt in the main installation directory (by default. 7 Using Console Mode for Advanced Product Installation Use a Proxy Server to Install If your company connects to the Internet through an HTTP or Socks proxy server.

 your home directory).x and higher release. If you want to save files you have created or customized.1.7 Using Console Mode for Advanced Product Installation Parameter Variables -debugErr Writes logging information to standard error as well as to  file. Specify the Installation Directory Specify the directory into which to install webMethods products. -debug number Shorthand way to specify -debugErr -debugLvl number.  Important! Only overwrite products in the most extreme cases.1. the userid  under which you are logged in must have full read and write permissions to the directory  you specify (for example.  Parameter Variables -overwriteInstall None. then move the files back after the overwrite is  complete. Overwrite Products If one or more of your webMethods products has been corrupted.x . Overwriting not only  overwrites a product. you can replace the products by overwriting them. or if you accidentally  deleted some product files. If you are installing as a non‐root user and are installing webMethods Broker. copy them to a different  directory before using this option. Specify Release Choose to install from the 7. it overwrites all related files you have created or customized for  the product. Specify User Name and Password Provide the user name and password you use to log in to the webMethods Advantage  Web site. Never use this option to upgrade any product. 74 webMethods Installation Guide Version 7.

 enter the number for Program Files under Integration Server). The installer shows an X next to each item  you select. You can choose products using these methods in any combination: „ Choose a development installation from the Roles list that appears at the top of  the  product tree. Enter the number that  appears next to the product heading (for example. Note: You might not see the selections until you page forward through the product  tree. For  example. Trading Networks Server depends on Integration Server. To page backward through  the product tree. To  page forward through the product tree. „ Choose the minimum recommended set of items for a product. To search for a specific product or item. Enter S again to find the next occurrence of  the product or item. Enter the number for each of the  items (for example. the item name is  followed by a letter I. the installer always automatically chooses other  products and items that the selected product or item requires on the same machine.  “Development Environments”. enter a minus sign (‐).1. „ Choose individual items from the product tree.  then enter the name of the product or item. How to Select Products The installer can display only a limited number of lines in the product tree at a time.x 75 . the installer  shows a pound sign (#) next to the product heading. If you select only some of the items listed under a product. When you select all items listed under a product. if  those products and items do not already exist in the specified installation directory. Choose the webMethods products to install. If you are  webMethods Installation Guide Version 7. If you select Trading  Networks Server. enter S. If  you have already installed an item in the specified installation directory. enter the number for Integration Server). Enter the number that appears next to the role. The  installer automatically selects and shows an X next to each of the appropriate  products and items for that task area in the product tree. enter a plus sign (+). The installer automatically selects and shows an X next to each of the items  listed under the product that have been designated as recommended. and Integration Server does not already exist in the specified  installation directory. 7 Using Console Mode for Advanced Product Installation Select Products to Install The installer lists the products for which you have purchased licenses and that are  supported on the target operating system. You  must enter each number on a separate line. The products and items in the task areas are listed in Chapter 1. the installer shows an X next to the  product heading. the installer automatically selects Integration Server. The highest level shows product names and  releases and the lower levels show the items that make up or are related to the product. When you choose a product or item.

 you might have to increase the number of  lines that are visible in your console window. or My  webMethods Server. you might install user interfaces  and My webMethods Server on a machine other than the machines that host the products  to which the user interfaces belong. English)  will be available to users. Optimize. go to “Review  and Install” on page 81. Go to  “Configure Products”. in a production environment. If language packs are available for products you  are installing or have already installed. read the license  agreement and indicate whether you accept the terms. Metadata  Library. If you are  not installing any of these products. go to “Select Language Packs”. Go to “Configure Products” on page 77 for instructions on  providing the information. and all of the languages installed (including the default. Optimize.  Infrastructure Data Collector.  Note: To see the entire license agreement. Integration Server. Integration Server. or My webMethods Server. If you are not installing any of these products. Select the language packs to install. webMethods Broker. For example. the installer prompts for  configuration information. Read the license agreement and indicate whether you accept the terms. Metadata Library. the installer prompts for configuration information.S. The installer does not automatically select these  required products and items.x .1. go to “Review and Install” on page 81. Complete Product Selection When you are done.  If no language packs are available or you do not want to install any. if you want to install one or more. webMethods Broker. you can install as many language  packs as you want. U. Some products require other products and items but not necessarily on the same  machine. Infrastructure Data Collector. You must select them when you are installing on the proper  machine. below. below. you can unselect products and items that you are sure  already exist on the target machine. Select Language Packs webMethods products support multiple languages. If you are installing Trading Networks Server. the installer prompts you to choose packs to  install. for instructions on providing the information.7 Using Console Mode for Advanced Product Installation creating an installation image. press ENTER twice. If you are installing Trading  Networks Server. 76 webMethods Installation Guide Version 7.

LoadBalancing=value [. webMethods Installation Guide Version 7. if the product will connect to a schema other than the default schema for the  specified database user.serviceName=service [.1. ConnectionDelay=value RAC .x 77 . Windows  [. Configure Trading Networks Server Define the database connection for Trading Networks Server to use to connect to the  Trading Networks database component.option=value …] DB2 for Linux.option=value …] Oracle  jdbc:wm:oracle://server:{1521|port}.option=value …] For DB2.InitializationString="SET CURRENT PATH=schema" AlternateID is the name of the default schema that is used to qualify unqualified  database objects in dynamically prepared SQL statements.option=value …] DB2 for iSeries jdbc:wm:db2://server:{446|port}.databaseName=database UNIX. sample URL  formats are shown below. 7 Using Console Mode for Advanced Product Installation Configure Products If you are installing any of the products listed below.databaseName=database [.option=value …] SQL Server jdbc:wm:sqlserver://server:{1433|port} .locationName=location [.  jdbc:wm:db2://server:{50000|port}. If you do not do so.…) .AlternateServers=(server:{1521|port}.  RDBMS Sample URL Format Oracle jdbc:wm:oracle://server:{1521|port}.serviceName=service configured for   . the installer prompts for  configuration information.AlternateId=schema.. you must specify these connection options in the URL: . „ Configure Trading Networks Server „ Configure Integration Server „ Configure Optimize „ Configure the Infrastructure Data Collector „ Configure Metadata Library „ Configure webMethods Broker „ Configure My webMethods Server Some products require you to supply database connection information.ConnectionRetry=value. Trading Networks will not  start after installation.

 or you want to get Integration Server up and running quickly. Each port must be unique. choose the external RDBMS and define the  database connection. if you need to create the IS Core Audit  Log. see the webMethods Integration Server  Administrator’s Guide. If you do not do specify the database connection. the port for each instance must be unique. you  can choose the embedded internal database. Document History. as a  reverse HTTP gateway or as the run time for an adapter). or if you want to use an external  RDBMS for all Integration Server data. identify the one to use. Note: You can switch from the embedded internal database to an external RDBMS  later if necessary. or Process Engine database component  (see Chapter 1.7 Using Console Mode for Advanced Product Installation Configure Integration Server 1 You can provide the Integration Server license key now. If you are going to cluster Integration Servers. The database  user and password are required. Do not use localhost.1. 2 Define the database connection for Metadata Library to use to connect to the  Metadata Repository and Metadata Reasoner database components. Configure Optimize 1 If you have multiple network interfaces. or you do not have an  external RDBMS. If you install multiple instances of a component  on the same machine.  Metadata Library will not start after installation. 2 Identify the Broker for Infrastructure Data Collector to use to communicate with the  Optimize Analytic Engine. “Development Environments”). Configure Metadata Library 1 Provide the port to use for the Metadata Library. Integration  Server will start after installation. Configure the Infrastructure Data Collector 1 You can provide the Infrastructure Data Collector license key now. or you can provide  it after you start Infrastructure Data Collector. If you do not provide the connection information. or accept the default. Provide the port you want the central  configurator to use to communicate with each Optimize component you are  installing. 2 Optimize offers a central configurator that allows you to configure Optimize  components from a single machine. For instructions. or you can provide it after  you start Integration Server. but some features will not work. 78 webMethods Installation Guide Version 7.x . Process Audit Log. If you are going to use Integration Server as a standalone server (for example. 2 Choose the database for Integration Server to use.

 You cannot  later change from a combined session to separate sessions or vice versa. If you  install multiple Broker Servers on this machine. „ You would create the Broker Server at this time (that is. If you  install multiple Broker Servers on this machine.) If you choose to create the Broker Server at this time. see the webMethods  Broker Administrator’s Guide. specify a different port for each. If  necessary. If you do not need to back up configuration data without shutting down  your Broker Server. using instructions in the  webMethods Broker Administrator’s Guide.  continue to step 4. bind Broker Monitor to a specific IP address instead. The default port is 6849. 5 Identify the port on which to run the Broker Server. 3 Indicate whether you want to create the Broker Server. (For  information about the  webMethods Broker online configuration data backup tool. Using  separate storage sessions minimizes the risk of corruption that goes with a  combined storage location and enables you to back up configuration data without  having to shut down your Broker Server. 6 Provide the full path to the data directory in which to store Broker Server data. using the installer) if you  want to use a storage size that is offered on the panel and you want to create  separate storage sessions for configuration (metadata) and run‐time data.1. „ You would not create the Broker Server configuration at this time (that is. 4 Enter the webMethods Broker license key provided by Software AG. specify a different data directory for  each. using a combined session might save you a small amount of  disk space. using  the installer) if you want to use a different storage size than is offered on the panel  or if you want to create a combined storage session for configuration and run‐time  data.x 79 . The default port is 6850. specify a different port for each. Broker Monitor will bind to all IP addresses on the local machine. If you  install multiple Broker Monitors on this machine. 2 By default.  you must use create it after installation is complete. webMethods Installation Guide Version 7. If you choose to not create the Broker Server configuration at this time. Important! Software AG recommends creating separate sessions. 7 Using Console Mode for Advanced Product Installation Configure webMethods Broker 1 Identify the port on which to run the Broker Monitor.

  and no document logging Medium Configuration 64MB log file  Standard deployment size. the factors to balance are  Broker Server startup time and the desired maximum transaction size. you can  add storage files and increase their size. If  necessary. when the Broker Monitor starts or shuts down. and you can increase  or decrease their size.  Broker Server Files Created When to Use Startup Time Small Configuration 32MB log file 512MB  Ideal for running development Broker  Fastest of all    storage file Servers or relatively few production  configurations integrations. The smaller  the log file. fits more  Up to twice as  4GB storage file cases than Small. larger maximum  long as for Small transaction size and twice the storage  capacity of Small Large Configuration 128MB log file  Suitable for production deployments  Two times longer  8GB storage file with many integrations running at  than for Medium. you can send larger  messages (that is.1. if the amount of storage allocated turns out to be insufficient.7 Using Console Mode for Advanced Product Installation 7 Select a preconfigured storage session for the Broker Server that is adequate for your  expected usage needs. however. you can remove or replace log files after installation. 8 Specify where to install the Broker Monitor. additional storage  capacity merely prevents the Broker Server from running out of room. see the webMethods Broker  Administrator’s Guide. one larger‐sized single document or a batch of documents). When determining the appropriate size for the log file. the faster the startup. The Broker Monitor controls the Broker  Server. Startup time does not depend on the size of the storage file. You cannot remove storage files or decrease  their size. it starts or shuts down the  Broker Server. low document volumes. 80 webMethods Installation Guide Version 7. The webMethods Broker Administrator’s Guide provides instructions on working with  log files and storage files. with a larger log file. After  installation.   relatively high document volumes.x .  four times longer  possibly using document logging as  than for Small well *For complete information on Broker Server storage sessions.

 press ENTER. or accept the default. webMethods Installation Guide Version 7. If the list is correct.1. Review and Install Review the list of products you have chosen to install. If you do not do so. My webMethods  Server will not start after installation. 7 Using Console Mode for Advanced Product Installation Configure My webMethods Server 1 Provide the port to use for My webMethods Server.x 81 .  The installer installs the products and related items. 2 Define the database connection for My webMethods Server to use to connect to the  My webMethods Server database component.

7 Using Console Mode for Advanced Product Installation 82 webMethods Installation Guide Version 7.1.x .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 „ Database Administrator Account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 „ Change Environment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 „ Download the Database Scripts and Database Component Configurator . . . . . . . . . . . . . . . . . . . . . . . .8 Preparing for Database Component Configuration „ webMethods Products and Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x 83 . . . . . . . . . 85 „ Character Set and Sort Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 „ Default Storage Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 „ Database Users and Storage . . 90 webMethods Installation Guide Version 7. . . . . . 89 „ Database Component Descriptions and Installation Requirements . . . . . . . 87 „ Set Database Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 „ Page and Block Size . . . .

 All  webMethods products come with the client component of this driver. “Completing the Installation”. For example.  specifically.1. You must use the DataDirect Connect JDBC 3. and the installer  uses the parameters to configure JDBC connection pools. you can use the webMethods JDBC Adapter. Tasks you perform after product installation  are covered in Chapter 10. My webMethods Server reads the  data from the Process Audit Log database component and passes it to My webMethods  to display. it is a Type 4 JDBC  native‐protocol driver that does not have a server component. see the  webMethods JDBC Adapter documentation. For some products. The following chapters provide instructions for creating  database users and storage. Note: If you want webMethods products to exchange data with non‐webMethods  databases. you set up the products to use the appropriate  connection pools. Database Users and Storage You can create a single database user for all webMethods database components or you  can create a database user for each database component. A  webMethods database component is a grouping of database objects that can be used by  one or more webMethods products. see the webMethods  System Requirements. 84 webMethods Installation Guide Version 7. Integration Servers write process status  data to the Process Audit Log database component.6 driver with webMethods products.8 Preparing for Database Component Configuration webMethods Products and Databases webMethods products use Java Database Connectivity (JDBC) to interact with databases. To enable webMethods products to interact with a database component. to query and update data in webMethods database components. The products use the  driver to convert JDBC requests from Java programs directly into the vendor‐specific  database protocol that each type of RDBMS can understand. After product installation and  database component creation is complete. usually during product installation. For more information. you provide  database connection parameters. you configure the JDBC  connection pools after product installation. such as Optimize.x . For the list of RDBMSs supported by the webMethods product suite. webMethods products  execute DDL commands at install time and sometimes design time for each RDBMS with  which they interact. You can create all database  component objects in the same storage or you can create the objects for each database  component in its own storage.

. Database sort order determines collation and comparison  behavior. you can check whether the selected RDBMS is configured for the Unicode  character set.x 85 . Software AG strongly  recommends choosing a Unicode encoding for your database and the most appropriate  sort order for your environment. consult your database  administrator and your RDBMS vendor’s documentation so you can carefully choose a  database character set that supports the languages your data is in.1 or higher UTF‐8 Universal character set. Oracle supports the UTF8 and AL32UTF8 Unicode encodings. For  nchar data types. Oracle webMethods database schemas for Oracle use character data types. For character data  types. Oracle supports the AL32UTF8 and AL16UTF16 Unicode encodings. 8 Preparing for Database Component Configuration Database Administrator Account You need DBA access only if you want to use the webMethods Database Component  Configurator to create the necessary database users and storage objects. Software AG  recommends these character sets and sort order:  For.  Important! You must set character set and sort order before creating webMethods  storage. While UTF8 is  CESU‐8‐compliant and supports the Unicode 3. A database character set determines which languages a  database can represent. webMethods products are designed to use the database users you create for the database  components.. Character Set and Sort Order webMethods products are globalized and support Unicode. If the RDBMS does not support Unicode. The sections below list the most appropriate Unicode character encoding and sort order  for each RDBMS that the webMethods product suite supports... the configurator lists the character  set the RDBMS does support. Software AG recommends. If you want to use a  different character set or sort order than recommended below.  AL32UTF8 conforms to the Unicode 3. Character set AL32UTF8 Nchar character set AL16UTF16 Sort order Binary webMethods Installation Guide Version 7.  webMethods’ Oracle database schemas do not have linguistic indexes.0 UTF‐8 Universal character set.1.  The supported Unicode version for AL32UTF8 depends on the Oracle database version. If you use the webMethods Database Component Configurator to create your database  components.

 DB2 supports UTF‐8 for  character data types and UTF‐16 for graphic data types.8 Preparing for Database Component Configuration You can check database configuration and session settings by viewing the  SYS. Nchar character set UTF‐16 Sort order Any case‐insensitive collation type.   you will not be able to create some database components in  SQL Server. Windows. Software AG recommends these  character sets and sort order:  For. Important! If you do not choose a case‐insensitive sort order. For DB2 for   iSeries... SQL Server webMethods database schemas for SQL Server use nchar data types... Unix. 86 webMethods Installation Guide Version 7.1.x . This option is only  available for DB2 for Linux..NLS_DATABASE_PARAMETERS or V$NLS_PARAMETERS parameter.   Software AG recommends these character sets and sort order: For. SQL Server  provides support for UTF‐16 through its nchar data types.. Graphic Character Set UTF‐16 Sort order IDENTITY_16BIT Note: This sort order ensures the same sorting result for both  character and graphic data types. DB2 webMethods database schemas for DB2 use character data types. Character set The appropriate encoding for the languages your data is in. sort order is always binary order when the database  character set is UTF‐8. Software AG recommends. Character set CCSID 1208 (UTF‐8) Note: My webMethods Server requires this character set. You can check the database configuration using the sp_helpdb database stored procedure... Since nchar data types are  always in UTF‐16. Software AG recommends. you do not have to perform any special database configuration and can  choose the most appropriate code page for your environment as a database character set.

8 Preparing for Database Component Configuration

You can check the database configuration by using the following: 

RDBMS Use...
DB2 for Linux, Unix,  GET DATABASE CONFIGURATION command
Windows
DB2 for iSeries DSPFD command to check the database file description

Page and Block Size
Use the page and block sizes specified below for each type of RDBMS.

RDBMS Required Page and Block Size Default
Oracle 8k page/block size 8k
SQL Server 8k page/block size 8k
DB2 32k page size 4k

Set Database Options

Oracle
For webMethods products to function properly, you must set the 
NLS_LENGTH_SEMANTICS initialization parameter to BYTE. 

Important! webMethods uses BYTE rather than CHAR semantics because BYTE is the 
default configuration of Oracle database and is used by most Oracle users. If you try 
to use webMethods products with CHAR semantics, unexpected results might occur. 
For example, since CHAR semantics allow storage of longer data than BYTE 
semantics (for Japanese, varchar(12 byte) takes four characters in UTF8 while 
varchar(12 char) takes 12), using CHAR semantics could cause the buffer in some 
products to overflow.

SQL Server
The following database settings are required for webMethods products to function 
properly:
ALTER DATABASE database_name SET ALLOW_SNAPSHOT_ISOLATION ON;
ALTER DATABASE database_name SET READ_COMMITTED_SNAPSHOT ON;

By default, SQL Server uses case‐insensitive collations. If you create the My webMethods 
Server database component, do not change this option from the default; My webMethods 
Server does not support case‐sensitive collations.

webMethods Installation Guide Version 7.1.x 87

8 Preparing for Database Component Configuration

Download the Database Scripts and Database Component
Configurator
The database scripts and the Database Component Configurator are available through 
the webMethods Installer. For complete instructions on using the webMethods Installer, 
see previous chapters in this guide.
1 Download the webMethods Installer from the webMethods Advantage Web site to 
the appropriate machine, as follows: 

If you are going to create database
components using... Download the webMethods Installer to...
Scripts A machine equipped with the database client for 
your type of RDBMS
Database Component  Any machine on the same network as your 
Configurator database server

2 Start the webMethods Installer. 
3 In the product selection list, select Database Component Configurator.

88 webMethods Installation Guide Version 7.1.x

8 Preparing for Database Component Configuration

Change Environment Settings
The Database Component Configurator has the default environment settings shown 
below. If necessary, you can change them as described below.
1 Go to the webMethods_directory\common\db\bin directory.
2 Open the setEnv.{bat|sh} file in the text editor and edit the fields as necessary. 

Determines whether the Database Component
Setting Configurator... Default
‐DtermOutOn Writes execution information to the  true
console.
‐DspoolOn Logs execution information. true
‐DlogLevel Sets the log level to INFO (high‐level  INFO
information) or DEBUG (more detailed 
information, including internal 
processing and SQL calls).
‐Dlog.dir This setting specifies the full path to the  webMethods_directory\
directory in which to store the log files.  common\db\logs
Make sure you have permission to write 
to this directory.

3 Save and close the file.

Default Storage Convention
By default, all webMethods database components follow this storage convention: 

RDBMS Data Storage Unit Index Storage Unit BLOB Storage Unit
Oracle tablespaces WEBMDATA WEBMINDX WEBMDATA
SQL Server filegroups Primary Primary Primary
DB2 for Linux, UNIX,  WEBMDATA WEBMINDX WEBMBLOB
Windows tablespaces
DB2 for iSeries Default Default Default

If you want to use a different storage convention during database component creation, 
modify the values listed above in the database component SQL scripts. The scripts are 
located in the webMethods_directory\ common\db\scripts directory.
You can modify webMethods storage convention by directly modifying the scripts. 
Commercial and public domain utilities provide search and replace functionality across  
subdirectories. The webMethods product suite supports all tablespace configurations 
deployed by customers.

webMethods Installation Guide Version 7.1.x 89

 trigger joins. IS Internal. Cross Reference. Cross Reference. guaranteed delivery. 90 webMethods Installation Guide Version 7. ence Document  Document history information for exactly‐once processing in publish‐ History and‐subscribe solutions. If you are not clustering Integration Servers. If you are clustering Integration Servers.1. Document History database component. guaranteed delivery. Database Component Data that Integration Server Writes IS Internal Scheduled tasks and client certificate mappings. and run‐time data for  pub. and or have exhausted trigger retries. see the  relevant product documentation. and  IS Core Audit Log. Integration Server uses the information to  detect and reject duplicate documents. Note: For detailed information on concepts mentioned in the sections below. and session audit data. and IS Internal database  component for each Integration Server. If you are  Audit Log using triggers. You can create a separate IS Core Audit Log  database component for each Integration Server or you can create a single IS Core Audit  Log database component for the Integration Servers to share. Integration  Server Administrator and My webMethods display different parts of  the data.storage services. and the  scheduler. you  can skip this section.8 Preparing for Database Component Configuration Database Component Descriptions and Installation Requirements Each section below provides brief descriptions of database components. followed by  installation requirements. IS Core  Error.x . Document History. Cross Refer‐ Cross‐referencing data for publish‐and‐subscribe solutions. and IS Core Audit Log Database Components Note: If you chose to use the embedded IS Internal database during installation. Document History. service. create a separate Cross Reference database  component. have failed. create one of each of the following database  components for the cluster to share: IS Internal. Integration Server also stores documents that are in  doubt.

 it archives the data  from the sources to these copies.  and then create a DBlink name for Archive to use to link to each source. you must create Archive in the same database as the source IS Core  Audit Log and Process Audit Log database components. create a separate Process  Engine database component for each Process Engine. Process Engine Database Component Process Engines write process execution data to this database component. If you are not clustering Process Engines. Optimize Analytic Engines. If you are clustering Process Engines. or both to  the Archive database component. Optimize Analytic Engines read process data  so they can analyze capabilities such as transition duration and write data about analysis‐ enabled processes. Archive can use the same  DBLink to connect to both sources. you can  create either a separate Process Audit Log database component for each Process Engine  or a single Process Audit Log database component for the Process Engines to share. create a single Process Audit Log database component for all to  share. If you are not clustering Process Engines. 8 Preparing for Database Component Configuration Process Audit Log Database Component Process Engines write process status data and Task Engines write task status data to the  Process Audit Log database component. If you are using Oracle or SQL Server. Archive Database Component Archiving functionality available through Monitor can archive data from the IS Core  Audit Log database component. Third‐party products can also send process  execution data to this database component. you can create Archive in a different database  server than the source IS Core Audit Log and Process Audit Log database components. webMethods Installation Guide Version 7. Create a single Process Audit Log database components for all Task Engines to share. the Process Audit Log database component. My webMethods displays the data.x 91 . create a single Process Audit Log database  component for the cluster to share. If IS Core Audit  Log and Process Audit Log are on the same database server. The Archive database component creates a copy of the IS Core Audit Log and Process  Audit Log database components in the same database or schema. You must create Archive in the same type of RDBMS as  the source IS Core Audit Log and Process Audit Log database components. or some  combination of these. create a single Process Engine database component  for the cluster to share. If you are clustering Process Engines. If you are using DB2. Task Engines. If you are using Process Engines.1.

If you are clustering Trading Networks Servers. My webMethods displays the data. configuration.1.  and business data.8 Preparing for Database Component Configuration Metadata Reasoner and Metadata Repository Database Components Metadata Library writes and reads metadata required to find or reuse assets to and from  these database component. task distribution. create a separate Trading Networks database component for each Trading  Networks Server. Create one Metadata Reasoner database component and one Metadata Repository  database component for Metadata Library. The metadata in the two database components differs in that it is  optimized for different operations. create a single My webMethods Server  database component for the cluster to share. create a single Trading Networks  database component for the cluster to share. trading partner agreements. create a separate My webMethods Server database component for each My  webMethods Server. portal  pages. Optimize Prediction Engines evaluate the data and  generate prediction events. Trading Networks  archiving functionality can archive data from the Trading Networks database component  to the Trading Networks Archive database component. If you are clustering My webMethods Servers. Trading Networks Console displays data. If you are not clustering My webMethods  Servers. The metadata can come from Designer.x . and delivery information) to the Trading  Networks database component. If you are not clustering Trading Networks  Servers. Trading Networks and Trading Networks Archive Database Components Trading Networks Server writes metadata (partner profiles. The Task Engine writes task status. 92 webMethods Installation Guide Version 7. attributes.  document types. and run‐time operations to this database component. it uses this data to manage  My webMethods user interfaces. Analysis and Process Tracker Database Components Optimize Analytic Engines write computed analytics and process and monitoring data  received from Infrastructure Data Collectors and Web Service Data Collectors to the  Analysis database component. document content parts. Integration Server. security. and partner profile groups) and run‐time data  (documents. processing rules. Create the Trading Networks Archive database component in the same  database as the source Trading Networks database component. Trading Networks Server also logs entries about  document processing steps. or  a UDDI registry. My webMethods Server Database Component My webMethods Server writes data about deployment.

Create a single Analysis database component and a single Process Tracker database  component for all Optimize Analytic Engines to share. My  webMethods displays the data. 8 Preparing for Database Component Configuration Optimize Analytic Engines write business and process data received from Process  Engines and Web Service Data Collectors to the Process Tracker database component.x 93 . Database  Provides core routines for data purge functionality. You can then generate reports that contain aggregated data about  processes and tasks. install the Reporting or Staging database  components on a database server that will not adversely affect the Process Audit Log or  the Process Engine database components. For best performance. Operation  Provides a common method for configuration. Resources can be locked for exclusive use. to prevent another server from  updating the resource as it is being accessed.1. or for shared use. You can create the Reporting and Staging database components in the same database. Staging and Reporting Database Components Monitor populates these database components with data from the Process Audit Log  database component. the services that populate the Reporting database component consume large  amounts of CPU. webMethods Installation Guide Version 7. such as  tablespaces and user credentials. and  Management error handling for any database component. for all database components.  Database Component and Version Description Component  Tracks the database components that are created or dropped. Management Distributed  Coordinates access to resources across a distributed collection of  Locking servers and processes. The Storage database component creates default webMethods storage structures. Infrastructure Database Components The table below lists infrastructure database components that are automatically created  when you create product‐related database components.  However. Tracker DataPurge Provides a common method for purging data from the Analysis  and Process Tracker database components. logging.  to prevent another server from accessing the resource as it is  being updated.

8 Preparing for Database Component Configuration 94 webMethods Installation Guide Version 7.x .1.

. . . . . . . . . . . . . . . . 110 webMethods Installation Guide Version 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9 Creating and Dropping Database Components „ Use the Graphical User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1. . . . . . . . 101 „ Use Database Scripts . . . . . . . . . . . . . . . . . . . . . . . .x 95 . . . . . . . . . . . . . . . 96 „ Use the Command Line .

When specifying the URL for DB2. The configurator writes execution information to the Results tab and to a log file named  dcc_yyyymmddHHMMss in the webMethods_directory\common\ db\logs directory.x .AlternateId=cschema. you must specify these connection options  in the URL: . if the product will connect to a schema other than the  default schema for the specified database user.9 Creating and Dropping Database Components Use the Graphical User Interface This section explains how to use the Database Component Configurator graphical user  interface to create or drop a database user and storage. and to create or drop webMethods  database components.1. 96 webMethods Installation Guide Version 7. Each run of the configurator operates on a single schema.InitializationString="SET CURRENT PATH=schema" AlternateID is the name of the default schema that is used to qualify unqualified  database objects in dynamically prepared SQL statements.

 You can change these  values and specify other field values. then later import the values  from a file by clicking Import Configuration.x 97 .  and DB2 for Linux.xml files by clicking Export. Windows. go to ProgramswebMethods7ToolsDatabase Component Configurator. you must create the database  user and storage using scripts (see “Use Database Scripts” on page 110). 9 Creating and Dropping Database Components Create Database Components and Create a Database User and Storage You can use the configurator to create a database user and storage in Oracle. Initially. SQL Server. you can set the current field  values as the defaults for subsequent runs by clicking Save Settings as Default. You can  also export field values to . webMethods Installation Guide Version 7. some of the fields on the the Inputs tab show values you entered for the same  fields in the webMethods Installer during product installation. 1 On the Start menu. In each case.1. For DB2 for iSeries. If you intend to run the configurator more than once. the values for the two Password  fields are not saved. UNIX.

1 in the Version list. select a product whose database components to create. checkEncoding Checks whether your RDBMS is configured for the Unicode  character set.  Document History. click the action to perform. IS Internal. 98 webMethods Installation Guide Version 7. recreate Drops.9 Creating and Dropping Database Components 2 In the Action Type list. If it is not. Process Tracker. and Process Audit Log Trading Networks Trading Networks 4 The contents of the Version list vary based on your choice in the Database Component  list. „ If you selected ALL in the Database component list.  Reporting. click 7. lists the character set the RDBMS does  support on the Results tab. the database components you select in the  Database component list. The product options map to the database components listed below. The  will create the latest version of all the webMethods database components. create Creates the database components you select in the Database component list. Staging. as follows: „ If you selected a product in the Database component list. “Development Environments”). then re‐creates.x . 3 In the Database Component list. „ If you selected a database component in the Database component list. as follows:  Option Action catalog Displays existing database components on the Results tab.  select one database component to create. Product Database Components Integration Server IS Core Audit Log. and Cross Reference Metadata Library Metadata Repository and Metadata Reasoner My webMethods Server My webMethods Server Optimize Analysis. Process Audit Log. click the  proper version for your product (see Chapter 1. Process Engine.1. or choose to create all database components. click Latest in the Version list. and lets you create a database user and storage.

 identify the database user or operating system user that has  database administrator credentials to create the database user and storage. webMethods Installation Guide Version 7. UNIX.sysLoginRole=sysdba). Important! If you are using Oracle. use the Tablespace directory field only if the DB_CREATE_FILE_DEST  parameter is not set for your Oracle instance. b In the Admin ID field. in the Tablespace directory field. . Windows. Windows. Sample URL formats are  displayed. 9 Creating and Dropping Database Components 5 Specify the connection for the configurator to use to connect to the RDBMS. Drop Database Components Before dropping. go to ProgramswebMethods7ToolsDatabase Component Configurator. drop Drops the database components you select in the Database component  list. you must specify the sysLoginRole connection  option on the URL (for example. as follows: Value Action catalog Displays existing database components on the Results tab. The execution information is displayed on the Results tab and is written  to the log file dcc_yyyymmddHHMMss in the webMethods_directory\common\db\logs  directory. For Oracle. For SQL Server. and are going to create storage and the Data  Purge database component. c For DB2 for Linux.  specify the database user and password to create.x 99 .1. shut down all webMethods products that are connected to the database  component and back up the database component. 7 Click Execute. c If you are going to create a database user and storage in Oracle or SQL Server. click the action to perform. 6 If you selected create in the Action Type list. specify the OS user  to which to grant permissions. click the RDBMS in which to create the database components.  Supply the password for the user in the Admin password field. 1 On the Start menu. a In the RDBMS list. UNIX. If you are going to create a  database user and storage in DB2 for Linux. 2 In the Action list. If you are not going to create a database user and  storage. identify the  directory in which to create the tablespaces. specify an existing database user and password. provide the URL for the RDBMS. specify the database to create. a Select the Create tablespaces and database user check box. b In the URL field. you can create a database user and storage. in the Database field.

 provide the URL for the RDBMS. b In the URL field. you can drop the storage and revoke  the database user permissions.x . UNIX. 6 Click Execute. 4 The contents of the Version list vary based on your choice in the Database Component  list. SQL Server. provide the URL for the RDBMS. Drop the Storage and Revoke Database User Permissions If you drop all database components in a schema.1. go to ProgramswebMethods7ToolsDatabase Component Configurator. you must drop the database user and  storage using a script (see “Use Database Scripts” on page 110). a In the RDBMS list. 1 On the Start menu. 5 Specify the connection for the configurator to use to connect to the RDBMS. 100 webMethods Installation Guide Version 7. For DB2 for iSeries. „ If you selected a database component in the Database component list. click ALL. select a product whose database components to drop. click drop.  select one database component to drop. click the RDBMS from which to drop the database components. Sample URL formats are  displayed. Windows. c Specify the database user and password to use to connect to the RDBMS in the  User ID and Password fields.1 in the Version list. click 7. a In the RDBMS list. You can use the configurator to drop the storage for Oracle. 3 In the Database component list. „ If you selected ALL in the Database component list. click the  proper version for your product (see Chapter 1.  Sample URL formats are  displayed. The execution information is displayed on the Results tab and is written  to the log file dcc_yyyymmddHHMMss in the webMethods_directory\common\db\logs  directory. 4 Specify the connection for the configurator to use to connect to the RDBMS. and DB2 for  Linux. as follows: „ If you selected a product in the Database component list.9 Creating and Dropping Database Components 3 In the Database Component list. or choose to drop all database components. b In the URL field. “Development Environments”). 2 In the Action list. c Specify the database user and password to use to connect to the RDBMS in the  User ID and Password fields. click Latest in the Version list. click the RDBMS from which to drop the database components.

6 Click Execute. webMethods Installation Guide Version 7.  identify the directory that contains the tablespaces to drop. shut down all webMethods products that are  connected to the database component. SQL Server. You can use the command line to drop  storage for Oracle.x 101 . Supply  the password for the database user in the Admin password field. Before dropping any database component. you can drop the  storage and revoke the database user permissions. UNIX. in the  Database field. UNIX. Command line mode lets you create a database user and storage in Oracle. identify the database user or operating system user that has  database administrator credentials to drop the database user and storage. and DB2 for Linux. If you have dropped all the database components from a schema. SQL Server.1. in the Tablespace directory field. 9 Creating and Dropping Database Components 5 Select the Drop tablespaces and database user check box. UNIX. and to create or drop webMethods  database components. The execution information is displayed on the Results tab and is written  to the log file dcc_yyyymmddHHMMss in the webMethods_directory\common\db\logs  directory.  and DB2 for Linux. a In the Admin ID field. Windows. For SQL Server. Windows.  you must drop storage using scripts (see “Use Database Scripts” on page 110). you must create the database  user and storage using scripts (see “Use Database Scripts” on page 110). b For DB2 for Linux. and Oracle. Use the Command Line This section explains how to use Database Component Configurator command line mode  to create or drop a database user and storage. For DB2 for iSeries. For DB2 for iSeries. Each run of the configurator operates on a single schema. specify the database to create. Windows.

drop Drops db_component or the database  components for product.  You run the command from the webMethods_directory\common\db\bin directory. then creates   db_component or the database  components for product. create Creates db_component or the database  components for product. lists the  supported character set. Important! Before dropping. 102 webMethods Installation Guide Version 7. using the command below. or  on the database components for one webMethods product.x . If it is not.  dbConfigurator.9 Creating and Dropping Database Components Database Component Configurator Command You can perform an action on one database component or on all database components. you must  shut down all webMethods products that  are connected to the database component  and back up the database component.{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] [-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 Action to perform.1. Value Action catalog Displays existing database components. recreate Drops db_component or the database  components for product. checkEncoding Checks whether the RDBMS specified on  the command is configured for the  Unicode character set.

 Windows db2i DB2 for iSeries {-c|--component} Database component version for which to perform action. sqlserver|db2luw| db2i} Value DBMS oracle Oracle sqlserver SQL Server db2luw DB2 for Linux. Code Name ALL All database components ANL Analysis ARC Archive CTR ComponentTracker XRF CrossReference DTP DataPurge DBM DatabaseManagement DSL DistributedLocking IDR DocumentHistory ISC ISCoreAudit ISI ISInternal MTR MetadataReasoner MTD MetadataRepository MWS MywebMethodsServer OPM OperationManagement PRA ProcessAudit PRE ProcessEngine PTR ProcessTracker PRP Reporting PST Staging STR Storage TNS TradingNetworks TNA TradingNetworksArchive webMethods Installation Guide Version 7.1. UNIX.x 103 . you can specify the database component  code or name. 9 Creating and Dropping Database Components Parameter Entry {-d|--dbms} {oracle| RDBMS on which to perform action.  db_component {-v|--version} version For db_component.

  specify the version of the database  component (see Chapter 1. If you specified ALL for db_component. Process Tracker. Reporting. {-pr|--product} product Product release for whose database components to perform  {-v|--version} release action. Process  Server Engine.  For product. perform action for the  latest version of db_component.1. Value Description latest If you specified one database component  for db_component. you can specify the product code or name. and Process  Optimize Audit Log TN or Trading Trading Networks Networks 104 webMethods Installation Guide Version 7. you must specify latest for  db_component_version. version If you are performing action on a  database component other than Storage. Code or Product Maps to These Database Components IS or  IS Core Audit Log. you can specify these values.9 Creating and Dropping Database Components Parameter Entry For version. Document History. Process  Integration Audit Log. and Cross  Reference ML or Metadata Metadata Repository and Metadata  Library Reasoner MWS or My My webMethods Server webMethods Server OPTI or Analysis. Staging. The configurator  will create the latest version of each  database component.x . IS Internal.  “Development Environments”).

option=value …] Windows DB2 for iSeries jdbc:wm:db2://server:{446|port} . release Release of the product for whose  database components to perform action. RDBMS Sample Format Oracle jdbc:wm:oracle://server:{1521|port} . Value Description latest Perform action on the database  components for the latest release of  product.option=value …] webMethods Installation Guide Version 7.sysLoginRole=sysdba).x 105 . . you can specify the values below. 9 Creating and Dropping Database Components Parameter Entry For release.databaseName=database[.1.option=value …] DB2 for Linux.  The configurator will create the correct  versions of the database components for  the specified release. {-l|--url} RDBMS_URL URL for the RDBMS.option=value …] Important! If are going to create storage  and the Data Purge database component.  you must specify the sysLoginRole  connection option on the URL (for  example. SQL Server jdbc:wm:sqlserver://server:{1433|port } .serviceName=service[.  .databaseName=database[.   jdbc:wm:db2://server:{50000|port} UNIX.locationName=location[.

 UNIX.1. For Oracle. Important! For DB2. or Oracle. specify the OS user to  which to grant permissions. 106 webMethods Installation Guide Version 7. Windows. If you are creating a database user and storage in  DB2 for Linux.9 Creating and Dropping Database Components Parameter Entry Important! When working with database components on  UNIX systems.x . like create or drop. specify the database user and password to  password create. [-pc|--printComponents] Prints database components the configurator supports. {-u|--user} db_user If you are creating a database user and storage in Oracle or  {-p|--password} SQL Server.  Windows. [-n|--dbname] If you are creating a database user and storage in SQL  Server. [-pd|--printDatabase] Prints RDBMS the configurator supports. [{-au|--admin_user} If you are creating a database user and storage. you must enclose the URL in double  quotes.InitializationString="SET CURRENT PATH=schema" AlternateID is the name of the default schema that is used  to qualify unqualified database objects in dynamically  prepared SQL statements. [-t|--tablespacedir] If you are creating a database user and storage.AlternateId=schema. password] Additional Parameters [-r|--runCatalog] Runs the catalog action at the end of every execution. [-pa|--printActions] Lists the actions you can perform. full path to the directory. you must specify these connection options  in the URL: . If you are not creating a database user and storage. name of the target database. if you are creating database components  in a schema other than the default schema for the specified  database user. and want to  create a tablespace directory for DB2 for Linux. [-h|--help] Prints command line help. specify the  db_admin_user database user or operating system user and password that has  {-ap|--admin_password} the necessary database administrator credentials.  use this parameter only if the DB_CREATE_FILE_DEST  parameter is not set for your Oracle instance. [-ab|--about] Prints  information about the Database Component  Configurator. specify  an existing database user and password. UNIX.

bat -a create -d oracle -c storage -v latest -l jdbc:wm:oracle://DBserver:1521.xml file.bat -a create -d sqlserver -c storage -v latest -l jdbc:wm:sqlserver://DBserver:1433. directory {-file|--configfile} file {-i|--import} Imports values for all parameters from an . file Examples Important! On UNIX systems.bat -a create -d db2luw -c storage -v latest -l jdbc:wm:db2://vmxpdb01:50000.1. {-dir|--configdir} directory Note: Password parameters are not saved. so you must  {-file|--configfile} specify them on the command.x 107 .xml file.serviceName=myservicename -au adminuser -ap adminpass -u webmuser -p w3bmpass -t tablespace_dir This command creates the webMethods database and database user for SQL Server:  dbConfigurator. [-pe] Prints command line examples. Create a Database User and Storage This command creates the two webMethods tablespaces and the database user for Oracle: dbConfigurator. 9 Creating and Dropping Database Components Parameter Entry [-pp|--printProducts] Prints webMethods products the configurator supports.databaseName=amol -u webmuser -au adminuser -ap admin_password -t tablespace_dir webMethods Installation Guide Version 7. {-e|--export} Exports values for all required parameters except the  {-dir|--configdir} password parameters to an . and grants  permissions for DB2:  dbConfigurator. you must enclose the RDBMS URL in double quotes.databaseName=master -u webmuser -p w3bmpass -au sa -ap sa_password -n webmdb This command creates the webMethods bufferpool and tablespaces.

serviceName=myservicename -u webmuser -p w3bmpass This command recreates (drops and then creates) the latest versions of all database  components in SQL Server: dbConfigurator.1. UNIX.bat -a drop -d oracle -c storage -v latest -l jdbc:wm:oracle://DBserver:1521. and revokes  permissions for DB2:  dbConfigurator.bat -a catalog -d db2udb -l jdbc:wm:db2://DBserver:50000. SQL Server. Windows: dbConfigurator.databaseName=webmdb -u webmuser -p w3bmpass 108 webMethods Installation Guide Version 7. you can drop the storage and revoke  the database user permissions. and DB2 for  Linux.bat -a create -d oracle -c processaudit -v 30 -l jdbc:wm:oracle://DBserver:1521. For DB2 for iSeries.serviceName=myservicename -au adminuser -ap adminpass -u webmuser -p w3bmpass -t tablespace_dir This command drops the webMethods database for SQL Server:  dbConfigurator.bat -a drop -d sqlserver -c storage -v latest -l jdbc:wm:sqlserver://DBserver:1433. you must drop the database user and  storage using a script (see “Use Database Scripts” on page 110). Windows.bat -a drop -d db2luw -c storage -v latest -l jdbc:wm:db2://vmxpdb01:50000.9 Creating and Dropping Database Components Drop the Storage and Revoke Database User Permissions If you drop all database components in a schema.  UNIX. This command drops the two webMethods tablespaces for Oracle:  dbConfigurator.databaseName=webmdb -u webmuser -p w3bmpass This command displays the database components that currently exist in DB2 for Linux.databaseName=master -u webmuser -p w3bmpass -au sa -ap sa_password -n webmdb This command drops the webMethods bufferpool and tablespaces. You can use the configurator to drop the storage for Oracle.x .bat -a recreate -d sqlserver -c all -v latest -l jdbc:wm:sqlserver://DBserver:1433.databaseName=amol -u webmuser -au adminuser -ap admin_password -t tablespace_dir Create Database Components This command creates Process Audit Log v30 in Oracle: dbConfigurator.

serviceName=myservicename -u webmuser -p w3bmpass This command drops the latest versions of all database components from SQL Server:  dbConfigurator.bat -a drop -d db2luw -c analysis -v latest -l jdbc:wm:db2://DBserver:50000.1.AlternateId=ALTSCHEMA .databaseName=webmdb -u webmuser -p w3bmpass This command drops the latest version of the Analysis database component from DB2  when dropping from ALTSCHEMA rather than the default schema for the specified  database user:  dbConfigurator.x 109 . You cannot drop the Component Tracker database component using the configurator.databaseName=webmdb .InitializationString=\”SET CURRENT PATH=ALTSCHEMA\”” -u webmuser -p w3bmpass Drop Database Components Before dropping.InitializationString="SET CURRENT PATH=ALTSCHEMA" -u webmuser -p w3bmpass webMethods Installation Guide Version 7.databaseName=webmdb. For instructions.bat -a create -d db2luw -c all -v latest -l “jdbc:wm:db2://DBserver:50000.databaseName=webmdb -u webmuser -p w3bmpass The command drops the latest version of the Analysis database component from DB2 for  Linux. UNIX. This command drops Process Audit Log v30 from Oracle: dbConfigurator -a drop -d oracle -c processaudit -v 30 -l jdbc:wm:oracle://myserver:1521. Windows: dbConfigurator.bat -a drop -d db2luw -c analysis -v latest -l jdbc:wm:db2://DBserver:50000.bat -a drop -d sqlserver -c core -v latest -l jdbc:wm:sqlserver://myserver:1433.AlternateId=ALTSCHEMA. shut down all webMethods products that are connected to the database  component and back up the database component.  you must use a script. 9 Creating and Dropping Database Components This command creates the latest database components in DB2 when creating in  ALTSCHEMA rather than the default schema for the specified database user: dbConfigurator. see “Use Database Scripts” on page 110.

 run this command:  dbConfigurator.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i} -c storage -v latest Drop Storage and Revoke Database User Permissions If you have dropped all database components from a schema.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i} -c storage -v latest Create Database Components Create the proper versions of the database components for your product (see Chapter 1. from your database client. To determine which scripts to run. To list the scripts for dropping storage and revoking database user permissions. go to the webMethods_directory\common\db\bin  directory and run the appropriate command below.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i} -pr product -v product_release 110 webMethods Installation Guide Version 7. stored in the  webMethods_directory\common\db\scripts directory. For explanations of the fields in the  commands below. or all database  components. you can drop the database  user and storage. run this  command:  dbConfigurator. drop storage and revoke the database user permissions. Create a Database User and Storage To list the scripts for creating a database user and storage. To list the scripts for creating individual database components. The order in which the scripts are  listed is the order in which you should run them.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i} -c db_component -v db_component_version To list the scripts for creating the database components for a certain webMethods  product. You run the scripts. see “Database Component Configurator Command” on page 102.x .  “Development Environments”).9 Creating and Dropping Database Components Use Database Scripts This section explains how to use SQL scripts provided by webMethods to create a  database user and storage. run this command: dbConfigurator. run this command:  dbConfigurator. and to  create or drop webMethods database components.1.

 or all database  components. To list the scripts for dropping individual database components. shut down all webMethods products that are connected to the database  component and back up the database component. run this command:  dbConfigurator.x 111 .1. run this command: dbConfigurator.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i} -pr product -v product_release webMethods Installation Guide Version 7. 9 Creating and Dropping Database Components Drop Database Components Before dropping.{bat|sh} -a print -d {oracle|sqlserver|db2luw|db2i} -c db_component -v db_component_version To list the scripts for dropping the database components for a certain webMethods  product.

1.x .9 Creating and Dropping Database Components 112 webMethods Installation Guide Version 7.

. . . . . . . .1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 „ Complete the Metadata Library Installation . . . . . . . . . . . . . . . . . . . . 129 „ Installed JDKs and Product JDK Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 „ Connect Products to Each Other . . . . . . . . . . . . . . . 120 „ Complete the Monitor Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 „ Configure Logging . . . . . . . 133 „ Complete the Installation for Other Products . 115 „ Complete the Integration Server Installation . . . . . . .10 Completing the Installation „ Post-Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 „ Connect Products to Database Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139 webMethods Installation Guide Version 7. . . . . . . . 121 „ Complete the Optimize Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .x 113 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 „ Complete the webMethods Broker Installation . . .

 if you are not using SVG.1. configure Broker Monitor to start  115 automatically when you start the system Integration Server On UNIX. set up  121 graphical display Optimize Configure Optimize (see the webMethods Central  Configuration and Deployment Guide) Most products Connect products to each other 122 Most products Connect products to webMethods database  129 components Configure Logging You can log various types of data for webMethods products. 114 webMethods Installation Guide Version 7.5 Monitor On UNIX systems. configure Metadata Library (see the   webMethods Metadata Library User’s Guide) On AIX systems. prevent memory problems 118 Metadata Library If you will use the Central Configurator to manage  Metadata Library.x . Additional sections in this chapter provide detailed instructions for  optional tasks you might want to perform. redirect Metadata Library to use the  120 Java 5 32‐bit IBM JDK 1. adjust per‐process thread and  115 kernel limits On UNIX systems. IBM i5. and Mac systems. Product Task Page webMethods Broker Make sure the Broker Server is running and the  115 default Broker exists On HP‐UX systems. if you are using a  116 Sun JDK.10 Completing the Installation Post-Installation Checklist The checklist below identifies tasks you need to perform to make an installation of  webMethods products operational. see the webMethods Logging Guide. and Mac systems. For detailed information  and instructions on setting up logging. Subsequent sections in this chapter or book provide  detailed instructions. IBM i5. increase file  117 descriptors On IBM i5 Systems. increase PermGen space On UNIX.

  you must configure the Broker Monitors to run as daemons. If  you installed webMethods Broker on a UNIX system. 10 Completing the Installation Complete the webMethods Broker Installation Make Sure the Broker Server is Running and the Default Broker Exists After installation. Configure Broker Monitors to Start Automatically on UNIX Systems By default. If you configure multiple Broker Monitors  to run as daemons. 3 Replace the “wm” in wm_broker71 with “Snumber. see the HP‐UX system manual.1.x 115 . 2 Copy each Broker Monitor startup script wm_broker71 to the appropriate UNIX  startup directory. level (for example. Make sure the Broker Server is running and  the default Broker exists by running this command: broker_status [Broker #1@]Broker Server_host[:Broker Server_port] You can also use My webMethods to make sure the Broker Server is running and the  default Broker exists (see the webMethods Broker Administrator’s Guide). or  priority. ask your system administrator  to adjust the per‐process thread limit and set the per‐process and kernel limit for the  maximum number of open files. Adjust Per-Process Thread Limit and Set Per-Process and Kernel Limit on HP-UX Systems If you installed webMethods Broker on an HP‐UX system. make the name for each Broker Monitor startup script unique  among the startup scripts in the UNIX startup directory (for example. S45_broker71). For instructions. and so on). webMethods Installation Guide Version 7. Broker Monitors run as applications that you start and shut down manually.  which begins running with a default Broker.” where number is the run. S45_broker71_2. and you want your Broker  Monitors to start and shut down automatically when your system starts and shuts down. Broker Monitor starts automatically and then starts Broker Server.  S45_broker71_1. 1 Go to the webMethods Broker_directory\Broker directory.

1 on Linux and Solaris  systems.1. 1 Go to the Integration Server_directory/bin directory and open the server. set the  environment variables LC_ALL and LANG to that locale. You do not have to reboot the AIX system for this change to take effect. Enable Full Core Dumps on AIX Systems On AIX systems. When you  restart the Broker Server. or if you are using your own  Sun JDK on one of those systems. you must increase the permanent  generation (PermGen) space from the default of 64 MB to at least 128 MB. and Mac Systems If you are using a Sun JDK with Integration Server.lang. ON  UNIX systems. English. However. Complete the Integration Server Installation Increase PermGen Space on UNIX. or an IBM i5 or Mac system. the Broker Server will use the default locale. the ability to perform full core dumps is not enabled. 116 webMethods Installation Guide Version 7.OutOfMemoryError: PermGen space exceptions when  running Integration Server. By default. the  webMethods Installer installs a Sun JDK for Integration Server 7. you set  your  shell to the proper locale before installation.  complete the steps below. Note: If you receive java.1. If you are using the default JDK on those systems. another UNIX system. Run the command smitty chgsys and set the value of Enable full CORE dump to true.sh file in a text  editor. IBM i5. English. if you want to set the Broker Server to run using a different locale. If you  want to enable this ability. U.10 Completing the Installation Set Locale on UNIX Systems If you are going to run webMethods Broker in a locale other than U.x .S. this setting only affects the  way the webMethods Installer starts your Broker Server during installation. set the PermGen space higher than 128 MB.S. do one of the following: „ Run this command: chdev -l sys0 -a fullcore=true „ Use the AIX System Management Interface Tool (SMIT). by default. 2 Uncomment these lines by removing the pound sign (#): #JAVA_MAX_PERM_SIZE=128M #JAVA_PERM_SIZESET=-XX:MaxPermSize=${JAVA_MAX_PERM_SIZE} 3 Save and close the file.

 ask the system administrator to  set the setrlimit value directly. Start Integration Server The tasks below require you to start Integration Server. Administrator and manage.  On most systems. so  if Integration Server requires more file descriptors. Open Integration Server Administrator in either of these ways: „ On the Windows Start menu. IBM i5. or change file  permissions to allow all users to run Integration Server (chmod). System Action Windows  On the Start menu. you might want to change the ownership of the  installed files to allow a single non‐root user to run Integration Server (chown). go to ProgramswebMethods7Integration Server Administrator. 10 Completing the Installation Increase File Descriptors and Change Permissions on UNIX. „ Enter the URL below in an Internet browser. It is dangerous to set the  rlim_fd_max value higher than 1024 because of limitations with the select function. If you installed Integration Server on a UNIX. change  the file group to the group of users who will run Integration Server (chgrp).sh  systems script.x 117 .  Important! You might have to increase this number depending on the number of files  Integration Server needs to have open at one time. IBM i5.1. and Mac Systems On UNIX. The default port for Integration Server is  5555. and Mac systems. All other  Go to the Integration Server_directory/bin directory and run the server. Integration Server’s ability to handle traffic is  constrained by the number of file descriptors available to the Integration Server process. webMethods Installation Guide Version 7. or Mac system and non‐root users  will be running Integration Server. IBM i5. http://Integration Server_host:Integration Server_port Log in under the default user name and password.1. go to ProgramswebMethods7ServersIntegration application Server. 64 file descriptors are available to each process by default. Windows  Go to the Services window and start the service webMethods Integration service Server 7.  webMethods recommends that you ask your system administrator to increase the  number of file descriptors available to the Integration Server process to at least 1024.

cnf files when it starts for the first time. c Locate the JAVA_MEMSET parameter and set it as follows: JAVA_MEMSET="-ms${JAVA_MIN_MEM}" d Save and close the file. Integration Server  creates the server. c Go to the Integration Server_directory/config directory and open the server. start it now.10 Completing the Installation Prevent Memory Problems on IBM i5 Systems If you installed Integration Server on an IBM i5 system. as follows: a If you have not yet started Integration Server.x . Prevent the JVM that Integration Server is using from running out of  memory by doing the following: a Go to the Integration Server_directory/bin directory and open the server. the JAVA_MIN_MEM setting acts as a garbage collection  threshold. b Locate the JAVA_MIN_MEM parameter and set it as follows: JAVA_MIN_MEM=64M Note: This setting is based on an IBM i5 system that hosts an Integration Server  and a DB2 for iSeries database.server. b Shut down Integration Server. The optimal value for initial heap size might  be higher or lower based on your system’s configuration. 2 On IBM i5 systems.portQueue=511 Save and close the file.cnf file  in a text editor.1. 118 webMethods Installation Guide Version 7. 1 Limit the size of the port queue available to the TCP/IP stack. prevent memory problems by  following the steps below. Add this line: watt.sh file in a  text editor.

10 Completing the Installation

Streamline Integration Server
By default, Integration Server is equipped with several packages that provide different 
types of functionality. If you want to streamline Integration Server (for example, because 
you are using it only to run adapters, or because you are running it as a Reverse HTTP 
Gateway server), you can disable many of these packages.
1 Review the table below and determine which packages you can safely disable. 

Package Contents
WmART Services that Integration Server uses to run webMethods 
adapters that are version 6.0 or later.
Important! Do not disable this package unless you are also 
disabling WmARTExtDC, or WmARTExtDC will not load.
WmARTExtDC Services the Infrastructure Data Collector uses to discover 
and monitor adapters installed on Integration Server.
WmAssetPublisher Services that Integration Server uses to extract and publish 
metadata about its services to Metadata Library.
WmFlatFile Services that enable you to process flat files and use file 
polling ports.
WmISExtDC Services the Infrastructure Data Collector uses to discover 
and monitor Integration Server.
Important! Do not disable this package unless you are also 
disabling WmTNExtDC and WmARTExtDC, or those 
packages will not load.
WmPRT,  Services that support business processes and tasks.
WmDesigner,  
WmOptimize, 
WmTaskClient
WmTomcat Services that support the servlet 2.4 and JSP 2.0 
specifications.
WmTNExtDC Services the Infrastructure Data Collector uses to discover 
and monitor Trading Networks Server.
WmUDDI Services that enable you to query and publish to a UDDI v2 
directory.
Note: This package has been deprecated and will not be 
available in the next release. You should use Developer to 
interact with UDDI v3 directories.
WmVCS Services that enable you to store Developer elements in a 
source control system.

webMethods Installation Guide Version 7.1.x 119

10 Completing the Installation

Package Contents
WmWin32 Services that enable you to call methods on COM objects. 
Also contains Windows‐specific samples, such as sample 
Visual Basic services.
Note: This package has been deprecated and will not be 
available in the next release.
WmXSLT Services that enable you to write XSLT services.

2 Start Integration Server and open Integration Server Administrator (see “Increase File 
Descriptors and Change Permissions on UNIX, IBM i5, and Mac Systems” on 
page 117).
3 Go to the PackagesManagement page and disable each package you do not need. To 
do so, locate the row for the package in the table, then click Yes in the Enabled column 
in that row. The Yes changes to No. 

Important! Never disable the WmRoot or WmPublic package.

Drop Redundant Database Component
If you used the Database Component Configurator to install database components, and 
you installed the Integration Server database component set and the Optimize database 
component set in two different schemas, you will have two instances of the Process Audit 
Log database component. Configure Integration Server and Optimize to point to the 
same instance using instructions in “Connect Products to Database Components” on 
page 129 and the webMethods Central Configuration and Deployment Guide, respectively. 
You can then drop the other instance (see the database chapters in this guide).

Complete the Metadata Library Installation

Configure Metadata Library
If you are going to use the Central Configurator to manage Metadata Library, you must 
configure Metadata Library using the Central Configurator. For instructions, see the 
webMethods Metadata Library User’s Guide.

Set up JDK on AIX Systems
If you installed Metadata Library on an AIX system, you must redirect Metadata Library 
to use the Java 5 32‐bit IBM JDK 1.5. For instructions, see “Redirect Products to Use a 
Non‐Default JRE or JDK” on page 135.

120 webMethods Installation Guide Version 7.1.x

10 Completing the Installation

Complete the Monitor Installation

Set Up Graphical Display on UNIX Systems
Monitor contains Java Swing and AWT components that require a graphical display 
utility to load. If you installed Monitor on a UNIX system and you are not using SVG, you 
must do one of the following:
„ Use a utility such as an X‐Server or a virtual X‐Server such as Xvfb. The UNIX system 
must have access to the graphical display utility, and you must set the machineʹs 
DISPLAY setting to identify the host machine on which the utility is running.
„ Modify Integration Server’s startup file to use the ‐Djava.awt.headless option, as 
follows:
a Go to the Integration Server_directory/bin directory and open the server.sh file in a 
text editor.
b Locate this line:
JAVA_MEMSET="-ms${JAVA_MIN_MEM} -mx${JAVA_MAX_MEM}"

c Add the argument shown below to the line:
JAVA_MEMSET="-Djava.awt.headless=true -ms${JAVA_MIN_MEM} -mx${JAVA_MAX_MEM}

Note: If the JAVA_MEMSET line already includes the ‐server option, add the 
‐Djava.awt.headless option after the ‐server option.

Complete the Optimize Installation

Configure Optimize
You must configure Optimize using its Central Configurator. For instructions, see the 
webMethods Central Configuration and Deployment Guide.

Drop Redundant Database Component
If you used the Database Component Configurator to install database components, and 
you installed the Integration Server database component set and the Optimize database 
component set in two different schemas, you will have two instances of the Process Audit 
Log database component. Configure Integration Server and Optimize to point to the 
same instance using instructions in “Connect Products to Database Components” on 
page 129 and the webMethods Central Configuration and Deployment Guide, respectively. 
You can then drop the other instance (see the database chapters in this guide).

webMethods Installation Guide Version 7.1.x 121

 IBM i5.  Open My webMethods in either of these ways: „ On the Windows Start menu. Windows  Go to the Services window and start the service webMethods My service webMethods Server 7.1. and Mac Systems” on page 117). go to ProgramswebMethods7My webMethods. go to ProgramswebMethods7ServersMy application webMethods Server. Metadata Library) „ Connect Deployer to Source and Target webMethods Products Start Integration Server and open Integration Server Administrator (see “Increase File  Descriptors and Change Permissions on UNIX. Administrator and manage. „ Enter the URL below in an Internet browser. Start My webMethods Server:  System Action Windows  On the Start menu. The default port for My webMethods  Server is 8585. http://My webMethods Server_host:My webMethods Server_port Log in under the default user name and password.x . All other  Go to the My webMethods Server_directory/bin directory and run this  systems command: mws -s default start My webMethods Server takes about five minutes to initialize the first time you start it.10 Completing the Installation Connect Products to Each Other This section explains how to do the following: „ Connect Optimize Analytic Engines to My webMethods Server „ Connect Process Engines to Task Engine „ Connect Process Engines to Optimize Analytic Engines „ Connect Integration Server to webMethods Broker and Metadata Library „ Connect Monitor to My webMethods Server „ Connect Trading Networks Server to My webMethods Server „ Connect Designer to Other Products (for example. 122 webMethods Installation Guide Version 7.1.

 you already  to the AdministrationMy webMethods identified the My webMethods Server  System Settings page. The default port  for Analytic Engines is 12503. as follows: a If a blank row is not available.. so My webMethods  Server need only communicate with one to communicate with all. select the Use SSL  check box. identify an  Configuration and Deployment Guide. Engines.x 123 . go  Central Configurator. 1 On the My webMethods Server that  If you configured Optimize using the  hosts the Optimize user interfaces. 3 Click Save. webMethods Installation Guide Version 7. that hosts the Optimize user interfaces to  your Analytic Engines. Note: All Analytic Engines share the same database components.. If not.1. do so using  2 In the Server Settings area.  click Add to add one. under  the instructions in the webMethods Central  Analytic Engine Host. 10 Completing the Installation Connect Optimize Analytic Engines to My webMethods Server You must connect the Optimize Analytic Engines to the My webMethods Server that  hosts the Optimize user interfaces so My webMethods can display Optimize data.. Identify an Analytic Engine to My webMethods Identify My webMethods Server to the Analytic Server. c If My webMethods Server should  use SSL to communicate with the  Analytic Engine.. Analytic Engine. b Provide the host and port for the  Analytic Engine.

 The default port  the Task Engine (for example. 124 webMethods Installation Guide Version 7. Note: All Process Engines in a Process Engine cluster share a Broker... accept the default values  Integration Server. 1 On the My webMethods Server  1 In the Integration Server Administrator  that hosts the Task Engine.. SSL check box. identify an  package. or both. type the URL  Process Engine in your Process  of the My webMethods Server that hosts  Engine cluster. go to  for an Integration Server that hosts a  the AdministrationMy Process Engine in your Process Engine  webMethodsSystem Settings page. 5 Reload the WmTaskClient package by  returning to the PackagesManagement  page and clicking   in the WmTaskClient  row. Identify the Task Engine to the Process Engines. Identify the Process Engines to the Task Engine. Integration Server that hosts a  2 In the Task Server URL field. 4 Click Save.1.. cluster. 4 Click Save.  for Integration Server is 5555. select the Use sysadmin and manage. so the Task Engine need only communicate with one  Process Engine to communicate with all.10 Completing the Installation Connect Process Engines to Task Engine You must connect your Process Engines to the Task Engine so the Task Engine can  provide results of process steps that required human intervention to running processes. go to the PackagesManagement  2 In the Integration Server (Process page and click   for the WmTaskClient  Engine host) area. the same  database component. http://myserver:8585). 3 If My webMethods Server should  3 In the Task Server Username and Task Server use SSL to communicate with the  Password fields.x .

Client Group Broker Server client group to which Integration Server should  connect. 5 Repeat these steps for every Integration Server that hosts a Process Engine. 3 Click Submit.  webMethods Installation Guide Version 7. go to the SettingsMessagingBroker Settings page and click Edit Broker Settings. By default. Integration  Server creates it when it connects to the Broker. you must modify this URL.   Broker #1 to the correct Broker name. 10 Completing the Installation Connect Process Engines to Optimize Analytic Engines If processes are enabled for analysis. If this Broker is not on the same machine as a Process Engine. or any combination of these. 6849 to the correct port. go to the PackagesManagement page and click   for the WmOptimize  package. Broker Name Name of the Broker to which Integration Server should connect. as necessary. 2 In the Broker URL field. Important! Do not change the broker:// or /analysis parts of the URL.x 125 . Field Setting Broker Host Name (DNSname:port or IPaddress:port) of the machine that hosts  the Broker Server. you must connect your Process Engines to the   Optimize Analytic Engines so My webMethods can display the process metrics. A Broker connects the Process Engines to the Analytic Engines.1.  as defined on Broker Server. If the specified client group does not exist. The default Broker is Broker #1. 2 Click Configured on the left side of the page and complete the fields as shown below. the URL  provided to the Process Engines for this Broker is broker://localhost:6849/Broker  #1/analysis. 1 In Integration Server Administrator for an Integration Server that hosts a Process  Engine. or the port it is  using is not 6849. or its name is not Broker #1. Connect Integration Server to webMethods Broker and Metadata Library Connect Integration Server to the Default Broker 1 In Integration Server Administrator. change localhost to the correct host. 4 Reload the WmOptimize package by returning to the PackagesManagement page and  clicking   in the WmOptimize row.

 prefix. Field Setting IS Host Name Name you assign to this Integration Server to identify it to  Designer. 3 Click Save Changes. The default is 8090. click HTTP. By default. Password Password for the user.  Integration Server uses its license key for the prefix. My webMethods displays this prefix for each client it creates for  Integration Server. Truststore Full path to Integration Server’s trust store file. Password Password to use to access the SSL certificate in Integration  Server’s keystore file. 126 webMethods Installation Guide Version 7.10 Completing the Installation Field Setting Client Prefix String that identifies Integration Server to the Broker. then click Edit Configuration and complete the fields below. click HTTPS. Encryption Whether to encrypt the connection between Integration Server  and the Broker. Connect Integration Server to the Metadata Library 1 In Integration Server Administrator. then restart Integration Server.) Use SSL Indicates whether to use SSL to communicate with the Broker. Port Port Metadata Library uses to communicate. Otherwise. Keystore Type File type of the keystore file (PKCS12 or JKS). You can  define your own. Truststore Type File type of the trust store file (JKS). all Integration Servers in the cluster must use the  same client prefix. 3 Click Save Changes. shorter. go to the SolutionsAsset Publisher page. If you configured the Metadata  Library to use SSL. Host Name or IP address of the machine that hosts the Metadata  Library. The default is develop.x . Protocol Communication protocol. User Name Name of a user authorized to access the Metadata Library. The  default is Developer. If the Integration Server is part  of a cluster. 2 Click Configuration. Keystore Full path to Integration Server’s keystore file. (The Broker creates multiple clients for each  Integration Server that connects to it.1.

x 127 . supply a unique  3 If the My webMethods Server is not  name for the Integration Server. identify  2 In the MWS Password field. Integration Server (Monitor) Host.  that hosts the Monitor user interface.  click Add to add one. edit the MWS Host  c Provide the host and port for the  and MWS Port fields to identify the My  Integration Server. serve as the default for users.  PackagesManagement page and  and choose the Integration Server to  clicking   in the WmMonitor row. 1 On the My webMethods Server that  1 In Integration Server Administrator  hosts the Monitor user interface. on the same machine as the  Integration Server. 4 If you want to check whether the  identified Integration Servers are  currently running. 10 Completing the Installation Connect Monitor to My webMethods Server You must connect Monitor to the My webMethods Server that hosts the Monitor user  interface so My webMethods can display Monitor data.. see  use SSL to communicate with the  the webMethods Monitor User’s Guide. The default  webMethods Server host machine and  port for Integration Server is 5555. d If My webMethods Server should  4 If you need to edit any other fields. The default is manage. 5 Click Submit.. Integration Server. under   for the WmMonitor package. click Display Server Status.. go to the  webMethodsSystem Settings page. 5 Click Save. 3 If you want to identify other  6 Reload the WmMonitor package by  Integration Servers that host Monitor.  returning to the  repeat the previous step as necessary. webMethods Installation Guide Version 7. Identify My webMethods Server to Monitor. type the  an Integration Server that hosts  password for Monitor to use to  Monitor. Users  can override this choice later.1.. as follows: connect to the My webMethods Server  a If a blank row is not available. port. Identify Monitor to My webMethods Server. b In the Name field. select the Use SSL check box. PackagesManagement page and click  2 In the Server Settings area. go to  for the Integration Server that hosts  the AdministrationMy Monitor.

 see the Designer online help. 6 Click OK. Field Setting Host Name or IP address of the machine that hosts the Metadata Library.10 Completing the Installation Connect Trading Networks Server to My webMethods Server You must connect Trading Networks Server to the My webMethods Server that hosts the  Trading Networks user interface so My webMethods can display Trading Networks data. see the  Designer online help. 128 webMethods Installation Guide Version 7.  Do not include the protocol prefix (for example. 2 In the Trading Networks Server area. identify the Integration Server that hosts Trading  Networks Server. Password Password for the user. click WindowPreferences.x . Port Port the Metadata Library uses to communicate. go to  the AdministrationIntegrationB2B SettingsAdministrative Preferences page. User name Name of a user authorized to access the Metadata Library. The default is develop. 5 Click Test Connection. see the webMethods  Deployer User’s Guide. For instructions. “http://”). go to webMethodsMetadata Library. Connect Designer to the Metadata Library 1 Start Designer. 7 If you configured the Metadata Library to use SSL. Connect Deployer to Source and Target webMethods Products Configure communication between Deployer and the source webMethods products from  which you want to deploy items. 3 In the tree. and between Deployer and the target webMethods   products to which you want to deploy items. Connect Designer to Other Products For instructions on connecting Designer to products other than Metadata Library. 1 On the My webMethods Server that hosts the Trading Networks user interface. you must perform additional  steps. 2 In Designer. 4 Clear the Disable Metadata Library Connection check box and complete the fields below. go to ProgramswebMethods7ToolsDesigner. For instructions. Then click Save. On the Start menu. The  default is Developer.1.

  Integration Server will create a separate instance of the connection pool for each database  component at run time. you must point those functions at the appropriate connection pools as well. Database Connections for Integration Server and Trading Networks Server You use Integration Server Administrator to connect Integration Server and Trading  Networks Server to database components. as follows: „ Define JDBC database connection pools for Integration Server and Trading Networks  Server to use to connect to database components. respectively. You can edit the pool using  the instructions in this section.  If the same database server hosts multiple database components.x 129 . IS Internal. „ Integration Server Administrator provides a function that corresponds to each  database component (for example. and Cross Reference database  components. IS Internal. and Archive database  components. you can edit the connection using the instructions in this  section. Archive. Direct the functions to write to the corresponding  database components by pointing each function at the appropriate connection pool. You might have defined the database connections for My webMethods Server and    Metadata Library during installation. If you defined the database connection for the Trading Networks database component  during product installation.1. webMethods Installation Guide Version 7. If you chose the embedded IS Internal database during Integration Server installation. the  installer created a connection pool called Embedded Database Pool and pointed the IS  Internal function at that pool. and for Trading Networks Server to use to connect to the Trading Networks  database component. Cross‐Reference. If you  created the Document History. an IS Core Audit Log function. For instructions on defining the database connections for the Optimize database  components. Each pool specifies the connection  to a database server that hosts database components. Reporting and Staging. the installer created a connection pool and pointed the IS Core Audit  Log. 10 Completing the Installation Connect Products to Database Components This section explains how to define the database connections for Integration Server to use  to connect to the IS Core Audit Log. Process Engine. Process Audit Log. see the webMethods Central Configuration and Deployment Guide. Document  History. a Trading  Networks function. Process Engine. see the My webMethods Server Administrator’s Guide and the webMethods  Metadata Library User’s Guide. If you chose an external RDBMS and defined the database connection during Integration  Server installation. and Process Audit Log functions at that pool. and so on). or you can create separate pools for the functions. define one connection  pool for the database server and point the corresponding functions at that pool. If you did not. or if you need to edit the database  connections.

InitializationString="SET CURRENT PATH=schema" AlternateID is the name of the default schema that is used to qualify  unqualified database objects in dynamically prepared SQL  statements.locationName=location [. URL Oracle jdbc:wm:oracle://server:{1521|port}. UNIX. ConnectionDelay=value.databaseName=database [.x .10 Completing the Installation Define a Connection Pool 1 Start Integration Server and open Integration Server Administrator (see “Increase File  Descriptors and Change Permissions on UNIX.option=value …] DB2 for Linux. 2 Go to the SettingsJDBC Pools page. and Mac Systems” on  page 117).serviceName=service [. Description Associated Database driver to use. The name can include any characters  that are valid for a file name in your operating system..option=value …] Important! For DB2.…).1. IBM i5. LoadBalancing=value [. ConnectionRetry=value. you  must specify these connection options in the URL: AlternateId=schema.serviceName=service. Click Create a new Pool Alias Definition and  complete the fields as follows: Field Entry Alias Name Name for the connection pool. if Integration Server will connect to a schema  other than the default schema for the specified database user.option=value …] DB2 for iSeries jdbc:wm:db2://server:{446|port}.databaseName=database [. Below are sample formats. AlternateServers=(server:{1521|port}.option=value …] SQL Server jdbc:wm:sqlserver://server:{1433|port}. Driver Alias Database URL for the database server. Alias Description for the pool. 130 webMethods Installation Guide Version 7. Windows jdbc:wm:db2://server:{50000|port}.option=value …] Oracle configured for RAC jdbc:wm:oracle://server:{1521|port}.

 you can improve  performance by making sure the connections needed to handle the  increased volume open quickly. each pool  instance keeps the specified number of connections open. You must coordinate the value for the temporary store property  watt. After the specified period of time. If you use this pool alias for more than one function. However. Make sure the total number  does not exceed the database’s connection limit. in milliseconds. Calculate this value as part of the total possible nuber of connections  that could be opened simultaneously by all functions and  applications that write to the database. webMethods Installation Guide Version 7. Idle Timeout Period of time. For  example.auditMaxPool with this value. so that more  connections remain open at all times. the  database will reject subsequent requests for connections from any  application. if you specify keeping at least 3 connections open. Maximum Maximum number of connections the pools can have open at one  connections time. the pool closes  unused connections that are not neded to satisfy the Minimum connections value. you could specify only 17  as the maximum number of connections for the current pool. if Trading Networks also writes to the database and has a   pool that could open up to 5 connections. For instructions. The IS  Core Audit Log pool instance could use up to 17 connections. If one of the  applications opens more connections than the database allows. If your logging volume has sudden spikes. and  the Document History pool instance could use the remaining 5  connections. the pool can keep an unused  connection open. You can minimize connection  startup time during spikes by setting this value higher. the pool keeps a total of 6 connections open ‐ 3  for the IS Core Audit Log pool instance and 3 for the Document  History pool instance. 3 Click Save Settings.1. and the  IS Core Audit Log and the Document History database components  both use this pool. Password Password for the database user.x 131 . 10 Completing the Installation Field Entry User Id Database user for Integration Server to use to communicate with the  database. Minimum Minimum number of connections the pool must keep open at all  connections times.server. see the  webMethods Logging Guide.

 scroll right to the  Restart Function column for the function and click Restart in that column. 4 Click Save Settings. test the connection by clicking  . 132 webMethods Installation Guide Version 7. scroll right to the Edit Association column for a  function and click Edit in that column. 5 Initialize the connection pool. In the Functional Alias Definitions area. 2 In the Functional Alias Definitions area. click the pool to which you want the function to point. go to the SettingsJDBC Pools page.x .10 Completing the Installation Point a Function at a Connection Pool 1 In Integration Server Administrator.1. 6 Make sure Integration Server can connect to the database. 7 Restart Integration Server. Integration Server Administrator returns to the SettingsJDBC Pools page. In the Test column (next to  the Restart Function column) for the function. 3 In the Associated Pool Alias list.

0_12 webMethods  Server. Optimize *By default.0_12 Broker Java and  JMS APIs 32‐bit HP  64‐ Integration  32‐bit Sun  64‐bit  1.5. 1.5. Sun  My  1. You can switch to 64‐bit mode.5. 10 Completing the Installation Installed JDKs and Product JDK Usage The table below lists the JDKs installed by the webMethods Installer on each operating  system that the webMethods product suite supports. Integration Server and Trading Networks Server also support 64‐bit IBM i5 and Mac  systems. You can redirect the products to use another JRE or JDK.5. Networks  64‐bit  extension* 12 extension* 0. see “Redirect  Products to Use a Non‐Default JRE or JDK” on page 135. webMethods Installation Guide Version 7. and the installer automatically configured the  products to use that JDK. 64‐bit  Trading  Sun  Networks  1.  Designer Developer. Important! You should apply maintenance updates to the installer JDK from the  appropriate vendor on a regular basis. as you would for JDKs you install yourself. see “Configure  Products to Use 64‐Bit Mode on Solaris and HP‐UX Systems” on page 134.0.0_12  Sun  08 with  IBM   Trading  with 64‐bit  1.0_ 64‐bit  1.5. The installer does not install a JDK on these systems.x 133 . Sun  32‐bit Sun  webMethods  1. these JDKs run in 32‐bit mode.1.  32 Bit 64 Bit Products Windows Linux Windows Solaris HP-UX Linux AIX Blaze Advisor. **Metadata Library on an AIX system requires the Java 5 32‐bit IBM JDK 1. you installed an  appropriate JDK to run the installer. For instructions.5.0_ bit  Server.0_12 1.5.125 Server.5. You must download and  install JDK yourself. The indicated products use the  installed JDK by default. For instructions. However.0_12 Console Metadata  32‐bit  Library.5.

 this JDK runs in 32‐bit mode. as follows: GLUE_OPTS="$GLUE_OPTS –d64 -Xss256k" 3 Save and close the file. You can switch to 64‐bit mode. Optimize  1 Go to the Optimize_directory/prediction/bin directory and open  Prediction  the startupPredictionEngine. as  follows: JAVA_D64=”-d64” 3 Save and close the file.x . My webMethods  1 Go to the My webMethods Server_directory/bin directory and  Server open the setenv.sh file in a text editor. 2 Locate the line GLUE_OPTS=ʺ$GLUE_OPTS ‐Xss256kʺ and  add ‐d64. 134 webMethods Installation Guide Version 7. as  follows: JAVA_D64=-d64 3 Save and close the file. 2 Locate the line {rem|#} JAVA_D64=‐d64 and uncomment. as follows: GLUE_OPTS="$GLUE_OPTS –d64 -Xss256k" 3 Save and close the file. Engine 2 Locate the line GLUE_OPTS=ʺ$GLUE_OPTS ‐Xss256kʺ and  add ‐d64.10 Completing the Installation Configure Products to Use 64-Bit Mode on Solaris and HP-UX Systems On 64‐bit Solaris and HP‐UX. packages) 2 Locate the line #JAVA_D64=”‐d64” and uncomment it.  Run-time Product Steps Integration  1 Go to the Integration Server_directory/bin directory and open  Server (and  the server. Optimize  1 Go to the Optimize_directory/analysis/bin directory and open  Analytic Engine the startupAnalyticEngine.sh file in a text editor.sh file in a text editor.sh file in a text editor. By  default.1. the installer installs a 32‐bit JDK with a 64‐bit extension.

10 Completing the Installation Run-time Product Steps Optimize Web  1 Go to the Optimize_directory/dataCollector/bin directory and  Service Data  open the startupDataCollectorEngine. all webMethods products use the JDKs installed by the webMethods Installer  on your systems. Install the files using  the instructions in the vendor documentation.com/developerworks/java/jdk/security/index. as follows: GLUE_OPTS="$GLUE_OPTS –d64 -Xss256k" 3 Save and close the file. You can download the JCE files for  an IBM JDK from the IBM Web site at  http://www.com/javase/downloads/index_jdk5. webMethods Installation Guide Version 7. Note: Software AG tests webMethods products only with the JDKs installed by the  webMethods Installer. your JVM must contain Java Cryptography  Extension (JCE) Unlimited Strength Jurisdiction Policy Files 5.sh file in a text editor. Data Collector 2 Locate the line #JAVA_D64=”‐d64” and uncomment it. You can redirect each product to use a non‐default JRE or JDK.ibm. Redirect Products to Use a Non-Default JRE or JDK By default. as  follows: JAVA_D64=”-d64” 3 Save and close the file.html. Collector 2 Locate the line GLUE_OPTS=ʺ$GLUE_OPTS ‐Xss256kʺ and  add ‐d64. If you use a non‐default JRE or JDK.0.1.sh file in a text editor.sun. webMethods products  need these files to be able to encrypt and decrypt SSL certificates.jsp.x 135 . You can download the  JCE files for a Sun or Hewlett‐Packard JDK from the Sun Web site at  http://java. Optimize  1 Go to the Infrastructure Data Collector_directory/bin directory  Infrastructure  and open the server.

 Process  save and close the file.10 Completing the Installation Run-time Products Product Steps to Redirect to a Non-Default JRE or JDK webMethods  Require JDK 1. Broker Java and  In the steps below.  Go to the Integration Server_directory\bin directory and open the  including  server.sh file in a text editor. awcert. awbroker.x .bat or server. In this  Server (and  case.5 localhost Integration  Requires JRE 1. unless you are using it with Developer.5. the command might look like this: /opt/webMethods7/Broker/bin/broker_status -DJAVA_HOME=/opt/java1. and  Trading  Networks Server) 136 webMethods Installation Guide Version 7. Integration Server requires JDK 1.5. command is any command other than  JMS APIs server_config. packages. Engine.5.  parameter to point to the JRE or JDK installation directory. the command might look like this: C:\Program Files\webMethods7\Broker\bin\broker_status -DJAVA_HOME-=C:\jdk1.1. then  Monitor.5 localhost On a UNIX system. or awbrokermon. Edit the JAVA_DIR  Deployer. webMethods Broker_directory\bin\command -DJAVA_HOME- =JDK_path host:port On a Windows system.

 you must download and install the JDK  yourself. 10 Completing the Installation Product Steps to Redirect to a Non-Default JRE or JDK Metadata Library Requires JDK 1. webMethods Installation Guide Version 7.bat or setenv.  uncomment it by removing the # sign. 2 On the JAVA_HOME variable. On a UNIX system: 1 Go to the Metadata Library_directory\library\bin directory and  open the library.  then save and close the file. On an AIX system.x 137 . specify the path to the JDK to  use. set JAVA_DIR=path_to_JDK). use the rem command  to comment out the set JAVA_DIR line (that is. Edit the  JAVA_HOME parameter to point to the JDK installation directory.1. 2 If you want Metadata Library to use the JDK specified by the  JAVA_HOME environment parameter.bat file in a text editor. On a Windows system: 1 Go to the Metadata Library_directory\library\bin directory and  open the setJava.5.sh file in a text editor. 3 Save and close the file. and then add a  new line just beneath it that specifies the path to the JDK to use  (that is. rem set JAVA_DIR=path_to_webMethods_JDK).conf file in a text editor.5. My webMethods  Requires JDK 1. Server Go to the My webMethods Server_directory\bin directory and open  the setenv.5. If the JAVA_HOME variable is commented out. comment  out the set JAVA_DIR line as explained above. requires specifically the Java  5 32‐bit IBM JDK 1. If you want Metadata Library to use a different JDK. 3 Save and close the file.

5. 4 If the engines were installed as Windows Services. Infrastructure  Go to the Infrastructure Data Collector_directory/bin directory and  Data Collector open the server.sh file in a text editor. b Edit the wrapper.x . and Web  2 Go to the Optimize directory\component\bin directory and open  Service Data  the kenobiEnv. Analytic Engine. do the  following for each: a Go to the Optimize directory\component\bin directory and  open the wrapper.  1 Log on to the host machine for the component.5.1 property to point to the  JDK_directory/lib/tool.bat or kenobiEnv.bat program. Edit the  JAVA_DIR parameter to point to the JRE installation directory.java.bat or server. Collector 3 Edit the JAVA_HOME parameter to point to the JDK  installation directory.  then save and close the file. Optimize  Requires JRE 1.10 Completing the Installation Product Steps to Redirect to a Non-Default JRE or JDK Optimize  Require JDK 1.jar library.sh file in a text editor.classpath. c Edit the wrapper.command property to point to the  JDK_directory/bin/java executable. f Run the installNTsvc. then save and close the file.java.conf file in a text editor. Prediction  Engine.bat program.1. d Save and close the file e Run the uninstallNTsvc. 138 webMethods Installation Guide Version 7.

Networks  Go to the Trading Networks Console_directory\bin directory and  Console open the console.5. Developer (and  Requires JRE 1.5. If you decide to use a different JRE for Trading Networks  Console. then save and close the file.5. Trading  Requires JRE 1. Make sure you check the product user’s guides for such tasks  before starting the products. Developer runs in the same JVM as Trading Networks  Console. Edit the JAVA_DIR parameter to  point to the JRE installation directory.1. Complete the Installation for Other Products Some products not covered in this chapter have tasks you must complete that are beyond  the scope of this guide. Note: When you launch Developer from Trading Networks  Console. webMethods Installation Guide Version 7.5. Edit the JAVA_DIR parameter to  point to the JRE installation directory.bat file in a text editor.x 139 . plug‐ins) Go to the Developer_directory\bin directory and open the  developer. Go to the Designer_directory\bin directory and open the  designer. 10 Completing the Installation Development Products Product Steps to Redirect to a Non-Default JRE or JDK Blaze Advisor Requires JRE 1.bat file in a text editor. You cannot redirect it from the default. the JRE must be suitable for Developer as well as Trading  Networks Console. then save and  close the file. Edit the JAVA_ROOT  parameter to point to the JRE installation directory. then save and close the file. Designer Requires JRE 1.bat file in a text editor.

10 Completing the Installation 140 webMethods Installation Guide Version 7.1.x .

. . . . . . . . . or Mac System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11 Uninstalling Products „ Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 webMethods Installation Guide Version 7. . . . . . . . 142 „ Uninstall on a Windows System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 „ Uninstall on a UNIX. . . . . . . . . . . . . . . . . . . . .x 141 . . . . .1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 „ Complete the Uninstallation . . . . . IBM i5. . . . . . . . . . . . . .

 Read the messages carefully to  avoid uninstalling products accidentally. You can change logging behavior.text in the webMethods_directory\install\history\history. and build information into an audit history log file  named history.  see “Change Logging Level and File.txt directory. it looks almost identical to the installer. the uninstaller writes the errors and  warnings to a file named WmUninstallLog. 142 webMethods Installation Guide Version 7. your system must have an X Windows  environment. 1 Shut down all webMethods products and all other applications that are running on  your machine. 2 Use the Windows Add/Remove Programs utility. and Add Targets” on page 52 or “Start the Installer  Using Advanced Options” on page 71.x . the uninstaller asks whether it should also  uninstall all products that depend on the product. as follows: System Mode Windows wizard UNIX or Mac wizard or console mode IBM i5 console mode To uninstall using the wizard on a UNIX system. 3 Select webMethods release_installation_directory as the program to uninstall. The installer writes product.1. the uninstaller  will not be able to remove key files that are locked by the operating system.11 Uninstalling Products Overview Uninstall webMethods products using the webMethods Uninstaller. You can run the uninstaller using different modes. for instructions. The webMethods  Installer installed all files you need to run the uninstaller. 4 Choose the products to uninstall. version.txt and stores the file in the main installation  directory (by default. webMethods7). Important! If you do not shut down all products and applications. Uninstall on a Windows System To uninstall webMethods products on a Windows system.   Important! When you choose a product. The  uninstaller starts. you must have Windows  system administrator privileges. to  start the uninstaller. If  errors or warnings occur during the uninstallation. available from the Control Panel.

 the  uninstaller experiences display problems. While these display problems will not  adversely affect the uninstallation process. Important! When you choose a product.x 143 . if you are using a bash shell and uninstalling from a local machine  named uninstaller and want to set the DISPLAY to the default device.0 3 Shut down all webMethods products and all other applications that are running on  the machine that contains the webMethods products you are uninstalling. 4 Go to the webMethods_directory/bin directory and enter the appropriate command. the uninstaller asks whether it should also  uninstall all products that depend on the product. c Set the DISPLAY variable on the remote machine to point to the local machine. 5 Choose the products to uninstall. IBM i5. where  remote_host is the remote machine from which to uninstall: xhost +remote_host b Log on to the remote machine. it looks almost identical to the installer. For  example. as  follows: Uninstall Mode Command Wizard uninstall Console mode uninstall -console The uninstaller starts. webMethods Installation Guide Version 7.   Important! If you do not shut down all products and applications. Read the messages carefully to  avoid uninstalling products accidentally. 1 Log on as the same user that installed the webMethods products. or Mac System Important! When you run the webMethods Uninstaller on an IBM i5 system. follow these steps: a Enable the display of the local machine using the command shown below. enter: export DISPLAY=uninstaller:0. the uninstaller  will not be able to remove key files that are locked by the operating system.1. 11 Uninstalling Products Uninstall on a UNIX. Software AG strongly recommends that  you minimize the problems by running the uninstaller from an IBM i5 client for  Windows rather than from a telnet client. 2 If the webMethods products you are uninstalling are located on a remote machine  and you want to use a graphical uninstaller.

 S45_broker71). 2 Delete the WmDeployerResource package. go to the PackagesManagement page. If the Integration Server is not  running. user‐created or configuration files). you  moved the Broker Monitor startup script to the appropriate UNIX startup directory. if you configured your Broker Monitor to run as a daemon so it  would start and shut down automatically when your system starts and shuts down.x . the uninstaller does not delete files created after you installed the  product (for example.11 Uninstalling Products Complete the Uninstallation For most products. nor does it delete the directory  structure that contains the files.  Complete the Deployer Uninstallation Uninstall the Deployer communications component from source and target Integration  Servers. including those called ProcessModel servers.1. Complete the webMethods Broker Uninstallation on UNIX Systems On a UNIX system. and the  names will have an additional character at the end to make them unique (for example. If you configured  multiple Broker Monitors to run as daemons. If you do not want to save the files. If the Integration Server is running. and so on). 144 webMethods Installation Guide Version 7. S45_broker71_2.  S45_broker71_1. You can delete these scripts from the UNIX  startup directories. go to the Integration Server_directory/packages directory and delete all of the  WmDeployerResource folder. The  script is named  Snumber_broker71 (for example. follow these steps: 1 In the Integration Server Administrator for an Integration Server that hosts the  resource package. delete the product  installation directory. you moved multiple startup scripts.

. . . . . . .x 145 . . . . .A Default Ports „ Default Ports . . . . . .1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 webMethods Installation Guide Version 7. . . . . . . . . . . . . . . . . . . .

A Default Ports Default Ports Component Default Port Protocol/Port Type webMethods Broker Broker Server 6849 (SSL not  TCP enabled) 6848 (SSL enabled) 6847 (SSL  authenticated) Default Broker 6849 TCP Broker Monitor 6850 TCP Central Configuration 16000‐16025 HTTP Dashboard application server 8080 HTTP Integration Server and all packages 5555 HTTP Data port for communication among  24547 Proprietary binary  clustered Integration Servers protocol over TCP Diagnostics 9999 HTTP Metadata Library 8090 HTTP/HTTPS My webMethods Server Java debugger (available when My  5000 HTTP webMethods Server is stared with ‐d  option) AJP13 ‐ Jetty listens to external Web  8009 AJP13 server.1.x . if using one (not enabled by  default) Jetty HTTP Web server and  8585 HTTP webMethods product user interfaces Jetty HTTPS Web server (not enabled by  8443 HTTPS default) Communication with Central  15002 HTTP Configuration 146 webMethods Installation Guide Version 7.

1. A Default Ports Component Default Port Protocol/Port Type Optimize Analytic Engine Communication with Central  15000 HTTP/HTTPS Configuration Broker client JMS API 6849 TCP/IP My webMethods Server 8585 HTTP Internal Web service registry 12503 HTTP Infrastructure Data Collector 5555 HTTP Prediction Engine Communication with Central  15003 HTTP/HTTPS Configuration Broker client JMS API 6849 TCP/IP Internal Web service registry 12513 HTTP Web Service Data Collector Communication with Central  15001 HTTP/HTTPS Configuration Broker client JMS API 6849 TCP/IP Internal Web service registry 12603 HTTP webMethods Installation Guide Version 7.x 147 .

A Default Ports 148 webMethods Installation Guide Version 7.1.x .