From 728eaedcee7995445fd82137529c18d28333d5bc Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 06:48:23 +0100 Subject: [PATCH 01/12] Changed the project page to http://locp.github.io/cassandra (#98). --- metadata.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metadata.json b/metadata.json index 2b7f26bb..22dd0275 100644 --- a/metadata.json +++ b/metadata.json @@ -5,7 +5,7 @@ "summary": "A Puppet module to install and manage Cassandra, DataStax Agent & OpsCenter", "license": "Apache-2.0", "source": "https://github.com/locp/cassandra", - "project_page": "https://github.com/locp/cassandra", + "project_page": "http://locp.github.io/cassandra", "issues_url": "https://github.com/locp/cassandra/issues", "tags": [ "cassandra", From fa73ef5d79b053482921b26d4f7cc7df7e1a7287 Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 06:56:56 +0100 Subject: [PATCH 02/12] Ensure fast navigation to all resources in the README (#98). --- README.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index e95b58d3..6ba88783 100644 --- a/README.md +++ b/README.md @@ -327,17 +327,17 @@ cassandra::opscenter::cluster_name { 'Cluster1': ### Public Classes -* **cassandra** -* **cassandra::datastax_agent** -* **cassandra::datastax_repo** -* **cassandra::firewall_ports** -* **cassandra::java** -* **cassandra::opscenter** -* **cassandra::opscenter::pycrypto** -* **cassandra::optutils** +* [cassandra](#class-cassandra) +* [cassandra::datastax_agent](#class-cassandradatastax_agent) +* [cassandra::datastax_repo](#class-cassandradatastax_repo) +* [cassandra::firewall_ports](#class-cassandrafirewall_ports) +* [cassandra::java](#class-cassandrajava) +* [cassandra::opscenter](#class-cassandraopscenter) +* [cassandra::opscenter::pycrypto](#class-cassandraopscenterpycrypto) +* [cassandra::optutils](#class-cassandraoptutils) ### Public Defined Types -* **cassandra::opscenter::cluster_name** +* [cassandra::opscenter::cluster_name](#defined-type-cassandraopscentercluster_name) ### Private Defined Types From d7c9fc40cbdd1b68aa04f33dd1e736ebc0e26e12 Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 07:02:12 +0100 Subject: [PATCH 03/12] Minor formatting (#98). --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 6ba88783..1e088edb 100644 --- a/README.md +++ b/README.md @@ -341,8 +341,8 @@ cassandra::opscenter::cluster_name { 'Cluster1': ### Private Defined Types -* **cassandra::opscenter::setting** -* **cassandra::firewall_ports::rule** +* cassandra::opscenter::setting +* cassandra::firewall_ports::rule ### Class: cassandra From 6a63379baa700327f9ce595d11d2cd3559d990a8 Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 07:39:05 +0100 Subject: [PATCH 04/12] Some work on Ensure how defaults are shown is consistent (#98). --- README.md | 318 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 164 insertions(+), 154 deletions(-) diff --git a/README.md b/README.md index 1e088edb..e65c9ded 100644 --- a/README.md +++ b/README.md @@ -353,263 +353,266 @@ configuration file. ##### `authenticator` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **AllowAllAuthenticator**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default value: 'AllowAllAuthenticator. ##### `authorizer` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default: **AllowAllAuthorizer**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default value: 'AllowAllAuthorizer' ##### `auto_snapshot` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **true**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default value 'true' ##### `cassandra_9822` If set to true, this will apply a patch to the init file for the Cassandra service as a workaround for [CASSANDRA-9822](https://issues.apache.org/jira/browse/CASSANDRA-9822). This option is silently ignored on the Red Hat family of operating systems as -this bug only affects Ubuntu systems (default **false**). +this bug only affects Ubuntu systems. +Default 'false' ##### `cassandra_yaml_tmpl` The path to the Puppet template for the Cassandra configuration file. This allows the user to supply their own customized template. A Cassandra 1.X -compatible template called cassandra1.yaml.erb has been provided by @Spredzy -(default **cassandra/cassandra.yaml.erb**). +compatible template called cassandra1.yaml.erb has been provided by @Spredzy. +Default 'cassandra/cassandra.yaml.erb' ##### `client_encryption_enabled` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **false**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'false' ##### `client_encryption_keystore` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **conf/.keystore**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'conf/.keystore' ##### `client_encryption_keystore_password` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **cassandra**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'cassandra' ##### `cluster_name` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **Test Cluster**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'Test Cluster' ##### `commitlog_directory` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **/var/lib/cassandra/commitlog**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '/var/lib/cassandra/commitlog' ##### `concurrent_counter_writes` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **32**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '32' ##### `concurrent_reads` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **32**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '32' ##### `concurrent_writes` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **32**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '32' ##### `config_path` The path to the cassandra configuration file. If this is undef, it will be changed to **/etc/cassandra/default.conf** on the Red Hat family of operating systems or **/etc/cassandra** on Ubuntu. Otherwise the user can specify the -path name -(default **undef**). +path name. +Default 'undef' ##### `data_file_directories` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **['/var/lib/cassandra/data']**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '['/var/lib/cassandra/data']' ##### `dc` Sets the value for dc in *config_path*/*snitch_properties_file* see http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html -for more details -(default **DC1**). +for more details. +Default 'DC1' ##### `dc_suffix` Sets the value for dc_suffix in *config_path*/*snitch_properties_file* see http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html for more details. If the value is *undef* then change will be made to the -snitch properties file for this setting -(default *undef*). +snitch properties file for this setting. +Default *undef* ##### `disk_failure_policy` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default: **stop**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'stop' ##### `endpoint_snitch` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default: **SimpleSnitch**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'SimpleSnitch' ##### `hinted_handoff_enabled` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(defaults to **'true'**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'true' ##### `incremental_backups` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **false**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'false' ##### `internode_compression` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **all**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'all' ##### `listen_address` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **localhost**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'localhost' ##### `manage_dsc_repo` DEPRECATION WARNING: This option is deprecated. Please include the the ::cassandra::datastax_repo instead. If set to true then a repository will be setup so that packages can be -downloaded from DataStax community (default **false**). +downloaded from DataStax community. +Default 'false' ##### `native_transport_port` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **9042**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '9042' ##### `num_tokens` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **256**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '256' ##### `package_ensure` The status of the package specified in **package_name**. Can be -*present*, *latest* or a specific version number (default **present**). +*present*, *latest* or a specific version number. +Default 'present' ##### `package_name` -The name of the Cassandra package. Must be available from a repository -(default **dsc22**). +The name of the Cassandra package. Must be available from a repository. +Default 'dsc22' ##### `partitioner` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **org.apache.cassandra.dht.Murmur3Partitioner**) +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'org.apache.cassandra.dht.Murmur3Partitioner' ##### `prefer_local` Sets the value for prefer_local in *config_path*/*snitch_properties_file* see http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html for more details. Valid values are true, false or *undef*. If the value is *undef* then change will be made to the snitch properties file for this -setting +setting. (default *undef*). ##### `rack` Sets the value for rack in *config_path*/*snitch_properties_file* see http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html -for more details -(default **RAC1**). +for more details. +Default 'RAC1' ##### `rpc_address` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **localhost**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'localhost' ##### `rpc_port` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **9160**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '9160' ##### `rpc_server_type` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **sync**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'sync' ##### `saved_caches_directory` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **/var/lib/cassandra/saved_caches**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '/var/lib/cassandra/saved_caches' ##### `seeds` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **127.0.0.1**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '127.0.0.1' ##### `server_encryption_internode` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **none**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'none' ##### `server_encryption_keystore` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **conf/.keystore**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'conf/.keystore' ##### `server_encryption_keystore_password` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **cassandra**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'cassandra' ##### `server_encryption_truststore` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **conf/.truststore**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'conf/.truststore' ##### `server_encryption_truststore_password` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **cassandra**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'cassandra' ##### `service_enable` Enable the Cassandra service to start at boot time. Valid values are true -or false -(default: **true**) +or false. +Default 'true' ##### `service_ensure` -Ensure the Cassandra service is running. Valid values are running or stopped -(default: **running**) +Ensure the Cassandra service is running. Valid values are running or stopped. +Default 'running' ##### `service_name` -The name of the service that runs the Cassandra software (default -**cassandra**). +The name of the service that runs the Cassandra software. +Default 'cassandra' ##### `snapshot_before_compaction` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **false**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'false' ##### `snitch_properties_file` The name of the snitch properties file. The full path name would be -*config_path*/*snitch_properties_file* -(default **cassandra-rackdc.properties**). +*config_path*/*snitch_properties_file*. +Default 'cassandra-rackdc.properties' ##### `ssl_storage_port` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **7001**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '7001' ##### `start_native_transport` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **true**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'true' ##### `start_rpc` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **true**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default 'true' ##### `storage_port` This is passed to the -[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file -(default **7000**). +[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. +Default '7000' ### Class: cassandra::datastax_agent @@ -620,27 +623,31 @@ instance. ##### `package_ensure` Is passed to the package reference. Valid values are **present** or a version -number -(default **present**). +number. +Default 'present' ##### `package_name` -Is passed to the package reference (default **datastax-agent**). +Is passed to the package reference. +Default 'datastax-agent' ##### `service_ensure` -Is passed to the service reference (default **running**). +Is passed to the service reference. +Default 'running' ##### `service_enable` -Is passed to the service reference (default **true**). +Is passed to the service reference. +Default 'true' ##### `service_name` -Is passed to the service reference (default **datastax-agent**). +Is passed to the service reference. +Default 'datastax-agent' ##### `stomp_interface` If the value is changed from the default of *undef* then this is what is set as the stomp_interface setting in **/var/lib/datastax-agent/conf/address.yaml** -which connects the agent to an OpsCenter instance -(default **undef**). +which connects the agent to an OpsCenter instance. +Default 'undef' ### Class: cassandra::datastax_repo @@ -669,52 +676,52 @@ it must be the final cassandra class included in the manifest. Only has any effect if the `cassandra` class is defined on the node. Allow these TCP ports to be opened for traffic -coming from the client subnets -(default **[9042, 9160]**). +coming from the client subnets. +Default '[9042, 9160]' ##### `client_subnets` Only has any effect if the `cassandra` class is defined on the node. An array of the list of subnets that are to allowed connection to cassandra::native_transport_port and cassandra::rpc_port. -(default **['0.0.0.0/0']**). +Default '['0.0.0.0/0']' ##### `inter_node_ports` Only has any effect if the `cassandra` class is defined on the node. Allow these TCP ports to be opened for traffic -between the Cassandra nodes -(default **[7000, 7001, 7199]**). +between the Cassandra nodes. +Default '[7000, 7001, 7199]' ##### `inter_node_subnets` Only has any effect if the `cassandra` class is defined on the node. An array of the list of subnets that are to allowed connection to cassandra::storage_port, cassandra::ssl_storage_port and port 7199 -for cassandra JMX monitoring -(default **['0.0.0.0/0']**). +for cassandra JMX monitoring. +Default '['0.0.0.0/0']' ##### `inter_node_ports` Allow these TCP ports to be opened for traffic -coming from OpsCenter subnets -(default **[7000, 7001, 7199]**). +coming from OpsCenter subnets. +Default '[7000, 7001, 7199]' ##### `public_ports` Allow these TCP ports to be opened for traffic coming from public subnets the port specified in `$ssh_port` will be -appended to this list -(default **[8888]**). +appended to this list. +Default '[8888]' ##### `public_subnets` An array of the list of subnets that are to allowed connection to cassandra::firewall_ports::ssh_port and if cassandra::opscenter has been included, both cassandra::opscenter::webserver_port and -cassandra::opscenter::webserver_ssl_port -(default **['0.0.0.0/0']**). +cassandra::opscenter::webserver_ssl_port. +Default '['0.0.0.0/0']' ##### `ssh_port` -Which port does SSH operate on -(default **22**). +Which port does SSH operate on. +Default '22' ##### `opscenter_ports` Only has any effect if the `cassandra::datastax_agent` or @@ -722,14 +729,14 @@ Only has any effect if the `cassandra::datastax_agent` or Allow these TCP ports to be opened for traffic coming to or from OpsCenter -appended to this list -(default **[61620, 61621]**). +appended to this list. +Default '[61620, 61621]' ##### `opscenter_subnets` A list of subnets that are to be allowed connection to port 61620 for nodes built with cassandra::opscenter and 61621 for nodes -built with cassandra::datastax_agent -(default **['0.0.0.0/0']**). +built with cassandra::datastax_agent. +Default '['0.0.0.0/0']' ### Class: cassandra::java @@ -739,25 +746,28 @@ A class to install an appropriate Java package. ##### `ensure` Is passed to the package reference for the JRE/JDK package. Valid values are -**present** or a version -number (default **present**). +**present** or a version number. +Default 'present' ##### `jna_ensure` Is passed to the package reference for the JNA package. Valid values are -**present** or a version number (default **present**). +**present** or a version number. +Default 'present' ##### `jna_package_name` If the default value of *undef* is left as it is, then a package called jna or libjna-java will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in -a package repository to the node (default **undef**). +a package repository to the node. +Default 'undef' ##### `package_name` If the default value of *undef* is left as it is, then a package called java-1.8.0-openjdk-headless or openjdk-7-jre-headless will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the -node (default **undef**). +node. +Default 'undef' ### Class: cassandra::opscenter @@ -1020,8 +1030,8 @@ for more details. A value of *undef* will ensure the setting is not present in the file. Default value *undef* ##### `config_file` -The full path to the OpsCenter configuration file -(default **/etc/opscenter/opscenterd.conf**). +The full path to the OpsCenter configuration file. +Default '/etc/opscenter/opscenterd.conf' ##### `definitions_auto_update` This sets the auto_update setting in the definitions section of the @@ -1088,8 +1098,8 @@ in the file. Default value *undef* ##### `ensure` This is passed to the package reference for **opscenter**. Valid values are -**present** or a version number -(default **present**). +**present** or a version number. +Default 'present' ##### `failover_configuration_directory` This sets the failover_configuration_directory setting in the failover section of the @@ -1323,8 +1333,8 @@ for more details. A value of *undef* will ensure the setting is not present in the file. Default value *undef* ##### `package_name` -The name of the OpsCenter package -(default **opscenter**). +The name of the OpsCenter package. +Default 'opscenter' ##### `provisioning_agent_install_timeout` This sets the agent_install_timeout setting in the provisioning section of the @@ -1531,16 +1541,16 @@ in the file. Default value *undef* ##### `service_enable` Enable the OpsCenter service to start at boot time. Valid values are true -or false -(default: **true**) +or false. +Default 'true**) ##### `service_ensure` -Ensure the OpsCenter service is running. Valid values are running or stopped -(default: **running**) +Ensure the OpsCenter service is running. Valid values are running or stopped. +Default 'running**) ##### `service_name` -The name of the service that runs the OpsCenter software -(default: **opscenterd**). +The name of the service that runs the OpsCenter software. +Default 'opscenterd' ##### `spark_base_master_proxy_port` This sets the base_master_proxy_port setting in the spark section of the @@ -1684,24 +1694,24 @@ family. ##### `ensure` This is passed to the package reference for **pycrypto**. Valid values are -**present** or a version number -(default **present**). +**present** or a version number. +Default 'present' ##### `manage_epel` -If set to true, the **epel-release** package will be installed -(default **false**). +If set to true, the **epel-release** package will be installed. +Default 'false' ##### `package_name` -The name of the PyCrypto package -(default **pycrypto**). +The name of the PyCrypto package. +Default 'pycrypto' ##### `provider` -The name of the provider of the pycrypto package -(default **pip**). +The name of the provider of the pycrypto package. +Default 'pip' ##### `reqd_pckgs` -Packages that are required to install the pycrypto package -(default **['python-devel', 'python-pip' ]**). +Packages that are required to install the pycrypto package. +Default '['python-devel', 'python-pip' ]' ### Class: cassandra::optutils @@ -1711,16 +1721,16 @@ A class to install the optional Cassandra tools package. ##### `ensure` Is passed to the package reference. Valid values are **present** or a version -number -(default **present**). +number. +Default 'present' ##### `package_name` If the default value of *undef* is left as it is, then a package called cassandra22-tools or cassandra-tools will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the -node -(default **undef**). +node. +Default 'undef' ### Defined Type cassandra::opscenter::cluster_name From 491fc5e98f3692f0e87853387d7ce1ade82d5e53 Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 07:50:39 +0100 Subject: [PATCH 05/12] Some work on Ensure how defaults are shown is consistent (#98). --- README.md | 156 +++++++++++++++++++++++++++--------------------------- 1 file changed, 78 insertions(+), 78 deletions(-) diff --git a/README.md b/README.md index e65c9ded..21120949 100644 --- a/README.md +++ b/README.md @@ -372,71 +372,71 @@ service as a workaround for [CASSANDRA-9822](https://issues.apache.org/jira/browse/CASSANDRA-9822). This option is silently ignored on the Red Hat family of operating systems as this bug only affects Ubuntu systems. -Default 'false' +Default value 'false' ##### `cassandra_yaml_tmpl` The path to the Puppet template for the Cassandra configuration file. This allows the user to supply their own customized template. A Cassandra 1.X compatible template called cassandra1.yaml.erb has been provided by @Spredzy. -Default 'cassandra/cassandra.yaml.erb' +Default value 'cassandra/cassandra.yaml.erb' ##### `client_encryption_enabled` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'false' +Default value 'false' ##### `client_encryption_keystore` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'conf/.keystore' +Default value 'conf/.keystore' ##### `client_encryption_keystore_password` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'cassandra' +Default value 'cassandra' ##### `cluster_name` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'Test Cluster' +Default value 'Test Cluster' ##### `commitlog_directory` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '/var/lib/cassandra/commitlog' +Default value '/var/lib/cassandra/commitlog' ##### `concurrent_counter_writes` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '32' +Default value '32' ##### `concurrent_reads` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '32' +Default value '32' ##### `concurrent_writes` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '32' +Default value '32' ##### `config_path` The path to the cassandra configuration file. If this is undef, it will be changed to **/etc/cassandra/default.conf** on the Red Hat family of operating systems or **/etc/cassandra** on Ubuntu. Otherwise the user can specify the path name. -Default 'undef' +Default value 'undef' ##### `data_file_directories` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '['/var/lib/cassandra/data']' +Default value '['/var/lib/cassandra/data']' ##### `dc` Sets the value for dc in *config_path*/*snitch_properties_file* see http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html for more details. -Default 'DC1' +Default value 'DC1' ##### `dc_suffix` Sets the value for dc_suffix in *config_path*/*snitch_properties_file* see @@ -448,32 +448,32 @@ Default *undef* ##### `disk_failure_policy` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'stop' +Default value 'stop' ##### `endpoint_snitch` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'SimpleSnitch' +Default value 'SimpleSnitch' ##### `hinted_handoff_enabled` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'true' +Default value 'true' ##### `incremental_backups` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'false' +Default value 'false' ##### `internode_compression` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'all' +Default value 'all' ##### `listen_address` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'localhost' +Default value 'localhost' ##### `manage_dsc_repo` DEPRECATION WARNING: This option is deprecated. Please include the @@ -481,31 +481,31 @@ the ::cassandra::datastax_repo instead. If set to true then a repository will be setup so that packages can be downloaded from DataStax community. -Default 'false' +Default value 'false' ##### `native_transport_port` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '9042' +Default value '9042' ##### `num_tokens` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '256' +Default value '256' ##### `package_ensure` The status of the package specified in **package_name**. Can be *present*, *latest* or a specific version number. -Default 'present' +Default value 'present' ##### `package_name` The name of the Cassandra package. Must be available from a repository. -Default 'dsc22' +Default value 'dsc22' ##### `partitioner` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'org.apache.cassandra.dht.Murmur3Partitioner' +Default value 'org.apache.cassandra.dht.Murmur3Partitioner' ##### `prefer_local` Sets the value for prefer_local in *config_path*/*snitch_properties_file* see @@ -519,100 +519,100 @@ setting. Sets the value for rack in *config_path*/*snitch_properties_file* see http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html for more details. -Default 'RAC1' +Default value 'RAC1' ##### `rpc_address` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'localhost' +Default value 'localhost' ##### `rpc_port` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '9160' +Default value '9160' ##### `rpc_server_type` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'sync' +Default value 'sync' ##### `saved_caches_directory` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '/var/lib/cassandra/saved_caches' +Default value '/var/lib/cassandra/saved_caches' ##### `seeds` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '127.0.0.1' +Default value '127.0.0.1' ##### `server_encryption_internode` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'none' +Default value 'none' ##### `server_encryption_keystore` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'conf/.keystore' +Default value 'conf/.keystore' ##### `server_encryption_keystore_password` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'cassandra' +Default value 'cassandra' ##### `server_encryption_truststore` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'conf/.truststore' +Default value 'conf/.truststore' ##### `server_encryption_truststore_password` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'cassandra' +Default value 'cassandra' ##### `service_enable` Enable the Cassandra service to start at boot time. Valid values are true or false. -Default 'true' +Default value 'true' ##### `service_ensure` Ensure the Cassandra service is running. Valid values are running or stopped. -Default 'running' +Default value 'running' ##### `service_name` The name of the service that runs the Cassandra software. -Default 'cassandra' +Default value 'cassandra' ##### `snapshot_before_compaction` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'false' +Default value 'false' ##### `snitch_properties_file` The name of the snitch properties file. The full path name would be *config_path*/*snitch_properties_file*. -Default 'cassandra-rackdc.properties' +Default value 'cassandra-rackdc.properties' ##### `ssl_storage_port` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '7001' +Default value '7001' ##### `start_native_transport` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'true' +Default value 'true' ##### `start_rpc` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default 'true' +Default value 'true' ##### `storage_port` This is passed to the [cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file. -Default '7000' +Default value '7000' ### Class: cassandra::datastax_agent @@ -624,30 +624,30 @@ instance. ##### `package_ensure` Is passed to the package reference. Valid values are **present** or a version number. -Default 'present' +Default value 'present' ##### `package_name` Is passed to the package reference. -Default 'datastax-agent' +Default value 'datastax-agent' ##### `service_ensure` Is passed to the service reference. -Default 'running' +Default value 'running' ##### `service_enable` Is passed to the service reference. -Default 'true' +Default value 'true' ##### `service_name` Is passed to the service reference. -Default 'datastax-agent' +Default value 'datastax-agent' ##### `stomp_interface` If the value is changed from the default of *undef* then this is what is set as the stomp_interface setting in **/var/lib/datastax-agent/conf/address.yaml** which connects the agent to an OpsCenter instance. -Default 'undef' +Default value 'undef' ### Class: cassandra::datastax_repo @@ -677,21 +677,21 @@ Only has any effect if the `cassandra` class is defined on the node. Allow these TCP ports to be opened for traffic coming from the client subnets. -Default '[9042, 9160]' +Default value '[9042, 9160]' ##### `client_subnets` Only has any effect if the `cassandra` class is defined on the node. An array of the list of subnets that are to allowed connection to cassandra::native_transport_port and cassandra::rpc_port. -Default '['0.0.0.0/0']' +Default value '['0.0.0.0/0']' ##### `inter_node_ports` Only has any effect if the `cassandra` class is defined on the node. Allow these TCP ports to be opened for traffic between the Cassandra nodes. -Default '[7000, 7001, 7199]' +Default value '[7000, 7001, 7199]' ##### `inter_node_subnets` Only has any effect if the `cassandra` class is defined on the node. @@ -699,29 +699,29 @@ Only has any effect if the `cassandra` class is defined on the node. An array of the list of subnets that are to allowed connection to cassandra::storage_port, cassandra::ssl_storage_port and port 7199 for cassandra JMX monitoring. -Default '['0.0.0.0/0']' +Default value '['0.0.0.0/0']' ##### `inter_node_ports` Allow these TCP ports to be opened for traffic coming from OpsCenter subnets. -Default '[7000, 7001, 7199]' +Default value '[7000, 7001, 7199]' ##### `public_ports` Allow these TCP ports to be opened for traffic coming from public subnets the port specified in `$ssh_port` will be appended to this list. -Default '[8888]' +Default value '[8888]' ##### `public_subnets` An array of the list of subnets that are to allowed connection to cassandra::firewall_ports::ssh_port and if cassandra::opscenter has been included, both cassandra::opscenter::webserver_port and cassandra::opscenter::webserver_ssl_port. -Default '['0.0.0.0/0']' +Default value '['0.0.0.0/0']' ##### `ssh_port` Which port does SSH operate on. -Default '22' +Default value '22' ##### `opscenter_ports` Only has any effect if the `cassandra::datastax_agent` or @@ -730,13 +730,13 @@ Only has any effect if the `cassandra::datastax_agent` or Allow these TCP ports to be opened for traffic coming to or from OpsCenter appended to this list. -Default '[61620, 61621]' +Default value '[61620, 61621]' ##### `opscenter_subnets` A list of subnets that are to be allowed connection to port 61620 for nodes built with cassandra::opscenter and 61621 for nodes built with cassandra::datastax_agent. -Default '['0.0.0.0/0']' +Default value '['0.0.0.0/0']' ### Class: cassandra::java @@ -747,19 +747,19 @@ A class to install an appropriate Java package. ##### `ensure` Is passed to the package reference for the JRE/JDK package. Valid values are **present** or a version number. -Default 'present' +Default value 'present' ##### `jna_ensure` Is passed to the package reference for the JNA package. Valid values are **present** or a version number. -Default 'present' +Default value 'present' ##### `jna_package_name` If the default value of *undef* is left as it is, then a package called jna or libjna-java will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. -Default 'undef' +Default value 'undef' ##### `package_name` If the default value of *undef* is left as it is, then a package called @@ -767,7 +767,7 @@ java-1.8.0-openjdk-headless or openjdk-7-jre-headless will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. -Default 'undef' +Default value 'undef' ### Class: cassandra::opscenter @@ -1031,7 +1031,7 @@ in the file. Default value *undef* ##### `config_file` The full path to the OpsCenter configuration file. -Default '/etc/opscenter/opscenterd.conf' +Default value '/etc/opscenter/opscenterd.conf' ##### `definitions_auto_update` This sets the auto_update setting in the definitions section of the @@ -1099,7 +1099,7 @@ in the file. Default value *undef* ##### `ensure` This is passed to the package reference for **opscenter**. Valid values are **present** or a version number. -Default 'present' +Default value 'present' ##### `failover_configuration_directory` This sets the failover_configuration_directory setting in the failover section of the @@ -1334,7 +1334,7 @@ in the file. Default value *undef* ##### `package_name` The name of the OpsCenter package. -Default 'opscenter' +Default value 'opscenter' ##### `provisioning_agent_install_timeout` This sets the agent_install_timeout setting in the provisioning section of the @@ -1542,15 +1542,15 @@ in the file. Default value *undef* ##### `service_enable` Enable the OpsCenter service to start at boot time. Valid values are true or false. -Default 'true**) +Default value 'true**) ##### `service_ensure` Ensure the OpsCenter service is running. Valid values are running or stopped. -Default 'running**) +Default value 'running**) ##### `service_name` The name of the service that runs the OpsCenter software. -Default 'opscenterd' +Default value 'opscenterd' ##### `spark_base_master_proxy_port` This sets the base_master_proxy_port setting in the spark section of the @@ -1695,23 +1695,23 @@ family. ##### `ensure` This is passed to the package reference for **pycrypto**. Valid values are **present** or a version number. -Default 'present' +Default value 'present' ##### `manage_epel` If set to true, the **epel-release** package will be installed. -Default 'false' +Default value 'false' ##### `package_name` The name of the PyCrypto package. -Default 'pycrypto' +Default value 'pycrypto' ##### `provider` The name of the provider of the pycrypto package. -Default 'pip' +Default value 'pip' ##### `reqd_pckgs` Packages that are required to install the pycrypto package. -Default '['python-devel', 'python-pip' ]' +Default value '['python-devel', 'python-pip' ]' ### Class: cassandra::optutils @@ -1722,7 +1722,7 @@ A class to install the optional Cassandra tools package. ##### `ensure` Is passed to the package reference. Valid values are **present** or a version number. -Default 'present' +Default value 'present' ##### `package_name` If the default value of *undef* is left as it is, then a package called @@ -1730,7 +1730,7 @@ cassandra22-tools or cassandra-tools will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. -Default 'undef' +Default value 'undef' ### Defined Type cassandra::opscenter::cluster_name From 485c4b10f8b117469d4badebf732d93c05229ee3 Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 07:56:36 +0100 Subject: [PATCH 06/12] Some work on Ensure how defaults are shown is consistent (#98). --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 21120949..39c2a243 100644 --- a/README.md +++ b/README.md @@ -443,7 +443,7 @@ Sets the value for dc_suffix in *config_path*/*snitch_properties_file* see http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html for more details. If the value is *undef* then change will be made to the snitch properties file for this setting. -Default *undef* +Default value *undef* ##### `disk_failure_policy` This is passed to the @@ -513,7 +513,7 @@ http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSni for more details. Valid values are true, false or *undef*. If the value is *undef* then change will be made to the snitch properties file for this setting. -(default *undef*). +Default value *undef* ##### `rack` Sets the value for rack in *config_path*/*snitch_properties_file* see @@ -1542,11 +1542,11 @@ in the file. Default value *undef* ##### `service_enable` Enable the OpsCenter service to start at boot time. Valid values are true or false. -Default value 'true**) +Default value 'true' ##### `service_ensure` Ensure the OpsCenter service is running. Valid values are running or stopped. -Default value 'running**) +Default value 'running' ##### `service_name` The name of the service that runs the OpsCenter software. From 6ac24974130d86e69be87a5fbc0d7d22318006a0 Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 07:58:31 +0100 Subject: [PATCH 07/12] This feature is now working on client sites (#98). --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 39c2a243..d9752ade 100644 --- a/README.md +++ b/README.md @@ -660,8 +660,6 @@ This class has no parameters. ### Class: cassandra::firewall_ports -WARNING: This feature is currently experimental. - An optional class to configure incoming network ports on the host that are relevant to the Cassandra installation. If firewalls are being managed already, simply do not include this module in your manifest. From 0232a063d5bddfa00dc5262958f417257b2a9846 Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 08:02:14 +0100 Subject: [PATCH 08/12] Some work on Ensure how defaults are shown is consistent (#98). --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index d9752ade..aab78063 100644 --- a/README.md +++ b/README.md @@ -425,7 +425,7 @@ The path to the cassandra configuration file. If this is undef, it will be changed to **/etc/cassandra/default.conf** on the Red Hat family of operating systems or **/etc/cassandra** on Ubuntu. Otherwise the user can specify the path name. -Default value 'undef' +Default value *undef* ##### `data_file_directories` This is passed to the @@ -647,7 +647,7 @@ If the value is changed from the default of *undef* then this is what is set as the stomp_interface setting in **/var/lib/datastax-agent/conf/address.yaml** which connects the agent to an OpsCenter instance. -Default value 'undef' +Default value *undef* ### Class: cassandra::datastax_repo @@ -757,7 +757,7 @@ If the default value of *undef* is left as it is, then a package called jna or libjna-java will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. -Default value 'undef' +Default value *undef* ##### `package_name` If the default value of *undef* is left as it is, then a package called @@ -765,7 +765,7 @@ java-1.8.0-openjdk-headless or openjdk-7-jre-headless will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. -Default value 'undef' +Default value *undef* ### Class: cassandra::opscenter @@ -1728,7 +1728,7 @@ cassandra22-tools or cassandra-tools will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the node. -Default value 'undef' +Default value *undef* ### Defined Type cassandra::opscenter::cluster_name From c931daf92ce164c4305d866f5a873e8fb8dfc89d Mon Sep 17 00:00:00 2001 From: dallinb Date: Wed, 2 Sep 2015 08:03:56 +0100 Subject: [PATCH 09/12] Fixes #98. --- README.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index aab78063..64b20713 100644 --- a/README.md +++ b/README.md @@ -434,13 +434,13 @@ Default value '['/var/lib/cassandra/data']' ##### `dc` Sets the value for dc in *config_path*/*snitch_properties_file* see -http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html +http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. Default value 'DC1' ##### `dc_suffix` Sets the value for dc_suffix in *config_path*/*snitch_properties_file* see -http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html +http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. If the value is *undef* then change will be made to the snitch properties file for this setting. Default value *undef* @@ -509,7 +509,7 @@ Default value 'org.apache.cassandra.dht.Murmur3Partitioner' ##### `prefer_local` Sets the value for prefer_local in *config_path*/*snitch_properties_file* see -http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html +http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. Valid values are true, false or *undef*. If the value is *undef* then change will be made to the snitch properties file for this setting. @@ -517,7 +517,7 @@ Default value *undef* ##### `rack` Sets the value for rack in *config_path*/*snitch_properties_file* see -http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html +http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. Default value 'RAC1' From 1b261a4501eca78f57c89a905b37309bafaec3e6 Mon Sep 17 00:00:00 2001 From: dallinb Date: Thu, 3 Sep 2015 08:22:31 +0100 Subject: [PATCH 10/12] v1.3.6 --- CHANGELOG.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1e96059e..550cee79 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,8 +1,14 @@ # Change Log for Puppet Module locp-cassandra -##2015-09-01 - Release 1.3.5 -* Fixed a bug allowing the user to set the running state of the Cassandra +##2015-09-03 - Release 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 +* 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. From 7605ff5efd10e7d09d73bbb57497bea1412ae53b Mon Sep 17 00:00:00 2001 From: Ben Dalling Date: Thu, 3 Sep 2015 08:55:20 +0100 Subject: [PATCH 11/12] Create gh-pages branch via GitHub --- index.html | 352 +++++++++++++++++++++++++++------------------------- params.json | 2 +- 2 files changed, 181 insertions(+), 173 deletions(-) diff --git a/index.html b/index.html index 152cf490..5c09379f 100644 --- a/index.html +++ b/index.html @@ -485,29 +485,29 @@

