Installation Instructions1. Ruby gemsThe majority of Ruby monitors in tools/monitors require the following gems: gem install needle-1.3.0.gem
gem install net-scp-1.0.1.gem
gem install net-sftp-1.1.1.gem
gem install net-ssh-2.0.3.gem
gem install mysql-2.7.3-mswin32.gemNote: for Win32 users of the mysql gem ... For this to work, you must have libmysql.dll in your PATH environmental variable. If you have MySQL installed locally, just make sure that \bin is in your path. If you donĂt have MySQL installed locally, you can install one or more of the MySQL tools, find the libmysql.dll included in their bin directory, and copy it to the %SystemRoot%\System32 folder. Note: for OSX 10.5 users you should install the mysql gem using the following command: sudo env ARCHFLAGS="-arch i386" gem install mysql
-- --with-mysql-config=/usr/local/mysql/bin/mysql_configNote: The gems used for development are also available locally in tools/gems 2. JRuby gemsA number of JRuby monitors (using JMX) require the installation of JRuby and the following gems: <jruby_install_dir>\bin\gem install jmx4r-0.0.5.gem 3. Config SettingsYou will need to modify the config settings in config/config.php for your database configuration. Ruby monitors also have a similar configuration requirement for each script. You will need to modify dbname, dbhost, dbusername and dbpassword settings for each. 4. Ruby monitorsThese are launched in windows using scheduled tasks. I typically run this under a local user with administrative priveleges. 5. Data AnalysisTo automatically create y shading 'bands' in your dataset, use the analyze_data.rb script in tools/analysis. With this you can set how many days to base the percentiles on (typically last 30 days).
|
On Mac OSX You should install your gems using sudo. I found I didn't need to install ssh as the sftp gem had it as a pre-requisite. Additionally some of the versions listed in the document are out of date, so it's best to just install the gem by name.