| 1 |
================================================== |
|---|
| 2 |
|
|---|
| 3 |
NetHorus: an Open Source Network Management System |
|---|
| 4 |
|
|---|
| 5 |
================================================== |
|---|
| 6 |
|
|---|
| 7 |
|
|---|
| 8 |
Requirements |
|---|
| 9 |
------------ |
|---|
| 10 |
|
|---|
| 11 |
To use NetHorus fully, you will need: |
|---|
| 12 |
|
|---|
| 13 |
* A working Rails 2.1 installation |
|---|
| 14 |
* A database supported by Rails |
|---|
| 15 |
* A network of SNMP-manageable devices |
|---|
| 16 |
|
|---|
| 17 |
|
|---|
| 18 |
Installation |
|---|
| 19 |
------------ |
|---|
| 20 |
|
|---|
| 21 |
If you're updating an existing codebase from Subversion, please see |
|---|
| 22 |
'Updating' at the end of this document. |
|---|
| 23 |
|
|---|
| 24 |
To install NetHorus, download the latest source code from Subversion: |
|---|
| 25 |
|
|---|
| 26 |
svn co http://svn.nethorus.org/svn/nethorus/ |
|---|
| 27 |
|
|---|
| 28 |
Copy the file config/database.example to config/database.yml and edit |
|---|
| 29 |
database.yml, changing the adapter, username and password as appropriate. |
|---|
| 30 |
You can change the database names too if you want, but keep the stanzas |
|---|
| 31 |
named as 'development', 'test' and 'live'. |
|---|
| 32 |
|
|---|
| 33 |
An example stanza is: |
|---|
| 34 |
|
|---|
| 35 |
development: |
|---|
| 36 |
adapter: mysql |
|---|
| 37 |
encoding: utf8 |
|---|
| 38 |
database: nethorus_development |
|---|
| 39 |
username: nethorus |
|---|
| 40 |
password: GF4i3pXlooTGeoci |
|---|
| 41 |
socket: /var/run/mysqld/mysqld.sock |
|---|
| 42 |
|
|---|
| 43 |
Next, create the database with rake: |
|---|
| 44 |
|
|---|
| 45 |
rake db:create |
|---|
| 46 |
|
|---|
| 47 |
Then, create the tables: |
|---|
| 48 |
|
|---|
| 49 |
rake db:schema:load |
|---|
| 50 |
|
|---|
| 51 |
Now, start the Mongrel web server: |
|---|
| 52 |
|
|---|
| 53 |
mongrel_rails start |
|---|
| 54 |
|
|---|
| 55 |
Finally, start the SNMP proxy: |
|---|
| 56 |
|
|---|
| 57 |
external/snmp_proxy.pl |
|---|
| 58 |
|
|---|
| 59 |
You are now running NetHorus. |
|---|
| 60 |
|
|---|
| 61 |
|
|---|
| 62 |
Updating |
|---|
| 63 |
-------- |
|---|
| 64 |
|
|---|
| 65 |
To update a Subversion copy of NetHorus, run the following command in the |
|---|
| 66 |
directory holding your source code: |
|---|
| 67 |
|
|---|
| 68 |
svn update |
|---|
| 69 |
|
|---|
| 70 |
Make sure you keep your database schema up-to-date by running any migrations |
|---|
| 71 |
as necessary: |
|---|
| 72 |
|
|---|
| 73 |
rake db:migrate |
|---|
| 74 |
|
|---|
| 75 |
That's it! |
|---|
