Академический Документы
Профессиональный Документы
Культура Документы
Version 8.2
March 2012
Copyright
This document applies to webMethods Product Suite Version 8.2 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 2012 Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, United States of America, and/or their licensors. Detailed information on trademarks and patents owned by Software AG and/or its subsidiaries is located at http://documentation.softwareag.com/legal/. Use of this software is subject to adherence to Software AG's licensing conditions and terms. These terms are part of the product documentation, located at http://documentation.softwareag.com/legal/ and/or in the root installation directory of the licensed product(s). This software may include portions of third-party products. For third-party copyright notices and license terms, please refer to License Texts, Copyright Notices and Disclaimers of Third-Party Products. This document is part of the product documentation, located at http://documentation.softwareag.com/legal/ and/or in the root installation directory of the licensed product(s).
Table of Contents
About this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1. webMethods Products that Use the Terracotta Server Array . . . . . . . . . . . . . . . . . . . . The webMethods Product Suite and Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Using Terracotta to Create Very Large In-Memory Caches with BigMemory . . . . . . . . Using a Terracotta Server Array to Share Cached Data Among Applications . . . . . . . System Caches Used by the webMethods Product Suite . . . . . . . . . . . . . . . . . . . . . . How webMethods Integration Server Uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods Event Server Uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods Mediator uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods Trading Networks uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods eStandards Modules use Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . How CentraSite Uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2. Licensing Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . An Overview of Licensing When Using Terracotta with webMethods . . . . . . . . . . . . . . . . . Installing the Terracotta License File on a webMethods Product . . . . . . . . . . . . . . . . . . . . What to do if a Terracotta License Key Already Resides in the common.conf Folder . . . . . 3. Installing the Terracotta Server Array for Use with webMethods Products . . . . . . . . . Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing and Configuring the Terracotta Server Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the Terracotta Program Files and License Key . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring the Terracotta Server Array for your webMethods Product . . . . . . . . . . . . . . . The Location of the tc-config File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5 5 6 9 10 10 11 12 12 13 14 14 15 15 17 18 18 18 21 22 22 22 25 25 27
Getting Started with the webMethods Product Suite and Terrracotta 8.2
Getting Started with the webMethods Product Suite and Terrracotta 8.2
Document Conventions
Convention Bold Narrowfont UPPERCASE Italic Description Identifies elements on a screen. Identifies storage locations for services on webMethods Integration Server, using the convention folder.subfolder:service. Identifies keyboard keys. Keys you must press simultaneously are joined with a plus sign (+). Identifies variables for which you must supply values specific to your own situation or environment. Identifies new terms the first time they occur in the text. Identifies text you must type or messages displayed by the system. Indicates a set of choices from which you must choose one. Type only the information inside the curly braces. Do not type the { } symbols. Separates two mutually exclusive choices in a syntax line. Type one of these choices. Do not type the | symbol. Indicates one or more options. Type only the information inside the square brackets. Do not type the [ ] symbols. Indicates that you can type multiple options of the same type. Type only the information. Do not type the ellipsis (...).
Monospace font
{}
| [] ...
Documentation Installation
You can download the product documentation using the Software AG Installer. Depending on the release of the webMethods product suite, the location of the downloaded documentation will be as shown in the table below. For webMethods... 6.x The documentation is downloaded to... The installation directory of each product.
Getting Started with the webMethods Product Suite and Terrracotta 8.2
The documentation is downloaded to... A central directory named _documentation in the main installation directory (webMethods by default). A central directory named _documentation in the main installation directory (Software AG by default).
Online Information
You can find additional information about Software AG products at the locations listed below. Note: The Empower Product Support Web site and the Software AG Documentation Web site replace Software AG ServLine24 and webMethods Advantage. If you want to... Access the latest version of product documentation. Find information about product releases and tools that you can use to resolve problems. See the Knowledge Center to: Read technical articles and papers. Download fixes and service packs. Learn about critical alerts. See the Products area to: Download products. Download certified samples. Get information about product availability. Access older versions of product documentation. Submit feature/enhancement requests. Go to... Software AG Documentation Web site http://documentation.softwareag.com Empower Product Support Web site https://empower.softwareag.com
Getting Started with the webMethods Product Suite and Terrracotta 8.2
If you want to... Access additional articles, demos, and tutorials. Obtain technical information, useful resources, and online discussion forums, moderated by Software AG professionals, to help you do more with Software AG technology. Use the online discussion forums to exchange best practices and chat with other experts. Expand your knowledge about product documentation, code samples, articles, online seminars, and tutorials. Link to external Web sites that discuss open standards and many Web technology topics. See how other customers are streamlining their operations with technology from Software AG.
Getting Started with the webMethods Product Suite and Terrracotta 8.2
Getting Started with the webMethods Product Suite and Terrracotta 8.2
The webMethods Product Suite and Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods Integration Server Uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods Event Server Uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods Mediator uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods Trading Networks uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How webMethods eStandards Modules use Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . How CentraSite Uses Terracotta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Getting Started with the webMethods Product Suite and Terrracotta 8.2
This chapter provides a general overview of how components of the webMethods product suite use Ehcache and, more specifically, how they use the extensions enabled by Terracotta. The content of this chapter is designed to introduce you to Terracotta usage by various webMethods products. For detailed information, it refers you to the appropriate user guides.
10
Getting Started with the webMethods Product Suite and Terrracotta 8.2
webMethods products that support Ehcache for caching also support BigMemory, however, you must install a Terracotta license on the webMethods product to enable the BigMemory feature. For additional information about the BigMemory extension to Ehcache, see the sections on BigMemory in the Ehcache User Guide Version 2.4 at http://www.ehcache.org/documentation/2.4/user-guide/preface.
Getting Started with the webMethods Product Suite and Terrracotta 8.2
11
Most webMethods products that use Ehcache also support the use of a Terracotta Server Array. To use these products with a Terracotta Server Array, you must install a Terracotta license on the webMethods product. For additional information about the Terracotta Server Array, see the Ehcache Distributed Cache User Guide Version 2.4 at http://www.ehcache.org/documentation/2.4/terracotta/ and the Terracotta product documentation at http://terracotta.org/legacy/3.5.0.html. Important! The webMethods product suite supports certain versions of the Terracotta Server Array. It is important to ensure that the Terracotta client libraries installed with your webMethods product are compatible with the version of the Terracotta Server Array you are using. If you are using a newly supported release of the Terracotta Server Array, it might be necessary to apply a fix that installs compatible Terracotta client libraries on your webMethods product.
12
Getting Started with the webMethods Product Suite and Terrracotta 8.2
Members of the cluster use caches on the Terracotta Server Array to share data
For more information about how Integration Server uses Terracotta for clustering, see the webMethods Integration Server Clustering Guide.
Getting Started with the webMethods Product Suite and Terrracotta 8.2
13
The master and the slave use the Terracotta Server Array to store data needed for synchronization
For more information about how Event Server uses Terracotta in a high-availability configuration, see the chapter on high availability in Administering webMethods Event Server.
14
Getting Started with the webMethods Product Suite and Terrracotta 8.2
Getting Started with the webMethods Product Suite and Terrracotta 8.2
15
16
Getting Started with the webMethods Product Suite and Terrracotta 8.2
Licensing Requirements
18 18 18
An Overview of Licensing When Using Terracotta with webMethods . . . . . . . . . . . . . . . . . . . . . Installing the Terracotta License File on a webMethods Product . . . . . . . . . . . . . . . . . . . . . . . . . What to do if a Terracotta License Key Already Resides in the common.conf Folder . . . . . . . . .
Getting Started with the webMethods Product Suite and Terrracotta 8.2
17
2 Licensing Requirements
18
Getting Started with the webMethods Product Suite and Terrracotta 8.2
2 Licensing Requirements
Note: You are only permitted to use a Terracotta license file with a webMethods product for which you have purchased a Terracotta license. Using the license with a nonlicensed product is prohibited. To determine which license key to use, examine each key file with a text editor. The file will describe the capabilities that the key enables. Install the key file that satisfies the needs of the webMethods product with the most demanding licensing requirements.
Getting Started with the webMethods Product Suite and Terrracotta 8.2
19
2 Licensing Requirements
20
Getting Started with the webMethods Product Suite and Terrracotta 8.2
Installing the Terracotta Server Array for Use with webMethods Products
22 22 22 25
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing and Configuring the Terracotta Server Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the Terracotta Program Files and License Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuring the Terracotta Server Array for your webMethods Product . . . . . . . . . . . . . . . . . . . .
Getting Started with the webMethods Product Suite and Terrracotta 8.2
21
3 Installing the Terracotta Server Array for Use with webMethods Products
Introduction
This chapter outlines the steps for installing and configuring a Terracotta Server Array. You must install and configure the Terracotta Server Array to use the clustering, highavailability, and/or shared-caching features in your webMethods product. Note: The version of Terracotta software that you install on the Terracotta Server Array must be compatible with the version of the Terracotta client libraries that your webMethods product uses.
22
Getting Started with the webMethods Product Suite and Terrracotta 8.2
3 Installing the Terracotta Server Array for Use with webMethods Products
To install the Terracotta program files and license key 1 2 Log on to Empower and go to the Software Download Center. From the product list (shown below), select the appropriate version of Terracotta and download its archive file.
If a Software AG installation folder already exists on your machine, create a subdirectory called Terracotta within it. If a Software AG installation folder does not exist, create the following directory structure on your machine: /SoftwareAG/Terracotta
Getting Started with the webMethods Product Suite and Terrracotta 8.2
23
3 Installing the Terracotta Server Array for Use with webMethods Products
Extract the contents of the archive file into the Terracotta folder that you created in the step above. Note: The program files are distributed in a compressed archive file (a tar.gz file). To install the files correctly, you must decompress the gz file and then extract the contents of the tar file into the Terracotta folder. When you are finished, the Terracotta folder should look as follows:
Note: This step places the license key in its default location. If required, you can install the key in a different folder and specify its location. For those procedures, see the license file section in the Terracotta product documentation. 6 Repeat steps 3 through 5 on each server (including mirrors) in the array.
24
Getting Started with the webMethods Product Suite and Terrracotta 8.2
3 Installing the Terracotta Server Array for Use with webMethods Products
Getting Started with the webMethods Product Suite and Terrracotta 8.2
25
3 Installing the Terracotta Server Array for Use with webMethods Products
26
Getting Started with the webMethods Product Suite and Terrracotta 8.2
Index
C
conventions used in this document 5
D
documentation conventions used 5 using effectively 5
P
program code conventions in this document 5
T
typographical conventions in this document 5
Getting Started with the webMethods Product Suite and Terrracotta 8.2
27
28
Getting Started with the webMethods Product Suite and Terrracotta 8.2