cassandra
Version information
This version is compatible with:
- Puppet Enterprise >= 3.7.0 < 2015.4.0
- Puppet >= 3.0.0 < 5.0.0
- , , , , ,
This module has been deprecated by its author since Jan 5th 2018.
The author has suggested puppet-cassandra as its replacement.
Start using this module
Documentation
Cassandra
Table of Contents
- Overview
- Setup - The basics of getting started with Cassandra
- Usage - Configuration options and additional functionality
- Reference
- 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 cassandra22 on Red Hat and cassandra on Debian).
- Configures settings in ${config_path}/cassandra.yaml.
- On CentOS 7 if the
init
service provider is used, then cassandra is added as a system service. - Optionally ensures that the Cassandra service is enabled and running.
- On Debian systems:
- Optionally replace
/etc/init.d/cassandra
with a workaround for CASSANDRA-9822.
- Optionally replace
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_repo 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 Debian).
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::optutils class affects
- Optionally installs the Cassandra support tools (e.g. cassandra22-tools).
Upgrading
We follow SemVer Versioning and an update of the major release (i.e. from 1.Y.Z to 2.Y.Z) will indicate a significant change to the API which will most probably require a change to your manifest.
Changes in 2.0.0
This is a major change to the API and you will more than likely need to change your manifest to accomodate these changes.
The service_ensure
attribute of the cassandra class now defaults to
undef, users who do want to manage service status in Puppet can still set
it to true. If leaving the value at the default and setting
service_refresh
and service_enable
to false will mean that the
user and not Puppet running will control the running state of
Cassandra. This currently works OK on the Red Hat family, but
has issues on Debian due to
CASSANDRA-2356
during an initial install or package upgrade.
All the functionality relating to OpsCenter has been divested to the locp/opscenter module on Puppet Forge.
It should also be noted that the module no longer creates directories for
the data
, commitlog
, saved_caches
and for Cassandra 3 the hints
directory. These resources will now need to be defined in your
manifest/profile.
For a list of features that have been deprecated in this release, please see https://github.com/locp/cassandra/wiki/Deprecations
For details on migrating from the version 1.X.X attributes to the settings
hash, see
https://github.com/locp/cassandra/wiki/Version-1.X.Y-Template-Defaults-Shown-As-2.X.Y-Hash
Please also see the notes for 2.0.0 in the CHANGELOG.
Changes in 1.19.0
The hints_directory documentation will cause a change in the cassandra.yaml file regardless of the value you set it to. If you do not wish this to result in a refesh of the Cassandra service, please set service_refresh to false.
Changes in 1.9.2
Now that Cassandra 3 is available from the DataStax repositories, there is a problem (especially on Debian) with the operating system package manager attempting to install Cassandra 3. This can be mitigated against using something similar to the code in this modules acceptance test. Please note that the default Cassandra package name has now been changed from 'dsc'. See the documentation for cassandra::package_name below for details.
if $::osfamily == 'RedHat' {
$version = '2.2.4-1'
} else {
$version = '2.2.4'
}
class { 'cassandra':
package_ensure => $version,
}
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.
Beginning with Cassandra
This code will install Cassandra onto a system and create a basic keyspace, table and index.
# Cassandra pre-requisites
include cassandra::datastax_repo
include cassandra::java
# Create a cluster called MyCassandraCluster which uses the
# GossipingPropertyFileSnitch. In this very basic example
# the node itself becomes a seed for the cluster.
class { 'cassandra':
authenticator => 'PasswordAuthenticator',
cluster_name => 'MyCassandraCluster',
endpoint_snitch => 'GossipingPropertyFileSnitch',
listen_address => $::ipaddress,
seeds => $::ipaddress,
require => Class['cassandra::datastax_repo', 'cassandra::java'],
}
class { 'cassandra':
settings => {
'authenticator' => 'PasswordAuthenticator',
'cluster_name' => 'MyCassandraCluster',
'commitlog_directory' => '/var/lib/cassandra/commitlog',
'commitlog_sync' => 'periodic',
'commitlog_sync_period_in_ms' => 10000,
'data_file_directories' => ['/var/lib/cassandra/data'],
'endpoint_snitch' => 'GossipingPropertyFileSnitch',
'listen_address' => $::ipaddress,
'partitioner' => 'org.apache.cassandra.dht.Murmur3Partitioner',
'saved_caches_directory' => '/var/lib/cassandra/saved_caches',
'seed_provider' => [
{
'class_name' => 'org.apache.cassandra.locator.SimpleSeedProvider',
'parameters' => [
{
'seeds' => $::ipaddress,
},
],
},
],
'start_native_transport' => true,
},
require => Class['cassandra::datastax_repo', 'cassandra::java'],
}
Usage
Setup a keyspace and users
We assume that authentication has been enabled for the cassandra cluster and we are connecting with the default user name and password ('cassandra/cassandra').
In this example, we create a keyspace (mykeyspace) with a table called 'users' and an index called 'users_lname_idx'.
We also add three users (to Cassandra, not the mykeyspace.users table) called spillman, akers and boone. We also ensure that a user called lucan is absent.
class { 'cassandra':
...
}
class { 'cassandra::schema':
cqlsh_password => 'cassandra',
cqlsh_user => 'cassandra',
cqlsh_host => $::ipaddress,
indexes => {
'users_lname_idx' => {
table => 'users',
keys => 'lname',
keyspace => 'mykeyspace',
},
},
keyspaces => {
'mykeyspace' => {
durable_writes => false,
replication_map => {
keyspace_class => 'SimpleStrategy',
replication_factor => 1,
},
}
},
tables => {
'users' => {
columns => {
user_id => 'int',
fname => 'text',
lname => 'text',
'PRIMARY KEY' => '(user_id)',
},
keyspace => 'mykeyspace',
},
},
users => {
'spillman' => {
password => 'Niner27',
},
'akers' => {
password => 'Niner2',
superuser => true,
},
'boone' => {
password => 'Niner75',
},
'lucan' => {
'ensure' => absent
},
},
}
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_interface => "eth1",
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 attribute 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 attribute) as RAC1 is the default value. Again, do not forget to either set auto_bootstrap to true or not set the attribute at all after initializing the cluster.
Reference
Public Classes
- cassandra
- cassandra::datastax_agent
- cassandra::datastax_repo
- cassandra::firewall_ports
- cassandra::java
- cassandra::optutils
- cassandra::schema
Public Defined Types
- cassandra::file
- cassandra::schema::cql_type
- cassandra::schema::index
- cassandra::schema::keyspace
- cassandra::schema::table
- cassandra::schema::user
Private Defined Types
Attributes
A class for installing the Cassandra package and manipulate settings in the configuration file.
Class: cassandra
cassandra_2356_sleep_seconds
This will provide a workaround for CASSANDRA-2356 by sleeping for the specifed number of seconds after an event involving the Cassandra package.
This option is silently ignored on the Red Hat family of operating systems as this bug only affects Debian systems. Default value 5
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 Debian 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. There is also cassandra20.yaml.erb that is more suitable for use with Cassandra 2.0. Default value 'cassandra/cassandra.yaml.erb'
config_file_mode
The permissions mode of the cassandra configuration file. Default value '0644'
config_path
The path to the cassandra configuration file. Default value /etc/cassandra/default.conf on Red Hat or /etc/cassandra on Debian.
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
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
attribute as well.
Default value 'true'
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 which must be available from a repository. Default value cassandra22 on the Red Hat family of operating systems or cassandra on Debian.
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'
rackdc_tmpl
The template for creating the snitch properties file. Default value 'cassandra/cassandra-rackdc.properties.erb'
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_provider
The name of the provider that runs the service. If left as undef then the OS family specific default will be used, otherwise the specified value will be used instead. Default value undef
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
settings
A hash that is passed to to_yaml
which dumps the results to the Cassandra
configuring file. The minimum required settings for Cassandra 2.X
are as follows:
{
'authenticator' => 'PasswordAuthenticator',
'cluster_name' => 'MyCassandraCluster',
'commitlog_directory' => '/var/lib/cassandra/commitlog',
'commitlog_sync' => 'periodic',
'commitlog_sync_period_in_ms' => 10000,
'data_file_directories' => ['/var/lib/cassandra/data'],
'endpoint_snitch' => 'GossipingPropertyFileSnitch',
'listen_address' => $::ipaddress,
'partitioner' => 'org.apache.cassandra.dht.Murmur3Partitioner',
'saved_caches_directory' => '/var/lib/cassandra/saved_caches',
'seed_provider' => [
{
'class_name' => 'org.apache.cassandra.locator.SimpleSeedProvider',
'parameters' => [
{
'seeds' => $::ipaddress,
},
],
},
],
'start_native_transport' => true,
}
For Cassandra 3.X you will also need to specify the hints_directory
attribute.
Default value {}
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'
Class: cassandra::datastax_agent
A class for installing the DataStax Agent and to point it at an OpsCenter instance.
In this example set agent_alias to foobar, stomp_interface to localhost and ensure that async_pool_size is absent from the file:
class { 'cassandra::datastax_agent':
settings => {
'agent_alias' => {
'setting' => 'agent_alias',
'value' => 'foobar',
},
'stomp_interface' => {
'setting' => 'stomp_interface',
'value' => 'localhost',
},
'async_pool_size' => {
'ensure' => absent,
},
},
}
address_config_file
The full path to the address config file. Default value '/var/lib/datastax-agent/conf/address.yaml'
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'
service_provider
The name of the provider that runs the service. If left as undef then the OS family specific default will be used, otherwise the specified value will be used instead. Default value undef
settings
A hash that is passed to create_ini_settings with the following additional defaults:
{
path => $address_config_file,
key_val_separator => ': ',
require => Package[$package_name],
notify => Service['datastax-agent'],
}
Default value {}
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.
descr
On the Red Hat family, this is passed as the descr
attribute to a
yumrepo
resource. On the Debian family, it is passed as the comment
attribute to an apt::source
resource.
Default value 'DataStax Repo for Apache Cassandra'
key_id
On the Debian family, this is passed as the id
attribute 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
attribute 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
attribute on an apt::source
to
'http://debian.datastax.com/community'. Default value undef
release
On the Debian family, this is passed as the release
attribute to an
apt::source
resource. On the Red Hat family, it is ignored.
Default value 'stable'
Defined Type: cassandra::file
A definition for altering files relative to the configuration directory. For example set the MAX_HEAP_SIZE and and HEAP_NEWSIZE for the JVM depending on the memory and number of processors on the node:
if $::memorysize_mb < 24576.0 {
$max_heap_size_in_mb = floor($::memorysize_mb / 2)
} elsif $::memorysize_mb < 8192.0 {
$max_heap_size_in_mb = floor($::memorysize_mb / 4)
} else {
$max_heap_size_in_mb = 8192
}
$heap_new_size = $::processorcount * 100
cassandra::file { "Set Java/Cassandra max heap size to ${max_heap_size_in_mb}.":
file => 'cassandra-env.sh',
file_lines => {
'MAX_HEAP_SIZE' => {
line => "MAX_HEAP_SIZE='${max_heap_size_in_mb}M'",
match => '^#?MAX_HEAP_SIZE=.*',
},
}
}
cassandra::file { "Set Java/Cassandra heap new size to ${heap_new_size}.":
file => 'cassandra-env.sh',
file_lines => {
'HEAP_NEWSIZE' => {
line => "HEAP_NEWSIZE='${heap_new_size}M'",
match => '^#?HEAP_NEWSIZE=.*',
}
}
}
file
The name of the file relative to the config_path
. This defaults to the
title of the definition.
config_path
The path to the configuration directory. On the RedHat family this will
default to /etc/cassandra/default.conf
on Debian, the
default is /etc/cassandra
.
file_lines
If set, then the create_resources
will be used to create an array of
file_line resources
where the path attribute is set to ${config_path}/${file}
Default undef
service_refresh
If the Cassandra service is to be notified if the environment file is changed. Set to false if this is not wanted. Default value true.
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.
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_ports
Allow these TCP ports to be opened for traffic coming from OpsCenter subnets. 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']'
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. 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
is defined.
Allow these TCP ports to be opened for traffic coming to or from OpsCenter appended to this list. Default value [9042, 9160, 61620, 61621]
opscenter_subnets
A list of subnets that are to be allowed connection to port 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.
aptkey
If supplied, this should be a hash of apt::key resources that will be passed to the create_resources function. This is ignored on non-Debian systems. Default value undef
aptsource
If supplied, this should be a hash of apt::source resources that will be passed to the create_resources function. This is ignored on non-Red Hat systems. Default value undef
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
The name of the JNA package. Default value jna or libjna-java will be installed on a Red Hat family or Debian system respectively.
package_ensure
Is passed to the package reference for the JRE/JDK package. Valid values are present or a version number. Default value 'present'
package_name
The name of the Java package to be installed. Default value java-1.8.0-openjdk-headless on Red Hat openjdk-7-jre-headless on Debian.
yumrepo
If supplied, this should be a hash of yumrepo resources that will be passed to the create_resources function. This is ignored on non-Red Hat systems. Default value undef
Class: cassandra::optutils
A class to install the optional Cassandra tools package.
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
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 Debian system respectively. Alternatively, one can specify a package that is available in a package repository to the node. Default value undef
Class: cassandra::schema
A class to maintain the database schema. Please note that cqlsh expects Python 2.7 to be installed. This may be a problem of older distributions (CentOS 6 for example).
connection_tries
How many times do try to connect to Cassandra. See also connection_try_sleep
.
Default value 6
connection_try_sleep
How much time to allow between the number of tries specified in
connection_tries
.
Default value 30
cql_types
Creates new cassandra::schema::cql_type
resources. Valid options: a hash to
be passed to the create_resources
function. Default: {}.
cqlsh_additional_options
Any additional options to be passed to the cqlsh command.
Default value ''
cqlsh_client_config
Set this to a file name (e.g. /root/.puppetcqlshrc) that will then be used to contain the credentials for connecting to Cassandra. This is a more secure option than having the credentials appearing on the command line. This option is only available in Cassandra 2.1.
Default value undef
cqlsh_client_tmpl
The location of the template for configuring the credentials for the cqlsh
client. This is ignored unless cqlsh_client_config
is set.
Default value 'cassandra/cqlshrc.erb'
cqlsh_command
The full path to the cqlsh command.
Default value '/usr/bin/cqlsh'
cqlsh_host
The host for the cqlsh command to connect to. See also cqlsh_port
.
Default value 'localhost'
cqlsh_password
If credentials are require for connecting, specify the password here.
See also cqlsh_user
. See also cqlsh_client_config
.
Default value undef
cqlsh_port
The host for the cqlsh command to connect to. See also cqlsh_host
.
See also cqlsh_host
.
Default value 9042
cqlsh_user
If credentials are require for connecting, specify the password here.
See also cqlsh_password
. See also cqlsh_client_config
.
Default value 'cassandra'
indexes
Creates new cassandra::schema::indexes
resources. Valid options: a hash to
be passed to the create_resources
function. Default: {}.
keyspaces
Creates new cassandra::schema::keyspace
resources. Valid options: a hash to
be passed to the create_resources
function. Default: {}.
tables
Creates new cassandra::schema::table
resources. Valid options: a hash to
be passed to the create_resources
function. Default: {}.
users
Creates new cassandra::schema::user
resources. Valid options: a hash to
be passed to the create_resources
function. Default: {}.
Defined Type cassandra::schema::cql_type
Create or drop user defined data types within the schema. Please see the Begining with Cassandra section of this document.
keyspace
The name of the keyspace that the data type is to be associated with.
ensure
Valid values can be present to ensure a data type is created, or absent to ensure it is dropped.
fields
A hash of the fields that will be components for the data type. See the example earlier in this document for the layout of the hash.
cql_type_name
The name of the CQL type to be created. Defaults to the title of the resource.
Defined Type cassandra::schema::index
Create or drop indexes within the schema. Please see the Begining with Cassandra section of this document.
ensure
Valid values can be present to ensure an index is created, or absent to ensure it is dropped.
class_name
The name of the class to be associated with an index when creating a custom index.
Default value undef
index
The name of the index. Defaults to the name of the resource. Set to undef if the index is not to have a name.
keys
The columns that the index is being created on.
Default value undef
keyspace
The name of the keyspace that the index is to be associated with.
options
Any options to be added to the index.
Default value undef
table
The name of the table that the index is to be associated with.
Defined Type cassandra::schema::keyspace
Create or drop keyspaces within the schema. Please see the example code in the Begining with Cassandra section of this document.
ensure
Valid values can be present to ensure a keyspace is created, or absent to ensure it is dropped.
durable_writes
When set to false, data written to the keyspace bypasses the commit log. Be careful using this option because you risk losing data. Set this attribute to false on a keyspace using the SimpleStrategy. Default value true.
keyspace_name
The name of the keyspace to be created. Defaults to the name of the resource.
replication_map
Needed if the keyspace is to be present. Optional if it is to be absent. Can be something like the following:
$network_topology_strategy = {
keyspace_class => 'NetworkTopologyStrategy',
dc1 => 3,
dc2 => 2
}
Defined Type cassandra::schema::table
Create or drop tables within the schema. Please see the example code in the Begining with Cassandra section of this document.
keyspace
The name of the keyspace. This value is taken from the title given to the
cassandra::schema::keyspace
resource.
columns
A hash of the columns to be placed in the table. Optional if the table is to be absent.
Default value {}
ensure
Valid values can be present to ensure a keyspace is created, or absent to ensure it is dropped.
Default value present
options
Options to be added to the table creation.
Default value []
table
The name of the table. Defaults to the name of the resource.
Defined Type cassandra::schema::user
Create or drop users. Please see the example code in the
Begining with Cassandra section of this document.
To use this class, a suitable authenticator
(e.g. PasswordAuthenticator)
must be set in the Cassandra class.
ensure
Valid values can be present to ensure a user is created, or absent to remove the user if it exists. Default value true.
password
A password for the user. Default value undef.
superuser
If the user is to be a super-user on the system. Default value false.
user_name
The name of the user. Defaults to the title of the resource.
Defined Type cassandra::private::deprecation_warning
A defined type to handle deprecation messages to the user. This is not intended to be used by a user but is documented here for completeness.
item_number
A unique reference number for the specific deprecation.
Defined Type cassandra::private::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.
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.
Limitations
When using a Ruby version before 1.9.0, the contents of the Cassandra configuration file may change order of elementsdue to a problem with to_yaml in earlier versions of Ruby.
When creating key spaces, indexes, cql_types and users the settings will only be used to create a new resource if it does not currently exist. If a change is made to the Puppet manifest but the resource already exits, this change will not be reflected.
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
Release | PR/Issue | Contributer |
---|---|---|
2.0.0 | #266 | @stanleyz |
1.25.2 | #269 | @ahharu |
1.25.1 | #264 | @pampelix |
1.25.0 | #261 | @tibers |
1.24.0 | #247 | @ericy-jana |
1.24.0 | #246 | @ericy-jana |
1.24.0 | #245 | @ericy-jana |
1.23.0 | #235 | @tibers |
1.22.1 | #233 | @tibers |
1.22.1 | #232 | @tibers |
1.21.0 | #226 | @tibers |
1.20.0 | #217 | @samyray |
1.19.0 | #215 | @tibers |
1.18.0 | #203 | @Mike-Petersen |
1.15.0 | #189 | @tibers |
1.14.0 | #171 | @jonen10 |
1.13.0 | #166 | @Mike-Petersen |
1.13.0 | #163 | @VeriskPuppet |
1.12.2 | #165 | @palmertime |
1.12.0 | #156 | @stuartbfox |
1.12.0 | #153 | @Mike-Petersen |
1.10.0 | #144 | @Mike-Petersen |
1.9.2 | #136 | @mantunovic |
1.9.2 | #136 | @al4 |
1.4.2 | #110 | @markasammut |
1.4.0 | #100 | @markasammut |
1.3.5 | #93 | @sampowers |
1.3.3 | #87 | @DylanGriffith |
0.4.2 | #34 | @amosshapira |
0.3.0 | #11 | @spredzy |
Change Log for Puppet Module locp-cassandra
##2016-09-29 - Release 2.0.0 (diff)
Summary
This is a major release and will more than likely break your existing manifest until you alter your code. Please see the Upgrading section of the README for further details.
- The method of passing parameters to Cassandra has been made more flexible.
- Support for Ubuntu 16.04.
- Changes to how
service_ensure
is handled. cassandra::file
is now a define, not a class (as it should have been).
##2016-09-03 - Release 1.25.2 (diff)
Summary
The service_systemd
attribute is now deprecated for the cassandra
,
cassandra::datastax_agent
and cassandra::opscenter
classes. See
https://github.com/locp/cassandra/wiki/DEP-020 for more details.
##2016-08-14 - Release 1.25.1 (diff)
Summary
Bugfix to ensure that the name of the PID file for the DataStax Agent service matches with the service name.
##2016-07-17 - Release 1.25.0 (diff)
Summary
A feature release.
Features
- The
cassandra
class now has adisk_access_mode
attribute.
##2016-06-26 - Release 1.24.3 (diff)
Summary
A couple of non-functional bug fixes.
Bugfixes
- The new version of RuboCop flagged code changes required in the Vagrantfile.
- The new version of Puppet Lint flagged code changes required in cassandra::java.
##2016-06-20 - Release 1.24.2 (diff)
Summary
A non-functional bug fix.
Bugfixes
- The release of the specinfra gem (2.59.1) caused problems with our build. Pinned now to 2.59.0.
##2016-06-18 - Release 1.24.1 (diff)
Summary
Really only affects CentOS 7 as all the other supported operating systems do not require the systemd file to be installed.
Bugfixes
- Change the way that systemd shuts Cassandra down.
##2015-05-25 - Release 1.24.0 (diff)
Summary
A Debian-centric release. Debian 8 is now supported and a workaround for CASSANDRA-2356 (which only affects Debian.
Features
- New attributes to the
::cassandra
class are:- cassandra_2356_sleep_seconds
- config_path_parents
- rackdc_tmpl
Bugfixes
- CASSANDRA-2356
Improvements
- Debian 8 is now part of the acceptance testing release process.
##2016-05-10 - Release 1.23.1 (diff)
Summary
A minor bugfix that fixes a problem that would only affect module developers, not users of the module.
Bugfixes
- Rubocop 0.4.0 is stricter so implemented changes that were flagged by it.
##2016-05-07 - Release 1.23.0 (diff)
Summary
A couple of new features, a non-functional improvement and a bugfix.
Features
- Added the cassandra::file class.
- Added the following attributes to the cassandra::schema class:
- cqlsh_client_tmpl
- cqlsh_client_config
Bugfixes
- Fixed a daft error that stopped beaker tests running on CentOS 7.
Improvements
- Improved how fast the beaker/acceptance tests are run from TravisCI.
##2016-05-03 - Release 1.22.1 (diff)
Summary
A non-functional release for a minor improvement and a bug fix.
Bugfixes
- Fixes a problem with resource ordering if the service_refresh attribute is set to false.
Improvements
- Test coverage in Coveralls is now back at 100% (https://coveralls.io/github/locp/cassandra).
##2016-04-25 - Release 1.22.0 (diff)
Summary
Two new features.
Features
- Allow the creation and dropping of users with the following:
- A new defined type cassandra::schema::user
- The new attribute cassandra::schema::users
- Allow the manipulation of the environment file with the new class cassandra::env.
##2016-04-20 - Release 1.21.0 (diff)
Summary
Some minor bug fixes. Also some features and improvements that allow acceptance tests to be run against Cassandra 3.
Features
-
Added the following attributes to cassandra::java:
- aptkey
- aptsource
- yumrepo
Bugfixes
- Corrected some errors in the README and CHANGELOG.
- Fixed problems with TravisCI builds.
- Fixed problems with CircleCI builds.
Improvements
- Acceptance testing of Cassandra 3.
##2016-04-13 - Release 1.20.0 (diff)
Summary
A minor release for client requirements.
Features
- Added the compaction_large_partition_warning_threshold_mb and memtable_allocation_type attributes to the cassandra class.
##2016-04-06 - Release 1.19.0 (diff)
Summary
A new template attribute and a couple of bug fixes.
Features
- The hints_directory attribute has been added to the cassandra class for placing into the template.
Bugfixes
- Some documentation errors that had been identified have been resolved.
- A problem with OpsCenter and systemd has been resolved. So far only CentOS 7 from the supported operating systems has been identified as being required to use systemd.
##2016-03-27 - Release 1.18.1 (diff)
Summary
Bug fixes and some minor and non-functional improvements.
Bugfixes
- Resource ordering clarified in the cassandra::schema class.
- The cqlsh command now attempts to connect to rpc_address, not the listen_address.
Improvements
- Optimised the CircleCI build process.
- Made some changes to the documentation to better reflect the new functionality delivered in 1.18.0.
##2016-03-26 - Release 1.18.0 (diff)
Summary
Some more functionality and sub-classes for cassandra::schema. Also some code and pipe-line improvements and a couple of bug fixes.
Features
-
The cassandra::schema class now has the following additional attributes:
- cql_types
- indexes
- tables
There are also corresponting defined types for those attributes:
- cassandra::schema::cql_type
- cassandra::schema::index
- cassandra::schema::table
-
The cassandra::opscenter class now has a new attribute called ldap_group_search_filter_with_dn.
Bugfixes
- In the firewalls class, an OpsCenter server also needs to connect to the Cassandra node it is monitoring as a client. The ports have been adjusted to allow this to happen.
- rspec-puppet version 2.4.0 was breaking our builds so pegged ourselves to 2.3.2.
Improvements
- Some minor and non-functional improvements to the build pipe-line.
- Carried out an audit using the Puppet plugin for SonarQube. The number of issues has been reduced from 227 (13 major, 214 minor) to 4 major issues of which 2 are false positives. The remaining issues will be resolved in 2.0.0.
##2016-03-22 - Release 1.17.0 (diff)
Summary
Another small change that is an emergency requirement for a client.
Features
- Added the
storage_keyspace
attribute to the cassandra::datastax_agent class.
##2016-03-15 - Release 1.16.0 (diff)
Summary
A smaller release than usual, but containing changes required for a client.
Features
- Added the
hosts
attribute to the cassandra::datastax_agent class.
Bugfixes
- The address.yaml file for the DataStax agent is now owned by the cassandra user.
##2016-03-11 - Release 1.15.1 (diff)
Summary
A small improvement.
Improvements
- Clarified CQL and Python versions.
##2016-03-10 - Release 1.15.0 (diff)
Summary
A rather large release. Minor (non-functional) fixes to the production pipeline and new features.
Features
-
A new class
cassandra::schema
allows the creation and dropping of keyspaces. -
Added the
additional_lines
attribute to thecassandra
class. -
Added the
service_systemd
attribute to thecassandra::opscenter
class. -
Allow the systemd template sources to be specified by the user. This is with the
service_systemd_tmpl
attribute to the following classes:- cassandra
- cassandra::datastax_agent
- cassandra::opscenter
-
Added another template file for
cassandra
=>service_systemd_tmpl
that is suitable for Cassandra 2.0.
Bugfixes
- Worked around a problem with rake-11 in the Gemfile.
- Fixed a problem in the CircleCI configuration.
Improvements
-
Renamed the
ensure
attribute topackage_ensure
so that it is more in line with how it's called in other modules. This was done on the the following classes:- cassandra::optutils
- cassandra::opscenter
- cassandra::opscenter::pycrypto
- cassandra::java
-
Updated the AWS AMI for the TravisCI/AWS acceptance testing to hopefully speed up builds a bit.
##2016-02-29 - Release 1.14.2 (diff)
Summary
A small bugfix release.
Bugfixes
- Removed
Restart=always
from the Systemd configuration files.
##2016-02-27 - Release 1.14.1 (diff)
Summary
A non-functional release of improvements and a bugfix.
Bugfixes
- If a systemd service file is created or updated, then systemctl daemon-reload is now be executed.
Improvements
- The workflow for building the module has been improved to include:
- Automatic integration of improvements and bugfixes into release candidates.
- Testing of release candidates includes acceptance (beaker) as well as unit (spec) tests.
- The refactoring of the majority of the Ruby code used to test and build this module so that it is hopefully more readable and easier to maintain.
- The automation of what had previously been manual steps when building a release.
##2016-02-19 - Release 1.14.0 (diff)
Summary
A minor release with one of each of a feature, bug fix and improvement.
Features
- Added the orbited_longpoll attribute to the cassandra::opscenter class.
Bugfixes
- Fixed a problem with the DataStax agent and systemd.
Improvements
- Refactored the contributors section of the README.
##2016-02-14 - Release 1.13.0 (diff)
Summary
A mixed back of new features in the shape of attributes for the cassandra, cassandra::datastax_agent and cassandra::opscenter classes. A couple of bug fixes and some non-functional improvements.
Features
- Added the thrift_framed_transport_size_in_mb attribute to ::cassandra.
- Added the following attributes to ::cassandra::datastax_agent:
- async_pool_size
- async_queue_size
- service_systemd
- Added the config_purge attribute to ::cassandra::opscenter.
Bugfixes
- Removed incorrect puppet code from the README examples.
- Fixed a problem with the beaker 2.34.0 gem which was causing problems during automated acceptance testing.
Improvements
- Changed the AWS instance type used by the TravisCI triggered acceptance tests from a c3.xlarge to c4.xlarge.
- Merged the acceptance tests virtual nodes into family specific node sets.
- Refactored the Gemfile.
- Changed references in the documentation to parameters to refer to attributes as that is more Puppet-like.
- Changed the format of the contributers section.
##2016-02-12 - Release 1.12.2 (diff)
Summary
More bug fixes.
Bugfixes
- Fixed a problem with the Red Hat family and systemd not starting the service and reporting all service stops as failures, regardless of if they were or not.
##2016-02-08 - Release 1.12.1 (diff)
Summary
This is a non-functional release. Some bug fixes and release improvements.
Bugfixes
- Completed documentation for attributes. This was missing for the
inter_dc_stream_throughput_outbound_megabits_per_sec
andstream_throughput_outbound_megabits_per_sec
options. - Corrected the ownership and directories for the OpsCenter configuration.
Improvements
- Nightly build created so that issues similar to those found in issues #136 and #157 can be caught quicker.
##2016-01-27 - Release 1.12.0 (diff)
Summary
A new feature in the cassandra::datastax_agent class, a minor bug fix and integration with CircleCI.
Features
- There is now an agent_alias attribute for the cassandra::datastax_agent class.
Bugfixes
- Unit tests were failing due to problems with the puppet-3.8.5 gem.
Improvements
- In addition to TravisCI, the build process is now integrated with CircleCI.
##2016-01-01 - Release 1.11.0 (diff)
Summary
New features added to the main class. Also some non-functional improvements.
Features
- The addition of the listen_interface and rpc_interface attributes to the main class.
Improvements
- Added more detail to the attributes to the main class in the README.
- Improved the module metadata.
- Clarified private defined types with the private subclass.
- The test coverage in release 1.10.0 dropped to 99.09%. Got it back to 100% in this release.
##2015-12-19 - Release 1.10.0 (diff)
Summary
A feature release with minor improvements.
Features
- Added the ability to allow setting the local_interface for the DataStax agent configuration.
- Allow the service provider to be specified for the Cassandra, DataStax agent and OpsCenter services with the service_provider attribute.
- Optionally allow a systemd system file be inserted with the cassandra::service_systemd attribute.
Improvements
-
Allow the files resources specified with in the cassandra attributes:
- commitlog_directory
- data_file_directories
- saved_caches_directory
To co-exist with file resources with the same name.
##2015-11-21 - Release 1.9.2 (diff)
Summary
A bug fix release that deals with some problems with Cassandra 3.
Bugfixes
- Attempt to mitigate against problems with Debian attempting to install Cassandra 3 when installing the dsc22 package.
- Also reverted the project home to the GitHub project page.
##2015-11-09 - Release 1.9.1 (diff)
Summary
A bug fix release.
Bugfixes
- The default value for the permissions mode of the Cassandra configuration file were far too open. Changed from 0666 to 0644.
##2015-10-25 - Release 1.9.0 (diff)
Summary
Added more features for the configuration of Cassandra, some improvements to the testing carried out before a release and a minor correction to the change log documentation.
Features
-
The following attributes have been added to the ::cassandra class to be configured into the configuration file:
- client_encryption_algorithm
- client_encryption_cipher_suites
- client_encryption_protocol
- client_encryption_require_client_auth
- client_encryption_store_type
- client_encryption_truststore
- client_encryption_truststore_password
- counter_cache_size_in_mb
- index_summary_capacity_in_mb
- key_cache_save_period
- key_cache_keys_to_save
- seed_provider_class_name
- server_encryption_algorithm
- server_encryption_cipher_suites
- server_encryption_protocol
- server_encryption_require_client_auth
- server_encryption_store_type
Please see the README file for more details.
Bugfixes
- Corrected an incorrect date (typo) in this document.
Improvements
- There is now an automated test to mitigate the risk of unnecessarily refreshes of the Cassandra service due to non-functional changes to the configuration file.
##2015-10-14 - Release 1.8.1 (diff)
Summary
A minor bug fix.
Bugfixes
- Fixed an edge case issue concerning users that may have been using the fail_on_non_supported_os before it was fixed in 1.8.0.
##2015-10-06 - Release 1.8.0 (diff)
Summary
Some new features a minor bug fix and some non-functional improvements.
Features
- Added the service_refresh and config_file_mode attributes to the Cassandra class.
Bugfixes
- The name of the fail_on_non_supported_os attribute has been corrected.
Improvements
- Automated acceptance tests in preparation for a release now run faster.
##1015-10-01 - Release 1.7.1 (diff)
Summary
A minor bug fix that incorrctly gave a failed build status for the module.
Bugfixes
- Fixed a problem that was showing the status of the module build as an error since the release of the fog-google gem version 0.1.1.
##2015-10-01 - Release 1.7.0 (diff)
Summary
- Corrected a bug in how commitlog_sync has handled by Cassandra.
- Some non-functional improvements
- Additional features for the cassandra::datastax_repo class.
Features
-
Added the commitlog_segment_size_in_mb attribute to the cassandra class.
-
Added the following fields to the cassandra::datastax_repo class:
- descr
- key_id
- key_url
- pkg_url
- release
This should make the configuring of repositories more flexible.
Bugfixes
- Fixed a bug in how the commitlog_sync and the attributes that are associated with it are handled
Improvements
The following non-functional improvements were implemented:
- Added tags to the module metadata.
- Migrated the acceptance tests from Vagrant to Docker. The associated improvements to performance means that more rigorous acceptance tests can be applied in a shorter time. For the first time as well, they are visible on Travis.
##2015-09-23 - Release 1.6.0 (diff)
Summary
More attributes for ::cassandra and ::cassandra::datastax_agent. Also some non-functional improvements in the automated unit tests.
Features
- The JAVA_HOME can now be set for the datastax_agent (see the cassandra::datastax_agent => java_home attribute).
- The file mode for the directories can now be specified for the commitlog_directory, data_file_directories and the saved_caches_directory in the cassandra class.
Improvements
- Uncovered resources in the unit testing are now tested.
##2015-09-21 - Release 1.5.0 (diff)
Summary
More attributes have been added that can be configured into the cassandra.yaml file.
Features
- The following attributes to the cassandra class can be configured into
the cassandra configuration:
- broadcast_address
- broadcast_rpc_address
- commitlog_sync
- commitlog_sync_batch_window_in_ms
- commitlog_total_space_in_mb
- concurrent_compactors
- counter_cache_keys_to_save
- file_cache_size_in_mb
- initial_token
- inter_dc_stream_throughput_outbound_megabits_per_sec
- internode_authenticator
- internode_recv_buff_size_in_bytes
- internode_send_buff_size_in_bytes
- memory_allocator
- memtable_cleanup_threshold
- memtable_flush_writers
- memtable_heap_space_in_mb
- memtable_offheap_space_in_mb
- native_transport_max_concurrent_connections
- native_transport_max_concurrent_connections_per_ip
- native_transport_max_frame_size_in_mb
- native_transport_max_threads
- permissions_update_interval_in_ms
- phi_convict_threshold
- request_scheduler_options_default_weight
- request_scheduler_options_throttle_limit
- row_cache_keys_to_save
- rpc_max_threads
- rpc_min_threads
- rpc_recv_buff_size_in_bytes
- rpc_send_buff_size_in_bytes
- streaming_socket_timeout_in_ms
- stream_throughput_outbound_megabits_per_sec
Improvements
- Clarity of changes per release in the change log (this document).
##2015-09-15 - Release 1.4.2 (diff)
Summary
Fixed a problem identified whilst releasing 1.4.1 and a bug fixed by a contributed pull request.
Features
- n/a
Bugfixes
- Fixed a problem with the acceptance tests.
- The datastax-agent service is restarted if the package is updated.
Improvements
- n/a
##2015-09-15 - Release 1.4.1 (diff)
Summary
This release fixes a minor bug (possibly better described as a typing mistake) and makes some non-functional improvements. It also allows the user to override the default behaviour of failing on a non-supported operating system.
Features
- A new flag called
fail_on_non_suppoted_os
has been added to thecassandra
class and can be set to false so that an attempt can be made to use this module on an operating system that is not in the Debian or Red Hat families.
Bugfixes
- Changed the default value for the
package_name
of thecassandra::optutils
class from'undef'
to undef.
Improvements
- Clarified the expectations of submitted contributions.
- Unit test improvements.
##2015-09-10 - Release 1.4.0 (diff)
-
Ensured that directories specified in the directory attributes are controlled with file resources.
-
Added the following attributes to the cassandra.yml file:
- batchlog_replay_throttle_in_kb
- cas_contention_timeout_in_ms
- column_index_size_in_kb
- commit_failure_policy
- compaction_throughput_mb_per_sec
- counter_cache_save_period
- counter_write_request_timeout_in_ms
- cross_node_timeout
- dynamic_snitch_badness_threshold
- dynamic_snitch_reset_interval_in_ms
- dynamic_snitch_update_interval_in_ms
- hinted_handoff_throttle_in_kb
- index_summary_resize_interval_in_minutes
- inter_dc_tcp_nodelay
- max_hints_delivery_threads
- max_hint_window_in_ms
- permissions_validity_in_ms
- range_request_timeout_in_ms
- read_request_timeout_in_ms
- request_scheduler
- request_timeout_in_ms
- row_cache_save_period
- row_cache_size_in_mb
- sstable_preemptive_open_interval_in_mb
- tombstone_failure_threshold
- tombstone_warn_threshold
- trickle_fsync
- trickle_fsync_interval_in_kb
- truncate_request_timeout_in_ms
- write_request_timeout_in_ms
##2015-09-08 - Release 1.3.7 (diff)
- Made the auto_bootstrap attribute available.
##2015-09-03 - Release 1.3.6 (diff)
- Fixed a bug, now allowing the user to set the enabled state of the Cassandra service.
- More cleaning up of the README and more links in that file to allow faster navigation.
##2015-09-01 - Release 1.3.5 (diff)
- Fixed a bug, now allowing the user to set the running state of the Cassandra service.
- More automated testing with spec tests.
- A refactoring of the README.
##2015-08-28 - Release 1.3.4 (diff)
- Minor corrections to the README.
- The addition of the storage_cassandra_seed_hosts attribute to cassandra::opscenter::cluster_name which is part of a bigger part of work but is urgently require by a client.
##2015-08-27 - Release 1.3.3 (diff)
- Corrected dependency version for puppetlabs-apt.
##2015-08-26 - Release 1.3.2 (diff)
- Fixed bug in cassandra::opscenter::cluster_name.
- Fixed code in cassandra::firewall_ports::rule to avoid deprecation warnings concerning the use of puppetlabs-firewall => port.
- Added more examples to the README
##2015-08-22 - Release 1.3.1 (diff) This was mainly a non-functional change. The biggest thing to say is that Debian 7 is now supported.
##2015-08-19 - Release 1.3.0 (diff)
- Allow additional TCP ports to be specified for the host based firewall.
- Fixed a problem where the client subnets were ignored by the firewall.
- Added more automated testing.
- Continued work on an ongoing improvement of the documentation.
- Added the ability to set the DC and RACK in the snitch properties.
##2015-08-10 - Release 1.2.0 (diff)
- Added the installation of Java Native Access (JNA) to cassandra::java
- For DataStax Enterprise, allow the remote storage of metric data with cassandra::opscenter::cluster_name.
##2015-08-03 - Release 1.1.0 (diff)
- Provided the cassandra::firewall_ports class.
- All OpsCenter options are now configurable in opscenterd.conf.
- ssl_storage_port is now configurable.
##2015-07-27 - Release 1.0.1 (diff)
- Provided a workaround for CASSANDRA-9822.
##2015-07-25 - Release 1.0.0 (diff)
- Changed the default installation from Cassandra 2.1 to 2.2.
- Fixed a bug that arose when the cassandra config_path was set.
- Created a workaround for PUP-3829.
- Minor changes to the API (see the Upgrading section of the README).
- Allow a basic installation of OpsCenter.
##2015-07-18 - Release 0.4.3 (diff)
- Module dependency metadata was too strict.
##2015-07-16 - Release 0.4.2 (diff)
- Some minor documentation changes.
- Fixed a problem with the module metadata that caused Puppetfile issues.
- Integrated with Coveralls (https://coveralls.io/github/locp/cassandra).
- Removed the deprecated config and install classes. These were private so there is no change to the API.
##2015-07-14 - Release 0.4.1 (diff)
- Fixed a resource ordering problem in the cassandra::datastax class.
- Tidied up the documentation a bit.
- Some refactoring of the spec tests.
##2015-07-12 - Release 0.4.0 (diff)
Summary
- Some major changes to the API on how Java, the optional Cassandra tools and the DataStax agent are installed. See the Upgrading section of the README file.
- Allowed the setting of the stomp_interface for the DataStax agent.
- Non-functionally, we have integrated with Travis CI (see https://travis-ci.org/locp/cassandra for details) and thanks to those guys for providing such a neat service.
- More spec tests.
##2015-06-27 - Release 0.3.0 (diff)
Summary
- Slight changes to the API. See the Upgrading section of the README file for full details.
- Allow for the installation of the DataStax Agent.
- Improved automated testing (and fixed some bugs along the way).
- Confirmed Ubuntu 12.04 works OK with this module.
- A Cassandra 1.X template has been provided.
- Some smarter handling of the differences between Ubuntu/Debian and RedHat derivatives.
##2015-06-17 - Release 0.2.2 (diff)
Summary
A non-functional change to change the following:
- Split the single manifest into multiple files.
- Implement automated testing.
- Test on additional operating systems.
##2015-05-28 - Release 0.2.1 (diff)
Summary
A non-functional change to fix puppet-lint problems identified by Puppet Forge.
##2015-05-28 - Release 0.2.0 (diff)
Summary
Added more attributes and improved the module metadata.
##2015-05-26 - Release 0.1.0
Summary
An initial release with VERY limited options.
Dependencies
- puppetlabs-apt (>= 2.0.0 < 3.0.0)
- puppetlabs-firewall (>= 1.0.0 < 2.0.0)
- puppetlabs-inifile (>= 1.5.0 < 2.0.0)
- puppetlabs-stdlib (>= 3.0.0 < 5.0.0)
Copyright 2015, 2016 League of Crafty Programmers Ltd. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.