mmtrix_rpm 1.0.0.1

data/GUIDELINES_FOR_CONTRIBUTING.md

@@ -0,0 +1,80 @@
+# Guidelines for Contributing Code
+
+At Mmtrix we welcome community code contributions to the Ruby agent, and have
+taken effort to make this process easy for both contributors and our development
+team.
+
+When contributing, keep in mind that the agent runs in a wide variety of Ruby
+language implementations (e.g. 1.8.7, 1.9.x, 2.x.x, jruby, rbx, etc.) as well as
+a wide variety of application environments (e.g. Rails, Sinatra, roll-your-own,
+etc.) See https://docs.mmtrix.com/docs/agents/ruby-agent/getting-started/mmtrix-ruby#compat
+for the current full list.
+
+Because of this, we need to be more defensive in our coding practices than most
+projects. Syntax must be compatible with all supported Ruby implementations
+(e.g. no 1.9 specific hash syntax) and we can't assume the presence of any
+specific libraries, including `ActiveSupport`, `ActiveRecord`, etc.
+
+## Testing
+
+The agent includes a suite of unit and functional tests which should be used to
+verify your changes don't break existing functionality.
+
+Unit tests are stored in the `test/mmtrix` directory.
+
+Functional tests are stored in the `test/multiverse` directory.
+
+### Running Tests
+
+Running the test suite is simple.  Just invoke:
+
+    bundle
+    bundle exec rake
+
+This will run the unit tests in standalone mode, bootstrapping a basic Rails
+3.2 environment for the agent to instrument, then executing the test suite.
+
+These tests are setup to run automatically in
+[Travis CI](https://travis-ci.org/mmtrix/rpm) under several Ruby implementations.
+When you've pushed your changes to GitHub, you can confirm that the Travis
+build passes for your fork.
+
+Additionally, our own CI jobs runs these tests under multiple versions of Rails
+to verify compatibility.
+
+### Writing Tests
+
+For most contributions it is strongly recommended to add additional tests which
+exercise your changes.
+
+This helps us efficiently incorporate your changes into our mainline codebase
+and provides a safeguard that your change won't be broken by future development.
+
+There are some rare cases where code changes do not result in changed
+functionality (e.g. a performance optimization) and new tests are not required.
+In general, including tests with your pull request dramatically increases the
+chances it will be accepted.
+
+### Functional Testing
+
+For cases where the unit test environment is not sufficient for testing a
+change (e.g. instrumentation for a non-Rails framework, not available in the
+unit test environment), we have a functional testing suite called multiverse.
+These tests can be run by invoking:
+
+    bundle
+    bundle exec rake test:multiverse
+
+More details are available in
+[test/multiverse/README.md](https://github.com/mmtrix/rpm/blob/master/test/multiverse/README.md).
+
+### And Finally...
+
+You are welcome to send pull requests to us - however, by doing so you agree
+that you are granting Mmtrix a non-exclusive, non-revokable, no-cost license
+to use the code, algorithms, patents, and ideas in that code in our products if
+we so choose. You also agree the code is provided as-is and you provide no
+warranties as to its fitness or correctness for any purpose.
+
+If you have any feedback on how we can make contributing easier, please get in
+touch at [support.mmtrix.com](http://support.mmtrix.com) and let us know!

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/Guardfile

@@ -0,0 +1,8 @@
+guard :minitest, :test_folders => ['test/mmtrix'], :all_after_pass => false do
+  watch(%r{^lib/(.+)\.rb$})     { |m| "test/#{m[1]}_test.rb" }
+  watch(%r{^test/.+_test\.rb$})
+  watch(%r{^test/rum/.*})       { "test/mmtrix/rack/browser_monitoring_test.rb" }
+  watch('test/test_helper.rb')  { "test/mmtrix" }
+  watch('test/agent_helper.rb') { "test/mmtrix" }
+  watch('lib/mmtrix/agent/configuration/default_source.rb') { "test/mmtrix/agent/configuration/orphan_configuration_test.rb" }
+end

data/LICENSE

@@ -0,0 +1,151 @@
+This product includes jquery written by John Resig
+and distributed under an MIT license.
+See https://github.com/jquery/jquery/blob/master/MIT-LICENSE.txt
+
+    Copyright (c) 2011 John Resig, http://jquery.com/
+
+    Permission is hereby granted, free of charge, to any person obtaining
+    a copy of this software and associated documentation files (the
+    "Software"), to deal in the Software without restriction, including
+    without limitation the rights to use, copy, modify, merge, publish,
+    distribute, sublicense, and/or sell copies of the Software, and to
+    permit persons to whom the Software is furnished to do so, subject to
+    the following conditions:
+
+    The above copyright notice and this permission notice shall be
+    included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+    LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+    OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+    WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+It includes source derived from 'okjson' by Keith Rarick, distributed under the
+MIT license.
+See https://github.com/kr/okjson/blob/bdd1113/okjson.rb#L3-21
+
+    Copyright 2011, 2012 Keith Rarick
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in
+    all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+    THE SOFTWARE.
+
+It includes source derived from 'system_timer' by David Vollbracht & Philippe
+Hanrigou, distributed under Ruby's license terms.
+
+Copyright:  (C) 2008 David Vollbracht & Philippe Hanrigou
+
+Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.co.jp>.
+You can redistribute it and/or modify it under either the terms of the GPL
+(see COPYING.txt file), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+modifications to Usenet or an equivalent medium, or by allowing
+the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+together with instructions (in the manual page or equivalent)
+on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial). But some files in the distribution
+     are not written by the author, so that they are not under this terms.
+
+     They are gc.c(partly), utils.c(partly), regex.[ch], st.[ch] and some
+     files under the ./missing directory. See each file for the copying
+     condition.
+
+  5. The scripts and library files supplied as input to or produced as
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them,
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.
+
+
+All other components of this product are
+Copyright (c) 2008-2014 Mmtrix, Inc.  All rights reserved.
+
+Certain inventions disclosed in this file may be claimed within
+patents owned or patent applications filed by Mmtrix, Inc. or third
+parties.
+
+Subject to the terms of this notice, Mmtrix grants you a
+nonexclusive, nontransferable license, without the right to
+sublicense, to (a) install and execute one copy of these files on any
+number of workstations owned or controlled by you and (b) distribute
+verbatim copies of these files to third parties.  As a condition to the
+foregoing grant, you must provide this notice along with each copy you
+distribute and you must not remove, alter, or obscure this notice. All
+other use, reproduction, modification, distribution, or other
+exploitation of these files is strictly prohibited, except as may be set
+forth in a separate written license agreement between you and New
+Mmtrix.  The terms of any such license agreement will control over this
+notice.  The license stated above will be automatically terminated and
+revoked if you exceed its scope or violate any of the terms of this
+notice.
+
+This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of Mmtrix, except as
+required for reasonable and customary use in describing the origin of
+this file and reproducing the content of this notice.  You may not
+mark or brand this file with any trade name, trademarks, service
+marks, or product names other than the original brand (if any)
+provided by Mmtrix.
+
+Unless otherwise expressly agreed by Mmtrix in a separate written
+license agreement, these files are provided AS IS, WITHOUT WARRANTY OF
+ANY KIND, including without any implied warranties of MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, TITLE, or NON-INFRINGEMENT.  As a
+condition to your use of these files, you are solely responsible for
+such use. Mmtrix will have no liability to you for direct,
+indirect, consequential, incidental, special, or punitive damages or
+for lost profits or data.

data/README.md

@@ -0,0 +1,202 @@
+# Mmtrix Ruby Agent
+
+Mmtrix is a performance management system, developed by
+Mmtrix, Inc (http://www.mmtrix.com).  It provides you with deep
+information about the performance of your Rails or Ruby
+application as it runs in production. The Mmtrix Ruby Agent is
+dual-purposed as a either a Gem or a Rails plugin, hosted on
+[github](http://github.com/mmtrix/rpm/tree/master).
+
+The Mmtrix Ruby Agent runs in one of two modes:
+
+**Production Mode**
+Low overhead instrumentation that captures detailed information on
+your application running in production and transmits them to
+mmtrix.com where you can monitor them in real time.
+
+**Developer Mode**
+A Rack middleware that maps `/mmtrix` to an application for showing
+detailed performance metrics on a page by page basis.  Installed
+automatically in Rails applications.
+
+## Supported Environments
+
+* Ruby 1.8.7, REE, 1.9.x, 2.0.x, 2.1.x, 2.2.x
+* JRuby 1.6 and 1.7
+* Rubinius 2.x (Experimental support only)
+* Rails 2.1 or later for Production Mode
+* Rails 2.3 or later for Developer Mode
+* Sinatra
+* Rack
+
+An up to date list of Ruby versions and frameworks for the latest agent
+can be found on [our docs site](http://docs.mmtrix.com/docs/ruby/supported-frameworks).
+
+Any Rack based framework should work but may not be tested.  Install
+the Ruby Agent as a gem and add the Developer Mode middleware if
+desired.  Report any problems by visiting support.mmtrix.com.
+
+You can also monitor non-web applications. Refer to the "Other
+Environments" section under "Getting Started".
+
+## Contributing Code
+
+We welcome code contributions (in the form of pull requests) from our user
+community.  Before submitting a pull request please review
+[GUIDELINES_FOR_CONTRIBUTING](https://github.com/mmtrix/rpm/blob/master/GUIDELINES_FOR_CONTRIBUTING.md).
+
+Following these helps us efficiently review and incorporate your contribution
+and avoid breaking your code with future changes to the agent.
+
+
+## Getting Started
+
+Add the Ruby Agent to your project's Gemfile.
+
+    gem 'mmtrix_rpm'
+
+To monitor your applications in production, create an account at
+http://mmtrix.com/ .  There you can
+sign up for a free Lite account or one of our paid subscriptions.
+
+Once you receive the welcome e-mail with a license key and
+`mmtrix.yml` file. You can copy the `mmtrix.yml` file into your app config
+directory OR can generate the file manually with command:
+
+    mmtrix install --license_key="YOUR_KEY" "My application"
+
+The initial configuration is done in the `mmtrix.yml` file.  This file
+is by default read from the `config` directory of the application root
+and is subsequently searched for in the application root directory,
+and then in a `~/.mmtrix` directory.  Once you're up and running you can
+enable Server Side Config and manage your mmtrix configuration from the web
+UI.
+
+#### Rails Installation
+
+You can install the agent as a Gem:
+
+For Bundler:
+
+Add the following line to your Gemfile:
+
+    gem 'mmtrix_rpm'
+
+For Rails 2.x without Bundler:
+
+edit `environment.rb` and add to the initalizer block:
+
+    config.gem "mmtrix_rpm"
+
+#### Sinatra Installation
+
+To use the Ruby Agent with a Sinatra app, add
+
+    require 'mmtrix_rpm'
+
+in your Sinatra app, below the Sinatra require directive.
+
+Then make sure you set `RACK_ENV` to the environment corresponding to the
+configuration definitions in the mmtrix.yml file; e.g., development,
+staging, production, etc.
+
+To use Developer Mode in Sinatra, add `Mmtrix::Rack::DeveloperMode` to
+the middleware stack.  See the `config.ru` sample below.
+
+#### Other Environments
+
+You can use the Ruby Agent to monitor any Ruby application.  Add
+
+    require 'mmtrix_rpm'
+
+to your startup sequence and then manually start the agent using
+
+    Mmtrix::Agent.manual_start
+
+For information about instrumenting pure Rack applications, see our
+[Rack middlewares documentation](http://docs.mmtrix.com/docs/ruby/rack-middlewares).
+
+Refer to the [Mmtrix's Docs](http://mmtrix.com/docs) for details on how to
+monitor other web frameworks, background jobs, and daemons.
+
+The Ruby Agent provides an API that allows custom instrumentation of additional
+frameworks.  You can find a list of community created intrumentation plugins
+(e.g. [mmtrix-redis](https://github.com/evanphx/mmtrix-redis)) in the
+[extends_mmtrix_rpm project](https://github.com/mmtrix/extends_mmtrix_rpm).
+
+## Developer Mode
+
+When running the Developer Mode, the Ruby Agent will track the
+performance of every HTTP request serviced by your application, and
+store in memory this information for the last 100 HTTP transactions.
+
+To view this performance information, including detailed SQL statement
+analysis, open `/mmtrix` in your web application.  For instance if
+you are running mongrel or thin on port 3000, enter the following into
+your browser:
+
+    http://localhost:3000/mmtrix
+
+Developer Mode is only initialized if the `developer_mode` setting in
+the mmtrix.yml file is set to true.  By default, it is turned off in
+all environments but `development`.
+
+#### Developer Mode in Rails
+
+Developer Mode is available automatically in Rails Applications based
+on Rails 2.3 and later.  No additional configuration is required. When
+your application starts and `developer_mode` is enabled, the Ruby
+Agent injects a middleware into your Rails middleware stack.
+
+For earlier versions of Rails that support Rack, you can use
+a `config.ru` as below.
+
+#### Developer Mode in Rack Applications
+
+Developer Mode is available for any Rack based application such as
+Sinatra by installing the Mmtrix::Rack::DeveloperMode
+middleware. This middleware passes all requests that do not start with
+/mmtrix.
+
+Here's an example entry for Developer Mode in a `config.ru` file:
+
+    require 'mmtrix/rack/developer_mode'
+    use Mmtrix::Rack::DeveloperMode
+
+## Production Mode
+
+When your application runs in the production environment, the New
+Mmtrix agent runs in production mode. It connects to the Mmtrix
+service and sends deep performance data to the UI for your
+analysis. To view this data, log in to http://rpm.mmtrix.com.
+
+NOTE: You must have a valid account and license key to view this data
+online.  Refer to instructions in *Getting Started*.
+
+## Recording Deploys
+
+The Ruby Agent supports recording deployments in Mmtrix via a command line
+tool or Capistrano recipes. For more information on these features see
+[our deployment documentation](http://docs.mmtrix.com/docs/ruby/recording-deployments-with-the-ruby-agent)
+for more information.
+
+## Support
+
+You can find more detailed documentation [on our website](http://mmtrix.com/docs),
+and specifically in the [Ruby category](http://mmtrix.com/docs/ruby).
+
+If you can't find what you're looking for there, reach out to us on our [support
+site](http://support.mmtrix.com/) or our [community forum](http://forum.mmtrix.com)
+and we'll be happy to help you.
+
+Also available is community support on IRC: we generally use #mmtrix
+on irc.freenode.net
+
+Find a bug? Contact us via [support.mmtrix.com](http://support.mmtrix.com/),
+or e-mail support @ mmtrix.com.
+
+Thank you, and may your application scale to infinity plus one.
+
+Lew Cirne, Founder and CEO
+
+Mmtrix, Inc.

data/Rakefile

@@ -0,0 +1,154 @@
+require 'rubygems'
+require 'rake/testtask'
+require 'yard'
+require "#{File.dirname(__FILE__)}/lib/tasks/all.rb"
+
+YARD::Rake::YardocTask.new
+
+task :default => :test
+task :test => ['test:mmtrix']
+
+namespace :test do
+  desc "Run all tests"
+  task :all => %w{mmtrix multiverse}
+
+  begin
+    require 'test_bisect'
+    TestBisect::BisectTask.new do |t|
+      t.test_task_name = 'test:mmtrix'
+    end
+  rescue LoadError
+  end
+
+  agent_home = File.expand_path(File.dirname(__FILE__))
+
+  # Agent-specific setup to enforce getting our proper suites directory
+  task :multiverse_setup do
+    ENV["SUITES_DIRECTORY"] = File.expand_path(File.join(File.dirname(__FILE__), 'test', 'multiverse', 'suites'))
+  end
+
+  task :multiverse => :multiverse_setup
+
+  desc "Test the multiverse testing framework by executing tests in test/multiverse/test. Get meta with it."
+  task 'multiverse:self', [:suite, :mode] => [] do |t, args|
+    args.with_defaults(:suite => "", :mode => "")
+    puts ("Testing the multiverse testing framework...")
+    test_files = FileList['test/multiverse/test/*_test.rb']
+    ruby test_files.join(" ")
+  end
+
+  task 'multiverse:prime', [:suite] => [] do |t, args|
+    require File.expand_path(File.join(File.dirname(__FILE__), 'test', 'multiverse', 'lib', 'multiverse', 'environment'))
+    opts = Multiverse::Runner.parse_args(args)
+    Multiverse::Runner.prime(args.suite, opts)
+  end
+
+  desc "Run agent performance tests"
+  task :performance, [:suite, :name] => [] do |t, args|
+    require File.expand_path(File.join(File.dirname(__FILE__), 'test', 'performance', 'lib', 'performance'))
+    options = {}
+    options[:suite] = args[:suite] if args[:suite]
+    options[:name]  = args[:name]  if args[:name]
+    Performance::Runner.new(options).run_and_report
+  end
+
+  desc "Run agent within existing mini environments"
+  task :env, [:env1, :env2, :env3, :env4, :env5, :env6] => [] do |t, args|
+    require File.expand_path(File.join(File.dirname(__FILE__), 'test', 'environments', 'lib', 'environments', 'runner'))
+    Environments::Runner.new(args.map{|_,v| v}).run_and_report
+  end
+
+  Rake::TestTask.new(:intentional_fail) do |t|
+    t.libs << "#{agent_home}/test"
+    t.libs << "#{agent_home}/lib"
+    t.pattern = "#{agent_home}/test/intentional_fail.rb"
+    t.verbose = true
+  end
+
+  # Note unit testing task is defined in lib/tasks/tests.rake to facilitate
+  # running them in a rails application environment.
+
+end
+
+desc 'Record build number and stage'
+task :record_build, [ :build_number, :stage ] do |t, args|
+  build_string = args.build_number
+  build_string << ".#{args.stage}" unless args.stage.nil? || args.stage.empty?
+
+  gitsha = File.exists?(".git") ? `git rev-parse HEAD` : "Unknown"
+  gitsha.chomp!
+
+  File.open("lib/mmtrix/build.rb", "w") do |f|
+    f.write("# GITSHA: #{gitsha}\n")
+    f.write("module Mmtrix; module VERSION; BUILD='#{build_string}'; end; end\n")
+  end
+end
+
+desc 'Update CA bundle'
+task :update_ca_bundle do |t|
+  ca_bundle_path = File.expand_path(File.join(File.dirname(__FILE__), '..', 'SSL_CA_cert_bundle'))
+  if !File.exist?(ca_bundle_path)
+    puts "Could not find SSL_CA_cert_bundle project at #{ca_bundle_path}. Please clone it."
+    exit
+  end
+  if !File.exist?(File.join(ca_bundle_path, '.git'))
+    puts "#{ca_bundle_path} does not appear to be a git repository."
+    exit
+  end
+
+  puts "Updating bundle at #{ca_bundle_path} with git..."
+  result = system("cd #{ca_bundle_path} && git fetch origin && git reset --hard origin/master")
+  if result != true
+    puts "Failed to update git repo at #{ca_bundle_path}."
+    exit
+  end
+
+  bundle_last_update = `cd #{ca_bundle_path} && git show -s --format=%ci HEAD`
+  puts "Source CA bundle last updated #{bundle_last_update}"
+
+  bundle_path = "cert/cacert.pem"
+  cert_paths = []
+  Dir.glob("#{ca_bundle_path}/*.pem").each { |p| cert_paths << p }
+  cert_paths.sort!
+
+  puts "Writing #{cert_paths.size} certs to bundle at #{bundle_path}..."
+
+  File.open(bundle_path, "w") do |f|
+    cert_paths.each do |cert_path|
+      cert_name = File.basename(cert_path, '.pem')
+      puts "Adding #{cert_name}"
+      f.write("#{cert_name}\n")
+      f.write(File.read(cert_path))
+      f.write("\n\n")
+    end
+  end
+  puts "Done, please commit your changes to #{bundle_path}"
+end
+
+namespace :cross_agent_tests do
+  cross_agent_tests_upstream_path = File.expand_path(File.join(File.dirname(__FILE__), '..', 'cross_agent_tests'))
+  cross_agent_tests_local_path    = File.expand_path(File.join(File.dirname(__FILE__), 'test', 'fixtures', 'cross_agent_tests'))
+
+  desc 'Pull latest changes from cross_agent_tests repo'
+  task :pull do
+    puts "Updating embedded cross_agent_tests from #{cross_agent_tests_upstream_path}..."
+    cmd = "rsync -avu --exclude .git #{cross_agent_tests_upstream_path}/ #{cross_agent_tests_local_path}/"
+    puts cmd
+    system(cmd)
+  end
+
+  desc 'Copy changes from embedded cross_agent_tests to official repo working copy'
+  task :push do
+    puts "Copying changes from embedded cross_agent_tests to #{cross_agent_tests_upstream_path}..."
+    cmd = "rsync -avu #{cross_agent_tests_local_path}/ #{cross_agent_tests_upstream_path}/"
+    puts cmd
+    system(cmd)
+  end
+end
+
+task :console do
+  require 'pry'
+  require 'mmtrix_rpm'
+  ARGV.clear
+  Pry.start
+end

data/bin/mmtrix

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# executes one of the commands in the mmtrix/commands directory
+# pass the name of the command as an argument
+
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), '..','lib'))
+require 'mmtrix/cli/command'
+begin
+  Mmtrix::Cli::Command.run
+rescue Mmtrix::Cli::Command::CommandFailure => failure
+  STDERR.puts failure.message
+  STDERR.puts failure.options if failure.options
+  exit 1
+end

data/bin/mmtrix_cmd

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# This command has been renamed "mmtrix"
+# executes one of the commands in the mmtrix/commands directory
+# pass the name of the command as an argument
+load File.dirname(__FILE__) + '/mmtrix'

data/bin/mongrel_rpm

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'rack'
+require 'rack/handler/mongrel'
+require 'optparse'
+
+port = 3000
+options = { }
+appname = nil
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{File.basename($0)} [options] [app_name]"
+  opts.on("-p", "--port=port", Integer, "default: #{port}") { | port | }
+  opts.on("--[no-]logging", "turn off request logging" ) { | l | options[:logging] = l }
+  opts.on("--license=license_key", "override license key" ) { | l | options[:license_key] = l }
+  opts.on("--install", "install a mmtrix.yml template" ) { | l | options[:install] = true }
+  opts.separator ""
+  opts.separator "app_name is the name of the application where the metrics will be stored"
+  opts.separator ""
+  # The rackup file references this var
+  appname = opts.parse!(ARGV.clone).first
+end
+
+options[:app_name] = appname if appname
+
+ru_file = File.expand_path(File.join(File.dirname(__FILE__), "..", "lib", "mmtrix", "rack", "mongrel_rpm.ru"))
+rackup_code = File.read ru_file
+builder = Rack::Builder.new { eval rackup_code, binding, ru_file }
+
+options = { :Host => '127.0.0.1', :Port => port }
+Rack::Handler::Mongrel.run(builder.to_app, options) do | server |
+  Mmtrix::Agent.logger.info "Started Mongrel listening for '#{Mmtrix::Control.instance.app_names.join(" and ")}' data at #{server.host}:#{server.port}" 
+end
+