elzar 0.0.1

data/cookbooks/apt/files/default/apt-proxy-v2.conf

@@ -0,0 +1,50 @@
+[DEFAULT]
+;; All times are in seconds, but you can add a suffix
+;; for minutes(m), hours(h) or days(d)
+
+;; commented out address so apt-proxy will listen on all IPs
+;; address = 127.0.0.1
+port = 9999
+cache_dir = /var/cache/apt-proxy
+
+;; Control files (Packages/Sources/Contents) refresh rate
+min_refresh_delay = 1s
+complete_clientless_downloads = 1
+
+;; Debugging settings.
+debug = all:4 db:0
+
+time = 30
+passive_ftp = on
+
+;;--------------------------------------------------------------
+;; Cache housekeeping
+
+cleanup_freq = 1d
+max_age = 120d
+max_versions = 3
+
+;;---------------------------------------------------------------
+;; Backend servers
+;;
+;; Place each server in its own [section]
+
+[ubuntu]
+; Ubuntu archive
+backends =
+        http://us.archive.ubuntu.com/ubuntu
+
+[ubuntu-security]
+; Ubuntu security updates
+backends = http://security.ubuntu.com/ubuntu
+
+[debian]
+;; Backend servers, in order of preference
+backends = 
+        http://debian.osuosl.org/debian/
+
+[security]
+;; Debian security archive
+backends = 
+        http://security.debian.org/debian-security
+        http://ftp2.de.debian.org/debian-security

data/cookbooks/apt/metadata.rb

@@ -0,0 +1,13 @@
+maintainer        "Opscode, Inc."
+maintainer_email  "cookbooks@opscode.com"
+license           "Apache 2.0"
+description       "Configures apt and apt services and an LWRP for managing apt repositories"
+long_description  IO.read(File.join(File.dirname(__FILE__), 'README.md'))
+version           "1.2.0"
+recipe            "apt", "Runs apt-get update during compile phase and sets up preseed directories"
+recipe            "apt::cacher", "Set up an APT cache"
+recipe            "apt::cacher-client", "Client for the apt::cacher server"
+
+%w{ ubuntu debian }.each do |os|
+  supports os
+end

data/cookbooks/apt/providers/repository.rb