Public Classes

Public Defined Types

Private Defined Types

    -
  • cassandra::opscenter::setting
    • -
  • cassandra::firewall_ports::rule
    • +
  • cassandra::opscenter::setting
    • +
  • cassandra::firewall_ports::rule

@@ -524,24 +524,24 @@

This is passed to the -cassandra.yaml file -(default AllowAllAuthenticator).

+cassandra.yaml file. +Default value: 'AllowAllAuthenticator.

authorizer

This is passed to the -cassandra.yaml file -(default: AllowAllAuthorizer).

+cassandra.yaml file. +Default value: 'AllowAllAuthorizer'

auto_snapshot

This is passed to the -cassandra.yaml file -(default true).

+cassandra.yaml file. +Default value 'true'

cassandra_9822 @@ -551,7 +551,8 @@
service as a workaround for CASSANDRA-9822. This option is silently ignored on the Red Hat family of operating systems as -this bug only affects Ubuntu systems (default false).

+this bug only affects Ubuntu systems. +Default value 'false'

cassandra_yaml_tmpl @@ -559,72 +560,72 @@

The path to the Puppet template for the Cassandra configuration file. This allows the user to supply their own customized template. A Cassandra 1.X -compatible template called cassandra1.yaml.erb has been provided by @Spredzy -(default cassandra/cassandra.yaml.erb).

