Stambia Analytics User's Guide

Preface

Welcome to Stambia Analytics!

This guide contains information about how to administer and monitor Stambia using Stambia Analytics

Below is a summary of the main features which are explained in this document:

• Creation and usage of Session Reports to visualize and follow sessions' execution in time.
• Creation and deployments of Deliveries to Runtimes
• Creation and configuration of different working environments, such as development, testing, production, ...
• Management of all attributes' values such as server URLs, passwords, ... for each defined environment.
• Usage of REST APIs to perform operations on Stambia Analytics

Audience

This document is intended for users interested in using Stambia Analytics to parameterize Packages and go into production, schedule executions, follow up the session’s executions, view sessions' details, ... .

Document Conventions

This guide uses the following formatting conventions:

Other Stambia Resources

In addition to the product manuals, Stambia provides other resources available on its company website: www.stambia.com and community website www.stambia.org.

Obtaining Help

To get help you can:

1. contact our global Technical Support Center: www.stambia.org/di/support.
2. consult the articles on our community website www.stambia.org.
3. consult or post topics on our forum on www.stambia.org.

Feedback

We welcome your comments and suggestions on the quality and usefulness of this documentation.
If you find any error or have any suggestion for improvement, please contact us at www.stambia.org/di/support and indicate the title of the documentation along with the chapter, section, and page number, if available. Please let us know if you want a reply.

Introduction to Stambia Analytics

Product Overview

Stambia Analytics is a web application which is used to manage all production process, from definition and configuration of environments, deployment of deliveries on those environments, to consultation of execution logs.

With Stambia Analytics you’ll be able to define as many environments as needed, such as development, test, or production environments.
Each environment will have its own set of Runtimes and Configurations.

You’ll then be able to manage all the production process on those environments, through dedicated features allowing to
configure, follow, and publish deliveries on each of them, with a notion of version to be able to historize what is deployed on Runtimes and come back to previous versions easily in case of issues.

Stambia Analytics moreover offers the possibility to consult execution logs with statistics, graphs, and ability to navigate inside executed sessions to find exactly what has been executed: which SQL Queries, which steps, which actions, ...

Graphical interface Overview

Here is an overview of Stambia Analytics graphical interface:

Additional views with more information may be displayed depending on the context and opened editor.

HTTP REST APIs Overview

A complete HTTP REST API is available to perform operations on Stambia Analytics through other tools easily.

Those APIs offer the possibility to manage and operate Delivery Projects, which are used to import sources, build and deploy deliveries on the different defined environments.

Stambia Analytics generates automatically a Swagger descriptor describing all available operations, and is shipped with Swagger-UI which can be used to play with the APIs easily.

For further information refer to the «Appendix 1 - REST API Reference» dedicated section in this document.

Managing Sessions

Defining Session Reports

Session Reports are used to gather, filter and visualize a list of sessions based on the criteria defined by the user.

Changing Profiles

Sessions which are retrieved in Session Reports are retrieved from the Log Databases of Runtimes.

The Log databases from which sessions are retrieved are defined through Profiles, Log Databases, and Runtimes, which can be selected from drop down list which can be found at the bottom of Stambia Analytics.

Sessions Reports will retrieve sessions only from the selected Profile, Runtime, or Log Database.

Refer to Stambia Analytics Installation and Configuration Guide to learn how to add items in this list.

Creating Session Reports

There are two types of Sessions Reports, public Sessions Reports which are visible by all users and stored under the Public Session Reports topic, and private Session Reports which are only visible by the current user and stored under the My Session Reports topic.

To create a new Session Report:

1. Right click in the Public Session Reports or My Session Report topic in the Navigator View.
2. Choose "New Session Report"
3. Give a name to the report
4. Modify the criteria to match your needs
5. Save and refresh sessions list

The sessions that meet your criteria will appear in the table.

Refreshing sessions list

You can manually refresh the session list through the refresh button or enable auto-refresh mode on the session report.
When auto-refresh is enabled, the sessions list will be refreshed periodically using the delay specified in Preferences.
You can enable or disable auto-refresh at any time on each session reports by clicking on the auto-refresh button.

Icon	Description
	Button to manually refresh the sessions list.
	Auto refresh is started
	Auto refresh is paused

Example:

Modifying criteria

Here are the criteria that you can choose to filter your sessions:

