Platform Inspector

The Platform Inspector is a diagnostic tool that verifies whether your ACE environment is configured according to recommended platform configuration guidelines.

The Platform Inspector runs a series of automated validation tests across all nodes in the deployment. These tests verify system configuration, cluster settings, security parameters, and operational settings. Each test returns a pass or fail result, helping you identify configuration issues or deviations from recommended best practices.

Note: The Platform Inspector validates the ASMS platform configuration itself. It does not inspect firewall rules or network policies managed by the system.

Run the Platform Inspector

Do the following:

  1. Open a terminal and log in as root.

  2. Connect to the ASMS Administration interface. For details, see Connect to and Utilize the Administration Interface.

  3. Enter 17 - System Information.

  4. Select 4 - Platform Inspector.

The system runs a set of validation tests and displays the results.

Platform Inspector results

When the Platform Inspector runs, it returns the results of all tests in JSON format.

Each test includes:

  • An overall pass/fail status

  • Optional messages

  • Node-level results for clustered environments

These results help you identify configuration issues and verify that the deployment meets recommended platform guidelines.

The JSON output includes the following parameters:

Parameter Description
testName The internal name of the validation test.
displayName A human-readable description of the test.
passed Indicates whether the test passed (true) or failed (false).
message An optional message describing the result or failure reason.
collateNodeResults Determines whether node results are evaluated collectively across all nodes.
nodeResults A list of results for each node where the test was executed.
nodeName The name of the node where the test was executed.
nodeIp The IP address of the node.
output Optional command output returned by the test.

Example JSON output

The following example shows shortened JSON output from the Platform Inspector:

Copy
[
  {
    "testName": "checkSSLCerts",
    "displayName": "Setup custom TLS/SSL certificates",
    "passed": true,
    "collateNodeResults": false,
    "nodeResults": [
      { "nodeName": "Master", "nodeIp": "127.0.0.1", "passed": true },
      { "nodeName": "RA1", "nodeIp": "10.164.0.133", "passed": true },
      { "nodeName": "LD1", "nodeIp": "10.164.0.134", "passed": true }
    ]
  },
  {
    "testName": "checkNTP",
    "displayName": "Setup NTP on all nodes",
    "passed": false,
    "collateNodeResults": true,
    "nodeResults": [
      { "nodeName": "Master", "nodeIp": "127.0.0.1", "passed": true },
      { "nodeName": "RA1", "nodeIp": "10.164.0.133", "passed": true },
      { "nodeName": "LD1", "nodeIp": "10.164.0.134", "passed": false }
    ]
  }
]

Example test summary

The following example shows a simplified view of test results.

Test Description Status
checkDNS Verify DNS configuration on all nodes Passed
checkNTP Verify NTP configuration Failed
checkHostName Verify unique hostnames across cluster nodes Passed
checkBackup Verify system backup configuration Passed
checkKeycloakPasswordPolicy Verify password complexity requirements Passed

Use the results to identify configuration issues and ensure that your ASMS deployment meets recommended platform standards.