Installing AMS


Table of Contents
AMS Installation
AMS Web Client Browser Support
Compatibility with StreamBase

This page explains how to install the Artifact Management Server (AMS) software on all supported platforms.

AMS Installation

Platform Requirements

The StreamBase platform's supported configurations exceed the AMS platform requirements. Although you can install AMS on a platform that is below the StreamBase guidelines, other platforms are not officially supported. See the Supported Configurations page in the Installation Guide in the TIBCO StreamBase® documentation.

Installing on Windows, macOS, or Linux

Run the installer as supplied from your purchase. By default, AMS installs to:

  • C:\tibco\sb-cep\n.m\ams (Windows)

  • /opt/tibco/sb-cep/n.m/ams/ (macOS, Linux)

Post-installation steps

Configure AMS by editing the site-specific configuration file as needed. See Configuring AMS.

Ensure the directory containing the AMS executable is on the PATH environment variable:

  • C:\tibco\sb-cep\n.m\bin (Windows)

  • /opt/tibco/sb-cep/n.m/bin (macOS, Linux)

If the local authentication realm is enabled, the AMS persistence realm will automatically be enabled as well, and any users that do not exist in the AMS persistence realm are copied from the local authentication realm. Post-installation, you may need to decide which realm(s) to enable and possibly change the contents of the local authentication realm in the AMS.conf file to modify, or remove one or more of the existing users and roles that would otherwise get copied into the AMS persistence realm the next time the AMS starts.

There is an AMS Command Prompt shortcut on Windows to set the appropriate environment, including the path, to run the AMS.

Upgrading From AMS 1.0.x to AMS 1.x

Upgrading AMS from 1.0.x to 1.x automatically backs up any existing AMS database to the data directory. The backup process accomplishes this by backing up the database's mv.db and trace.db files and copying them with a timestamp annotation (useful, for example, to preserve a backup or to later downgrade AMS).

The following example shows the AMS console output during upgrade. Note: lines below wrap to the next for legibility.

017-02-08 11.55.46.293 INFO  com.tibco.ep.ams.conf.Configuration.84 - 
  AMS configuration file: '/opt/tibco/sb-cep/10.1/ams/conf/AMS.conf'
2017-02-08 11.55.46.347 INFO  com.tibco.ep.ams.conf.Configuration.93 - D
  atabase file path: '/[Your site-specific location]/x/data/ams-h2-persistence'
2017-02-08 11.55.46.348 INFO  com.tibco.ep.ams.conf.Configuration.102 - 
  Authentication realms: [LocalAuthenticationRealm]
2017-02-08 11.55.46.543 INFO  com.tibco.ep.ams.DBMigrationUtil.302 - 
  Making a backup of the existing H2 database files
2017-02-08 11.55.46.548 INFO  com.tibco.ep.ams.DBMigrationUtil.308 -     
  /[Your site-specific location]/x/data/ams-h2-persistence.mv.db -> 
  /[Your site-specific location]/x/data/ams-h2-persistence.mv.db.2017-
  02-08.11.55.46.bak0
2017-02-08 11.55.46.548 INFO  com.tibco.ep.ams.DBMigrationUtil:308 -     
  /[Your site-specific location]/x/data/ams-h2-persistence.trace.db -> 
  /[Your site-specific location]/x/data/ams-h2-persistence.trace.db.2017-
  02-08.11.55.46.bak0
2017-02-08 11.55.46.548 INFO  com.tibco.ep.ams.AMSServer.176 - 
  Running the AMS server
2017-02-08 11.55.46.574 INFO  com.tibco.ep.ams.DBMigrationUtil.150 - 
  Creating migration table, db_migration
2017-02-08 11.55.46.576 INFO  com.tibco.ep.ams.DBMigrationUtil.179 - 
  Writing version 1.0 record to migration table, db_migration
2017-02-08 11.55.46.992 INFO  org.avaje.dbmigration.MigrationRunner.93 - 
  local migrations:1  existing migrations:1
2017-02-08 11.55.50.247 INFO  org.eclipse.jetty.server.ServerConnector.270 - 
  Started ServerConnector@58606c91{HTTP/1.1,[http/1.1]}{0.0.0.0:8080}

Data directory example after the auto-backup completes:

[Your site-specific information]:~/Desktop/x > ls -1 data
ams-h2-persistence.mv.db
ams-h2-persistence.mv.db.2017-02-08.11.55.46.bak0
ams-h2-persistence.trace.db
ams-h2-persistence.trace.db.2017-02-08.11.55.46.bak0

AMS Web Client Browser Support

The AMS web client is compatible with the following web browsers:

  • Google Chrome

  • Apple Safari

Other browsers may also work but are not officially supported.

Compatibility with StreamBase

The Artifact Management Server can be installed on a separate machine or on the machine hosting TIBCO StreamBase®.

Deploying decision table artifacts stored in an AMS repository to StreamBase Studio requires TIBCO StreamBase® release 7.6.6 or higher.

Deploying supported model file artifacts stored in an AMS repository to StreamBase Studio requires TIBCO StreamBase® release 7.7.1 or higher.