Replacing a viewLinc-signed certificate - viewLinc 5.2

SSL/TLS certificates viewLinc 5.2

Document code
viewLinc 5.2
Document type
Technical note
The following file types are supported for certificate files:
  • CRT
  • CSR
  • DER
  • PEM
  • PFX (pkcs7, pkcs12)
All files must be in Base-64 encoded X.509 format.
If the information in your viewLinc-signed certificate is incorrect or needs to be changed (for example, the fully qualifying domain name), you can replace the certificate with the following steps:
  1. If you generated viewLinc-signed certificate files during initial installation, go to step 5.
  2. If you did not generate viewLinc-signed certificate files during the initial installation of viewLinc, copy the signing software CreateCSR.exe and save the file to the C:\Users\Public\Documents\Vaisala\Vaisala viewLinc\config\keys folder.
  3. Drag the key file, viewLinc-yy-mm-dd.key, and drop it onto CreateCSR.exe.

    If your system does not allow you to drag and drop, use the CMD prompt (as admin) to move the request file onto CreateCSR.exe.

  4. Answer the questions. This process generates a certificate request file (.csr).
    Ensure the list of host names and aliases you provide is correct and complete, or users will not be able to connect to the viewLinc webserver.
  5. In your …\config\keys folder, locate the generated certificate request file (viewLinc-yy-mm-dd.csr) that has been created in the folder. The date in the file name reflects the date it was created.
    You should now have generated new viewLinc-yy-mm-dd.csr and viewLinc-yy-mm-dd.key files (yy-mm-dd is the current date).
  6. Copy the signing software, SignCSR.exe, and save the file to the C:\Users\Public\Documents\Vaisala\Vaisala viewLinc\config\keys folder.
  7. In the .\config\keys folder, drag the request file you generated earlier, viewLinc-yy-mm-dd.csr, and drop it onto SignCSR.exe.
    The following files are created in the …\config\keys folder:
    • viewLinc-yy-mm-dd.csr
    • viewLinc-yy-mm-dd.crt
    • viewLinc-yy-mm-dd.key
  8. Open the C:\Users\Public\Documents\Vaisala\Vaisala viewLinc\config folder and edit the viewLinc.cfg file as follows:
    1. Replace the .key file for "privatekeyfile" with the new .key name, viewLinc-yy-mm-dd.key.
    2. Replace the .crt file for "certificatefile" with the new .crt name, viewLinc-yy-mm-dd.crt.
  9. Restart the viewLinc Web Server service.
    Users who are currently logged in to viewLinc will need to log out and then log in again to establish a new, secure browser session.