easydocsis Files

Copyright 2015 OSS-IRIS

This file is part of Easydocsis.
Easydocsis 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 3 of the License, or
(at your option) any later version.

Easydocsis program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Easydocsis.  If not, see <http://www.gnu.org/licenses/>.

ABOUT EASYDOCSIS:

EASYDOCSIS is a complete solution to manage CMTS and cable modems.


REQUIREMENTS:

EASYDOCSIS should be able to run on any Unix-based operating system with
the following requirements:

PHP 5.1+
MySQL 5.0+
NET-SNMP 5.2+
RRDtool 1.4.7+
Web Server that supports PHP
SNMP PHP libs
MySQL PHP libs

but it should work with older versions.
Check directly with "php page_checkhost.php"

CMTS SNMP ACCESS is also necessary for easydocsis to retrieve data (check SNMP access-list, firewall and routing)


INSTALLATION PROCEDURE:

0/ Start mysql database and apache server

1/ Copy files locally to your web server
        example for this install: /var/www/easydocsis/
        cd /var/www/easydocsis/
        tar xzvf "your tar gz file"

2/ Validate access to php pages for system users (apache user/crontab/owner user)
        chmod -R 777 /var/www/easydocsis/* (for easy setup)

3/ Run sql database creation command:
        mysql < /var/www/easydocsis/easydocsis.sql

4/ Modify configuration of the application where/if necessary (SNMP/Mysql/... configuration):
        Edit
        /var/www/easydocsis/easydocsis.config.inc.php

5/ Access to the application and start configuration/management using http access:
        user=admin
        password=oss-iris

6/ Configure CMTS IP/name in CMTS ADMINISTRATION ACCESS menu

7/ Check that data-collections run correctly (control duration for next step):
/var/www/easydocsis/data-collection_cmts_min_standalone.php
/var/www/easydocsis/data-collection_cmts_hour_standalone.php

8/ If OK, specify a crontab for those data-collection processes (for example 5 min and 1 hour depending number of CM and load of your CMTS):
# generation of rrdgraph and data-collection of CMTS interfaces essential data
*/5 * * * * /var/www/easydocsis/data-collection_cmts_min_standalone.php
# data-collection of CM essential data
0 * * * * /var/www/easydocsis/data-collection_cmts_hour_standalone.php

9/ Application is ready you can check results in the web interface