Developing Ensemble Productions
Deploying a Production
[Back] [Next]
   
Server:docs1
Instance:LATEST
User:UnknownUser
 
-
Go to:
Search:    

Typically, you develop a production on a development system and then, after completing and testing the production on a test deployment, you deploy it on a live production system. This chapter describes how to use the Management Portal to package a deployment from a development system and then to deploy it on another system. It also describes how you can develop and test changes to a production and then deploy those updates to a system running with live business data. This chapter includes the following sections:

Overview of Deploying a Production
You can deploy a production using either the Management Portal or Studio. The Management Portal automates some steps that you need to perform manually using Studio. If you have a live production that is being used and are developing updates to the production, you need to ensure that the live production is updated without interrupting your processing of business data. At its simplest level deploying a production is done by exporting the XML definition of the production from one system and importing and compiling the XML on a target system. The most important issues for a successful deployment from development to live systems are:
Typically, deploying a production to a live system is an iterative process, with the following steps:
  1. Export the production from the development system.
  2. Deploy the deployment file on a test system.
  3. Ensure that the production has all required components and runs properly on the test system. If any failures are found fix them and repeat step 1.
  4. After the production has been deployed to the test system without errors, deploy the deployment file to the live system. Monitor the live system to ensure that the production continues to run correctly.
You should ensure that the test system environment matches as closely as possible the environment of the live system. If you are updating an existing production, the production on the test system should match the production on the live system before the update is applied. If you are deploying a production on a new Ensemble installation, the test system should be a new Ensemble installation.
In order to update a component in a running production, you must do the following:
  1. Load the updated XML on the system.
  2. Compile the XML.
  3. Update the running instances of the component to the new code by disabling and re-enabling the component.
The deployment process is slightly different depending on whether or not the target system is already running a version of the production. If the target system is running an older version of the production, then the deployment file should contain only the updated components and some configuration items, and, in most cases, it should not contain the definition of the production class. If the target system does not contain the production, the deployment file should contain all production components and settings.
If you use the [Ensemble] > [Deploy Production Changes] Management Portal page to deploy updates to a running production, the portal automatically does the following:
  1. Creates a rollback and log file.
  2. Disables components that have configuration items in the deployment file.
  3. Imports and compiles the XML. If there is a compilation error, the portal automatically rolls back the deployment.
  4. Enables the disabled components
There are some conditions where you have to explicitly stop and restart a component or the entire production. If you are using Studio or importing the classes from the Management Portal System Explorer, then you have to perform these steps manually.
Exporting a Production
To export the XML for a production using the Management Portal, open the production, click Production Settings and the Actions tab and then click the Export button. Ensemble selects all business services, business processes, business operations, and some related classes, and then displays the following form to allow you to add export notes and additional components.
You can also export a business service, process, or operation by selecting the component in the production configuration and then clicking the Export button on the Actions tab. In both cases, you can add additional components to the package by clicking on one of the buttons and selecting a component. You can remove components from the package by clearing the check box.
You can use the export notes to describe what is in the deployment package. For example, you can describe whether a complete production is in the package or set of components that are an update to a production. The export notes are displayed when you are deploying the package to a target system using the Management Portal.
When you are exporting a deployment package, the first decision you should make is whether the target system has an older version of the production.
If you are deploying the production as a new installation, you should:
If you are deploying the production to update a live version of the production, you should:
Although many components are included by default in the package, you have to add others manually by selecting one of the buttons in the Add to package section. For example, if any of the following are used in your production, you need to add them manually:
If you have a set of classes defined in a studio project file, you can include those classes in the deployment by clicking the Studio Project Files button and selecting the file.
The Production Settings button allows you to add the production ptd file. This XML defines the following:
You can deselect any component in the list by clearing its check box. You can select a component by checking its box. The Select All button checks all the boxes and the Unselect All button clears all check boxes.
Once you have selected the components for the deployment package, create it by clicking Export.
The deployment package contains the following information about how it was created:
You should keep a copy of the deployment file on your development system. You can use it to create a new deployment package with the latest changes to the components. Keeping a copy of the deployment file saves you from having to manually select the components to be included in the deployment file.
To create a new deployment package using an existing deployment package to select the components, do the following:
  1. On the development system with the updated production, click Production Settings and the Actions tab and then the Re-Export button.
  2. Select the file containing the older deployment package.
  3. Ensemble selects the same components from the current production that were included in the older deployment package.
  4. If there were any components missing from the older deployment package or if you have added new components to the production, add the missing components manually.
  5. Click the Export button to save a new deployment package with the updated components.
Note:
If a production uses XSD schemas for XML documents or uses an old format schema for X12 documents, the schemas are not included in the XML deployment file and have to be deployed through another mechanism. Ensemble can store X12 schemas in the current format, in an old format, or in both formats. When you create a deployment file, it can contain X12 schemas in the current format, but it does not contain any X12 schemas in the old format or any XSD schemas for XML documents. If your production uses an old format X12 schema or uses any XSD XML schema, you must deploy the schemas independently of deploying the production. For the schemas that are not included in the deployment file, they can be deployed to a target system by either of the following means:
Deploying a Production on a Target System
The Ensemble Management Portal automates the process of deploying a production from a development system to a live system. This section describes what Ensemble does when you are loading a new version of a production on a live system.
Once you have the deployment package XML file, you can load it on a target system. In the Management Portal, select the correct namespace and click Ensemble, Manage, Deployment Changes, Deploy, and then click the Open Deployment button and select the file containing the XML deployment package. The form lists the new and changed items in the deployment package, displays the deployment notes that were specified when the package was created and allows you to specify the following deployment settings:
When you have read the deployment notes and made any changes to the deployment settings, complete the deployment by clicking the Deploy button. As part of deploying the package, Ensemble does the following to stop the production, load the new code, and then restart the production.
  1. Create and save the rollback package.
  2. Disable the components in the production that have a production settings (ptd) file in the deployment package.
  3. Import the XML file and compile the code. If there is an error compiling any component, the entire deployment is rolled back.
  4. Update the production settings.
  5. Write a log detailing the deployment.
  6. Enable the production components that were disabled if their current setting specify that they are enabled.
To undo the results of this deployment change, you can select the rollback file with an Open Deployment and then click the Deploy button.
If you are using studio, you use the Tools Import Local or Import Remote to import the XML file. But you must then manually compile the components and then disable and re-enable them in the production. Using the Import classes button on the Management Portal System Explorer does automatically compile the classes, but it does not create a rollback package and disable the components.