Standard settings

The From and the To parts allow you to set the time scope of your report:

• Today will only display the sessions executed since or until today (depending on which of the two fields From, or To you are using)
• Yesterday will only display the sessions executed from or until yesterday
• Absolute allows you to define a specific day
• Days before allows you to specify a number of days in the past.

Advanced settings

Available statuses

Available Launch Modes

Available Execution Modes

Modifying displayed information columns

By Right-clicking on the sessions list table header, you can choose the columns you want to display.

This allows to add columns displaying information such as the Runtime which executed the session, ...

Columns' display modifications are saved for each user through cookies. If cookies are not allowed in the browser, modifications will be discarded when the user exits his web session.

The views

Around the sessions table, some views are useful to retrieve knowledge about the session when you click on it in the sessions table.

• The Statistic view gives the aggregated statistics on the session.

• The Variable view gives the main variables of the session

• The Information view gives an overview of important information (this information is the same as information you will find in the variable view or the sessions table)

Session detail

Entering session details

You can enter into session’s details by double-clicking on the session’s row in the sessions table.

This will open a new window, in which the session execution tree will appear.

The tree can be opened.

The views

You can find in this editor the same Views as in a Session Report.

Clicking on each node of the tree will synchronize the information displayed in the different views.

• The Statistic view gives the aggregated statistics for the selected step

• The Variable view gives the variables for the selected steps

• The Information view gives an overview of some important information for the selected steps. If the steps contain an executed text (for example a SQL order), an executed code tab appears in this view.

• If clicking on a step that has a text code, the Executed view gives the final executed code.

Modifying the displayed information and the session status

In the upper-right side of the session detail window, buttons can be pressed in order to select the information displayed in the tree.

Button	Description
	Message button allows to display the user messages. These messages should have been planned by the Process Designer.
	Details button allows to display the detail of a session (by default, this button is pressed)
	Warnings button allows to display only the details having warning messages.
	Errors button allows to display only the details having error messages.
	Stop button stops the current sessions if it is running.
	Restart button restarts the current session when it is in an error status.
	Refresh button refreshes the session tree. This is useful when the session is running.

Visualization of sessions

In a Session Report, you can visualize sessions from three different ways, represented through the three different tabs which can be accessed at the bottom of a Session Report Editor.

The Sessions tab

The Sessions tabs is the list of sessions returned by the defined criteria.

The Charts tab

The Charts tab gives some graphs that summarize the statistics of the sessions.

The Timeline tab

The Timeline tab shows sessions' executions over time.

To navigate in the timeline:

• Maintain left click and move left and right to go through time

To zoom in and out:

• Use the mouse wheel
• Double click on an empty place
• Maintain right Click and select the zone on which you want to zoom in
• Use the zoom buttons

To view the information of a session:

• Left click on the session. Information appears on the dedicated views
• Double click on a session to open the Session detail

Timeline Legend:

Full line: Normal execution

Multiple blank separated lines: Same session executed in parallel.

Dotted lines: child sessions

Gradation: Sessions scheduled.
Stambia Analytics analyze the already executed sessions and estimate the time for future scheduled one’s.
The Fifty next schedules are shown.

Current time:

Restarting or stopping a session

To restart or stop a session there are two ways:

• In the session report editor, a right-click on a session allows to restart or stop the session.

• In the session details editor, the button bar has two buttons to restart or stop the session.

Getting the documentation of a Process

If the Deliveries have been built through a package including the documentation, all the sessions running with theses will be linked to the documentation.

In this case, the documentation is accessible at different locations:

• On the sessions list, by a right-click on the session. In this case, it will open the Process documentation.

• In the detail of a session, by a right-click on a session’s tree node. In this case, it will open the documentation of the specific node (step of the Process).

• Inside the Deployment Manager, by a right-click on the Package including the documentation.

Managing Runtimes

In the Navigator View, under the Runtimes topic, will be listed all the Runtimes of the currently selected Profile.
If the list is empty, check if a profile is selected in the bottom combo box.

Changing Profiles

Listed Runtimes are retrieved from the currently selected Profile or Runtime.

Runtimes to display can be selected from drop down list which can be found at the bottom of Stambia Analytics.

Refer to Stambia Analytics Installation and Configuration Guide to learn how to add items in this list.

Runtime detail

