cookbook 'nexenta', '~> 1.3.0'
nexenta (1) Versions 1.3.0 Follow0
Manages configuration settings of NexentaStor ZFS based storage systems
cookbook 'nexenta', '~> 1.3.0', :supermarket
knife supermarket install nexenta
knife supermarket download nexenta
Description
Cookbook to manage configuration settings of NexentaStor ZFS based storage systems.
Requirements
Chef 0.10+
Platform
- NexentaStor 3.x
Tested On:
- NexentaStor 3.1.2
- NexentaStor 3.1.3
- NexentaStor 3.1.3.5
- NexentaStor 3.1.4
- NexentaStor 3.1.4.1
- NexentaStor 3.1.4.2
With Chef clients:
* 11.2.0
* 11.6.0
Attributes
Configure all settings by changing the attributes. Best practice would be to change these in Node and Environment
attributes. Alternatively the attributes/default.rb
can be changed directly. Some settings are used based on the node's version.
Some extra information about the non-default settings:
-
default["nexenta"]["nms"]["ses_check_flapping_default"]
- Must be a value between 0 and 9.
Only for NexentaStor 3.1.4 and higher. The ses-check runner occasionally gives false positives, for which this setting has been added. The suggested value ensures no false positives occur. default["nexenta"]["nms"]["nms_reporter_default"]
- Must be either "enable" or "disable".
The NMS reporter aggregates information once a week and mails this. The aggregation process can hang the NMS
for a few minutes, impeding monitoring. The suggested value disables the NMS reporter.default["nexenta"]["logadm"]["nmv_log_rotate_default"]
- Must be in format "XXm".
Log rotation for nmv.log is not implemented in 3.x. The suggested value adds the same log rotation to nmv.log
as the default for other log files which do have log rotation.default["nexenta"]["nfs"]["nfs_server_versmax"]
- Set the max NFS server version.
For some workloads/applications it is not recommended to use NFSv4 (VMware, Xen) or for some
applications enabling NFSv4 does not work at all (Cloudstack).default["nexenta"]["nfs"]["nfs_client_versmax"]
- Set the max NFS client version.
For some workloads/applications it is not recommended to use NFSv4 (VMware, Xen) or for some
applications enabling NFSv4 does not work at all (Cloudstack).default["nexenta"]["snmp"]["extends"]
- Add SNMP extends if needed.
SNMP extend scripts can be added in format ["custom_cpu /etc/custom_cpu.sh", "custom_mem /etc/custom_mem.sh"].default["nexenta"]["system"]["extra"]
- Any key/value pair can be added.
These will then be added to /etc/system in the #Non-Defaults section. The below are suggestions/examples.default["nexenta"]["system"]["extra"]["swapfs_minfree"]
- Number of 4kb pages.
This sets the minimum amount of memory which will always be available for the system (not used by ARC).
Default is 1/8th of total memory, which is way to much in a high memory system. The suggested value
results in 4GB of memory which will not be used by ARC.default["nexenta"]["system"]["extra"]["l2arc_write_boost"]
- Max bytes/s to fill the L2ARC.
Only used when the ARC itself is not full. Ensures the L2ARC is populated fast after a failover or reboot.default["nexenta"]["authorized_keys"]["joe"]
- Joe's public SSH key for easy/secure logon.
Add a extra attribute and key for each user.
Templates
-
System.erb
- Dynamically adds /etc/system settings based on NexentaStor version and settings set in the attributes file. In effect after reboot.
-
Authorized_keys.erb
- Adds the node's partner key (if there is a ssh-bind) and any other keys specified in the attributes file. -
Resolv.conf.erb
- Dynamically adds the domain name and sets the domain name as first search domain since NexentaStor derives the hosts FQDN from the first search domain. Search domains specified in the attributes file are added after the domain name.
Usage
- Install chef-client on your NexentaStor ZFS based storage system (after the initial setup has completed).
- Configure the attributes file (and any environment attributes if necessary/used) for your environment.
- Create a role for NexentaStor systems which uses the cookbooks default recipe.
- Add the newly created role to your NexentaStor systems.
- After the first two chef-client runs all settings will have been set.
License and Author
- Author:: Brenn Oosterbaan (boosterbaan@schubergphilis.com)
Copyright:: 2013 Schuberg Philis
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
1.3.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.3.0 failed this metric
FC064: Ensure issues_url is set in metadata: nexenta/metadata.rb:1
FC065: Ensure source_url is set in metadata: nexenta/metadata.rb:1
FC066: Ensure chef_version is set in metadata: nexenta/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: nexenta/metadata.rb:1
FC069: Ensure standardized license defined in metadata: nexenta/metadata.rb:1
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:170
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:190
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:208
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
1.3.0 passed this metric
Testing File Metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.3.0 failed this metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.3.0 failed this metric
FC064: Ensure issues_url is set in metadata: nexenta/metadata.rb:1
FC065: Ensure source_url is set in metadata: nexenta/metadata.rb:1
FC066: Ensure chef_version is set in metadata: nexenta/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: nexenta/metadata.rb:1
FC069: Ensure standardized license defined in metadata: nexenta/metadata.rb:1
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:170
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:190
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:208
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
1.3.0 passed this metric
Testing File Metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.3.0 failed this metric
FC065: Ensure source_url is set in metadata: nexenta/metadata.rb:1
FC066: Ensure chef_version is set in metadata: nexenta/metadata.rb:1
FC067: Ensure at least one platform supported in metadata: nexenta/metadata.rb:1
FC069: Ensure standardized license defined in metadata: nexenta/metadata.rb:1
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:170
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:190
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: nexenta/recipes/default.rb:208
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
1.3.0 passed this metric
Testing File Metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.3.0 failed this metric
1.3.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number