System Platform prerequisites

Operating system and SQL Server

A 64-bit Windows operating system is required for installing and running System Platform 2023 R2 SP1 and its component products. Some System Platform 2023 R2 SP1 components, such as the Application Server Galaxy Repository and the AVEVA Historian also require a 64-bit version of Microsoft SQL Server.

Check the AVEVA GCS Technology Matrix website for more information about supported Windows and SQL Server versions for the System Platform 2023 R2 SP1 component products you are installing.

Note: If you are using silent (command line) installation, all prerequisites, including the .NET Framework and SQL Server (if required for the components being installed), must be installed before launching the System Platform setup program. See Use silent installation for more information. SQL Server is required for the Galaxy Repository, Historian, and System Monitor.

.NET Framework

• System Platform requires Microsoft .NET® Framework 4.8, plus some additional .NET 8.0 run-time components. Prior to any other installation task, System Platform checks if all the required .NET components are installed. If not, you are prompted to allow its installation. A system restart may be required when .NET installation is complete. If the System Platform installation program does not automatically resume after the system restart, you will need to restart it manually. The .NET run-time components required for System Platform are:

  • .NET Runtime (x64)

  • ASP.Net Core Runtime - windows hosting bundle (x64)

  • .NET Desktop Runtime (x64)

• If an error occurs during setup that stops the .NET Framework 4.8 installation, you can try manually installing from the System Platform installation DVD:

  \InstallFiles\Redist\DOTNET\4.8\ndp48-x86-x64-allos-enu.exe

• In some cases, a higher version of the run-time .NET components may already be installed on your computer than those included on the System Platform installation DVD. Normally, this does not stop installation. However, if your computer has some, but not all, of the required run-time modules that are at a higher version (.NET Runtime, ASP .NET Core Runtime, and .NET Desktop Runtime), an error message is shown and you are prompted to download the latest version of .NET. This is because all of the modules must be at the same version.

To check installed .NET versions:

Open a command prompt and enter

cmd /k reg query "HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP" /s /v Version

The installed versions of .NET are listed.

Prerequisites automatically installed by System Platform

The System Platform installation program analyzes the software installed on your computer and lists any software that is required but not currently installed, and any installed software that is incompatible. The following prerequisites are installed by the System Platform installation program, if not already present on the system:

• Microsoft .NET® Framework 4.8

• SQL Server: SQL Server is required for products or roles that you select for installation that include GR node, Historian Server or System Monitor. If a supported version of SQL Server is not found, you are given the option to install SQL Server 2022 Express Core (with Advanced Tools) as part of System Platform installation. However, SQL Server Express supports only small installations with less than 25,000 I/O per node. See the Technology Matrix on the AVEVA Global Customer Support website for the current list of supported SQL Server versions.

  

  If you do not want to install SQL Server, and you have products or role selections that include the GR node by default, you can select the Customize Installation checkbox and deselect Galaxy Repository. However, this will limit any database-related product functionality, such as the AVEVA System Platform IDE, that uses the Galaxy Repository.

  See SQL Server requirements for more information about the limitations of using SQL Server Express instead of a standard or enterprise edition.

  The following tables summarize which System Platform products and roles require SQL Server.

  Product Selections	SQL Required
  Application Server	Yes
  Application Server and AVEVA OMI Runtime	No
  Application Server Development	No
  Application Server Galaxy Repository	Yes
  InTouch HMI	Yes (see note)
  InTouch Development and Runtime	Yes (see note)
  InTouch Runtime Only	No
  InTouch Access Anywhere Server	No
  InTouch Access Anywhere Secure Gateway	No
  InTouch Access Anywhere Authentication Server	No
  Historian	Yes
  Historian Client	No
  Licensing	No
  Role Selections	SQL Required
  Runtime Client	No
  Remote System Platform Development Client	No
  System Platform Development Server Without Galaxy Repository (custom installation)	Yes No
  Historian Server Node	Yes
  Historian Client Node	No
  InTouch Access Anywhere Secure Gateway Node	No
  All-In-One-Node Without Galaxy Repository and Historian Server (custom installation)	Yes No

  Note: System Platform will allow you to install an InTouch development system without a Galaxy Repository. However, InTouch Modern Applications will not work without the Galaxy Repository.

While installing System Platform, if the logged-on user (the installer) is not a SQL Server administrator and SQL Server was installed prior to System Platform, the SQL Access Configurator opens (the dialog box is labeled aaConfig SQL) and requests SQL Server administrator credentials. Enter valid SQL Server administrator credentials when requested. For more information about setting user privileges with the SQL Access Configurator, see Set the SQL Server security mode. For more information about SQL Server installation, see SQL Server requirements for System Platform components.

The System Platform installation program installs both system-specific and product-specific prerequisites. It also checks for incompatible software that will prevent installation from proceeding, (for example, if InTouch Access Anywhere was previously installed). You do not have to exit from the System Platform installation program to install the prerequisite software, with the exception of standard or enterprise versions of SQL Server. You will need to exit and perform any uninstall operations that are indicated before continuing with installation.

For information on prerequisites and software requirements for the specific products, see the System Platform Readme, the Readme files of the specific products located in your documentation directory, or the specific product information chapter in this installation guide.