Step 1: Choose your configuration option - Intergraph Smart API Manager - Installation & Upgrade - Intergraph

Smart API Manager Installation and Configuration

PPMProduct
Intergraph Smart API Manager
PPMCategory_custom
Installation & Upgrade

If the Smart API Manager Configuration Utility is not already running, open it from Start > Intergraph Smart API Manager > Configuration Utility.

If the Configuration Utility does not appear on the Start menu, go to:
[Smart API Manager Install Folder]\Tools\Intergraph.WebApi.Management.ConfigurationTool.exe

On the Welcome to the Intergraph Smart API Manager Configuration Utility! page, select the configuration task you need to complete.

These tasks center around domains—projects or other logical separations of work—you define in Smart API Manager to organize and manage data. Smart API Manager uses a multi-tenant database architecture, meaning that a single database can contain data for multiple instances of the application. The domain represents a single tenant in the database.

An instance of Smart API Manager is limited to viewing and editing data only for its domain.

The first time you configure Smart API Manager, the welcome page offers you the following options.

If you run the configuration utility again, the re-configure options let you correct any issues with the current configuration.

Option

Description

Choose If

Create new domain

Add a new domain to a new or existing database and configure Smart API Manager to manage it.

You are installing a new instance of Smart API Manager and want a new domain for registering Smart APIs, Clients, etc.

Join existing domain (existing database)

Connects this instance of Smart API Manager to an existing domain.

You are installing a new instance of Smart API Manager that duplicates an existing instance.

For example, the new instance will run in a web farm or behind a load balancer.

Join existing domain (via configuration file)

Configures all settings for Smart API Manager from a configuration file saved previously.

Performing an upgrade to a new version or re-installing.

Re-configure (interactive) or (via a configuration file)

Reconfigure Smart API Manager to fix configuration issues.

You need to modify the existing instance of Smart API Manager on this server.

For example, the existing instance was configured incorrectly, or a password changed after configuration.

You must step through all the pages of the wizard, unless you are using a saved configuration file: Join existing domain (via configuration file).

Follow the steps below if you are using a configuration file. Otherwise, click Next and continue with Step 2: Web application configuration.

  1. If <last-known-configuration> is displayed in the Configuration File: field, skip to step 4.

  2. Enter the filename (or browse) for the configuration file you previously saved.

  3. Enter the password you specified when saving the configuration file.

  4. Click Next.

    The configuration utility moves to the final screen (Review Configuration).

  5. Click Finish to configure Smart API Manager based on settings from the file.

    You can also use a configuration file to configure Smart API Manager from the command line. See Silent configuration for details.