Before you can view your plant data, you must configure the Smart Instrumentation Web API server to authenticate your user credentials. This procedure explains how to configure the settings for:
-
Automatic configuration of Smart Instrumentation Web API in IIS
-
Registration with the Smart API Manager (SAM)
-
Monitoring
We recommend that you already have an SSL certificate installed on your machine.
-
In the path where you installed the Smart Instrumentation Web API server, navigate to the ConfigurationTool folder and right-click IntergraphConfigurationUtility.exe.
-
On the shortcut menu, click Run as administrator.
-
Do one of the following:
-
If a warning telling you that the Configuration Utility is missing required features,
and follow the instructions. -
No warning is displayed and the Configuration Utility opens, continue with step 4.
Before continuing to step 4, if you have not already installed an SSL certificate on your machine, close the Configuration Utility and install one now. Once installed reopen the Configuration Utility and proceed to step 4.
-
-
In the Configuration Utility, click the Smart API Manager Module icon.
The Smart API Manager Module - Configuration Utility window opens on the Welcome page.
-
Click Next.
-
On the Smart API Registration (Step 1) page, do the following:
-
In the API Manager Url box, type the Url for the Smart API Manager server you will use for authentication.
-
Choose one of the following user authentication options:
-
Use Windows Authentication, see Test your connection.
-
Use User Name / Password (User name = SAM user).
-
Whichever option you choose, your login credentials must first be registered on SAM.
-
To verify that your login credentials are valid, click Test.
You will see an appropriate message.
-
Choose one of the following registration options:
-
Register New Service
-
Update Existing Service
If this is the first time you are registering a service, only the Register New Service option is available.
-
-
For a new service, choose a prefix from the Service Prefix list, representing the software application and version.
-
If updating an existing service, choose the service you want to update from the Service Id list.
For a new service, the service Id is generated automatically at the end of the registration process.
-
Type a string in the Service Secret box or click Generate to generate a secret automatically.
The secret must consist of at least one uppercase character, one lowercase character, one number, one of the following special characters: &!@#$%*=. , and must be between 8 and 64 characters in length.
-
Click Next.
-
-
On the IIS Configuration (Step 2) page, in the Application Name type "api".
-
Beside the Application Identity field, do the following:
-
Click Change.
-
In the Application Pool Identity dialog box that opens, click Custom account.
-
Enter the user name in the Login field and type the password.
This must be an Admin user name and password.
-
Click Test to ensure that the login values are valid.
-
Click OK to close the Application Pool Identity dialog box.
The Application Identity user must have Domain Admin rights on the machine where IIS is installed. This is an essential requirement because this user must have permissions to:
-
write log messages under the installation folder.
-
save temp files, such as %temp%.
-
access network resources, such as .ini path and plant reference data.
-
-
Fill in the remaining information on the page.
-
Ensure that the Enable Https check box is selected and that you have a valid https certificate.
-
For the port settings, we recommend entering port number 80 for http and port number 443 for https.
-
-
Click Next.
-
On the Monitoring Configuration (Step 3) page, type Smart Instrumentation as the product name and the WebAPI version in the relevant fields.
-
Click Next.
-
On the Configuration Preview (Step 4) page, review your settings.
-
Click Finish to save your changes and begin the configuration.
A page opens showing the status of each activity and an overall progress bar.
-
On completion of the configuration, click Finish again.
All that is left for you to do is create Authorized Groups with in SAM
In the Advanced Settings of the Application Pool, the Disable Overlapped Recycle = True. This parameter is included in Intergraph Smart Configuration Utility from Smart Instrumentation Web API v 2.3.11.