Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

cassandra-opscenter (2) Versions 0.1.0

Installs Opscenter for monitoring Cassandra

Policyfile
Berkshelf
Knife
cookbook 'cassandra-opscenter', '~> 0.1.0', :supermarket
cookbook 'cassandra-opscenter', '~> 0.1.0'
knife supermarket install cassandra-opscenter
knife supermarket download cassandra-opscenter
README
Dependencies
Quality 33%

Description

This cookbook exists to make a deployment of a Datastax Opscenter cluster on a Cassandra cluster in Amazon EC2.

Datastax Opscenter is a Monitoring and Management platform for Apache Cassandra - vital for visualising Cassandra's Status.

Datastax Opscenter is deployed in a traditional many-clients just-one-server model, which conflicts slightly with Cassandra's masterless deployment model.

To get around needing to know this/manage in an automated manner a leadership election takes place between nodes in the cluster, a leader is automatically assigned based on having the 'lowest' alphanumeric hostname, and that leader generates an agent package which is then distributed by http and verified by checksum.

The good news is that Opscenter stores its data within Cassandra itself in its own Keyspace (2 replicas) so if a leader is terminated and a new leader arises from the ashes, no data should be lost.

This cookbook supports two modes of deployment - multiregion OR non-multiregion, set through attributes. We default to non-multiregion aka singleregion. The way multiregion is expressed is in a difference in the agent's address configuration. Check the attributes for how to set this.

This cookbook deploys the tarball version of opscenter because the packages provided tend to install as root, whereas this cookbook installs/runs opscenter as a unique system user.

This cookbook holds certain assumptions to be true in order to easily manage its deployment:

A) You are deploying this on EC2
Reason: This cookbook was developed on/designed for EC2 deployment. If you want to support non-EC2 deployment please submit patches.
B) All members of the cluster share the same UNIQUE chef role and this is the first role in the list of roles. i.e. cassandra-cluster-one or product-production-casdb.
Reason: The unique role is used to search for other cluster members for shared information. If you want to extend/improve this please submit patches.
C) Connectivity between cluster members is suffiently open to allow for agent distribution and agent connectivity. Typically you should have a security group that allows relatively open access from that security group on port 80 for agent distrubtion.
Reason: Nothing will work without connectivity anyway. No node is an island.

Requirements

  • Chef 10.16.4+
  • Cassandra on each node.
  • Python cookbook to run the server.
  • Java cookbook to run the agent (on each node including the elected server).
  • Nginx for agent distribution on the elected server.

Platform

  • Ubuntu 12.04+ [tested heavily]
  • Very Probably Debian
  • Probably RPM-based distros. [we do attempt to differentiate where necessary]

Attributes

See the contents of attributes/default.rb where there are accurate comments and self-explanatory attribute names.

Recipes

  • default.rb : A dummy recipe pointing to install.rb
  • install.rb : Installs everything by calling the rest of the recipes in the right order. Includes a leadership election section for nominating the server.
  • opscenter-server.rb : Installs the server
  • opscenter-agent.rb : Installs the agent
  • opscenter-server-shutdown.rb : Shuts down the server when a new leader takes over - we wouldn't want to waste ram, right ?

Usage

Include cassandra-opscenter in your runlist.

Ensure you have enough connectivity between cluster members so that the agent can be distributed. (over the http port)

Once this cookbook is deployed and the nodes converged, login to the cluster member with the lowest alphanumeric node.name on port 8888

Click 'Use Existing Cluster' in the dialogue box.

In the next dialogue box add the hostname you have connected to the cluster list and click 'Save Cluster'.

multiregion requires the following attribute be set - this is from the cassandra-priam cookbook, but would work for non-priam deployments of opscenter and cassandra:

{
  "cassandra": {
    "priam_multiregion_enable": "true"
  }
}

Development

See the Github page

Authors

Copyright: 2013–2013 Medidata Solutions, Inc.

Dependent cookbooks

python >= 0.0.0
java >= 0.0.0
nginx >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric
            

0.1.0 failed this metric

Failure: Cookbook has 1 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

0.1.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
            

0.1.0 failed this metric

FC064: Ensure issues_url is set in metadata: cassandra-opscenter/metadata.rb:1
FC065: Ensure source_url is set in metadata: cassandra-opscenter/metadata.rb:1
FC066: Ensure chef_version is set in metadata: cassandra-opscenter/metadata.rb:1
FC069: Ensure standardized license defined in metadata: cassandra-opscenter/metadata.rb:1
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: cassandra-opscenter/recipes/install.rb:21
FC075: Cookbook uses node.save to save partial node data to the chef-server mid-run: cassandra-opscenter/recipes/opscenter-server.rb:132
FC104: Use the :run action in ruby_block instead of :create: cassandra-opscenter/recipes/opscenter-server.rb:120
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

0.1.0 passed this metric

Testing File Metric
            

0.1.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
            

0.1.0 passed this metric