Skip to main content

 Advanced

Advanced topics

Servlet: DBMonitor

com.pageseeder.DBMonitor

Description

This servlet does not return XML data and cannot be used by the Ant or Layout APIs.

The DBMonitor servlet tries to connect to the database using the current database settings.

It is used for server monitoring only.

Usage

Unless prevented by firewall or other network security, the DBMonitor URL is publicly accessible on any PageSeeder server as:

/ps/servlet/com.pageseeder.DBMonitor

While getting the standard response doesn't mean the system is free from problems, not getting it guarantees there are problems.

Successfully getting a response means that PageSeeder's key infrastructure (servlet container, web server, database) is live and communicating.

Responses

All responses are text only (text/plain). HTTP Status codes can be used to help diagnosing problems.

200 OK

If DBMonitor is able to connect and use the PageSeeder database, it returns the HTTP status code 200 (OK) and a text message.

It means that the DBMonitor was able to connect to the database using the current database properties and that it was able to make a query.

DBMonitor does not verify the integrity of the database. It can only assert that PageSeeder create a connection to the database successfully. A successful response does not necessarily guarantee that the database is setup properly.

502 Bad Gateway

The HTTP status code 502 (Bad Gateway) is returned if there is any error related to the database. A message indicating the possible cause might be included in the response.

This error might occur because:

  • The database properties are incorrect;
  • The database service is not started;
  • The database server is unreachable (if on a different host);
  • The database server was not setup properly.

500 Internal Server Error

The HTTP status code 500 (Internal Server Error) is only returned if the DBMonitor itself is in an error state. This rarely occurs and it means that the DBMonitor is unable to provide any information about the system.

Server Timeout / Unreachable

When no status code is returned. It might be indicative of a more serious problem such as:

  • PageSeeder itself is not configured properly;
  • PageSeeder is too busy and has become unresponsive;
  • A network error (DNS, firewall, network security);
  • The entire system is down.

HTTP Method: GET

No parameters required for this request.

Created on , last edited on