Installing Link

The Link service requires CygNet SCADA services to be installed on the system that is running the service. It also requires a 64-bit version of Dclnd (Dclnd64.dll). If you are not already running 64-bit CygNet services, the recommended method of obtaining a 64-bit Dclnd is to install the 64-bit VHS with the installer using the CygNet SCADA Services (64-bit) Setup application (CygNetSCADAServicesSetup64.exe). This will install Dclnd64.dll and any other 64 bit dependencies required for Link. See the 64-bit Installation Guide for installation instructions.

Note: A valid license file is required if you intend to support more than 50 points to be published from the gateway. Please contact your Account Manager for more information.

To Install the Link Service

Important: Ensure that all prerequisite steps are complete. Refer to the CygNet System Requirements document.

  1. Install the Link service:
  1. Copy the Link package (Weatherford_Link-x64.msi) file from the CygNet\Setup folder of your CygNet source files to the desktop of your local machine.
  2. Use the setup package to install the Link service on your machine:
  1. Open the Link package.
  2. Read and agree to the license terms and conditions.
  3. Click Install to install the Link service on your machine.
  1. Go to the sample_appsettings.json file included in the installation package to configure it to your specifications, and rename it to "appsettings.gateway.json".

    2. Note: The sample_appsettings.json file is located in C:/ProgramData/Weatherford/Link. See Configuring Link for more information.

  1. Start the service.
  1. Open Windows Task Manager (run TaskMgr.exe).
  2. Click on the Services tab.
  3. Find WLink (Weatherford Link) in the list.
  4. Right-click and select Start.

Link Security

To automatically generate the encryptedPassword value, after filling in the password field, run Link with the -encrypt parameter specified in the command line. The process will automatically generate an encrypted password, store it as the encryptedPassword value, and erase the values of all password fields. It will also generate a key file used to decrypt the passwords, which it will store in the Link data folder (C:/ProgramData/Weatherford/Link on Windows). Lastly, it will update the passwordEncryptionKeyPath object member in appsettings.gateway.json with the location of the key file.

Once the key file has been generated, users are free to move the file wherever they please, provided they also update the passwordEncryptionKeyPath to point to the new file location. If the key file is not present when Link is run, it will not be able to decrypt the encrypted passwords and it will fail.

Note: NTFS permissions should be used to prevent unauthorized users from accessing the encryption key file.

Back to top

Let us know how we can improve this topic.

CygNet at weatherford.com

© 2020 Weatherford. All rights reserved.