Deploy

Deploy is the operation of upgrading a target machine to a new version of your USoft application by applying the instructions and data contained in the delivery of that version.

Exactly what must be done to deploy each deliverable depends on the type of deliverable. For example:

•A new publication made in Web Designer must be deployed by replacing the old publication files by the new and then restarting the local Rules Services in scope.

•New metadata (for example, new constraints made in USoft Definer) must be deployed by replacing the old flatfiles by new flatfiles and then restarting the local Rules Services in scope, if the target machine runs from repository. They must be deployed by running delivered metadata XML files if the target machine runs from repository.

Deploy scripts

It is good practice to deliver instructions about how to deploy each type of deliverable. These can take the form of step-by-step text instructions, executable Powershell scripts, or executable USoft Blend scripts.

About USoft Blend

USoft 9.1 introduces an XML-based, set-oriented processor that executes typical USoft deployment tasks automatically. These tasks include making flatfiles; creating physical database tables; starting and stopping Rules Services; exporting and importing data; configuring and deploying published Web Designer publications and Service Framework servers; and many more. You can script these tasks by calling ready-made processing commands from XML files. The processor and the processing command library go under the working title of UBlendIt.

The new USoft Delivery Manager offers an array of UBlendIt samples for each type of deliverable (flatfiles, deliverable data, Web Designer publications, Service Framework servers, SQL upgrade scripts…). You can tailor these samples to the specific needs of your application environment.

UBlendIt has Alpha status. Its features will be published progressively in 9.1.x product documentation versions.

You can execute a USoft Blend sample script by running from the command line:

(USoft 32-bit installation:)

> usoft-install-dir\bin\ublendit.exe blend-script.xml

(USoft 64-bit installation:)

> usoft-install-dir\bin64\ublendit.exe blend-script.xml

Delivery Manager facilitates the inclusion of an appropriate USoft Blend script for each type of deliverable. As an example, here are the steps for including a default script for deploying flatfiles on target machine TM:

•Edit the registry XML so that it identifies the USoft installation directory on TM, as well as the names and port numbers of the Rules Services in scope on TM.

The result is that an appropriate USoft Blend deploy script is placed in the \flatfiles release folder. When deployers run the script after delivery, the delivered flatfiles are automatically copied to the correct location, and the Rules Services are restarted.

Configure example 1 illustrates the use of a registry for configuring machine-specific information, combined with a deploy script that reads this information at the time when deliverables are deployed.