+compatible template called cassandra1.yaml.erb has been provided by @Spredzy. +Default value 'cassandra/cassandra.yaml.erb'

client_encryption_enabled

This is passed to the -cassandra.yaml file -(default false).

+cassandra.yaml file. +Default value 'false'

client_encryption_keystore

This is passed to the -cassandra.yaml file -(default conf/.keystore).

+cassandra.yaml file. +Default value 'conf/.keystore'

client_encryption_keystore_password

This is passed to the -cassandra.yaml file -(default cassandra).

+cassandra.yaml file. +Default value 'cassandra'

cluster_name

This is passed to the -cassandra.yaml file -(default Test Cluster).

+cassandra.yaml file. +Default value 'Test Cluster'

commitlog_directory

This is passed to the -cassandra.yaml file -(default /var/lib/cassandra/commitlog).

+cassandra.yaml file. +Default value '/var/lib/cassandra/commitlog'

concurrent_counter_writes

This is passed to the -cassandra.yaml file -(default 32).

+cassandra.yaml file. +Default value '32'

concurrent_reads

This is passed to the -cassandra.yaml file -(default 32).

+cassandra.yaml file. +Default value '32'

concurrent_writes

This is passed to the -cassandra.yaml file -(default 32).

+cassandra.yaml file. +Default value '32'

config_path @@ -633,83 +634,83 @@

The path to the cassandra configuration file. If this is undef, it will be changed to /etc/cassandra/default.conf on the Red Hat family of operating systems or /etc/cassandra on Ubuntu. Otherwise the user can specify the -path name -(default undef).

+path name. +Default value undef

data_file_directories

This is passed to the -cassandra.yaml file -(default ['/var/lib/cassandra/data']).

+cassandra.yaml file. +Default value '['/var/lib/cassandra/data']'

dc

Sets the value for dc in config_path/snitch_properties_file see -http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html -for more details -(default DC1).

+http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html +for more details. +Default value 'DC1'

dc_suffix

Sets the value for dc_suffix in config_path/snitch_properties_file see -http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html +http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. If the value is undef then change will be made to the -snitch properties file for this setting -(default undef).

+snitch properties file for this setting. +Default value undef

disk_failure_policy

This is passed to the -cassandra.yaml file -(default: stop).

+cassandra.yaml file. +Default value 'stop'

endpoint_snitch

This is passed to the -cassandra.yaml file -(default: SimpleSnitch).

+cassandra.yaml file. +Default value 'SimpleSnitch'

hinted_handoff_enabled

This is passed to the -cassandra.yaml file -(defaults to 'true').

+cassandra.yaml file. +Default value 'true'

incremental_backups

This is passed to the -cassandra.yaml file -(default false).

+cassandra.yaml file. +Default value 'false'

internode_compression

This is passed to the -cassandra.yaml file -(default all).

+cassandra.yaml file. +Default value 'all'

listen_address

This is passed to the -cassandra.yaml file -(default localhost).

+cassandra.yaml file. +Default value 'localhost'

manage_dsc_repo @@ -719,215 +720,217 @@
the ::cassandra::datastax_repo instead.

If set to true then a repository will be setup so that packages can be -downloaded from DataStax community (default false).

+downloaded from DataStax community. +Default value 'false'

native_transport_port

This is passed to the -cassandra.yaml file -(default 9042).

+cassandra.yaml file. +Default value '9042'

num_tokens

This is passed to the -cassandra.yaml file -(default 256).

+cassandra.yaml file. +Default value '256'

package_ensure

The status of the package specified in package_name. Can be -present, latest or a specific version number (default present).

+present, latest or a specific version number. +Default value 'present'

package_name
-

The name of the Cassandra package. Must be available from a repository -(default dsc22).

+

The name of the Cassandra package. Must be available from a repository. +Default value 'dsc22'

partitioner

This is passed to the -cassandra.yaml file -(default org.apache.cassandra.dht.Murmur3Partitioner)

+cassandra.yaml file. +Default value 'org.apache.cassandra.dht.Murmur3Partitioner'

prefer_local

Sets the value for prefer_local in config_path/snitch_properties_file see -http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html +http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html for more details. Valid values are true, false or undef. If the value is undef then change will be made to the snitch properties file for this -setting -(default undef).

+setting. +Default value undef

rack

Sets the value for rack in config_path/snitch_properties_file see -http://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html -for more details -(default RAC1).

+http://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html +for more details. +Default value 'RAC1'

rpc_address

This is passed to the -cassandra.yaml file -(default localhost).

+cassandra.yaml file. +Default value 'localhost'

rpc_port

This is passed to the -cassandra.yaml file -(default 9160).

+cassandra.yaml file. +Default value '9160'

rpc_server_type

This is passed to the -cassandra.yaml file -(default sync).

+cassandra.yaml file. +Default value 'sync'

saved_caches_directory

This is passed to the -cassandra.yaml file -(default /var/lib/cassandra/saved_caches).

+cassandra.yaml file. +Default value '/var/lib/cassandra/saved_caches'

seeds

This is passed to the -cassandra.yaml file -(default 127.0.0.1).

+cassandra.yaml file. +Default value '127.0.0.1'

server_encryption_internode

This is passed to the -cassandra.yaml file -(default none).

+cassandra.yaml file. +Default value 'none'

server_encryption_keystore

This is passed to the -cassandra.yaml file -(default conf/.keystore).

+cassandra.yaml file. +Default value 'conf/.keystore'

server_encryption_keystore_password

This is passed to the -cassandra.yaml file -(default cassandra).

+cassandra.yaml file. +Default value 'cassandra'

server_encryption_truststore

This is passed to the -cassandra.yaml file -(default conf/.truststore).

+cassandra.yaml file. +Default value 'conf/.truststore'

server_encryption_truststore_password

This is passed to the -cassandra.yaml file -(default cassandra).

+cassandra.yaml file. +Default value 'cassandra'

service_enable

Enable the Cassandra service to start at boot time. Valid values are true -or false -(default: true)

+or false. +Default value 'true'

service_ensure
-

Ensure the Cassandra service is running. Valid values are running or stopped -(default: running)

+

Ensure the Cassandra service is running. Valid values are running or stopped. +Default value 'running'

service_name
-

The name of the service that runs the Cassandra software (default -cassandra).

+

The name of the service that runs the Cassandra software. +Default value 'cassandra'

snapshot_before_compaction

This is passed to the -cassandra.yaml file -(default false).

+cassandra.yaml file. +Default value 'false'

snitch_properties_file

The name of the snitch properties file. The full path name would be -config_path/snitch_properties_file -(default cassandra-rackdc.properties).

+config_path/snitch_properties_file. +Default value 'cassandra-rackdc.properties'

ssl_storage_port

This is passed to the -cassandra.yaml file -(default 7001).

+cassandra.yaml file. +Default value '7001'

start_native_transport

This is passed to the -cassandra.yaml file -(default true).

+cassandra.yaml file. +Default value 'true'

start_rpc

This is passed to the -cassandra.yaml file -(default true).

+cassandra.yaml file. +Default value 'true'

storage_port

This is passed to the -cassandra.yaml file -(default 7000).

+cassandra.yaml file. +Default value '7000'

Class: cassandra::datastax_agent

@@ -943,32 +946,36 @@

Is passed to the package reference. Valid values are present or a version -number -(default present).

+number. +Default value 'present'

package_name
-

Is passed to the package reference (default datastax-agent).

+

Is passed to the package reference. +Default value 'datastax-agent'

service_ensure
-

Is passed to the service reference (default running).

+

Is passed to the service reference. +Default value 'running'

service_enable
-

Is passed to the service reference (default true).

+

Is passed to the service reference. +Default value 'true'

service_name
-

Is passed to the service reference (default datastax-agent).

+

Is passed to the service reference. +Default value 'datastax-agent'

stomp_interface @@ -977,8 +984,8 @@

If the value is changed from the default of undef then this is what is set as the stomp_interface setting in /var/lib/datastax-agent/conf/address.yaml -which connects the agent to an OpsCenter instance -(default undef).

+which connects the agent to an OpsCenter instance. +Default value undef

Class: cassandra::datastax_repo

@@ -994,8 +1001,6 @@

Class: cassandra::firewall_ports

-

WARNING: This feature is currently experimental.

-

An optional class to configure incoming network ports on the host that are relevant to the Cassandra installation. If firewalls are being managed already, simply do not include this module in your manifest.

@@ -1014,8 +1019,8 @@

Only has any effect if the cassandra class is defined on the node.

Allow these TCP ports to be opened for traffic -coming from the client subnets -(default [9042, 9160]).

+coming from the client subnets. +Default value '[9042, 9160]'

client_subnets @@ -1025,7 +1030,7 @@

An array of the list of subnets that are to allowed connection to cassandra::native_transport_port and cassandra::rpc_port. -(default ['0.0.0.0/0']).

+Default value '['0.0.0.0/0']'

inter_node_ports @@ -1034,8 +1039,8 @@

Only has any effect if the cassandra class is defined on the node.

Allow these TCP ports to be opened for traffic -between the Cassandra nodes -(default [7000, 7001, 7199]).

+between the Cassandra nodes. +Default value '[7000, 7001, 7199]'

inter_node_subnets @@ -1045,16 +1050,16 @@

An array of the list of subnets that are to allowed connection to cassandra::storage_port, cassandra::ssl_storage_port and port 7199 -for cassandra JMX monitoring -(default ['0.0.0.0/0']).

+for cassandra JMX monitoring. +Default value '['0.0.0.0/0']'

inter_node_ports

Allow these TCP ports to be opened for traffic -coming from OpsCenter subnets -(default [7000, 7001, 7199]).

+coming from OpsCenter subnets. +Default value '[7000, 7001, 7199]'

public_ports @@ -1062,8 +1067,8 @@

Allow these TCP ports to be opened for traffic coming from public subnets the port specified in $ssh_port will be -appended to this list -(default [8888]).

+appended to this list. +Default value '[8888]'

public_subnets @@ -1072,15 +1077,15 @@

An array of the list of subnets that are to allowed connection to cassandra::firewall_ports::ssh_port and if cassandra::opscenter has been included, both cassandra::opscenter::webserver_port and -cassandra::opscenter::webserver_ssl_port -(default ['0.0.0.0/0']).

+cassandra::opscenter::webserver_ssl_port. +Default value '['0.0.0.0/0']'

ssh_port
-

Which port does SSH operate on -(default 22).

+

Which port does SSH operate on. +Default value '22'

opscenter_ports @@ -1091,8 +1096,8 @@

Allow these TCP ports to be opened for traffic coming to or from OpsCenter -appended to this list -(default [61620, 61621]).

+appended to this list. +Default value '[61620, 61621]'

opscenter_subnets @@ -1100,8 +1105,8 @@

A list of subnets that are to be allowed connection to port 61620 for nodes built with cassandra::opscenter and 61621 for nodes -built with cassandra::datastax_agent -(default ['0.0.0.0/0']).

+built with cassandra::datastax_agent. +Default value '['0.0.0.0/0']'

Class: cassandra::java

@@ -1116,15 +1121,16 @@

Is passed to the package reference for the JRE/JDK package. Valid values are -present or a version -number (default present).

+present or a version number. +Default value 'present'

jna_ensure

Is passed to the package reference for the JNA package. Valid values are -present or a version number (default present).

+present or a version number. +Default value 'present'

jna_package_name @@ -1133,7 +1139,8 @@

If the default value of undef is left as it is, then a package called jna or libjna-java will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in -a package repository to the node (default undef).

+a package repository to the node. +Default value undef

package_name @@ -1143,7 +1150,8 @@
java-1.8.0-openjdk-headless or openjdk-7-jre-headless will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the -node (default undef).

+node. +Default value undef

Class: cassandra::opscenter

@@ -1519,8 +1527,8 @@
config_file
-

The full path to the OpsCenter configuration file -(default /etc/opscenter/opscenterd.conf).

+

The full path to the OpsCenter configuration file. +Default value '/etc/opscenter/opscenterd.conf'

definitions_auto_update @@ -1617,8 +1625,8 @@

This is passed to the package reference for opscenter. Valid values are -present or a version number -(default present).

+present or a version number. +Default value 'present'

failover_configuration_directory @@ -1954,8 +1962,8 @@
package_name
-

The name of the OpsCenter package -(default opscenter).

+

The name of the OpsCenter package. +Default value 'opscenter'

provisioning_agent_install_timeout @@ -2252,22 +2260,22 @@

Enable the OpsCenter service to start at boot time. Valid values are true -or false -(default: true)

+or false. +Default value 'true'

service_ensure
-

Ensure the OpsCenter service is running. Valid values are running or stopped -(default: running)

+

Ensure the OpsCenter service is running. Valid values are running or stopped. +Default value 'running'

service_name
-

The name of the service that runs the OpsCenter software -(default: opscenterd).

+

The name of the service that runs the OpsCenter software. +Default value 'opscenterd'

spark_base_master_proxy_port @@ -2469,36 +2477,36 @@

This is passed to the package reference for pycrypto. Valid values are -present or a version number -(default present).

+present or a version number. +Default value 'present'

manage_epel
-

If set to true, the epel-release package will be installed -(default false).

+

If set to true, the epel-release package will be installed. +Default value 'false'

package_name
-

The name of the PyCrypto package -(default pycrypto).

+

The name of the PyCrypto package. +Default value 'pycrypto'

provider
-

The name of the provider of the pycrypto package -(default pip).

+

The name of the provider of the pycrypto package. +Default value 'pip'

reqd_pckgs
-

Packages that are required to install the pycrypto package -(default ['python-devel', 'python-pip' ]).

+

Packages that are required to install the pycrypto package. +Default value '['python-devel', 'python-pip' ]'

Class: cassandra::optutils

@@ -2513,8 +2521,8 @@

Is passed to the package reference. Valid values are present or a version -number -(default present).

+number. +Default value 'present'

package_name @@ -2524,8 +2532,8 @@
cassandra22-tools or cassandra-tools will be installed on a Red Hat family or Ubuntu system respectively. Alternatively, one can specify a package that is available in a package repository to the -node -(default undef).

+node. +Default value undef

Defined Type cassandra::opscenter::cluster_name

