Upgrade Web HMI

When installing Web HMI 2.2 SP2 on a machine that previously had an earlier version, the upgrade process automatically backs up existing PostgreSQL databases as well as the model and server data.

The Web HMI upgrade paths are:

  • 2.0>2.2 SP2
  • 2.1>2.2 SP2
  • 2.2>2.2 SP2
Important:
  • To retain your model and configuration data, install Web HMI to the same location as the earlier version of Web HMI.
  • If you modified any Web HMI components, such as mashups, and added menu links in Application Assembler (ThingWorx), these changes are overwritten during this upgrade. Any mashups that you added are not removed. Before upgrading, go to Back Up Customized Components.
  • Uninstall the earlier version of Web HMI.
  • Run Windows Update (including security updates) before upgrading Web HMI.
  • If using iFIX, do the following:
    • Start the iFIX System Configuration Utility (SCU).
    • Navigate to Configuration > Tasks to delete the tasks for Scadastat.exe, AlarmGateway.exe, and DataDistributor.exe, and then select OK.
    • Close the SCU and select Yes to save the changes.
    • If installing Web HMI on the same machine as iFIX, you must stop iFIX before installing Web HMI.
  • Install all required software that is not already installed.
  • Have your existing administrator passwords for Web HMI and PostgreSQL ready. You are asked for these during the upgrade.
  • If a VM screen appears frozen when installing Web HMI, click on it to view information about the installation. This typically occurs after 15 minutes of inactivity.
  1. Start the installation program.
    If the installation fails on Microsoft Windows 7 or Windows 10, right-click the installation program and select Run as Administrator.
  2. In the Welcome screen, select Next.
  3. In the License Agreement screen, select Accept, and then Next.
  4. In the Configure Install Path screen, select Browse to choose the installation directory path or accept the default path.
    If you are not using the default installation path, make sure the path does not exceed 32 characters.
  5. In the Configure Host and Port screen, define which URLs (host names or IP addresses) can be used by a browser to connect to Web HMI. For more information, see Connections based on URLs.
    For external Web HMI clients to connect to Web HMI, enable port number 443 or the port that you are using for the Web HMI installation in the incoming firewall rules.
  6. Select Next.
  7. In the Configure PostgreSQL screen, enter your existing Web HMI administrator password for PostgreSQL.
  8. In the Configure GE Administrator User screen, select a user name and a password (10-character minimum) for your GE Administrator user.
    A user name can contain alphanumeric characters (at least one), hyphens, periods, underscores, email addresses, and spaces. It cannot start or end with a space. You cannot create the following user names: Administrator, GEAdmin, GEUser, gePeMsUser, System, and SuperUser.
    Record this user name and password, as you will use this user account to log in to Web HMI for the first time after the upgrade.
  9. In the Ready to Install screen, select Install.
    If a Progres screen appears, select Next and wait for the final screen to appear.

    The program installs Web HMI and its associated software.

  10. Select Exit when the installation completes.
Install the CA certificate, as explained in Install CA Certificates.