20.4 Monitoring the Health of Access Gateways

20.4.1 Monitoring the Health of an Access Gateway

To view detailed health status information of an Access Gateway:

  1. In the Administration Console, click Devices > Access Gateways > [Name of Server] > Health.

    The status icon is followed by a description that explains the significance of the current state. For more information about these icons, see Section 20.1, Health States.

  2. To ensure that the information is current, select one of the following:

    • Click Refresh to refresh the page with the latest health available from the Administration Console.

    • Click Update from Server to send a request to the Access Gateway to update its status information. If you have made changes that affect the health of the Access Gateway, select this option. Otherwise, it can take up to five minutes for the health status to change.

  3. Examine the Services Detail section that displays the status of each service. For an Access Gateway, this includes information such as the following:

  4. Click Close.

Service Categories of the Access Gateway Service

Service Category

If Not Healthy

Reverse Proxy - <Proxy Service Name>: Indicates the general health of all configured proxy services. A separate row is created for each proxy service.

Check the health of the Web server.

AGM - Configuration: Indicates whether all configuration changes have been applied.

Do the following:

  • To re-push the current configuration, click Auditing > Troubleshooting, select the gateway from the list of the Current Access Gateway Configurations, then click Re-push Current Configuration.

  • To revert to last applied configuration, click Devices > Access Gateways > Edit, then click Revert.

If these options do not fix the problem, view the Apache error.log file to discover the cause. The file is located in the following directory:

TCP Listener - <IP Address:Port>: Indicates whether the Access Gateway Service is listening on the specified port. A separate row is created for each port the Gateway Service is configured to listen on.

Restart the Apache service.

ApacheGateway.log: Appears when the Access Gateway Service is not healthy. It displays the latest error from the Apache error.log file.

For more information about the problem, view the error.log file in the following directory:

Embedded Service Provider Configuration: Indicates whether the Access Gateway has been configured to trust an Identity Server and whether that configuration has been applied.

At least one Identity Server must be configured and set up as a trusted authentication source for the Access Gateway.

A green status indicates that a configuration has been applied; it does not indicate that it is a functioning configuration.

See Section 3.8.2, Managing Reverse Proxies and Authentication for information about assigning an Identity Server configuration to the Access Gateway.

Configuration Datastore: Indicates whether the configuration datastore is functioning correctly.

Restore the configuration datastore. See Section 26.3.6, Repairing the Configuration Datastore.

Clustering: Indicates whether all the cluster members are active and processing requests.

Restart the cluster members that are not active or remove them from the cluster.

Signing, Encryption and SSL Connector Keys: Indicates whether these keystores contain a valid key.

Click Access Gateways > Edit > Service Provider Certificates and replace any missing or expired keys.

System Incoming and Outgoing HTTP Requests: Appears when throughput is slow. This health check monitors incoming HTTP requests, outgoing HTTP requests on the SOAP back channel, and HTTP proxy requests to cluster members. If one or more requests remain in the queue for over 2 minutes, this health check appears.

Verify that all members of the cluster have sufficient bandwidth to handle requests. If a cluster member is going down, the problem resolves itself as other members of the cluster are informed that the member is down.

If a cluster member is slow because it doesn’t have enough physical resources (speed or memory) to handle the load, upgrade the hardware.

TCP Listener(s): Indicates whether the listening port for the Embedded Service Provider is healthy.

Restart the Access Gateway.

Embedded Service Provider’s Trusted Identity Provider: Indicates whether the configuration that the Access Gateway trusts has been configured to contain at least one Identity Server.

Modify the Identity Server configuration and add an Identity Server.

Configure the Access Gateway to trust an Identity Server configuration. See Creating a Proxy Service.

Audit Logging Server: Indicates whether the audit agent is functioning and able to log events to the auditing server.

Auditing must be enabled on the Identity Server to activate this health check (click Devices > Identity Servers > Edit > Logging).

Check the network connection between the Identity Server and the auditing server.

See “Troubleshooting Novell Audit”.

20.4.2 Monitoring the Health of an Access Gateway Cluster

The Health icon on the cluster row displays the status of the least healthy member of the cluster. For information about the meaning of health icons, see Section 20.1, Health States.

To view details about the status of the cluster:

  1. In the Administration Console, click Devices > Access Gateways.

  2. On the cluster row, click the Health icon.

  3. To ensure that the information is current, click Refresh.

  4. To view specific information about the status of an Access Gateway, click the Health icon in the Access Gateway row.