By a double-click on a specific Runtime, a new window will appear.

This window has several tabs:

• The monitoring tab gives information on the clients connected to the Runtime and on the session’s thread running on the Runtime.

• The Virtual Machine tab gives real-time information on the Java Virtual Machine on which the Runtime is running.

• The Test tab is useful to make some tests directly on the Runtime. You can test an IP route (to know if an IP port is available from the Runtime towards another host), or you can test the existence of a Folder (directory) on the Runtime server.

• The Purge tab is used to schedule a purge for the Runtime log database. You can add, edit or remove purges with the corresponding buttons. You can configure on a scheduled purge how many sessions, days, etc are kept, when it is executed, ...

• The Command tab allows to execute Runtime commands.

Runtime Deliveries

A Delivery can be opened by a double-click on it. The opened view allows to execute, restart or delete a session for this Delivery.

A session list is automatically displayed, filtering on this Delivery.

The criteria can be modified in order to refine the session list.

A right-click on the Delivery in the navigator view allows to execute or define a new schedule.

When executing Multi-Configuration Deliveries, a selection window will open to choose the Configuration to use.

Scheduling a Delivery

In order to schedule a Delivery:

1. Right-click on the Delivery in the Navigator View
2. Choose New Schedule
3. A new window appears, allowing you to define the schedule.
4. In this new window, each tab Second, Minute, Hour, Day, Month, Year should be filled according to the schedule you want to create.
5. This will generate a sort of cron expression that will be sent to the Runtime when the schedule information will be saved.

Note: For Multi-Configuration Deliveries, a Configuration must be selected in the corresponding combo box.

Managing Delivery Projects

Concepts

A Delivery Project is used to follow, configure, manage and deploy deliveries on multiple environments.

A Delivery Project contains a number of Packages which are defined in administration, and which are logical and versioned placeholders containing a set of sources.

Each Package has its own life cycle which can be managed through Stambia Analytics UI or through the available REST APIs.

You have the possibility to create, for each Package, different versions and deploy the one you want on a given environment, offering the possibility to deploy a given version on development environment for instance, while the last stable version is deployed on the production one.

Overview of graphical UI

Description of each item

Defining Delivery Projects

Definition and configuration of Delivery Project is performed in administration.

If you want to create a new Delivery Project, defines its Environments, Packages, Configurations, ... open administration and go to Delivery Projects.

You can define and configure here Delivery Projects which will allow to build and deploy Packages on one or more Environments.

1. Click the add Button
2. Set a name for the Delivery Project
3. Create one or more Packages.
4. Add one or more Environments.

If multiple environments are defined in the same Delivery Project, it will be possible to manage the lifecycle of each Package across the various environments. For instance, if a Delivery Project uses the «Tests» and «Production» environments, it will be possible to deploy Version 1.0 of a Package in «Production» and deploy Version 2.0 of the same Package in «Tests» without impacting the «Production» environment.

Warning: Environments display order in Package Editor is computed from the order in which they have been added in the Delivery Project when configuring it. If you want to change the order in which the Environment columns appear in Package Editor, such as having «Development», «Testing», «Production» in the correct order from left to right, you have to make sure they are in the wanted order in the list of Environment of the Delivery Project, and if not, delete them, save, and them again in the correct order.

Note: For further information about Configurations, Runtimes, and Environments definition please refer to Analytics Installation and Configuration Guide.

Managing Versions

Each Package defined in a Delivery Project is managed through its own cycle of life, having its own versions which can evolve in time.
A Package Version corresponds to a consistent set of sources that should be deployed altogether on the different environments.

Each Version of a Package can contain a different set of sources, which will then be deployed on the target environment when performing deployment operations.

Example:

To manage the Versions of a Package, double click on the corresponding Package in the Navigator View. This will open the Package Editor where each Package Version corresponds to a row in the table and each column corresponds to an Environment into which the Version can be deployed.

Creating a new Package Version

New versions are created using the add button, which creates a new empty version with a default name computed automatically.

It is possible to rename the Version by clicking on the <VersionName> link:

Importing sources

To import new sources or to update existing ones in a version:

1. Edit the version through the edit button or by clicking on the version name
2. Click on the import button
3. Then click on the Browse button
4. Select the archive containing the sources to import
5. Click on the Open Button
6. Click on the OK Button
7. Click on the Save Button

