Configuring Ensemble Productions
Adding Business Hosts
[Back] [Next]
   
Server:docs2
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

This chapter describes how to use the Production Configuration page to add business hosts to a production. It contains the following sections:

For information on the color coding in the diagram, see the previous chapter.
The next chapter describes how to configure settings for the production and all business hosts.
Introduction
An Ensemble business host is any business service, business process, or business operation within an Ensemble production. These are also referred to generically as configuration items.
A configuration item is always associated with a specific production. It may resemble or duplicate items in other productions. Each production is an entirely closed universe that does not use configuration items from other productions.
Configuration Names
By default, the name of a configuration item is the name of its underlying host class. However, you can assign a different name, to describe the purpose of the item, for example.
For example, if you have a business service class that communicates with a specific type of server, and you use it to communicate with the same type of server in different enterprise locations, you must configure the business service with different settings to communicate with each enterprise location, even though the type of server is the same. Each different configuration of the business service must have a different Name in the diagram (except see Working with Multiple Versions of a Business Host,” later in this chapter).
The following rules govern configuration names:
Important:
You cannot change the name of an existing configuration item. If you require a name change, you can copy the item and delete the original item.
Adding Business Hosts to a Production
To add a business host to a production:
  1. Identify (or create and compile) the appropriate business host class.
  2. Open the production on the [Ensemble] > [Configure] > [Production] page.
  3. Click plus-sign icon next to the Services, Processes, or Operations column heading.
  4. Use the wizard that Ensemble displays. See the next topic for details on the options.
  5. Click OK to add the process to the production.
  6. Configure the business process as needed.
This process does not generate any new classes. It updates the production class.
Wizard Options
This section describes the options in the Business Service Wizard, the Business Process Wizard, and Business Operation Wizard.
Options in the Business Service Wizard
The Business Service Wizard provides multiple tabs, which correspond to different types of business service classes to use. Click a tab and then specify values as follows:
Options in the Business Process Wizard
The Business Process Wizard provides multiple tabs, which correspond to different types of business process classes to use. Click a tab and then specify values as follows:
Note that all types of business process share the following optional fields:
Options in the Business Operation Wizard
The Business Operation Wizard provides multiple tabs, which correspond to different types of business operation classes to use. Click a tab and then specify values as follows:
All types of business operation share the following optional fields:
Enabling, Disabling, or Restarting a Business Host
To enable, disable, or restart a business host, do either of the following:
Note:
You cannot disable a business process with a pool size of 0. The management portal does not allow this action because disabling it would stop all business processes with a pool size of 0, which use the same shared actor queue. If you want to disable only a single business process, you must first set its pool size to 1 or more. After you apply the settings, you can disable it. If you do want to stop all business processes using the shared actor pool, select Production Settings and set the Actor Pool Size to 0.
Changing the Class That a Business Host Uses
To modify a business host so that it is based on a different class:
  1. Display the Production Configuration page:
  2. Click the business host in the diagram.
  3. Click the Actions tab.
  4. Click Change Class.
  5. Select a new class.
Copying a Business Host
To create a copy of a business host within a given production:
  1. Display the Production Configuration page:
  2. Click the business host in the diagram.
  3. Click the Actions tab.
  4. Click Copy.
  5. Click Copy to create a copy of the selected business host.
    A dialog box prompts you to enter a configuration name.
  6. Enter a unique name and click OK.
When first created, the copy has the same host class and settings as the original; only the name is different. Generally your next step is to configure the copy to make it unique. For example:
The copy has no relationship to the original item; you can configure, enable, and disable each item independently.
Note:
The Copy command works only within the same production. You cannot copy a business host from one production to another.
Deleting a Business Host
To delete a business host within a given production:
  1. Display the Production Configuration page:
  2. Click the business host in the diagram.
  3. Click the Actions tab.
  4. Click Delete.
    This process removes this item from the production configuration. This action does not delete the business host class on which the business host is based.
Repairing an Error
If the class for a given business host is not available, the diagram displays the item with a red background. To fix the error:
  1. Select the item.
  2. Click the Actions tab.
  3. Now either click Delete to remove the item or click Change Class to choose a class.
Viewing and Configuring Connections
When you click the status indicator of a business host, lines connect items as defined by the values in the Target Config Names setting or, in the case of a routing process, as defined by the associated Business Rule Name. The following figure shows an example:
You can assign a business service Target Config Names by clicking its status indicator and dragging the pointer to a business process or operation until you see its status indicator highlighted. When you do so, the Production Configuration page displays a dialog window requesting you to confirm the connection. If you confirm the connection, the page displays a Settings applied message and the item is added to the list in the Target Config Names setting.
Working with Multiple Versions of a Business Host
During development, it can be convenient to include multiple “versions” of a business host in the production and then switch among them for testing.
Only one of them can be enabled at any time; when you enable one, Ensemble automatically disables any previously enabled version.
To create and work with multiple versions of a host:
  1. Add the first business host as usual.
  2. Add the next business host and provide the same configuration name as for the first one.
    The production configuration still shows only one business host with the given name.
  3. If you are not in listing view, click the listing view icon .
  4. Select the business host.
    Now the diagram displays a small box that indicates the number of items that have this name, as follows:
    Also, the area above the diagram shows a drop-down list that you can use to select the specific item to work with:
    By default, the enabled version is selected. If no host is enabled, the selected version is the first business host that you added.
  5. Use the Item list to select the version that you want to configure. Specify configuration details as usual and apply them.
  6. Repeat if needed.
To understand why this is useful, consider the following: when testing or troubleshooting the production you might want to send messages by typing them at the console command line, or by reading data from files. But when running the production, you might intend for these messages to arrive from an external application via a TCP connection. Each means of obtaining input for the production requires a different business service host class.