BGPmon-Analytics-db version 1.01 ================================ The BGPmon Analytics Database module includes the source and scripts necessary to set up a BGP-tracking database in Postgres and to populate it from BGPmon output. It is a set of scripts, not a module to be imported into other packages. INSTALLATION This package depends on being able to connect to a postgres installation. The following instructions will help prepare that installation, installation procedures may vary across platforms. 1. Install Postgresql 2. Create the database user bgpuser (sudo -u postgres createuser bgpuser) 3. Create the database bgpdata (sudo -u postgres createdb bgpdata) 4. Give a user other than root or postgres access to the database (should include web user): Edit /etc/postgresql/8.1/main/pg_hba.conf to give specific users access Refer to postres documentation for assitance editing the pg_hba.conf file 5. Restart postgres 6. Initialize the bgpdata database (bin/reset.pl --dbname=bgpdata --dblogin=bgpuser) DEPENDENCIES This module requires these other modules and libraries: PostgreSQL 8.4 or higher, with PL/pg SQL installed BGPmon::Fetch BGPmon::Configure BGPmon::Translator::XFB2PerlHash::Simple BGPmon::Log Data::Dumper POSIX COPYRIGHT AND LICENCE Copyright (c) 2012 Colorado State University 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. Authors: Jason Bartlett Date: 15 August 2012