Skip to main content
Skip table of contents

How-to OPC server registration and unregistration.

This guide is specifically relevant to who are installing any version of Qinsy from 9.6.4 onwards.

This document will go into the procedures for registering and unregistering the OPC server using both Windows Explorer and Terminal/PowerShell. The steps involved in both methods will be thoroughly covered to facilitate a comprehensive understanding of the process.

A recent change to the installer was implemented due to issues caused by the 'unregister' operation of the OPCClassicServer when multiple Qinsy versions are installed concurrently. This resulted in a message box appearing and obstructing the installation process.

image-20240521-133729.png

Message box

Registering the OPC server

To ensure the correct installation and operation of the OPC driver bundled with Qinsy, it is necessary to register the OPC server.

Method 1: Explorer

The initial approach involves utilizing the file explorer to navigate to the server installation location.

  1. Open up a new Windows Explorer window (Win + E)

  2. Navigate to the Qinsy installation directory of the version that you use, an example shown below for 9.7.0.

    CODE
    C:\Program Files (x86)\QPS\Qinsy\9.7.0\
  3. Open a Terminal or PowerShell in this directory (This can be done by shift-right-clicking in the explorer).

    rightlcick.png

    fig.1: Context menu options

  4. run the following line to register

    CODE
    .\OpcClassicServer.exe /regserver

Method 2: Terminal / PowerShell

To register the OPC server using the terminal, please adhere to these steps.

  1. Open up a terminal (Win + X, A) or PowerShell (Press Win, search powershell, run as administrator)

  2. Navigate to OPC server installation directory in terminal or PowerShell. It's located in Qinsy installation directory matching your version, e.g. 9.7.0.

    CODE
    cd "C:\Program Files (x86)\QPS\Qinsy\9.7.0\"
  3. Once in the install directory, run the following line to register

    CODE
    .\OpcClassicServer.exe /regserver

Unregistering the OPC server

Unregistering the OPC server is essential before uninstalling Qinsy to avoid encountering a specific dialog during the process.

Untitled-20240521-101841.png

When the server is registered, it will be running and prevent the uninstallation from continuing. To avoid any unexpected behavior, we encourage you to unregister it.

Method 1: Explorer

This approach involves the file explorer to navigate to the server location.

  1. Open up a new Windows Explorer window (Win + E)

  2. Navigate to the Qinsy installation directory of the version that you use, an example shown below for 9.7.0.

    CODE
    C:\Program Files (x86)\QPS\Qinsy\9.7.0\
  3. Open a Terminal or PowerShell in this directory (This can be done by shift-right-clicking in the explorer). (refer to fig.1 above)

  4. run the following line to register

    CODE
    .\OpcClassicServer.exe /unregserver

Method 2: Terminal / PowerShell

To unregister the OPC server using the terminal, please follow these steps.

  1. Open up a terminal (Win + X, A) or PowerShell (Press Win, search powershell, run as administrator)

  2. Navigate to OPC server installation directory in terminal or PowerShell. It's located in Qinsy installation directory matching your version, e.g. 9.7.0.

    CODE
    cd "C:\Program Files (x86)\QPS\Qinsy\9.7.0\"
  3. Once in the install directory, run the following line to register

    CODE
    .\OpcClassicServer.exe /unregserver

Something to look out for while uninstalling

If you do not correctly de-register the server correctly, you will encounter a dialog during the uninstall process of Qinsy.

Untitled-20240521-101841.png

If you encounter this issue, we recommend clicking on "cancel" to halt the uninstallation process. Next, attempt to unregister it as outlined above to avoid any unexpected behavior. After that, proceed with the uninstallation process once again.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.