Alpine Linux - User contributions [en]

Zabbix - cgi and mysql

2020-08-13T16:29:26Z

Stateful:

The purpose of this document is to assist in installing the Zabbix server software and Zabbix agent on the Alpine Linux operating system. Instructions on how to configure and use Zabbix - as well as many useful tutorials - can be found at http://www.zabbix.com.

{{Note|The minimum required version of Alpine Linux required to install Zabbix is Alpine 2.2. this guide has been updated to zabbix 3.0}}

= Install Lighttpd, and PHP =

{{:Setting Up Lighttpd With FastCGI}}

For Zabbix you will have to install following two extra packages otherwise Zabbix will not run.
1. php7-mbstring 2. php7-pgsql

To Install these two packages
{{Cmd|apk add php7-mbstring php7-pgsql}}
= Configure PostgreSQL =

Install PostgreSQL

{{Cmd|apk add postgresql postgresql-client}}

Now configure PostgreSQL:
{{Cmd|/etc/init.d/postgresql setup
/etc/init.d/postgresql start
rc-update add postgresql}}

= Install Zabbix =

{{Cmd|apk add zabbix zabbix-pgsql zabbix-webif zabbix-setup}}

Now we need to set up the zabbix database. Substitute '*********' in the example below for a real password:

{{Cmd|<nowiki>psql -U postgres
postgres=# create user zabbix with password '*********';
postgres=# create database zabbix owner zabbix;
postgres=# \q
cd /usr/share/zabbix/database/postgresql
cat schema.sql | psql -U zabbix zabbix
cat images.sql | psql -U zabbix zabbix
cat data.sql | psql -U zabbix zabbix</nowiki>}}

Create a softlink for the Zabbix web-frontend files:

{{Cmd|rm /var/www/localhost/htdocs -R
ln -s /usr/share/webapps/zabbix /var/www/localhost/htdocs}}

Edit PHP configuration to satisfy some zabbix requirements. Edit /etc/php7/php.ini and configure the following values at least:

<pre>
Max_execution_time = 600
Expose_php = Off
Date.timezone = <insert your timezone here>
post_max_size = 32M
upload_max_filesize = 16M
max_input_time = 600
memory_limit = 256M
</pre>

Also comment (doc_root & user_dir ) by putting # before these.

Configure the following entries in /etc/zabbix/zabbix_server.conf, where DBPassword is the password chosen for the database above:

<pre>
DBName=zabbix

# Database user

DBUser=zabbix

# Database password
# Comment this line if no password used

DBPassword=*********

FpingLocation=/usr/sbin/fping
</pre>

Start Zabbix server:

{{Cmd|rc-update add zabbix-server
/etc/init.d/zabbix-server start}}

Fix permissions on conf directory.

{{Cmd|chown -R lighttpd /usr/share/webapps/zabbix/conf}}

You should now be able to browse to the Zabbix frontend: http://yourservername/.

or

You should now be able to browse to the Zabbix setup frontend: http://yourserverip/instal.php.

Follow the setup instructions to configure Zabbix, supplying the database information used above.

