Configuring and Deploying Your Environment

About this task

Optimize uses the My webMethods Define Environments page, (sometimes referred to as the IBM webMethods Central Configurator tool) as the graphical user interface for configuring an Optimize system without manually editing properties files. The Define Environments page enables you to configure Optimize components, such as an Analytic Engine and Data Collector. In addition, to connect My webMethods to Optimize (an Analytic Engine) or to an Integration Server, you must use the My webMethods System Settings page.

A working group of webMethods product components that share common configuration settings is called an environment. A default Optimize environment contains the following logical servers: a Broker (deprecated), an Analytic Engine, a Web Service Data Collector, and a IBM My webMethods Server. For more complete information on configuring your environment, see Configuring BAM.

One to three default environments are available in Optimize, depending on the chosen installation option. These are BAM only, BPM only, and BAM/BPM mixed (also known as BPMS). If you choose a BPM only or a BAM/BPM mixed installation, the BPM environment is immediately accessible from the My webMethods monitoring pages using a default Integration Server. If you choose a BAM-only environment, or want to access the BAM components of a mixed installation, you must configure, deploy, and add one or more Analytic Engines to the System Settings page before you can use them to generate and view monitoring information. Refer to Configuring Optimize to use an Analytic Engine for instructions to add an Analytic Engine.

A Server drop-down menu appears at the top of most My webMethods pages that enables users to select from the servers/environments available to them.

Access to the Define Environments page is through the My webMethods interface. Refer to Configuring BAM for an overview of the process of installing and configuring Optimize and My webMethods. Once you have set up your environment using the Define Environments page, you can modify your configuration at any time through My webMethods.

To configure and deploy your environment

Procedure

In My webMethods, navigate the following path: Applications > Administration > System-Wide > Environments> Define Environments.

The Define Environments page is displayed.
Add an environment:
1. Click Add Environments.
  
  The Add Environment page is displayed.
2. On the Environment Information panel, enter a name for the environment.
  
  You might choose a name that reflects the environment functionality, such as “development” or “production.”
3. In the Description field, enter a description for the environment.
4. Click Save.
Add logical servers:
1. Open your environment by clicking its name in the Define Environments page. The Edit Environment page is displayed.
2. Click the Design Servers tab.
3. Click Add From Template to create a default set of logical servers.
  The default set of Optimize logical servers contains one each of the following:
  - Analytic Engine
  - JMS Server (Either Broker Server (deprecated) or IBM webMethods Universal Messaging)
  - Data Collection Services (Web Service Data Collector for Optimize for Process, and Infrastructure Data Collector for Optimize for Infrastructure)
  - IBM My webMethods Server
  Tip: To make your logical servers easier to recognize, you can rename them with information about their location or use. To rename a logical server, click its name in the Design Servers tab and modify the name and description in the Edit Logical Server dialog.
4. Click Add to add another server not included in the default logical server set.
Configure servers:
1. Click the Configure Servers tab.
2. Do one of the following:
  - To modify a server configuration, click the name of the attribute you want to change. After you make the changes, click Save.
    Note: Depending on the configuration of the Optimize installation, you might be asked to change the Administrator password when you start Analytic Engine for the first time. To change the Administrator password, go to Administrator Password Settings in the Analytic Engine section of the configuration tree.
    
    Note: To keep your changes, you must click Save before closing each configuration editor. If you close an editor without clicking Save, you will lose your changes.
  - Do nothing to accept the default attribute settings.
    Important: If more than one Optimize environment exists on your network, you must define a unique Cluster Port number by clicking Cache Configuration in the Default Settings section of the configuration tree. A conflict will result if the cluster port is not unique. Choose a port number between 10000 and 64768 to avoid conflicts.
Define Hosts:
1. Click the Define Hosts tab.
2. For each host in your environment, click Add Host, type the display name and host name or IP address of the host in the Add/Edit Host dialog, and click OK.
Map servers:
1. Click the Map Servers tab.
2. For each logical server, click the name of the server (or click Edit) to display the Edit Host Mapping swap box. For each logical server, specify one or more host server locations by double-clicking the host name(s) to move from the Available Hosts list to the Mapped Hosts list, and click Save.
Map Endpoints:
1. Click the Map Endpoints tab.
2. Check the incoming and outgoing connections for each logical server and modify port numbers, if necessary.
3. Click Save to save changes.
Map DB Pools:

Note: In order to map DB pools, you need to have previously configured DB pools. See Configuring Optimize Database Pools for detailed DB pool configuration instructions.
1. Click the Map DB Pools tab.
2. For each database component, select a pool from the drop-down list.
3. To make changes to a pool already associated with this component, click Edit to display the Add/Edit Pool panel, make any necessary changes to the pool information, database connection, or pool settings, and click Save on the Add/Edit Pool page to save these changes.
4. Click Save on the Database Components panel to save any changes in the mapping of pools to the database components.
Validate your environment:
1. Click the Validate tab.
2. Click Finish.
Deploy your environment:
1. Click Deploy.
2. Click Deploy All.

Changing Your Configuration Settings

Edit online

About this task

When you change settings (other than log settings) using the My webMethods Define Environments page, you must complete the following steps before the changes take effect:

Procedure

Do one of the following:
- Click Deploy Updates to send only the changed settings to the appropriate logical server(s).
- Click Deploy All to send all settings to all logical servers in your environment.
- Click Deploy to File to save all settings to all logical servers in your environment as a file.
Restart the logical server(s) for which you changed settings.