---
title: Checking System After Configuration
slug: Ao4bZCSrJu12YG2m-oIjG
description: Verify your system setup post-configuration to confirm that Ocient operates correctly and meets performance benchmarks.
docTags: 
createdAt: Mon Jul 03 2023 20:42:22 GMT+0000 (Coordinated Universal Time)
updatedAt: Mon Mar 30 2026 18:52:45 GMT+0000 (Coordinated Universal Time)
---

The `postcheck` command helps capture critical node health states and metrics after the Ocient® configuration process.

You can run the command as shown in this example. The flags included after the `precheck` command are optional. See [Flags for Command Execution](./#flags-for-command-execution) for descriptions.&#x20;

```shell
$ sudo /usr/local/bin/postcheck --dsn ocient://<user>:<password>@<host>:<port>/<database>
```

This table describes each placeholder in the DSN:

| **Placeholder** | **Description**                                                                |
| --------------- | ------------------------------------------------------------------------------ |
| `<user>`        | The username for the Ocient database connection (for example, `admin@system`). |
| `<password>`    | The password associated with the specified user.                               |
| `<host>`        | The hostname or IP address of the SQL Node to connect to.                      |
| `<port>`        | The port number on which the SQL Node is listening.                            |
| `<database>`    | The name of the database to connect to.                                        |

The command invokes a script from the command line on operating systems supported by Ocient. The script sends output to standard output (STDOUT) and standard error (STDERR) with the option to send a text file or a JSON file.&#x20;

To specify the file option, use this flag: `--logfile-location <directory>` where `<directory>` is the directory where the `postcheck` command creates the log file.

Before you begin, ensure that all steps in the [Ocient System Bootstrapping](<././Ocient System Bootstrapping.md>) process are complete.

## Prerequisites

The script requires Java® and the Ocient JDBC JAR to run. In most cases, you should use this script on client servers rather than database nodes.

To get the post-check script onto a client, perform the `scp` operation on the wheel onto the server and run `python3 -m pip install --no-index <path_to_wheel>/postcheck*.whl`, and replace `<path_to_wheel>` with the path to the directory of the wheel file on your server.

## Flags for Command Execution

Use the `postcheck` command to run the script that checks the system configuration after you configure Ocient. You can execute the command using these flags.

| **Flag Name**      | **Required** | **Values**        | **Default**                          | **Description**                                                                                                                                                                              | **Example**                                                                                                                                                                                 |
| ------------------ | ------------ | ----------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| --dsn              | Yes          | Many              | Not applicable                       | Data source name (DSN). The script prompts for your credentials.                                                                                                                             | `--dsn ocient://host:port/path` connects you to the specified cluster where `host` is the host name, `port` is the port number, and `path` is the path on the host for the connection.      |
| --logfile-location | No           | Non-empty string  | /var/opt/ocient/log                  | Name of directory that contains the log file created from the execution of the script.                                                                                                       | `--logfile-location /user/query/logs` generates a log file in the `/user/query/logs` directory. If this directory does not exist, the command issues a warning.                             |
| --print-level      | No           | verbose or silent | verbose                              | Denotes the level of detail in the output. See the “Outputs” section.                                                                                                                        | `--print-level verbose` provides a detailed report with information about the checks that Ocient performs. `--print-level silent` provides the overall status from the check of the system. |
| --timeout          | No           | Any integer       | 3                                    | Denotes the default timeout (in seconds) for running any command-line command in the script. In most cases, the default is enough, so you do not need to specify this setting.               | `--timeout 4` runs checks with a timeout of 4 seconds for each command.                                                                                                                     |
| --jar-path         | No           | Non-empty string  | /opt/ocient/current/ocient-jdbc4.jar | Denotes the path to the Ocient JDBC JAR. The default value is the usual location of the JAR file on an Ocient System. This path must be accurate for the postcheck command to run correctly. | `--jar-path /opt/ocient/test_dir/jdbc.jar` uses the JAR at `/opt/ocient/test_dir/jdbc.jar` to run JDBC commands for the `postcheck` command.                                                |
| --json             | No           | Not applicable    | False                                | If you specify the --json flag, the command prints output in JSON format to STDOUT. If you do not specify this flag, the command prints human-readable output to STDOUT.                     | `--json` prints output in JSON format to STDOUT.                                                                                                                                            |

## Command Output

The command has two types of output, silent or verbose, which you can specify by using the `--print-level` flag at the command line.

**Silent**

The `silent` value for the `--print-level` flag only produces a status code. The code is 0 for success, 1 for error, and 2 for warning.

**Verbose**

The `verbose` value for the `--print-level` flag prints either human-readable output by default or output in JSON format (if you specify the `--json` flag). The output contains all status details.

This example shows human-readable output.

```Text
Warnings:
- Foundation Nodes storage are non-uniform.

OS Configuration - OK
================
Huge Page Settings - OK
isolcpus settings - OK

Memory - OK
======
Foundation Nodes: 1024 GB
SQL Nodes: 1024 GB
Loader Nodes: 1536 GB
Total DRAM: 123120 GB
...
```

This example shows output in JSON format.

```json
{"status": 2,
  "components": {
    "firmware": {
      "status": 0,
      "message": "SUCCESS: NVMe drive firmware is consistent across nodes."
    }
    "symmetry": {
      "status": 2,
      "message": "WARNING: non-uniform configuration."
      "storage": {
        "status": 2,
        "foundation": {
          "status": 0,
          "message": "SUCCESS: storage consistent across Foundation Nodes."
          "foundation1": 16TB,
          ...
        }
    ...
  }
}
```

## Related Links

[Ocient System Bootstrapping](<././Ocient System Bootstrapping.md>)

[Ocient Application Configuration](<././Ocient Application Configuration.md>)

