Cassandra
Table of Contents
- Overview
- Setup - The basics of getting started with Cassandra
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Contributers
Overview
A Puppet module to install and manage Cassandra, DataStax Agent & OpsCenter
Setup
What Cassandra affects
What the Cassandra class affects
- Installs the Cassandra package (default dsc22).
- Configures settings in ${config_path}/cassandra.yaml.
- Optionally ensures that the Cassandra service is enabled and running.
- On Ubuntu systems, optionally replace
/etc/init.d/cassandra
with a workaround for CASSANDRA-9822.
What the cassandra::datastax_agent class affects
- Optionally installs the DataStax agent.
- Optionally sets JAVA_HOME in /etc/default/datastax-agent.
What the cassandra::datastax_agent class affects
- Optionally configures a Yum repository to install the Cassandra packages from (on Red Hat).
- Optionally configures an Apt repository to install the Cassandra packages from (on Ubuntu).
What the cassandra::firewall_ports class affects
- Optionally configures the firewall for the Cassandra related network ports.
What the cassandra::java class affects
- Optionally installs a JRE/JDK package (e.g. java-1.7.0-openjdk) and the Java Native Access (JNA).
What the cassandra::opscenter class affects
- Installs the OpsCenter package.
- Manages the content of the configuration file (/etc/opscenter/opscenterd.conf).
- Manages the opscenterd service.
What the cassandra::opscenter::cluster_name type affects
- An optional type that allows DataStax OpsCenter to connect to a remote key space for metrics storage. These files will be created in /etc/opscenter/clusters. The module also creates this directory if required. This functionality is only valid in DataStax Enterprise.
What the cassandra::opscenter::pycrypto class affects
- On the Red Hat family it installs the pycrypto library and it's pre-requisites (the python-devel and python-pip packages).
- Optionally installs the Extra Packages for Enterprise Linux (EPEL) repository.
- As a workaround for
PUP-3829 a symbolic
link is created from
/usr/bin/pip
to/usr/bin/pip-python
. Hopefully this can be removed in the not too distant future.
What the cassandra::optutils class affects
- Optionally installs the Cassandra support tools (e.g. cassandra22-tools).
Beginning with Cassandra
A basic example is as follows:
class { 'cassandra':
cluster_name => 'MyCassandraCluster',
endpoint_snitch => 'GossipingPropertyFileSnitch',
listen_address => "${::ipaddress}",
seeds => '110.82.155.0,110.82.156.3'
}
Upgrading
Changes in 1.8.0
A somewhat embarrassing correction to the spelling of the cassandra::fail_on_non_suppoted_os to cassandra::fail_on_non_supported_os.
Issues when Upgrading to 1.4.0
Unfortunately both releases 1.3.7 and 1.4.0 have subsequently been found to call a refresh service even when no changes had been made to the underlying configuration. In release 1.8.0 (somewhat belatedly) the service_refresh flag has been introduced to mitigate against similar problems.
Issues When Upgrading to 1.3.7
- Please see the notes for 1.4.0.
Changes in 1.0.0
- cassandra::cassandra_package_ensure has been renamed to cassandra::package_ensure.
- cassandra::cassandra_package_name has been renamed to cassandra::package_name.
Changes in 0.4.0
There is now a cassandra::datastax_agent class, therefore:
- cassandra::datastax_agent_package_ensure has now been replaced with cassandra::datastax_agent::package_ensure.
- cassandra::datastax_agent_service_enable has now been replaced with cassandra::datastax_agent::service_enable.
- cassandra::datastax_agent_service_ensure has now been replaced with cassandra::datastax_agent::service_ensure.
- cassandra::datastax_agent_package_name has now been replaced with cassandra::datastax_agent::package_name.
- cassandra::datastax_agent_service_name has now been replaced with cassandra::datastax_agent::service_name.
Likewise now there is a new class for handling the installation of Java:
- cassandra::java_package_ensure has now been replaced with cassandra::java::ensure.
- cassandra::java_package_name has now been replaced with cassandra::java::package_name.
Also there is now a class for installing the optional utilities:
- cassandra::cassandra_opt_package_ensure has now been replaced with cassandra::optutils:ensure.
- cassandra::cassandra_opt_package_name has now been replaced with cassandra::optutils:package_name.
Changes in 0.3.0
cassandra_opt_package_ensure changed from 'present' to undef.
The manage_service option has been replaced with service_enable and service_ensure.
Usage
Create a Cluster in a Single Data Center
In the DataStax documentation Initializing a multiple node cluster (single data center) http://docs.datastax.com/en/cassandra/2.2/cassandra/initialize/initSingleDS.html there is a basic example of a six node cluster with two seeds to be created in a single data center spanning two racks. The nodes in the cluster are:
Node Name | IP Address |
---|---|
node0 (seed 1) | 110.82.155.0 |
node1 | 110.82.155.1 |
node2 | 110.82.155.2 |
node3 (seed 2) | 110.82.156.3 |
node4 | 110.82.156.4 |
node5 | 110.82.156.5 |
Each node is configured to use the GossipingPropertyFileSnitch and 256 virtual nodes (vnodes). The name of the cluster is MyCassandraCluster. Also, while building the initial cluster, we are setting the auto_bootstrap to false.
In this initial example, we are going to expand the example by:
- Ensuring that the software is installed via the DataStax Community
repository by including
cassandra::datastax_repo
. This needs to be executed before the Cassandra package is installed. - That a suitable Java Runtime environment (JRE) is installed with Java Native
Access (JNA) by including
cassandra::java
. This need to be executed before the Cassandra service is started.
node /^node\d+$/ {
class { 'cassandra::datastax_repo':
before => Class['cassandra']
}
class { 'cassandra::java':
before => Class['cassandra']
}
class { 'cassandra':
cluster_name => 'MyCassandraCluster',
endpoint_snitch => 'GossipingPropertyFileSnitch',
listen_address => "${::ipaddress}",
num_tokens => 256,
seeds => '110.82.155.0,110.82.156.3',
auto_bootstrap => false
}
}
The default value for the num_tokens is already 256, but it is included in the example for clarity. Do not forget to either set auto_bootstrap to true or not set the parameter at all after initializing the cluster.
Create a Cluster in Multiple Data Centers
To continue with the examples provided by DataStax, we look at the example for a cluster across multiple data centers http://docs.datastax.com/en/cassandra/2.2/cassandra/initialize/initMultipleDS.html.
Node Name | IP Address | Data Center | Rack |
---|---|---|---|
node0 (seed 1) | 10.168.66.41 | DC1 | RAC1 |
node1 | 10.176.43.66 | DC1 | RAC1 |
node2 | 10.168.247.41 | DC1 | RAC1 |
node3 (seed 2) | 10.176.170.59 | DC2 | RAC1 |
node4 | 10.169.61.170 | DC2 | RAC1 |
node5 | 10.169.30.138 | DC2 | RAC1 |
For the sake of simplicity, we will confine this example to the nodes:
node /^node[012]$/ {
class { 'cassandra':
cluster_name => 'MyCassandraCluster',
endpoint_snitch => 'GossipingPropertyFileSnitch',
listen_address => "${::ipaddress}",
num_tokens => 256,
seeds => '10.168.66.41,10.176.170.59',
dc => 'DC1',
auto_bootstrap => false
}
}
node /^node[345]$/ {
class { 'cassandra':
cluster_name => 'MyCassandraCluster',
endpoint_snitch => 'GossipingPropertyFileSnitch',
listen_address => "${::ipaddress}",
num_tokens => 256,
seeds => '10.168.66.41,10.176.170.59',
dc => 'DC2',
auto_bootstrap => false
}
}
We don't need to specify the rack name (with the rack parameter) as RAC1 is the default value. Again, do not forget to either set auto_bootstrap to true or not set the parameter at all after initializing the cluster.
OpsCenter
To continue with the original example within a single data center, say we
have an instance of OpsCenter running on a node called opscenter which has
an IP address of 110.82.157.6. We add the cassandra::datastax_agent
to
the cassandra node to connect to OpsCenter:
node /^node\d+$/ {
class { 'cassandra::datastax_repo':
before => Class['cassandra']
} ->
class { 'cassandra::java':
before => Class['cassandra']
} ->
class { 'cassandra':
cluster_name => 'MyCassandraCluster',
endpoint_snitch => 'GossipingPropertyFileSnitch',
listen_address => "${::ipaddress}",
num_tokens => 256,
seeds => '110.82.155.0,110.82.156.3',
before => Class['cassandra::datastax_agent']
} ->
class { 'cassandra::datastax_agent':
stomp_interface => '110.82.157.6'
}
}
node /opscenter/ {
include '::cassandra::datastax_repo' ->
include '::cassandra' ->
include '::cassandra::opscenter'
}
We have also added the cassandra::opscenter
class for the opscenter node.
DataStax Enterprise
After configuring the relevant repository, the following snippet works on CentOS 7 to install DSE Cassandra 4.7.0:
class { 'cassandra::datastax_repo':
descr => 'DataStax Repo for DataStax Enterprise',
pkg_url => 'https://username:password@rpm.datastax.com/enterprise',
before => Class['cassandra'],
}
class { 'cassandra':
cluster_name => 'MyCassandraCluster',
config_path => '/etc/dse/cassandra',
package_ensure => '4.7.0-1',
package_name => 'dse-full',
service_name => 'dse',
}
Also with DSE, one can specify a remote keyspace for storing the metrics for a cluster. An example is:
cassandra::opscenter::cluster_name { 'Cluster1':
cassandra_seed_hosts => 'host1,host2',
storage_cassandra_username => 'opsusr',
storage_cassandra_password => 'opscenter',
storage_cassandra_api_port => 9160,
storage_cassandra_cql_port => 9042,
storage_cassandra_keyspace => 'OpsCenter_Cluster1'
}
Reference
Public Classes
- cassandra
- cassandra::datastax_agent
- cassandra::datastax_repo
- cassandra::firewall_ports
- cassandra::java
- cassandra::opscenter
- cassandra::opscenter::pycrypto
- cassandra::optutils
Public Defined Types
Private Defined Types
- cassandra::opscenter::setting
- cassandra::firewall_ports::rule
Class: cassandra
A class for installing the Cassandra package and manipulate settings in the configuration file.
Parameters
authenticator
This is passed to the cassandra.yaml file. Default value: 'AllowAllAuthenticator.
authorizer
This is passed to the cassandra.yaml file. Default value: 'AllowAllAuthorizer'
auto_bootstrap
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
auto_snapshot
This is passed to the cassandra.yaml file. Default value 'true'
batchlog_replay_throttle_in_kb
This is passed to the cassandra.yaml file. Default value: '1024'
batch_size_warn_threshold_in_kb
This is passed to the cassandra.yaml file. Default value 5
broadcast_address
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
broadcast_rpc_address
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
cas_contention_timeout_in_ms
This is passed to the cassandra.yaml file. Default value: '1000'
cassandra_9822
If set to true, this will apply a patch to the init file for the Cassandra service as a workaround for CASSANDRA-9822. This option is silently ignored on the Red Hat family of operating systems as this bug only affects Ubuntu systems. Default value 'false'
cassandra_yaml_tmpl
The path to the Puppet template for the Cassandra configuration file. This allows the user to supply their own customized template. A Cassandra 1.X compatible template called cassandra1.yaml.erb has been provided by @Spredzy. Default value 'cassandra/cassandra.yaml.erb'
client_encryption_algorithm
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is client_encryption_options -> algorithm
.
Default value: undef
client_encryption_cipher_suites
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is client_encryption_options -> cipher_suites
.
Default value: undef
client_encryption_enabled
This is passed to the
cassandra.yaml file.
The field being set is client_encryption_options -> enabled
.
Default value 'false'
client_encryption_keystore
This is passed to the
cassandra.yaml file.
The field being set is client_encryption_options -> keystore
.
Default value 'conf/.keystore'
client_encryption_keystore_password
This is passed to the
cassandra.yaml file.
The field being set is client_encryption_options -> keystore_password
.
Default value 'cassandra'
client_encryption_protocol
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is client_encryption_options -> protocol
.
Default value: undef
client_encryption_require_client_auth
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is client_encryption_options -> require_client_auth
.
Default value: undef
client_encryption_store_type
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is client_encryption_options -> store_type
.
Default value: undef
client_encryption_truststore
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is client_encryption_options -> truststore
.
Default value: undef
client_encryption_truststore_password
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is client_encryption_options -> truststore_password
.
Default value: undef
cluster_name
This is passed to the cassandra.yaml file. Default value 'Test Cluster'
column_index_size_in_kb
This is passed to the cassandra.yaml file. Default value: '64'
commit_failure_policy
This is passed to the cassandra.yaml file. Default value: 'stop'
commitlog_directory
This is passed to the cassandra.yaml file. Default value '/var/lib/cassandra/commitlog'
commitlog_directory_mode
The mode for the directory specified in commitlog_directory
.
Default value '0750'
commitlog_segment_size_in_mb
This is passed to the cassandra.yaml file. Default value: 32
commitlog_sync
This is passed to the cassandra.yaml file.
See also commitlog_sync_batch_window_in_ms
and commitlog_sync_period_in_ms
.
Default value: 'periodic'
commitlog_sync_batch_window_in_ms
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file.
If commitlog_sync
is set to 'batch' then this value should be set.
Otherwise it should be set to undef.
Default value: undef
commitlog_sync_period_in_ms
This is passed to the cassandra.yaml file. If set to a value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file.
If commitlog_sync
is set to 'periodic' then this value should be set.
Otherwise it should be set to undef.
Default value: 10000
commitlog_total_space_in_mb
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
compaction_throughput_mb_per_sec
This is passed to the cassandra.yaml file. Default value: '16'
concurrent_counter_writes
This is passed to the cassandra.yaml file. Default value '32'
concurrent_reads
This is passed to the cassandra.yaml file. Default value '32'
concurrent_writes
This is passed to the cassandra.yaml file. Default value '32'
config_file_mode
The permissions mode of the cassandra configuration file. Default value '0666'
config_path
The path to the cassandra configuration file. If this is undef, it will be changed to /etc/cassandra/default.conf on the Red Hat family of operating systems or /etc/cassandra on Ubuntu. Otherwise the user can specify the path name. Default value undef
concurrent_compactors
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
counter_cache_save_period
This is passed to the cassandra.yaml file. Default value: '7200'
counter_cache_keys_to_save
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
counter_cache_size_in_mb
This is passed to the cassandra.yaml file. Default value: ''
counter_write_request_timeout_in_ms
This is passed to the cassandra.yaml file. Default value: '5000'
cross_node_timeout
This is passed to the cassandra.yaml file. Default value: 'false'
data_file_directories
This is passed to the cassandra.yaml file. Default value '['/var/lib/cassandra/data']'
data_file_directories_mode
The mode for the directories specified in data_file_directories
.
Default value '0750'
dc
Sets the value for dc in config_path/snitch_properties_file see http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. Default value 'DC1'
dc_suffix
Sets the value for dc_suffix in config_path/snitch_properties_file see http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. If the value is undef then change will be made to the snitch properties file for this setting. Default value undef
disk_failure_policy
This is passed to the cassandra.yaml file. Default value 'stop'
dynamic_snitch_badness_threshold
This is passed to the cassandra.yaml file. Default value: '0.1'
dynamic_snitch_reset_interval_in_ms
This is passed to the cassandra.yaml file. Default value: '600000'
dynamic_snitch_update_interval_in_ms
This is passed to the cassandra.yaml file. Default value: '100'
endpoint_snitch
This is passed to the cassandra.yaml file. Default value 'SimpleSnitch'
fail_on_non_supported_os
A flag that dictates if the module should fail if it is not RedHat or Debian.
If you set this option to false then you must also at least set the
config_path
parameter as well.
Default value 'true'
file_cache_size_in_mb
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
hinted_handoff_enabled
This is passed to the cassandra.yaml file. Default value 'true'
hinted_handoff_throttle_in_kb
This is passed to the cassandra.yaml file. Default value: '1024'
index_summary_capacity_in_mb
This is passed to the cassandra.yaml file. Default value: ''
index_summary_resize_interval_in_minutes
This is passed to the cassandra.yaml file. Default value: '60'
incremental_backups
This is passed to the cassandra.yaml file. Default value 'false'
initial_token
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
inter_dc_tcp_nodelay
This is passed to the cassandra.yaml file. Default value: 'false'
internode_authenticator
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
internode_compression
This is passed to the cassandra.yaml file. Default value 'all'
internode_recv_buff_size_in_bytes
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
internode_send_buff_size_in_bytes
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
key_cache_save_period
This is passed to the cassandra.yaml file. Default value: 14400
key_cache_size_in_mb
This is passed to the cassandra.yaml file. Default value: ''
key_cache_keys_to_save
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
listen_address
This is passed to the cassandra.yaml file. Default value 'localhost'
manage_dsc_repo
DEPRECATION WARNING: This option is deprecated. Please include the the ::cassandra::datastax_repo instead.
If set to true then a repository will be setup so that packages can be downloaded from DataStax community. Default value 'false'
max_hints_delivery_threads
This is passed to the cassandra.yaml file. Default value: '2'
max_hint_window_in_ms
This is passed to the cassandra.yaml file. Default value: '10800000'
memory_allocator
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
memtable_cleanup_threshold
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
memtable_flush_writers
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
memtable_heap_space_in_mb
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
memtable_offheap_space_in_mb
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
native_transport_max_concurrent_connections
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
native_transport_max_concurrent_connections_per_ip
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
native_transport_max_frame_size_in_mb
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
native_transport_max_threads
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
native_transport_port
This is passed to the cassandra.yaml file. Default value '9042'
num_tokens
This is passed to the cassandra.yaml file. Default value '256'
package_ensure
The status of the package specified in package_name. Can be present, latest or a specific version number. Default value 'present'
package_name
The name of the Cassandra package. Must be available from a repository. Default value 'dsc22'
partitioner
This is passed to the cassandra.yaml file. Default value 'org.apache.cassandra.dht.Murmur3Partitioner'
permissions_update_interval_in_ms
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
permissions_validity_in_ms
This is passed to the cassandra.yaml file. Default value: '2000'
phi_convict_threshold
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
prefer_local
Sets the value for prefer_local in config_path/snitch_properties_file see http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. Valid values are true, false or undef. If the value is undef then change will be made to the snitch properties file for this setting. Default value undef
rack
Sets the value for rack in config_path/snitch_properties_file see http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. Default value 'RAC1'
range_request_timeout_in_ms
This is passed to the cassandra.yaml file. Default value: '10000'
read_request_timeout_in_ms
This is passed to the cassandra.yaml file. Default value: '5000'
request_scheduler
This is passed to the cassandra.yaml file. Default value: 'org.apache.cassandra.scheduler.NoScheduler'
request_scheduler_options_default_weight
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
request_scheduler_options_throttle_limit
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
request_timeout_in_ms
This is passed to the cassandra.yaml file. Default value: '10000'
row_cache_keys_to_save
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
row_cache_save_period
This is passed to the cassandra.yaml file. Default value: '0'
row_cache_size_in_mb
This is passed to the cassandra.yaml file. Default value: '0'
rpc_address
This is passed to the cassandra.yaml file. Default value 'localhost'
rpc_max_threads
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
rpc_min_threads
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
rpc_port
This is passed to the cassandra.yaml file. Default value '9160'
rpc_recv_buff_size_in_bytes
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
rpc_send_buff_size_in_bytes
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
rpc_server_type
This is passed to the cassandra.yaml file. Default value 'sync'
saved_caches_directory
This is passed to the cassandra.yaml file. Default value '/var/lib/cassandra/saved_caches'
saved_caches_directory_mode
The mode for the directory specified in saved_caches_directory
.
Default value '0750'
seeds
This is passed to the
cassandra.yaml file.
The field being set is seed_provider -> parameters -> seeds
.
Default value '127.0.0.1'
seed_provider_class_name
This is passed to the
cassandra.yaml file.
The field being set is seed_provider -> class_name
.
Default value 'org.apache.cassandra.locator.SimpleSeedProvider'
server_encryption_algorithm
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is server_encryption_options -> algorithm
.
Default value: undef
server_encryption_cipher_suites
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is server_encryption_options -> cipher_suites
.
Default value: undef
server_encryption_internode
This is passed to the
cassandra.yaml file.
The field being set is server_encryption_options -> internode_encryption
.
Default value 'none'
server_encryption_keystore
This is passed to the
cassandra.yaml file.
The field being set is server_encryption_options -> keystore
.
Default value 'conf/.keystore'
server_encryption_keystore_password
This is passed to the
cassandra.yaml file.
The field being set is server_encryption_options -> keystore_password
.
Default value 'cassandra'
server_encryption_protocol
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is server_encryption_options -> protocol
.
Default value: undef
server_encryption_require_client_auth
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is server_encryption_options -> require_client_auth
.
Default value: undef
server_encryption_store_type
If left at the default value of undef then the entry in the configuration
file is absent or commented out. If a value is set, then the parameter
and variable are placed into the configuration file.
The field being set is server_encryption_options -> store_type
.
Default value: undef
server_encryption_truststore
This is passed to the
cassandra.yaml file.
The field being set is server_encryption_options -> truststore
.
Default value 'conf/.truststore'
server_encryption_truststore_password
This is passed to the
cassandra.yaml file.
The field being set is server_encryption_options -> truststore_password
.
Default value 'cassandra'
service_enable
Enable the Cassandra service to start at boot time. Valid values are true or false. Default value 'true'
service_ensure
Ensure the Cassandra service is running. Valid values are running or stopped. Default value 'running'
service_name
The name of the service that runs the Cassandra software. Default value 'cassandra'
service_refresh
If set to true, changes to the Cassandra config file or the data directories will ensure that Cassandra service is refreshed after the changes. Setting this flag to false will disable this behaviour, therefore allowing the changes to be made but allow the user to control when the service is restarted. Default value true
snapshot_before_compaction
This is passed to the cassandra.yaml file. Default value 'false'
snitch_properties_file
The name of the snitch properties file. The full path name would be config_path/snitch_properties_file. Default value 'cassandra-rackdc.properties'
ssl_storage_port
This is passed to the cassandra.yaml file. Default value '7001'
sstable_preemptive_open_interval_in_mb
This is passed to the cassandra.yaml file. Default value: '50'
start_native_transport
This is passed to the cassandra.yaml file. Default value 'true'
start_rpc
This is passed to the cassandra.yaml file. Default value 'true'
storage_port
This is passed to the cassandra.yaml file. Default value '7000'
streaming_socket_timeout_in_ms
This is passed to the cassandra.yaml file. If left at the default value of undef then the entry in the configuration file is absent or commented out. If a value is set, then the parameter and variable are placed into the configuration file. Default value: undef
tombstone_failure_threshold
This is passed to the cassandra.yaml file. Default value: '100000'
tombstone_warn_threshold
This is passed to the cassandra.yaml file. Default value: '1000'
trickle_fsync
This is passed to the cassandra.yaml file. Default value: 'false'
trickle_fsync_interval_in_kb
This is passed to the cassandra.yaml file. Default value: '10240'
truncate_request_timeout_in_ms
This is passed to the cassandra.yaml file. Default value: '60000'
write_request_timeout_in_ms
This is passed to the cassandra.yaml file. Default value: '2000'
Class: cassandra::datastax_agent
A class for installing the DataStax Agent and to point it at an OpsCenter instance.
Parameters
defaults_file
The full path name to the file where java_home
is set.
Default value '/etc/default/datastax-agent'
java_home
If the value of this variable is left as undef, no action is taken.
Otherwise the value is set as JAVA_HOME in defaults_file
.
Default value undef
package_ensure
Is passed to the package reference. Valid values are present or a version number. Default value 'present'
package_name
Is passed to the package reference. Default value 'datastax-agent'
service_ensure
Is passed to the service reference. Default value 'running'
service_enable
Is passed to the service reference. Default value 'true'
service_name
Is passed to the service reference. Default value 'datastax-agent'
stomp_interface
If the value is changed from the default of undef then this is what is set as the stomp_interface setting in /var/lib/datastax-agent/conf/address.yaml which connects the agent to an OpsCenter instance. Default value undef
Class: cassandra::datastax_repo
An optional class that will allow a suitable repository to be configured from which packages for DataStax Community can be downloaded. Changing the defaults will allow any Debian Apt or Red Hat Yum repository to be configured.
Parameters
descr
On the Red Hat family, this is passed as the descr
parameter to a
yumrepo
resource. On the Debian family, it is passed as the comment
parameter to an apt::source
resource.
Default value 'DataStax Repo for Apache Cassandra'
key_id
On the Debian family, this is passed as the id
parameter to an apt::key
resource. On the Red Hat family, it is ignored.
Default value '7E41C00F85BFC1706C4FFFB3350200F2B999A372'
key_url
On the Debian family, this is passed as the source
parameter to an
apt::key
resource. On the Red Hat family, it is ignored.
Default value 'http://debian.datastax.com/debian/repo_key'
pkg_url
If left as the default, this will set the baseurl
to
'http://rpm.datastax.com/community' on a yumrepo
resource
on the Red Hat family. On the Debian family, leaving this as the default
will set the location
parameter on an apt::source
to
'http://debian.datastax.com/community'. Default value undef
release
On the Debian family, this is passed as the release
parameter to an
apt::source
resource. On the Red Hat family, it is ignored.
Default value 'stable'
Class: cassandra::firewall_ports
An optional class to configure incoming network ports on the host that are relevant to the Cassandra installation. If firewalls are being managed already, simply do not include this module in your manifest.
IMPORTANT: The full list of which ports should be configured is assessed at evaluation time of the configuration. Therefore if one is to use this class, it must be the final cassandra class included in the manifest.
Parameters
client_ports
Only has any effect if the cassandra
class is defined on the node.
Allow these TCP ports to be opened for traffic coming from the client subnets. Default value '[9042, 9160]'
client_subnets
Only has any effect if the cassandra
class is defined on the node.
An array of the list of subnets that are to allowed connection to cassandra::native_transport_port and cassandra::rpc_port. Default value '['0.0.0.0/0']'
inter_node_ports
Only has any effect if the cassandra
class is defined on the node.
Allow these TCP ports to be opened for traffic between the Cassandra nodes. Default value '[7000, 7001, 7199]'
inter_node_subnets
Only has any effect if the cassandra
class is defined on the node.
An array of the list of subnets that are to allowed connection to cassandra::storage_port, cassandra::ssl_storage_port and port 7199 for cassandra JMX monitoring. Default value '['0.0.0.0/0']'
inter_node_ports
Allow these TCP ports to be opened for traffic coming from OpsCenter subnets. Default value '[7000, 7001, 7199]'
public_ports
Allow these TCP ports to be opened for traffic
coming from public subnets the port specified in $ssh_port
will be
appended to this list.
Default value '[8888]'
public_subnets
An array of the list of subnets that are to allowed connection to cassandra::firewall_ports::ssh_port and if cassandra::opscenter has been included, both cassandra::opscenter::webserver_port and cassandra::opscenter::webserver_ssl_port. Default value '['0.0.0.0/0']'
ssh_port
Which port does SSH operate on. Default value '22'
opscenter_ports
Only has any effect if the cassandra::datastax_agent
or
cassandra::opscenter
classes are defined.
Allow these TCP ports to be opened for traffic coming to or from OpsCenter appended to this list. Default value '[61620, 61621]'
opscenter_subnets
A list of subnets that are to be allowed connection to port 61620 for nodes built with cassandra::opscenter and 61621 for nodes built with cassandra::datastax_agent. Default value '['0.0.0.0/0']'
Class: cassandra::java
A class to install an appropriate Java package.
Parameters
ensure
Is passed to the package reference for the JRE/JDK package. Valid values are present or a version number. Default value 'present'
jna_ensure
Is passed to the package reference for the JNA package. Valid values are present or a version number. Default value 'present'
jna_package_name
If the default value of undef is left as it is, then a package called jna or libjna-java will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. Default value undef
package_name
If the default value of undef is left as it is, then a package called java-1.8.0-openjdk-headless or openjdk-7-jre-headless will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. Default value undef
Class: cassandra::opscenter
This class installs and manages the DataStax OpsCenter. Leaving the defaults as they are will provide a running OpsCenter without any authentication on port 8888.
Parameters
agents_agent_certfile
This sets the agent_certfile setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_agent_keyfile
This sets the agent_keyfile setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_agent_keyfile_raw
This sets the agent_keyfile_raw setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_config_sleep
This sets the config_sleep setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_fingerprint_throttle
This sets the fingerprint_throttle setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_incoming_interface
This sets the incoming_interface setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_incoming_port
This sets the incoming_port setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_install_throttle
This sets the install_throttle setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_not_seen_threshold
This sets the not_seen_threshold setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_path_to_deb
This sets the path_to_deb setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_path_to_find_java
This sets the path_to_find_java setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_path_to_installscript
This sets the path_to_installscript setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_path_to_rpm
This sets the path_to_rpm setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_path_to_sudowrap
This sets the path_to_sudowrap setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_reported_interface
This sets the reported_interface setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_runs_sudo
This sets the runs_sudo setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_scp_executable
This sets the scp_executable setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_ssh_executable
This sets the ssh_executable setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_ssh_keygen_executable
This sets the ssh_keygen_executable setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_ssh_keyscan_executable
This sets the ssh_keyscan_executable setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_ssh_port
This sets the ssh_port setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_ssh_sys_known_hosts_file
This sets the ssh_sys_known_hosts_file setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_ssh_user_known_hosts_file
This sets the ssh_user_known_hosts_file setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_ssl_certfile
This sets the ssl_certfile setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_ssl_keyfile
This sets the ssl_keyfile setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_tmp_dir
This sets the tmp_dir setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
agents_use_ssl
This sets the use_ssl setting in the agents section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
authentication_audit_auth
This sets the audit_auth setting in the authentication section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
authentication_audit_pattern
This sets the audit_pattern setting in the authentication section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
authentication_method
This sets the authentication_method setting in the authentication section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
authentication_enabled
This sets the enabled setting in the authentication section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value 'False'
authentication_passwd_db
This sets the passwd_db setting in the authentication section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
authentication_timeout
This sets the timeout setting in the authentication section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
cloud_accepted_certs
This sets the accepted_certs setting in the cloud section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
clusters_add_cluster_timeout
This sets the add_cluster_timeout setting in the clusters section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
clusters_startup_sleep
This sets the startup_sleep setting in the clusters section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
config_file
The full path to the OpsCenter configuration file. Default value '/etc/opscenter/opscenterd.conf'
definitions_auto_update
This sets the auto_update setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
definitions_definitions_dir
This sets the definitions_dir setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
definitions_download_filename
This sets the download_filename setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
definitions_download_host
This sets the download_host setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
definitions_download_port
This sets the download_port setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
definitions_hash_filename
This sets the hash_filename setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
definitions_sleep
This sets the sleep setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
definitions_ssl_certfile
This sets the ssl_certfile setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
definitions_use_ssl
This sets the use_ssl setting in the definitions section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ensure
This is passed to the package reference for opscenter. Valid values are present or a version number. Default value 'present'
failover_configuration_directory
This sets the failover_configuration_directory setting in the failover section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
failover_heartbeat_fail_window
This sets the heartbeat_fail_window setting in the failover section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
failover_heartbeat_period
This sets the heartbeat_period setting in the failover section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
failover_heartbeat_reply_period
This sets the heartbeat_reply_period setting in the failover section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
hadoop_base_job_tracker_proxy_port
This sets the base_job_tracker_proxy_port setting in the hadoop section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_admin_group_name
This sets the admin_group_name setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_connection_timeout
This sets the connection_timeout setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_debug_ssl
This sets the debug_ssl setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_group_name_attribute
This sets the group_name_attribute setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_group_search_base
This sets the group_search_base setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_group_search_filter
This sets the group_search_filter setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_group_search_type
This sets the group_search_type setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_ldap_security
This sets the ldap_security setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_opt_referrals
This sets the opt_referrals setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_protocol_version
This sets the protocol_version setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_search_dn
This sets the search_dn setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_search_password
This sets the search_password setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_server_host
This sets the server_host setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_server_port
This sets the server_port setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_ssl_cacert
This sets the ssl_cacert setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_ssl_cert
This sets the ssl_cert setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_ssl_key
This sets the ssl_key setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_tls_demand
This sets the tls_demand setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_tls_reqcert
This sets the tls_reqcert setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_uri_scheme
This sets the uri_scheme setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_user_memberof_attribute
This sets the user_memberof_attribute setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_user_search_base
This sets the user_search_base setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ldap_user_search_filter
This sets the user_search_filter setting in the ldap section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
logging_level
This sets the level setting in the logging section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
logging_log_length
This sets the log_length setting in the logging section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
logging_log_path
This sets the log_path setting in the logging section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
logging_max_rotate
This sets the max_rotate setting in the logging section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
logging_resource_usage_interval
This sets the resource_usage_interval setting in the logging section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
package_name
The name of the OpsCenter package. Default value 'opscenter'
provisioning_agent_install_timeout
This sets the agent_install_timeout setting in the provisioning section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
provisioning_keyspace_timeout
This sets the keyspace_timeout setting in the provisioning section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
provisioning_private_key_dir
This sets the private_key_dir setting in the provisioning section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_alert_on_repair_failure
This sets the alert_on_repair_failure setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_cluster_stabilization_period
This sets the cluster_stabilization_period setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_error_logging_window
This sets the error_logging_window setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_incremental_err_alert_threshold
This sets the incremental_err_alert_threshold setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_incremental_range_repair
This sets the incremental_range_repair setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_incremental_repair_tables
This sets the incremental_repair_tables setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_ks_update_period
This sets the ks_update_period setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_log_directory
This sets the log_directory setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_log_length
This sets the log_length setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_max_err_threshold
This sets the max_err_threshold setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_max_parallel_repairs
This sets the max_parallel_repairs setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_max_pending_repairs
This sets the max_pending_repairs setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_max_rotate
This sets the max_rotate setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_min_repair_time
This sets the min_repair_time setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_min_throughput
This sets the min_throughput setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_num_recent_throughputs
This sets the num_recent_throughputs setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_persist_directory
This sets the persist_directory setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_persist_period
This sets the persist_period setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_restart_period
This sets the restart_period setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_single_repair_timeout
This sets the single_repair_timeout setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_single_task_err_threshold
This sets the single_task_err_threshold setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
repair_service_snapshot_override
This sets the snapshot_override setting in the repair_service section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
request_tracker_queue_size
This sets the queue_size setting in the request_tracker section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
security_config_encryption_active
This sets the config_encryption_active setting in the security section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
security_config_encryption_key_name
This sets the config_encryption_key_name setting in the security section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
security_config_encryption_key_path
This sets the config_encryption_key_path setting in the security section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
service_enable
Enable the OpsCenter service to start at boot time. Valid values are true or false. Default value 'true'
service_ensure
Ensure the OpsCenter service is running. Valid values are running or stopped. Default value 'running'
service_name
The name of the service that runs the OpsCenter software. Default value 'opscenterd'
spark_base_master_proxy_port
This sets the base_master_proxy_port setting in the spark section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
stat_reporter_initial_sleep
This sets the initial_sleep setting in the stat_reporter section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
stat_reporter_interval
This sets the interval setting in the stat_reporter section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
stat_reporter_report_file
This sets the report_file setting in the stat_reporter section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
stat_reporter_ssl_key
This sets the ssl_key setting in the stat_reporter section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ui_default_api_timeout
This sets the default_api_timeout setting in the ui section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ui_max_metrics_requests
This sets the max_metrics_requests setting in the ui section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ui_node_detail_refresh_delay
This sets the node_detail_refresh_delay setting in the ui section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
ui_storagemap_ttl
This sets the storagemap_ttl setting in the ui section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
webserver_interface
This sets the interface setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value '0.0.0.0'
webserver_log_path
This sets the log_path setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
webserver_port
This sets the port setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value '8888'
webserver_ssl_certfile
This sets the ssl_certfile setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
webserver_ssl_keyfile
This sets the ssl_keyfile setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
webserver_ssl_port
This sets the ssl_port setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
webserver_staticdir
This sets the staticdir setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
webserver_sub_process_timeout
This sets the sub_process_timeout setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
webserver_tarball_process_timeout
This sets the tarball_process_timeout setting in the webserver section of the OpsCenter configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
Class: cassandra::opscenter::pycrypto
On the Red Hat family of operating systems, if one intends to use encryption for configuration values then the pycrypto library is required. This class will install it for the user. See http://docs.datastax.com/en/opscenter/5.2//opsc/configure/installPycrypto.html for more details.
This class has no effect when included on nodes that are not in the Red Hat family.
Parameters
ensure
This is passed to the package reference for pycrypto. Valid values are present or a version number. Default value 'present'
manage_epel
If set to true, the epel-release package will be installed. Default value 'false'
package_name
The name of the PyCrypto package. Default value 'pycrypto'
provider
The name of the provider of the pycrypto package. Default value 'pip'
reqd_pckgs
Packages that are required to install the pycrypto package. Default value '['python-devel', 'python-pip' ]'
Class: cassandra::optutils
A class to install the optional Cassandra tools package.
Parameters
ensure
Is passed to the package reference. Valid values are present or a version number. Default value 'present'
package_name
If the default value of undef is left as it is, then a package called cassandra22-tools or cassandra-tools will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. Default value undef
Defined Type cassandra::opscenter::cluster_name
With DataStax Enterprise, one can specify a remote keyspace for OpsCenter to store metric data (this is not available in the DataStax Community Edition).
Parameters
cassandra_seed_hosts
This sets the seed_hosts setting in the cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_api_port
This sets the api_port setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_bind_interface
This sets the bind_interface setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_connection_pool_size
This sets the connection_pool_size setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_connect_timeout
This sets the connect_timeout setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_cql_port
This sets the cql_port setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_keyspace
This sets the keyspace setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_local_dc_pref
This sets the local_dc_pref setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_password
This sets the password setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_retry_delay
This sets the retry_delay setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_seed_hosts
This sets the seed_hosts setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_send_rpc
This sets the send_rpc setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_ssl_ca_certs
This sets the ssl_ca_certs setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_ssl_client_key
This sets the ssl_client_key setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_ssl_client_pem
This sets the ssl_client_pem setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_ssl_validate
This sets the ssl_validate setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_used_hosts_per_remote_dc
This sets the used_hosts_per_remote_dc setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
storage_cassandra_username
This sets the username setting in the storage_cassandra section of the cluster_name.conf configuration file. See http://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html for more details. A value of undef will ensure the setting is not present in the file. Default value undef
Defined Type cassandra::firewall_ports::rule
A defined type to be used as a macro for setting host based firewall rules. This is not intended to be used by a user (who should use the API provided by cassandra::firewall_ports instead) but is documented here for completeness.
Parameters
title
A text field that contains the protocol name and CIDR address of a subnet.
port
The number(s) of the port(s) to be opened.
Defined Type cassandra::opscenter::setting
A defined type to be used as a macro for settings in the OpsCenter configuration file. This is not intended to be used by a user (who should use the API provided by cassandra::opscenter instead) but is documented here for completeness.
Parameters
service_name
The name of the service to be notified if a change is made to the configuration file. Typically this would by opscenterd.
path
The path to the configuration file. Typically this would by /etc/opscenter/opscenterd.conf.
section
The section in the configuration file to be added to (e.g. webserver).
setting
The setting within the section of the configuration file to changed (e.g. port).
value
The setting value to be changed to (e.g. 8888).
Limitations
Tested on the Red Hat family versions 6 and 7, Ubuntu 12.04 and 14.04, Debian 7 Puppet (CE) 3.7.5 and DSC 2.
From release 1.6.0 of this module, regular updates of the Cassandra 1.X template will cease and testing against this template will cease. Testing against the template for versions of Cassandra >= 2.X will continue.
Contributers
Contributions will be gratefully accepted. Please go to the project page, fork the project, make your changes locally and then raise a pull request. Details on how to do this are available at https://guides.github.com/activities/contributing-to-open-source.
Please also see the CONTRIBUTING.md page for project specific requirements.
Additional Contributers
Yanis Guenane (GitHub @spredzy) provided the Cassandra 1.x compatible template (see #11).
Amos Shapira (GitHub @amosshapira) fixed a bug in the requirements metadata that caused a problem with Puppetfile (see #34).
Dylan Griffith (GitHub @DylanGriffith) identified that the dependency for puppetlabs-apt was incorrect (see #87).
Sam Powers (GitHub @sampowers) reported a bug in the ability to set the running state of the Cassandra service and subsequently submitted a pull request with a fix (see #93).
@markasammut contributed a pull request to set the batch_size_warn_threshold_in_kb parameter (see #100).
@markasammut also contributed a pull request to restart the service if the datastax-agent package is upgraded (see #110).