Installing MES
- Last UpdatedMay 01, 2023
- 7 minute read
Note the following 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.
-
It is recommended that you install all MES product and component prerequisite software before starting the installation. For more information, see MES Prerequisite Software.
To install MES products and components
-
Locate the installation folder on the MES installation media that has been loaded or copied to the local node.
-
Run the Setup.exe file in the root directory of the installation folder.
-
If a version of System Platform prior to System Platform 2023 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 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 11 for more information. Note that the License applications might be identified as AVEVA or Schneider Electric products.
-
-
Click OK to close the messages.
If the required release of .NET Framework is not installed, you are prompted to install it.
Click Yes to install the required release of .NET Framework. At the conclusion of the .NET Framework installation, you might be prompted to restart the system. If so, restart the system and then rerun the MES Setup tool to continue with the MES installation.
Otherwise, the Setup tool opens and the Welcome to MES Setup message appears.
-
Click Next.
The End User License Agreement (EULA) appears.
-
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.
-
To continue with the installation, select the I have read and accept the terms ... option, then click Agree.
If you are upgrading MES and any MES applications are running, you are prompted to close them.
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.

-
Select the roles whose products and components you want to install on the local node and click Next.
A list of the products and components that will be installed appears.

-
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 11.
-
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 7. Information about the selected component appears in the description box on the right. Go to step 9.

Note: To install the following components as part of the MES installation, you have to choose the Customize Installation option and then manually select the components: License Server and Manager components; MES Supervisor; BI Gateway components.
Note: To install the Quality Characteristic Detail report's SPC Chart control, the MES BI Gateway Reports component must be installed and configured on the same node as the BI Gateway Datastore and SQL Server Reporting Services (SSRS).
-
-
To change the install destination folder, click the Browse button and then navigate to and select the desired folder.
-
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 or later is required. You will be prompted to install the Application Server component of System Platform 2023 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:.

-
-
Click 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.
-
Click 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: . 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.

-
-
To start the Configurator, click 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: Activating 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 Activating the 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 Implementing 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. 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.
Recovering from the License Manager Installation Error
-
If the post-install Configurator application is open at the conclusion of the MES installation, close it.
-
Reboot the system.
-
Do one of the following:
-
In the Control Panel Programs and Features applet, select Manufacturing Execution System and click Change or Uninstall/Change on the toolbar.
-
Run the Setup.exe file in the MES installation root folder.
The Setup tool options appear.

-
-
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.
-
Select the three Licensing product options:
-
Licensing
-
AVEVA Enterprise License Server
-
AVEVA Enterprise License Manager

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