diff --git a/.travis.yml b/.travis.yml
index a33cd3e..63e34f8 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,30 +1,28 @@
---
env:
- "PUPPET_VERSION='~> 4.5' BEAKER_set=centos6_2"
- "PUPPET_VERSION='~> 4.5' BEAKER_set=centos6_3"
- "PUPPET_VERSION='~> 4.5' BEAKER_set=centos7"
- "PUPPET_VERSION='~> 4.5' BEAKER_set=debian7"
- "PUPPET_VERSION='~> 4.5' BEAKER_set=debian8"
- "PUPPET_VERSION='~> 4.5' BEAKER_set=ubuntu1204"
- "PUPPET_VERSION='~> 4.5' BEAKER_set=ubuntu1404"
- "PUPPET_VERSION='~> 4.5' BEAKER_set=ubuntu1604"
language: ruby
rvm:
- 2.3.1
cache: bundler
before_install: rm Gemfile.lock || true
bundler_args: --without development
dist: trusty
sudo: required
script:
- "bundle exec puppet --version"
- "bundle exec rake metadata_lint"
- "bundle exec rubocop"
- "bundle exec rake lint"
- "bundle exec rake validate"
- "bundle exec rake spec SPEC_OPTS='--format documentation'"
- "bundle exec rake acceptance"
notifications:
email: false
-matrix:
- fast_finish: true
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1383489..55e86b2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,1139 +1,1150 @@
# Change Log
+## [2.6.0](https://github.com/locp/cassandra/tree/2.6.0) (2017-09-11)
+[Full Changelog](https://github.com/locp/cassandra/compare/2.5.0...2.6.0)
+
+**Fixed bugs:**
+
+- Unit and acceptance tests are failing that have been successful in the past. [\#397](https://github.com/locp/cassandra/issues/397)
+
+**Merged pull requests:**
+
+- Implement apache_repo for RedHat [\#396](https://github.com/locp/cassandra/pull/396) ([stijnvdb](https://github.com/stijnvdb))
+
## [2.5.0](https://github.com/locp/cassandra/tree/2.5.0) (2017-05-31)
[Full Changelog](https://github.com/locp/cassandra/compare/2.4.1...2.5.0)
**Implemented enhancements:**
- Integration with github\_changelog\_generator [\#389](https://github.com/locp/cassandra/pull/389) ([dallinb](https://github.com/dallinb))
**Fixed bugs:**
- Tests failing for CentOS 6 on "Create schema for 2.1" [\#392](https://github.com/locp/cassandra/issues/392)
**Closed issues:**
- Rubocop failing tests since upgrade from 0.48.1 to 0.49.0 [\#391](https://github.com/locp/cassandra/issues/391)
**Merged pull requests:**
- Switch to role management instead of user one [\#388](https://github.com/locp/cassandra/pull/388) ([SergK](https://github.com/SergK))
## 2017-04-24 - Release 2.4.1 ([diff](https://github.com/locp/cassandra/compare/2.4.0...2.4.1))
### Summary
A non-functional release of improvements.
### Improvements
* A refactoring and extension of the acceptance tests.
* Migrated from version 1.0 to 2.0 of the CircleCI API.
## 2017-03-30 - Release 2.4.0 ([diff](https://github.com/locp/cassandra/compare/2.3.0...2.4.0))
### Summary
* Added the `cassandra::dse` class to 2.X.Y of the module.
* Added the new `cassandra::apache_repo` class.
* Minor bug fixes and improvements.
## 2017-02-28 - Release 1.27.0 ([diff](https://github.com/locp/cassandra/compare/1.26.1...1.27.0))
### Summary
Add the `cassandra::dse` class.
## 2017-01-21 - Release 2.3.0 ([diff](https://github.com/locp/cassandra/compare/2.2.1...2.3.0))
New attribute to `::cassandra` class:
* `baseline_settings`
New defined types:
* `cassandra::system::swapoff`
* `cassandra::system::sysctl`
* `cassandra::system::transparent_hugepage`
## 2016-12-08 - Release 2.2.1 ([diff](https://github.com/locp/cassandra/compare/2.2.0...2.2.1))
### Summary
Non-functional improvements and some documentation fixes.
### Improvements
* All beaker spec tests have been migrated from AWS/EC2 to Docker.
* Installed Python 2.7 onto the CentOS 6 docker image allowing the full test
suite to be run against that operating system.
* Some documentation improvements and fixed some typos.
* The spec tests will now fail if there is not 100% coverage.
## 2016-12-01 - Release 2.2.0 ([diff](https://github.com/locp/cassandra/compare/2.1.2...2.2.0))
### Summary
At long last we have a defined type for handling permissions (something that
we have been promising since May). Added some more facts for assisting
in JVM tuning. Also fixed an error that was happening when attempting to
build the project.
### Features
* Added the `permissions` attribute to the `cassandra::schema` class.
* Added the `cassandra::schema::permission`
### Bugfixes
* Some refactoring of the ruby code since the release of Rubocop 0.46.0 which
was failing code that previously had passed OK.
## 2016-11-02 - Release 2.1.2 ([diff](https://github.com/locp/cassandra/compare/2.1.1...2.1.2))
### Summary
Basically a non-functional release to reduce some of the technical debt
from the 2.0.0 release. Also some minor improvements to the documentation.
## 2016-11-19 - Release 1.26.1 ([diff](https://github.com/locp/cassandra/compare/1.26.0...1.26.1))
### Summary
Retro-fitted a bug that was fixed in 2.1.1 into the 1.X.Y version of the module.
### Bugfixes
* A hotfix for a bug in `cassandra::schema` that has been around since version 1.18.0 of this
module.
## 2016-11-02 - Release 2.1.1 ([diff](https://github.com/locp/cassandra/compare/2.1.0...2.1.1))
### Summary
A hotfix for a bug in `cassandra::schema` that has been around since version 1.18.0 of this
module.
### Bugfixes
* Fixed a bug where cql_types would not be created unless keyspaces were also provided.
* Fixed a minor typo in the README.
## 2016-10-29 - Release 2.1.0 ([diff](https://github.com/locp/cassandra/compare/2.0.2...2.1.0))
### Summary
A mixture of new features, a new style of documentation and other
improvements. Also ran the [Sonar-Puppet](https://github.com/iwarapter/sonar-puppet)
plugin against the code to improve the code quality.
### Features
* The following facts are now available:
* cassandramajorversion
* cassandraminorversion
* cassandrapatchversion
* cassandrarelease
* The following attributes are now available:
* cassandra::commitlog_directory
* cassandra::commitlog_directory_mode
* cassandra::data_file_directories
* cassandra::data_file_directories_mode
* cassandra::hints_directory
* cassandra::hints_directory_mode
* cassandra::saved_caches_directory
* cassandra::saved_caches_directory_mode
* cassandra::systemctl
### Bugfixes
* Resolved all issues identified by Sonar-Puppet from 38 (2 major,
36 minor). In doing so, this reduced the technical debt ration
from 0.9% to 0.0%.
### Improvements
* The reference documentation is now processed via
http://locp.github.io/cassandra
* Made a start on refactoring the spec/unit tests so that there is less
duplication of code.
## 2016-10-12 - Release 2.0.2 ([diff](https://github.com/locp/cassandra/compare/2.0.1...2.0.2))
### Summary
This is a non-functional patch release that fixes some issues in documentation, and fixes some
bugs and makes some improvements in our testing framework.
### Improvements
* Ensure there is a framework for supporting the legacy 1.X.Y. module until the end of 2016.
* A more obvious test rig for the beaker/acceptance tests on TravisCI.
### Bugfixes
* Corrected misleading documentation.
* Ensure legacy test builds still work against Ruby 1.9.3.
* Corrected deprecated tags in the module metadata.
## 2016-10-08 - Release 1.26.0 ([diff](https://github.com/locp/cassandra/compare/1.25.2...1.26.0))
### Improvements
* The `cassandra::seeds` paramater can now be provided as an array or as a string.
# Bugfixes
* Ensure legacy builds still work on TravisCI.
## 2016-10-01 - Release 2.0.1 ([diff](https://github.com/locp/cassandra/compare/2.0.0...2.0.1))
### Summary
A non-functional release containing some improvements and documentation corrections.
### Improvements
* Corrected some out of date documentation.
* Removed some deprecated files.
* Regained 100% spec test coverage.
## 2016-09-29 - Release 2.0.0 ([diff](https://github.com/locp/cassandra/compare/1.26.0...2.0.0))
### Summary
This is a major release and will more than likely break your existing
manifest until you alter your code. Please see the
[Upgrading](https://github.com/locp/cassandra/tree/release/274/v2.0.0#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](https://github.com/locp/cassandra/compare/1.25.1...1.25.2))
### 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](https://github.com/locp/cassandra/compare/1.25.0...1.25.1))
### 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](https://github.com/locp/cassandra/compare/1.24.3...1.25.0))
### Summary
A feature release.
### Features
* The `cassandra` class now has a `disk_access_mode` attribute.
## 2016-06-26 - Release 1.24.3 ([diff](https://github.com/locp/cassandra/compare/1.24.2...1.24.3))
### 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](https://github.com/locp/cassandra/compare/1.24.1...1.24.2))
### 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](https://github.com/locp/cassandra/compare/1.24.0...1.24.1))
### 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](https://github.com/locp/cassandra/compare/1.23.1...1.24.0))
### Summary
A Debian-centric release. Debian 8 is now supported and a workaround for
[CASSANDRA-2356](https://issues.apache.org/jira/browse/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](https://github.com/locp/cassandra/compare/1.23.0...1.23.1))
### 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](https://github.com/locp/cassandra/compare/1.22.1...1.23.0))
### 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](https://github.com/locp/cassandra/compare/1.22.0...1.22.1))
### 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](https://github.com/locp/cassandra/compare/1.21.0...1.22.0))
### 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](https://github.com/locp/cassandra/compare/1.20.0...1.21.0))
### 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](https://github.com/locp/cassandra/compare/1.19.0...1.20.0))
### 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](https://github.com/locp/cassandra/compare/1.18.1...1.19.0))
### 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](https://github.com/locp/cassandra/compare/1.18.0...1.18.1))
### 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](https://github.com/locp/cassandra/compare/1.17.0...1.18.0))
### 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](https://github.com/locp/cassandra/compare/1.16.0...1.17.0))
### 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](https://github.com/locp/cassandra/compare/1.15.1...1.16.0))
### 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](https://github.com/locp/cassandra/compare/1.15.0...1.15.1))
### Summary
A small improvement.
### Improvements
* Clarified CQL and Python versions.
## 2016-03-10 - Release 1.15.0 ([diff](https://github.com/locp/cassandra/compare/1.14.2...1.15.0))
### 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 the `cassandra` class.
* Added the `service_systemd` attribute to the `cassandra::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 to `package_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](https://github.com/locp/cassandra/compare/1.14.1...1.14.2))
### Summary
A small bugfix release.
### Bugfixes
* Removed `Restart=always` from the Systemd configuration files.
## 2016-02-27 - Release 1.14.1 ([diff](https://github.com/locp/cassandra/compare/1.14.0...1.14.1))
### 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](https://github.com/locp/cassandra/compare/1.13.0...1.14.0))
### 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](https://github.com/locp/cassandra/compare/1.12.2...1.13.0))
### 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](https://github.com/locp/cassandra/compare/1.12.1...1.12.2))
### 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](https://github.com/locp/cassandra/compare/1.12.0...1.12.1))
### 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` and
`stream_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](https://github.com/locp/cassandra/compare/1.11.0...1.12.0))
### 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](https://circleci.com/gh/locp/cassandra).
## 2016-01-01 - Release 1.11.0 ([diff](https://github.com/locp/cassandra/compare/1.10.0...1.11.0))
### 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](https://github.com/locp/cassandra/compare/1.9.2...1.10.0))
### 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](https://github.com/locp/cassandra/compare/1.9.1...1.9.2))
### 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](https://github.com/locp/cassandra/compare/1.9.0...1.9.1))
### 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](https://github.com/locp/cassandra/compare/1.8.1...1.9.0))
### 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](https://github.com/locp/cassandra/compare/1.8.0...1.8.1))
### 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](https://github.com/locp/cassandra/compare/1.7.1...1.8.0))
### 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](https://github.com/locp/cassandra/compare/1.7.0...1.7.1))
### 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](https://github.com/locp/cassandra/compare/1.6.0...1.7.0))
### 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](https://github.com/locp/cassandra/compare/1.5.0...1.6.0))
### 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](https://github.com/locp/cassandra/compare/1.4.2...1.5.0))
### 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](https://github.com/locp/cassandra/compare/1.4.1...1.4.2))
### 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](https://github.com/locp/cassandra/compare/1.4.0...1.4.1))
### 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 the
`cassandra` 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 the
`cassandra::optutils` class from `'undef'` to *undef*.
### Improvements
* Clarified the expectations of submitted contributions.
* Unit test improvements.
## 2015-09-10 - Release 1.4.0 ([diff](https://github.com/locp/cassandra/compare/1.3.7...1.4.0))
* 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](https://github.com/locp/cassandra/compare/1.3.6...1.3.7))
* Made the auto_bootstrap attribute available.
## 2015-09-03 - Release 1.3.6 ([diff](https://github.com/locp/cassandra/compare/1.3.5...1.3.6))
* 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](https://github.com/locp/cassandra/compare/1.3.4...1.3.5))
* 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](https://github.com/locp/cassandra/compare/1.3.3...1.3.4))
* 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](https://github.com/locp/cassandra/compare/1.3.2...1.3.3))
* Corrected dependency version for puppetlabs-apt.
## 2015-08-26 - Release 1.3.2 ([diff](https://github.com/locp/cassandra/compare/1.3.1...1.3.2))
* 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](https://github.com/locp/cassandra/compare/1.3.0...1.3.1))
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](https://github.com/locp/cassandra/compare/1.2.0...1.3.0))
* 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](https://github.com/locp/cassandra/compare/1.1.0...1.2.0))
* 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](https://github.com/locp/cassandra/compare/1.0.1...1.1.0))
* 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](https://github.com/locp/cassandra/compare/1.0.0...1.0.1))
* Provided a workaround for
[CASSANDRA-9822](https://issues.apache.org/jira/browse/CASSANDRA-9822).
## 2015-07-25 - Release 1.0.0 ([diff](https://github.com/locp/cassandra/compare/0.4.3...1.0.0))
* 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](https://tickets.puppetlabs.com/browse/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](https://github.com/locp/cassandra/compare/0.4.2...0.4.3))
* Module dependency metadata was too strict.
## 2015-07-16 - Release 0.4.2 ([diff](https://github.com/locp/cassandra/compare/0.4.1...0.4.2))
* 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](https://github.com/locp/cassandra/compare/0.4.0...0.4.1))
* 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](https://github.com/locp/cassandra/compare/0.3.0...0.4.0))
### 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](https://github.com/locp/cassandra/compare/0.2.2...0.3.0))
### 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](https://github.com/locp/cassandra/compare/0.2.1...0.2.2))
### 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](https://github.com/locp/cassandra/compare/0.2.0...0.2.1))
### Summary
A non-functional change to fix puppet-lint problems identified by Puppet
Forge.
## 2015-05-28 - Release 0.2.0 ([diff](https://github.com/locp/cassandra/compare/0.1.0...0.2.0))
### Summary
Added more attributes and improved the module metadata.
## 2015-05-26 - Release 0.1.0
### Summary
An initial release with **VERY** limited options.
-\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*
\ No newline at end of file
+\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4c62d55..3c6d693 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,169 +1,170 @@
# Contributing to the Module or Raising Issues
## Table of Contents
1. [Raising an Issue](#raising-an-issue)
1. [Contribtions](#contributions)
* [Unit Tests](#unit-tests)
* [Acceptance Tests](#acceptance-tests)
1. [Contributors](#contributors)
1. [Further Reading](#further-reading)
## Raising an Issue
When raising an issue, please provide the following information:
* The version of the locp-cassandra module that you are using.
* The version of Cassandra that you are installing.
* The operating system and release (output from `facter os` would be
appropriate).
* A sample of your manifest/profile that is calling the `cassandra` module.
Feel free to obfuscate sections of the code that contain details that
are confidential (e.g. passwords and other secrets).
## Contributions
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.
However, we do ask that at the very least, all items marked as **MUST** or
**WON'T** in the list below are applicable:
* Any new features (e.g. new resources or new attributes to existing resoures)
**MUST** be fully documented .
* Unit tests **MUST** be completing successfully. See
[Unit Tests](#unit-tests) for more details. If your initial unit tests fail
after a pull request and you need to fix them, simply change the code on
your branch and push them to *origin* again as this will re-run the
tests. It is not required to submit a new pull request.
* Any new functionality or enhancements **SHOULD** be covered by unit/spec
tests. If you are not comfortable with this, submit the PR anyway and
we will fill in these gaps. You will most probably be asked to rebase
your PR branch and then push again to register these changes.
* If applicable, changes **COULD** be covered in beaker/acceptance tests.
* Change **WON'T** break any functionality on any of the supported operating
systems.
### Unit Tests
First, you'll need to install the testing dependencies using
[bundler](http://bundler.io).
```shell
bundle install
```
To run all of the unit tests execute the following:
```shell
bundle exec rake test
```
This should output something like the following:
```
Running RuboCop...
Inspecting 24 files
........................
24 files inspected, no offenses detected
---> syntax:manifests
---> syntax:templates
---> syntax:hiera:yaml
/home/ben/.rvm/rubies/ruby-2.1.6/bin/ruby -I/home/ben/.rvm/gems/ruby-2.1.6/gems/rspec-core-3.5.4/lib:/home/ben/.rvm/gems/ruby-2.1.6/gems/rspec-support-3.5.0/lib /home/ben/.rvm/gems/ruby-2.1.6/gems/rspec-core-3.5.4/exe/rspec --pattern spec/\{aliases,classes,defines,unit,functions,hosts,integration,types\}/\*\*/\*_spec.rb --color
[Coveralls] Set up the SimpleCov formatter.
[Coveralls] Using SimpleCov's default settings.
.......................................................
Finished in 7.86 seconds (files took 0.81841 seconds to load)
55 examples, 0 failures
Total resources: 64
Touched resources: 64
Resource coverage: 100.00%
[Coveralls] Outside the CI environment, not sending data.
```
Note that if you prefer, you can run the lint, syntax, and spec tests separately with individual commands:
```shell
bundle exec rake metadata_lint
bundle exec rake rubocop
bundle exec rake lint
bundle exec rake validate
bundle exec rake spec
```
If in doubt, or you are stuck, please ask for help in the PR or via our
[Gitter Room](https://gitter.im/locp/cassandra).
The unit tests will also fail if the test coverage falls below 100%.
### Acceptance Tests
These tests are more CPU intensive and are run via Docker. You will
need to install further gems for this to work with the following
command:
```shell
bundle install --with acceptance
```
Then run the tests:
```shell
bundle exec rake beaker:centos6
bundle exec rake beaker:centos7
bundle exec rake beaker:debian7
bundle exec rake beaker:debian8
bundle exec rake beaker:ubuntu1204
bundle exec rake beaker:ubuntu1404
bundle exec rake beaker:ubuntu1604
```
## Contributors
**Release** | **PR/Issue** | **Contributer**
------------|-----------------------------------------------------|----------------------------------------------------
+2.6.0 | [Adding Red Hat OS](https://github.com/locp/cassandra/pull/396) | [@stijnvdb](https://github.com/stijnvdb)
2.3.0 | [Hiera documentation](https://github.com/locp/cassandra/pull/329) | [@tibers](https://github.com/tibers)
2.1.1 | [Correct cql_types conditional in cassandra::schema class](https://github.com/locp/cassandra/pull/325)| [@aaron-miller](https://github.com/aaron-miller)
2.0.2 | [locp/cassandra 2.0 example has two cassandra declarations](https://github.com/locp/cassandra/issues/291)| [@ericy-jana](https://github.com/ericy-jana)
2.0.0 | [Convert cassandra::file from a class to a define](https://github.com/locp/cassandra/issues/266)| [@stanleyz](https://github.com/stanleyz)
1.26.1 | [Correct cql_types conditional in cassandra::schema class](https://github.com/locp/cassandra/pull/325)| [@aaron-miller](https://github.com/aaron-miller)
1.25.2 | [Ubuntu 16 doesnt like the service file](https://github.com/locp/cassandra/issues/269)| [@ahharu](https://github.com/ahharu)
1.25.1 | [PID file name in systemd file for datastax-agent doesn't match PID file name in /etc/init.d/datastax-agent](https://github.com/locp/cassandra/issues/264)| [@pampelix](https://github.com/pampelix)
1.25.0 | [adding support for mmap](https://github.com/locp/cassandra/pull/261) | [@tibers](https://github.com/tibers)
1.24.0 | [remove varlib_dir require from data directory](https://github.com/locp/cassandra/pull/247) | [@ericy-jana](https://github.com/ericy-jana)
1.24.0 | [stage config files before installing cassandra package](https://github.com/locp/cassandra/pull/246) | [@ericy-jana](https://github.com/ericy-jana)
1.24.0 | [locp/cassandra starts two Cassandra processes](https://github.com/locp/cassandra/issues/245)| [@ericy-jana](https://github.com/ericy-jana)
1.23.0 | [attemping to realize client security](https://github.com/locp/cassandra/pull/235) | [@tibers](https://github.com/tibers)
1.22.1 | [#232 - add ordering to service definition](https://github.com/locp/cassandra/pull/233) | [@tibers](https://github.com/tibers)
1.22.1 | [module tries to start cassandra before it's installed](https://github.com/locp/cassandra/issues/232)| [@tibers](https://github.com/tibers)
1.21.0 | [Issue: Java version installed on Debian family by cassandra::java class #223](https://github.com/locp/cassandra/pull/226) | [@tibers](https://github.com/tibers)
1.20.0 | [Missing attributes in cassandra.yaml](https://github.com/locp/cassandra/issues/217)| [@samyray](https://github.com/samyray)
1.19.0 | [adding hints_directory for cassandra 3.x](https://github.com/locp/cassandra/pull/215) | [@tibers](https://github.com/tibers)
1.18.0 | [Added opscenter ldap option group_search_filter_with_dn](https://github.com/locp/cassandra/pull/203) | [@Mike-Petersen](https://github.com/Mike-Petersen)
1.15.0 | [creating vanilla cassandra 2.0.xx template](https://github.com/locp/cassandra/pull/189) | [@tibers](https://github.com/tibers)
1.14.0 | [Feature/opscenter orbited longpoll](https://github.com/locp/cassandra/pull/171) | [@jonen10](https://github.com/jonen10)
1.13.0 | [Allowing setting of async_pool_size and async_queue_size for the agent](https://github.com/locp/cassandra/pull/166) | [@Mike-Petersen](https://github.com/Mike-Petersen)
1.13.0 | [parameterized thrift_framed_transport_size_in_mb](https://github.com/locp/cassandra/pull/163) | [@VeriskPuppet](https://github.com/VeriskPuppet)
1.12.2 | [Error opening zip file or JAR manifest missing : /usr/sbin/../lib/jamm-0.3.0.jar](https://github.com/locp/cassandra/pull/165) | [@palmertime](https://github.com/palmertime)
1.12.0 | [Rename alias to agent_alias as alias is a reserved puppet word](https://github.com/locp/cassandra/pull/156) | [@stuartbfox](https://github.com/stuartbfox)
1.12.0 | [Added interfaces as an option](https://github.com/locp/cassandra/pull/153) | [@Mike-Petersen](https://github.com/Mike-Petersen)
1.10.0 | [Allowing setting of local_interface for the datastax agent configuration](https://github.com/locp/cassandra/pull/144) | [@Mike-Petersen](https://github.com/Mike-Petersen)
1.9.2 | [When installing cassandra dsc22 it tries to install cassandra 3.0.0 and as dependecy 2.2.3 is needed](https://github.com/locp/cassandra/issues/136)| [@mantunovic](https://github.com/mantunovic)
1.9.2 | [When installing cassandra dsc22 it tries to install cassandra 3.0.0 and as dependecy 2.2.3 is needed](https://github.com/locp/cassandra/issues/136)| [@al4](https://github.com/al4)
1.4.2 | [restart service if datastax agent package is upgraded](https://github.com/locp/cassandra/pull/110) | [@markasammut](https://github.com/markasammut)
1.4.0 | [allow batch_size_warn_threshold to be modified externally](https://github.com/locp/cassandra/pull/100) | [@markasammut](https://github.com/markasammut)
1.3.5 | [service_ensure unused](https://github.com/locp/cassandra/issues/93) | [@sampowers](https://github.com/sampowers)
1.3.3 | [Fails To Run With puppetlabs-apt v1.8.0](https://github.com/locp/cassandra/pull/87) | [@DylanGriffith](https://github.com/DylanGriffith)
0.4.2 | [Fix syntax in version_requirements](https://github.com/locp/cassandra/pull/34) | [@amosshapira](https://github.com/amosshapira)
0.3.0 | [Add a template for Cassandra 1.x compat](https://github.com/locp/cassandra/pull/11) | [@spredzy](https://github.com/Spredzy)
## Further Reading
* *RSpec tests for your Puppet manifests*
* *Beaker Info*
diff --git a/Gemfile b/Gemfile
index 0469e8d..c0c1d54 100644
--- a/Gemfile
+++ b/Gemfile
@@ -1,48 +1,52 @@
source ENV['GEM_SOURCE'] || 'https://rubygems.org'
-puppetversion = ENV.key?('PUPPET_VERSION') ? ENV['PUPPET_VERSION'] : ['>= 3.8']
+puppetversion = ENV.key?('PUPPET_VERSION') ? ENV['PUPPET_VERSION'] : ['~> 4.0']
+
+# github_changelog_generator must be 1.13.0 for ruby < 2.2.2
+github_changelog_generator_version = RUBY_VERSION < '2.2.2' ? '~> 1.13.0' : '>= 1.13.0'
# github_changelog_generator must be 1.13.0 for ruby < 2.2.2
github_changelog_generator_version = RUBY_VERSION < '2.2.2' ? '~> 1.13.0' : '>= 1.13.0'
group :test do
gem 'coveralls', require: false
gem 'facter', '>= 1.7.0'
gem 'git', '1.3.0'
gem 'github_changelog_generator', github_changelog_generator_version
gem 'hiera', require: false
gem 'httparty', require: false
gem 'metadata-json-lint', require: false
gem 'puppet', puppetversion
gem 'puppet-blacksmith', require: false
gem 'puppet-lint', require: false
gem 'puppet-strings', require: false
gem 'puppetlabs_spec_helper', require: false
gem 'rack', '~> 1.0', require: false if RUBY_VERSION < '2.2.2'
gem 'rspec-puppet', '>= 2.3.2'
gem 'rspec-puppet-utils', require: false
gem 'rspec_junit_formatter', require: false
gem 'rubocop-rspec', '1.4.1' if RUBY_VERSION < '2.2.0'
+ gem 'semantic_puppet', require: false
gem 'travis', require: false
gem 'travis-lint', require: false
gem 'yard', require: false
end
group :acceptance do
gem 'beaker'
gem 'beaker-puppet_install_helper'
gem 'beaker-rspec'
gem 'pry'
end
group :development do
gem 'notes', '~> 0.1.2'
end
# rspec must be v2 for ruby 1.8.7
if RUBY_VERSION >= '1.8.7' && RUBY_VERSION < '1.9'
gem 'rake', '~> 10.0'
gem 'rspec', '~> 2.0'
else
# rubocop requires ruby >= 1.9
gem 'rubocop'
end
diff --git a/README.md b/README.md
index 53defc1..e1eb0b0 100644
--- a/README.md
+++ b/README.md
@@ -1,669 +1,670 @@
# Cassandra
[](https://forge.puppetlabs.com/locp/cassandra)
[](https://github.com/locp/cassandra)
[](https://travis-ci.org/locp/cassandra)
[](https://coveralls.io/github/locp/cassandra?branch=master)
[](https://gitter.im/locp/cassandra?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://circleci.com/gh/locp/cassandra)
[](https://forge.puppetlabs.com/locp/cassandra)
[](https://forge.puppetlabs.com/locp/cassandra)
## Table of Contents
1. [Overview](#overview)
1. [Setup - The basics of getting started with Cassandra](#setup)
* [What Cassandra affects](#what-cassandra-affects)
* [Upgrading](#upgrading)
* [Beginning with Cassandra](#beginning-with-cassandra)
1. [Usage - Configuration options and additional functionality](#usage)
* [Setup a keyspace and users](#setup-a-keyspace-and-users)
* [Create a Cluster in a Single Data Center](#create-a-cluster-in-a-single-data-center)
* [Create a Cluster in Multiple Data Centers](#create-a-cluster-in-multiple-data-centers)
* [DataStax Enterprise](#datastax-enterprise)
* [Apache Cassandra](#apache-cassandra)
1. [Reference](#reference)
1. [Limitations - OS compatibility, etc.](#limitations)
1. [Development](#development)
## 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](https://issues.apache.org/jira/browse/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_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::dse class affects
* Optionally configures files in the `/etc/dse` directory if one is using
DataStax Enterprise.
#### 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](http://semver.org/) 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](https://issues.apache.org/jira/browse/CASSANDRA-2356)
during an initial install or package upgrade.
All the functionality relating to OpsCenter has been divested to the
[locp/opscenter](https://forge.puppet.com/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/Suggested-Baseline-Settings)
Please also see the notes for 2.0.0 in the
[CHANGELOG](https://forge.puppet.com/locp/cassandra/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.
```puppet
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
Create a Cassandra 2.X cluster called MyCassandraCluster which uses the
GossipingPropertyFileSnitch and password authentication. In this very
basic example the node itself becomes a seed for the cluster and the
credentials will default to a user called cassandra with a password
called of cassandra.
```puppet
# Cassandra pre-requisites
include cassandra::datastax_repo
include 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'],
}
```
However, **PLEASE** note that this is the **ABSOLUTE MINIMUM** configuration
to get Cassandra up and running but will probably give you a rather badly
configured node. Please see
[Suggested Baseline Settings](https://github.com/locp/cassandra/wiki/Suggested-Baseline-Settings)
for details on making your configuration a lot more robust.
For this code to run with version 3.X of Cassandra, the `hints_directory` will
also need to be specified:
```puppet
...
class { 'cassandra':
settings => {
...
'hints_directory' => '/var/lib/cassandra/hints',
...
},
require => Class['cassandra::datastax_repo', 'cassandra::java'],
}
```
### Hiera
In your top level node classification (usually `common.yaml`), add the
settings hash and all the tweaks you want all the clusters to use:
```YAML
cassandra::baseline_settings:
authenticator: AllowAllAuthenticator
authorizer: AllowAllAuthorizer
auto_bootstrap: true
auto_snapshot: true
...
```
Then, in the individual node classification add the parts which define
the cluster:
```YAML
cassandra::settings:
cluster_name: developer playground cassandra cluster
cassandra::dc: Onsite1
cassandra::rack: RAC1
cassandra::package_ensure: 3.0.5-1
cassandra::package_name: cassandra30
```
## 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 while ensuring that a user
called lucan is absent.
```puppet
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,
},
}
},
permissions => {
'Grant select permissions to spillman to all keyspaces' => {
permission_name => 'SELECT',
user_name => 'spillman',
},
'Grant modify to to keyspace mykeyspace to akers' => {
keyspace_name => 'mykeyspace',
permission_name => 'MODIFY',
user_name => 'akers',
},
'Grant alter permissions to mykeyspace to boone' => {
keyspace_name => 'mykeyspace',
permission_name => 'ALTER',
user_name => 'boone',
},
'Grant ALL permissions to mykeyspace.users to gbennet' => {
keyspace_name => 'mykeyspace',
permission_name => 'ALTER',
table_name => 'users',
user_name => 'gbennet',
},
},
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',
},
'gbennet' => {
'password' => 'foobar',
},
'lucan' => {
'ensure' => absent
},
},
}
```
### Create a Cluster in a Single Data Center
In the DataStax documentation _Initializing a multiple node cluster (single
data center)_
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.
```puppet
node /^node\d+$/ {
class { 'cassandra::datastax_repo':
before => Class['cassandra']
}
class { 'cassandra::java':
before => Class['cassandra']
}
class { 'cassandra':
settings => {
'authenticator' => 'AllowAllAuthenticator',
'auto_bootstrap' => false,
'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',
'hints_directory' => '/var/lib/cassandra/hints',
'listen_interface' => 'eth1',
'num_tokens' => 256,
'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' => '110.82.155.0,110.82.156.3',
},
],
},
],
'start_native_transport' => true,
},
}
}
```
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
.
**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:
```puppet
node /^node[012]$/ {
class { 'cassandra':
dc => 'DC1',
settings => {
'authenticator' => 'AllowAllAuthenticator',
'auto_bootstrap' => false,
'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',
'hints_directory' => '/var/lib/cassandra/hints',
'listen_interface' => 'eth1',
'num_tokens' => 256,
'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' => '110.82.155.0,110.82.156.3',
},
],
},
],
'start_native_transport' => true,
},
}
}
node /^node[345]$/ {
class { 'cassandra':
dc => 'DC2',
settings => {
'authenticator' => 'AllowAllAuthenticator',
'auto_bootstrap' => false,
'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',
'hints_directory' => '/var/lib/cassandra/hints',
'listen_interface' => 'eth1',
'num_tokens' => 256,
'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' => '110.82.155.0,110.82.156.3',
},
],
},
],
'start_native_transport' => true,
},
}
}
```
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.
### DataStax Enterprise
After configuring the relevant repository, the following snippet works on
CentOS 7 to install DSE Cassandra 4.7.0, set the HADOOP_LOG_DIR, set the
DSE_HOME and configure DataStax Enterprise to use LDAP for authentication:
```puppet
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',
...
}
class { 'cassandra::dse':
file_lines => {
'Set HADOOP_LOG_DIR directory' => {
ensure => present,
path => '/etc/dse/dse-env.sh',
line => 'export HADOOP_LOG_DIR=/var/log/hadoop',
match => '^# export HADOOP_LOG_DIR=',
},
'Set DSE_HOME' => {
ensure => present,
path => '/etc/dse/dse-env.sh',
line => 'export DSE_HOME=/usr/share/dse',
match => '^#export DSE_HOME',
},
},
settings => {
ldap_options => {
server_host => localhost,
server_port => 389,
search_dn => 'cn=Admin',
search_password => secret,
use_ssl => false,
use_tls => false,
truststore_type => jks,
user_search_base => 'ou=users,dc=example,dc=com',
user_search_filter => '(uid={0})',
credentials_validity_in_ms => 0,
connection_pool => {
max_active => 8,
max_idle => 8,
}
}
}
}
```
### Apache Cassandra
DataStax announced in late October 2016 that it was no longer supporting
the community edition of Cassandra or DSC as it was known (see
*[Take a bow Planet
Cassandra]*(http://www.datastax.com/2016/10/take-a-bow-planet-cassandra)
for details). However, the following snippet of code running on Ubuntu
14.04 worked fine without having to change any of the `::cassandra` class
settings:
```puppet
require cassandra::java
include cassandra::optutils
class { 'cassandra::apache_repo':
release => '310x',
before => Class['cassandra', 'cassandra::optutils'],
}
class { 'cassandra':
...
}
```
## Reference
The reference documentation is generated using the
[puppet-strings](https://github.com/puppetlabs/puppet-strings) tool. To see
all of it, please go to
[http://locp.github.io/cassandra](http://locp.github.io/cassandra/_index.html).
## Limitations
* When using a Ruby version before 1.9.0, the contents of the Cassandra
configuration file may change order of elements due 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.
* At the moment the `cassandra::system::transparent_hugepage` does not
persist between reboots.
-* Currently Apache Cassandra only provides binary packages for Debian so
-the `cassandra::apache_repo` is not of much use to Red Hat family users.
+* Acceptance for Debian 7 are confined to Cassandra 2.1 and 2.2. There is
+a conflict between the GLIBC on Debian 7 and the newer releases of Cassandra
+3.X.
## Development
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](https://github.com/locp/cassandra/blob/master/CONTRIBUTING.md)
page for project specific requirements.
### Additional Contributers
For a list of contributers see
[CONTRIBUTING.md](https://github.com/locp/cassandra/blob/master/CONTRIBUTING.md)
and https://github.com/locp/cassandra/graphs/contributors
diff --git a/manifests/apache_repo.pp b/manifests/apache_repo.pp
index f79678f..0f1be42 100644
--- a/manifests/apache_repo.pp
+++ b/manifests/apache_repo.pp
@@ -1,69 +1,85 @@
# An optional class that will allow a suitable repository to be configured
-# from which packages for Apache Cassandra can be downloaded. Changing
-# the defaults will allow any Debian Apt repository to be configured.
-# Currently Apache only provide a Debian repository
-# (http://cassandra.apache.org/download/) mentions of Yum are for wishful
-# thinking.
+# from which packages for Apache Cassandra can be downloaded.
# @param descr [string] 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.
# @param key_id [string] On the Debian family, this is passed as the `id`
# attribute to an `apt::key` resource. On the Red Hat family, it is
# ignored.
# @param key_url [string] On the Debian family, this is passed as the
# `source` attribute to an `apt::key` resource. On the Red Hat family,
-# it is ignored.
-# @param pkg_url [string] 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
+# it is set to the `gpgkey` attribute on the `yumrepo` resource.
+# @param pkg_url [string] On the Red Hat family, leaving this as default will
+# set the `baseurl` on the `yumrepo` resource to
+# 'http://www.apache.org/dist/cassandra/redhat' with whatever is set in the
+# 'release' attribute appended.
+# On the Debian family, leaving this as the default
# will set the `location` attribute on an `apt::source` to
# 'http://www.apache.org/dist/cassandra/debian'.
# @param release [string] On the Debian family, this is passed as the `release`
-# attribute to an `apt::source` resource. On the Red Hat family, it is
-# ignored.
+# attribute to an `apt::source` resource. On the Red Hat family, it is the
+# major version number of Cassandra, without dot, and with an appended 'x'
+# (e.g. '311x')
class cassandra::apache_repo (
$descr = 'Repo for Apache Cassandra',
$key_id = 'A26E528B271F19B9E5D8E19EA278B781FE4B2BDA',
$key_url = 'https://www.apache.org/dist/cassandra/KEYS',
$pkg_url = undef,
$release = 'main',
) {
case $::osfamily {
+ 'RedHat': {
+ if $pkg_url != undef {
+ $baseurl = $pkg_url
+ } else {
+ $url = 'http://www.apache.org/dist/cassandra/redhat'
+ $baseurl = "${url}/${release}"
+ }
+
+ yumrepo { 'cassandra_apache':
+ ensure => present,
+ descr => $descr,
+ baseurl => $baseurl,
+ enabled => 1,
+ gpgcheck => 1,
+ gpgkey => $key_url,
+ }
+ }
'Debian': {
include apt
include apt::update
apt::key {'apache.cassandra':
id => $key_id,
source => $key_url,
before => Apt::Source['cassandra.sources'],
}
if $pkg_url != undef {
$location = $pkg_url
} else {
$location = 'http://www.apache.org/dist/cassandra/debian'
}
apt::source {'cassandra.sources':
location => $location,
comment => $descr,
release => $release,
include => {
'src' => false,
},
notify => Exec['update-apache-cassandra-repo'],
}
# Required to wrap apt_update
exec {'update-apache-cassandra-repo':
refreshonly => true,
command => '/bin/true',
require => Exec['apt_update'],
}
}
default: {
warning("OS family ${::osfamily} not supported")
}
}
-}
\ No newline at end of file
+}
diff --git a/metadata.json b/metadata.json
index 2f202de..6b5f331 100644
--- a/metadata.json
+++ b/metadata.json
@@ -1,82 +1,82 @@
{
"name": "locp-cassandra",
- "version": "2.5.0",
+ "version": "2.6.0",
"author": "locp",
"summary": "Installs Cassandra & DataStax Agent on RHEL/Ubuntu/Debian.",
"license": "Apache-2.0",
"source": "https://github.com/locp/cassandra",
"project_page": "https://github.com/locp/cassandra",
"issues_url": "https://github.com/locp/cassandra/issues",
"tags": [
"Apache",
"cassandra",
"cluster",
"database",
"datastax",
"datastax-agent",
"nosql"
],
"dependencies": [
{
"name": "puppetlabs-apt",
"version_requirement": ">= 2.0.0 < 3.0.0"
},
{
"name": "puppetlabs-firewall",
"version_requirement": ">= 1.0.0 < 2.0.0"
},
{
"name": "puppetlabs-inifile",
"version_requirement": ">= 1.5.0 < 2.0.0"
},
{
"name": "puppetlabs-stdlib",
"version_requirement": ">= 3.0.0 < 5.0.0"
}
],
"operatingsystem_support": [
{
"operatingsystem": "CentOS",
"operatingsystemrelease": [
"6",
"7"
]
},
{
"operatingsystem": "OracleLinux",
"operatingsystemrelease": [
"6",
"7"
]
},
{
"operatingsystem": "RedHat",
"operatingsystemrelease": [
"6",
"7"
]
},
{
"operatingsystem": "Debian",
"operatingsystemrelease": [
"7",
"8"
]
},
{
"operatingsystem": "Scientific",
"operatingsystemrelease": [
"6",
"7"
]
},
{
"operatingsystem": "Ubuntu",
"operatingsystemrelease": [
"12.04",
"14.04",
"16.04"
]
}
]
}
diff --git a/spec/acceptance/bootstrap_spec.rb b/spec/acceptance/bootstrap_spec.rb
index b887d4a..c92fd61 100644
--- a/spec/acceptance/bootstrap_spec.rb
+++ b/spec/acceptance/bootstrap_spec.rb
@@ -1,13 +1,13 @@
require 'spec_helper_acceptance'
osfamily = fact('osfamily')
roles = hosts[0]['roles']
-t = TestManifests.new(roles, 0)
+t = TestManifests.new(roles, 0, 0)
bootstrap_pp = t.bootstrap_pp()
describe 'Test Entry Criteria' do
it "Should work with no errors (#{osfamily})" do
apply_manifest(bootstrap_pp, catch_failures: true)
shell('[ -d /opt/rh/ruby200 ] && /usr/bin/gem install puppet -v 3.8.7 --no-rdoc --no-ri; true')
end
end
diff --git a/spec/acceptance/cassandra_spec.rb b/spec/acceptance/cassandra_spec.rb
index 7cff55f..14ec230 100644
--- a/spec/acceptance/cassandra_spec.rb
+++ b/spec/acceptance/cassandra_spec.rb
@@ -1,128 +1,128 @@
require 'spec_helper_acceptance'
describe 'cassandra' do
roles = hosts[0]['roles']
versions = []
versions.push(2.1) if roles.include? 'cassandra2'
versions.push(2.2) if roles.include? 'cassandra2'
versions.push(3.0) if roles.include? 'cassandra3'
versions.each do |version|
- t = TestManifests.new(roles, version)
+ t = TestManifests.new(roles, version, fact('operatingsystemmajrelease'))
describe "Cassandra #{version} installation." do
# firewall_pp = t.firewall_pp()
cassandra_install_pp = t.cassandra_install_pp
it 'should work with no errors' do
apply_manifest(cassandra_install_pp, catch_failures: true)
end
it 'check code is idempotent' do
expect(apply_manifest(cassandra_install_pp,
catch_failures: true).exit_code).to be_zero
end
end
describe service('cassandra') do
it "check Cassandra-#{version} is running and enabled" do
is_expected.to be_running
is_expected.to be_enabled
end
end
if fact('osfamily') == 'RedHat'
describe service('datastax-agent') do
it 'check service status' do
is_expected.to be_running
is_expected.to be_enabled
end
end
end
describe "Create schema for #{version}." do
it 'should work with no errors' do
apply_manifest(t.schema_create_pp, catch_failures: true)
end
if version != 2.1
it 'check code is idempotent' do
expect(apply_manifest(t.schema_create_pp, catch_failures: true).exit_code).to be_zero
end
end
end
describe "Schema drop type for #{version}." do
it 'should work with no errors' do
apply_manifest(t.schema_drop_type_pp, catch_failures: true)
end
it 'check code is idempotent' do
expect(apply_manifest(t.schema_drop_type_pp, catch_failures: true).exit_code).to be_zero
end
end
describe "Revoke permissions for #{version}." do
it 'should work with no errors' do
apply_manifest(t.permissions_revoke_pp, catch_failures: true)
end
it 'check code is idempotent' do
expect(apply_manifest(t.permissions_revoke_pp, catch_failures: true).exit_code).to be_zero
end
end
describe "Drop user for #{version}" do
it 'should work with no errors' do
apply_manifest(t.schema_drop_user_pp, catch_failures: true)
end
it 'check code is idempotent' do
expect(apply_manifest(t.schema_drop_user_pp, catch_failures: true).exit_code).to be_zero
end
end
describe "Drop index for #{version}" do
it 'should work with no errors' do
apply_manifest(t.schema_drop_index_pp, catch_failures: true)
end
it 'check code is idempotent' do
expect(apply_manifest(t.schema_drop_index_pp, catch_failures: true).exit_code).to be_zero
end
end
describe "Drop table for #{version}" do
it 'should work with no errors' do
apply_manifest(t.schema_drop_table_pp, catch_failures: true)
end
it 'check code is idempotent' do
expect(apply_manifest(t.schema_drop_table_pp, catch_failures: true).exit_code).to be_zero
end
end
describe "Drop keyspace for #{version}" do
it 'should work with no errors' do
apply_manifest(t.schema_drop_keyspace_pp, catch_failures: true)
end
it 'check code is idempotent' do
expect(apply_manifest(t.schema_drop_keyspace_pp, catch_failures: true).exit_code).to be_zero
end
end
describe "Facts Tests for #{version}" do
it 'should work with no errors' do
apply_manifest(t.facts_testing_pp, catch_failures: true)
end
end
next unless version != 3.0
describe "Uninstall #{version}." do
it 'should work with no errors' do
apply_manifest(t.cassandra_uninstall_pp, catch_failures: true)
end
end
end
end
diff --git a/spec/acceptance/nodesets/debian7.yml b/spec/acceptance/nodesets/debian7.yml
index a832f44..42e728f 100644
--- a/spec/acceptance/nodesets/debian7.yml
+++ b/spec/acceptance/nodesets/debian7.yml
@@ -1,15 +1,14 @@
----
-CONFIG:
+---
+CONFIG:
log_level: notice
type: foss
-HOSTS:
- debian7:
- docker_image_commands:
+HOSTS:
+ debian7:
+ docker_image_commands:
- "apt-get install -y wget"
hypervisor: docker
image: "debian:7"
platform: debian-7-amd64
- roles:
+ roles:
- cassandra2
- - cassandra3
- firewall
diff --git a/spec/classes/apache_repo_spec.rb b/spec/classes/apache_repo_spec.rb
new file mode 100644
index 0000000..7d46212
--- /dev/null
+++ b/spec/classes/apache_repo_spec.rb
@@ -0,0 +1,78 @@
+require 'spec_helper'
+describe 'cassandra::apache_repo' do
+ let(:pre_condition) do
+ [
+ 'class apt () {}',
+ 'class apt::update () {}',
+ 'define apt::key ($id, $source) {}',
+ 'define apt::source ($location, $comment, $release, $include) {}'
+ ]
+ end
+
+ context 'On a RedHat OS with defaults for all parameters' do
+ let :facts do
+ {
+ osfamily: 'RedHat'
+ }
+ end
+
+ let :params do
+ {
+ release: '311x'
+ }
+ end
+
+ it do
+ should have_resource_count(1)
+
+ should contain_class('cassandra::apache_repo').only_with(
+ 'descr' => 'Repo for Apache Cassandra',
+ 'key_id' => 'A26E528B271F19B9E5D8E19EA278B781FE4B2BDA',
+ 'key_url' => 'https://www.apache.org/dist/cassandra/KEYS',
+ 'release' => '311x'
+ )
+
+ should contain_yumrepo('cassandra_apache').with(
+ ensure: 'present',
+ descr: 'Repo for Apache Cassandra',
+ baseurl: 'http://www.apache.org/dist/cassandra/redhat/311x',
+ enabled: 1,
+ gpgcheck: 1,
+ gpgkey: 'https://www.apache.org/dist/cassandra/KEYS'
+ )
+ end
+ end
+
+ context 'On a Debian OS with defaults for all parameters' do
+ let :facts do
+ {
+ osfamily: 'Debian',
+ lsbdistid: 'Ubuntu',
+ lsbdistrelease: '14.04'
+ }
+ end
+
+ it do
+ should have_resource_count(3)
+ should contain_class('apt')
+ should contain_class('apt::update')
+
+ should contain_apt__key('apache.cassandra').with(
+ id: 'A26E528B271F19B9E5D8E19EA278B781FE4B2BDA',
+ source: 'https://www.apache.org/dist/cassandra/KEYS'
+ )
+
+ should contain_apt__source('cassandra.sources').with(
+ location: 'http://www.apache.org/dist/cassandra/debian',
+ comment: 'Repo for Apache Cassandra',
+ release: 'main',
+ include: { 'src' => false }
+ ).that_notifies('Exec[update-apache-cassandra-repo]')
+
+ should contain_exec('update-apache-cassandra-repo').with(
+ refreshonly: true,
+ command: '/bin/true'
+ )
+ end
+ end
+end
diff --git a/spec/classes/datastax_agent_spec.rb b/spec/classes/datastax_agent_spec.rb
index 660181e..199adff 100644
--- a/spec/classes/datastax_agent_spec.rb
+++ b/spec/classes/datastax_agent_spec.rb
@@ -1,141 +1,140 @@
require 'spec_helper'
describe 'cassandra::datastax_agent' do
let(:pre_condition) do
[
'class cassandra() {}',
'define ini_setting($ensure = nil,
$path,
$section,
$key_val_separator = nil,
$setting,
$value = nil) {}'
]
end
context 'Test for cassandra::datastax_agent with defaults (RedHat).' do
let :facts do
{
osfamily: 'RedHat',
operatingsystemmajrelease: 6
}
end
it do
should have_resource_count(4)
should contain_class('cassandra::datastax_agent').only_with(
'defaults_file' => '/etc/default/datastax-agent',
- 'java_home' => nil,
'package_ensure' => 'present',
'package_name' => 'datastax-agent',
'service_ensure' => 'running',
'service_enable' => true,
'service_name' => 'datastax-agent',
'stomp_interface' => nil,
'local_interface' => nil
)
should contain_package('datastax-agent').with(
ensure: 'present',
notify: 'Exec[datastax_agent_reload_systemctl]'
).that_notifies('Exec[datastax_agent_reload_systemctl]')
should contain_exec('datastax_agent_reload_systemctl').only_with(
command: '/usr/bin/systemctl daemon-reload',
onlyif: 'test -x /usr/bin/systemctl',
path: ['/usr/bin', '/bin'],
refreshonly: true,
notify: 'Service[datastax-agent]'
).that_notifies('Service[datastax-agent]')
should contain_file('/var/lib/datastax-agent/conf/address.yaml')
.with(
owner: 'cassandra',
group: 'cassandra',
mode: '0644'
).that_requires('Package[datastax-agent]')
should contain_service('datastax-agent').only_with(
ensure: 'running',
enable: true,
name: 'datastax-agent'
)
end
end
context 'Test for cassandra::datastax_agent with defaults (Debian).' do
let :facts do
{
osfamily: 'Debian',
operatingsystemmajrelease: 6
}
end
it do
should contain_exec('datastax_agent_reload_systemctl').with(
command: '/bin/systemctl daemon-reload',
onlyif: 'test -x /bin/systemctl',
path: ['/usr/bin', '/bin'],
refreshonly: true
).that_notifies('Service[datastax-agent]')
end
end
context 'Test that the JAVA_HOME can be set.' do
let :facts do
{
osfamily: 'Debian',
operatingsystemmajrelease: 6
}
end
let :params do
{
java_home: '/usr/lib/jvm/java-8-oracle'
}
end
it do
should contain_ini_setting('java_home').with(
ensure: 'present',
path: '/etc/default/datastax-agent',
section: '',
key_val_separator: '=',
setting: 'JAVA_HOME',
value: '/usr/lib/jvm/java-8-oracle'
).that_notifies('Service[datastax-agent]')
end
end
context 'Test settings.' do
let :facts do
{
osfamily: 'Debian',
operatingsystemmajrelease: 6
}
end
let :params do
{
settings: {
'agent_alias' => {
'setting' => 'agent_alias',
'value' => 'foobar'
},
'stomp_interface' => {
'setting' => 'stomp_interface',
'value' => 'localhost'
},
'async_pool_size' => {
'ensure' => 'absent'
}
}
}
end
it do
should have_resource_count(4)
end
end
end
diff --git a/spec/classes/datastax_repo_spec.rb b/spec/classes/datastax_repo_spec.rb
index 60adf73..d45e7b4 100644
--- a/spec/classes/datastax_repo_spec.rb
+++ b/spec/classes/datastax_repo_spec.rb
@@ -1,72 +1,71 @@
require 'spec_helper'
describe 'cassandra::datastax_repo' do
let(:pre_condition) do
[
'class apt () {}',
'class apt::update () {}',
'define apt::key ($id, $source) {}',
'define apt::source ($location, $comment, $release, $include) {}'
]
end
context 'On a RedHat OS with defaults for all parameters' do
let :facts do
{
osfamily: 'RedHat'
}
end
it do
should have_resource_count(1)
should contain_class('cassandra::datastax_repo').only_with(
'descr' => 'DataStax Repo for Apache Cassandra',
'key_id' => '7E41C00F85BFC1706C4FFFB3350200F2B999A372',
'key_url' => 'http://debian.datastax.com/debian/repo_key',
- 'pkg_url' => nil,
'release' => 'stable'
)
should contain_yumrepo('datastax').with(
ensure: 'present',
descr: 'DataStax Repo for Apache Cassandra',
baseurl: 'http://rpm.datastax.com/community',
enabled: 1,
gpgcheck: 0
)
end
end
context 'On a Debian OS with defaults for all parameters' do
let :facts do
{
osfamily: 'Debian',
lsbdistid: 'Ubuntu',
lsbdistrelease: '14.04'
}
end
it do
should have_resource_count(3)
should contain_class('apt')
should contain_class('apt::update')
should contain_apt__key('datastaxkey').with(
id: '7E41C00F85BFC1706C4FFFB3350200F2B999A372',
source: 'http://debian.datastax.com/debian/repo_key'
)
should contain_apt__source('datastax').with(
location: 'http://debian.datastax.com/community',
comment: 'DataStax Repo for Apache Cassandra',
release: 'stable',
include: { 'src' => false }
).that_notifies('Exec[update-cassandra-repos]')
should contain_exec('update-cassandra-repos').with(
refreshonly: true,
command: '/bin/true'
)
end
end
end
diff --git a/spec/classes/init_spec.rb b/spec/classes/init_spec.rb
index bc43e1c..ecd65fd 100644
--- a/spec/classes/init_spec.rb
+++ b/spec/classes/init_spec.rb
@@ -1,405 +1,403 @@
require 'spec_helper'
describe 'cassandra' do
let(:pre_condition) do
[
'class apt () {}',
'class apt::update () {}',
'define apt::key ($id, $source) {}',
'define apt::source ($location, $comment, $release, $include) {}',
'define ini_setting($ensure = nil,
$path,
$section,
$key_val_separator = nil,
$setting,
$value = nil) {}'
]
end
context 'On an unknown OS with defaults for all parameters' do
let :facts do
{
operatingsystemmajrelease: 10,
osfamily: 'Darwin'
}
end
it { should raise_error(Puppet::Error) }
end
context 'Test the default parameters (RedHat)' do
let :facts do
{
osfamily: 'RedHat',
operatingsystemmajrelease: 7
}
end
it do
should contain_package('cassandra').with(
ensure: 'present',
name: 'cassandra22'
).that_notifies('Exec[cassandra_reload_systemctl]')
should contain_exec('cassandra_reload_systemctl').only_with(
command: '/usr/bin/systemctl daemon-reload',
onlyif: 'test -x /usr/bin/systemctl',
path: ['/usr/bin', '/bin'],
refreshonly: true
)
should contain_file('/etc/cassandra/default.conf').with(
ensure: 'directory',
group: 'cassandra',
owner: 'cassandra',
mode: '0755'
).that_requires('Package[cassandra]')
should contain_file('/etc/cassandra/default.conf/cassandra.yaml')
.with(
ensure: 'present',
owner: 'cassandra',
group: 'cassandra',
mode: '0644'
)
.that_requires('Package[cassandra]')
should contain_class('cassandra').only_with(
baseline_settings: {},
cassandra_2356_sleep_seconds: 5,
cassandra_9822: false,
cassandra_yaml_tmpl: 'cassandra/cassandra.yaml.erb',
commitlog_directory_mode: '0750',
config_file_mode: '0644',
config_path: '/etc/cassandra/default.conf',
data_file_directories_mode: '0750',
dc: 'DC1',
- dc_suffix: nil,
fail_on_non_supported_os: true,
hints_directory_mode: '0750',
package_ensure: 'present',
package_name: 'cassandra22',
rack: 'RAC1',
rackdc_tmpl: 'cassandra/cassandra-rackdc.properties.erb',
saved_caches_directory_mode: '0750',
service_enable: true,
- # service_ensure: nil,
service_name: 'cassandra',
service_provider: nil,
service_refresh: true,
settings: {},
systemctl: '/usr/bin/systemctl'
)
end
end
context 'On RedHat 7 with data directories specified.' do
let :facts do
{
osfamily: 'RedHat',
operatingsystemmajrelease: 7
}
end
let :params do
{
commitlog_directory: '/var/lib/cassandra/commitlog',
data_file_directories: ['/var/lib/cassandra/data'],
hints_directory: '/var/lib/cassandra/hints',
saved_caches_directory: '/var/lib/cassandra/saved_caches',
settings: { 'cluster_name' => 'MyCassandraCluster' }
}
end
it do
should have_resource_count(10)
should contain_file('/var/lib/cassandra/commitlog')
should contain_file('/var/lib/cassandra/data')
should contain_file('/var/lib/cassandra/hints')
should contain_file('/var/lib/cassandra/saved_caches')
end
end
context 'On RedHat 7 with service provider set to init.' do
let :facts do
{
osfamily: 'RedHat',
operatingsystemmajrelease: 7
}
end
let :params do
{
service_provider: 'init'
}
end
it do
should have_resource_count(7)
should contain_exec('/sbin/chkconfig --add cassandra').with(
unless: '/sbin/chkconfig --list cassandra'
)
.that_requires('Package[cassandra]')
.that_comes_before('Service[cassandra]')
end
end
context 'On a Debian OS with defaults for all parameters' do
let :facts do
{
operatingsystemmajrelease: 8,
osfamily: 'Debian'
}
end
it do
should contain_class('cassandra')
should contain_group('cassandra').with_ensure('present')
should contain_package('cassandra').with(
ensure: 'present',
name: 'cassandra'
).that_notifies('Exec[cassandra_reload_systemctl]')
should contain_exec('cassandra_reload_systemctl').only_with(
command: '/bin/systemctl daemon-reload',
onlyif: 'test -x /bin/systemctl',
path: ['/usr/bin', '/bin'],
refreshonly: true
)
should contain_service('cassandra').with(
ensure: nil,
name: 'cassandra',
enable: 'true'
)
should contain_exec('CASSANDRA-2356 sleep')
.with(
command: '/bin/sleep 5',
refreshonly: true,
user: 'root'
)
.that_subscribes_to('Package[cassandra]')
.that_comes_before('Service[cassandra]')
should contain_user('cassandra')
.with(
ensure: 'present',
comment: 'Cassandra database,,,',
gid: 'cassandra',
home: '/var/lib/cassandra',
shell: '/bin/false',
managehome: true
)
.that_requires('Group[cassandra]')
should contain_file('/etc/cassandra').with(
ensure: 'directory',
group: 'cassandra',
owner: 'cassandra',
mode: '0755'
)
should contain_file('/etc/cassandra/cassandra.yaml')
.with(
ensure: 'present',
owner: 'cassandra',
group: 'cassandra',
mode: '0644'
)
.that_comes_before('Package[cassandra]')
.that_requires(['User[cassandra]', 'File[/etc/cassandra]'])
should contain_file('/etc/cassandra/cassandra-rackdc.properties')
.with(
ensure: 'file',
owner: 'cassandra',
group: 'cassandra',
mode: '0644'
)
.that_requires(['File[/etc/cassandra]', 'User[cassandra]'])
.that_comes_before('Package[cassandra]')
should contain_service('cassandra')
.that_subscribes_to(
[
'File[/etc/cassandra/cassandra.yaml]',
'File[/etc/cassandra/cassandra-rackdc.properties]',
'Package[cassandra]'
]
)
end
end
context 'CASSANDRA-9822 activated on Debian' do
let :facts do
{
operatingsystemmajrelease: 7,
osfamily: 'Debian',
lsbdistid: 'Ubuntu',
lsbdistrelease: '14.04'
}
end
let :params do
{
cassandra_9822: true
}
end
it do
should contain_file('/etc/init.d/cassandra').with(
source: 'puppet:///modules/cassandra/CASSANDRA-9822/cassandra',
mode: '0555'
).that_comes_before('Package[cassandra]')
end
end
context 'Install DSE on a Red Hat family OS.' do
let :facts do
{
operatingsystemmajrelease: 7,
osfamily: 'RedHat'
}
end
let :params do
{
package_ensure: '4.7.0-1',
package_name: 'dse-full',
config_path: '/etc/dse/cassandra',
service_name: 'dse'
}
end
it do
should contain_file('/etc/dse/cassandra/cassandra.yaml').that_notifies('Service[cassandra]')
should contain_file('/etc/dse/cassandra')
should contain_file('/etc/dse/cassandra/cassandra-rackdc.properties')
.with(
ensure: 'file',
owner: 'cassandra',
group: 'cassandra',
mode: '0644'
)
.that_notifies('Service[cassandra]')
should contain_package('cassandra').with(
ensure: '4.7.0-1',
name: 'dse-full'
)
is_expected.to contain_service('cassandra').with_name('dse')
end
end
context 'On an unsupported OS pleading tolerance' do
let :facts do
{
operatingsystemmajrelease: 10,
osfamily: 'Darwin'
}
end
let :params do
{
config_file_mode: '0755',
config_path: '/etc/cassandra',
fail_on_non_supported_os: false,
package_name: 'cassandra',
service_provider: 'base',
systemctl: '/bin/true'
}
end
it do
should contain_file('/etc/cassandra/cassandra.yaml').with('mode' => '0755')
should contain_service('cassandra').with(provider: 'base')
should have_resource_count(6)
end
end
context 'Ensure cassandra service can be stopped and disabled.' do
let :facts do
{
operatingsystemmajrelease: 8,
osfamily: 'Debian'
}
end
let :params do
{
service_ensure: 'stopped',
service_enable: 'false'
}
end
it do
should contain_service('cassandra')
.with(ensure: 'stopped',
name: 'cassandra',
enable: 'false')
end
end
context 'Test the dc and rack properties with defaults (Debian).' do
let :facts do
{
operatingsystemmajrelease: 8,
osfamily: 'Debian'
}
end
it do
should contain_file('/etc/cassandra/cassandra-rackdc.properties')
.with_content(/^dc=DC1/)
.with_content(/^rack=RAC1$/)
.with_content(/^#dc_suffix=$/)
.with_content(/^# prefer_local=true$/)
end
end
context 'Test the dc and rack properties with defaults (RedHat).' do
let :facts do
{
operatingsystemmajrelease: 7,
osfamily: 'RedHat'
}
end
it do
should contain_file('/etc/cassandra/default.conf/cassandra-rackdc.properties')
.with_content(/^dc=DC1/)
.with_content(/^rack=RAC1$/)
.with_content(/^#dc_suffix=$/)
.with_content(/^# prefer_local=true$/)
end
end
context 'Test the dc and rack properties.' do
let :facts do
{
operatingsystemmajrelease: 7,
osfamily: 'RedHat'
}
end
let :params do
{
snitch_properties_file: 'cassandra-topology.properties',
dc: 'NYC',
rack: 'R101',
dc_suffix: '_1_cassandra',
prefer_local: 'true'
}
end
it do
should contain_file('/etc/cassandra/default.conf/cassandra-topology.properties')
.with_content(/^dc=NYC$/)
.with_content(/^rack=R101$/)
.with_content(/^dc_suffix=_1_cassandra$/)
.with_content(/^prefer_local=true$/)
end
end
end
diff --git a/spec/classes/schema_spec.rb b/spec/classes/schema_spec.rb
index 5d9867f..9d8bbd4 100644
--- a/spec/classes/schema_spec.rb
+++ b/spec/classes/schema_spec.rb
@@ -1,143 +1,142 @@
require 'spec_helper'
describe 'cassandra::schema' do
let(:pre_condition) do
[
'define ini_setting($ensure = nil,
$path,
$section,
$key_val_separator = nil,
$setting,
$value = nil) {}'
]
end
context 'Ensure that a connection test is made.' do
let :facts do
{
operatingsystemmajrelease: 7,
osfamily: 'RedHat'
}
end
it do
should contain_class('cassandra::schema')
.with(connection_tries: 6,
connection_try_sleep: 30,
cqlsh_additional_options: '',
cqlsh_command: '/usr/bin/cqlsh',
cqlsh_host: 'localhost',
cqlsh_password: nil,
cqlsh_port: 9042,
- cqlsh_user: 'cassandra',
- keyspaces: [])
+ cqlsh_user: 'cassandra')
read_command = '/usr/bin/cqlsh -e \'DESC KEYSPACES\' localhost 9042'
should contain_exec('::cassandra::schema connection test')
.only_with(command: read_command,
returns: 0,
tries: 6,
try_sleep: 30,
unless: read_command)
end
end
context 'Test that users can specify a credentials file.' do
let :facts do
{
id: 'root',
gid: 'root',
operatingsystemmajrelease: 7,
osfamily: 'Debian'
}
end
let :params do
{
cqlsh_client_config: '/root/.puppetcqlshrc'
}
end
it do
should contain_file('/root/.puppetcqlshrc').with(
ensure: 'file',
group: 'root',
mode: '0600',
owner: 'root',
content: /username = cassandra/
).that_comes_before('Exec[::cassandra::schema connection test]')
read_command = "/usr/bin/cqlsh --cqlshrc=/root/.puppetcqlshrc -e 'DESC KEYSPACES' localhost 9042"
should contain_exec('::cassandra::schema connection test')
.only_with(command: read_command,
returns: 0,
tries: 6,
try_sleep: 30,
unless: read_command)
end
end
context 'Test that users can specify a credentials file and password.' do
let :facts do
{
id: 'root',
gid: 'root',
operatingsystemmajrelease: 7,
osfamily: 'Debian'
}
end
let :params do
{
cqlsh_client_config: '/root/.puppetcqlshrc',
cqlsh_password: 'topsecret'
}
end
it do
should contain_file('/root/.puppetcqlshrc').with(
ensure: 'file',
group: 'root',
mode: '0600',
owner: 'root',
content: /password = topsecret/
)
read_command = "/usr/bin/cqlsh --cqlshrc=/root/.puppetcqlshrc -e 'DESC KEYSPACES' localhost 9042"
should contain_exec('::cassandra::schema connection test')
.only_with(command: read_command,
returns: 0,
tries: 6,
try_sleep: 30,
unless: read_command)
end
end
context 'Test that users can specify a password.' do
let :facts do
{
operatingsystemmajrelease: 7,
osfamily: 'Redhat'
}
end
let :params do
{
cqlsh_password: 'topsecret'
}
end
it do
read_command = "/usr/bin/cqlsh -u cassandra -p topsecret -e 'DESC KEYSPACES' localhost 9042"
should contain_exec('::cassandra::schema connection test')
.only_with(command: read_command,
returns: 0,
tries: 6,
try_sleep: 30,
unless: read_command)
end
end
end
diff --git a/spec/spec_helper_acceptance.rb b/spec/spec_helper_acceptance.rb
index 45563ff..2f97515 100644
--- a/spec/spec_helper_acceptance.rb
+++ b/spec/spec_helper_acceptance.rb
@@ -1,508 +1,528 @@
require 'beaker-rspec'
require 'pry'
class TestManifests
- def initialize(roles, version)
+ def initialize(roles, version, operatingsystemmajrelease)
# Instance variables
@roles = roles
@version = version
if version == 2.1
init21
elsif version == 2.2
init22
elsif version == 3.0
- init30
+ init30(operatingsystemmajrelease)
end
end
def init21
@debian_release = '21x'
- @debian_package_ensure = '2.1.17'
+ @debian_package_ensure = '2.1.18'
@redhat_package_ensure = '2.1.15-1'
@cassandra_optutils_package = 'cassandra21-tools'
@cassandra_package = 'cassandra21'
end
def init22
@debian_release = '22x'
- @debian_package_ensure = '2.2.9'
+ @debian_package_ensure = '2.2.10'
@redhat_package_ensure = '2.2.8-1'
@cassandra_optutils_package = 'cassandra22-tools'
@cassandra_package = 'cassandra22'
end
- def init30
+ def init30(operatingsystemmajrelease)
@debian_release = '30x'
- @debian_package_ensure = '3.0.13'
- @redhat_package_ensure = '3.0.9-1'
- @cassandra_optutils_package = 'cassandra30-tools'
- @cassandra_package = 'cassandra30'
+ @debian_package_ensure = '3.0.14'
+ print "operatingsystemmajrelease := #{operatingsystemmajrelease}"
+
+ if operatingsystemmajrelease == '6'
+ @redhat_package_ensure = '3.0.9-1'
+ @cassandra_optutils_package = 'cassandra30-tools'
+ @cassandra_package = 'cassandra30'
+ else
+ @redhat_release = '30x'
+ @redhat_package_ensure = '3.0.14-1'
+ @cassandra_optutils_package = 'cassandra-tools'
+ @cassandra_package = 'cassandra'
+ end
end
def bootstrap_pp
<<-EOS
Exec {
path => [
'/usr/local/bin',
'/opt/local/bin',
'/usr/bin',
'/usr/sbin',
'/bin',
'/sbin'],
logoutput => true,
}
- notify { "${::operatingsystem}-${::operatingsystemmajrelease}": }
+ notify { "${::hostname}:${::operatingsystem}-${::operatingsystemmajrelease}": }
file { '/etc/dse':
ensure => directory,
} ->
file { '/etc/dse/dse-env.sh':
ensure => present,
content => "#export DSE_HOME\n# export HADOOP_LOG_DIR=",
}
case downcase("${::operatingsystem}-${::operatingsystemmajrelease}") {
'centos-6': {
package { ['gcc', 'tar', 'yum-utils', 'centos-release-scl']: } ->
exec { 'yum-config-manager --enable rhel-server-rhscl-7-rpms': } ->
package { 'ruby200': } ->
package { 'python27-python':
ensure => '2.7.8-18.el6',
} ->
exec { 'cp /opt/rh/python27/enable /etc/profile.d/python.sh': } ->
exec { 'echo "\n" >> /etc/profile.d/python.sh': } ->
exec { 'echo "export PYTHONPATH=/usr/lib/python2.7/site-packages" >> /etc/profile.d/python.sh': } ->
exec { '/bin/cp /opt/rh/ruby200/enable /etc/profile.d/ruby.sh': } ->
exec { '/bin/rm /usr/bin/ruby /usr/bin/gem': } ->
exec { '/usr/sbin/alternatives --install /usr/bin/ruby ruby /opt/rh/ruby200/root/usr/bin/ruby 1000': } ->
exec { '/usr/sbin/alternatives --install /usr/bin/gem gem /opt/rh/ruby200/root/usr/bin/gem 1000': }
}
'centos-7': {
package { ['gcc', 'tar', 'initscripts']: }
}
'debian-7': {
package { ['sudo', 'ufw', 'wget']: }
}
'debian-8': {
package { ['locales-all', 'net-tools', 'sudo', 'ufw']: } ->
file { '/usr/sbin/policy-rc.d':
ensure => absent,
}
}
'ubuntu-12.04': {
package {['python-software-properties', 'iptables', 'sudo']:} ->
exec {'/usr/bin/apt-add-repository ppa:brightbox/ruby-ng':} ->
exec {'/usr/bin/apt-get update': } ->
package {'ruby2.0': } ->
exec { '/bin/rm /usr/bin/ruby': } ->
exec { '/usr/sbin/update-alternatives --install /usr/bin/ruby ruby /usr/bin/ruby2.0 1000': }
}
'ubuntu-16.04': {
package { ['locales-all', 'net-tools', 'sudo', 'ufw']: } ->
file { '/usr/sbin/policy-rc.d':
ensure => absent,
}
}
}
EOS
end
def cassandra_install_pp
<<-EOS
if $::osfamily == 'Debian' {
class { 'cassandra::apache_repo':
release => '#{@debian_release}',
before => Class['cassandra', 'cassandra::optutils'],
}
$package_ensure = '#{@debian_package_ensure}'
$cassandra_package = 'cassandra'
$cassandra_optutils_package = 'cassandra-tools'
} else {
- class { 'cassandra::datastax_repo':
- before => Class['cassandra', 'cassandra::optutils'],
+ if #{@version} >= 3.0 and $::operatingsystemmajrelease >= 7 {
+ yumrepo { 'datastax':
+ ensure => absent,
+ } ->
+ class { 'cassandra::apache_repo':
+ release => '#{@redhat_release}',
+ before => Class['cassandra', 'cassandra::optutils'],
+ }
+ } else {
+ class { 'cassandra::datastax_repo':
+ before => Class['cassandra', 'cassandra::optutils'],
+ }
}
+
$package_ensure = '#{@redhat_package_ensure}'
$cassandra_package = '#{@cassandra_package}'
$cassandra_optutils_package = '#{@cassandra_optutils_package}'
}
require cassandra::system::swapoff
require cassandra::system::transparent_hugepage
include cassandra::java
if versioncmp($::rubyversion, '1.9.0') < 0 {
$service_refresh = false
} else {
$service_refresh = true
}
if #{@version} >= 3.0 {
class { 'cassandra':
hints_directory => '/var/lib/cassandra/hints',
package_ensure => $package_ensure,
package_name => $cassandra_package,
service_refresh => $service_refresh,
require => Class['cassandra::java'],
}
} else {
class { 'cassandra':
package_ensure => $package_ensure,
package_name => $cassandra_package,
service_refresh => $service_refresh,
require => Class['cassandra::java'],
}
}
class { 'cassandra::optutils':
package_ensure => $package_ensure,
package_name => $cassandra_optutils_package,
require => Class['cassandra']
}
if $::osfamily == 'RedHat' {
class { 'cassandra::datastax_agent':
require => Class['cassandra']
}
}
#{firewall_pp}
include cassandra::dse
EOS
end
def cassandra_uninstall_pp
<<-EOS
Exec {
path => [
'/usr/bin',
'/bin' ],
logoutput => true,
}
if $::osfamily == 'RedHat' {
$cassandra_optutils_package = '#{@cassandra_optutils_package}'
$cassandra_package = '#{@cassandra_package}'
} else {
$cassandra_optutils_package = 'cassandra-tools'
$cassandra_package = 'cassandra'
}
service { 'cassandra':
ensure => stopped,
} ->
package { $cassandra_optutils_package:
ensure => purged,
} ->
package { $cassandra_package:
ensure => purged,
} ->
exec { 'rm -rf /var/lib/cassandra/*/* /var/log/cassandra/*': }
EOS
end
def facts_testing_pp
<<-EOS
#{cassandra_install_pp}
if $::osfamily == 'Debian' {
$package_comparison = $cassandrarelease
} else {
$package_comparison = "${cassandrarelease}-1"
}
if $package_comparison != $package_ensure {
fail("cassandrarelease: ${package_comparison} != ${package_ensure}")
}
if $::cassandramaxheapsize <= 0 {
fail('cassandramaxheapsize is not set.')
}
if $::cassandracmsmaxheapsize <= 0 {
fail('cassandracmsmaxheapsize is not set.')
}
if $::cassandraheapnewsize <= 0 {
fail('cassandraheapnewsize is not set.')
}
if $::cassandracmsheapnewsize <= 0 {
fail('cassandracmsheapnewsize is not set.')
}
EOS
end
def firewall_pp
pp = if @roles.include? 'firewall'
<<-EOS
class { '::cassandra::firewall_ports':
require => Class['::cassandra'],
}
EOS
else
<<-EOS
# Firewall test skipped
EOS
end
pp
end
def permissions_revoke_pp
<<-EOS
#{cassandra_install_pp}
class { 'cassandra::schema':
cqlsh_password => 'Niner2',
cqlsh_user => 'akers',
cqlsh_client_config => '/root/.puppetcqlshrc',
permissions => {
'Revoke select permissions to spillman to all keyspaces' => {
ensure => absent,
permission_name => 'SELECT',
user_name => 'spillman',
},
'Revoke modify to to keyspace mykeyspace to akers' => {
ensure => absent,
keyspace_name => 'mykeyspace',
permission_name => 'MODIFY',
user_name => 'akers',
},
'Revoke alter permissions to mykeyspace to boone' => {
ensure => absent,
keyspace_name => 'mykeyspace',
permission_name => 'ALTER',
user_name => 'boone',
},
'Revoke ALL permissions to mykeyspace.users to gbennet' => {
ensure => absent,
keyspace_name => 'mykeyspace',
permission_name => 'ALTER',
table_name => 'users',
user_name => 'gbennet',
},
},
}
EOS
end
def schema_create_pp
<<-EOS
#{cassandra_install_pp}
$cql_types = {
'fullname' => {
'keyspace' => 'mykeyspace',
'fields' => {
'fname' => 'text',
'lname' => 'text',
},
},
}
$keyspaces = {
'mykeyspace' => {
ensure => present,
replication_map => {
keyspace_class => 'SimpleStrategy',
replication_factor => 1,
},
durable_writes => false,
},
}
class { 'cassandra::schema':
cql_types => $cql_types,
cqlsh_password => 'cassandra',
cqlsh_user => 'cassandra',
indexes => {
'users_lname_idx' => {
keyspace => 'mykeyspace',
table => 'users',
keys => 'lname',
},
},
keyspaces => $keyspaces,
tables => {
'users' => {
'keyspace' => 'mykeyspace',
'columns' => {
'userid' => 'int',
'fname' => 'text',
'lname' => 'text',
'PRIMARY KEY' => '(userid)',
},
},
},
permissions => {
'Grant select permissions to spillman to all keyspaces' => {
permission_name => 'SELECT',
user_name => 'spillman',
},
'Grant modify to to keyspace mykeyspace to akers' => {
keyspace_name => 'mykeyspace',
permission_name => 'MODIFY',
user_name => 'akers',
},
'Grant alter permissions to mykeyspace to boone' => {
keyspace_name => 'mykeyspace',
permission_name => 'ALTER',
user_name => 'boone',
},
'Grant ALL permissions to mykeyspace.users to gbennet' => {
keyspace_name => 'mykeyspace',
permission_name => 'ALTER',
table_name => 'users',
user_name => 'gbennet',
},
},
users => {
'akers' => {
password => 'Niner2',
superuser => true,
},
'boone' => {
password => 'Niner75',
},
'gbennet' => {
password => 'Strewth',
},
'spillman' => {
password => 'Niner27',
},
'bob' => {
password => 'kaZe89a',
login => false,
},
'john' => {
superuser => true,
password => 'kaZe89a',
login => true,
},
},
}
EOS
end
def schema_drop_index_pp
<<-EOS
#{cassandra_install_pp}
class { 'cassandra::schema':
cqlsh_user => 'akers',
cqlsh_password => 'Niner2',
indexes => {
'users_lname_idx' => {
ensure => absent,
keyspace => 'mykeyspace',
table => 'users',
},
},
}
EOS
end
def schema_drop_table_pp
<<-EOS
#{cassandra_install_pp}
class { 'cassandra::schema':
cqlsh_password => 'Niner2',
cqlsh_user => 'akers',
tables => {
'users' => {
ensure => absent,
keyspace => 'mykeyspace',
},
},
}
EOS
end
def schema_drop_keyspace_pp
<<-EOS
#{cassandra_install_pp}
$keyspaces = {
'mykeyspace' => {
ensure => absent,
}
}
class { 'cassandra::schema':
cqlsh_password => 'Niner2',
cqlsh_user => 'akers',
keyspaces => $keyspaces,
}
EOS
end
def schema_drop_type_pp
pp = <<-EOS
#{cassandra_install_pp}
$cql_types = {
'fullname' => {
'keyspace' => 'mykeyspace',
'ensure' => 'absent'
}
}
class { 'cassandra::schema':
cql_types => $cql_types,
cqlsh_user => 'akers',
cqlsh_password => 'Niner2',
}
EOS
pp
end
def schema_drop_user_pp
pp = <<-EOS
#{cassandra_install_pp}
class { 'cassandra::schema':
cqlsh_password => 'Niner2',
cqlsh_user => 'akers',
cqlsh_client_config => '/root/.puppetcqlshrc',
users => {
'boone' => {
ensure => absent,
},
},
}
EOS
pp
end
end
hosts.each do |host|
case host.name
when 'ubuntu1604'
host.install_package('puppet')
else
install_puppet_on(host)
end
end
RSpec.configure do |c|
module_root = File.expand_path(File.join(File.dirname(__FILE__), '..'))
c.formatter = :documentation
# Configure all nodes in nodeset
c.before :suite do
# Install modules
puppet_module_install(source: module_root, module_name: 'cassandra')
hosts.each do |host|
on host, puppet('module', 'install',
'puppetlabs-apt'), acceptable_exit_codes: [0, 1]
on host, puppet('module', 'install',
'puppetlabs-firewall'), acceptable_exit_codes: [0, 1]
on host, puppet('module', 'install',
'puppetlabs-inifile'), acceptable_exit_codes: [0, 1]
on host, puppet('module', 'install',
'puppetlabs-stdlib'), acceptable_exit_codes: [0, 1]
# Install hiera
write_hiera_config_on(host,
[
'environments/%{environment}/data/fqdn/%{fqdn}',
'environments/%{environment}/data/osfamily/%{osfamily}/%{lsbdistcodename}',
'environments/%{environment}/data/osfamily/%{osfamily}/%{lsbmajdistrelease}',
'environments/%{environment}/data/osfamily/%{osfamily}/%{architecture}',
'environments/%{environment}/data/osfamily/%{osfamily}/common',
# 'environments/%{environment}/data/modules/%{cname}',
'environments/%{environment}/data/modules/%{caller_module_name}',
'environments/%{environment}/data/modules/%{module_name}',
'environments/%{environment}/data/common'
])
copy_hiera_data_to(host, './spec/acceptance/hieradata/')
end
end
end