Note: When importing sources Stambia Analytics automatically checks the consistency of the version which may lead to warning or error messages. For more information on this topic, refer to the chapter Understanding Warning and Error messages.

Note: An archive containing sources correspond most of the time to a Package file generated from the Designer software.

Duplicating an existing version

A new version can also be created by duplicating an existing one. This can be done by clicking on the duplicate button.

This creates a new version with a default name computed automatically and that contains exactly the same sources as the duplicated version.

It is possible to rename the version by clicking on the <VersionName> link.

Managing Deployments

Creating a Deployment

By default, when creating a new version or when duplicating an existing one, no Deployment is created. After having imported sources into the version, the next step consists of creating a Deployment by clicking on the add button for the desired environment.

A Deployment is the association between a Package Version and the Environment for which this version should be configured and deployed to.
This is used to configure the required Metadata for the given Version and Environment, and to build and deploy corresponding deliveries.

Creating a Deployment

This sets this new Deployment as the working deployment in this environment.

Configuring Metadata

By clicking on configure button, it is possible to edit the Metadata values required by the sources for the given environment. This opens the Metadata editor filtered to focus only on required Metadata attributes.

Clicking on the configure button

Defining Metadata Attributes

The following filters and helpers are available on this window:

Button	Description
	Button allowing to filter the list with Configurations / attributes having unset values which need to be specified.
	Button allowing to initialize all missing values with the default attributes' values. Note that default values are extracted from the sources when extracting Metadata attributes while importing sources.
	Button allowing to test databases connection with current settings. Note that this requires the JDBC driver of the database to be installed in Stambia Analytics

Important: Configuration attributes values are global to all the application. If you modify the value of an attribute on a «development» Configuration for instance, all the Projects, Packages, and Packages Versions using the same «Development» Configuration will be impacted.

Note: When creating Deployments or editing Configurations Stambia Analytics automatically checks the consistency of the Version which may lead to warning or error messages. For more information on this topic, refer to the chapter «Understanding Warning and Error messages».

Building and deploying a Version

Once a Deployment has been specified and configured, it is possible to deploy it to the Runtimes configured in the corresponding environment.

When clicking on the deploy button, Stambia Analytics will generate and deploy deliveries on the Runtimes of the given environment, based on the Metadata attributes configured for this environment and the version’s sources.

Click on the deploy button

Version is deployed on development environment

Note The deploy button is available in an environment only for the currently deployed version as well as for the working Version. To restore a previous build for the given Deployment, refer to the chapter Restoring a previous Build.

Understanding Warning and Error messages

Under certain circumstances, a Deployment may require some attention. For instance if a Deployment has been made with an older version of the sources, or if the Metadata values set in the used Configuration has changed since the last deployment, warning or error messages are displayed.

More information on the root cause of the message can be found by performing an analyze on the version

Restoring a previous Build

Each time a Deployment is made Stambia Analytics stores a copy of the built deliveries. There are three different possibilities when restoring previous Builds:

• Restore the build exactly as it was deployed, including the same Configuration values
• Re-build and deploy the corresponding version with the current Configuration values
• Download the built Deliveries to manually deploy them on specific Runtimes

Restoring a Build with the initially configured values

1. Click on the Build link
2. Among the Builds historized by Stambia Analytics select the one to restore
3. Review the differences between the built sources and the current sources in the version: If a version has been deployed multiple times with changes in the sources (this is typically the case when a Deployment remains in working status for a long time) the sources that differ will be displayed with a warning icon and with an OK icon otherwise
4. Review the Metadata to check any difference with the current Configuration values
   1. It is possible to Filter displayed Metadata by selecting one or more sources holding the CTRL or SHIFT keys and selecting the Processes
   2. If values used to perform the build correspond to existing values in Configuration, they will be displayed with a green check icon and with a warning icon otherwise
5. To restore the selected Build with these Metadata values, click on the deploy button

Re-building and deploying with current configured values

1. Set the Deployment as the current working Deployment for this Environment
2. Click on the deploy button

Stambia Analytics will apply the current Configurations values on the sources of the version and will publish the Deliveries to the Runtimes of the given environment.

Example

Version deployed on development environment

Downloading the deliveries of a previous build

1. Click on the build link
2. Among the builds historized by Stambia Analytics select the one to download
3. Click on the download button

