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. 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
    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. 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 UAALdapConfigPort=7010 UAASecurityAppPort=7011 AdminClientId=admin AdminClientSecret=abc 
    ConfigHubPort=5000 ContainerPort=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 UAALdapConfigPort=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 UAALdapConfigPort=7010 UAASecurityAppPort=7011 AdminClientId=admin 
    AdminClientSecret=abc UseExternalUaa=1 ActiveUaaBaseUrl=https://<etrenaluaamachinehostname>:443 
    ConfigHubPort=5000 ContainerPort=4890 ConfigHubInstallFolder=C:\Program Files (x86)\GE\ConfigurationHub 
    ConfigHubClientID=admin ConfigHubClientSecret=xyz 
    DataPath=C:\ProgramData\HistorianWebBasedClientsLogs