tyler.durden/icingaweb2
1
0
Fork 0
mirror of https://github.com/Icinga/icingaweb2.git synced 2025-07-22 05:14:25 +02:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'feature/alpine-linux-docs'

Browse Source 
closes #2727
This commit is contained in:
Eric Lippmann 2017-06-02 09:51:16 +02:00
commit 693a893cad
1 changed files with 34 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
doc/02-Installation.md
View File

@ -47,6 +47,7 @@ Below is a list of official package repositories for installing Icinga Web 2 for
| Gentoo | [Upstream](https://packages.gentoo.org/packages/www-apps/icingaweb2) | | Gentoo | [Upstream](https://packages.gentoo.org/packages/www-apps/icingaweb2) |
| FreeBSD | [Upstream](http://portsmon.freebsd.org/portoverview.py?category=net-mgmt&portname=icingaweb2) | | FreeBSD | [Upstream](http://portsmon.freebsd.org/portoverview.py?category=net-mgmt&portname=icingaweb2) |
| ArchLinux | [Upstream](https://aur.archlinux.org/packages/icingaweb2) | | ArchLinux | [Upstream](https://aur.archlinux.org/packages/icingaweb2) |
| Alpine Linux | [Upstream](http://git.alpinelinux.org/cgit/aports/tree/community/icingaweb2/APKBUILD) |
Packages for distributions other than the ones listed above may also be available. Packages for distributions other than the ones listed above may also be available.
Please contact your distribution packagers. Please contact your distribution packagers.
@ -63,7 +64,6 @@ wget -O - http://packages.icinga.com/icinga.key | apt-key add -
echo 'deb http://packages.icinga.com/debian icinga-jessie main' >/etc/apt/sources.list.d/icinga.list echo 'deb http://packages.icinga.com/debian icinga-jessie main' >/etc/apt/sources.list.d/icinga.list
apt-get update apt-get update
``` ```
> INFO > INFO
> >
> For other Debian versions just replace jessie with your distribution's code name. > For other Debian versions just replace jessie with your distribution's code name.
@ -110,6 +110,15 @@ zypper ar http://packages.icinga.com/openSUSE/ICINGA-release.repo
zypper ref zypper ref
``` ```
**Alpine Linux**:
```
echo "http://dl-cdn.alpinelinux.org/alpine/edge/community" >> /etc/apk/repos
apk update
```
> INFO
>
> Latest version of Icinga Web 2 is in the edge repository, which is the -dev branch.
#### <a id="package-repositories-rhel-notes"></a> RHEL/CentOS Notes #### <a id="package-repositories-rhel-notes"></a> RHEL/CentOS Notes
The packages for RHEL/CentOS depend on other packages which are distributed as part of the The packages for RHEL/CentOS depend on other packages which are distributed as part of the
@ -118,6 +127,14 @@ The packages for RHEL/CentOS depend on other packages which are distributed as p
> Please note that installing Icinga Web 2 on **RHEL/CentOS 5** is not supported due to EOL versions of PHP and PostgreSQL. > Please note that installing Icinga Web 2 on **RHEL/CentOS 5** is not supported due to EOL versions of PHP and PostgreSQL.
#### <a id="package-repositories-alpine-notes"></a> Alpine Linux Notes
The example provided suppose that you are running Alpine edge, which is the -dev branch and is a rolling release.
If you are using a stable version, in order to use the latest Icinga Web 2 version you should "pin" the edge repository.
In order to correctly manage your repository, please follow
[these instructions](https://wiki.alpinelinux.org/wiki/Alpine_Linux_package_management).
### <a id="installing-from-package-example"></a> Installing Icinga Web 2 ### <a id="installing-from-package-example"></a> Installing Icinga Web 2
You can install Icinga Web 2 by using your distribution's package manager to install the `icingaweb2` package. You can install Icinga Web 2 by using your distribution's package manager to install the `icingaweb2` package.
@ -139,6 +156,12 @@ For RHEL/CentOS please read the [package repositories notes](#package-repositori
zypper install icingaweb2 icingacli zypper install icingaweb2 icingacli
``` ```
**Alpine Linux**:
```
apk add icingaweb2
```
For Alpine Linux please read the [package repositories notes](#package-repositories-alpine-notes).
### <a id="preparing-web-setup-from-package"></a> Preparing Web Setup ### <a id="preparing-web-setup-from-package"></a> Preparing Web Setup
You can set up Icinga Web 2 quickly and easily with the Icinga Web 2 setup wizard which is available the first time You can set up Icinga Web 2 quickly and easily with the Icinga Web 2 setup wizard which is available the first time
@ -234,6 +257,10 @@ Example for Apache on Debian Jessie:
a2enconf icingaweb2 a2enconf icingaweb2
``` ```
Example for Apache on Alpine Linux:
```
icingacli setup config webserver apache --document-root /usr/share/webapps/icingaweb2/public > /etc/apache2/conf.d/icingaweb2.conf
```
### <a id="preparing-web-setup-from-source"></a> Preparing Icinga Web 2 Setup ### <a id="preparing-web-setup-from-source"></a> Preparing Icinga Web 2 Setup
You can set up Icinga Web 2 quickly and easily with the Icinga Web 2 setup wizard which is available the first time You can set up Icinga Web 2 quickly and easily with the Icinga Web 2 setup wizard which is available the first time
@ -275,6 +302,12 @@ usermod -a -G icingaweb2 www-data
service apache2 restart service apache2 restart
``` ```
**Alpine Linux**:
```
gpasswd -a apache icingaweb2
rc-service apache2 restart
```
Use `icingacli` to create the configuration directory which defaults to **/etc/icingaweb2**: Use `icingacli` to create the configuration directory which defaults to **/etc/icingaweb2**:
``` ```