Install MES

Before starting the installation

• To install MES, you must have administrator privileges for the Windows operating system on the node on which the software is being installed.

• It is recommended that you install the required Microsoft .NET Framework release, version 4.8. To install Microsoft .NET Framework 4.8:

  1. Download the install package:

     • Visit https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48.

     • Download the latest version of the .NET Framework runtime install package.

  2. Unblock the downloaded EXE file:

     • Right-click on the downloaded file.

     • Select the Properties shortcut menu. The Properties dialogs opens.

       

     • In the General tab security settings, select the Unblock checkbox.

     • Select OK.

  3. Run the installer:

     • Double-click on the unblocked EXE file.

     • Follow the on-screen instructions to complete the installation.

• It is recommended that you install all MES product and component prerequisite software before starting the installation. For more information, see MES prerequisite software.

Install MES products and components

1. Locate the installation folder on the MES installation media that has been loaded or copied to the local node.

2. Run the Setup.exe file in the root directory of the installation folder.

   • If a version of System Platform prior to System Platform 2023 R2 SP1 is installed, a message appears that instructs you to uninstall the previous version before continuing with the MES installation. If this is the case, upgrade to System Platform 2023 R2 SP1 Patch 2 or later before installing MES. Note that you do not have to uninstall the existing version of System Platform; you can perform an upgrade.

   • If previous releases of MES and its related products are already installed on the node, a message appears that identifies the version and that the product will be updated.

     

     Note: If a version of the License Server and License Manager prior to 3.5 is listed to be updated, it might not install properly. Refer to step 13 for more information. Note that the License applications might be identified as AVEVA or Schneider Electric products.

3. Select OK to close the messages.

   If the required version of .NET Framework is not installed, you will be prompted to install it and the MES installation will exit. Install .NET framework, restarting the system if required. After successfully installing .NET Framework, rerun the MES setup file to continue installing MES.

   If the required version of .NET Framework is installed, the Setup tool opens and the Welcome to MES Setup message appears.

4. Select Next.

   The End User License Agreement (EULA) appears.

5. Use the options to read the general EULA content and the specific schedules for each of the software components available in the installation software.

   You can use the controls above the license agreement box to print the agreement or adjust how it is displayed.

6. To continue with the installation, select I have read and accept the terms ... , then select Agree.

7. If MES Cloud integration is installed, select Uninstall to remove the product.

   Once the uninstall is completed, select Next.

8. If you are upgrading MES and any MES applications are running, you are prompted to close them.

   Once the applications are closed, select Next.

   The roles by which the MES components are grouped appears. Information about the highlighted role appears in the description box on the right. For more information about these roles and which products and components are installed with them, refer to MES role-based installation.

   

   Note: If you are installing MES 2023 R2 on a system with Platform Common Services (PCS) (version 8.1.2), the MES installation will behave as though the MES install is an upgrade and not a new installation and the Select Roles dialog will not be displayed. Proceed to step 10 to select the features and components to install. For more information on what components are installed for each role, see MES role-based installation.

9. Select the roles whose products and components you want to install on the local node and then select Next.

   A list of the products and components that will be installed appears.

   

   Note: When upgrading MES from a prior version installed in a custom destination folder, the default destination folder will show in the dialog. However, the product will install into the previously used custom folder.

10. Do one of the following, depending on whether you want to customize which products and components will be installed or change the destination install folder:

    • To install the default sets of products and components for the roles you selected and use the default install destination folder (C:\Program Files (x86)), leave the Customize Installation check box cleared and click Next.

      A list of the prerequisite software that must be installed on the node prior to performing the MES installation appears. Go to step 12.

    • To customize the sets of products and components for the roles you selected, or to change the install destination folder, select the Customize Installation check box and click Next.

      The list of products and components appears. The products and components are selected based on the roles selected in step 8. Information about the selected component appears in the description box on the right.

      

    Note: To install the License Server and Manager component as part of the MES installation, you have to choose the Customize Installation option and then manually select the component to include it in the installation.

