Install Operations Hub

Before you begin

  • Ensure that the machine on which you want to install Operations Hub meets the system requirements.
  • Use a machine that does not host any applications that are bundled with Operations Hub.
  • Run a Windows update (including security updates).
  • Use a host name that contains up to 24 characters and any of the following characters:
    • Alphabetic characters
    • Numeric characters
    • Minus
    • Period
  • Ensure that you have administrative privileges to the machine on which you want to install Operations Hub.
  • Ensure that you have port 443 available.

About this task

This topic describes how to perform step-by-step installation of Operations Hub. You can also install Operations Hub automatically.
Note: This topic describes how to install Operations Hub stand-alone (by downloading the installer from Salesforce). If, however, you want to use only the Historian analysis application in Operations Hub, you can choose to install just the Operations Hub add-on for Historian. If you do so, you will not be able to create, modify, or delete any applications or components of applications in Operations Hub.

Procedure

  1. Run the Operations Hub installation DVD, and then select Install GE Operations Hub 1.5.
    The Welcome to GE Operations Hub page appears.

  2. Select Next.
    The Read and accept the license agreement to continue page appears.

  3. Select the Accept check box, and then select Next.
    The TCP port check page appears, specifying whether the ports chosen for Operations Hub are available.

  4. If you want to review or change the ports that will be used by Operations Hub, select the Show Details check box.
    The TCP port assignments page appears, providing a list of ports that will be used by the various components in Operations Hub.

  5. If needed, modify the port numbers, and then select Next.
    The Host Names page appears. By default, the All Host Names box contains a value, and the Primary Host Name box is disabled and populated with the first value in the All Host Names box.

  6. In the All Host Names box, enter the any of the following details of the machine on which you want to install Operations Hub:
    • Fully qualified domain name
    • host name
    • IP address
    Note:
    • If you want to provide more than one of the aforementioned values, use a comma to separate them.
    • If you want to use Operations Hub on an iPad, the first value in this box must be the IP address.
    The Primary Host Name box is updated with the first value in the All Host Names box.
  7. Select Next.
    The User Authentication and Authorization Service page appears.

  8. If you want to use the User Authentication and Authorization (UAA) service that is integrated with Operations Hub, enter a password in the Admin Client Secret and Re-enter Secret boxes. Otherwise, skip to the next step.
  9. If you want to use an external UAA service, select the Use External UAA check box, and then provide values as specified in the following table.
    BoxDescription
    UAA Base URLEnter the URL of the UAA service.
    Admin Client IdEnter the ID of the administrator account of the UAA client.
    Admin Client SecretEnter the password of the administrator account.
    UAA certificate fileEnter the path to the certificate file used by the UAA service.
    Note: The certificate file must be a .pem file and must be installed in the Trusted Root Certificate Authorities certificate store.
    If the UAA URL in the Operations Hub install does NOT match the Historian 8 UAA URL then you will receive an "Issue not trusted" error when attempting to import a model. Examples of UAA URLs used during the Operations Hub install may be a URL with a Fully Qualified Domain Name (FQDN) or one that includes a Port Number such as: https://z840his2019:443/uaa. If there is a mismatch between Operations Hub and Historian, you will need to make a change in Windows Registry to resolve the issue. This workaround is outlined in the steps below. As always, use extreme caution when making any changes to the Registry, and backup your system before making any changes.
    Step Description
    1 In Windows, launch regedit as an Administrator.
    2

    Navigate to the following key: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\WebhmiTomcat\Parameters\Java\Options
    3

    Locate the entry for Dwebhmi.services.auth.fastTokenServices.trustedIssuers. For example: Dwebhmi.services.auth.fastTokenServices.trustedIssuers=https://Z840HIS2019:443/uaa/oauth/token
    4

    Determine the issuer_uri of the HOST UAA machine, in this case the Historian 8.0 machine. This can be done by finding the uaa.yml file and finding the issuer_uri entry or obtaining the access token using the browser.
    5

    Add this value to the line containing Dwebhmi.services.auth.fastTokenServices.trustedIssuers. New entries can be added with a comma separator. For example: Dwebhmi.services.auth.fastTokenServices.trustedIssuers=https://Z840HIS2019:443/uaa/oauth/token,https://z840his2019/uaa/oauth/token
    6

    Restart the Master Control Service.
  10. Select Next.
    The Create Tenant Admin Account page appears.

  11. Provide values as specified in the following table, and then select Next.
    BoxDescription
    User IdEnter the user ID of the administrator account for Operations Hub. When you provide the tenant user ID, the following conditions apply:
    • If you are installing Operations Hub for the first time, do not provide StudioAdmin as the tenant user ID because it is used by Operations Hub.
    • If you want to use a shared UAA to work with Operations Hub, do not provide the user ID of an existing user of the UAA instance. If you do so, the installation fails.
    • If you are reinstalling Operations Hub, do not provide the tenant user ID that you previously provided. This is because even if you purged the data while uninstalling Operations Hub, the user account, along with the groups and privileges assigned to the user, still exists in the UAA instance.
    PasswordEnter a password for the administrator account.
    Re-enter PasswordRe-enter the password for the administrator account.
    The Customize Log Files and Postgres Data Locations page appears.

  12. Provide values as specified in the following table, and then select Next.
    BoxDescription
    Log Files Base FolderEnter the path to the log files generated by Operations Hub. By default, the value in this box is %ProgramData%\OphubLogs.
    Base Folder for DatabasesEnter the path to the base folder for the UAA, Operations Hub, and WebHMI databases. If you want to use the default folder, leave this box blank. Otherwise, enter the path to the folder that you want to use.
    Customize database locations individually for subsystemsSelect this check box if you want to use different folders for each database.
    UAA Database FolderThis box appears only if you have selected the Customize database locations individually for subsystems check box. Enter the database folder that you want to use for UAA. If you want to use the default folder, leave this box blank.
    IQP Database FolderThis box appears only if you have selected the Customize database locations individually for subsystems check box. Enter the database folder that you want to use for Operations Hub. If you want to use the default folder, leave this box blank.
    WebHMI Database FolderThis box appears only if you have selected the Customize database locations individually for subsystems check box. Enter the database folder that you want to use for WebHMI. If you want to use the default folder, leave this box blank.
    The You are ready to install page appears.

  13. Select Install.
    After the installation is complete, a message appears, specifying that the installation is complete. A link to the log folder appears. All the services used by Operations Hub are started.

What to do next

Install the Certificate Authority (CA) certificates on each client that you will use to access Operations Hub , and then log in to Operations Hub.