@@ -0,0 +1,73 @@
+#
+# Cookbook Name:: apt
+# Provider:: repository
+#
+# Copyright 2010-2011, Opscode, Inc.
+#
+# 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.
+#
+
+action :add do
+  unless ::File.exists?("/etc/apt/sources.list.d/#{new_resource.repo_name}-source.list")
+    Chef::Log.info "Adding #{new_resource.repo_name} repository to /etc/apt/sources.list.d/#{new_resource.repo_name}-source.list"
+    # add key
+    if new_resource.keyserver && new_resource.key
+      execute "install-key #{new_resource.key}" do
+        command "apt-key adv --keyserver #{new_resource.keyserver} --recv #{new_resource.key}"
+        action :nothing
+      end.run_action(:run)
+    elsif new_resource.key && (new_resource.key =~ /http/)
+      key_name = new_resource.key.split(/\//).last
+      remote_file "#{Chef::Config[:file_cache_path]}/#{key_name}" do
+        source new_resource.key
+        mode "0644"
+        action :nothing
+      end.run_action(:create_if_missing)
+      execute "install-key #{key_name}" do
+        command "apt-key add #{Chef::Config[:file_cache_path]}/#{key_name}"
+        action :nothing
+      end.run_action(:run)
+    end
+    # build our listing
+    repository = "deb"
+    repository = "deb-src" if new_resource.deb_src
+    repository = "# Created by the Chef apt_repository LWRP\n" + repository
+    repository += " #{new_resource.uri}"
+    repository += " #{new_resource.distribution}"
+    new_resource.components.each {|component| repository += " #{component}"}
+    # write out the file, replace it if it already exists
+    file "/etc/apt/sources.list.d/#{new_resource.repo_name}-source.list" do
+      owner "root"
+      group "root"
+      mode 0644
+      content repository + "\n"
+      action :nothing
+    end.run_action(:create)
+    execute "update package index" do
+      command "apt-get update"
+      ignore_failure true
+      action :nothing
+    end.run_action(:run)
+    new_resource.updated_by_last_action(true)
+  end
+end
+
+action :remove do
+  if ::File.exists?("/etc/apt/sources.list.d/#{new_resource.repo_name}-source.list")
+    Chef::Log.info "Removing #{new_resource.repo_name} repository from /etc/apt/sources.list.d/"
+    file "/etc/apt/sources.list.d/#{new_resource.repo_name}-source.list" do
+      action :delete
+    end
+    new_resource.updated_by_last_action(true)
+  end
+end

data/cookbooks/apt/recipes/cacher-client.rb

@@ -0,0 +1,44 @@
+#
+# Cookbook Name:: apt
+# Recipe:: cacher-client
+#
+# Copyright 2011, Opscode, Inc.
+#
+# 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.
+#
+
+#remove Acquire::http::Proxy lines from /etc/apt/apt.conf since we use 01proxy
+#these are leftover from preseed installs
+execute "Remove proxy from /etc/apt/apt.conf" do
+  command "sed --in-place '/^Acquire::http::Proxy/d' /etc/apt/apt.conf"
+  only_if "grep Acquire::http::Proxy /etc/apt/apt.conf"
+end
+
+servers = search(:node, 'recipes:apt\:\:cacher') || []
+if servers.length > 0
+  Chef::Log.info("apt-cacher server found on #{servers[0]}.")
+  proxy = "Acquire::http::Proxy \"http://#{servers[0].ipaddress}:3142\";\n"
+  file "/etc/apt/apt.conf.d/01proxy" do
+    owner "root"
+    group "root"
+    mode "0644"
+    content proxy
+    action :create
+  end
+else
+  Chef::Log.info("No apt-cacher server found.")
+  file "/etc/apt/apt.conf.d/01proxy" do
+    action :delete
+    only_if {File.exists?("/etc/apt/apt.conf.d/01proxy")}
+  end
+end

data/cookbooks/apt/recipes/cacher.rb

@@ -0,0 +1,45 @@
+#
+# Cookbook Name:: apt
+# Recipe:: cacher
+#
+# Copyright 2008-2011, Opscode, Inc.
+#
+# 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.
+#
+package "apt-cacher" do
+  action :install
+end
+
+service "apt-cacher" do
+  supports :restart => true, :status => false
+  action [ :enable, :start ]
+end
+
+cookbook_file "/etc/apt-cacher/apt-cacher.conf" do
+  source "apt-cacher.conf"
+  owner "root"
+  group "root"
+  mode 0644
+  notifies :restart, resources(:service => "apt-cacher")
+end
+
+cookbook_file "/etc/default/apt-cacher" do
+  source "apt-cacher"
+  owner "root"
+  group "root"
+  mode 0644
+  notifies :restart, resources(:service => "apt-cacher")
+end
+
+#this will help seed the proxy
+include_recipe "apt::cacher-client"

data/cookbooks/apt/recipes/default.rb

@@ -0,0 +1,50 @@
+#
+# Cookbook Name:: apt
+# Recipe:: default
+#
+# Copyright 2008-2011, Opscode, Inc.
+# Copyright 2009, Bryan McLellan <btm@loftninjas.org>
+#
+# 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.
+#
+
+# Run apt-get update to create the stamp file
+execute "apt-get-update" do
+  command "apt-get update"
+  ignore_failure true
+  not_if do ::File.exists?('/var/lib/apt/periodic/update-success-stamp') end
+  action :nothing
+end
+
+# provides /var/lib/apt/periodic/update-success-stamp on apt-get update
+package "update-notifier-common" do
+  notifies :run, resources(:execute => "apt-get-update"), :immediately
+end
+
+execute "apt-get-update-periodic" do
+  command "apt-get update"
+  ignore_failure true
+  only_if do
+    File.exists?('/var/lib/apt/periodic/update-success-stamp') &&
+    File.mtime('/var/lib/apt/periodic/update-success-stamp') < Time.now - 86400
+  end
+end
+
+%w{/var/cache/local /var/cache/local/preseeding}.each do |dirname|
+  directory dirname do
+    owner "root"
+    group "root"
+    mode  0644
+    action :create
+  end
+end

data/cookbooks/apt/resources/repository.rb

@@ -0,0 +1,30 @@
+#
+# Cookbook Name:: apt
+# Resource:: repository
+#
+# Copyright 2010-2011, Opscode, Inc.
+#
+# 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.
+#
+
+actions :add, :remove
+
+#name of the repo, used for source.list filename
+attribute :repo_name, :kind_of => String, :name_attribute => true
+attribute :uri, :kind_of => String
+attribute :distribution, :kind_of => String
+attribute :components, :kind_of => Array, :default => []
+#whether or not to add the repository as a source repo as well
+attribute :deb_src, :default => false
+attribute :keyserver, :kind_of => String, :default => nil
+attribute :key, :kind_of => String, :default => nil

data/cookbooks/build-essential/README.md

@@ -0,0 +1,24 @@
+DESCRIPTION
+===========
+
+Installs packages required for compiling C software from source.
+
+LICENSE AND AUTHOR
+==================
+
+Author:: Joshua Timberman (<joshua@opscode.com>)
+Author:: Seth Chisamore (<schisamo@opscode.com>)
+
+Copyright 2009-2011, Opscode, Inc.
+
+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.

data/cookbooks/build-essential/metadata.rb

@@ -0,0 +1,10 @@
+maintainer        "Opscode, Inc."
+maintainer_email  "cookbooks@opscode.com"
+license           "Apache 2.0"
+description       "Installs C compiler / build tools"
+version           "1.0.0"
+recipe            "build-essential", "Installs C compiler and build tools on Linux"
+
+%w{ fedora redhat centos ubuntu debian }.each do |os|
+  supports os
+end

data/cookbooks/build-essential/recipes/default.rb

@@ -0,0 +1,45 @@
+#
+# Cookbook Name:: build-essential
+# Recipe:: default
+#
+# Copyright 2008-2009, Opscode, Inc.
+#
+# 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.
+#
+
+case node['platform']
+when "ubuntu","debian"
+  %w{build-essential binutils-doc}.each do |pkg|
+    package pkg do
+      action :install
+    end
+  end
+when "centos","redhat","fedora"
+  %w{gcc gcc-c++ kernel-devel make}.each do |pkg|
+    package pkg do
+      action :install
+    end
+  end
+end
+
+package "autoconf" do
+  action :install
+end
+
+package "flex" do
+  action :install
+end
+
+package "bison" do
+  action :install
+end

data/cookbooks/database/README.md

@@ -0,0 +1,403 @@
+Database Cookbook
+=================
+
+The main highlight of this cookbook is the `database` and `database_user` resources for managing databases and database users in a RDBMS.  Providers for MySQL, PostgreSQL and SQL Server are also provided, see usage documentation below.
+
+This cookbook also contains recipes to configure mysql database masters and slaves and uses EBS for storage, integrating together with the application cookbook utilizing data bags for application related information. These recipes are written primarily to use MySQL and the Opscode mysql cookbook. Other RDBMS may be supported at a later date.  This cookbook does not automatically restore database dumps, but does install tools to help with that.
+
+Requirements
+============
+
+Chef 0.10.0 or higher required (for Chef environment use).
+
+Platform
+--------
+
+* Debian, Ubuntu
+* Red Hat, CentOS, Scientific, Fedora
+
+Cookbooks
+---------
+
+The following Opscode cookbooks are dependencies:
+
+* mysql
+* postgresql
+* xfs
+* aws
+
+Resources/Providers
+===================
+
+These resources aim to expose an abstraction layer for interacting with different RDBMS in a general way.  Currently the cookbook ships with providers for MySQL, PostgreSQL and SQL Server.  Please see specific usage in the __Example__ sections below.  The providers use specific Ruby gems to execute commands and carry out actions.  These gems will need to be installed before the providers can operate correctly.  Specific notes for each RDBS flavor:
+
+- MySQL: leverages the `mysql` gem which is installed as part of the `mysql::client` recipe.
+- PostgreSQL: leverages the `pg` gem which is installed as part of the `postgresql::client` recipe.
+- SQL Server: leverages the `tiny_tds` gem which is installed as part of the `sql_server::client` recipe.
+
+`database`
+----------
+
+Manage databases in a RDBMS.  Use the proper shortcut resource depending on your RDBMS: `mysql_database`, `postgresql_database` or `sql_server_database`.
+
+### Actions
+
+- :create: create a named database
+- :drop: drop a named database
+- :query: execute an arbitrary query against a named database
+
+### Attribute Parameters
+
+- database_name: name attribute. Name of the database to interact with
+- connection: hash of connection info. valid keys include :host, :port, :username, :password
+- sql: string of sql to execute against the database.  used by :query action only
+
+### Providers
+
+- **Chef::Provider::Database::Mysql**: shortcut resource `mysql_database`
+- **Chef::Provider::Database::Postgresql**: shortcut resource `postgresql_database`
+- **Chef::Provider::Database::SqlServer**: shortcut resource `sql_server_database`
+
+### Examples
+
+    # create a mysql database
+    mysql_database 'oracle_rules' do
+      connection ({:host => "localhost", :username => 'root', :password => node['mysql']['server_root_password']})
+      action :create
+    end
+    
+    # create a sql server database
+    sql_server_database 'mr_softie' do
+      connection ({:host => "127.0.0.1", :port => node['sql_server']['port'], :username => 'sa', :password => node['sql_server']['server_sa_password']})
+      action :create
+    end
+
+    # create a postgresql database
+    postgresql_database 'mr_softie' do
+      connection ({:host => "127.0.0.1", :port => 5432, :username => 'postgres', :password => node['postgresql']['password']['postgres']})
+      action :create
+    end
+    
+    # create a postgresql database with additional parameters
+    postgresql_database 'mr_softie' do
+      connection ({:host => "127.0.0.1", :port => 5432, :username => 'postgres', :password => node['postgresql']['password']['postgres']})
+      template 'DEFAULT'
+      encoding 'DEFAULT'
+      tablespace 'DEFAULT'
+      connection_limit '-1'
+      owner 'postgres'
+      action :create
+    end
+
+    # externalize conection info in a ruby hash
+    mysql_connection_info = {:host => "localhost", :username => 'root', :password => node['mysql']['server_root_password']}
+    sql_server_connection_info = {:host => "localhost", :port => node['sql_server']['port'], :username => 'sa', :password => node['sql_server']['server_sa_password']}
+    postgresql_connection_info = {:host => "127.0.0.1", :port => 5432, :username => 'postgres', :password => node['postgresql']['password']['postgres']}
+    
+    # same create commands, connection info as an external hash
+    mysql_database 'foo' do
+      connection mysql_connection_info
+      action :create
+    end
+    sql_server_database 'foo' do
+      connection sql_server_connection_info
+      action :create
+    end
+    postgresql_database 'foo' do
+      connection postgresql_connection_info
+      action :create
+    end
+    
+    # create database, set provider in resource parameter
+    database 'bar' do
+       connection mysql_connection_info
+       provider Chef::Provider::Database::Mysql
+       action :create
+    end
+    database 'bar' do
+      connection sql_server_connection_info
+      provider Chef::Provider::Database::SqlServer
+      action :create
+    end
+    database 'bar' do
+      connection postgresql_connection_info
+      provider Chef::Provider::Database::Postgresql
+      action :create
+    end
+    
+    # drop a database
+    mysql_database "baz" do
+      connection mysql_connection_info
+      action :drop
+    end
+    
+    # query a database
+    mysql_database "flush the privileges" do
+      connection mysql_connection_info
+      sql "flush privileges"
+      action :query
+    end
+
+    # vacuum a postgres database
+    postgres_database "vacuum databases" do
+      connection postgresql_connection_info
+      database_table "template1"
+      sql "VACUUM FULL VERBOSE ANALYZE"
+      action :query
+    end
+
+`database_user`
+---------------
+
+Manage users and user privileges in a RDBMS. Use the proper shortcut resource depending on your RDBMS: `mysql_database_user` or `sql_server_database_user`.
+
+### Actions
+
+- :create: create a user
+- :drop: drop a user
+- :grant: manipulate user privileges on database objects
+
+### Attribute Parameters
+
+- username: name attribute. Name of the database user
+- password: password for the user account
+- database_name: Name of the database to interact with
+- connection: hash of connection info. valid keys include :host, :port, :username, :password
+- privileges: array of database privileges to grant user. used by the :grant action. default is :all
+- host: host where user connections are allowed from. used by MySQL provider only. default is 'localhost'
+- table: table to grant privileges on. used by :grant action and MySQL provider only. default is '*' (all tables)
+
+### Providers
+
+- **Chef::Provider::Database::MysqlUser**: shortcut resource `mysql_database_user`
+- **Chef::Provider::Database::SqlServerUser**: shortcut resource `sql_server_database_user`
+
+### Examples
+
+    # create connection info as an external ruby hash
+    mysql_connection_info = {:host => "localhost", :username => 'root', :password => node['mysql']['server_root_password']}
+    sql_server_connection_info = {:host => "localhost", :port => node['sql_server']['port'], :username => 'sa', :password => node['sql_server']['server_sa_password']}
+    
+    # create a mysql user but grant no priveleges
+    mysql_database_user 'disenfranchised' do
+      connection mysql_connection_info
+      password 'super_secret'
+      action :create
+    end
+    
+    # do the same but pass the provider to the database resource
+    database_user 'disenfranchised' do
+      connection mysql_connection_info
+      password 'super_secret'
+      provider Chef::Provider::Database::MysqlUser
+      action :create
+    end
+    
+    # create a sql server user but grant no priveleges
+    sql_server_database_user 'disenfranchised' do
+      connection sql_server_connection_info
+      password 'super_secret'
+      action :create
+    end
+    
+    # drop a mysql user
+    mysql_database_user "foo_user" do
+      connection mysql_connection_info
+      action :drop
+    ends
+    
+    # bulk drop sql server users
+    %w{ disenfranchised foo_user }.each do |user|
+      sql_server_database_user user do
+        connection sql_server_connection_info
+        action :drop
+      end
+    end
+    
+    # grant select,update,insert privileges to all tables in foo db from all hosts
+    mysql_database_user 'foo_user' do
+      connection mysql_connection_info
+      password 'super_secret'
+      database_name 'foo'
+      host '%'
+      privileges [:select,:update,:insert]
+      action :grant
+    end
+    
+    # grant all privelages on all databases/tables from localhost
+    mysql_database_user 'super_user' do
+      connection mysql_connection_info
+      password 'super_secret'
+      action :grant
+    end
+    
+    # grant select,update,insert privileges to all tables in foo db
+    sql_server_database_user 'foo_user' do
+      connection sql_server_connection_info
+      password 'super_secret'
+      database_name 'foo'
+      privileges [:select,:update,:insert]
+      action :grant
+    end
+
+Recipes
+=======
+
+ebs\_volume
+-----------
+
+Loads the aws information from the data bag. Searches the applications data bag for the database master or slave role and checks that role is applied to the node. Loads the EBS information and the master information from data bags. Uses the aws cookbook LWRP, `aws_ebs_volume` to manage the volume.
+
+On a master node:
+* if we have an ebs volume already as stored in a data bag, attach it.
+* if we don't have the ebs information then create a new one and attach it.
+* store the volume information in a data bag via a ruby block.
+
+On a slave node:
+* use the master volume information to generate a snapshot.
+* create the new volume from the snapshot and attach it.
+
+Also on a master node, generate some configuration for running a snapshot via `chef-solo` from cron.
+
+On a new filesystem volume, create as XFS, then mount it in /mnt, and also bind-mount it to the mysql data directory (default /var/lib/mysql).
+
+master
+------
+
+This recipe no longer loads AWS specific information, and the database position for replication is no longer stored in a databag because the client might not have permission to write to the databag item. This may be handled in a different way at a future date.
+
+Searches the apps databag for applications, and for each one it will check that the specified database master role is set in both the databag and applied to the node's run list. Then, retrieves the passwords for `root`, `repl` and `debian` users and saves them to the node attributes. If the passwords are not found in the databag, it prints a message that they'll be generated by the mysql cookbook.
+
+Then it adds the application databag database settings to a hash, to use later.
+
+Then it will iterate over the databases and create them with the `mysql_database` resource while adding privileges for application specific database users using the `mysql_database_user` resource.
+
+slave
+-----
+
+_TODO_: Retrieve the master status from a data bag, then start replication using a ruby block. The replication status needs to be handled in some other way for now since the master recipe above doesn't actually set it in the databag anymore.
+
+snapshot
+--------
+
+Run via Chef Solo. Retrieves the db snapshot configuration from the specified JSON file. Uses the `mysql_database` resource to lock and unlock tables, and does a filesystem freeze and EBS snapshot.
+
+Deprecated Recipes
+==================
+
+The following recipe is considered deprecated. It is kept for reference purposes.
+
+ebs\_backup
+-----------
+
+Older style of doing mysql snapshot and replication using Adam Jacob's [ec2_mysql](http://github.com/adamhjk/ec2_mysql) script and library.
+
+Data Bags
+=========
+
+This cookbook uses the apps data bag item for the specified application; see the `application` cookbook's README.md. It also creates data bag items in a bag named 'aws' for storing volume information. In order to interact with EC2, it expects aws to have a main item:
+
+    {
+      "id": "main",
+      "ec2_private_key": "private key as a string",
+      "ec2_cert": "certificate as a string",
+      "aws_account_id": "",
+      "aws_secret_access_key": "",
+      "aws_access_key_id": ""
+    }
+
+Note: with the Open Source Chef Server, the server using the database recipes must be an admin client or it will not be able to create data bag items. You can modify whether the client is admin by editing it with knife.
+
+    knife client edit <client_name>
+    {
+      ...
+      "admin": true
+      ...
+    }
+
+This is not required if the Chef Server is the Opscode Platform, instead use the ACL feature to modify access for the node to be able to update the data bag.
+
+Usage
+=====
+
+Aside from the application data bag (see the README in the application cookbook), create a role for the database master. Use a role.rb in your chef-repo, or create the role directly with knife.
+
+    % knife role show my_app_database_master -Fj
+    {
+      "name": "my_app_database_master",
+      "chef_type": "role",
+      "json_class": "Chef::Role",
+      "default_attributes": {
+      },
+      "description": "",
+      "run_list": [
+        "recipe[mysql::server]",
+        "recipe[database::master]"
+      ],
+      "override_attributes": {
+      }
+    }
+
+Create a `production` environment. This is also used in the `application` cookbook.
+
+    % knife environment show production -Fj
+    {
+      "name": "production",
+      "description": "",
+      "cookbook_versions": {
+      },
+      "json_class": "Chef::Environment",
+      "chef_type": "environment",
+      "default_attributes": {
+      },
+      "override_attributes": {
+      }
+    }
+    
+
+The cookbook `my_app_database` is recommended to set up any application specific database resources such as configuration templates, trending monitors, etc. It is not required, but you would need to create it separately in `site-cookbooks`. Add it to the `my_app_database_master` role.
+
+Changes/Roadmap
+===============
+
+## Future
+
+* update `database::master` to work with any RDBMS provider (most likely keying off database adapter)
+
+## v1.1.0
+
+* [COOK-716] providers for PostgreSQL
+
+## v1.0.0
+
+* [COOK-683] added `database` and `database_user` resources
+* [COOK-684] MySQL providers
+* [COOK-685] SQL Server providers
+* refactored `database::master` and `database::snapshot` recipes to leverage new resources
+
+## v0.99.1
+
+* Use Chef 0.10's `node.chef_environment` instead of `node['app_environment']`.
+
+License and Author
+==================
+
+Author:: Adam Jacob (<adam@opscode.com>)
+Author:: Joshua Timberman (<joshua@opscode.com>)
+Author:: AJ Christensen (<aj@opscode.com>)
+Author:: Seth Chisamore (<schisamo@opscode.com>)
+Author:: Lamont Granquist (<lamont@opscode.com>)
+
+Copyright 2009-2011, Opscode, Inc.
+
+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.