After installation, the Configuration Utility should run automatically.
If it does not, or if you need to run it again later, you can find it here:
-
Start > Intergraph Smart API Manager > Configuration Utility
-
<installation location>\Hexagon.Sam.ConfigurationTool.exe
If the tool does not start and you see an error message like An error occurred: The specified value is not a valid password, restart the tool. To learn more about this known issue, see Configuration Tool will not open because of invalid password.
-
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.
Re-configure (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 or to join an existing domain.
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 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.
You must step through all the pages of the wizard, unless you are using a saved configuration
file: Re-configure (via configuration file).
-
Continue with the steps below based on whether you are using a configuration file.
If you are not using a configuration file
-
Click Next and continue with Step 2: Web application configuration.
If you are using a configuration file
-
If the Configuration File field is blank, provide the name and password for the saved configuration file.
-
Click Next.
The configuration utility moves to the final screen (Review Configuration).
-
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.