Update docs for virtual images (#9456)

This commit is contained in:
Neil Lathwood
2018-11-17 14:19:38 +00:00
committed by GitHub
parent d3f5dc682f
commit 09b2b5f1a1
6 changed files with 69 additions and 151 deletions

View File

@@ -1,74 +1,3 @@
source: Installation/CentOS-image.md
path: blob/master/doc/
> NOTE: We highly advice that you change all passwords on this image when you deploy it!!
> NOTE: Read the above note again!
We have available for download a pre-built image based on CentOS 7. Details of the image are below:
The image is built with VirtualBox, a vmdk is provided along with an ova which was exported using OFV 1.0 version.
These should be supported in VMWare Fusion, Workstation, Player and VirtualBox.
* NOTE: It's highly recommended that you update by doing the following.
```bash
cd /opt/librenms
./daily.sh
```
* Any issues and or help with these images should be reported via [Community Fourm](https://community.librenms.org) or our [Discord server](https://t.libren.ms/discord)
#### Setup
- UK Keyboard
- Etc/UTC Timezone
- 4 Poller Wrapper threads
#### Software
- PHP 7
- MariaDB
- Syslog-ng
### Features
- Oxidized install but not configured
- Weathermap plugin enabled
- Billing enabled
- RRDCached enabled
- Service checks enabled
- Syslog enabled
#### Download
[OVA Image](http://www.lathwood.co.uk/librenms/librenms_centos_7.ova) - 1.1G
- md5sum: 53f0c06c26255e859144e471ae85eedc
- sha256sum: 9d902e8452ec8f88ab96180b46113ab5c8ef9213b16cebbbf3f88df37670ebd4
[VMDK Image](http://www.lathwood.co.uk/librenms/librenms_centos_7.vmdk) - 2.8G
- md5sum: 8c54cb929ba9e16bc9a985a292b8f9d9
- sha256sum: 944d1164f0664334fdb50e425049819a18da5568c56b6b49681a9ebe13ae9489
#### Credentials
> Please note the second character of the SSH password is a CAPITAL EYE
- SSH
- username: librenms
- password: `CIne3fwdfds`
> Please note the second character of the SSH password is a CAPITAL EYE
- MySQL/MariaDB
- username: root
- password: `NIfceu3fqfd`
- username: librenms
- password: `D42nf23rewD`
- WebUI
- username: librenms
- password: `D32fwefwef`
<meta http-equiv="refresh" content="0; url=/Installation/Images/" />

View File

@@ -0,0 +1,61 @@
> NOTE: We highly advice that you change all passwords on this image when you deploy it!!
> NOTE: Read the above note again!
We have available for download a pre-built image based on CentOS 7 and Ubuntu 18.04. These images are built using [packer.io](https://packer.io).
Details of the image and it's setup are:
At present we provide the following builds:
- OVA Built with VirtualBox.
* Any issues and or help with these images should be reported via [Community Fourm](https://community.librenms.org) or our [Discord server](https://t.libren.ms/discord)
#### Setup
- US Keyboard
- Etc/UTC Timezone
- 4 Poller Wrapper threads
#### Software
- PHP 7
- MariaDB
- Syslog-ng
### Features
- Oxidized install but not configured
- Weathermap plugin enabled
- Billing enabled
- RRDCached enabled
- Service checks enabled
- Syslog enabled
#### Download
All images can be downloaded from [GitHub](https://github.com/librenms/packer-builds/releases). The tags follow the main LibreNMS repo.
When a new LibreNMS release is available we will push new images out running that version. Please do note that if you download an older
release with a view to running that specific version, you will need to disable updates in config.php.
#### Credentials
- SSH
- username: librenms
- password: `CDne3fwdfds`
> Please note the second character of the SSH password is a CAPITAL EYE
- MySQL/MariaDB
- username: librenms
- password: `D42nf23rewD`
- WebUI
- username: librenms
- password: `D32fwefwef`
#### Contributing
If you would like to help with these images whether it's add additional features or default software / settings then you can do so
on [GitHub](https://github.com/librenms/packer-builds/).

View File

@@ -1,74 +1,3 @@
source: Installation/Ubuntu-image.md
path: blob/master/doc/
> NOTE: We highly advise that you change all passwords on this image when you deploy it!!
> NOTE: Read the above note again!
We have available for download a pre-built image based on Ubuntu 16.04 LTS. Details of the image are below:
The image is built with VirtualBox, a vmdk is provided along with an ova which was exported using OFV 1.0 version.
These should be supported in VMWare Fusion, Workstation, Player and VirtualBox.
* NOTE: It's highly recommended that you update by doing the following.
```bash
cd /opt/librenms
./daily.sh
```
* Any issues and or help with these images should be reported via [Community Fourm](https://community.librenms.org) or our [Discord server](https://t.libren.ms/discord)
#### Setup
- UK Keyboard
- Etc/UTC Timezone
- LVM for disk setup
- 4 Poller Wrapper threads
#### Software
- PHP 7
- MariaDB
- Syslog-ng
### Features
- Oxidized install but not configured
- Weathermap plugin enabled
- Billing enabled
- RRDCached enabled
- Service checks enabled
- Syslog enabled
#### Download
[OVA Image](http://www.lathwood.co.uk/librenms/librenms_ubuntu_1604.ova) - 1.6G
- md5sum: 18c13c521aa5a6f5e96be2641324a626
- sha256sum: 78c09dcd441633ea633118fbc51090e032257752b1f0698fcd084b2b025b6343
[VMDK Image](http://www.lathwood.co.uk/librenms/librenms_ubuntu_1604.vmdk) - 4.0G
- md5sum: fc072de8ee6c95ccee1a7a4cd8d08f4c
- sha256sum: 36a2252a6f6f7a3a8d7b5e2fda00eb7949a8d9d1fb637a440773aac5ebf838f3
#### Credentials
> Please note the second character of the SSH password is a CAPITAL EYE
- SSH
- username: librenms
- password: `CIne3fwdfds`
> Please note the second character of the SSH password is a CAPITAL EYE
- MySQL/MariaDB
- username: root
- password: `NIfceu3fqfd`
- username: librenms
- password: `D42nf23rewD`
- WebUI
- username: librenms
- password: `D32fwefwef`
<meta http-equiv="refresh" content="0; url=/Installation/Images/" />

View File

@@ -7,10 +7,9 @@ path: blob/master/doc/
An official LibreNMS docker image based on Alpine Linux and Nginx is available on [DockerHub](https://hub.docker.com/r/librenms/librenms/) and [Quay](https://quay.io/repository/librenms/librenms). Documentation can be found on the [Github repository](https://github.com/librenms/docker).
## Images
We have some pre-built VirtualBox images you can use to get started. Please note that these images are pre-built for VirtualBox, hence they might not work with other hypervisors without converting them:
We have some pre-built VirtualBox images you can use to get started:
- [Ubuntu 16.04](http://docs.librenms.org/Installation/Ubuntu-image/)
- [CentOS 7](http://docs.librenms.org/Installation/CentOS-image/)
- [Virtual Machines](http://docs.librenms.org/Installation/Images/)
## Manually
If you want to install manually then we have some documentation which should make it easy.
@@ -37,5 +36,4 @@ Third-party installation supports have been created by the community.
### Docker images
- [crazymax/librenms](https://github.com/crazy-max/docker-librenms) based on Alpine Linux by [CrazyMax](https://github.com/crazy-max)
- [jarischaefer/docker-librenms](https://github.com/jarischaefer/docker-librenms) based on Ubuntu by [Jari Schäfer](https://github.com/jarischaefer)
- [librenms/docker](https://github.com/librenms/docker) based on Ubuntu by [Jari Schäfer](https://github.com/jarischaefer)

View File

@@ -36,8 +36,7 @@ nav:
- General/Welcome-to-Observium-users.md
- 2. Installing:
- Installing LibreNMS: Installation/index.md
- Ubuntu VM Image: Installation/Ubuntu-image.md
- CentOS VM Image: Installation/CentOS-image.md
- LibreNMS VMs: Installation/Images.md
- Ubuntu 18.04 (Nginx): Installation/Installation-Ubuntu-1804-Nginx.md
- Ubuntu 18.04 (Apache): Installation/Installation-Ubuntu-1804-Apache.md
- CentOS 7 (Nginx): Installation/Installation-CentOS-7-Nginx.md

View File

@@ -56,6 +56,8 @@ class DocTest extends TestCase
'Installation/Installation-Ubuntu-1604-Nginx.md',
'Installation/Installing-LibreNMS.md',
'Support/Support-New-OS.md',
'Installation/Ubuntu-image.md',
'Installation/CentOS-image.md',
];
public function testDocExist()