Install Web-Based Clients at a Command Prompt

About this task

This topic describes how to install Web-based Clients at a command prompt. You can also install Web-based Clients using an installer.

Procedure

  1. If you want to install Web-based Clients with the default values, run the following command: 
    install.exe /quiet AdminClientSecret=<password> ConfigHubClientSecret=<password>
  2. If you want to modify the default values, run the following command: 
    install.exe /quiet AdminClientSecret=<password> ConfigHubClientSecret=<password> <parameter>=<value>
    The following table describes the installation parameters.
    Parameter Description Default Value
    PublicPort Port for https protocol communication used by Web-based Clients. Ensure that the value for this parameter matches the one you specify while installing the Historian server. In addition:
    • If you will install Operations Hub later on the same machine, the value that you provide for this parameter is populated while installing Operations Hub.
    • If you have already installed Operations Hub on the same machine, provide the same value that you provided while installing Operations Hub.
    		443
    UAAHttpPort Port for http protocol communication used by the UAA service. 9480
    UAADatabasePort Port for the UAA database. 9432
    HistorianHttpPort Port for the http protocol communication used by Web-based Clients. 8070
    HistorianDatabasePort Port for the PostgreSQL Historian database. 8432
    UAAIdpConfigPort Port for the Configuration Hub identity provider service. 7010
    UAASecurityAppPort Port for the UAA Configuration tool. 7011
    EmbeddedWebServerAlternativeNames The fully qualified domain names to access Historian web applications remotely. You can use it to access the Web Admin console using alias names. Enter the values separated by commas.
    For example, to access the Web Admin console using any of the following URLs, enter Test.abc.ge.com,localhost,127.0.0.1,aliasName
    Important:
    • Do not enter a space between the values.
    • If you have already installed Operations Hub on the same machine, enter the same value that you have provided while installing Operations Hub.
    • If you will install Operations Hub later on the same machine, the value that you provide for this parameter is used while installing Operations Hub.
    • You must add the IP address and alias name in the hosts file located at C:\Windows\System32\drivers\etc. The IP address that you add must be a static or fixed IP address.

      Format: <IP address> <alias name>

      Example: 1.2.3.4 myservername

    • FQDN is not supported for Configuration Hub.
    AdminClientId The client ID to connect to the UAA service.
    AdminClientSecret The password to connect to the UAA service. The password must satisfy the following conditions:
    • Must not contain only numbers.
    • Must not begin or end with a special character.
    • Must not contain curly braces.
    If the password does not satisfy these conditions, the installation may be successful, but Web-based Clients will not work.
    Note: The format of username for Historian Web-based Clients is <host name>.admin, where <host name> is the machine on which Web-based Clients are installed. And, the default client ID is admin. Both the host name and client ID are case-sensitive.

    If, however, the UAA server hostname is long, resulting in a username longer than 20 characters, Windows does not allow you to create the user. In that case, you can create a UAA user, and then create the corresponding Windows user, using the uaa_config_tool utility.

    		 Not applicable
    UseExternalUaa Identifies whether you want to use an external UAA service (that is, a UAA instance already installed by an external application such as Operations Hub). If you want to use an external UAA, enter 1. 0
    ActiveUaaBaseUrl The base URL to connect to an external UAA. A value is required only if you want to connect to an external UAA service. Enter a value in the following format: https://<UAA server machine name>:<public https port number>. By default, the port number is 443.
    ConfigHubPort The web server (NGINX) port that you want to use for Configuration Hub. 5000
    ConfigHubContainerPort The port for the Configuration Hub container. 4890
    ConfigHubInstallFolder The installation folder for Configuration Hub.
    Important: You can install Configuration Hub only in the C drive. If, however, you want to install it in a different drive:
    1. Create Configuration Hub server certificates.
    2. Start the ConfigHubNGINXService service.
    3. Using the Web Based Clients Configuration tool, provide the UAA and Configuration Hub details, test the connection, and select Resgister to re-register the Historian plugin with Configuration Hub.
    		 C:\Program Files (x86)\GE\ConfigurationHub
    UseExternalConfigHub Identifies whether you want to use Configuration Hub installed with iFIX or on a remote machine. If you want to use an external Configuration Hub, enter 1. 0
    ExternalConfigHubMachineName Enter the server name or the FQDN of the existing Configuration Hub server, as displayed in the address bar of the browser when you access Configuration Hub from the machine where Configuration Hub is installed.
    ConfigHubClientId The username to connect to Configuration Hub. The value that you enter can contain:
    • All English alphanumeric characters (ABCDEFGHIJKLMNOPQRSTUVXYZ abcdefghijklmnopqrstuvwxyz_0123456789)
    • The following special characters: ><:~!@#$%^&*?|
    		 admin
    ConfigHubClientSecret The password to connect to Configuration Hub. The value that you enter can contain:
    • Must contain at least eight characters.
    • All English alphanumeric characters (ABCDEFGHIJKLMNOPQRSTUVXYZ abcdefghijklmnopqrstuvwxyz_0123456789)
    • The following special characters: ><:~!@#$%^&*?|
    DataPath The path to the log files. C:\ProgramData\HistorianWebBasedClientsLogs
    DestinationHistorian The name of the destination Historian server.
    Note: If you want to connect to a remote Historian server, you must disable the Enforce Strict Client Authentication and Enforce Strict Collector Authentication options using Historian Administrator in the remote server.
    To install Web-based Clients with local UAA and local Configuration Hub, run the following command: 
    Install.exe /quiet PublicPort=443 UAAHttpPort=9480 UAADatabasePort=9432 HistorianHttpPort=8070 
HistorianDatabasePort=8432 UAAIdpConfigPort=7010 UAASecurityAppPort=7011 AdminClientId=admin AdminClientSecret=abc 
ConfigHubPort=5000 ConfigHubContainerPort=4890 ConfigHubInstallFolder="C:\Program Files (x86)\GE\ConfigurationHub" 
ConfigHubClientId=admin ConfigHubClientSecret=xyz 
DataPath="C:\ProgramData\HistorianWebBasedClientsLogs"
    To install Web-based Clients with local UAA and an external Configuration Hub, run the following command: 
    Install.exe /quiet PublicPort=443 UAAHttpPort=9480 UAADatabasePort=9432 HistorianHttpPort=8070 
HistorianDatabasePort=8432 UAAIdpConfigPort=7010 UAASecurityAppPort=7011 AdminClientId=admin AdminClientSecret=abc 
UseExternalConfigHub=1 ExternalConfigHubMachineName=abc123 ConfigHubClientId=admin
ConfigHubClientSecret=xyz DataPath="C:\ProgramData\HistorianWebBasedClientsLogs"
    To install Web-based Clients with external UAA and a local Configuration Hub, run the following command: 
    Install.exe /quiet PublicPort=443 UAAHttpPort=9480 UAADatabasePort=9432 HistorianHttpPort=8070 
HistorianDatabasePort=8432 UAAIdpConfigPort=7010 UAASecurityAppPort=7011 AdminClientId=admin 
AdminClientSecret=abc UseExternalUaa=1 ActiveUaaBaseUrl=https://<extrenal UAA machine hostname>:443 
ConfigHubPort=5000 ConfigHubContainerPort=4890 ConfigHubInstallFolder="C:\Program Files (x86)\GE\ConfigurationHub" 
ConfigHubClientId=admin ConfigHubClientSecret=xyz 
DataPath="C:\ProgramData\HistorianWebBasedClientsLogs"