This will download the deliveries locally allowing for instance manual installation on another Runtime.

Validating existing Deployments

Analyzing a specific Deployment

When a version has been deployed to an Environment Stambia Analytics can analyze the Deployment and provide feedback on the status of each source Process regarding build and deployment status on each Runtime. To trigger the analysis, click on the button.

This will open a page with a detailed report for each source Process:

• The first column contains the source Process name along with an icon indicating if the source Process is valid or if warnings were detected
• The second column indicates the status of the Build of this source Process
• The other columns indicate the status of the corresponding delivery on each Runtime

Build statuses

Runtime statuses

Manually validating multiple Deployments

Stambia Analytics can analyze multiple Deployments at once and provide feedback on Packages requiring attention.

In the Navigator, right click on one of the following nodes and select Validate:

• Delivery Projects root node
• Delivery Project node
• Package node

Stambia Analytics will analyze all the Deployments under this node and will display an icon in the Navigator corresponding to the level of attention required if any, according to the checks described in chapter Analyzing a specific Deployment

Managing Configured Metadata

Importing Metadata only

Stambia Analytics allows to import the Metadata attributes globally outside of a any Delivery Project context. This is useful in order to prepare the configuration values before importing the Packages into the Versions:

1. In the Navigator, right click on Delivery Projects
2. Select Import Package Metadata
3. Click on the Browse button
4. Select a Package archive from which Metadata attributes should be extracted.
5. Click on the Open Button
6. Click on the OK Button
7. Click on the OK Button

Stambia Analytics will extract the Metadata attributes of the provided archive.
It is then possible to review the Configurations and set the new Metadata values.

Managing Metadata

Metadata attributes values can be defined either from the global Metadata Editor or directly from a Package Editor in order to focus on a specific set of attributes values. In both cases the attributes values are updated for the corresponding Configuration which will potentially impact multiple Delivery Projects and Packages.

For instance, if you change the value of a server URL Metadata attribute on the «Development» Configuration, all the Delivery Projects and Packages using the «Development» Configuration will be impacted by the change.

Managing Metadata values from Metadata Editor.

It is possible to edit Metadata values for all the Configurations through the main Metadata Editor.

1. In the Navigator, right click on Delivery Projects root node
2. Select Open Metadata Editor
3. Update or set the values for the Metadata
4. Click OK to save the new values in the Configuration

Note: It is possible to filter this editor on Metadata without any value, through the red filter button.

Managing Metadata of a specific environment from Package Editor

When you are working on a specific Delivery Project and Package, you can also manage Metadata values directly from the Package Editor.

1. Click on the configure button of a Deployment.
2. Update or set the values for the Metadata
3. Click OK to save the new values in the Configuration

Clicking on the configure button

Changing Metadata values

As for the Metadata Editor, changing the value of a Configuration will impact the Configuration itself, so all the Delivery Projects and Packages which are using it.

Note: It is possible to filter this editor on Metadata without any value, through the filter button, and also to test connections if the corresponding JDBC driver is installed in Stambia Analytics.

Appendix 1 – REST API Reference

Overview

Stambia Analytics is exposing REST APIs to perform operations on the application programmatically.

The complete list of available operations and parameters is exposed through a Swagger descriptor file, and an embedded Swagger-UI component allowing to visualize and play with the APIs.

Authentication required to use the APIs is an HTTP Basic Authentication, and the user connecting must have ‹analyticsRepositoryAdmin› role to be able to perform operations. Refer to Analytics Installation and Configuration documentation for further information about users and roles

Technical Return Codes Reference

When invoking the REST API, if there is an issue while processing the request Stambia Analytics will return with a corresponding error code and message through a JSON message which will be returned, and the HTTP status code.

Those functional error may appear for instance when trying to perform operations on objects which do not exist, when trying to deploy deliveries on unavailable Runtimes, etc.

You can find below the complete list of codes and messages which may be returned.

Appendix 2 – Using Deployment Managers (Stambia Analytics V2.x)

Warning: Deployment Managers have been removed in 3.x and replaced by Delivery Projects.

Introduction

Deployment managers allow you to customize, configure and manage the deployment of the integration processes developed on the Stambia Designer tool.

A Deployment Manager will contain Packages, Deployment Specifications and topology information (connections, metadata configuration).

Creating a Deployment Manager

