Install Common Components

This topic describes how to install Proficy Authentication and Configuration Hub.

Before you begin

Ensure that you have administrative privileges to the machine on which you want to perform the installation.

Download the latest Operations Hub ISO installation media from Salesforce and mount the file.

About this task

Common components are Proficy Authentication and Configuration Hub. It is recommended to install common components before proceeding with any additional product installations.

Procedure

  1. In the mounted ISO, navigate to the Setup folder and execute the setup.exe file.
    The welcome screen appears.
  2. Select Common Components > START.
  3. Read and accept the license agreement to continue with the install.
    The Install Location screen appears and validates for port conflicts.
  4. Continue to the next screen with the default install location.

    If port conflicts are detected, you must fix them before proceeding to the next screen.

    If there are no conflicts, the Credentials screen for Configuration Hub and Proficy Authentication appears.
  5. Complete the following and proceed to the next screen.
    Note: Keep a record of the information you enter here, as you will need it later to log in to the applications. If you forget the credentials, you will have to reinstall common components to configure them again.
    1. Create these login credentials for Configuration Hub:
      CLIENT ID Enter a client id, which you can use to login to the Configuration Hub application.

      For example, confighubadmin

      CLIENT SECRET Enter a secret password for your Configuration Hub client id.
      CONFIRM CLIENT SECRET Enter the secret password again to confirm.
    2. Create these login credentials for Proficy Authentication:
      Use the same credentials for Configuration Hub and Proficy Authentication
      Note: It is recommended to install common components (Configuration Hub, Proficy Authentication) with the same client id/secret.
      If you select this check box, then you do not have to enter any additional credentials for Proficy Authentication. The login credentials you entered for Configuration Hub is automatically applied to Proficy Authentication.

      This is a useful feature if you do not want to remember two sets of login credentials.

      However, if you want to set unique login credentials for Proficy Authentication, then clear the check box and proceed to enter additional details.

      CLIENT ID Enter a client id, which you can use to login to the Proficy Authentication application.
      CLIENT SECRET Enter a secret password for your Proficy Authentication client id.
      CONFIRM CLIENT SECRET Enter the secret password again to confirm.
    The Start Install screen appears.
  6. Choose from the following install options and select START.
    Silent Install Selecting this option initiates an automated installation using pre-configured settings, without prompting for additional information.
    Interactive Install Selecting this option enables you to configure settings for Proficy Authentication.
  7. After the installation is complete, select CLOSE.
    A message appears asking whether you want to restart your computer, or install more products.
    Select from these options:
    Install More Products You are redirected to the installation welcome screen, from where you can choose to install more applications. For example, Operations Hub.
    Reboot Later Closes the installation setup screen without restarting your computer.
    Reboot Now Restarts your computer.
    Note: You must reboot for applications to function properly. You may choose to do this after installing all the applications, or at a later time.

    If you restart the machine after installing common components, you can set up authentication and test whether you are able to log into Configuration Hub. For more information, refer to Proficy Authentication documentation. You can also skip setting up authentication at this stage and do it later after installing Operations Hub.

Results

After installation, shortcut icons for the installed applications will appear on your desktop.

What to do next

Set up Proficy Authentication.