150 Commits

Author SHA1 Message Date
3155b56501 Updated virtual images doc to use latest URL 2018-12-30 21:38:41 +00:00
95d37262d3 No need Third Party doc for now (#9538) 2018-12-12 08:43:00 -06:00
27a3555ecc docs: fix images doc (#9527)
There is no capital I in the password...
2018-12-06 11:55:52 -06:00
eadf27cbcc Change group owner for php/session for CentOS 7 nginx install (#9393)
By default on CentOS 7, /var/lib/php/session is root:root.

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
After you are done testing, you can remove the changes with `./scripts/github-remove`.  If there are schema changes, you can ask on discord how to revert.
2018-11-28 21:28:04 +00:00
09b2b5f1a1 Update docs for virtual images (#9456) 2018-11-17 14:19:38 +00:00
ac7997d9ec Added official docker image installation in doc (#9398) 2018-10-29 10:08:54 +00:00
1ee2e8e0e0 Updated to use new theme for docs site (#9320)
* Updated to use new theme for docs site

* Updated theme location

* Removed librenms.css

* Updated index page + re-added librenms.css

* Use built in theme modification

* flexbox grid, dump bootstrap

* tidy up things

* Added path and updated deploy script + mkdocs config

* Removed db schmea changes

* Updated to install python/pip 3

* Removed pip3 install

* Pip3 install

* Updated deploy-docs

* Updated deploy-docs
2018-10-27 23:04:34 +01:00
769f51fb7c Add docs about third-party docker builds created by the community (#9274) 2018-10-03 21:48:31 +01:00
05d6720a01 Add universe repo (#9238)
adjustment to ## Install Required Packages ## section > add-apt-repository universe
2018-09-19 15:49:22 -05:00
720e6289a8 add-apt-repository universe (#9237)
adjustment to ## Install Required Packages ## section > add-apt-repository universe
2018-09-19 15:49:11 -05:00
cc225bd39c Fixed format for snmpd configuration step (#9203) 2018-09-14 08:03:51 -05:00
810baeee3d Add 18.04 install guide and and move 16.04 guide (#9101)
* Add 18.04 install guide and and move 16.04 guide

Adds 18.04 install guides to "Installing LibreNMS" page.
Moves 16.04 install guides to "Old install docs" section.

* Update index.md

Update index tree to 1804 over 1604
2018-08-28 14:23:33 -05:00
de2f3028da Create Installation-Ubuntu-1804-Nginx.md (#8630)
* Create Installation-Ubuntu-1804-Nginx.md

A few tweaks are required to the Ubuntu 16.04 instructions to install on the newly released 18.04 version mostly relating to php being bumped to 7.2 from 7.0 and no mcrypt module for this php version in the distro repository.

* Create Installation-Ubuntu-1804-Apache.md

Used instructions from 1604 Apache as template and updated to work on Bionic (18.04).

* Update Installation-Ubuntu-1804-Nginx.md

Removed instructions for installing mcrypt module as I confirmed it works without it and it was mentioned it was no longer needed.

* Update Installation-Ubuntu-1804-Apache.md

The 1604 directions had a mixture of vi and vim for editing files. Since this is ubuntu and we want the instructions to be as easy as possible, I updated editor to be nano. I have no personal preference and can make it whatever we prefer, just figured it should be consistent between the two guides.

* Update mkdocs.yml

Added Ubuntu 18.04 instruction pages

* Update Installation-Ubuntu-1804-Apache.md

Corrected to libapache2-mod-php7.2 from libapache2-mod-php7.0

* Updated Ubuntu install docs

* Added missing mbstring + curl packages
2018-08-28 10:30:37 -05:00
a2e33efba8 Use PDO for MySQL queries (#8935)
Gut dbFacile
mres() now does nothing... could have some vulnerable queries, but most are ok

TODO
- [x] IRC client broke
- [x] Install broke

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
2018-08-17 21:29:20 +01:00
70857e556d Updated installation instructions (#8733)
* Updated CentOS (Apache) installation instructions

Added a few steps I think might be useful to first time Libre users.

* Update Installation-CentOS-7-Apache.md

* Added proposed changes from the comments sections

* Update Installation-CentOS-7-Nginx.md

* Update Installation-Ubuntu-1604-Apache.md

* Update Installation-Ubuntu-1604-Nginx.md
2018-05-17 11:30:03 -05:00
182185d433 Update to add acl on list of necessary package (#8639)
* Update to add acl on list of necessary package

Add acl package for the installation of Librenms

* Change sort

add acl to first

* Change file to add acl package
2018-05-11 22:42:04 -05:00
1ad7f3138b Add Laravel to LibreNMS (#8318)
* Add Laravel to LibreNMS.

* Try to set permissions during initial install and first composer update to Laravel.

* Fix composer.lock
Fix missing db config keys

* Start building v1 layout
Port ajax_setresolution, inject csrf into jquery ajax calls
Layout works, building menu
Partially done.

* Fix device group list
remove stupid count relationships

* Print messages for common boot errors.
Don't log to laravel.log file.
Log to error_log until booted, then librenms.log

* Fix up some issues with Config loading
Start of custom directives

* Custom blade directives: config, notconfig, admin

* Preflight checks
Only load config files once.

* Update the composer.lock for php 5.6

* Menu through routing

* Start of alert menu

* Better alert scopes

* reduce cruft in models

* Alerting menu more or less working :D

* Fix style

* Improved preflight

* Fix chicken-eggs!

* Remove examples

* Better alert_rule status queries
Debugbar

* fix app.env check

* User Menu

* Settings bar (dropped refresh)
Search JS

* Toastr messages

* Rename preflight

* Use hasAccess(User) on most models.
Add port counts

* Missed a Preflight -> Checks rename

* Fix some formatting

* Boot Eloquent outside of Laravel
Use Eloquent for Config and Plugins so we don't have to connect with dbFacile inside Laravel.
Move locate_binary() into Config class

* Config WIP

* Try to fix a lot of config loading issues.

* Improve menu for non-admins removing unneeded menus
url() for all in menu

* Only use eloquent if it exists

* Include APP_URL in initial .env settings

* Implement Legacy User Provider

* Helper class for using Eloquent outside of Laravel.
Allows access to DB style queries too and checking the connection status.

* Fix up tests

* Fix device groups query

* Checking Travis

* copy config.test.php earlier

* dbFacile check config before connecting
Don't use exception to check if eloquent is connected, it gets grabbed by the exception handler.
Ignore missing config.php error.

* Fix config load with database is not migrated yet.

* Remove Config::load() from early boot.

* Use laravel config settings to init db (this prefers .env settings)
Fix bgp vars not set in menu
add _ide_helper.php to .gitignore

* Restrict dependencies to versions that support php 5.6

* Update ConfigTest

* Fix a couple of installation issues

* Add unique NODE_ID to .env

* Correct handling of title image

* Fix database config not loading. Thanks @laf

* Don't prepend /

* add class_exists checks for development service providers

* Fix config value casting

* Don't use functions that may not exist

* Update dbFacile.php

* d_echo may not be defined when Config used called.

* Add SELinux configuration steps
More detailed permissions check.
Check all and give complete corrective commands in one step.

* Ignore node_modules directory

* Re-add accidetal removal
2018-05-09 08:05:17 -05:00
b3d190ec52 docs: Updated CentOS 7 install docs to use php72w-mysqlnd (#8618) 2018-04-25 19:04:37 -05:00
98e3014d31 Remove mcrypt, it doesn't exist in php 7.2 (#8352) 2018-03-09 22:14:37 -06:00
72dffd8d95 docs: Update Installation-CentOS-7-Apache.md (#8349)
php72w-mcrypt is not used anymore
2018-03-09 17:52:26 +01:00
496575ea99 docs: Add composer back to the CentOS install docs (#8224)
* Add composer back to the centos install docs
This is for CentOS 7, not CentOS 6...

* In tree composer requires php 7.2

* Rename socket file to match

* Clean up the initial config.php a bit
Add clearer releasing info in that config.php
Update the manual update instructions
2018-02-08 21:46:55 +00:00
9b9fb121ab Remove dependencies from the repository, update install docs (#6920)
After vendor is un-indexed restore the contents so things keep working.
2018-02-06 08:17:44 -06:00
cc4633c7d1 docs: Added info on fping / http for SELinux (#7778)
* docs: new SELinux docs

I am not feeling the best about this doc's location/integration.

What do we think about splitting apart the install docs?  We could share some docs between the different docs...
Also would show up on the left toc and have the prev/next buttons.  I just don't want too many sections.

* move docs into install
2017-11-29 20:56:39 +00:00
199d160fe0 docs: VM image install doc minor spelling fix (#7801)
* docs: VM image install doc minor spelling fix

* Update CentOS-image.md
2017-11-26 17:22:28 -06:00
e205c93c07 remove extra backtick (#7770) 2017-11-19 20:53:25 -06:00
3bd9920e38 docs: Continue to reorganize docs (#7762)
* docs: Continue to reorganize things
Make landing pages for /Installation, /API, etc.
Split API out into multiple docs
Properly use multi-level navigation
Add lower nav buttons (tops are bug so disable for now)
Add logo for fanciness
Refine index page a bit

* Improve API TOC layout

* Couple of fixes.

* Fix API/API-Docs, assumed it was at the right url.
2017-11-19 01:19:18 +00:00
e4a775a9cd docs: fix for VM images doc. (#7740)
* docs: fix for VM images doc. 

I messed up the backticks :(

* Update CentOS-image.md
2017-11-15 11:28:28 -06:00
e563931a03 docs: VM images recommended user update (#7737)
* docs: VM images recommended user update

Added note for the user to update LibreNMS.
and added Community Forum

* docs: VM image doc

recommend user to update.

* Update CentOS-image.md

requested changes made.

* Update Ubuntu-image.md

requested changes made.
2017-11-15 09:33:19 -06:00
ec2256c350 docs: Install Docs Update for min PHP ver (#7630)
* docs: Install Docs Update

* Some changes..
2017-11-15 08:12:14 +00:00
b79d106c56 fix: Errors with missing posix extension (#7666)
* fix: errors with missing posix extension
It should be an optional dependency

* add php71w-process to the CentOS 7 install docs
2017-11-10 15:20:47 +00:00
51ba934e11 feature: Added web validation (#7474)
* refactor: convert validations to modules to prep for gui integration

* accidentally dropped, schema update

* fix accidental output to webui

* mention discovery-wrapper.py and re-arrange.

* refine some fix statements

* rename the Config validation group to Configuration.

* fix some scrutinizer issues
remove as many local functions from validator.php as possible
move extensions from pre-check
remove duplicate timezone check
looks like there is some db schema differences between mariadb 10.1 and 10.2, investigating

* mariadb version diff take2

* Check schema version first for database.
Remove stop to go back to command line for install docs.
Add helpful link when there is no devices added to /addhost

* fix incorrect validation for empty string defaults

* Fix style

* Add additional file permissions checks

* catch exception and fail for invalid timezone
Change visuals a bit.

* add php version warning

* fix space
2017-10-26 07:56:09 +01:00
e3c0714ede docs: Updated references for ##librenms to discord (#7523)
* docs: Updated references for ##librenms to discord

* updated channel -> server

* updated channel -> server
2017-10-20 14:22:18 -05:00
163d0b4f88 fix: Errors in the documentations for CentOS 7 (#7510)
* fix: Erros in the documentations for CentOS 7

* fix: Erros in the documentations for CentOS 7

* fix: Erros in the documentations for CentOS 7

* fix: Erros in the documentations for CentOS 7

* Some corrections to make docs work as intended.

* re-add httpd_execmem for nginx
2017-10-18 14:38:56 -05:00
b6964ab3d6 docs: Re-organize install docs (#7424)
Try to group things that go together
prevent repeat actions such as running yum/apt
The only reason to return to command line after install.php is to check validate.php.
(The future is to move most validation to the web ui)
2017-10-04 21:18:59 +01:00
f1b50737bb Docs refactor (#7389)
* docs: Refactored docs for new layout

* some more changes

* more doc updates

* More doc updates

* small update

* small update
2017-10-02 21:36:22 +01:00
529660b8c5 docs: Updated docs to include installing xml php modules + updated validate (#7349) 2017-09-15 19:29:54 -05:00
03ff4cf236 docs: Updated CentOS 7 + Nginx install docs (#7209) 2017-08-22 21:15:19 +01:00
6d6d8cef37 docs: Update CentOS 7 + Nginx install docs to set SCRIPT_FILENAME (#7200)
Set SCRIPT_FILENAME to prevent white pages on PHP 7.1.x
2017-08-21 22:55:19 +01:00
38cb8ab5db docs: Allow host renames with selinux enforcing for CentOS installs
* Allow host renames with selinux enforcing

you have to change the fcontext of /opt/librenms/rrd/ to allow read/write.

* Update Installation-CentOS-7-Nginx.md

Changed to add semanage fcontext -a -t httpd_sys_content_t '/opt/librenms/rrd(/.*)?' to complete the selinux change.

* Update Installation-CentOS-7-Apache.md
2017-08-11 09:34:21 +01:00
1d777693e1 feature: New IP parsing classes. Removes usage of Pear Net_IPv4 and Net_IPv6. (#7106)
* Refactor remove use of pear Net_IPv4 and Net_IPv6

Caution, I added tests to test the functionality of the new functions, but I'm not 100% certain the replaced usages match 100%.  Please test.

Left usage in generate-iplist.php because I'm not sure the use of that script, so I didn't want to implement additional functionality to support it.

Add support for ipv6 fo ipInNetwork() function

Add phpdocs to functions
Remove accidental inclusion

Use binary operations instead of string for networKFromIp()
Tidy up binary operations in ipInNetwork()

tidy parsing cidr network

Change to a class based implementation.

Update phpdocs.
Fully catch exceptions for hex parsing.

Fix mistake.

support older phpunit versions

Fix php shifting to negative with php 5

* Fix graph authorization. Uncaught exception and checking an ipv4 against an ipv6 network == fail.

* Also remove colons from hex strings.

* Fix typo in bgp polling
Two passes of removing invalid characters from hex strings. (That way we don't mangle valid IPs)
2017-08-08 14:14:58 -05:00
8b627bfec9 Update Ubuntu-image.md (#6960)
advise 

http://blog.oxforddictionaries.com/2014/05/advise-advice/
2017-07-05 07:48:29 +01:00
573a4b0e62 Updated validate to detect lower case tables + added support for checking mariadb 10.2 timestamps (#6928)
* Updated validate to detect lower case tables + added support for checking mariadb 10.2 timestamps

* updated install docs
2017-07-03 15:46:45 -05:00
5975980dee Emphasize web isntall.php (#6913) 2017-06-28 20:33:04 -05:00
fb548a9732 docs: Update Ubuntu and CentOS nginx install doc with a better nginx config (#6836)
* docs: Update install doc with a beter nginx config

* Updated LibreNMS API Location to v0

* Updated LibreNMS API Location to v0
2017-06-22 22:49:13 +01:00
c835708689 docs: Add instructions for opening firewall on CentOS (#6605)
* Add instructions for opening firewall

* Allow access through the firewall
2017-05-13 09:21:19 +01:00
64e020d703 docs: Updated install docs + perf to support compressing file types and using http/2 (#6466) 2017-04-22 08:09:34 -05:00
681b8ba9aa docs: Update install docs to remove deprecated GRANT usage 2017-03-30 22:12:51 +01:00
e165565413 removed -p from doc (#6274) 2017-03-26 13:45:27 +01:00
b6c2648f44 Update Installation-CentOS-7-Apache.md (#6271)
The -p option is not needed by the default installation of mariadb-server on CentOS Linux release 7.3.1611 (Core)

Including it without knowing to press enter for no password results in an authentication error:

root@netmon ~# mysql -u root -p
Enter password:
ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)

Alternatively, it could be noted to leave the password field blank when asked.
2017-03-26 13:02:23 +01:00
35e33d629c docs: php-fpm grant access (#6227)
php-fpm runs as the apache user, add it to the librenms group too.
Changing the user of php-fpm breaks other things, so this is the better fix
Primarily broken when using rrdcached.
2017-03-21 19:31:40 -05:00