Using the Ping Support Feature

Learn how to ping Network Director and Policy Manager instances to verify they are running.

Using Admin Console Managing Containers

Table of Contents

  1. Introduction
  2. Enabling the Ping Service

Introduction

The Ping Support feature includes a simple "ping" web service for testing the functional state of the container's web service framework.

Enabling the Ping Service

In many cases, when load balancers are being used to load balance the Network Director instances and/or Policy Manager instances, the load balancers "ping" these instances to verify that the instances are running.

The Ping Support feature provides support for pinging the instances. You can install and enable this feature from the Akana Administration Console of the container instance.

Step 1: Install the Ping feature into the instance

  1. Launch the Akana Administration Console for the Policy Manager container instance (http://{hostname:{port}/admin/).
  2. On the Available Features screen, from the Filter menu, select Feature.
  3. Select the Ping Feature and click Install Feature.
  4. After the installation is complete, click Close.

Step 2: Enable the Ping feature

  1. Select the Configuration tab. In the Configuration Categories section, select com.soa.feature.ping.
  2. Change the value of the ping.service.enabled property from False to True, and then click Apply Changes.

Step 3: Invoke the Ping Service

To invoke the Ping service, use a GET request.

There are two different methods available, with different responses:

  • http://{instance_host}:{instance_port}/pingrest/ping
    • Response: status code 200
    • Body content: true
  • http://{instance_host}:{instance_port}/pingrest/who
    • Response: status code 200
    • Body content: instance container key
Sample Request: /pingrest/ping
C:\>curl -v http://localhost:9101/pingrest/ping

GET /pingrest/ping HTTP/1.1
Host: localhost:9101
User-Agent: curl/7.61.0
Accept: */*
Sample Response: /pingrest/ping
HTTP/1.1 200 OK
Date: Tue, 30 Oct 2018 07:53:32 GMT
Content-Type: application/xml
Transfer-Encoding: chunked
true
Sample Request: /pingrest/who

Sample Response: /pingrest/who

Back to top