Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This article describes how to set up the Ping function in Protocol Gateway. 

The Ping service (monitoring service) is used for system health checks and can be used by load balancers to detect issues in nodes. A Ping call engages all internal components in the CA system, including HSMs.

Prerequisites

Expand
titlePrerequisites

The following prerequisites apply:

  • Protocol Gateway must be installed. 

...


Expand
titleCreate certificate procedure for Ping
  1. Create a certificate procedure for Ping, see Create certificate procedure in Certificate Manager.
    1. Set Procedure name to Ping Certificate Procedure.  
    2. In Issuing CA, select Device Issuing CA
    3. In Certificate format, select Ping


Expand
titleCreate token procedure for Ping
  1. Create a token procedure for Ping, see Create token procedure in Certificate Manager.
    1. Set Procedure name to Ping Procedure.  
    2. In Certificate procedures, select the certificate procedure you just created, that is Ping Certificate Procedure
    3. In Type, select pkcs10


Expand
titleSet Ping properties

To set the properties for Ping: 

  1. Open \Nexus\cm-gateway\conf\Ping.properties for editing.
  2. Modify the following properties: 
    1. Enable Ping by setting start to true
    2. Set default.tokenprocedure to Ping Procedure.

    3. By default, the Ping service only checks the status of Protocol Gateway. It it shall also check the status of Certificate Factory (CF), then set default.pingCF to true
Code Block
titleExample: Ping.properties
start = true
default.tokenprocedure = Ping Procedure



Expand
titleRestart Tomcat
  1. Restart the Tomcat service. 


Expand
titleVerify Ping

To verify Ping: 

  1. Open a browser and go to: 

    Code Block
    titleExample: Ping URL
    localhost:8080/pgwy/ping


  2. Verify that the page shows online.

Related information