Knowledge Search


×
 

Northstar System Health Monitor and Analytics Times Out due to Expired Certificate

  [TSB17645] Show Article Properties


Alert Type:
PSN - Product Support Notification
Product Affected:
NorthStar Controller (versions 3.1 through 5.0)
Alert Description:

Summary
The original NorthStar installation scripts did not properly generate SSL certificates for the health monitoring and analytics packages.  As a result, the certificates will prematurely expire (or have become expired) and need to be updated immediately.

Impacted Versions:
All versions of NorthStar 3.1 through 5.0

Symptoms:
                Web -- Health monitor erroneously reports the application nodes as unreachable (because the SSL certificate expired).
                Charts -- Queries will fail (because the SSL certificate expired).
                Telemetry -- Data will not be stored into Elastic Search (because the SSL certificate expired).


NorthStar customers can confirm if the certificate is invalid by issuing the following command:

[root@pcs-q-pod03 NodeJS]# openssl x509 -enddate -noout -in /opt/northstar/web/routes/v1/health/certs/server/server-crt.pem
 
notAfter=Sep 24 21:51:07 2019 GMT
Note: The date listed in the response is the date when the certificate expires.
Solution:
Please find the procedure to generate the new certificate attached to this TSB.  Processes that need to be restarted will vary depending on how the NorthStar Controller is implemented.

This patch is for versions 3.1 - 5.0.  A separate patch will be made available for 3.0.

Patch Instructions (NorthStar versions 3.1-5.0):
  1. Extract the archive nsCertPatch_2019_09_26.tar.gz on the the main application server only.
  2. Execute update_cert.sh
  3. On all servers (apps and analytics) identify the RUNNING processes
         supervisorctl status
  4. Restart the below processes on all servers (if it exists) and if the status is RUNNING
         infra:healthmonitor
         infra:web
         collector_main:es_publisher
         analytics:esauthproxy
Related Links:
Attachment File:
nsCertPatch_2019_09_26.tar.gz
3K • < 1 minute @ 56k, < 1 minute @ broadband