Upgrading the Web Server - Intergraph Smart 3D Web API - Installation & Upgrade - Hexagon PPM

Intergraph Smart 3D and Smart 3D Admin Web API Installation and Configuration

Language
English
Product
Intergraph Smart 3D Web API
Subproduct
Smart 3D Web APIs
Search by Category
Installation & Upgrade
Smart 3D Version
13
  1. Save a copy of the web configuration file:

    • For the Smart 3D Web API - C:\Program Files\Smart3D\WebApi\WebServer\Web.config

    • For the Smart 3D Admin Web API - C:\Program Files\Smart3D\WebApi\AdminWebServer\appsettings.json

      Even though the export operation saves a copy of this file, a manual save is very useful for support if anything goes wrong during the upgrade operation.

      This operation can be done only on the computer hosting your web server.

  2. Click Start > Intergraph Smart 3D.

  3. Choose the tool for the Web API you're configuring, either Web API Configuration Tool or Admin Web API Configuration Tool.

    The Configuration Utility opens to the Welcome page, which looks something like this.

  4. Verify that all of the check boxes on the Welcome page are cleared.

  5. Click Next.

  6. Click Export.

  7. Specify a file name.

  8. If you plan to upgrade without any changes in configuration, you can select the Use Encryption option. If Use Encryption is checked, specify a password for the file encryption.

    -OR-

    Clear the Use Encryption option if you need to change the configuration or security is not a problem. You can also decrypt the configuration file later using configuration tool.

  9. Click Export to create the file.

  10. Close the configuration tool.

  11. Uninstall the Web API from your computer.

  12. Uninstall Intergraph Smart 3D if needed.

  13. Install the updated version of Intergraph Smart 3D if needed.

  14. Install the new version of the Web API.

  15. Open the configuration tool again. Click Start > Intergraph Smart 3D, then choose the tool for the Web API you're configuring, either Web API Configuration Tool or Admin Web API Configuration Tool.

  16. Click Import on Welcome screen.

  17. Select the configuration file that was generated by your export operation. If you exported with encryption, type the password.

  18. Select Regenerate metadata after import check box if you choose to regenerate metadata for all web API enabled plants after the import. You must regenerate metadata when you move to a newer version of Smart 3D or when the catalog data for an existing plant changes.

  19. Click Import.

    You are prompted to migrate the database if it is out-of-date. Click Migrate to upgrade the database, or click Cancel to cancel the import. If you are using Oracle and the configuration file does not have the full datasource string, you are prompted to enter the details of Oracle server. Enter host name, service name, protocol, port, and then click Import.

  20. Verify the data you are importing, and click Finish.

  21. The data displayed is from the configuration file. If you find problems, click Back and edit the data. Alternatively, exit the configuration tool, modify the configuration file, and then restart the import procedure.