In the Navigator View , under the Deployments topic , will be listed all the Deployment Managers that have been created.

To create a new Deployment Manager:

1. Right-click on the Deployments node in the Navigator View
2. Choose New Deployment Manager
3. Give a name and click on Finish

Deployment Manager View:

The arrows are used to navigate through the items with missing settings.

The Deployment process

In a Deployment Manager, you will be able to

• Import the Packages generated through the Stambia Designer tool by the people who have designed the integration processes.
• Define new Configurations. For instance you can define production or preproduction Configurations.
• Define Deployment Specifications on Packages, which allow to customize the Package deployment and metadata properties through the specified Configurations.
• Build a Delivery
• Deploy this Delivery on the Runtimes
• Manage the versions and check differences

Importing a Package

To import a Package:

1. Open the Deployment Manager
2. Click on the Import button
3. Browse and choose a Package file, the extension of which is .pck

The package will be imported and attached to the Process node.
Different packages files can be attached to a same Process node, according to their unique identifier.
The default name used for the imported Package is the import date.

To import multiple packages at the once, simply make a zip archive containing all your packages and import it with the Import button
The packages must be at the root of the archive and only .zip files are allowed.

Organizing Packages

You can structure your Deployment Manager using virtual folders .
This allows to organize and arrange your packages under a folder tree.
To create a folder, click on the New Virtual Folder button.
You can create as many folder/sub-folders as you need.

Then, simply drag and drop your packages between folders to organize them.

Defining Configurations

You have to define the Configurations that will be used to configure the Delivery’s metadata.
To define a new Configuration:

1. Click on the Configuration tab in the Deployment Manager
2. Click on the Add button
3. On the right side fill the Name field that will be the unique identifier of the Configuration.
4. Don’t forget to save.

Note: The Configurations could be, for instance, PROD, PREPROD, or TEST.

Composed Configurations:

The Configuration can be configured to inherit from other existing Configurations with the Parents field.
To define a new Composed Configuration:

1. Click on the button near Parents field.
2. This will open a new Window in which you will select the desired Configurations.

Note: The order is important as it will define the inheritance order: the values of the lowest Configuration will be taken, if a value is not found, the value of the upper configuration will be taken, and so on...

Creating a Deployment Specification

Once you have imported a Package, and you have defined at least one Configuration, you will be able to create Deployment Specifications and configure the metadata.

To create a Deployment Specification:

1. Right-click on the Process node
2. Choose New Deployment Specification
3. On the specification , specify one or multiple Configurations by clicking on the button near Configurations property.
4. This will open a new Window in which you will choose the Configurations you want to associate to your Specification.

Note: # You can have multiple Configurations associated to a Deployment Specification. It offers the possibility to execute a delivery with different Configurations, useful for testing with different values, for example.
# Do not confuse this with a Composed Configuration, which is a single Configuration that inherits from other ones.

Configuring the metadata properties

Once the Deployment Specification is created and associated to one or more Configurations, you will need to configure the metadata properties on these specified Configurations.

1. Click on the Deployment Specification.
2. On the right part will appear the list of the metadata that you need to configure.

If the Error icon appears on property, you have to configure the metadata, because it has not been configured before.
If the Configuration icon appears, then the metadata is correctly configured.

Several Packages can share the same metadata. In this case, some metadata could already be configured due to a previous deployment work.

You can filter all properties which need to be configured by clicking on the error icon on the top of Configuration table, next to the text filter.

To define the metadata:

1. Click on the property that you want to configure
2. On the bottom part, the property will appear with its imported value. This is the value that has been exported from the design moment when the Package was created.
   1. You can keep the same value by clicking on the Configuration link
   2. Or you can define your own value by filling the text area
3. Do this for each property that has the Error icon

Note: For composed Configurations, you can see that all the parents appear in this window. If a value is not set, the value from the parent will be taken.

Tip: Use the Initialize top button to set all the missing values to the default package values.

Remotely available deliveries

You can set a delivery as Remotely Available.
A Runtime configured to access to the Deployment Manager will fetch the latest version of the delivery before executing it.

1. Click on a Deployment Specification.
2. Check Remotely Available.
3. Optionally, change the remote name, which by default is the process name.

Building a Delivery

Once all the metadata are configured, a Delivery can be built from the Deployment Specification.

