Commit Graph

59 Commits

Author SHA1 Message Date
CrazyMax
a0062aa633 Remove hardcoded URLs to doc (#12364)
Co-authored-by: CrazyMax <crazy-max@users.noreply.github.com>
2020-11-27 23:34:58 +01:00
Jellyfrog
bd81f76caa Use variable for PHP min version in docs (#12256)
* Use variable for PHP min version in docs

* Bump mkdocs deps
2020-10-24 11:19:45 +02:00
Hans Erasmus
612817f1a0 Added python3 for new installs (#11564)
`./scripts/composer_wrapper.php install --no-dev` will fail without pip3 installed.
2020-05-06 22:57:14 +02:00
Hans Erasmus
3169e663d1 Remove webtatic repo from CentOS install docs (#11490)
I personally have no problem with them, but after a recent discussion in discord about a user asking which Repo, it got me thinking that maybe we should also stick to what the OS providers have to say? I see that (obviously) SCL and remi is on the trusted list, so shouldn't the install docs rather stick with them?
https://wiki.centos.org/AdditionalResources/Repositories
2020-04-27 09:07:16 +02:00
Jellyfrog
05507526c0 Set PHP 7.2.5 as minimum supported version (#11470) 2020-04-24 11:04:36 +02:00
Atroskelis
2bd17690ba Added yum-config-manager to Remi install (#11033)
Hello,

If you follow the original Rumi config, the path to the binaries are not changed, so you cannot do php -v after the yum install line. 

If you install the yum-package-manager then apply the repo, all php packages become rumi php packages.

I hope the yum install line is correct, as i've tried to edit it and i hope i didnt miss any packages.
2020-02-13 22:22:41 +01:00
TheGreatDoc
f99c45b4c1 Update Installation-CentOS-7-Apache.md (#11056)
Fixed typo
2020-01-21 08:53:14 +00:00
Hans Erasmus
dd70f6e0c9 Deleted yum package listed twice (#10758) 2019-10-29 18:36:33 +01:00
Jellyfrog
c76e95d343 Markdown linting of docs (#10595)
* Remove trailing spaces

* Markdown linting of docs
2019-10-21 00:47:40 +00:00
Tony Murray
c8bcdbb916 Fix CentOS PHP install docs (#10645)
* Fix CentOS PHP install docs

* Update Installation-CentOS-7-Apache.md

* Update Installation-CentOS-7-Apache.md

* Update Installation-CentOS-7-Nginx.md
2019-10-02 13:57:01 +00:00
Orsiris de Jong
a0c2df6cd9 Improve CentOS 7 install instructions (#10477)
* Improve instructions

Documentation when open_basedir is set
Also gives list of packages when installing php-fpm
Fixes cron and logrotate files not being executed if umask is set

* Split dependencies universal / php

* Updated php doc

* Add more binaries to open_basedir
2019-09-18 14:59:20 +00:00
Hans Erasmus
cec10c1d37 Update Installation-CentOS-7-Apache to fix formatting (#10504)
* Update Installation-CentOS-7-Apache.md

Fixed formatting.

* Update Installation-CentOS-7-Apache.md
2019-08-09 21:55:14 +01:00
VVelox
06b85f5b07 docs: more md linting (#10371)
* clean 1-Minute-Polling.md formatting

* cleanup formatting for Adding-a-Device.md

* clean up formatting of Cleanup-options.md

* cleanup formatting some for CLI-Tools.md

* cleanup formatting for Syslog.md and Configuration.md

* cleanup formatting for Device-Sensors.md

* cleanup formatting for Device-Troubleshooting.md

* cleanup Discovery Support.md

* cleanup Environment-Variables.md

* cleanup Example-Hardware-Setup.md and FAQ.mg

* update Features.md, Install Validation.md, Perfermance.md, Poller Support.md, and index.md

* cleanup Remote-Monitoring-VPN.md, SNMP-Configuration-Examples.md, and SSL-Configuration.md

* lots of updates for Installation docs

* more installation doc cleanup

* more formatting cleanup

* clean Work-Map.md up some
2019-07-18 21:25:53 -05:00
Tony Murray
0baeb07754 Split install steps into git clone and composer install (#10249)
* Split install steps into git clone and composer install
This gives the admin a little more knowledge about how to maintain the system, showing them composer_wrapper.php and su - librenms
They will get errors if composer_wrapper doesn't work because of a proxy or no internet connection

We lose stats on packagist.org (https://packagist.org/packages/librenms/librenms/stats)
If we wanted to keep stats, we could use:
```
COMPOSER_ALLOW_SUPERUSER=1 composer create-project --no-dev --no-install --keep-vcs librenms/librenms librenms dev-master
```
not sure that is worth it.

* fix composer_wrapper.php path
2019-06-12 00:21:32 -05:00
PipoCanaja
f9527ba5d2 Update Installation-CentOS-7-Apache.md (#10191) 2019-05-13 23:18:04 -05:00
TheGreatDoc
0835d8899e Change minimum PHP version in install docs (#9820)
* Change minimum PHP version in install docs
2019-02-15 12:05:22 +01:00
mhzgh
f7ae5e3cff Install docs, note proxy config (#9720)
* Update Installation-Ubuntu-1804-Apache.md

As discussed here:
https://github.com/librenms/librenms/issues/9709

* Update Installation-Ubuntu-1804-Apache.md

* Update Installation-Ubuntu-1804-Apache.md

* Update Installation-Ubuntu-1804-Apache.md

* Update Installation-Ubuntu-1804-Nginx.md

* Update Installation-Ubuntu-1604-Nginx.md

* Update Installation-Ubuntu-1604-Apache.md

* Update Installation-Ubuntu-1404-Nginx.md

* Update Installation-Ubuntu-1404-Lighttpd.md

* Update Installation-Ubuntu-1404-Apache.md

* Update Installation-CentOS-7-Nginx.md

* Update Installation-CentOS-7-Apache.md

* Update Installation-CentOS-6-Apache-Nginx.md
2019-02-13 10:13:33 -06:00
Neil Lathwood
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
TheGreatDoc
cc225bd39c Fixed format for snmpd configuration step (#9203) 2018-09-14 08:03:51 -05:00
Tony Murray
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
Hans Erasmus
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
Tony Murray
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
Neil Lathwood
b3d190ec52 docs: Updated CentOS 7 install docs to use php72w-mysqlnd (#8618) 2018-04-25 19:04:37 -05:00
TheGreatDoc
72dffd8d95 docs: Update Installation-CentOS-7-Apache.md (#8349)
php72w-mcrypt is not used anymore
2018-03-09 17:52:26 +01:00
Tony Murray
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
Tony Murray
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
Tony Murray
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
Søren Rosiak
ec2256c350 docs: Install Docs Update for min PHP ver (#7630)
* docs: Install Docs Update

* Some changes..
2017-11-15 08:12:14 +00:00
Tony Murray
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
Tony Murray
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
FTBZ
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
Tony Murray
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
Neil Lathwood
529660b8c5 docs: Updated docs to include installing xml php modules + updated validate (#7349) 2017-09-15 19:29:54 -05:00
kedearian
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
Tony Murray
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
Neil Lathwood
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
timando
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
sorano
681b8ba9aa docs: Update install docs to remove deprecated GRANT usage 2017-03-30 22:12:51 +01:00
Tyler
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
JꙨdцӍoηҬ
d468fc301e systemctl enable mariadb (#6117)
* systemctl enable mariadb

It might be practical to start on boot the DB ;)

* Update Installation-CentOS-7-Apache.md
2017-03-07 21:01:51 +00:00
Neil Lathwood
24a5f6bd37 Db collation standardisation (#5932)
* initial work to standardise collation

* more updates

* final bits for collation update (famous last words)

* Rename 165.sql to 166.sql

* Update schema version inside 166.sql

* moved schema file 166->171
2017-02-27 18:28:01 +00:00
deutor
cdd9238b32 Installation-CentOS-7-Apache.md - fixed typo (#5918)
Fixed typo
2017-02-16 15:08:30 +00:00
jackson-tim
94bdff3b86 docs: Update Oxidized integration to show example of SELinux setup 2017-01-30 17:59:35 +00:00
Todd Eddy
a8c04460f4 docs: Add logrotate config and update install docs (#5520) 2017-01-21 11:11:22 +00:00
Layne
7a3e437852 docs: Update installation documentation on Ubuntu 16.x and CentOS 7 to use systemd (#5324) 2017-01-06 21:43:06 +00:00
Layne
78ae0f42a1 docs: fixed example timezone (#5084) 2016-11-29 22:34:39 +00:00
FTBZ
369bfaf508 Corrected CentOS 7/RHEL 7 snmp.conf path (#4519)
Documentation: fixed centos snmp path
2016-09-21 16:22:38 +00:00
joeywas
b2aa271660 Fixing hyperlinks to actually hyperlink 2016-08-30 15:54:09 -07:00
joeywas
149f4538a2 Clarified validate.php is run as root 2016-08-30 15:48:10 -07:00
Neil Lathwood
383c50b4f4 Updated docs to have source to use for edit github (#4185)
* Added source link for edit on github

* Updated formatting issues

* Updated formatting issues

* Updated formatting issues
2016-08-24 08:12:20 +01:00