Synopsis

Validates the schema version as seen from the node.

Ensure that all nodes are have the same schema version.

Can poll multiple times to wait for the schema version to converge.

Can also specify a schema version if required.

Schema version is obtained through the usage of the nodetool describecluster command.

Requirements

The below requirements are needed on the host that executes this module.

• nodetool

Parameters

uuid (optional, str, None)

The expected schema version.

poll (optional, int, 1)

The maximum number of times to call nodetool describecluster.

interval (optional, int, 30)

The number of seconds to wait between poll executions.

host (optional, str, 127.0.0.1)

The hostname.

port (optional, int, 7199)

The Cassandra TCP port.

password (optional, str, None)

The password to authenticate with.

password_file (optional, str, None)

Path to a file containing the password.

username (optional, str, None)

The username to authenticate with.

nodetool_path (optional, str, None)

The path to nodetool.

nodetool_flags (optional, str, -Dcom.sun.jndi.rmiURLParsing=legacy)

Flags to pass to nodetool.

debug (optional, bool, False)

Enable additional debug output.

Examples

- name: Ensure all Cassandra nodes are in schema agreement.
  community.cassandra.cassandra_schema:

- name: Ensure all Cassandra nodes have the expected schema version
  community.cassandra.cassandra_schema:
    is: 1176b7ac-8993-395d-85fd-41b89ef49fbb

- name: Poll schema version a max of 5 times with a 30 second interval
  community.cassandra.cassandra_schema:
    poll: 5
    interval: 30

Return Values

msg (on success, bool, )

A message indicating what has happened.

rc (always, int, )

Return code of the last executed command.

Status