After setup, login using: Login name: '''Admin''' Password:'''zabbix'''. (as described at http://www.zabbix.com/documentation/1.8/manual/installation)

Finally, Zabbix requires special permissions to use the fping binary.

{{Cmd|chmod u+s /usr/sbin/fping}}

= Install Zabbix Agent on Monitored Servers =

Zabbix can monitor almost any operating system, including Alpine Linux hosts. Complete the following steps to install the Zabbix agent on Alpine Linux.

{{Note|Support to allow zabbix-agentd to view running processes on Alpine Linux has been added since linux-grsec-2.6.35.9-r2. Please ensure you have that kernel installed prior to attempting to run zabbix-agentd.}}

Ensure that the readproc group exists (support added since alpine-baselayout-2.0_rc1-r1), by adding the following line to /etc/group:

{{Cmd|readproc:x:30:zabbix}}

Install the agent package:

{{Cmd|apk add zabbix-agent}}

Edit the /etc/zabbix/zabbix_agentd.conf file and configure at least the following option:
<pre>
Server=<ip or hostname of zabbix server>
Hostname=<ip or hostname of zabbix agent>
ListenPort=10050
</pre>

Start the zabbix-agent:

{{Cmd|rc-update add zabbix-agentd
/etc/init.d/zabbix-agentd start}}

In case you want to monitor using SNMP agent on remote machines you have to add these packages on zabbix server:

{{Cmd|apk add net-snmp net-snmp-tools}}

And add these packages on remote machines:

{{Cmd|apk add net-snmp }}

= Optional: Crash course in adding hosts, checks, and notifications =

''Note:'' This is optional since it's not specific to Alpine Linux, but I wanted a couple notes for how to perform a simple check on a server that doesn't have the agent installed on it, and be notified on state changes.

Administration -> Media Types -> Email
* Setup server, helo, email from address

Administration -> Users
* Setup each user who'll get notified, make sure they have media type "Email" added with their address

Configuration -> Hosts -> Create host
* In Linux Servers hostgroup
* Define dns name, ip, connect by IP
* If the machine is a simple networking device that will only be monitored using SNMP, add it to Template_SNMPv2_Device, and you're done.

Configuration -> Templates -> Create template
* Give it a name (Template_Alpine_Linux_Infra_HTTP)
* In Templates group

Configuration -> Templates -> Template_Alpine_Linux_Infra_HTTP -> Items
* Create Item
* Host: Template_Alpine_Linux_Infra_HTTP
* Description: HTTP Basic Check
* Type: Simple_check
* Key: http,80

Configuration -> Templates -> Template_Alpine_Linux_Infra_HTTP -> Triggers
* Create Trigger
* Name: "HTTP Trigger"
* Expression: {Template_Alpine_Linux_Infra_HTTP:http,80.last(0)}#1
* Severity: High

Configuration -> Actions ->
* Create Action
* name: Email notifications
* Event source: triggers
* Default Subject: add "{HOST.DNS}:" to the beginning
* Default message: add "{HOST.DNS}:" to the beginning
* Conditions: make host have to be from "Linux Servers" hostgroup, and Template_Alpine_Linux_Infra_HTTP:HTTP trigger" is not 1
* Email affected users

[[Category:Monitoring]]
[[Category:PHP]]
[[Category:SQL]]

Zabbix - cgi and mysql

2020-08-13T16:28:47Z

Stateful:

The purpose of this document is to assist in installing the Zabbix server software and Zabbix agent on the Alpine Linux operating system. Instructions on how to configure and use Zabbix - as well as many useful tutorials - can be found at http://www.zabbix.com.

{{Note|The minimum required version of Alpine Linux required to install Zabbix is Alpine 2.2. this guide has been updated to zabbix 3.0}}

= Install Lighttpd, and PHP =

{{:Setting Up Lighttpd With FastCGI}}

For Zabbix you will have to install following two extra packages otherwise Zabbix will not run.
1. php7-mbstring 2. php7-pgsql

To Install these two packages
{{Cmd|apk add php7-mbstring php7-pgsql}}
= Configure PostgreSQL =

Install PostgreSQL

{{Cmd|apk add postgresql postgresql-client}}

Now configure PostgreSQL:
{{Cmd|/etc/init.d/postgresql setup
/etc/init.d/postgresql start
rc-update add postgresql}}

= Install Zabbix =

{{Cmd|apk add zabbix zabbix-pgsql zabbix-webif zabbix-setup}}

Now we need to set up the zabbix database. Substitute '*********' in the example below for a real password:

{{Cmd|<nowiki>psql -U postgres
postgres=# create user zabbix with password '*********';
postgres=# create database zabbix owner zabbix;
postgres=# \q
cd /usr/share/zabbix/database/postgresql
cat schema.sql | psql -U zabbix zabbix
cat images.sql | psql -U zabbix zabbix
cat data.sql | psql -U zabbix zabbix</nowiki>}}

Create a softlink for the Zabbix web-frontend files:

{{Cmd|rm /var/www/localhost/htdocs -R
ln -s /usr/share/webapps/zabbix /var/www/localhost/htdocs}}

Edit PHP configuration to satisfy some zabbix requirements. Edit /etc/php7/php.ini and configure the following values at least:

<pre>
Max_execution_time = 600
Expose_php = off
Date.timezone = <insert your timezone here>
post_max_size = 32M
upload_max_filesize = 16M
max_input_time = 600
memory_limit = 256M
</pre>

Also comment (doc_root & user_dir ) by putting # before these.

Configure the following entries in /etc/zabbix/zabbix_server.conf, where DBPassword is the password chosen for the database above:

<pre>
DBName=zabbix

# Database user

DBUser=zabbix

# Database password
# Comment this line if no password used

DBPassword=*********

FpingLocation=/usr/sbin/fping
</pre>

Start Zabbix server:

{{Cmd|rc-update add zabbix-server
/etc/init.d/zabbix-server start}}

Fix permissions on conf directory.

{{Cmd|chown -R lighttpd /usr/share/webapps/zabbix/conf}}

You should now be able to browse to the Zabbix frontend: http://yourservername/.

or

You should now be able to browse to the Zabbix setup frontend: http://yourserverip/instal.php.

Follow the setup instructions to configure Zabbix, supplying the database information used above.

After setup, login using: Login name: '''Admin''' Password:'''zabbix'''. (as described at http://www.zabbix.com/documentation/1.8/manual/installation)

Finally, Zabbix requires special permissions to use the fping binary.

{{Cmd|chmod u+s /usr/sbin/fping}}

= Install Zabbix Agent on Monitored Servers =

Zabbix can monitor almost any operating system, including Alpine Linux hosts. Complete the following steps to install the Zabbix agent on Alpine Linux.

{{Note|Support to allow zabbix-agentd to view running processes on Alpine Linux has been added since linux-grsec-2.6.35.9-r2. Please ensure you have that kernel installed prior to attempting to run zabbix-agentd.}}

Ensure that the readproc group exists (support added since alpine-baselayout-2.0_rc1-r1), by adding the following line to /etc/group:

{{Cmd|readproc:x:30:zabbix}}

Install the agent package:

{{Cmd|apk add zabbix-agent}}

Edit the /etc/zabbix/zabbix_agentd.conf file and configure at least the following option:
<pre>
Server=<ip or hostname of zabbix server>
Hostname=<ip or hostname of zabbix agent>
ListenPort=10050
</pre>

Start the zabbix-agent:

{{Cmd|rc-update add zabbix-agentd
/etc/init.d/zabbix-agentd start}}

In case you want to monitor using SNMP agent on remote machines you have to add these packages on zabbix server:

{{Cmd|apk add net-snmp net-snmp-tools}}

And add these packages on remote machines:

{{Cmd|apk add net-snmp }}

= Optional: Crash course in adding hosts, checks, and notifications =

''Note:'' This is optional since it's not specific to Alpine Linux, but I wanted a couple notes for how to perform a simple check on a server that doesn't have the agent installed on it, and be notified on state changes.

Administration -> Media Types -> Email
* Setup server, helo, email from address

Administration -> Users
* Setup each user who'll get notified, make sure they have media type "Email" added with their address

Configuration -> Hosts -> Create host
* In Linux Servers hostgroup
* Define dns name, ip, connect by IP
* If the machine is a simple networking device that will only be monitored using SNMP, add it to Template_SNMPv2_Device, and you're done.

Configuration -> Templates -> Create template
* Give it a name (Template_Alpine_Linux_Infra_HTTP)
* In Templates group

Configuration -> Templates -> Template_Alpine_Linux_Infra_HTTP -> Items
* Create Item
* Host: Template_Alpine_Linux_Infra_HTTP
* Description: HTTP Basic Check
* Type: Simple_check
* Key: http,80

Configuration -> Templates -> Template_Alpine_Linux_Infra_HTTP -> Triggers
* Create Trigger
* Name: "HTTP Trigger"
* Expression: {Template_Alpine_Linux_Infra_HTTP:http,80.last(0)}#1
* Severity: High

Configuration -> Actions ->
* Create Action
* name: Email notifications
* Event source: triggers
* Default Subject: add "{HOST.DNS}:" to the beginning
* Default message: add "{HOST.DNS}:" to the beginning
* Conditions: make host have to be from "Linux Servers" hostgroup, and Template_Alpine_Linux_Infra_HTTP:HTTP trigger" is not 1
* Email affected users

[[Category:Monitoring]]
[[Category:PHP]]
[[Category:SQL]]

Zabbix - cgi and mysql

2020-08-13T16:22:59Z

Stateful:

The purpose of this document is to assist in installing the Zabbix server software and Zabbix agent on the Alpine Linux operating system. Instructions on how to configure and use Zabbix - as well as many useful tutorials - can be found at http://www.zabbix.com.

{{Note|The minimum required version of Alpine Linux required to install Zabbix is Alpine 2.2. this guide has been updated to zabbix 3.0}}

= Install Lighttpd, and PHP =

{{:Setting Up Lighttpd With FastCGI}}

For Zabbix you will have to install following two extra packages otherwise Zabbix will not run.
1. php7-mbstring 2. php7-pgsql

To Install these two packages
{{Cmd|apk add php7-mbstring php7-pgsql}}
= Configure PostgreSQL =

Install PostgreSQL

{{Cmd|apk add postgresql postgresql-client}}

Now configure PostgreSQL:
{{Cmd|/etc/init.d/postgresql setup
/etc/init.d/postgresql start
rc-update add postgresql}}

= Install Zabbix =

{{Cmd|apk add zabbix zabbix-pgsql zabbix-webif zabbix-setup}}

Now we need to set up the zabbix database. Substitute '*********' in the example below for a real password:

{{Cmd|<nowiki>psql -U postgres
postgres=# create user zabbix with password '*********';
postgres=# create database zabbix owner zabbix;
postgres=# \q
cd /usr/share/zabbix/database/postgresql
cat schema.sql | psql -U zabbix zabbix
cat images.sql | psql -U zabbix zabbix
cat data.sql | psql -U zabbix zabbix</nowiki>}}

Create a softlink for the Zabbix web-frontend files:

{{Cmd|rm /var/www/localhost/htdocs -R
ln -s /usr/share/webapps/zabbix /var/www/localhost/htdocs}}

Edit PHP configuration to satisfy some zabbix requirements. Edit /etc/php/php.ini and configure the following values at least:

<pre>
Max_execution_time = 600
Expose_php = off
Date.timezone = <insert your timezone here>
post_max_size = 32M
upload_max_filesize = 16M
max_input_time = 600
memory_limit = 256M
</pre>

Also comment (doc_root & user_dir ) by putting # before these.

Configure the following entries in /etc/zabbix/zabbix_server.conf, where DBPassword is the password chosen for the database above:

<pre>
DBName=zabbix

# Database user

DBUser=zabbix

# Database password
# Comment this line if no password used

DBPassword=*********

FpingLocation=/usr/sbin/fping
</pre>

Start Zabbix server:

{{Cmd|rc-update add zabbix-server
/etc/init.d/zabbix-server start}}

Fix permissions on conf directory.

{{Cmd|chown -R lighttpd /usr/share/webapps/zabbix/conf}}

You should now be able to browse to the Zabbix frontend: http://yourservername/.

or

You should now be able to browse to the Zabbix setup frontend: http://yourserverip/instal.php.

Follow the setup instructions to configure Zabbix, supplying the database information used above.

After setup, login using: Login name: '''Admin''' Password:'''zabbix'''. (as described at http://www.zabbix.com/documentation/1.8/manual/installation)

Finally, Zabbix requires special permissions to use the fping binary.

{{Cmd|chmod u+s /usr/sbin/fping}}

= Install Zabbix Agent on Monitored Servers =

Zabbix can monitor almost any operating system, including Alpine Linux hosts. Complete the following steps to install the Zabbix agent on Alpine Linux.

{{Note|Support to allow zabbix-agentd to view running processes on Alpine Linux has been added since linux-grsec-2.6.35.9-r2. Please ensure you have that kernel installed prior to attempting to run zabbix-agentd.}}

Ensure that the readproc group exists (support added since alpine-baselayout-2.0_rc1-r1), by adding the following line to /etc/group:

{{Cmd|readproc:x:30:zabbix}}

Install the agent package:

{{Cmd|apk add zabbix-agent}}

Edit the /etc/zabbix/zabbix_agentd.conf file and configure at least the following option:
<pre>
Server=<ip or hostname of zabbix server>
Hostname=<ip or hostname of zabbix agent>
ListenPort=10050
</pre>

Start the zabbix-agent:

{{Cmd|rc-update add zabbix-agentd
/etc/init.d/zabbix-agentd start}}

In case you want to monitor using SNMP agent on remote machines you have to add these packages on zabbix server:

{{Cmd|apk add net-snmp net-snmp-tools}}

And add these packages on remote machines:

{{Cmd|apk add net-snmp }}

= Optional: Crash course in adding hosts, checks, and notifications =

''Note:'' This is optional since it's not specific to Alpine Linux, but I wanted a couple notes for how to perform a simple check on a server that doesn't have the agent installed on it, and be notified on state changes.

Administration -> Media Types -> Email
* Setup server, helo, email from address

Administration -> Users
* Setup each user who'll get notified, make sure they have media type "Email" added with their address

Configuration -> Hosts -> Create host
* In Linux Servers hostgroup
* Define dns name, ip, connect by IP
* If the machine is a simple networking device that will only be monitored using SNMP, add it to Template_SNMPv2_Device, and you're done.

Configuration -> Templates -> Create template
* Give it a name (Template_Alpine_Linux_Infra_HTTP)
* In Templates group

Configuration -> Templates -> Template_Alpine_Linux_Infra_HTTP -> Items
* Create Item
* Host: Template_Alpine_Linux_Infra_HTTP
* Description: HTTP Basic Check
* Type: Simple_check
* Key: http,80

Configuration -> Templates -> Template_Alpine_Linux_Infra_HTTP -> Triggers
* Create Trigger
* Name: "HTTP Trigger"
* Expression: {Template_Alpine_Linux_Infra_HTTP:http,80.last(0)}#1
* Severity: High

Configuration -> Actions ->
* Create Action
* name: Email notifications
* Event source: triggers
* Default Subject: add "{HOST.DNS}:" to the beginning
* Default message: add "{HOST.DNS}:" to the beginning
* Conditions: make host have to be from "Linux Servers" hostgroup, and Template_Alpine_Linux_Infra_HTTP:HTTP trigger" is not 1
* Email affected users

[[Category:Monitoring]]
[[Category:PHP]]
[[Category:SQL]]

MATE

2020-04-30T15:54:33Z

Stateful: /* Install MATE Desktop */ fix typo

== Setup Xorg ==
Use Alpine's setup script:
{{cmd|# setup-xorg-base}}

Add any additional video drivers necessary:
{{cmd|# apk add xf86-video-ati}}

Add additional input drivers (if necessary)
{{cmd|# apk add xf86-input-synaptics}}

== Enable Community Repository ==

Mate is available in the Community repository. Uncomment {{codeline|http://<url>/alpine/<version>/community}} in {{path|/etc/apk/repositories}}. For example:
{{cat|/etc/apk/repositories|<nowiki># /etc/apk/repositories

#/media/sdb/apks
http://mirror.csclub.uwaterloo.ca/alpine/v3.11/main
http://mirror.csclub.uwaterloo.ca/alpine/v3.11/community
#http://mirror.csclub.uwaterloo.ca/alpine/v3.11/testing
</nowiki>
}}

== Install MATE Desktop ==


{{Cmd|<nowiki># apk add mate-desktop-environment dbus dbus-x11 lxdm udev adwaita-icon-theme faenza-icon-theme sudo
# gvfs_pkgs=$(apk search gvfs -q | grep -v '\-dev' | grep -v '\-lang' | grep -v '\-doc')
# apk add $gvfs_pkgs</nowiki>
}}

Create a regular user:
{{Cmd|# adduser -h /home/<user> -g "Full User Name" <user>}}



{{Cmd|<nowiki># apk del mate-screensaver
# ln -s /usr/etc/xdg/menus/ /etc/xdg/menus
# apk add mate-screensaver</nowiki>}}

Add all available True Type Fonts:
{{Cmd|<nowiki>$ ttfs=$(apk search -q ttf- | grep -v '\-doc')
# apk add $ttfs</nowiki>
}}

If you are running your Alpine from RAM, save the changes:
{{Cmd|# lbu ci}}

Enable services to start on reboot
{{Cmd|<nowiki># rc-update add lxdm
# rc-update add dbus
# rc-update add udev</nowiki>}}

And finally, start the dbus, udev, and lxdm. This will start the display manager and allow you to login.
{{Cmd|<nowiki># rc-service dbus start
# rc-service udev start
# rc-service lxdm start</nowiki>}}



== Misc ==
=== Disabling standby and screensaver ===
Check the current configuration using xset:

{{Cmd|$ sudo apk add xset
$ xset q}}

{{cat|xset q|
Keyboard Control:
auto repeat: on key click percent: 0 LED mask: 00000000
XKB indicators:
00: Caps Lock: off 01: Num Lock: off 02: Scroll Lock: off
03: Compose: off 04: Kana: off 05: Sleep: off
06: Suspend: off 07: Mute: off 08: Misc: off
09: Mail: off 10: Charging: off 11: Shift Lock: off
12: Group 2: off 13: Mouse Keys: off
auto repeat delay: 500 repeat rate: 20
auto repeating keys: 00ffffffdffffbbf
fadfffefffedffff
9fffffffffffffff
fff7ffffffffffff
bell percent: 0 bell pitch: 400 bell duration: 100
Pointer Control:
acceleration: 2/1 threshold: 4
Screen Saver:
prefer blanking: yes allow exposures: yes
timeout: 600 cycle: 0
Colors:
default colormap: 0x22 BlackPixel: 0x0 WhitePixel: 0xffffff
Font Path:
/usr/share/fonts/misc,/usr/share/fonts/100dpi:unscaled,/usr/share/fonts/75dpi:unscaled,/usr/share/fonts/misc,/usr/share/fonts/100dpi:unscaled,/usr/share/fonts/75dpi:unscaled,built-ins
DPMS (Energy Star):
Standby: 600 Suspend: 0 Off: 900
DPMS is Enabled
Monitor is On
}}

To disable those timers issue the command:
{{Cmd|$ xset dpms 0 0 0}}

Santiy check:

{{Cmd|$ xset q | grep Standby
Standby: 0 Suspend: 0 Off: 0}}

[[Category:Desktop]]