From 8a5518342cf0acb9d49f85b6716549f879885d1d Mon Sep 17 00:00:00 2001 From: Steve Kemp Date: Fri, 22 Apr 2016 19:15:21 +0300 Subject: Renamed page. --- README | 82 --------------------------------------------------------------- README.md | 82 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 82 insertions(+), 82 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index 3d8e67e..0000000 --- a/README +++ /dev/null @@ -1,82 +0,0 @@ - -Source: - https://gitlab.bytemark.co.uk/open-source/custodian - -Github Mirror: - https://github.com/BytemarkHosting/custodian - - -Copyright: - Copyright (c) 2012-2016 Bytemark Computer Consulting Ltd - -Bug Tracker: - https://github.com/BytemarkHosting/custodian/issues - https://gitlab.bytemark.co.uk/open-source/custodian/issues - -Licence: - This program is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published by - the Free Software Foundation; either version 2 of the License, or - (at your option) any later version. - - - - -About Custodian ---------------- - -Custodian is a simple, scalable, and reliable protocol-tester that allows -a number of services to be tested across a network. - -The core design is based upon a work queue, which is manipulated by two -main tools: - - custodian-enqueue - * A parser that reads a list of hosts and tests to apply. These - tests are broken down into individual jobs, serialized and stored - in a central queue. - - custodian-dequeue - * A tool that pulls jobs from the queue, executing them in turn, and - raises/clears alerts based upon the result of the test. - - -Custodian uses class-factories to ensure that protocol tests, and notification -objects, are only loosely tied to the core. This is done so that custodian -may be extended or adapted more easily to your environment. - - - -Configuration -------------- - -The software is configured by the main configuration file located at: - - /etc/custodian/custodian.cfg - -This file contains the alerting mechanism to use, the IP:port of the queue -the two scripts mentioned above use, and similar static things. - -Each of the available configuration options has a sensible default which -is documented in that same file. - - - -Dependencies ------------- - -The software is written in Ruby and has successfully been deployed in -production under: - -* Ruby 1.8 -* Ruby 1.9.x -* Ruby 2.1.x - -The software has not yet been tested upon JRuby, or similar. - -Dependencies, beyond ruby, are limited to the following gems: - -* For HTTP/HTTPS testing: curb -* For communication with the queue: redis - - diff --git a/README.md b/README.md new file mode 100644 index 0000000..3d8e67e --- /dev/null +++ b/README.md @@ -0,0 +1,82 @@ + +Source: + https://gitlab.bytemark.co.uk/open-source/custodian + +Github Mirror: + https://github.com/BytemarkHosting/custodian + + +Copyright: + Copyright (c) 2012-2016 Bytemark Computer Consulting Ltd + +Bug Tracker: + https://github.com/BytemarkHosting/custodian/issues + https://gitlab.bytemark.co.uk/open-source/custodian/issues + +Licence: + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + + + +About Custodian +--------------- + +Custodian is a simple, scalable, and reliable protocol-tester that allows +a number of services to be tested across a network. + +The core design is based upon a work queue, which is manipulated by two +main tools: + + custodian-enqueue + * A parser that reads a list of hosts and tests to apply. These + tests are broken down into individual jobs, serialized and stored + in a central queue. + + custodian-dequeue + * A tool that pulls jobs from the queue, executing them in turn, and + raises/clears alerts based upon the result of the test. + + +Custodian uses class-factories to ensure that protocol tests, and notification +objects, are only loosely tied to the core. This is done so that custodian +may be extended or adapted more easily to your environment. + + + +Configuration +------------- + +The software is configured by the main configuration file located at: + + /etc/custodian/custodian.cfg + +This file contains the alerting mechanism to use, the IP:port of the queue +the two scripts mentioned above use, and similar static things. + +Each of the available configuration options has a sensible default which +is documented in that same file. + + + +Dependencies +------------ + +The software is written in Ruby and has successfully been deployed in +production under: + +* Ruby 1.8 +* Ruby 1.9.x +* Ruby 2.1.x + +The software has not yet been tested upon JRuby, or similar. + +Dependencies, beyond ruby, are limited to the following gems: + +* For HTTP/HTTPS testing: curb +* For communication with the queue: redis + + -- cgit v1.2.1