{
  "id": "rlcheck",
  "title": "rlcheck",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/cli-utilities/rlcheck/",
  "summary": "Verify nodes.",
  "content": "The `rlcheck` utility runs various [tests](#tests) to check the health of a Redis Enterprise Software node and reports any discovered issues.\nYou can use this utility to confirm a successful installation or to verify that the node is functioning properly.\n\nTo resolve issues reported by `rlcheck`, [contact Redis support](https://redis.com/company/support/).\n\n## Run rlcheck\n\nYou can run `rlcheck` from the node host's command line.\nThe output of `rlcheck` shows information specific to the host you run it on.\n\nTo run `rlcheck` tests:\n\n1. Sign in to the Redis Enterprise Software host with an account that is a member of the **redislabs** operating system group.\n\n1. Run: \n\n    ```sh\n    rlcheck\n    ```\n\n## Options\n\nYou can run `rlcheck` with the following options:\n\n| Option | Description |\n|--------|-------------|\n| \u003cnobr\u003e`--suppress-tests TEXT`\u003c/nobr\u003e | Skip the specified, comma-delimited list of tests. See [Tests](#tests) for the list of tests and descriptions. |\n| \u003cnobr\u003e`--retry-delay INTEGER`\u003c/nobr\u003e | Delay between retries, in seconds. |\n| \u003cnobr\u003e`--retry INTEGER`\u003c/nobr\u003e | Number of retries after a failure. |\n| \u003cnobr\u003e`--file-path TEXT`\u003c/nobr\u003e | Custom path to `rlcheck.log`. |\n| \u003cnobr\u003e`--continue-on-error`\u003c/nobr\u003e | Continue to run all tests even if a test fails, then show all errors when complete. |\n| `--help` | Return the list of `rlcheck` options. |\n\n## Tests\n\n`rlcheck` runs the following tests by default:\n\n| Test name | Description |\n|-----------|-------------|\n| verify_owner_and_group | Verifies the owner and group for Redis Enterprise Software files are correct. |\n| verify_bootstrap_status | Verifies the local node's bootstrap process completed without errors. |\n| verify_services | Verifies all Redis Enterprise Software services are running. |\n| verify_port_range | Verifies the [`ip_local_port_range`](https://www.kernel.org/doc/html/latest/networking/ip-sysctl.html) doesn't conflict with the ports Redis Enterprise might assign to shards. |\n| verify_pidfiles | Verifies all active local shards have PID files. |\n| verify_capabilities | Verifies all binaries have the proper capability bits. |\n| verify_existing_sockets | Verifies sockets exist for all processes that require them. |\n| verify_host_settings | Verifies the following:\u003cbr /\u003e• Linux `overcommit_memory` setting is 1.\u003cbr /\u003e•`transparent_hugepage` is disabled.\u003cbr /\u003e• Socket maximum connections setting `somaxconn` is 1024. |\n| verify_tcp_connectivity | Verifies this node can connect to all other alive nodes. |\n| verify_encrypted_gossip | Verifies gossip communication is encrypted. |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00",
  "children": []
}