Skip to main content

Creating a Production

The Interoperability > List > Productions page allows you to create a new production and open, export, document, or delete an existing production. After you open a production, InterSystems IRIS® data platform displays the Production Configuration page, which allows you to configure, start, and stop productions. To configure the current production, you can select Interoperability > Configure > Production, which also displays the Production Configuration page. 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 topic primarily describes how to use these pages. Other pages 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.

Creating a Production

To create a production:

  1. If you are not already in an interoperability-enabled namespace, choose your working namespace from the available interoperability-enabled namespaces.

  2. Navigate to the Interoperability > List > Productions page, and then click Go, if necessary.

  3. Select New to create a new production.

  4. Enter a Package Name, Production Name, and Description.

  5. Choose Generic production.

  6. Click OK.

  7. Now you can add business hosts and configure them.

Opening a Production

To open a production:

  1. If you are not already in an interoperability-enabled namespace, choose your working namespace from the available interoperability-enabled namespaces.

  2. Navigate to the Interoperability > List > Productions page, and then select Go, if necessary.

  3. Select 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.

    Production Settings link

    This step returns the focus to the production and changes the options on the Actions tab.

  2. Select the Actions tab.

  3. Select Open on the Actions tab to open an existing production or select New on the same tab to create a new production.

Introduction to the Production Configuration Page

For example, the following figure shows a sample production.

Screen shot of the Production Configuration page that shows a production that routes files

The Update Button

While you are developing new code and configuring the production, it sometimes happens that when you start the Management Portal, InterSystems IRIS detects a discrepancy between the production as defined in the code, and the status of the running production. Examples would be if:

  • A specific business host experienced an error and has died (the most likely cause).

  • You changed a configuration parameter for a business host in a running production, such that the host now needs to be restarted.

  • You enabled or disabled an item in a production, and this action requires the production to be stopped and restarted.

  • A production typically opens a Terminal window, but this window was closed by a user action while the production was still running.

When such discrepancies occur, the Update button appears on the Production Configuration page. If you click the button, InterSystems IRIS updates the production to resolve the discrepancy. If you prefer for the system to attempt to resolve the discrepancy automatically, you can add a business service based on the Ens.ProductionMonitorServiceOpens in a new tab class to the production. For more information, see Using the Production Monitor Service.

Controlling the Display

This section describes how to filter the display, sort the display, how to display alternative views of the production, how to control the refresh of the display, and how to hide the production or business host settings.

Filtering the Display by Category

To filter the business hosts in the production diagram, use the Category list.

Category drop-down list on the Production Configuration page

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:

Sort field on the Production Configuration page

  • Name — Sorts items alphabetically within each column.

  • Status — Sorts items within each column by status as follows: disabled, enabled, error, inactive.

  • Number — Sorts items as listed in the production class (which, by default, represents the order in which they were added to the production). To modify this order, you can edit the production class in an IDE.

Choosing a View Type

To view the business hosts in a different way, use the View options:

View field on the Production Configuration page

These view types are as follows:

  • The listing view Listing view icon displays the business hosts in lists, within the Services, Processes, and Operations columns. If the name of a business host is truncated due to the width of the columns, you can hover over the business host to view its full name.

    The listing view is used in most of the documentation.

    Screen shot of the Production Configuration page in listing view

  • The monitor view Monitor view icon represents each business host in a larger circle where you can easily see items that may need attention. Here, click a circle to see a box with details for the business host.

    Screen shot of the Production Configuration page in monitor view

  • The service bus view Service bus view icon is relevant only if you configure business partners and enter values in the Business Partner setting.

    This view displays the business hosts grouped by their associated business partners.

    Screen shot of the Production Configuration page in sevice bus view

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 InterSystems IRIS 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.

Hiding the Settings Pane

Click the Hide Settings Tabs icon Hide Settings Tab icon to hide the production or business host settings.

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, InterSystems IRIS displays the following:

Legend indicating the status associated with each color on the Production Configuration page

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 a 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.

Stopping a Production

To stop a 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:

    Production could not stop, do you want to force a shut down?

    And provides a command:

    Yes - Force to Shut Down

    If you click this command, the production is forced to shut down.

InterSystems IRIS 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 in the right-hand pane.

    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 Export.

  5. Select whether you want to export the production to the server or to your local machine via the browser’s downloading capability.

  6. If you are exporting to the server, enter a path and name of the export file. If you are downloading to your local machine via the browser, enter the name of the export file.

  7. Click OK.

See Deploying a Production 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 Interoperability > List > Productions page, select a production name and click Document.

  • From the Interoperability > Configure > Production page, on the Actions tab for the production, click Document.

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:

  • Click View to display the online documentation you previously generated. If you click View and no HTML documentation exists, you can choose to generate it.

  • Click Generate to create new documentation for this production using a background job.

    It may take a considerable amount of time to generate documentation for large productions; therefore, you may not want to generate new documentation if you have not made changes to the configuration of your production.

  • Cancel to cancel the operation.

You can also generate HTML documentation and, additionally, PDF documentation using the following methods in the Ens.Config.ProductionOpens in a new tab class:

  • CreateDocumentHTML()Opens in a new tab — creates new documentation in HTML format.

    For example, to create documentation for Demo.Loan.FindRateProduction in HTML format:

     Set status=##class(Ens.Config.Production).CreateDocumentHTML("Demo.Loan.FindRateProduction",1,.URL,.ErrLog)
  • RemoveDocumentHTML()Opens in a new tab — removes existing HTML-format documentation from the current namespace.

  • CreateDocumentPDF()Opens in a new tab — creates new documentation as a PDF file.

    For example, to create documentation for Demo.Loan.FindRateProduction in PDF format, you can use the method in a statement similar to the following:

     Set status=##class(Ens.Config.Production).CreateDocumentPDF("Demo.Loan.FindRateProduction",1,"C:\Temp\Rate.pdf",.Log)

    The PDF format requires that you have a PDF renderer installed. It also requires Java.

Deleting a Production

To delete a production:

  1. Navigate to the Interoperability > List > Productions page.

  2. Click the production that you want to delete.

  3. Click Delete.

  4. Click OK.

Using the Production List

On the Interoperability > List > Productions page, you can use the following options:

  • Click New to start the Production Wizard to create a new production in this namespace.

  • Click Open to display the Production Configuration page for the selected production.

  • Click Export to export the selected production. See Deploying a Production for details on exporting and deploying a production.

  • Click Delete to delete the selected production.

  • Click Document to view or generate configuration documentation for this production.

  • Enter text in the Search text box to search for productions that contain the specified text in their definitions.

The table on this page provides the following information for each production:

  • Production Name — The name of the production.

  • Status — The status of the production.

    If a production is Suspended or Troubled, see Correcting Production Problem States in Monitoring Productions.

  • Last Start Time — The date and time when the production was last started.

  • Last Stop Time — The date and time when the production was last stopped.

FeedbackOpens in a new tab