This page explains how to install the Artifact Management Server (AMS) software on all supported platforms.
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.
Run the installer as supplied from your purchase. By default, AMS installs to:
C:\tibco\sb-cep\
(Windows)n.m
\ams
/opt/tibco/sb-cep/
(macOS, Linux)n.m
/ams/
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\
(Windows)n.m
\bin
/opt/tibco/sb-cep/
(macOS, Linux)n.m
/bin
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 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
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.
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.