Service versioning concept

StreamServer application exposes service

When you deploy a Project that includes a service-enabled Message to a StreamServer application, the StreamServer application automatically exposes a service. The service used for creating, previewing, and releasing documents based on the Runtime configuration.

Service version equals Project version

The service is assigned the same version as the deployed Project. The service version is registered in a service directory in the runtime repository when the StreamServer application is started, and is unregistered when the StreamServer application is stopped.

Paused Messages locked to service versions

A paused Message in the Message storage is locked to the service version that originally created the Message. To preview and release the corresponding document, the StreamServer application that exposed the specific service version must be running.

Several service versions can run in parallel

Several versions of the same service can run in parallel in the application domain. This means that you can preview and release paused Messages based on one version of the Project using one StreamServer application, and at the same time create new documents based on a later version of the same Project using another StreamServer application.

Document definitions tied to service versions

There can be only one published version of a document definition at a time.

When a document definition is published or republished, it is tied to the latest available service version in the application domain. New documents can only be created by the StreamServer application that runs the latest version of the Project.

An already paused Message can only be previewed and released by the service version that originally created the Message. The service version will continue to use the original document definition, based on the original StoryTeller template, that was published by this specific service version.

Note:

Because the paused Message uses the original document definition, it can be previewed and released before the document definition is republished.

Promoting previous versions of document definitions

If several versions of the same service run in parallel in the application domain, business users cannot view and promote all previous versions of document definitions in StreamStudio Composition Center.

To view and promote a previous version of a document definition, both the service version and the version of the StoryTeller template that the document definition is based upon must remain unchanged (that is, must be the latest service and template versions).