Alpine Linux - User contributions [en]

Alpine Linux:FAQ

2011-03-23T15:35:06Z

Linker3000:

[[Image:filetypes.svg|64px|left|link=]]
This is a list of '''frequently asked questions''' about Alpine Linux. If your question is not answered on this page, use the search box above to find work in progress pages not linked here, or in case of no answer, edit this page and write down your question.
{{Tip| Prepare your question. Think it through. Make it simple and understandable.}}

=General=

== I have found a bug, where can I report it? ==
You can report it on the [http://bugs.alpinelinux.org/ bugtracker].

== Alpine freezes during boot from Compact Flash, how can I fix? ==
Most Compact Flash card readers do not support proper DMA. You should append '''nodma''' to the ''append'' line in syslinux.cfg.

== How can I contribute? ==
You can contribute by using the software and giving feedback.
You can contribute by documenting your Alpine Linux experiences on this wiki. You can contribute in many other ways. Please visit [[Contribute|Contribute page]] to read more about this topic.

Your contributions are highly appreciated.

== How do I remove the CDROM? ==
Since the modloop loopback device is on CDROM you cannot just run ''eject''. You need to unmount the modloop first. Unmounting both the modloop and the cdrom in one step can be done by executing:
/etc/init.d/modloop stop

Then it's possible to run ''eject'' to eject the cdrom.

== Why don't I have man pages or where is the 'man' command? ==
The 'man' command and man pages are not installed by default.

* First, install the man package:
: {{Cmd|apk add man}}
* Once that's done, install the documentation for the packages that you require man pages for: (Keep in mind, however, it's possible that not all packages will have a corresponding documentation package.)
: {{Cmd|apk add <pkg>-doc}}
: For example, say you installed iptables and you now require its man pages:
: {{Cmd|apk add iptables-doc}}
 
In our example above, we installed the man pages (and other documentation) for iptables. We can now read it:
{{Cmd|man iptables}}

==My cron jobs don't run?==
The cron daemon is started automatically on system boot and executes the scripts placed in the folders under ''/etc/periodic'' - there's a ''15min'' folder, plus ones for ''hourly'', ''daily'', ''weekly'' and ''monthly'' scripts.

You can check whether your scripts are likely to run using the command:

: {{cmd|run-parts -t /etc/periodic/[foldername]}} - for example: ''run-parts -t /etc/periodic/15min''

This command will tell you what should run but will not actually execute the scripts.

If the results of the test are not as expected, check the following:

* Make sure the script is executable - if unsure, issue the command : {{cmd|chmod a+x [scriptname]}}
* Make sure the first line of your script is : {{cmd|#!/bin/sh}}
* Do not put file extensions on your script names - this stops them from working; for example: ''myscript'' will run, but ''myscript.sh'' won't

=Audio=

== How do I play my .ogg/.mp3 files? ==
First, the sound card should be recognized (you must have /dev/snd/***** files)

sox, mpg321, mpg123, oggplay, etc all use the oss sound driver, while Alpine uses ALSA drivers. So you need to load the snd-pcm-oss compatibility module. While you're at it, you might need aumix to turn up the sound volume

echo snd-pcm-oss >> /etc/modules
modprobe snd-pcm-oss
apk_add aumix sox
aumix (set volume settings)
play really_cool_song.mp3

= Time and timezones =

== How do I set the local timezone? ==

Starting in Alpine 2.2, a setting the timezone will be part of the setup-alpine script. For previous versions, however:

/etc/timezone and the whole zoneinfo directory tree are not supported.
To set the timezone, set the TZ environment variable as specified in
http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap08.html
or you may also create an /etc/TZ file of a single line, ending with a
newline, containing the TZ setting. For example
echo CST6CDT > /etc/TZ
''Source: http://www.uclibc.org/downloads/Glibc_vs_uClibc_Differences.txt''

For more information, see how other uClibc-based distributions do this:
* http://leaf.sourceforge.net/doc/buci-tz3.html
* http://www.sonoracomm.com/index.php?option=com_content&task=view&id=107&Itemid=32

For a more complete list of timezones, please see: http://en.wikipedia.org/wiki/List_of_tz_database_time_zones

== OpenNTPD reports an error with "adjtime" ==
Your log contains something like:
reply from 85.214.86.126: offset 865033148.784255 delay 0.055466, next query 32s
reply from 202.150.212.24: offset 865033148.779314 delay 0.400771, next query 3s
adjusting local clock by 865033148.779835s
adjtime failed: Invalid argument

openntpd is supposed to make small adjustments in the time without causing time jumps. If the adjustment is too big then something is clearly wrong and ntpd gives up. (its actually adjtime(3) that has a limit on how big adjustments are allowed)

You can make ntpd set the time at startup by adding ''-s'' option to ntpd. This is done by setting '''NTPD_OPTS="-s"''' in ''/etc/conf.d/ntpd''.

== Using a cron job to keep the time in sync ==
Add the following to ''/etc/periodic/daily'' (or use another folder under the /etc/periodic heirarchy if you want to run the script more/less frequently)

Example: file called ''do-ntp''

: {{cmd|#!/bin/sh}}
: {{cmd|ntpd -d -q -n -p uk.pool.ntp.org}}

This queries the uk time server pool - you can modify this to suit your localisation, or just use ''pool.ntp.org''. More info here: [http://www.pool.ntp.org/zone/@ http://www.pool.ntp.org/zone/@]

= Packages =
== Can you build an apk package for ...? ==
Yes, we probably can. Please create an [http://redmine.alpinelinux.org/projects/alpine/issues/new issue] in the [http://bugs.alpinelinux.org bugtracker]. Mark it as "feature" and include a short description (one-line), an url for the home page, and an url for the source package.

== How can I build my own package? ==
Please see the [[Creating an Alpine package]] page.

= Dynamic DNS =
== How do I schedule a regular dynamic DNS update? ==
You'll want to install the ez-ipupdate package:
apk add ez-ipupdate

After that, create a new file at /etc/ezipupdate.conf with the contents similar to:
service-type=dyndns
user=myusername:mypassword
interface=eth1
host=myhostname.dyndns.org

Make the new ip cache directory:
mkdir /var/cache/ez-ipupdate
lbu add /var/cache/ez-ipupdate

Then schedule a new cron job with this command:
echo >> /var/log/ez-ipupdate && /bin/date >> /var/log/ez-ipupdate && ez-ipupdate --config /etc/ez-ipupdate.conf -f -F /var/run/ez-ipupdate.pid --cache-file /var/cache/ez-ipupdate/ipcache --quiet >> /var/log/ez-ipupdate 2>&1

Don't forget to backup your settings!
lbu ci

Alpine Linux:FAQ

2011-03-23T07:41:46Z

Linker3000: /* OpenNTPD reports an error with "adjtime" */

[[Image:filetypes.svg|64px|left|link=]]
This is a list of '''frequently asked questions''' about Alpine Linux. If your question is not answered on this page, use the search box above to find work in progress pages not linked here, or in case of no answer, edit this page and write down your question.
{{Tip| Prepare your question. Think it through. Make it simple and understandable.}}

=General=

== I have found a bug, where can I report it? ==
You can report it on the [http://bugs.alpinelinux.org/ bugtracker].

== Alpine freezes during boot from Compact Flash, how can I fix? ==
Most Compact Flash card readers do not support proper DMA. You should append '''nodma''' to the ''append'' line in syslinux.cfg.

== How can I contribute? ==
You can contribute by using the software and giving feedback.
You can contribute by documenting your Alpine Linux experiences on this wiki. You can contribute in many other ways. Please visit [[Contribute|Contribute page]] to read more about this topic.

Your contributions are highly appreciated.

== How do I remove the CDROM? ==
Since the modloop loopback device is on CDROM you cannot just run ''eject''. You need to unmount the modloop first. Unmounting both the modloop and the cdrom in one step can be done by executing:
/etc/init.d/modloop stop

Then it's possible to run ''eject'' to eject the cdrom.

== Why don't I have man pages or where is the 'man' command? ==
The 'man' command and man pages are not installed by default.

* First, install the man package:
: {{Cmd|apk add man}}
* Once that's done, install the documentation for the packages that you require man pages for: (Keep in mind, however, it's possible that not all packages will have a corresponding documentation package.)
: {{Cmd|apk add <pkg>-doc}}
: For example, say you installed iptables and you now require its man pages:
: {{Cmd|apk add iptables-doc}}
 
In our example above, we installed the man pages (and other documentation) for iptables. We can now read it:
{{Cmd|man iptables}}

==My cron jobs don't run?==
The cron daemon is started automatically on system boot and executes the scripts placed in the folders under ''/etc/periodic'' - there's a ''15min'' folder, plus ones for ''hourly'', ''daily'', ''weekly'' and ''monthly'' scripts.

You can check whether your scripts are likely to run using the command:

: {{cmd|run-parts -t /etc/periodic/[foldername]}} - for example: run-parts -t /etc/periodic/15min

This command will tell you what should run but will not actually execute the scripts.

If the results of the test are not as expected, check the following:

* Make sure the script is executable - if unsure, issue the command : {{cmd|chmod a+x [scriptname]}}
* Make sure the first line of your script is : {{cmd|#!/bin/sh}}
* Do not put file extensions on your scripts - this stops them from working; for example: ''myscript'' will run, but ''myscript.sh'' won't

=Audio=

== How do I play my .ogg/.mp3 files? ==
First, the sound card should be recognized (you must have /dev/snd/***** files)

sox, mpg321, mpg123, oggplay, etc all use the oss sound driver, while Alpine uses ALSA drivers. So you need to load the snd-pcm-oss compatibility module. While you're at it, you might need aumix to turn up the sound volume

echo snd-pcm-oss >> /etc/modules
modprobe snd-pcm-oss
apk_add aumix sox
aumix (set volume settings)
play really_cool_song.mp3

= Time and timezones =

== How do I set the local timezone? ==

Starting in Alpine 2.2, a setting the timezone will be part of the setup-alpine script. For previous versions, however:

/etc/timezone and the whole zoneinfo directory tree are not supported.
To set the timezone, set the TZ environment variable as specified in
http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap08.html
or you may also create an /etc/TZ file of a single line, ending with a
newline, containing the TZ setting. For example
echo CST6CDT > /etc/TZ
''Source: http://www.uclibc.org/downloads/Glibc_vs_uClibc_Differences.txt''

For more information, see how other uClibc-based distributions do this:
* http://leaf.sourceforge.net/doc/buci-tz3.html
* http://www.sonoracomm.com/index.php?option=com_content&task=view&id=107&Itemid=32

For a more complete list of timezones, please see: http://en.wikipedia.org/wiki/List_of_tz_database_time_zones

== OpenNTPD reports an error with "adjtime" ==
Your log contains something like:
reply from 85.214.86.126: offset 865033148.784255 delay 0.055466, next query 32s
reply from 202.150.212.24: offset 865033148.779314 delay 0.400771, next query 3s
adjusting local clock by 865033148.779835s
adjtime failed: Invalid argument

openntpd is supposed to make small adjustments in the time without causing time jumps. If the adjustment is too big then something is clearly wrong and ntpd gives up. (its actually adjtime(3) that has a limit on how big adjustments are allowed)

You can make ntpd set the time at startup by adding ''-s'' option to ntpd. This is done by setting '''NTPD_OPTS="-s"''' in ''/etc/conf.d/ntpd''.

== Using a cron job to keep the time in sync ==
Add the following to ''/etc/periodic/daily'' (or use another folder if you want to run the script more/less frequently)

Example: file called ''do-ntp''

: {{cmd|#!/bin/sh}}
: {{cmd|ntpd -d -q -n -p uk.pool.ntp.org}}

This queries the uk time server pool - you can modify this to suit your localisation, or just use ''pool.ntp.org''. More info here: [http://www.pool.ntp.org/zone/@ http://www.pool.ntp.org/zone/@]

= Packages =
== Can you build an apk package for ...? ==
Yes, we probably can. Please create an [http://redmine.alpinelinux.org/projects/alpine/issues/new issue] in the [http://bugs.alpinelinux.org bugtracker]. Mark it as "feature" and include a short description (one-line), an url for the home page, and an url for the source package.

== How can I build my own package? ==
Please see the [[Creating an Alpine package]] page.

= Dynamic DNS =
== How do I schedule a regular dynamic DNS update? ==
You'll want to install the ez-ipupdate package:
apk add ez-ipupdate

After that, create a new file at /etc/ezipupdate.conf with the contents similar to:
service-type=dyndns
user=myusername:mypassword
interface=eth1
host=myhostname.dyndns.org

Make the new ip cache directory:
mkdir /var/cache/ez-ipupdate
lbu add /var/cache/ez-ipupdate

Then schedule a new cron job with this command:
echo >> /var/log/ez-ipupdate && /bin/date >> /var/log/ez-ipupdate && ez-ipupdate --config /etc/ez-ipupdate.conf -f -F /var/run/ez-ipupdate.pid --cache-file /var/cache/ez-ipupdate/ipcache --quiet >> /var/log/ez-ipupdate 2>&1

Don't forget to backup your settings!
lbu ci

Alpine Linux:FAQ

2011-03-23T05:59:45Z

Linker3000: /* My cron jobs don't run? */

[[Image:filetypes.svg|64px|left|link=]]
This is a list of '''frequently asked questions''' about Alpine Linux. If your question is not answered on this page, use the search box above to find work in progress pages not linked here, or in case of no answer, edit this page and write down your question.
{{Tip| Prepare your question. Think it through. Make it simple and understandable.}}

=General=

== I have found a bug, where can I report it? ==
You can report it on the [http://bugs.alpinelinux.org/ bugtracker].

== Alpine freezes during boot from Compact Flash, how can I fix? ==
Most Compact Flash card readers do not support proper DMA. You should append '''nodma''' to the ''append'' line in syslinux.cfg.

== How can I contribute? ==
You can contribute by using the software and giving feedback.
You can contribute by documenting your Alpine Linux experiences on this wiki. You can contribute in many other ways. Please visit [[Contribute|Contribute page]] to read more about this topic.

Your contributions are highly appreciated.

== How do I remove the CDROM? ==
Since the modloop loopback device is on CDROM you cannot just run ''eject''. You need to unmount the modloop first. Unmounting both the modloop and the cdrom in one step can be done by executing:
/etc/init.d/modloop stop

Then it's possible to run ''eject'' to eject the cdrom.

== Why don't I have man pages or where is the 'man' command? ==
The 'man' command and man pages are not installed by default.

* First, install the man package:
: {{Cmd|apk add man}}
* Once that's done, install the documentation for the packages that you require man pages for: (Keep in mind, however, it's possible that not all packages will have a corresponding documentation package.)
: {{Cmd|apk add <pkg>-doc}}
: For example, say you installed iptables and you now require its man pages:
: {{Cmd|apk add iptables-doc}}
 
In our example above, we installed the man pages (and other documentation) for iptables. We can now read it:
{{Cmd|man iptables}}

==My cron jobs don't run?==
The cron daemon is started automatically on system boot and executes the scripts placed in the folders under ''/etc/periodic'' - there's a ''15min'' folder, plus ones for ''hourly'', ''daily'', ''weekly'' and ''monthly'' scripts.

You can check whether your scripts are likely to run using the command:

: {{cmd|run-parts -t /etc/periodic/[foldername]}} - for example: run-parts -t /etc/periodic/15min

This command will tell you what should run but will not actually execute the scripts.

If the results of the test are not as expected, check the following:

* Make sure the script is executable - if unsure, issue the command : {{cmd|chmod a+x [scriptname]}}
* Make sure the first line of your script is : {{cmd|#!/bin/sh}}
* Do not put file extensions on your scripts - this stops them from working; for example: ''myscript'' will run, but ''myscript.sh'' won't

=Audio=

== How do I play my .ogg/.mp3 files? ==
First, the sound card should be recognized (you must have /dev/snd/***** files)

sox, mpg321, mpg123, oggplay, etc all use the oss sound driver, while Alpine uses ALSA drivers. So you need to load the snd-pcm-oss compatibility module. While you're at it, you might need aumix to turn up the sound volume

echo snd-pcm-oss >> /etc/modules
modprobe snd-pcm-oss
apk_add aumix sox
aumix (set volume settings)
play really_cool_song.mp3

= Time and timezones =

== How do I set the local timezone? ==

Starting in Alpine 2.2, a setting the timezone will be part of the setup-alpine script. For previous versions, however:

/etc/timezone and the whole zoneinfo directory tree are not supported.
To set the timezone, set the TZ environment variable as specified in
http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap08.html
or you may also create an /etc/TZ file of a single line, ending with a
newline, containing the TZ setting. For example
echo CST6CDT > /etc/TZ
''Source: http://www.uclibc.org/downloads/Glibc_vs_uClibc_Differences.txt''

For more information, see how other uClibc-based distributions do this:
* http://leaf.sourceforge.net/doc/buci-tz3.html
* http://www.sonoracomm.com/index.php?option=com_content&task=view&id=107&Itemid=32

For a more complete list of timezones, please see: http://en.wikipedia.org/wiki/List_of_tz_database_time_zones

== OpenNTPD reports an error with "adjtime" ==
Your log contains something like:
reply from 85.214.86.126: offset 865033148.784255 delay 0.055466, next query 32s
reply from 202.150.212.24: offset 865033148.779314 delay 0.400771, next query 3s
adjusting local clock by 865033148.779835s
adjtime failed: Invalid argument

openntpd is supposed to make small adjustments in the time without causing time jumps. If the adjustment is too big then something is clearly wrong and ntpd gives up. (its actually adjtime(3) that has a limit on how big adjustments are allowed)

You can make ntpd set the time at startup by adding ''-s'' option to ntpd. This is done by setting '''NTPD_OPTS="-s"''' in ''/etc/conf.d/ntpd''.

= Packages =
== Can you build an apk package for ...? ==
Yes, we probably can. Please create an [http://redmine.alpinelinux.org/projects/alpine/issues/new issue] in the [http://bugs.alpinelinux.org bugtracker]. Mark it as "feature" and include a short description (one-line), an url for the home page, and an url for the source package.

== How can I build my own package? ==
Please see the [[Creating an Alpine package]] page.

= Dynamic DNS =
== How do I schedule a regular dynamic DNS update? ==
You'll want to install the ez-ipupdate package:
apk add ez-ipupdate

After that, create a new file at /etc/ezipupdate.conf with the contents similar to:
service-type=dyndns
user=myusername:mypassword
interface=eth1
host=myhostname.dyndns.org

Make the new ip cache directory:
mkdir /var/cache/ez-ipupdate
lbu add /var/cache/ez-ipupdate

Then schedule a new cron job with this command:
echo >> /var/log/ez-ipupdate && /bin/date >> /var/log/ez-ipupdate && ez-ipupdate --config /etc/ez-ipupdate.conf -f -F /var/run/ez-ipupdate.pid --cache-file /var/cache/ez-ipupdate/ipcache --quiet >> /var/log/ez-ipupdate 2>&1

Don't forget to backup your settings!
lbu ci

Alpine Linux:FAQ

2011-03-23T05:52:34Z

Linker3000:

[[Image:filetypes.svg|64px|left|link=]]
This is a list of '''frequently asked questions''' about Alpine Linux. If your question is not answered on this page, use the search box above to find work in progress pages not linked here, or in case of no answer, edit this page and write down your question.
{{Tip| Prepare your question. Think it through. Make it simple and understandable.}}

=General=

== I have found a bug, where can I report it? ==
You can report it on the [http://bugs.alpinelinux.org/ bugtracker].

== Alpine freezes during boot from Compact Flash, how can I fix? ==
Most Compact Flash card readers do not support proper DMA. You should append '''nodma''' to the ''append'' line in syslinux.cfg.

== How can I contribute? ==
You can contribute by using the software and giving feedback.
You can contribute by documenting your Alpine Linux experiences on this wiki. You can contribute in many other ways. Please visit [[Contribute|Contribute page]] to read more about this topic.

Your contributions are highly appreciated.

== How do I remove the CDROM? ==
Since the modloop loopback device is on CDROM you cannot just run ''eject''. You need to unmount the modloop first. Unmounting both the modloop and the cdrom in one step can be done by executing:
/etc/init.d/modloop stop

Then it's possible to run ''eject'' to eject the cdrom.

== Why don't I have man pages or where is the 'man' command? ==
The 'man' command and man pages are not installed by default.

* First, install the man package:
: {{Cmd|apk add man}}
* Once that's done, install the documentation for the packages that you require man pages for: (Keep in mind, however, it's possible that not all packages will have a corresponding documentation package.)
: {{Cmd|apk add <pkg>-doc}}
: For example, say you installed iptables and you now require its man pages:
: {{Cmd|apk add iptables-doc}}
 
In our example above, we installed the man pages (and other documentation) for iptables. We can now read it:
{{Cmd|man iptables}}

==My cron jobs don't run?==
The cron daemon is started automatically on system boot and executes the scripts placed in the folders under ''/etc/periodic'' - there's a ''15min'' folder, plus ones for ''hourly'', ''daily'', ''weekly'' and ''monthly'' scripts.

You can check whether your scripts are likely to run using the command:

: {{cmd|run-parts -t /etc/periodic/[foldername]}} - for example: run-parts -t /etc/periodic/15min

This command will tell you what should run but will not actually execute the scripts.

If the results of the test are not as expected, check the following:

* Make sure the script is executable - if unsure, issue the command : {{cmd|chmod a+x [scriptname]}}
* Do not put file extensions on your scripts - this stops them from working; for example: ''myscript'' will run, but ''myscript.sh'' won't

=Audio=

== How do I play my .ogg/.mp3 files? ==
First, the sound card should be recognized (you must have /dev/snd/***** files)

sox, mpg321, mpg123, oggplay, etc all use the oss sound driver, while Alpine uses ALSA drivers. So you need to load the snd-pcm-oss compatibility module. While you're at it, you might need aumix to turn up the sound volume

echo snd-pcm-oss >> /etc/modules
modprobe snd-pcm-oss
apk_add aumix sox
aumix (set volume settings)
play really_cool_song.mp3

= Time and timezones =

== How do I set the local timezone? ==

Starting in Alpine 2.2, a setting the timezone will be part of the setup-alpine script. For previous versions, however:

/etc/timezone and the whole zoneinfo directory tree are not supported.
To set the timezone, set the TZ environment variable as specified in
http://www.opengroup.org/onlinepubs/007904975/basedefs/xbd_chap08.html
or you may also create an /etc/TZ file of a single line, ending with a
newline, containing the TZ setting. For example
echo CST6CDT > /etc/TZ
''Source: http://www.uclibc.org/downloads/Glibc_vs_uClibc_Differences.txt''

For more information, see how other uClibc-based distributions do this:
* http://leaf.sourceforge.net/doc/buci-tz3.html
* http://www.sonoracomm.com/index.php?option=com_content&task=view&id=107&Itemid=32

For a more complete list of timezones, please see: http://en.wikipedia.org/wiki/List_of_tz_database_time_zones

== OpenNTPD reports an error with "adjtime" ==
Your log contains something like:
reply from 85.214.86.126: offset 865033148.784255 delay 0.055466, next query 32s
reply from 202.150.212.24: offset 865033148.779314 delay 0.400771, next query 3s
adjusting local clock by 865033148.779835s
adjtime failed: Invalid argument

openntpd is supposed to make small adjustments in the time without causing time jumps. If the adjustment is too big then something is clearly wrong and ntpd gives up. (its actually adjtime(3) that has a limit on how big adjustments are allowed)

You can make ntpd set the time at startup by adding ''-s'' option to ntpd. This is done by setting '''NTPD_OPTS="-s"''' in ''/etc/conf.d/ntpd''.

= Packages =
== Can you build an apk package for ...? ==
Yes, we probably can. Please create an [http://redmine.alpinelinux.org/projects/alpine/issues/new issue] in the [http://bugs.alpinelinux.org bugtracker]. Mark it as "feature" and include a short description (one-line), an url for the home page, and an url for the source package.

== How can I build my own package? ==
Please see the [[Creating an Alpine package]] page.

= Dynamic DNS =
== How do I schedule a regular dynamic DNS update? ==
You'll want to install the ez-ipupdate package:
apk add ez-ipupdate

After that, create a new file at /etc/ezipupdate.conf with the contents similar to:
service-type=dyndns
user=myusername:mypassword
interface=eth1
host=myhostname.dyndns.org

Make the new ip cache directory:
mkdir /var/cache/ez-ipupdate
lbu add /var/cache/ez-ipupdate

Then schedule a new cron job with this command:
echo >> /var/log/ez-ipupdate && /bin/date >> /var/log/ez-ipupdate && ez-ipupdate --config /etc/ez-ipupdate.conf -f -F /var/run/ez-ipupdate.pid --cache-file /var/cache/ez-ipupdate/ipcache --quiet >> /var/log/ez-ipupdate 2>&1

Don't forget to backup your settings!
lbu ci

How to configure static routes

2011-03-04T06:22:18Z

Linker3000:

This document describes how to configure persistent static routes in Alpine Linux so that the route definitions survive server reboots.

This process was tested with release 2.1.4, dated 2011-01-07.

First, set the staticroute service to start automatically on boot by entering the following command:

<pre>
rc-update add staticroute
</pre>

You can now define your static routes in one of three ways:

'''Option 1: Edit /etc/conf.d/staticroute'''

Routes are added as a parameter value - the staticroute file has header information that explains the syntax - for example:

<pre>staticroute="net 10.200.200.0 netmask 255.255.255.0 gw 192.168.202.12"
</pre>

If you need to add multiple static routes, just add additional routes to the end of the text between the quotes, with each route separated by a semicolon or a line break (press ENTER).

'''Option 2: Create /etc/route.conf'''

Use nano, vi or your favourite installed editor to create the file /etc/route.conf and add each static route on a separate line - for example:

<pre>
net 10.200.200.0 netmask 255.255.255.0 gw 192.168.200.12
net 10.200.201.0 netmask 255.255.255.0 gw 192.168.200.13
</pre>

''' Option 3: Setup routes in /etc/network/interfaces '''

If you have static network configuration in /etc/network/interfaces, you can add a static route that gets activated when an interface gets brought up:

auto eth0
iface eth0 inet static
address 192.168.0.1
netmask 255.255.255.0
up ip route add 10.14.0.0/16 via 192.168.0.2
up ip route add 192.168.100.0/23 via 192.168.0.3

Once editing is complete, remember to save your changes if you are running the OS in RAM (eg: booting from a USB stick) - if you are not sure how to do this, see this article: [http://5718wiki.gatorfone.com/wikka.php?wakka=KennyAralAlpine How to Boot Alpine Linux and Save Settings on a USB Stick] or [[Alpine_local_backup]]

You can verify your settings by restarting the server, or by issuing the following commands:

To add your defined static routes manually (for testing):

<pre>
/etc/init.d/staticroute start
</pre>

To remove your defined static routes:

<pre>
/etc/init.d/staticroute stop
</pre>

There is a 'restart' option to do an automatic stop/start, but it seems less reliable than using the two above.

How to configure static routes

2011-02-01T12:27:21Z

Linker3000:

This document describes how to configure persistent static routes in Alpine Linux so that the route definitions survive server reboots.

This process was tested with release 2.1.4, dated 2011-01-07.

First, set the staticroute service to start automatically on boot by entering the following command:

<pre>
rc-update add staticroute
</pre>

You can now define your static routes in one of three ways:

'''Option 1: Edit /etc/conf.d/staticroute'''

Routes are added as a parameter value - the staticroute file has header information that explains the syntax - for example:

<pre>staticroute="net 10.200.200.0 netmask 255.255.255.0 gw 192.168.202.12"
</pre>

If you need to add multiple static routes, just add additional routes to the end of the text between the quotes, with each route separated by a semicolon or a line break (press ENTER).

'''Option 2: Create /etc/route.conf'''

Use nano, vi or your favourite installed editor to create the file /etc/route.conf and add each static route on a separate line - for example:

<pre>
net 10.200.200.0 netmask 255.255.255.0 gw 192.168.200.12
net 10.200.201.0 netmask 255.255.255.0 gw 192.168.200.13
</pre>

Once editing is complete, remember to save your changes if you are running the OS in RAM (eg: booting from a USB stick) - if you are not sure how to do this, see this article: [http://5718wiki.gatorfone.com/wikka.php?wakka=KennyAralAlpine How to Boot Alpine Linux and Save Settings on a USB Stick] or [[Alpine_local_backup]]

You can verify your settings by restarting the server, or by issuing the following commands:

To add your defined static routes manually (for testing):

<pre>
/etc/init.d/staticroute start
</pre>

To remove your defined static routes:

<pre>
/etc/init.d/staticroute stop
</pre>

There is a 'restart' option to do an automatic stop/start, but it seems less reliable than using the two above.

''' Option 3: Setup routes in /etc/network/interfaces '''

If you have static network configuration in /etc/network/interfaces, you can add a static route that gets activated when an interface gets brought up:

auto eth0
iface eth0 inet static
address 192.168.0.1
netmask 255.255.255.0
up ip route add 10.14.0.0/16 via 192.168.0.2
up ip route add 192.168.100.0/23 via 192.168.0.3

Error message on boot: Address space collision: host bridge window conflicts with Adaptor ROM

2011-01-24T12:54:26Z

Linker3000:

== Adaptor ROM Conflicts ==

This information relates to error messages such as the one outlined in the page title and other similar ones - for example:

<pre>
pci_root PNP0A08:00: address space collision: host bridge window [mem
0x000cc000-0x000cffff] conflicts with Video ROM [mem 0x000c0000-0x000ce9ff]
</pre>

This error occurs due to the way later 2.6 kernels enumerate adaptor ROMs and is not specific to Alpine Linux - [https://bugzilla.kernel.org/show_bug.cgi?id=16497 see this kernel bug report]. Typical symptoms are computers with multiple NICs not starting all adaptors reliably and issues with multi display/adaptor configurations.

To fix this issue, edit the syslinux.cfg boot file and add '''pci=nocrs''' to the parameters. On systems that boot from a USB memory stick, this file is /media/usb/syslinux.cfg

Example:

<pre>
timeout 20
prompt 1
default grsec
label grsec
kernel /boot/grsec
append pci=nocrs initrd=/boot/grsec.gz alpine_dev=usbdisk:vfat modules=loop,cramfs,sd-mod,usb-storage quiet
</pre>

Error message on boot: Address space collision: host bridge window conflicts with Adaptor ROM

2011-01-24T12:46:57Z

Linker3000: Created page with "== Adaptor ROM Conflicts == This information relates to error messages such as the one outlined in the page title and other similar ones - for example: <pre> pci_root PNP0A08:0..."

== Adaptor ROM Conflicts ==

This information relates to error messages such as the one outlined in the page title and other similar ones - for example:

<pre>
pci_root PNP0A08:00: address space collision: host bridge window [mem
0x000cc000-0x000cffff] conflicts with Video ROM [mem 0x000c0000-0x000ce9ff]
</pre>

This error message relates to the way later 2.6 kernels enumerate adaptor ROMs and is not specific to Alpine Linux - [https://bugzilla.kernel.org/show_bug.cgi?id=16497 see this kernel bug report]

To fix this issue, edit the syslinux.cfg boot file and add '''pci=nocrs''' to the parameters. On systems that boot from a USB memory stick, this file is /media/usb/syslinux.cfg

Example:

<pre>
timeout 20
prompt 1
default grsec
label grsec
kernel /boot/grsec
append pci=nocrs initrd=/boot/grsec.gz alpine_dev=usbdisk:vfat modules=loop,cramfs,sd-mod,usb-storage quiet
</pre>

Tutorials and Howtos

2011-01-24T12:34:40Z

Linker3000: /* Misc */

[[Image:package_edutainment.svg|left|link=]]
{{TOC right}}'''Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.'''
The tutorials are hands-on and the reader is expected to try and achieve the goals described in each step, possibly with the help of a good examples. The output in one step is the starting point for the following step. 
Howtos are smaller articles explaining how to perform a particular task with Alpine Linux. We encourage people to send in both complete articles as well as requesting topics to be covered. If you think you have the skills and knowledge to write an Alpine Linux related article please do so on this Wiki. If you want to request a topic, please add your request in this page [[Talk:Tutorials_and_Howtos|Discussion]].

== Installation ==
* [[Setting up a basic vserver]]
* [[Setting up Logical Volumes with LVM]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[XFCE Setup]]
* [[Enable Serial Console on Boot]]
* [[How to enable APK caching]]
* [[Install Alpine on VirtualBox]]
* [[Upgrading to Edge]]
* [[Setting up a software raid1 array]]
* [[Running Alpine Linux As a QEMU networked Guest ]]
* [[Manually editing a existing apkovl]]

== Networking ==
* [[Configure Networking]]
* [[Howto Configure a Network Bridge]]
* [[Howto Configure static routes]]
* [[Using serial modem]]
* [[Using HSDPA modem]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
* [[Setting up Satellite Internet Connection]]
* [[Connecting to a wireless accesspoint]]

== iSCSI ==
* [[iSCSI Target and Initiator Configuration]]
* [[iSCSI Raid and Clustered File Systems]]
* [[High performance SCST iSCSI Target on Linux software Raid]]

== Network Services ==
* [[Setting Up Lighttpd With FastCGI]]
* [[Setting up a OpenVPN-server with Alpine]]
* [[Setting up Zaptel/Asterisk on Alpine]]
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]
* [[Hosting services on Alpine]] ''(This applies to hosting mail, webservices and other services)''
** [[Setting up postfix with virtual domains]]
** [[Protecting your email server with Alpine]]
** [[Hosting Web/Email services on Alpine]]
* [[Setting up a ssh-server]]
* [[Multiple Instances of Services]]
* [[ISP Mail Server HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-serivce ISP mail server)''
* [[Freepbx on Alpine Linux]]
* [[Apache authentication: NTLM Single Signon]]
* [[Generating SSL certs with ACF]]
* [[Changing passwords for ACF]]
* [[Freeradius Active Directory Integration]]

== Web Applications ==
* [[2600hz]] ''FreeSWITCH, Asterisk GUI web acces tool.''
* [[Awstats]] ''Free log file analyzer.''
* [[Drupal]] ''Content Management System (CMS) written in PHP.''
* [[EyeOS]] ''Cloud Computing Desktop.''
* [[FreePBX_V3]] ''FreeSWITCH, Asterisk GUI web acces tool.''
* [[Glpi]] ''Information Resource-Manager.''
* [[MediaWiki]] ''Free web-based wiki software application''
* [[Phpizabi]] ''Social Networking Platform.''
* [[PhpPgAdmin]] ''Web-based administration tool for PostgreSQL.''
* [[Phpmyadmin]] ''Web-based administration tool for MYSQL.''
* [[Redmine]] ''Project management system''
* [[Statusnet]] ''Microblogging Platform.''
* [[Sqstat]] ''Script to look active squid users connections.''
* [[Webmin]] ''A web-based interface for Linux system.''
* [[WordPress]] ''Web software to create website or blog. ''

== Monitoring ==
* [[Traffic monitoring]] ''(For Alpine Linux firewalls)''
* [[Setting up traffic monitoring using rrdtool (and snmp)]]
* [[Setting up Smokeping]] ''(Smokeping network latency monitoring)''
* [[Setting up Cacti]]
* [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)''
* [[Setting up Zabbix]]
* [[Setting Up Fprobe And Ntop]] ''NetFlow collection and analysis''

== Misc ==
* [[Setting up lm_sensors]]
* [[Formatting HD/Floppy/Other]]
* [[Screen on console]]
* [[Using espeak on Alpine Linux]]
* [[IPTV How To]]
* [[Pllua]]
* [[Error message on boot: Address space collision: host bridge window conflicts with Adaptor ROM]]

== Drafts ==
Those are not finished yet.
* [[AlpineSystem:CoLinux_Setup | Installing Alpine on CoLinux ]]
* [[Using Racoon for Remote Sites]]
* [[High Performance and Fault Tolerant Routing with Alpine Linux]]
* [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)''
** [[Obtaining user information via SNMP]] ''(Using the Squark Squid authentication helper)''
* [[Setting up Streaming an Asterisk Channel]]
* [[Setting up A Network Monitoring and Inventory System]] ''((Nagios + OpenAudit and related components)''
* [[Intrusion Detection using Snort]] ''Installing and configuring Snort and related applications on Alpine 2.0.x''
* [[IP Accounting]] ''Installing and configuring pmacct for IP Accounting, Netflow/sFlow collector''
* [[Howto Setup a Wireless Access Point]] ''Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network''

== Obsolete Docs ==
Those are candidates for rewriting/removal.
* [[Bootstrapping Alpine on Soekris net4xxx]]
* [[Bootstrapping Alpine on PC Engines ALIX.3]]
* [[Setting up a /var partition on software IDE raid1]]
* [[Native Harddisk Install]]
* [[Installing XUbuntu using Alpine boot floppy]]
* [[Setting up trac wiki]]

AlpineSystem:CoLinux Setup

2011-01-24T12:31:42Z

Linker3000:

<pre>
THIS IS A WIP PLEASE LEAVE COMMENTS IN THE DISCUSSIONS PAGE. THANKS
</pre>

== CoLinux ==

CoLinux provides a virtualized Linux environment under Windows, much like Virtual Box or vmware. However there is much less overhead.

use the [ File: Mini_AlpineLinux_2_0_512MB | Alpine mini 512 GB filesystem attached ]

# install coLinux [ File: coLinux-0.7.7.1.exe | coLinux 0.7.7.1 (July 2010) ]
# install [ File: Mini_AlpineLinux_2_0_512MB | Alpine mini 512 GB filesystem attached ]
<pre>
cd C:\Program Files\coLinux
tar xzf coAlpine-2.0.tar.gz
</pre>
# run coAlpine/_start.bat. This will start Alpine 2.0 in a coLinux environment.
# connect console to Alpine colinux-console-nt.exe. This will connect to Alpine.

=== Networking ===
There are three different types of networking:
* slirp - recommend following
<pre>
eth0=slirp,,tcp:22:22/tcp:443:443/tcp:5666:5666
#eth0=pcap-bridge,"Wireless Network Connection",00:43:4F:4E:45:31
</pre>
* set

=== External Devices ===
I like to install packages locally. Can use the Alpine iso and mount.

=== Extra Packages ===

__NOTOC__
__NOEDITSECTION__

How to configure static routes

2011-01-21T15:46:41Z

Linker3000:

This document describes how to configure persistent static routes in Alpine Linux so that the route definitions survive server reboots.

This process was tested with release 2.1.4, dated 2011-01-07.

First, set the staticroute service to start automatically on boot by entering the following command:

<pre>
rc-update add staticroute
</pre>

You can now define your static routes in one of two ways:

'''Option 1: Edit /etc/conf.d/staticroute'''

Routes are added as a parameter value - the staticroute file has header information that explains the syntax - for example:

<pre>staticroute="net 10.200.200.0 netmask 255.255.255.0 gw 192.168.202.12"
</pre>

If you need to add multiple static routes, just add additional routes to the end of the text between the quotes, with each route separated by a semicolon or a line break (press ENTER).

'''Option 2: Create /etc/route.conf'''

Use nano, vi or your favourite installed editor to create the file /etc/route.conf and add each static route on a separate line - for example:

<pre>
net 10.200.200.0 netmask 255.255.255.0 gw 192.168.200.12
net 10.200.201.0 netmask 255.255.255.0 gw 192.168.200.13
</pre>

Once editing is complete, remember to save your changes if you are running the OS in RAM (eg: booting from a USB stick) - if you are not sure how to do this, see this article: [http://5718wiki.gatorfone.com/wikka.php?wakka=KennyAralAlpine How to Boot Alpine Linux and Save Settings on a USB Stick]

You can verify your settings by restarting the server, or by issuing the following commands:

To add your defined static routes manually (for testing):

<pre>
/etc/init.d/staticroute start
</pre>

To remove your defined static routes:

<pre>
/etc/init.d/staticroute stop
</pre>

There is a 'restart' option to do an automatic stop/start, but it seems less reliable than using the two above.

How to configure static routes

2011-01-21T13:03:52Z

Linker3000: Created page with "This document describes how to configure persistent static routes in Alpine Linux so that the route definitions survive server reboots. This process was tested with release 2.1..."

This document describes how to configure persistent static routes in Alpine Linux so that the route definitions survive server reboots.

This process was tested with release 2.1.4, dated 2011-01-07.

First, set the staticroute service to start automatically on boot by entering the following command:

<pre>
rc-update add staticroute
</pre>

You can now define your static routes in one of two ways:

'''Option 1: Edit /etc/conf.d/staticroute'''

Routes are added as a parameter value - the staticroute file has header information that explains the syntax - for example:

<pre>staticroute="net 10.200.200.0 netmask 255.255.255.0 gw 192.168.202.12"
</pre>

If you need to add multiple static routes, just add additional routes to the end of the text between the quotes, with each route separated by a semicolon or a line break (press ENTER).

'''Option 2: Create /etc/route.conf'''

Use nano, vi or your favourite installed editor to create the file /etc/route.conf and add each static route on a separate line - foe example:

<pre>
net 10.200.200.0 netmask 255.255.255.0 gw 192.168.200.12
net 10.200.201.0 netmask 255.255.255.0 gw 192.168.200.13
</pre>

Once editing is complete, remember to save your changes if you are running the OS in RAM (eg: booting from a USB stick) - if you are not sure how to do this, see this article: [http://5718wiki.gatorfone.com/wikka.php?wakka=KennyAralAlpine How to Boot Alpine Linux and Save Settings on a USB Stick]

You can verify your settings by restarting the server, or by issuing the following commands

To add your defined static routes manually (for testing):

<pre>
/etc/init.d/staticroute start
</pre>

To remove your defined static routes:

<pre>
/etc/init.d/staticroute stop
</pre>

There is a 'restart' option to do an automatic stop/start, but it seems less reliable than using the two above.

Tutorials and Howtos

2011-01-21T12:22:28Z

Linker3000: /* Networking */

[[Image:package_edutainment.svg|left|link=]]
{{TOC right}}'''Welcome to Tutorials and Howtos, a place of basic and advanced configuration tasks for your Alpine Linux.'''
The tutorials are hands-on and the reader is expected to try and achieve the goals described in each step, possibly with the help of a good examples. The output in one step is the starting point for the following step. 
Howtos are smaller articles explaining how to perform a particular task with Alpine Linux. We encourage people to send in both complete articles as well as requesting topics to be covered. If you think you have the skills and knowledge to write an Alpine Linux related article please do so on this Wiki. If you want to request a topic, please add your request in this page [[Talk:Tutorials_and_Howtos|Discussion]].

== Installation ==
* [[Setting up a basic vserver]]
* [[Setting up Logical Volumes with LVM]]
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[XFCE Setup]]
* [[Enable Serial Console on Boot]]
* [[How to enable APK caching]]
* [[Install Alpine on VirtualBox]]
* [[Upgrading to Edge]]
* [[Setting up a software raid1 array]]
* [[Running Alpine Linux As a QEMU networked Guest ]]
* [[Manually editing a existing apkovl]]

== Networking ==
* [[Configure Networking]]
* [[Howto Configure a Network Bridge]]
* [[Howto Configure static routes]]
* [[Using serial modem]]
* [[Using HSDPA modem]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
* [[Setting up Satellite Internet Connection]]
* [[Connecting to a wireless accesspoint]]

== iSCSI ==
* [[iSCSI Target and Initiator Configuration]]
* [[iSCSI Raid and Clustered File Systems]]
* [[High performance SCST iSCSI Target on Linux software Raid]]

== Network Services ==
* [[Setting Up Lighttpd With FastCGI]]
* [[Setting up a OpenVPN-server with Alpine]]
* [[Setting up Zaptel/Asterisk on Alpine]]
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]
* [[Hosting services on Alpine]] ''(This applies to hosting mail, webservices and other services)''
** [[Setting up postfix with virtual domains]]
** [[Protecting your email server with Alpine]]
** [[Hosting Web/Email services on Alpine]]
* [[Setting up a ssh-server]]
* [[Multiple Instances of Services]]
* [[ISP Mail Server HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-serivce ISP mail server)''
* [[Freepbx on Alpine Linux]]
* [[Apache authentication: NTLM Single Signon]]
* [[Generating SSL certs with ACF]]
* [[Changing passwords for ACF]]
* [[Freeradius Active Directory Integration]]

== Web Applications ==
* [[2600hz]] ''FreeSWITCH, Asterisk GUI web acces tool.''
* [[Awstats]] ''Free log file analyzer.''
* [[Drupal]] ''Content Management System (CMS) written in PHP.''
* [[EyeOS]] ''Cloud Computing Desktop.''
* [[FreePBX_V3]] ''FreeSWITCH, Asterisk GUI web acces tool.''
* [[Glpi]] ''Information Resource-Manager.''
* [[MediaWiki]] ''Free web-based wiki software application''
* [[Phpizabi]] ''Social Networking Platform.''
* [[PhpPgAdmin]] ''Web-based administration tool for PostgreSQL.''
* [[Phpmyadmin]] ''Web-based administration tool for MYSQL.''
* [[Redmine]] ''Project management system''
* [[Statusnet]] ''Microblogging Platform.''
* [[Sqstat]] ''Script to look active squid users connections.''
* [[Webmin]] ''A web-based interface for Linux system.''
* [[WordPress]] ''Web software to create website or blog. ''

== Monitoring ==
* [[Traffic monitoring]] ''(For Alpine Linux firewalls)''
* [[Setting up traffic monitoring using rrdtool (and snmp)]]
* [[Setting up Smokeping]] ''(Smokeping network latency monitoring)''
* [[Setting up Cacti]]
* [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)''
* [[Setting up Zabbix]]
* [[Setting Up Fprobe And Ntop]] ''NetFlow collection and analysis''

== Misc ==
* [[Setting up lm_sensors]]
* [[Formatting HD/Floppy/Other]]
* [[Screen on console]]
* [[Using espeak on Alpine Linux]]
* [[IPTV How To]]
* [[Pllua]]

== Drafts ==
Those are not finished yet.
* [[AlpineSystem:CoLinux_Setup | Installing Alpine on CoLinux ]]
* [[Using Racoon for Remote Sites]]
* [[High Performance and Fault Tolerant Routing with Alpine Linux]]
* [[Setting up Transparent Squid Proxy]] ''(Covers Squid proxy and URL Filtering system)''
** [[Obtaining user information via SNMP]] ''(Using the Squark Squid authentication helper)''
* [[Setting up Streaming an Asterisk Channel]]
* [[Setting up A Network Monitoring and Inventory System]] ''((Nagios + OpenAudit and related components)''
* [[Intrusion Detection using Snort]] ''Installing and configuring Snort and related applications on Alpine 2.0.x''
* [[IP Accounting]] ''Installing and configuring pmacct for IP Accounting, Netflow/sFlow collector''
* [[Howto Setup a Wireless Access Point]] ''Setting up Secure Wireless AP w/ WPA encryption with bridge to wired network''

== Obsolete Docs ==
Those are candidates for rewriting/removal.
* [[Bootstrapping Alpine on Soekris net4xxx]]
* [[Bootstrapping Alpine on PC Engines ALIX.3]]
* [[Setting up a /var partition on software IDE raid1]]
* [[Native Harddisk Install]]
* [[Installing XUbuntu using Alpine boot floppy]]
* [[Setting up trac wiki]]