5facc95 Merge pull request #42 from tuupola/no-dev-master b52d2cb Do not courage installing dev-master 0b88830 Merge branch 'release/1.3.0' ce4a39b Changelog 1.3.0 22ff83e Merge pull request #38 from influxdata/feature/travis 0448a6d Fixed order contributors 1934531 Travis container-infra and php 7 42ba3a0 Merge pull request #37 from influxdata/feature/fix-testsuite 18f1c3a Fixed wrong orderby tests 9dc71c0 Merge pull request #35 from skazi0/order-by f20ec57 Merge pull request #36 from skazi0/reserved-dbnames-fix 2232e47 Updated dependencies, added testscript 110ae56 added explicit testing of reserved keywords quoting fa4b7e7 added test a8cffeb - fixed tests - added more name quoting 223dc0f Update README.md 8375b67 added orderBy to query builder 07ce381 added quoting of dbname in queries a2d6301 Fixed issue with listUsers, added getColumns and added unit tests 430d3e2 Fixed issue with intval function on 32bit php ac12b98 Updated travis/codeclimate links after org rename to influxdata 5b2b53f Added support for 32 bit systems and added setters/getters for Point fields 5da903f Bumped version to 1.1.3; added support for symfony 3 9109fa2 Merge pull request #32 from sc0rp10/master 2fc58a6 change symfony/event-dispatcher version to 2.*|3.* b1201e9 Merge pull request #27 from mermetbt/master 351c1a1 Leave booleans lowercase. 44b1fbc Merge pull request #26 from andig/fix-24 20bd2e7 Fix check timestamp format and add unit tests. 5ddab42 The Guzzle driver now throw an exception when the response has an invalid return code. 7c0f681 Fix multi-point encoding on windows 82b7540 Merge pull request #20 from iGusev/patch-2 2f83ba0 Improved test coverage cb45f82 Modified readme for 1.1.2 99cf644 Merge pull request #23 from influxdb/ISSUE-21 b0ee796 ISSUE-21 - Fixed issue with authentication not working for write operations a0d4215 Added groupBy method to QueryBuilder b3cfd74 Added support for 0.9.4; added getlastQuery; added database if not exists support 22fda13 Merge pull request #19 from iGusev/patch-1 e96bb6d Code formatting 03b4cea Merge pull request #18 from cnelissen/escape-invalid-characters 6bb8e25 Merge pull request #17 from cnelissen/write-falsey-values dddf3c7 Escape invalid characters 7e23035 Allow falsey value 29b13ed Changed version from 1.0.2 to 1.1.0 87e284c Updated changelog df5d181 Added support for 0.9.3rc2 4f3f99c Merge pull request #16 from erwinw/patch-1 b1eb0b2 Update README.md git-subtree-dir: lib/influxdb-php git-subtree-split: 5facc95ef61ae66b365e878f69a9e8185693da89
4.5 KiB
Introduction
LibreNMS is an autodiscovering PHP/MySQL/SNMP based network monitoring which includes support for a wide range of network hardware and operating systems including Cisco, Linux, FreeBSD, Juniper, Brocade, Foundry, HP and many more. LibreNMS is a community-based fork of Observium.
We intend LibreNMS to be a viable project and community that:
- encourages contribution,
- focuses on the needs of its users, and
- offers a welcoming, friendly environment for everyone.
The Debian Social Contract will be the basis of our priority system, and mutual respect is the basis of our behaviour towards others. For more about the culture we're trying to build, please read the Freenode philosophy, including guidelines for running an IRC channel and being a community catalyst.
Documentation
Documentation can be found in the doc directory or docs.librenms.org, including instructions for installing and contributing.
Participating
You can participate in the project by:
- Talking to us on IRC (##librenms on Freenode) or Twitter.
- Joining the librenms-project mailing list.
- Improving the documentation.
- Cloning the repo and filing bug reports and pull requests on github. See CONTRIBUTING for more details.
VM image
You can try LibreNMS by downloading a VM image. Currently, a Ubuntu-based image is supplied and has been tested with VirtualBox.
Download the VirtualBox / VMWare image and open it then log in with credentials provided. Enter the following command:
./daily.sh
You'll then need to find out the IP of your VM (ifconfig | grep add
) and
create a DNS entry for librenms.example.com
to point to that IP. You can
also edit your /etc/hosts
file with the following line:
$ip librenms.example.com
where $ip
is the IP of your VM.
Add a new user by entering:
./adduser.php <username> <password> 10 <email>
replace , and with a username, password and your email address.
From there, just point your web browser
to http://librenms.example.com/
and login with your new username and password.
License
Copyright (C) 2006-2012 Adam Armstrong adama@memetic.org
Copyright (C) 2013-2016 by individual LibreNMS contributors
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 3 of the License, or (at your option) any later version.
This 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 this program. If not, see http://www.gnu.org/licenses/.
LICENSE.txt contains a copy of the full GPLv3 licensing conditions.
The following additional license conditions apply to LibreNMS (a GPL exception):
As a special exception, you have permission to link or otherwise combine LibreNMS with the included copies of the following third-party software, and distribute modified versions, as long as you follow the requirements of the GNU GPL v3 in regard to all of the remaining software (comprising LibreNMS).
Please see Acknowledgements