11. To change the install destination folder, click the Browse button and then navigate to and select the desired folder.

12. To change the products or components to be installed, select the check boxes of only those products or components that you want to install and click Next.

    Note the following:

    • If any prerequisite software cannot be installed by the MES installation, it will be identified in a message. Install this software before proceeding.

    • If you are using MES with System Platform, System Platform 2023 R2 SP1 Patch 2 or later is required. You will be prompted to install the Application Server component of System Platform 2023 R2 SP1 Patch 2 or later if you selected the Entity Model Builder.

      MES is ready to be installed. A list of the products and components that will be installed appears. Also, any prerequisite software that the MES installation can install is listed under Prerequisites:.

      

13. Select Install.

    If any applications that might conflict with the installation are running, a list of them appears.

    You have the following options:

    • Close the conflicting applications and then click the Try Again button to see if there are still any conflicts.

    • Select Next to continue with the installation.

      If any conflicting applications are still running when you click Next, the Configurator tool will tell you if you need to restart the system when you have finished the MES configuration.

    Once the installation begins, the progress status appears.

    Note: If the installation is updating a version of License Server and License Manager prior to 3.5, the following error message might appear, indicating that it did not install properly: Service 'License Server Agent Service' (License Server Agent Service) could not be deleted. Verify that you have sufficient privileges to remove system services. To resolve this error, see the instructions below in "Recovering from the License Manager Installation Error."

    When the installation is finished, you are prompted to configure products and components that require configuration before they can be used.

    

14. To start the Configurator, select Configure.

    The post-install Configurator application opens.

    

    Initially, it is possible that not all of the components on which MES is dependent will appear in the Configurator or will be available to be configured. For this reason, close the Configurator. The necessary components will appear properly the next time you open the Configurator. However, before using the Configurator to configure the MES components, see the instructions below in "Next Steps."

Next Steps:

Important: If you upgraded MES, you must remove the AVEVA Single Sign-On Service.ASBServiceRepository feature of the AVEVA Platform Common Services (PCS) product after making sure that other products do not need this feature. For more information, see Requirements for upgrading MES versions.

Activate the MES Product Licenses and Configuring AVEVA Single Sign-on

Before configuring the MES components in the post-install Configurator:

• The MES product licenses must be activated so that the MES middleware can be started. See Activate MES product licenses.

• If the Single Sign-on Service was installed as part of the MES installation, its component in the Configurator, System Management Server, has to be configured. See Implement secure communication with System Management Server.

MES Service Monitor

If the MES Middleware component was installed on the node, the MES Service Monitor is installed and its icon (shown below) is added to the system tray.

The Service Monitor allows users to start, stop, and restart the MES Middleware Host and Curator Host services. For more information, see MES Service Monitor.

MES Shortcuts in the Startup Menu

On the Start screen, MES application shortcuts will appear in the Manufacturing Execution System group. MES user documentation shortcuts will appear in the AVEVA Documentation group. If you do not see these groups in the Start screen, they should appear after restarting the node.

Recover from a License Manager installation error

15. If the post-install Configurator application is open at the conclusion of the MES installation, close it.

16. Reboot the system.

17. Do one of the following:

    • Run the Setup.exe file in the MES installation root folder.

    • In the Control Panel Programs and Features dialog, select Manufacturing Execution System and click Change or Uninstall/Change on the toolbar.

    The Setup tool options appear.

    

18. Select Modify, and then click Next.

    The list of MES products and components appears. The check boxes of products and components that are currently installed are selected by default.

19. Select the three Licensing product options:

    • AVEVA Enterprise License Server: Installs the secure license server.

    • AVEVA Enterprise License Manager: Installs the license manager on the node.

    • AVEVA Enterprise License Server Legacy Support: Enables support for legacy versions of Licensing on client nodes. If this checkbox is not selected, all client nodes that connect to this License Server would need to be upgraded to 4.2.

    

20. Click Next.

21. When you are prompted that the Licensing features are currently installed and will be upgraded, click OK to proceed with their installation.