1. Right click on the Deployment Specification node , and choose Build Deliveries.
2. This will create a new version of Delivery and place it under the Deployment Specification node.

Note that you can build Deliveries from any nodes (Specification, Process, Folder, ...) with right click and Build Deliveries.
This will create a Delivery for each child of the node.

Note The metadata configured on a built Delivery cannot be modified. If a modification needs to be done, update the Deployment Specification, and build a new version.

Tip: Click on the top Build All button to build Deliveries for the entire Deployment Manager.

Deploying Deliveries on the Runtimes

A version of a Delivery can be deployed on Runtimes.

To proceed, you’ll first have to associate one or more Runtimes to the Deployment Specification.

1. Click on the Deployment Specification
2. Click on the button near Runtime property.
3. This will open a new Window in which you will choose the Runtimes you want to associate to your specification.

After associating one or more Runtimes, you can deploy Deliveries to them.

There are three ways to do it:

• On the Delivery

1. Right click on the Delivery and choose Publish Delivery

• On any node of the tree (Specification, Process, Folder, ...)

1. Right click and choose Publish Deliveries
2. This will open a new Window in which you will select the Delivery to publish and on which Runtime.

• Alternatively, you can also decide to download the Delivery file and deploy it manually on the Runtimes.

1. Right-click on the Delivery
2. Choose Download Delivery

Note: You can only deploy the Delivery on a Runtime by a Publish operation if the Runtime is started (on-line) and accessible.

Tip: Click on the top Publish All button to publish all Deliveries of the Deployment Manager.

Defining Deployment Schemes

Deployment Schemes can be used to automate the configuration of Deployment Specifications.
A Scheme is simply a pre-configured Specification where you can define the Configurations, Runtimes, and options that must be used.
After defining a Scheme, you can choose to use it on the desired Deployment Specifications using the Deployment Scheme box.

Warning: When updating a Scheme, all the Deployment Specifications using it will be impacted.

To define a Deployment Scheme:

1. Click on the Deployment Scheme tab in the Deployment Manager
2. Click on the Add button
3. On the right side fill the Name field that will be the unique identifier of the Deployment Scheme.
4. Define the properties accordingly to your requirement: Runtime, Configuration, ...
5. Don’t forget to save.

The ‹Use as default Scheme› property allows to specify that the Scheme must be used automatically on newly created Deployment Specifications.

The ‹Remote name mask› property can be used to define dynamically the remote name of the Specifications using the Scheme.
This allows to use the same Scheme on multiple Specifications by using the following masks:

The masks will be replaced automatically with their values on the Specifications using the Scheme.

You can moreover use the Generate Schemes button to automatically create all the Schemes corresponding to the existing Deployment Specifications.
After clicking on this button, Stambia Analytics will generate the Schemes and let you choose if you want to use the newly created Schemes on the Deployment Specifications.

Managing Delivery versions and checking the differences

The current and default versions

Packages

If you import new versions of a Package you have imported before, the last imported Package will become the current used version of the Package .
A new icon will be added to specify that this Package is the one used to generate the Deliveries.

Delivery versions

If you create a new version of a Delivery, the last Delivery version you created will become the current version of the Delivery .
A new icon will be added to specify that this Delivery version is the last version.

Checking the differences

• Differences between metadata and the built version of the Delivery

If there are differences between the Delivery metadata and the version of the Delivery, a warning icon will appear on the objects (tree nodes and metadata properties).

This is probably because a metadata has been changed before the Delivery was built.

• Differences between the built version and the deployed version on the Runtimes

You can check the differences between the built version of the delivery and the version deployed on the Runtimes. This is available if you defined Runtimes for this Delivery.

Under the current version node you will see the Runtimes on which different statuses can appear.
A warning icon will appear if a difference is found.
A question icon will appear if the difference is unknown.
A green checked icon will appear if the built Delivery and the deployed Delivery are correctly synchronized.

To check the differences:

• Right click on the Runtime under the current version node and choose Analyze.
• Right click on any node of the tree and choose Analyze Runtimes.

Tip: Click on the top Analyze All button to analyze all the runtimes.

Restoring a previous version

It is possible to restore a previous version of a Package or a Delivery.

• To change the current Package, click on the Current Package check box.
• To change the current version, click on the Current Build check box.

The default green icon will appear on the element you have selected.