Install UNIQO

Premise

UNIQO requires the installation of various software on the development PC and on the targets on which the Q Application will be run. In particular, on target systems the software to be installed varies depending on the operating system. On ASEM HMI target systems, all required software is pre-installed.

To design logics in C# code in projects (see NetLogic and Manage NetLogics in Q Studio), a code editor must be available. Q Studio supports Microsoft Visual Studio 2017 and 2019 and Microsoft Visual Studio Code. In the absence of these, you can use another code editor of your choice but the development assistance features such as IntelliSense, refactoring and automatic completion will not be available. To install Visual Studio or Visual Studio Code, refer to the Microsoft website.

Minimum system requirements for Q Studio

Below are the minimum requirements of the PC on which Q Studio is installed:

  • Microsoft Windows 10 (x64) or Windows 7 (x64)

  • Microsoft .NET Framework 4.7.2

  • Microsoft .NET Core SDK 2.2

Note

refer to Microsoft’s website to download and install the software.

Minimum system requirements for targets

Below are the minimum requirements for targets on which a Q Application is run:

  • Operating system:

    • Microsoft Windows 10 (x64) or Windows 7 (x64)

    • Linux (ASEM HMI or Debian 10 systems)

      Note

      the runtime components are pre-installed on ASEM PCs.

  • Windows systems: Microsoft .NET Framework 4.7.2

    Note

    refer to Microsoft’s website to download and install the software.

  • For Debian 10 systems to run Q Applications that integrate the UNIQO display engine:

    • X11 windows manager

    • Xinerama extension for X11

Install Q Studio on the development PC

  1. Access the'area Download on the UNIQO product site (https://uniqo.asem.it) and download Q Studio.

  2. Double-click the downloaded file and follow the wizard.

Install the software on a Windows target

  1. Access the'area Download on the UNIQO product site (https://uniqo.asem.it) and download the most recent stable version of UNIQO Runtime Tools.

    Note

    the package contains both Update Server and License Manager.

  2. On the target, double-click the downloaded file and follow the wizard.

Install the software on a Debian 10 target

  1. Access the'area Download on the UNIQO product site (https://uniqo.asem.it) and download the most recent stable versions of Update Server and UNIQO License CLI (command line license manager).

  2. Install Update Server on the target from the command line, with the following command:

    UpdateServer.Debian_10_x64.X.Y.Z.K.sh

  3. Install UNIQO License CLI on the target from the command line, with the following command:

    sudo ./UniqoLicenseCli.Debian_10_x64.X.Y.Z.K.sh

Configure a Debian 10 target for the UNIQO display engine

Q Applications can create their own graphical interface thanks to the native UNIQO display engine included, or they can be displayed via a web browser (see Presentation engine).

In the first case, the following procedure must be performed on the Debian 10 target:

  1. If Wayland manager is installed and active, disable it: open the file /etc/gdm3/daemon.conf with a code editor and uncomment #WaylandEnable=false.

  2. Install and activate the X11 windows manager.

  3. Install the Xinerama extension from the command line, with the following command:

    apt-get install -y libxcb-xinerama0

Update Q Studio

  1. Access the'area Download on the UNIQO product site (https://uniqo.asem.it). Alternatively, from Q Studio click image1, then Update UNIQO: the Download area page opens in the browser.

  2. Download the most recent stable version of Q Studio.

  3. Double-click the downloaded file and follow the wizard.

Update Update Server

If necessary, Update Server is updated automatically by Q Studio when deploying an application from Q Studio to the target. After the update is complete, the application deployment continues as normal.

Warning

On Windows targets, the Update Server version 1.0 to version 1.1 upgrade must be done manually. Also, the deployment credentials in Q Studio should be changed.

See also

Related procedures

Activate the UNIQO license