diff --git a/params.json b/params.json index 7ea9ff3d..f201cfb3 100644 --- a/params.json +++ b/params.json @@ -1 +1 @@ -{"name":"Cassandra","tagline":"A Puppet module to install and manage Cassandra, DataStax Agent & OpsCenter","body":"# Cassandra\r\n[![Puppet Forge](http://img.shields.io/puppetforge/v/locp/cassandra.svg)](https://forge.puppetlabs.com/locp/cassandra)\r\n[![Github Tag](https://img.shields.io/github/tag/locp/cassandra.svg)](https://github.com/locp/cassandra)\r\n[![Build Status](https://travis-ci.org/locp/cassandra.png?branch=master)](https://travis-ci.org/locp/cassandra)\r\n[![Coverage Status](https://coveralls.io/repos/locp/cassandra/badge.svg?branch=master&service=github)](https://coveralls.io/github/locp/cassandra?branch=master)\r\n[![Join the chat at https://gitter.im/locp/cassandra](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/locp/cassandra?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\r\n\r\n#### Table of Contents\r\n\r\n1. [Overview](#overview)\r\n2. [Setup - The basics of getting started with Cassandra](#setup)\r\n * [What Cassandra affects](#what-cassandra-affects)\r\n * [Beginning with Cassandra](#beginning-with-cassandra)\r\n * [Upgrading](#upgrading)\r\n3. [Usage - Configuration options and additional functionality](#usage)\r\n * [Create a Cluster in a Single Data Center](#create-a-cluster-in-a-single-data-center)\r\n * [Create a Cluster in Multiple Data Centers](#create-a-cluster-in-multiple-data-centers)\r\n * [OpsCenter](#opscenter)\r\n * [DataStax Enterprise](#datastax-enterprise)\r\n4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\r\n * [cassandra](#class-cassandra)\r\n * [cassandra::datastax_agent](#class-cassandradatastax_agent)\r\n * [cassandra::datastax_repo](#class-cassandradatastax_repo)\r\n * [cassandra::firewall_ports](#class-cassandrafirewall_ports)\r\n * [cassandra::java](#class-cassandrajava)\r\n * [cassandra::opscenter](#class-cassandraopscenter)\r\n * [cassandra::opscenter::cluster_name](#defined-type-cassandraopscentercluster_name)\r\n * [cassandra::opscenter::pycrypto](#class-cassandraopscenterpycrypto)\r\n * [cassandra::optutils](#class-cassandraoptutils)\r\n * [cassandra::opscenter::setting](#defined-type-cassandraopscentersetting)\r\n5. [Limitations - OS compatibility, etc.](#limitations)\r\n6. [Contributers](#contributers)\r\n\r\n## Overview\r\n\r\nA Puppet module to install and manage Cassandra, DataStax Agent & OpsCenter\r\n\r\n## Setup\r\n\r\n### What Cassandra affects\r\n\r\n#### What the Cassandra class affects\r\n\r\n* Installs the Cassandra package (default **dsc22**).\r\n* Configures settings in *${config_path}/cassandra.yaml*.\r\n* Optionally ensures that the Cassandra service is enabled and running.\r\n* On Ubuntu systems, optionally replace ```/etc/init.d/cassandra``` with a\r\n workaround for \r\n [CASSANDRA-9822](https://issues.apache.org/jira/browse/CASSANDRA-9822).\r\n\r\n#### What the cassandra::datastax_agent class affects\r\n\r\n* Optionally installs the DataStax agent.\r\n\r\n#### What the cassandra::datastax_agent class affects\r\n\r\n* Optionally configures a Yum repository to install the Cassandra packages\r\n from (on Red Hat).\r\n* Optionally configures an Apt repository to install the Cassandra packages\r\n from (on Ubuntu).\r\n\r\n#### What the cassandra::firewall_ports class affects\r\n\r\n* Optionally configures the firewall for the Cassandra related network\r\n ports.\r\n\r\n#### What the cassandra::java class affects\r\n\r\n* Optionally installs a JRE/JDK package (e.g. java-1.7.0-openjdk) and the\r\n Java Native Access (JNA).\r\n\r\n#### What the cassandra::opscenter class affects\r\n\r\n* Installs the OpsCenter package.\r\n* Manages the content of the configuration file\r\n (/etc/opscenter/opscenterd.conf).\r\n* Manages the opscenterd service.\r\n\r\n#### What the cassandra::opscenter::cluster_name type affects\r\n\r\n* An optional type that allows DataStax OpsCenter to connect to a remote\r\n key space for metrics storage. These files will be created in\r\n /etc/opscenter/clusters. The module also creates this directory if\r\n required. This functionality is only valid in DataStax Enterprise.\r\n\r\n#### What the cassandra::opscenter::pycrypto class affects\r\n\r\n* On the Red Hat family it installs the pycrypto library and it's\r\n pre-requisits (the python-devel and python-pip packages).\r\n* Optionally installs the Extra Packages for Enterprise Linux (EPEL)\r\n repository.\r\n* As a workaround for\r\n [PUP-3829](https://tickets.puppetlabs.com/browse/PUP-3829) a symbolic\r\n link is created from ```/usr/bin/pip``` to\r\n ```/usr/bin/pip-python```. Hopefully this can be removed in the not\r\n too distant future.\r\n\r\n#### What the cassandra::optutils class affects\r\n\r\n* Optionally installs the Cassandra support tools (e.g. cassandra22-tools).\r\n\r\n### Beginning with Cassandra\r\n\r\nA basic example is as follows:\r\n\r\n```puppet\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n seeds => '110.82.155.0,110.82.156.3'\r\n }\r\n```\r\n\r\n### Upgrading\r\n\r\nThe following changes to the API have taken place.\r\n\r\n#### Changes in 1.0.0\r\n\r\n* cassandra::cassandra_package_ensure has been renamed to\r\n cassandra::package_ensure.\r\n* cassandra::cassandra_package_name has been renamed to\r\n cassandra::package_name.\r\n\r\n#### Changes in 0.4.0\r\n\r\nThere is now a cassandra::datastax_agent class, therefore:\r\n\r\n* cassandra::datastax_agent_package_ensure has now been replaced with\r\n cassandra::datastax_agent::package_ensure.\r\n* cassandra::datastax_agent_service_enable has now been replaced with\r\n cassandra::datastax_agent::service_enable.\r\n* cassandra::datastax_agent_service_ensure has now been replaced with\r\n cassandra::datastax_agent::service_ensure.\r\n* cassandra::datastax_agent_package_name has now been replaced with\r\n cassandra::datastax_agent::package_name.\r\n* cassandra::datastax_agent_service_name has now been replaced with\r\n cassandra::datastax_agent::service_name.\r\n\r\nLikewise now there is a new class for handling the installation of Java:\r\n\r\n* cassandra::java_package_ensure has now been replaced with\r\n cassandra::java::ensure.\r\n* cassandra::java_package_name has now been replaced with\r\n cassandra::java::package_name.\r\n\r\nAlso there is now a class for installing the optional utilities:\r\n\r\n* cassandra::cassandra_opt_package_ensure has now been replaced with\r\n cassandra::optutils:ensure.\r\n* cassandra::cassandra_opt_package_name has now been replaced with\r\n cassandra::optutils:package_name.\r\n\r\n#### Changes in 0.3.0\r\n\r\n* cassandra_opt_package_ensure changed from 'present' to undef.\r\n\r\n* The manage_service option has been replaced with service_enable and\r\n service_ensure.\r\n\r\n## Usage\r\n\r\n### Create a Cluster in a Single Data Center\r\n\r\nIn the DataStax documentation _Initializing a multiple node cluster (single\r\ndata center)_\r\n\r\nthere is a basic example of a six node cluster with two seeds to be created in\r\na single data center spanning two racks. The nodes in the cluster are:\r\n\r\n**Node Name** | **IP Address** |\r\n---------------|----------------|\r\nnode0 (seed 1) | 110.82.155.0 |\r\nnode1 | 110.82.155.1 |\r\nnode2 | 110.82.155.2 |\r\nnode3 (seed 2) | 110.82.156.3 |\r\nnode4 | 110.82.156.4 |\r\nnode5 | 110.82.156.5 |\r\n\r\nEach node is configured to use the GossipingPropertyFileSnitch and 256 virtual\r\nnodes (vnodes). The name of the cluster is _MyCassandraCluster_.\r\n\r\nIn this initial example, we are going to expand the example by:\r\n\r\n* Ensuring that the software is installed via the DataStax Community\r\n repository by including `cassandra::datastax_repo`. This needs to be\r\n executed before the Cassandra package is installed.\r\n* That a suitable Java Runtime environment (JRE) is installed with Java Native\r\n Access (JNA) by including `cassandra::java`. This need to be executed\r\n before the Cassandra service is started.\r\n\r\n```puppet\r\nnode /^node\\d+$/ {\r\n class { 'cassandra::datastax_repo':\r\n before => Class['cassandra']\r\n }\r\n\r\n class { 'cassandra::java':\r\n before => Class['cassandra']\r\n }\r\n\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n num_tokens => 256,\r\n seeds => '110.82.155.0,110.82.156.3'\r\n }\r\n}\r\n```\r\n\r\nThe default value for the num_tokens is already 256, but it is\r\nincluded in the example for clarity.\r\n\r\n### Create a Cluster in Multiple Data Centers\r\n\r\nTo continue with the examples provided by DataStax, we look at the example\r\nfor a cluster across multiple data centers\r\n.\r\n\r\n**Node Name** | **IP Address** | **Data Center** | **Rack** |\r\n---------------|----------------|-----------------|----------|\r\nnode0 (seed 1) | 10.168.66.41 | DC1 | RAC1 |\r\nnode1 | 10.176.43.66 | DC1 | RAC1 |\r\nnode2 | 10.168.247.41 | DC1 | RAC1 |\r\nnode3 (seed 2) | 10.176.170.59 | DC2 | RAC1 |\r\nnode4 | 10.169.61.170 | DC2 | RAC1 |\r\nnode5 | 10.169.30.138 | DC2 | RAC1 |\r\n\r\nFor the sake of simplicity, we will confine this example to the nodes:\r\n\r\n```puppet\r\nnode /^node[012]$/ {\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n num_tokens => 256,\r\n seeds => '10.168.66.41,10.176.170.59',\r\n dc => 'DC1'\r\n }\r\n}\r\n\r\nnode /^node[345]$/ {\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n num_tokens => 256,\r\n seeds => '10.168.66.41,10.176.170.59',\r\n dc => 'DC2'\r\n }\r\n}\r\n```\r\n\r\nWe don't need to specify the rack name (with the rack parameter) as RAC1 is\r\nthe default value.\r\n\r\n### OpsCenter\r\n\r\nTo continue with the original example within a single data center, say we\r\nhave an instance of OpsCenter running on a node called opscenter which has\r\nan IP address of 110.82.157.6. We add the `cassandra::datastax_agent` to\r\nthe cassandra node to connect to OpsCenter:\r\n\r\n```puppet\r\nnode /^node\\d+$/ {\r\n class { 'cassandra::datastax_repo':\r\n before => Class['cassandra']\r\n } ->\r\n class { 'cassandra::java':\r\n before => Class['cassandra']\r\n } ->\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n num_tokens => 256,\r\n seeds => '110.82.155.0,110.82.156.3',\r\n before => Class['cassandra::datastax_agent']\r\n } ->\r\n class { 'cassandra::datastax_agent':\r\n stomp_interface => '110.82.157.6'\r\n }\r\n}\r\n\r\nnode /opscenter/ {\r\n include '::cassandra::datastax_repo' ->\r\n include '::cassandra' ->\r\n include '::cassandra::opscenter'\r\n}\r\n```\r\n\r\nWe have also added the `cassandra::opscenter` class for the opscenter node.\r\n\r\n### DataStax Enterprise\r\n\r\nAfter configuring the relevant repositories elsewhere in the manifest, the\r\nfollowing snippet works on CentOS 7 to install DSE Cassandra 4.7.0:\r\n\r\n```puppet\r\nclass { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n config_path => '/etc/dse/cassandra',\r\n package_ensure => '4.7.0-1',\r\n package_name => 'dse-full',\r\n service_name => 'dse',\r\n}\r\n```\r\n\r\nAlso with DSE, one can specify a remote keyspace for storing the metrics for\r\na cluster. An example is:\r\n\r\n```puppet\r\ncassandra::opscenter::cluster_name { 'Cluster1':\r\n cassandra_seed_hosts => 'host1,host2',\r\n storage_cassandra_username => 'opsusr',\r\n storage_cassandra_password => 'opscenter',\r\n storage_cassandra_api_port => 9160,\r\n storage_cassandra_cql_port => 9042,\r\n storage_cassandra_keyspace => 'OpsCenter_Cluster1'\r\n}\r\n```\r\n\r\n## Reference\r\n\r\n### Public Classes\r\n\r\n* **cassandra**\r\n* **cassandra::datastax_agent**\r\n* **cassandra::datastax_repo**\r\n* **cassandra::firewall_ports**\r\n* **cassandra::java**\r\n* **cassandra::opscenter**\r\n* **cassandra::opscenter::pycrypto**\r\n* **cassandra::optutils**\r\n\r\n### Public Defined Types\r\n* **cassandra::opscenter::cluster_name**\r\n\r\n### Private Defined Types\r\n\r\n* **cassandra::opscenter::setting**\r\n* **cassandra::firewall_ports::rule**\r\n\r\n### Class: cassandra\r\n\r\nA class for installing the Cassandra package and manipulate settings in the\r\nconfiguration file.\r\n\r\n#### Parameters\r\n\r\n##### `authenticator`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **AllowAllAuthenticator**).\r\n\r\n##### `authorizer`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default: **AllowAllAuthorizer**).\r\n\r\n##### `auto_snapshot`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **true**).\r\n\r\n##### `cassandra_9822`\r\nIf set to true, this will apply a patch to the init file for the Cassandra\r\nservice as a workaround for\r\n[CASSANDRA-9822](https://issues.apache.org/jira/browse/CASSANDRA-9822). This\r\noption is silently ignored on the Red Hat family of operating systems as\r\nthis bug only affects Ubuntu systems (default **false**).\r\n\r\n##### `cassandra_yaml_tmpl`\r\nThe path to the Puppet template for the Cassandra configuration file. This\r\nallows the user to supply their own customized template. A Cassandra 1.X\r\ncompatible template called cassandra1.yaml.erb has been provided by @Spredzy\r\n(default **cassandra/cassandra.yaml.erb**).\r\n\r\n##### `client_encryption_enabled`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **false**).\r\n\r\n##### `client_encryption_keystore`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **conf/.keystore**).\r\n\r\n##### `client_encryption_keystore_password`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **cassandra**).\r\n\r\n##### `cluster_name`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **Test Cluster**).\r\n\r\n##### `commitlog_directory`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **/var/lib/cassandra/commitlog**).\r\n\r\n##### `concurrent_counter_writes`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **32**).\r\n\r\n##### `concurrent_reads`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **32**).\r\n\r\n##### `concurrent_writes`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **32**).\r\n\r\n##### `config_path`\r\nThe path to the cassandra configuration file. If this is undef, it will be\r\nchanged to **/etc/cassandra/default.conf** on the Red Hat family of operating\r\nsystems or **/etc/cassandra** on Ubuntu. Otherwise the user can specify the\r\npath name\r\n(default **undef**).\r\n\r\n##### `data_file_directories`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **['/var/lib/cassandra/data']**).\r\n\r\n##### `dc`\r\nSets the value for dc in *config_path*/*snitch_properties_file* see\r\nhttp://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html\r\nfor more details\r\n(default **DC1**).\r\n\r\n##### `dc_suffix`\r\nSets the value for dc_suffix in *config_path*/*snitch_properties_file* see\r\nhttp://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html\r\nfor more details. If the value is *undef* then change will be made to the\r\nsnitch properties file for this setting\r\n(default *undef*).\r\n\r\n##### `disk_failure_policy`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default: **stop**).\r\n\r\n##### `endpoint_snitch`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default: **SimpleSnitch**).\r\n\r\n##### `hinted_handoff_enabled`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(defaults to **'true'**).\r\n\r\n##### `incremental_backups`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **false**).\r\n\r\n##### `internode_compression`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **all**).\r\n\r\n##### `listen_address`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **localhost**).\r\n\r\n##### `manage_dsc_repo`\r\nDEPRECATION WARNING: This option is deprecated. Please include the\r\nthe ::cassandra::datastax_repo instead.\r\n\r\nIf set to true then a repository will be setup so that packages can be\r\ndownloaded from DataStax community (default **false**).\r\n\r\n##### `native_transport_port`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **9042**).\r\n\r\n##### `num_tokens`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **256**).\r\n\r\n##### `package_ensure`\r\nThe status of the package specified in **package_name**. Can be\r\n*present*, *latest* or a specific version number (default **present**).\r\n\r\n##### `package_name`\r\nThe name of the Cassandra package. Must be available from a repository\r\n(default **dsc22**).\r\n\r\n##### `partitioner`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **org.apache.cassandra.dht.Murmur3Partitioner**)\r\n\r\n##### `prefer_local`\r\nSets the value for prefer_local in *config_path*/*snitch_properties_file* see\r\nhttp://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html\r\nfor more details. Valid values are true, false or *undef*. If the value is\r\n*undef* then change will be made to the snitch properties file for this\r\nsetting\r\n(default *undef*).\r\n\r\n##### `rack`\r\nSets the value for rack in *config_path*/*snitch_properties_file* see\r\nhttp://docs.datastax.com/en/cassandra/2.0/cassandra/architecture/architectureSnitchesAbout_c.html\r\nfor more details\r\n(default **RAC1**).\r\n\r\n##### `rpc_address`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **localhost**).\r\n\r\n##### `rpc_port`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **9160**).\r\n\r\n##### `rpc_server_type`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **sync**).\r\n\r\n##### `saved_caches_directory`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **/var/lib/cassandra/saved_caches**).\r\n\r\n##### `seeds`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **127.0.0.1**).\r\n\r\n##### `server_encryption_internode`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **none**).\r\n\r\n##### `server_encryption_keystore`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **conf/.keystore**).\r\n\r\n##### `server_encryption_keystore_password`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **cassandra**).\r\n\r\n##### `server_encryption_truststore`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **conf/.truststore**).\r\n\r\n##### `server_encryption_truststore_password`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **cassandra**).\r\n\r\n##### `service_enable`\r\nEnable the Cassandra service to start at boot time. Valid values are true\r\nor false\r\n(default: **true**)\r\n\r\n##### `service_ensure`\r\nEnsure the Cassandra service is running. Valid values are running or stopped\r\n(default: **running**)\r\n\r\n##### `service_name`\r\nThe name of the service that runs the Cassandra software (default\r\n**cassandra**).\r\n\r\n##### `snapshot_before_compaction`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **false**).\r\n\r\n##### `snitch_properties_file`\r\nThe name of the snitch properties file. The full path name would be\r\n*config_path*/*snitch_properties_file*\r\n(default **cassandra-rackdc.properties**).\r\n\r\n##### `ssl_storage_port`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **7001**).\r\n\r\n##### `start_native_transport`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **true**).\r\n\r\n##### `start_rpc`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **true**).\r\n\r\n##### `storage_port`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file\r\n(default **7000**).\r\n\r\n### Class: cassandra::datastax_agent\r\n\r\nA class for installing the DataStax Agent and to point it at an OpsCenter\r\ninstance.\r\n\r\n#### Parameters\r\n\r\n##### `package_ensure`\r\nIs passed to the package reference. Valid values are **present** or a version\r\nnumber\r\n(default **present**).\r\n\r\n##### `package_name`\r\nIs passed to the package reference (default **datastax-agent**).\r\n\r\n##### `service_ensure`\r\nIs passed to the service reference (default **running**).\r\n\r\n##### `service_enable`\r\nIs passed to the service reference (default **true**).\r\n\r\n##### `service_name`\r\nIs passed to the service reference (default **datastax-agent**).\r\n\r\n##### `stomp_interface`\r\nIf the value is changed from the default of *undef* then this is what is\r\nset as the stomp_interface setting in\r\n**/var/lib/datastax-agent/conf/address.yaml**\r\nwhich connects the agent to an OpsCenter instance\r\n(default **undef**).\r\n\r\n### Class: cassandra::datastax_repo\r\n\r\nAn optional class that will allow a suitable repository to be configured\r\nfrom which packages for DataStax Community can be downloaded.\r\n\r\n#### Parameters\r\n\r\nThis class has no parameters.\r\n\r\n### Class: cassandra::firewall_ports\r\n\r\nWARNING: This feature is currently experimental.\r\n\r\nAn optional class to configure incoming network ports on the host that are\r\nrelevant to the Cassandra installation. If firewalls are being managed \r\nalready, simply do not include this module in your manifest.\r\n\r\nIMPORTANT: The full list of which ports should be configured is assessed at\r\nevaluation time of the configuration. Therefore if one is to use this class,\r\nit must be the final cassandra class included in the manifest.\r\n\r\n#### Parameters\r\n\r\n##### `client_ports`\r\nOnly has any effect if the `cassandra` class is defined on the node.\r\n\r\nAllow these TCP ports to be opened for traffic\r\ncoming from the client subnets\r\n(default **[9042, 9160]**).\r\n\r\n##### `client_subnets`\r\nOnly has any effect if the `cassandra` class is defined on the node.\r\n\r\nAn array of the list of subnets that are to allowed connection to\r\ncassandra::native_transport_port and cassandra::rpc_port.\r\n(default **['0.0.0.0/0']**).\r\n\r\n##### `inter_node_ports`\r\nOnly has any effect if the `cassandra` class is defined on the node.\r\n\r\nAllow these TCP ports to be opened for traffic\r\nbetween the Cassandra nodes\r\n(default **[7000, 7001, 7199]**).\r\n\r\n##### `inter_node_subnets`\r\nOnly has any effect if the `cassandra` class is defined on the node.\r\n\r\nAn array of the list of subnets that are to allowed connection to\r\ncassandra::storage_port, cassandra::ssl_storage_port and port 7199\r\nfor cassandra JMX monitoring\r\n(default **['0.0.0.0/0']**).\r\n\r\n##### `inter_node_ports`\r\nAllow these TCP ports to be opened for traffic\r\ncoming from OpsCenter subnets\r\n(default **[7000, 7001, 7199]**).\r\n\r\n##### `public_ports`\r\nAllow these TCP ports to be opened for traffic\r\ncoming from public subnets the port specified in `$ssh_port` will be\r\nappended to this list\r\n(default **[8888]**).\r\n\r\n##### `public_subnets`\r\nAn array of the list of subnets that are to allowed connection to\r\ncassandra::firewall_ports::ssh_port and if cassandra::opscenter has been\r\nincluded, both cassandra::opscenter::webserver_port and\r\ncassandra::opscenter::webserver_ssl_port\r\n(default **['0.0.0.0/0']**).\r\n\r\n##### `ssh_port`\r\nWhich port does SSH operate on\r\n(default **22**).\r\n\r\n##### `opscenter_ports`\r\nOnly has any effect if the `cassandra::datastax_agent` or\r\n`cassandra::opscenter` classes are defined.\r\n\r\nAllow these TCP ports to be opened for traffic\r\ncoming to or from OpsCenter\r\nappended to this list\r\n(default **[61620, 61621]**).\r\n\r\n##### `opscenter_subnets`\r\nA list of subnets that are to be allowed connection to\r\nport 61620 for nodes built with cassandra::opscenter and 61621 for nodes\r\nbuilt with cassandra::datastax_agent\r\n(default **['0.0.0.0/0']**).\r\n\r\n### Class: cassandra::java\r\n\r\nA class to install an appropriate Java package.\r\n\r\n#### Parameters\r\n\r\n##### `ensure`\r\nIs passed to the package reference for the JRE/JDK package. Valid values are\r\n**present** or a version\r\nnumber (default **present**).\r\n\r\n##### `jna_ensure`\r\nIs passed to the package reference for the JNA package. Valid values are\r\n**present** or a version number (default **present**).\r\n\r\n##### `jna_package_name`\r\nIf the default value of *undef* is left as it is, then a package called\r\njna or libjna-java will be installed on a Red Hat family or Ubuntu system\r\nrespectively. Alternatively, one can specify a package that is available in\r\na package repository to the node (default **undef**).\r\n\r\n##### `package_name`\r\nIf the default value of *undef* is left as it is, then a package called\r\njava-1.8.0-openjdk-headless or openjdk-7-jre-headless will be installed\r\non a Red Hat family or Ubuntu system respectively. Alternatively, one\r\ncan specify a package that is available in a package repository to the\r\nnode (default **undef**).\r\n\r\n### Class: cassandra::opscenter\r\n\r\nThis class installs and manages the DataStax OpsCenter. Leaving the defaults\r\nas they are will provide a running OpsCenter without any authentication on\r\nport 8888.\r\n\r\n#### Parameters\r\n\r\n##### `agents_agent_certfile`\r\nThis sets the agent_certfile setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_agent_keyfile`\r\nThis sets the agent_keyfile setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_agent_keyfile_raw`\r\nThis sets the agent_keyfile_raw setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_config_sleep`\r\nThis sets the config_sleep setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_fingerprint_throttle`\r\nThis sets the fingerprint_throttle setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_incoming_interface`\r\nThis sets the incoming_interface setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_incoming_port`\r\nThis sets the incoming_port setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_install_throttle`\r\nThis sets the install_throttle setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_not_seen_threshold`\r\nThis sets the not_seen_threshold setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_deb`\r\nThis sets the path_to_deb setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_find_java`\r\nThis sets the path_to_find_java setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_installscript`\r\nThis sets the path_to_installscript setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_rpm`\r\nThis sets the path_to_rpm setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_sudowrap`\r\nThis sets the path_to_sudowrap setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_reported_interface`\r\nThis sets the reported_interface setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_runs_sudo`\r\nThis sets the runs_sudo setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_scp_executable`\r\nThis sets the scp_executable setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_executable`\r\nThis sets the ssh_executable setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_keygen_executable`\r\nThis sets the ssh_keygen_executable setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_keyscan_executable`\r\nThis sets the ssh_keyscan_executable setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_port`\r\nThis sets the ssh_port setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_sys_known_hosts_file`\r\nThis sets the ssh_sys_known_hosts_file setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_user_known_hosts_file`\r\nThis sets the ssh_user_known_hosts_file setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssl_certfile`\r\nThis sets the ssl_certfile setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssl_keyfile`\r\nThis sets the ssl_keyfile setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_tmp_dir`\r\nThis sets the tmp_dir setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_use_ssl`\r\nThis sets the use_ssl setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_audit_auth`\r\nThis sets the audit_auth setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_audit_pattern`\r\nThis sets the audit_pattern setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_method`\r\nThis sets the authentication_method setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_enabled`\r\nThis sets the enabled setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value 'False'\r\n\r\n##### `authentication_passwd_db`\r\nThis sets the passwd_db setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_timeout`\r\nThis sets the timeout setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `cloud_accepted_certs`\r\nThis sets the accepted_certs setting in the cloud section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `clusters_add_cluster_timeout`\r\nThis sets the add_cluster_timeout setting in the clusters section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `clusters_startup_sleep`\r\nThis sets the startup_sleep setting in the clusters section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `config_file`\r\nThe full path to the OpsCenter configuration file\r\n(default **/etc/opscenter/opscenterd.conf**).\r\n\r\n##### `definitions_auto_update`\r\nThis sets the auto_update setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_definitions_dir`\r\nThis sets the definitions_dir setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_download_filename`\r\nThis sets the download_filename setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_download_host`\r\nThis sets the download_host setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_download_port`\r\nThis sets the download_port setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_hash_filename`\r\nThis sets the hash_filename setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_sleep`\r\nThis sets the sleep setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_ssl_certfile`\r\nThis sets the ssl_certfile setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_use_ssl`\r\nThis sets the use_ssl setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ensure`\r\nThis is passed to the package reference for **opscenter**. Valid values are\r\n**present** or a version number\r\n(default **present**).\r\n\r\n##### `failover_configuration_directory`\r\nThis sets the failover_configuration_directory setting in the failover section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `failover_heartbeat_fail_window`\r\nThis sets the heartbeat_fail_window setting in the failover section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `failover_heartbeat_period`\r\nThis sets the heartbeat_period setting in the failover section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `failover_heartbeat_reply_period`\r\nThis sets the heartbeat_reply_period setting in the failover section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `hadoop_base_job_tracker_proxy_port`\r\nThis sets the base_job_tracker_proxy_port setting in the hadoop section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_admin_group_name`\r\nThis sets the admin_group_name setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_connection_timeout`\r\nThis sets the connection_timeout setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_debug_ssl`\r\nThis sets the debug_ssl setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_group_name_attribute`\r\nThis sets the group_name_attribute setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_group_search_base`\r\nThis sets the group_search_base setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_group_search_filter`\r\nThis sets the group_search_filter setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_group_search_type`\r\nThis sets the group_search_type setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_ldap_security`\r\nThis sets the ldap_security setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_opt_referrals`\r\nThis sets the opt_referrals setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_protocol_version`\r\nThis sets the protocol_version setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_search_dn`\r\nThis sets the search_dn setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_search_password`\r\nThis sets the search_password setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_server_host`\r\nThis sets the server_host setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_server_port`\r\nThis sets the server_port setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_ssl_cacert`\r\nThis sets the ssl_cacert setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_ssl_cert`\r\nThis sets the ssl_cert setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_ssl_key`\r\nThis sets the ssl_key setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_tls_demand`\r\nThis sets the tls_demand setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_tls_reqcert`\r\nThis sets the tls_reqcert setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_uri_scheme`\r\nThis sets the uri_scheme setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_user_memberof_attribute`\r\nThis sets the user_memberof_attribute setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_user_search_base`\r\nThis sets the user_search_base setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_user_search_filter`\r\nThis sets the user_search_filter setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_level`\r\nThis sets the level setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_log_length`\r\nThis sets the log_length setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_log_path`\r\nThis sets the log_path setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_max_rotate`\r\nThis sets the max_rotate setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_resource_usage_interval`\r\nThis sets the resource_usage_interval setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `package_name`\r\nThe name of the OpsCenter package\r\n(default **opscenter**).\r\n\r\n##### `provisioning_agent_install_timeout`\r\nThis sets the agent_install_timeout setting in the provisioning section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `provisioning_keyspace_timeout`\r\nThis sets the keyspace_timeout setting in the provisioning section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `provisioning_private_key_dir`\r\nThis sets the private_key_dir setting in the provisioning section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_alert_on_repair_failure`\r\nThis sets the alert_on_repair_failure setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_cluster_stabilization_period`\r\nThis sets the cluster_stabilization_period setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_error_logging_window`\r\nThis sets the error_logging_window setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_incremental_err_alert_threshold`\r\nThis sets the incremental_err_alert_threshold setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_incremental_range_repair`\r\nThis sets the incremental_range_repair setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_incremental_repair_tables`\r\nThis sets the incremental_repair_tables setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_ks_update_period`\r\nThis sets the ks_update_period setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_log_directory`\r\nThis sets the log_directory setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_log_length`\r\nThis sets the log_length setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_max_err_threshold`\r\nThis sets the max_err_threshold setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_max_parallel_repairs`\r\nThis sets the max_parallel_repairs setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_max_pending_repairs`\r\nThis sets the max_pending_repairs setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_max_rotate`\r\nThis sets the max_rotate setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_min_repair_time`\r\nThis sets the min_repair_time setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_min_throughput`\r\nThis sets the min_throughput setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_num_recent_throughputs`\r\nThis sets the num_recent_throughputs setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_persist_directory`\r\nThis sets the persist_directory setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_persist_period`\r\nThis sets the persist_period setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_restart_period`\r\nThis sets the restart_period setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_single_repair_timeout`\r\nThis sets the single_repair_timeout setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_single_task_err_threshold`\r\nThis sets the single_task_err_threshold setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_snapshot_override`\r\nThis sets the snapshot_override setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `request_tracker_queue_size`\r\nThis sets the queue_size setting in the request_tracker section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `security_config_encryption_active`\r\nThis sets the config_encryption_active setting in the security section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `security_config_encryption_key_name`\r\nThis sets the config_encryption_key_name setting in the security section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `security_config_encryption_key_path`\r\nThis sets the config_encryption_key_path setting in the security section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `service_enable`\r\nEnable the OpsCenter service to start at boot time. Valid values are true\r\nor false\r\n(default: **true**)\r\n\r\n##### `service_ensure`\r\nEnsure the OpsCenter service is running. Valid values are running or stopped\r\n(default: **running**)\r\n\r\n##### `service_name`\r\nThe name of the service that runs the OpsCenter software \r\n(default: **opscenterd**).\r\n\r\n##### `spark_base_master_proxy_port`\r\nThis sets the base_master_proxy_port setting in the spark section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `stat_reporter_initial_sleep`\r\nThis sets the initial_sleep setting in the stat_reporter section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `stat_reporter_interval`\r\nThis sets the interval setting in the stat_reporter section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `stat_reporter_report_file`\r\nThis sets the report_file setting in the stat_reporter section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `stat_reporter_ssl_key`\r\nThis sets the ssl_key setting in the stat_reporter section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ui_default_api_timeout`\r\nThis sets the default_api_timeout setting in the ui section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ui_max_metrics_requests`\r\nThis sets the max_metrics_requests setting in the ui section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ui_node_detail_refresh_delay`\r\nThis sets the node_detail_refresh_delay setting in the ui section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ui_storagemap_ttl`\r\nThis sets the storagemap_ttl setting in the ui section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_interface`\r\nThis sets the interface setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value '0.0.0.0'\r\n\r\n##### `webserver_log_path`\r\nThis sets the log_path setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_port`\r\nThis sets the port setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value '8888'\r\n\r\n##### `webserver_ssl_certfile`\r\nThis sets the ssl_certfile setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_ssl_keyfile`\r\nThis sets the ssl_keyfile setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_ssl_port`\r\nThis sets the ssl_port setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_staticdir`\r\nThis sets the staticdir setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_sub_process_timeout`\r\nThis sets the sub_process_timeout setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_tarball_process_timeout`\r\nThis sets the tarball_process_timeout setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n\r\n### Class: cassandra::opscenter::pycrypto\r\n\r\nOn the Red Hat family of operating systems, if one intends to use encryption\r\nfor configuration values then the pycrypto library is required. This class\r\nwill install it for the user. See\r\nhttp://docs.datastax.com/en/opscenter/5.2//opsc/configure/installPycrypto.html\r\nfor more details.\r\n\r\nThis class has no effect when included on nodes that are not in the Red Hat\r\nfamily.\r\n\r\n#### Parameters\r\n\r\n##### `ensure`\r\nThis is passed to the package reference for **pycrypto**. Valid values are\r\n**present** or a version number\r\n(default **present**).\r\n\r\n##### `manage_epel`\r\nIf set to true, the **epel-release** package will be installed\r\n(default **false**).\r\n\r\n##### `package_name`\r\nThe name of the PyCrypto package\r\n(default **pycrypto**).\r\n\r\n##### `provider`\r\nThe name of the provider of the pycrypto package\r\n(default **pip**).\r\n\r\n##### `reqd_pckgs`\r\nPackages that are required to install the pycrypto package\r\n(default **['python-devel', 'python-pip' ]**).\r\n\r\n### Class: cassandra::optutils\r\n\r\nA class to install the optional Cassandra tools package.\r\n\r\n#### Parameters\r\n\r\n##### `ensure`\r\nIs passed to the package reference. Valid values are **present** or a version\r\nnumber\r\n(default **present**).\r\n\r\n##### `package_name`\r\nIf the default value of *undef* is left as it is, then a package called\r\ncassandra22-tools or cassandra-tools will be installed\r\non a Red Hat family or Ubuntu system respectively. Alternatively, one\r\ncan specify a package that is available in a package repository to the\r\nnode\r\n(default **undef**).\r\n\r\n### Defined Type cassandra::opscenter::cluster_name\r\n\r\nWith DataStax Enterprise, one can specify a remote keyspace for OpsCenter\r\nto store metric data (this is not available in the DataStax Community Edition).\r\n\r\n#### Parameters\r\n\r\n##### `cassandra_seed_hosts`\r\nThis sets the seed_hosts setting in the cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_api_port`\r\nThis sets the api_port setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_bind_interface`\r\nThis sets the bind_interface setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_connection_pool_size`\r\nThis sets the connection_pool_size setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_connect_timeout`\r\nThis sets the connect_timeout setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_cql_port`\r\nThis sets the cql_port setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_keyspace`\r\nThis sets the keyspace setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_local_dc_pref`\r\nThis sets the local_dc_pref setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_password`\r\nThis sets the password setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_retry_delay`\r\nThis sets the retry_delay setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_seed_hosts`\r\nThis sets the seed_hosts setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_send_rpc`\r\nThis sets the send_rpc setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_ssl_ca_certs`\r\nThis sets the ssl_ca_certs setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_ssl_client_key`\r\nThis sets the ssl_client_key setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_ssl_client_pem`\r\nThis sets the ssl_client_pem setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_ssl_validate`\r\nThis sets the ssl_validate setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_used_hosts_per_remote_dc`\r\nThis sets the used_hosts_per_remote_dc setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_username`\r\nThis sets the username setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n### Defined Type cassandra::firewall_ports::rule\r\n\r\nA defined type to be used as a macro for setting host based firewall\r\nrules. This is not intended to be used by a user (who should use the\r\nAPI provided by cassandra::firewall_ports instead) but is documented\r\nhere for completeness.\r\n\r\n#### Parameters\r\n\r\n##### `title`\r\nA text field that contains the protocol name and CIDR address of a subnet.\r\n\r\n##### `port`\r\nThe number(s) of the port(s) to be opened.\r\n\r\n### Defined Type cassandra::opscenter::setting\r\n\r\nA defined type to be used as a macro for settings in the OpsCenter\r\nconfiguration file. This is not intended to be used by a user (who\r\nshould use the API provided by cassandra::opscenter instead) but is documented\r\nhere for completeness.\r\n\r\n#### Parameters\r\n\r\n##### `service_name`\r\nThe name of the service to be notified if a change is made to the\r\nconfiguration file. Typically this would by **opscenterd**.\r\n\r\n##### `path`\r\nThe path to the configuration file. Typically this would by\r\n**/etc/opscenter/opscenterd.conf**.\r\n\r\n##### `section`\r\nThe section in the configuration file to be added to (e.g. **webserver**).\r\n\r\n##### `setting`\r\nThe setting within the section of the configuration file to changed\r\n(e.g. **port**).\r\n\r\n##### `value`\r\nThe setting value to be changed to (e.g. **8888**).\r\n\r\n## Limitations\r\n\r\nTested on the Red Hat family versions 6 and 7, Ubuntu 12.04 and 14.04,\r\nDebian 7 Puppet (CE) 3.7.5 and DSC 2.\r\n\r\n## Contributers\r\n\r\nContributions will be gratefully accepted. Please go to the project page,\r\nfork the project, make your changes locally and then raise a pull request.\r\nDetails on how to do this are available at\r\nhttps://guides.github.com/activities/contributing-to-open-source.\r\n\r\n### Additional Contributers\r\n\r\n* Yanis Guenane (GitHub [@spredzy](https://github.com/Spredzy)) provided the\r\nCassandra 1.x compatible template\r\n(see [#11](https://github.com/locp/cassandra/pull/11)).\r\n\r\n* Amos Shapira (GitHub [@amosshapira](https://github.com/amosshapira)) fixed\r\na bug in the requirements metadata that caused a problem with Puppetfile\r\n(see [#34](https://github.com/locp/cassandra/pull/34)).\r\n\r\n* Dylan Griffith (GitHub [@DylanGriffith](https://github.com/DylanGriffith))\r\nidentified that the dependency for puppetlabs-apt was incorrect\r\n(see [#87](https://github.com/locp/cassandra/pull/87)).\r\n\r\n* Sam Powers (GitHub [@sampowers](https://github.com/sampowers)) reported a\r\nbug in the ability to set the running state of the Cassandra service and\r\nsubsequently submitted a pull request with a fix\r\n(see [#93](https://github.com/locp/cassandra/issues/93)).\r\n","google":"UA-6773548-6","note":"Don't delete this file! It's used internally to help with page regeneration."} \ No newline at end of file +{"name":"Cassandra","tagline":"A Puppet module to install and manage Cassandra, DataStax Agent & OpsCenter","body":"# Cassandra\r\n[![Puppet Forge](http://img.shields.io/puppetforge/v/locp/cassandra.svg)](https://forge.puppetlabs.com/locp/cassandra)\r\n[![Github Tag](https://img.shields.io/github/tag/locp/cassandra.svg)](https://github.com/locp/cassandra)\r\n[![Build Status](https://travis-ci.org/locp/cassandra.png?branch=master)](https://travis-ci.org/locp/cassandra)\r\n[![Coverage Status](https://coveralls.io/repos/locp/cassandra/badge.svg?branch=master&service=github)](https://coveralls.io/github/locp/cassandra?branch=master)\r\n[![Join the chat at https://gitter.im/locp/cassandra](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/locp/cassandra?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\r\n\r\n#### Table of Contents\r\n\r\n1. [Overview](#overview)\r\n2. [Setup - The basics of getting started with Cassandra](#setup)\r\n * [What Cassandra affects](#what-cassandra-affects)\r\n * [Beginning with Cassandra](#beginning-with-cassandra)\r\n * [Upgrading](#upgrading)\r\n3. [Usage - Configuration options and additional functionality](#usage)\r\n * [Create a Cluster in a Single Data Center](#create-a-cluster-in-a-single-data-center)\r\n * [Create a Cluster in Multiple Data Centers](#create-a-cluster-in-multiple-data-centers)\r\n * [OpsCenter](#opscenter)\r\n * [DataStax Enterprise](#datastax-enterprise)\r\n4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\r\n * [cassandra](#class-cassandra)\r\n * [cassandra::datastax_agent](#class-cassandradatastax_agent)\r\n * [cassandra::datastax_repo](#class-cassandradatastax_repo)\r\n * [cassandra::firewall_ports](#class-cassandrafirewall_ports)\r\n * [cassandra::java](#class-cassandrajava)\r\n * [cassandra::opscenter](#class-cassandraopscenter)\r\n * [cassandra::opscenter::cluster_name](#defined-type-cassandraopscentercluster_name)\r\n * [cassandra::opscenter::pycrypto](#class-cassandraopscenterpycrypto)\r\n * [cassandra::optutils](#class-cassandraoptutils)\r\n * [cassandra::opscenter::setting](#defined-type-cassandraopscentersetting)\r\n5. [Limitations - OS compatibility, etc.](#limitations)\r\n6. [Contributers](#contributers)\r\n\r\n## Overview\r\n\r\nA Puppet module to install and manage Cassandra, DataStax Agent & OpsCenter\r\n\r\n## Setup\r\n\r\n### What Cassandra affects\r\n\r\n#### What the Cassandra class affects\r\n\r\n* Installs the Cassandra package (default **dsc22**).\r\n* Configures settings in *${config_path}/cassandra.yaml*.\r\n* Optionally ensures that the Cassandra service is enabled and running.\r\n* On Ubuntu systems, optionally replace ```/etc/init.d/cassandra``` with a\r\n workaround for \r\n [CASSANDRA-9822](https://issues.apache.org/jira/browse/CASSANDRA-9822).\r\n\r\n#### What the cassandra::datastax_agent class affects\r\n\r\n* Optionally installs the DataStax agent.\r\n\r\n#### What the cassandra::datastax_agent class affects\r\n\r\n* Optionally configures a Yum repository to install the Cassandra packages\r\n from (on Red Hat).\r\n* Optionally configures an Apt repository to install the Cassandra packages\r\n from (on Ubuntu).\r\n\r\n#### What the cassandra::firewall_ports class affects\r\n\r\n* Optionally configures the firewall for the Cassandra related network\r\n ports.\r\n\r\n#### What the cassandra::java class affects\r\n\r\n* Optionally installs a JRE/JDK package (e.g. java-1.7.0-openjdk) and the\r\n Java Native Access (JNA).\r\n\r\n#### What the cassandra::opscenter class affects\r\n\r\n* Installs the OpsCenter package.\r\n* Manages the content of the configuration file\r\n (/etc/opscenter/opscenterd.conf).\r\n* Manages the opscenterd service.\r\n\r\n#### What the cassandra::opscenter::cluster_name type affects\r\n\r\n* An optional type that allows DataStax OpsCenter to connect to a remote\r\n key space for metrics storage. These files will be created in\r\n /etc/opscenter/clusters. The module also creates this directory if\r\n required. This functionality is only valid in DataStax Enterprise.\r\n\r\n#### What the cassandra::opscenter::pycrypto class affects\r\n\r\n* On the Red Hat family it installs the pycrypto library and it's\r\n pre-requisits (the python-devel and python-pip packages).\r\n* Optionally installs the Extra Packages for Enterprise Linux (EPEL)\r\n repository.\r\n* As a workaround for\r\n [PUP-3829](https://tickets.puppetlabs.com/browse/PUP-3829) a symbolic\r\n link is created from ```/usr/bin/pip``` to\r\n ```/usr/bin/pip-python```. Hopefully this can be removed in the not\r\n too distant future.\r\n\r\n#### What the cassandra::optutils class affects\r\n\r\n* Optionally installs the Cassandra support tools (e.g. cassandra22-tools).\r\n\r\n### Beginning with Cassandra\r\n\r\nA basic example is as follows:\r\n\r\n```puppet\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n seeds => '110.82.155.0,110.82.156.3'\r\n }\r\n```\r\n\r\n### Upgrading\r\n\r\nThe following changes to the API have taken place.\r\n\r\n#### Changes in 1.0.0\r\n\r\n* cassandra::cassandra_package_ensure has been renamed to\r\n cassandra::package_ensure.\r\n* cassandra::cassandra_package_name has been renamed to\r\n cassandra::package_name.\r\n\r\n#### Changes in 0.4.0\r\n\r\nThere is now a cassandra::datastax_agent class, therefore:\r\n\r\n* cassandra::datastax_agent_package_ensure has now been replaced with\r\n cassandra::datastax_agent::package_ensure.\r\n* cassandra::datastax_agent_service_enable has now been replaced with\r\n cassandra::datastax_agent::service_enable.\r\n* cassandra::datastax_agent_service_ensure has now been replaced with\r\n cassandra::datastax_agent::service_ensure.\r\n* cassandra::datastax_agent_package_name has now been replaced with\r\n cassandra::datastax_agent::package_name.\r\n* cassandra::datastax_agent_service_name has now been replaced with\r\n cassandra::datastax_agent::service_name.\r\n\r\nLikewise now there is a new class for handling the installation of Java:\r\n\r\n* cassandra::java_package_ensure has now been replaced with\r\n cassandra::java::ensure.\r\n* cassandra::java_package_name has now been replaced with\r\n cassandra::java::package_name.\r\n\r\nAlso there is now a class for installing the optional utilities:\r\n\r\n* cassandra::cassandra_opt_package_ensure has now been replaced with\r\n cassandra::optutils:ensure.\r\n* cassandra::cassandra_opt_package_name has now been replaced with\r\n cassandra::optutils:package_name.\r\n\r\n#### Changes in 0.3.0\r\n\r\n* cassandra_opt_package_ensure changed from 'present' to undef.\r\n\r\n* The manage_service option has been replaced with service_enable and\r\n service_ensure.\r\n\r\n## Usage\r\n\r\n### Create a Cluster in a Single Data Center\r\n\r\nIn the DataStax documentation _Initializing a multiple node cluster (single\r\ndata center)_\r\n\r\nthere is a basic example of a six node cluster with two seeds to be created in\r\na single data center spanning two racks. The nodes in the cluster are:\r\n\r\n**Node Name** | **IP Address** |\r\n---------------|----------------|\r\nnode0 (seed 1) | 110.82.155.0 |\r\nnode1 | 110.82.155.1 |\r\nnode2 | 110.82.155.2 |\r\nnode3 (seed 2) | 110.82.156.3 |\r\nnode4 | 110.82.156.4 |\r\nnode5 | 110.82.156.5 |\r\n\r\nEach node is configured to use the GossipingPropertyFileSnitch and 256 virtual\r\nnodes (vnodes). The name of the cluster is _MyCassandraCluster_.\r\n\r\nIn this initial example, we are going to expand the example by:\r\n\r\n* Ensuring that the software is installed via the DataStax Community\r\n repository by including `cassandra::datastax_repo`. This needs to be\r\n executed before the Cassandra package is installed.\r\n* That a suitable Java Runtime environment (JRE) is installed with Java Native\r\n Access (JNA) by including `cassandra::java`. This need to be executed\r\n before the Cassandra service is started.\r\n\r\n```puppet\r\nnode /^node\\d+$/ {\r\n class { 'cassandra::datastax_repo':\r\n before => Class['cassandra']\r\n }\r\n\r\n class { 'cassandra::java':\r\n before => Class['cassandra']\r\n }\r\n\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n num_tokens => 256,\r\n seeds => '110.82.155.0,110.82.156.3'\r\n }\r\n}\r\n```\r\n\r\nThe default value for the num_tokens is already 256, but it is\r\nincluded in the example for clarity.\r\n\r\n### Create a Cluster in Multiple Data Centers\r\n\r\nTo continue with the examples provided by DataStax, we look at the example\r\nfor a cluster across multiple data centers\r\n.\r\n\r\n**Node Name** | **IP Address** | **Data Center** | **Rack** |\r\n---------------|----------------|-----------------|----------|\r\nnode0 (seed 1) | 10.168.66.41 | DC1 | RAC1 |\r\nnode1 | 10.176.43.66 | DC1 | RAC1 |\r\nnode2 | 10.168.247.41 | DC1 | RAC1 |\r\nnode3 (seed 2) | 10.176.170.59 | DC2 | RAC1 |\r\nnode4 | 10.169.61.170 | DC2 | RAC1 |\r\nnode5 | 10.169.30.138 | DC2 | RAC1 |\r\n\r\nFor the sake of simplicity, we will confine this example to the nodes:\r\n\r\n```puppet\r\nnode /^node[012]$/ {\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n num_tokens => 256,\r\n seeds => '10.168.66.41,10.176.170.59',\r\n dc => 'DC1'\r\n }\r\n}\r\n\r\nnode /^node[345]$/ {\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n num_tokens => 256,\r\n seeds => '10.168.66.41,10.176.170.59',\r\n dc => 'DC2'\r\n }\r\n}\r\n```\r\n\r\nWe don't need to specify the rack name (with the rack parameter) as RAC1 is\r\nthe default value.\r\n\r\n### OpsCenter\r\n\r\nTo continue with the original example within a single data center, say we\r\nhave an instance of OpsCenter running on a node called opscenter which has\r\nan IP address of 110.82.157.6. We add the `cassandra::datastax_agent` to\r\nthe cassandra node to connect to OpsCenter:\r\n\r\n```puppet\r\nnode /^node\\d+$/ {\r\n class { 'cassandra::datastax_repo':\r\n before => Class['cassandra']\r\n } ->\r\n class { 'cassandra::java':\r\n before => Class['cassandra']\r\n } ->\r\n class { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n endpoint_snitch => 'GossipingPropertyFileSnitch',\r\n listen_address => \"${::ipaddress}\",\r\n num_tokens => 256,\r\n seeds => '110.82.155.0,110.82.156.3',\r\n before => Class['cassandra::datastax_agent']\r\n } ->\r\n class { 'cassandra::datastax_agent':\r\n stomp_interface => '110.82.157.6'\r\n }\r\n}\r\n\r\nnode /opscenter/ {\r\n include '::cassandra::datastax_repo' ->\r\n include '::cassandra' ->\r\n include '::cassandra::opscenter'\r\n}\r\n```\r\n\r\nWe have also added the `cassandra::opscenter` class for the opscenter node.\r\n\r\n### DataStax Enterprise\r\n\r\nAfter configuring the relevant repositories elsewhere in the manifest, the\r\nfollowing snippet works on CentOS 7 to install DSE Cassandra 4.7.0:\r\n\r\n```puppet\r\nclass { 'cassandra':\r\n cluster_name => 'MyCassandraCluster',\r\n config_path => '/etc/dse/cassandra',\r\n package_ensure => '4.7.0-1',\r\n package_name => 'dse-full',\r\n service_name => 'dse',\r\n}\r\n```\r\n\r\nAlso with DSE, one can specify a remote keyspace for storing the metrics for\r\na cluster. An example is:\r\n\r\n```puppet\r\ncassandra::opscenter::cluster_name { 'Cluster1':\r\n cassandra_seed_hosts => 'host1,host2',\r\n storage_cassandra_username => 'opsusr',\r\n storage_cassandra_password => 'opscenter',\r\n storage_cassandra_api_port => 9160,\r\n storage_cassandra_cql_port => 9042,\r\n storage_cassandra_keyspace => 'OpsCenter_Cluster1'\r\n}\r\n```\r\n\r\n## Reference\r\n\r\n### Public Classes\r\n\r\n* [cassandra](#class-cassandra)\r\n* [cassandra::datastax_agent](#class-cassandradatastax_agent)\r\n* [cassandra::datastax_repo](#class-cassandradatastax_repo)\r\n* [cassandra::firewall_ports](#class-cassandrafirewall_ports)\r\n* [cassandra::java](#class-cassandrajava)\r\n* [cassandra::opscenter](#class-cassandraopscenter)\r\n* [cassandra::opscenter::pycrypto](#class-cassandraopscenterpycrypto)\r\n* [cassandra::optutils](#class-cassandraoptutils)\r\n\r\n### Public Defined Types\r\n* [cassandra::opscenter::cluster_name](#defined-type-cassandraopscentercluster_name)\r\n\r\n### Private Defined Types\r\n\r\n* cassandra::opscenter::setting\r\n* cassandra::firewall_ports::rule\r\n\r\n### Class: cassandra\r\n\r\nA class for installing the Cassandra package and manipulate settings in the\r\nconfiguration file.\r\n\r\n#### Parameters\r\n\r\n##### `authenticator`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value: 'AllowAllAuthenticator.\r\n\r\n##### `authorizer`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value: 'AllowAllAuthorizer'\r\n\r\n##### `auto_snapshot`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'true'\r\n\r\n##### `cassandra_9822`\r\nIf set to true, this will apply a patch to the init file for the Cassandra\r\nservice as a workaround for\r\n[CASSANDRA-9822](https://issues.apache.org/jira/browse/CASSANDRA-9822). This\r\noption is silently ignored on the Red Hat family of operating systems as\r\nthis bug only affects Ubuntu systems.\r\nDefault value 'false'\r\n\r\n##### `cassandra_yaml_tmpl`\r\nThe path to the Puppet template for the Cassandra configuration file. This\r\nallows the user to supply their own customized template. A Cassandra 1.X\r\ncompatible template called cassandra1.yaml.erb has been provided by @Spredzy.\r\nDefault value 'cassandra/cassandra.yaml.erb'\r\n\r\n##### `client_encryption_enabled`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'false'\r\n\r\n##### `client_encryption_keystore`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'conf/.keystore'\r\n\r\n##### `client_encryption_keystore_password`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'cassandra'\r\n\r\n##### `cluster_name`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'Test Cluster'\r\n\r\n##### `commitlog_directory`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '/var/lib/cassandra/commitlog'\r\n\r\n##### `concurrent_counter_writes`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '32'\r\n\r\n##### `concurrent_reads`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '32'\r\n\r\n##### `concurrent_writes`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '32'\r\n\r\n##### `config_path`\r\nThe path to the cassandra configuration file. If this is undef, it will be\r\nchanged to **/etc/cassandra/default.conf** on the Red Hat family of operating\r\nsystems or **/etc/cassandra** on Ubuntu. Otherwise the user can specify the\r\npath name.\r\nDefault value *undef*\r\n\r\n##### `data_file_directories`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '['/var/lib/cassandra/data']'\r\n\r\n##### `dc`\r\nSets the value for dc in *config_path*/*snitch_properties_file* see\r\nhttp://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html\r\nfor more details.\r\nDefault value 'DC1'\r\n\r\n##### `dc_suffix`\r\nSets the value for dc_suffix in *config_path*/*snitch_properties_file* see\r\nhttp://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html\r\nfor more details. If the value is *undef* then change will be made to the\r\nsnitch properties file for this setting.\r\nDefault value *undef*\r\n\r\n##### `disk_failure_policy`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'stop'\r\n\r\n##### `endpoint_snitch`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'SimpleSnitch'\r\n\r\n##### `hinted_handoff_enabled`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'true'\r\n\r\n##### `incremental_backups`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'false'\r\n\r\n##### `internode_compression`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'all'\r\n\r\n##### `listen_address`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'localhost'\r\n\r\n##### `manage_dsc_repo`\r\nDEPRECATION WARNING: This option is deprecated. Please include the\r\nthe ::cassandra::datastax_repo instead.\r\n\r\nIf set to true then a repository will be setup so that packages can be\r\ndownloaded from DataStax community.\r\nDefault value 'false'\r\n\r\n##### `native_transport_port`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '9042'\r\n\r\n##### `num_tokens`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '256'\r\n\r\n##### `package_ensure`\r\nThe status of the package specified in **package_name**. Can be\r\n*present*, *latest* or a specific version number.\r\nDefault value 'present'\r\n\r\n##### `package_name`\r\nThe name of the Cassandra package. Must be available from a repository.\r\nDefault value 'dsc22'\r\n\r\n##### `partitioner`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'org.apache.cassandra.dht.Murmur3Partitioner'\r\n\r\n##### `prefer_local`\r\nSets the value for prefer_local in *config_path*/*snitch_properties_file* see\r\nhttp://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html\r\nfor more details. Valid values are true, false or *undef*. If the value is\r\n*undef* then change will be made to the snitch properties file for this\r\nsetting.\r\nDefault value *undef*\r\n\r\n##### `rack`\r\nSets the value for rack in *config_path*/*snitch_properties_file* see\r\nhttp://docs.datastax.com/en/cassandra/2.1/cassandra/architecture/architectureSnitchesAbout_c.html\r\nfor more details.\r\nDefault value 'RAC1'\r\n\r\n##### `rpc_address`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'localhost'\r\n\r\n##### `rpc_port`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '9160'\r\n\r\n##### `rpc_server_type`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'sync'\r\n\r\n##### `saved_caches_directory`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '/var/lib/cassandra/saved_caches'\r\n\r\n##### `seeds`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '127.0.0.1'\r\n\r\n##### `server_encryption_internode`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'none'\r\n\r\n##### `server_encryption_keystore`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'conf/.keystore'\r\n\r\n##### `server_encryption_keystore_password`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'cassandra'\r\n\r\n##### `server_encryption_truststore`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'conf/.truststore'\r\n\r\n##### `server_encryption_truststore_password`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'cassandra'\r\n\r\n##### `service_enable`\r\nEnable the Cassandra service to start at boot time. Valid values are true\r\nor false.\r\nDefault value 'true'\r\n\r\n##### `service_ensure`\r\nEnsure the Cassandra service is running. Valid values are running or stopped.\r\nDefault value 'running'\r\n\r\n##### `service_name`\r\nThe name of the service that runs the Cassandra software.\r\nDefault value 'cassandra'\r\n\r\n##### `snapshot_before_compaction`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'false'\r\n\r\n##### `snitch_properties_file`\r\nThe name of the snitch properties file. The full path name would be\r\n*config_path*/*snitch_properties_file*.\r\nDefault value 'cassandra-rackdc.properties'\r\n\r\n##### `ssl_storage_port`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '7001'\r\n\r\n##### `start_native_transport`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'true'\r\n\r\n##### `start_rpc`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value 'true'\r\n\r\n##### `storage_port`\r\nThis is passed to the\r\n[cassandra.yaml](http://docs.datastax.com/en/cassandra/2.1/cassandra/configuration/configCassandra_yaml_r.html) file.\r\nDefault value '7000'\r\n\r\n### Class: cassandra::datastax_agent\r\n\r\nA class for installing the DataStax Agent and to point it at an OpsCenter\r\ninstance.\r\n\r\n#### Parameters\r\n\r\n##### `package_ensure`\r\nIs passed to the package reference. Valid values are **present** or a version\r\nnumber.\r\nDefault value 'present'\r\n\r\n##### `package_name`\r\nIs passed to the package reference.\r\nDefault value 'datastax-agent'\r\n\r\n##### `service_ensure`\r\nIs passed to the service reference.\r\nDefault value 'running'\r\n\r\n##### `service_enable`\r\nIs passed to the service reference.\r\nDefault value 'true'\r\n\r\n##### `service_name`\r\nIs passed to the service reference.\r\nDefault value 'datastax-agent'\r\n\r\n##### `stomp_interface`\r\nIf the value is changed from the default of *undef* then this is what is\r\nset as the stomp_interface setting in\r\n**/var/lib/datastax-agent/conf/address.yaml**\r\nwhich connects the agent to an OpsCenter instance.\r\nDefault value *undef*\r\n\r\n### Class: cassandra::datastax_repo\r\n\r\nAn optional class that will allow a suitable repository to be configured\r\nfrom which packages for DataStax Community can be downloaded.\r\n\r\n#### Parameters\r\n\r\nThis class has no parameters.\r\n\r\n### Class: cassandra::firewall_ports\r\n\r\nAn optional class to configure incoming network ports on the host that are\r\nrelevant to the Cassandra installation. If firewalls are being managed \r\nalready, simply do not include this module in your manifest.\r\n\r\nIMPORTANT: The full list of which ports should be configured is assessed at\r\nevaluation time of the configuration. Therefore if one is to use this class,\r\nit must be the final cassandra class included in the manifest.\r\n\r\n#### Parameters\r\n\r\n##### `client_ports`\r\nOnly has any effect if the `cassandra` class is defined on the node.\r\n\r\nAllow these TCP ports to be opened for traffic\r\ncoming from the client subnets.\r\nDefault value '[9042, 9160]'\r\n\r\n##### `client_subnets`\r\nOnly has any effect if the `cassandra` class is defined on the node.\r\n\r\nAn array of the list of subnets that are to allowed connection to\r\ncassandra::native_transport_port and cassandra::rpc_port.\r\nDefault value '['0.0.0.0/0']'\r\n\r\n##### `inter_node_ports`\r\nOnly has any effect if the `cassandra` class is defined on the node.\r\n\r\nAllow these TCP ports to be opened for traffic\r\nbetween the Cassandra nodes.\r\nDefault value '[7000, 7001, 7199]'\r\n\r\n##### `inter_node_subnets`\r\nOnly has any effect if the `cassandra` class is defined on the node.\r\n\r\nAn array of the list of subnets that are to allowed connection to\r\ncassandra::storage_port, cassandra::ssl_storage_port and port 7199\r\nfor cassandra JMX monitoring.\r\nDefault value '['0.0.0.0/0']'\r\n\r\n##### `inter_node_ports`\r\nAllow these TCP ports to be opened for traffic\r\ncoming from OpsCenter subnets.\r\nDefault value '[7000, 7001, 7199]'\r\n\r\n##### `public_ports`\r\nAllow these TCP ports to be opened for traffic\r\ncoming from public subnets the port specified in `$ssh_port` will be\r\nappended to this list.\r\nDefault value '[8888]'\r\n\r\n##### `public_subnets`\r\nAn array of the list of subnets that are to allowed connection to\r\ncassandra::firewall_ports::ssh_port and if cassandra::opscenter has been\r\nincluded, both cassandra::opscenter::webserver_port and\r\ncassandra::opscenter::webserver_ssl_port.\r\nDefault value '['0.0.0.0/0']'\r\n\r\n##### `ssh_port`\r\nWhich port does SSH operate on.\r\nDefault value '22'\r\n\r\n##### `opscenter_ports`\r\nOnly has any effect if the `cassandra::datastax_agent` or\r\n`cassandra::opscenter` classes are defined.\r\n\r\nAllow these TCP ports to be opened for traffic\r\ncoming to or from OpsCenter\r\nappended to this list.\r\nDefault value '[61620, 61621]'\r\n\r\n##### `opscenter_subnets`\r\nA list of subnets that are to be allowed connection to\r\nport 61620 for nodes built with cassandra::opscenter and 61621 for nodes\r\nbuilt with cassandra::datastax_agent.\r\nDefault value '['0.0.0.0/0']'\r\n\r\n### Class: cassandra::java\r\n\r\nA class to install an appropriate Java package.\r\n\r\n#### Parameters\r\n\r\n##### `ensure`\r\nIs passed to the package reference for the JRE/JDK package. Valid values are\r\n**present** or a version number.\r\nDefault value 'present'\r\n\r\n##### `jna_ensure`\r\nIs passed to the package reference for the JNA package. Valid values are\r\n**present** or a version number.\r\nDefault value 'present'\r\n\r\n##### `jna_package_name`\r\nIf the default value of *undef* is left as it is, then a package called\r\njna or libjna-java will be installed on a Red Hat family or Ubuntu system\r\nrespectively. Alternatively, one can specify a package that is available in\r\na package repository to the node.\r\nDefault value *undef*\r\n\r\n##### `package_name`\r\nIf the default value of *undef* is left as it is, then a package called\r\njava-1.8.0-openjdk-headless or openjdk-7-jre-headless will be installed\r\non a Red Hat family or Ubuntu system respectively. Alternatively, one\r\ncan specify a package that is available in a package repository to the\r\nnode.\r\nDefault value *undef*\r\n\r\n### Class: cassandra::opscenter\r\n\r\nThis class installs and manages the DataStax OpsCenter. Leaving the defaults\r\nas they are will provide a running OpsCenter without any authentication on\r\nport 8888.\r\n\r\n#### Parameters\r\n\r\n##### `agents_agent_certfile`\r\nThis sets the agent_certfile setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_agent_keyfile`\r\nThis sets the agent_keyfile setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_agent_keyfile_raw`\r\nThis sets the agent_keyfile_raw setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_config_sleep`\r\nThis sets the config_sleep setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_fingerprint_throttle`\r\nThis sets the fingerprint_throttle setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_incoming_interface`\r\nThis sets the incoming_interface setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_incoming_port`\r\nThis sets the incoming_port setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_install_throttle`\r\nThis sets the install_throttle setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_not_seen_threshold`\r\nThis sets the not_seen_threshold setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_deb`\r\nThis sets the path_to_deb setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_find_java`\r\nThis sets the path_to_find_java setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_installscript`\r\nThis sets the path_to_installscript setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_rpm`\r\nThis sets the path_to_rpm setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_path_to_sudowrap`\r\nThis sets the path_to_sudowrap setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_reported_interface`\r\nThis sets the reported_interface setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_runs_sudo`\r\nThis sets the runs_sudo setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_scp_executable`\r\nThis sets the scp_executable setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_executable`\r\nThis sets the ssh_executable setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_keygen_executable`\r\nThis sets the ssh_keygen_executable setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_keyscan_executable`\r\nThis sets the ssh_keyscan_executable setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_port`\r\nThis sets the ssh_port setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_sys_known_hosts_file`\r\nThis sets the ssh_sys_known_hosts_file setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssh_user_known_hosts_file`\r\nThis sets the ssh_user_known_hosts_file setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssl_certfile`\r\nThis sets the ssl_certfile setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_ssl_keyfile`\r\nThis sets the ssl_keyfile setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_tmp_dir`\r\nThis sets the tmp_dir setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `agents_use_ssl`\r\nThis sets the use_ssl setting in the agents section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_audit_auth`\r\nThis sets the audit_auth setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_audit_pattern`\r\nThis sets the audit_pattern setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_method`\r\nThis sets the authentication_method setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_enabled`\r\nThis sets the enabled setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value 'False'\r\n\r\n##### `authentication_passwd_db`\r\nThis sets the passwd_db setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `authentication_timeout`\r\nThis sets the timeout setting in the authentication section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `cloud_accepted_certs`\r\nThis sets the accepted_certs setting in the cloud section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `clusters_add_cluster_timeout`\r\nThis sets the add_cluster_timeout setting in the clusters section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `clusters_startup_sleep`\r\nThis sets the startup_sleep setting in the clusters section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `config_file`\r\nThe full path to the OpsCenter configuration file.\r\nDefault value '/etc/opscenter/opscenterd.conf'\r\n\r\n##### `definitions_auto_update`\r\nThis sets the auto_update setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_definitions_dir`\r\nThis sets the definitions_dir setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_download_filename`\r\nThis sets the download_filename setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_download_host`\r\nThis sets the download_host setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_download_port`\r\nThis sets the download_port setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_hash_filename`\r\nThis sets the hash_filename setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_sleep`\r\nThis sets the sleep setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_ssl_certfile`\r\nThis sets the ssl_certfile setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `definitions_use_ssl`\r\nThis sets the use_ssl setting in the definitions section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ensure`\r\nThis is passed to the package reference for **opscenter**. Valid values are\r\n**present** or a version number.\r\nDefault value 'present'\r\n\r\n##### `failover_configuration_directory`\r\nThis sets the failover_configuration_directory setting in the failover section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `failover_heartbeat_fail_window`\r\nThis sets the heartbeat_fail_window setting in the failover section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `failover_heartbeat_period`\r\nThis sets the heartbeat_period setting in the failover section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `failover_heartbeat_reply_period`\r\nThis sets the heartbeat_reply_period setting in the failover section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `hadoop_base_job_tracker_proxy_port`\r\nThis sets the base_job_tracker_proxy_port setting in the hadoop section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_admin_group_name`\r\nThis sets the admin_group_name setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_connection_timeout`\r\nThis sets the connection_timeout setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_debug_ssl`\r\nThis sets the debug_ssl setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_group_name_attribute`\r\nThis sets the group_name_attribute setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_group_search_base`\r\nThis sets the group_search_base setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_group_search_filter`\r\nThis sets the group_search_filter setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_group_search_type`\r\nThis sets the group_search_type setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_ldap_security`\r\nThis sets the ldap_security setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_opt_referrals`\r\nThis sets the opt_referrals setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_protocol_version`\r\nThis sets the protocol_version setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_search_dn`\r\nThis sets the search_dn setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_search_password`\r\nThis sets the search_password setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_server_host`\r\nThis sets the server_host setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_server_port`\r\nThis sets the server_port setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_ssl_cacert`\r\nThis sets the ssl_cacert setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_ssl_cert`\r\nThis sets the ssl_cert setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_ssl_key`\r\nThis sets the ssl_key setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_tls_demand`\r\nThis sets the tls_demand setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_tls_reqcert`\r\nThis sets the tls_reqcert setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_uri_scheme`\r\nThis sets the uri_scheme setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_user_memberof_attribute`\r\nThis sets the user_memberof_attribute setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_user_search_base`\r\nThis sets the user_search_base setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ldap_user_search_filter`\r\nThis sets the user_search_filter setting in the ldap section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_level`\r\nThis sets the level setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_log_length`\r\nThis sets the log_length setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_log_path`\r\nThis sets the log_path setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_max_rotate`\r\nThis sets the max_rotate setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `logging_resource_usage_interval`\r\nThis sets the resource_usage_interval setting in the logging section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `package_name`\r\nThe name of the OpsCenter package.\r\nDefault value 'opscenter'\r\n\r\n##### `provisioning_agent_install_timeout`\r\nThis sets the agent_install_timeout setting in the provisioning section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `provisioning_keyspace_timeout`\r\nThis sets the keyspace_timeout setting in the provisioning section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `provisioning_private_key_dir`\r\nThis sets the private_key_dir setting in the provisioning section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_alert_on_repair_failure`\r\nThis sets the alert_on_repair_failure setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_cluster_stabilization_period`\r\nThis sets the cluster_stabilization_period setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_error_logging_window`\r\nThis sets the error_logging_window setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_incremental_err_alert_threshold`\r\nThis sets the incremental_err_alert_threshold setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_incremental_range_repair`\r\nThis sets the incremental_range_repair setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_incremental_repair_tables`\r\nThis sets the incremental_repair_tables setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_ks_update_period`\r\nThis sets the ks_update_period setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_log_directory`\r\nThis sets the log_directory setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_log_length`\r\nThis sets the log_length setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_max_err_threshold`\r\nThis sets the max_err_threshold setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_max_parallel_repairs`\r\nThis sets the max_parallel_repairs setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_max_pending_repairs`\r\nThis sets the max_pending_repairs setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_max_rotate`\r\nThis sets the max_rotate setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_min_repair_time`\r\nThis sets the min_repair_time setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_min_throughput`\r\nThis sets the min_throughput setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_num_recent_throughputs`\r\nThis sets the num_recent_throughputs setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_persist_directory`\r\nThis sets the persist_directory setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_persist_period`\r\nThis sets the persist_period setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_restart_period`\r\nThis sets the restart_period setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_single_repair_timeout`\r\nThis sets the single_repair_timeout setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_single_task_err_threshold`\r\nThis sets the single_task_err_threshold setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `repair_service_snapshot_override`\r\nThis sets the snapshot_override setting in the repair_service section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `request_tracker_queue_size`\r\nThis sets the queue_size setting in the request_tracker section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `security_config_encryption_active`\r\nThis sets the config_encryption_active setting in the security section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `security_config_encryption_key_name`\r\nThis sets the config_encryption_key_name setting in the security section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `security_config_encryption_key_path`\r\nThis sets the config_encryption_key_path setting in the security section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `service_enable`\r\nEnable the OpsCenter service to start at boot time. Valid values are true\r\nor false.\r\nDefault value 'true'\r\n\r\n##### `service_ensure`\r\nEnsure the OpsCenter service is running. Valid values are running or stopped.\r\nDefault value 'running'\r\n\r\n##### `service_name`\r\nThe name of the service that runs the OpsCenter software.\r\nDefault value 'opscenterd'\r\n\r\n##### `spark_base_master_proxy_port`\r\nThis sets the base_master_proxy_port setting in the spark section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `stat_reporter_initial_sleep`\r\nThis sets the initial_sleep setting in the stat_reporter section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `stat_reporter_interval`\r\nThis sets the interval setting in the stat_reporter section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `stat_reporter_report_file`\r\nThis sets the report_file setting in the stat_reporter section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `stat_reporter_ssl_key`\r\nThis sets the ssl_key setting in the stat_reporter section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ui_default_api_timeout`\r\nThis sets the default_api_timeout setting in the ui section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ui_max_metrics_requests`\r\nThis sets the max_metrics_requests setting in the ui section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ui_node_detail_refresh_delay`\r\nThis sets the node_detail_refresh_delay setting in the ui section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `ui_storagemap_ttl`\r\nThis sets the storagemap_ttl setting in the ui section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_interface`\r\nThis sets the interface setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value '0.0.0.0'\r\n\r\n##### `webserver_log_path`\r\nThis sets the log_path setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_port`\r\nThis sets the port setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value '8888'\r\n\r\n##### `webserver_ssl_certfile`\r\nThis sets the ssl_certfile setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_ssl_keyfile`\r\nThis sets the ssl_keyfile setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_ssl_port`\r\nThis sets the ssl_port setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_staticdir`\r\nThis sets the staticdir setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_sub_process_timeout`\r\nThis sets the sub_process_timeout setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n##### `webserver_tarball_process_timeout`\r\nThis sets the tarball_process_timeout setting in the webserver section of the\r\nOpsCenter configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscConfigProps_r.html\r\nfor more details. A value of *undef* will ensure the setting is not present\r\nin the file. Default value *undef*\r\n\r\n\r\n### Class: cassandra::opscenter::pycrypto\r\n\r\nOn the Red Hat family of operating systems, if one intends to use encryption\r\nfor configuration values then the pycrypto library is required. This class\r\nwill install it for the user. See\r\nhttp://docs.datastax.com/en/opscenter/5.2//opsc/configure/installPycrypto.html\r\nfor more details.\r\n\r\nThis class has no effect when included on nodes that are not in the Red Hat\r\nfamily.\r\n\r\n#### Parameters\r\n\r\n##### `ensure`\r\nThis is passed to the package reference for **pycrypto**. Valid values are\r\n**present** or a version number.\r\nDefault value 'present'\r\n\r\n##### `manage_epel`\r\nIf set to true, the **epel-release** package will be installed.\r\nDefault value 'false'\r\n\r\n##### `package_name`\r\nThe name of the PyCrypto package.\r\nDefault value 'pycrypto'\r\n\r\n##### `provider`\r\nThe name of the provider of the pycrypto package.\r\nDefault value 'pip'\r\n\r\n##### `reqd_pckgs`\r\nPackages that are required to install the pycrypto package.\r\nDefault value '['python-devel', 'python-pip' ]'\r\n\r\n### Class: cassandra::optutils\r\n\r\nA class to install the optional Cassandra tools package.\r\n\r\n#### Parameters\r\n\r\n##### `ensure`\r\nIs passed to the package reference. Valid values are **present** or a version\r\nnumber.\r\nDefault value 'present'\r\n\r\n##### `package_name`\r\nIf the default value of *undef* is left as it is, then a package called\r\ncassandra22-tools or cassandra-tools will be installed\r\non a Red Hat family or Ubuntu system respectively. Alternatively, one\r\ncan specify a package that is available in a package repository to the\r\nnode.\r\nDefault value *undef*\r\n\r\n### Defined Type cassandra::opscenter::cluster_name\r\n\r\nWith DataStax Enterprise, one can specify a remote keyspace for OpsCenter\r\nto store metric data (this is not available in the DataStax Community Edition).\r\n\r\n#### Parameters\r\n\r\n##### `cassandra_seed_hosts`\r\nThis sets the seed_hosts setting in the cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_api_port`\r\nThis sets the api_port setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_bind_interface`\r\nThis sets the bind_interface setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_connection_pool_size`\r\nThis sets the connection_pool_size setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_connect_timeout`\r\nThis sets the connect_timeout setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_cql_port`\r\nThis sets the cql_port setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_keyspace`\r\nThis sets the keyspace setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_local_dc_pref`\r\nThis sets the local_dc_pref setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_password`\r\nThis sets the password setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_retry_delay`\r\nThis sets the retry_delay setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_seed_hosts`\r\nThis sets the seed_hosts setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_send_rpc`\r\nThis sets the send_rpc setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_ssl_ca_certs`\r\nThis sets the ssl_ca_certs setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_ssl_client_key`\r\nThis sets the ssl_client_key setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_ssl_client_pem`\r\nThis sets the ssl_client_pem setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_ssl_validate`\r\nThis sets the ssl_validate setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_used_hosts_per_remote_dc`\r\nThis sets the used_hosts_per_remote_dc setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n##### `storage_cassandra_username`\r\nThis sets the username setting in the storage_cassandra section of the\r\n_cluster_name_.conf configuration file. See\r\nhttp://docs.datastax.com/en/opscenter/5.2/opsc/configure/opscStoringCollectionDataDifferentCluster_t.html\r\nfor more details. A value of *undef* will ensure the setting is not\r\npresent in the file. Default value *undef*\r\n\r\n### Defined Type cassandra::firewall_ports::rule\r\n\r\nA defined type to be used as a macro for setting host based firewall\r\nrules. This is not intended to be used by a user (who should use the\r\nAPI provided by cassandra::firewall_ports instead) but is documented\r\nhere for completeness.\r\n\r\n#### Parameters\r\n\r\n##### `title`\r\nA text field that contains the protocol name and CIDR address of a subnet.\r\n\r\n##### `port`\r\nThe number(s) of the port(s) to be opened.\r\n\r\n### Defined Type cassandra::opscenter::setting\r\n\r\nA defined type to be used as a macro for settings in the OpsCenter\r\nconfiguration file. This is not intended to be used by a user (who\r\nshould use the API provided by cassandra::opscenter instead) but is documented\r\nhere for completeness.\r\n\r\n#### Parameters\r\n\r\n##### `service_name`\r\nThe name of the service to be notified if a change is made to the\r\nconfiguration file. Typically this would by **opscenterd**.\r\n\r\n##### `path`\r\nThe path to the configuration file. Typically this would by\r\n**/etc/opscenter/opscenterd.conf**.\r\n\r\n##### `section`\r\nThe section in the configuration file to be added to (e.g. **webserver**).\r\n\r\n##### `setting`\r\nThe setting within the section of the configuration file to changed\r\n(e.g. **port**).\r\n\r\n##### `value`\r\nThe setting value to be changed to (e.g. **8888**).\r\n\r\n## Limitations\r\n\r\nTested on the Red Hat family versions 6 and 7, Ubuntu 12.04 and 14.04,\r\nDebian 7 Puppet (CE) 3.7.5 and DSC 2.\r\n\r\n## Contributers\r\n\r\nContributions will be gratefully accepted. Please go to the project page,\r\nfork the project, make your changes locally and then raise a pull request.\r\nDetails on how to do this are available at\r\nhttps://guides.github.com/activities/contributing-to-open-source.\r\n\r\n### Additional Contributers\r\n\r\n* Yanis Guenane (GitHub [@spredzy](https://github.com/Spredzy)) provided the\r\nCassandra 1.x compatible template\r\n(see [#11](https://github.com/locp/cassandra/pull/11)).\r\n\r\n* Amos Shapira (GitHub [@amosshapira](https://github.com/amosshapira)) fixed\r\na bug in the requirements metadata that caused a problem with Puppetfile\r\n(see [#34](https://github.com/locp/cassandra/pull/34)).\r\n\r\n* Dylan Griffith (GitHub [@DylanGriffith](https://github.com/DylanGriffith))\r\nidentified that the dependency for puppetlabs-apt was incorrect\r\n(see [#87](https://github.com/locp/cassandra/pull/87)).\r\n\r\n* Sam Powers (GitHub [@sampowers](https://github.com/sampowers)) reported a\r\nbug in the ability to set the running state of the Cassandra service and\r\nsubsequently submitted a pull request with a fix\r\n(see [#93](https://github.com/locp/cassandra/issues/93)).\r\n","google":"UA-6773548-6","note":"Don't delete this file! It's used internally to help with page regeneration."} \ No newline at end of file From f1260cea159c87390bce7b0a2a7fb546c0ed83ce Mon Sep 17 00:00:00 2001 From: dallinb Date: Thu, 3 Sep 2015 08:58:02 +0100 Subject: [PATCH 12/12] [blacksmith] Bump version to 1.3.6 --- metadata.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metadata.json b/metadata.json index 22dd0275..28388ecd 100644 --- a/metadata.json +++ b/metadata.json @@ -1,6 +1,6 @@ { "name": "locp-cassandra", - "version": "1.3.5", + "version": "1.3.6", "author": "locp", "summary": "A Puppet module to install and manage Cassandra, DataStax Agent & OpsCenter", "license": "Apache-2.0",