Configuring Ensemble Productions
Creating a Production
[Back] [Next]
   
Server:docs2
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

The [Ensemble] > [List] > [Productions] page allows you to create a new production and open, export, document, or delete an existing production. After you open a production, Ensemble displays the [Ensemble] > [Configure] > [Production] page, which allows you to configure, start, and stop Ensemble productions. If you are not yet working in a production, the [Ensemble] > [Configure] > [Production] page allows you to create or open a production. Once you are working in a production, you can use the Actions tab to switch to a new or another existing production or to document or export the current one.

This chapter primarily describes how to use these pages. It contains the following topics:
Later chapters describe how to add business hosts and configure settings for the production and all business hosts.
Note:
If a production is Suspended or Troubled, see Correcting Production Problem States,” in Monitoring Ensemble.
Creating a Production
To create a production:
  1. If you are not already in an Ensemble namespace, choose your working namespace from the available Ensemble namespaces.
  2. Navigate to the [Ensemble] > [List] > [Productions] page, and then click Go, if necessary.
  3. Click New to create a new production.
  4. Choose one of the following:
  5. Click OK.
  6. Now you can add business hosts and configure them, as described in later chapters.
Opening a Production
To open a production:
  1. If you are not already in an Ensemble namespace, choose your working namespace from the available Ensemble namespaces.
  2. Navigate to the [Ensemble] > [List] > [Productions] page, and then click Go, if necessary.
  3. Click Open to open an existing production.
To open a production or create a new production when you currently configuring a production on the Production Configuration page:
  1. If you have clicked anywhere within the diagram, click Production Settings.
    This step returns the focus to the production and changes the options on the Actions tab.
  2. Click on the Actions tab.
  3. Click Open on the Actions tab to open an existing production or click New on the same tab to create a new production.
Introduction to the Production Configuration Page
For example, the following figure shows the Demo.Loan.FindRateProduction in the ENSDEMO namespace.
The Update Button
While you are developing new code and configuring the production, it sometimes happens that when you start the Management Portal, Ensemble detects a discrepancy between the production as defined in the code, and the status of the running production. Examples would be if:
When such discrepancies occur, the [Ensemble] > [Configure] > [Productions] page displays the Update button. Click this, and Ensemble updates the production to resolve the discrepancy.
Controlling the Display
This section describes how to filter the display, sort the display, how to display alternative views of the production, and how to control the refresh of the display.
Filtering the Display by Category
To filter the business hosts in the production diagram, use the Category list.
Select a value from this list. When you do so, the diagram display only those business hosts that have been assigned to the given category. Or click All to view all the business hosts in the production.
Note that a business host can be assigned to multiple categories.
For details, see Category in the reference Settings in All Productions.”
Sorting Business Hosts
To sort the business hosts in the production diagram, use the Sort options:
Choosing a View Type
To view the business hosts in a different way, use the View options:
These view types are as follows:
Controlling the Refresh
Click the circular arrow to refresh the diagram once or click on to reload a fresh copy of the production diagram every 60 seconds; the refresh timer is off by default.
Note that Ensemble checks the status of individual business hosts (on a shorter interval) and refreshes the display for individual hosts as needed, regardless of the setting of auto-refresh.
Understanding the Color Coding
When in list or monitor view, the Production Configuration page displays a circular status indicator next to each business host. If you click Legend to see the meaning of this indicator, Ensemble displays the following:
Note:
You can increase the visibility of the error states by specifying that the Error, Retry and Inactive states are to be indicated by a colored ellipse, not a circle. To do this append &VISUALAID=1 to the URL for the Production Configuration page.
Starting a Production
To start an Ensemble production that is displayed on the Production Configuration page:
  1. Click Start and answer OK to launch the Start Production dialog box. It displays the name of the production, its startup status, and any messages associated with production startup.
    Note:
    If any Terminal windows open as a result of starting the production, do not close them.
  2. When the startup dialog shows it is Done, click OK at the bottom of the Start Production dialog box.
You can stop the running production and start another one from this page. Only one of these productions can run at a time in a given namespace. If you try to start one, and another is already started, a warning message displays and nothing changes. For example:
12:05:06.292:Ens.Director: ERROR <Ens>ErrProductionAlreadyRunning:
Production 'Demo.Loan.FindRateProduction' is already running
12:05:06.352:Ens.Director: ERROR <Ens>ErrProductionAlreadyRunning:
Production 'Demo.Loan.FindRateProduction' is already running
Production 'Demo.Loan.BankUSProduction' not started:
ERROR <Ens>ErrProductionAlreadyRunning: Production
'Demo.Loan.FindRateProduction' is already running
Note:
This option is primarily for use during development. For a live, deployed production, InterSystems recommends that you use the auto-start option. See Starting and Stopping Productions in Managing Ensemble.
Stopping a Production
To stop an Ensemble production that is displayed on the Production Configuration page:
  1. Click Stop and answer OK to launch the Stop Production dialog box. It displays the name of the production, its shutdown status, and any messages associated with production shutdown.
  2. When the shutdown dialog indicates it is Done, click OK at the bottom of the Stop Production dialog box.
  3. If the request to stop the production initially fails, the portal displays a message:
    And provides a command:
    If you click this command, the production is forced to shut down.
Ensemble displays an informational message if you try to stop a production that is not running.
Exporting a Production
To export a production from the Production Configuration page:
  1. If you have clicked anywhere within the diagram, click Production Settings.
    This step returns the focus to the production and changes the options on the Actions tab.
  2. Click Export on the Actions tab.
  3. Select items to export.
  4. Click OK.
See Deploying a Production in Developing Ensemble Productions for details on exporting and deploying a production.
Generating Production Documentation
You can navigate to the Production Documentation page from the following places in the Management Portal:
From the Production Documentation page for a production, you can generate or view the production documentation, which includes a list of all the business hosts and their settings. Perform one of the following actions:
You can also generate HTML documentation and, additionally, PDF documentation using the following methods in the Ens.Config.Production class:
Deleting a Production
To delete a production:
  1. Navigate to the [Ensemble] > [List] > [Productions] page.
  2. Click the production that you want to delete.
  3. Click Delete.
  4. Click OK.
Using the Production List
On the [Ensemble] > [List] > [Productions] page, you can use the following options:
The table on this page provides the following information for each production: