Replacing a viewLinc-signed certificate - viewLinc 5.1

SSL/TLS certificates viewLinc 5.1

Document code
viewLinc 5.1
Document type
Technical note
The following file types are supported for certificate files:
  • CRT
  • CSR
  • PEM
All files must be in PEM format.
If the information in your viewLinc-signed certificate is incorrect or needs to be changed (for example, the fully qualified 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 5.1, copy the signing software CreateCSR.exe (the file must be from version 5.1.8 or later) 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. For the domain name, you can provide a comma-separate list of hostnames and aliases; ensure the list you provide is correct and complete. This process generates a certificate request file (.csr).
  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.
  10. Test that the newly installed certificate works using the URLs you supplied in step 4.