Alpine Linux - User contributions [en]

Local APK cache

2012-02-19T22:08:14Z

Rxbrdn: grammar

Alpine Linux needs to be able to pull packages from local media on boot. (You can't download packages from the net before you have a network connection.) Using remote repositories presents a problem. If the config files have been modified for a newer version of a package, and the older package is on local media, all sorts of fun can result.

The solution is a local cache of updated packages. This cache can be stored on any r/w media, typically the same location as the apkovl.

The cache is enabled by creating a symlink named ''/etc/apk/cache'' that points to the cache directory.

To enable local cache run: {{Cmd|setup-apkcache}}

= To enable Local Cache on releases prior v2.3 =
Alpine Linux version prior to v2.3 does not have the ''setup-apkcache'' tool so the symlink needs to be set up manually.

== To Manually Enable Local Cache on HDD install ==
If you've installed Alpine to your hard drive (as 'sys'), then create a cache dir and then an ''/etc/apk/cache'' symlink pointing to that dir:
{{Cmd|mkdir -p /var/cache/apk
ln -s /var/cache/apk /etc/apk/cache}}

You normally don't need apk cache on HDD 'sys' installs but it might be handy if you re-install from net to have the packages cached.

== To Manually Enable Local Cache on run-from-RAM installs ==

# Create a '''cache''' directory on the device you store your lbu backups (typically, <code>/dev/sda1</code>.) {{Cmd| mkdir /media/sda1/cache }}
{{Tip|If you get an error that says "mkdir: can't create directory '/media/usbdisk/cache': Read-only file system", then you probably need to remount your disk read-write temporarily. Try {{Cmd|mount -o remount,rw /media/sda1}} and then don't forget to run {{Cmd|mount -o remount,ro /media/sda1}} when you are done with the following commands}}
# Create a symlink to this directory from <code>/etc/apk/cache</code>. {{Cmd|ln -s /media/sda1/cache /etc/apk/cache}}
# Run an lbu commit to save the change (<code>/etc/apk/cache</code> is in <code>/etc</code> and is automatically backed up.) {{Cmd|lbu commit}}
# Done. Now whenever you run an apk command that pulls a new package from a remote repository, The package is stored on your local media. On startup, Alpine Linux will check the local cache for new packages, and will install them in preference.

So you now have a run-from-RAM distro that can do a '''yum upgrade''' or '''apt-get dist-upgrade'''

= Cache Maintenance =
Over time, newer packages will replace older ones; the cache directory will contain all older versions of packages.

== Delete Old Packages ==
To clean out older versions of packages, run the '''clean''' command. {{cmd|apk cache clean}} or to see what is deleted {{cmd|apk -v cache clean}}

== Download Missing Packages ==
If you accidentally delete packages from the cache directory, you can make sure they are there with the '''download''' command, {{cmd|apk cache download}}

== Delete and Download In One Step ==
You can combine the two steps into one with the '''sync''' command - this cleans out old packages and downloads missing packages. {{cmd|apk cache -v sync}}

== Automatically Cleaning Cache on Reboot ==
To automatically attempt to validate your cache on reboot, you can add the above command to the <code>/etc/conf.d/local</code> script, in the <code>stop</code> stanza:

local_stop() {
# This is a good place to unload any misc.
# programs you started above.

# verify the local cache on shutdown
apk cache -v sync

# We should always return 0
return 0
}

{{Tip|Usually the only time you need to reboot is when things have gone horribly wrong; so this is a "best effort" to cover forgetting to sync the cache; It is much better to run '''sync''' immediately after adding or upgrading packages.}}

Alpine Linux:Wiki etiquette

2012-02-19T21:37:49Z

Rxbrdn: /* Basic Principles */ grammar

== Basic Principles ==
* Assume good faith. Comply with etiquette ethics. Alpine Linux Wiki has worked remarkably well so far based on a policy of nearly complete freedom to edit. People come here to collaborate and write good articles.
* Remember the Golden Rule: Treat others as you would have them treat you—even if they are new. We were all new once.
* Be polite, please.
** Keep in mind that raw text may be ambiguous and often seems ruder than the same words coming from a person standing in front of you. Irony is not always obvious when written—text comes without facial expressions, vocal inflection, or body language. Be careful in choosing the words you write: what you mean might not be what others understand. Be careful of how you interpret what you read: what you understand might not be what the writer means.
* Sign and date your posts to talk pages (not articles!), unless you have some excellent reasons not to do so.
* Work towards agreement.
* Argue facts, not personalities.
* Do not ignore questions.
** If another disagrees with your edit, provide good reasons why you think that it is appropriate.
* Concede a point when you have no response to it, or admit when you disagree based on intuition or taste.
* Be civil.
** Although it is understandably difficult in an intense argument, if other editors are not as civil as you would like them to be, be ''more'' civil than they are, not less. That way at least you are not moving towards open conflict and name-calling; by your own action you are actively doing something about it: take a hit and refrain from hitting back—everybody appreciates that (or at least they should).
** However, do not hesitate to let the other person know that you are not comfortable with their tone in a neutral way—otherwise they might think that you are too dense to understand their "subtlety", and you will involuntarily encourage them (e.g., "I know that you have been sarcastic above, but I do not think that is helping us resolve the issue. However, I do not think that your argument stands because ...").
* Be prepared to apologize. In animated discussions, we often say things we later wish we had not. Say so.
* Forgive and forget.
* Recognize your own biases, and keep them in check.
* Give praise when due. Everybody likes to feel appreciated, especially in an environment that often requires compromise. Drop a friendly note on users' talk pages.
* Remove or summarize resolved disputes that you initiated.
* Help mediate disagreements between others.
* If you are arguing, take a break. If you are mediating, recommend a break.
** Take it slowly. If you are angry, spend time away from Wikipedia instead of posting or editing. Come back in a day or a week. You may find that someone else made the desired change or comment for you. If you think mediation is needed, enlist someone.
* Avoid reverts whenever possible, and stay within the three-revert rule except in cases of clear vandalism. Explain reversions in the edit summary box.
** Amend, edit, discuss.
* Remind yourself that these are ''people'' with whom you are dealing. They have feelings, and probably have other people in the world who love them. Try to treat others with dignity. The world is a big place, with different cultures and conventions. Do not use jargon that others might not understand. Use acronyms carefully and clarify if there is the possibility of any doubt.
* When reverting other people's edits, give a rationale for the revert (on the article's talk page, if necessary), and be prepared to enter into an extended discussion over the edits in question. Calmly explaining your thinking to others can often result in their agreeing with you.

== Other words of advice ==
* Be open and warmly welcoming, not insular,
* Be focused single-mindedly on writing an encyclopedia, not on [[IRC|Usenet]]-style debate,
* Recognize and praise the best work: work that is detailed, factual, well-informed, and well-referenced,
* Work to understand what neutrality requires, and why it is so essential to and good for this project,
* Treat your fellow productive, well-meaning members of Alpine Linux with respect and good will,
* Attract and honor good people who know a lot and can write about it well, and
* Show the door to trolls, vandals, and wiki-anarchists who, if permitted, would waste your time and create a poisonous atmosphere here.

How to write a HOWTO

2012-02-19T21:31:52Z

Rxbrdn: /* Writing the HOWTO */

If you are reading this, it probably means you are interested in contributing a Howto or Tutorial to Alpine Linux Wiki. This is great! Just follow those simple steps and you will end up with a great howto in no time.

=Writing the HOWTO=
Know your readers and what you are trying to tell them to do.
#Login to Alpine Linux Wiki.{{tip|If you have never logged in, click the Log in / create account on the top-right, and then click the Create an account link.}}
#Edit any Alpine Linux Wiki page, adding a link to your new, not yet existent page: <nowiki>[[How To Write A HOWTO]]</nowiki>
#Click the link, [[Sandbox:How to write a HOWTO|How to write a HOWTO]].<br/>''Alpine Linux Wiki opens the new page for editing.''
#Paste the '''Basic HOWTO Template''' into your new HOWTO.
#Follow the instructions in the template.

=Learn to format Wiki text as you write:=
*By reading the Text Formatting Rules
*By clicking the Edit page button on Alpine Linux Wiki articles to read the source
*By experimenting
=Basic HOWTO Template=

A WikiText skeleton of a basic HOWTO:
=How To Do Something=

Summarize your article here so readers can decide
quickly whether to read it.

=Before You Start Title=
Your readers might need to get ready before they can do the work.
If so explain those prerequisites first. This section might alternatively
contain background information readers need to know before they can make
sense of your example or carry out your instructions.

=Doing Something Title=
Write the steps of how to do something in this section.
If possible, show an example first, then tell your readers the steps.
Break this procedure into separate procedures to avoid more than
about 7-9 steps per procedure.

INSERT GREAT EXAMPLE HERE

#Answer the following three questions, at least in your head.
##What do I explain how to do?
##How do I do that?
##What do HOWTO readers already know about doing that?
#Write up a good example. This ensures you can do it.
#Write up the steps to do it.
#Write the background info/prerequisites readers need.
#Write the summary.
#Clean up your work.
#Revise, revise, revise.

=See Also=
If you ought to point your readers to related information
they no doubt need but that does not fit in your HOWTO, add links here.

=See Also=
*[[Text Formatting Rules]]
*[[Wiki Etiquette]]
*[[Alpine Linux Wiki templates]]

How to write a HOWTO

2012-02-19T21:31:13Z

Rxbrdn:

If you are reading this, it probably means you are interested in contributing a Howto or Tutorial to Alpine Linux Wiki. This is great! Just follow those simple steps and you will end up with a great howto in no time.

=Writing the HOWTO=
Know your readers and what you are trying to tell them how to do.
#Login to Alpine Linux Wiki.{{tip|If you have never logged in, click the Log in / create account on the top-right, and then click the Create an account link.}}
#Edit any Alpine Linux Wiki page, adding a link to your new, not yet existent page: <nowiki>[[How To Write A HOWTO]]</nowiki>
#Click the link, [[Sandbox:How to write a HOWTO|How to write a HOWTO]].<br/>''Alpine Linux Wiki opens the new page for editing.''
#Paste the '''Basic HOWTO Template''' into your new HOWTO.
#Follow the instructions in the template.
=Learn to format Wiki text as you write:=
*By reading the Text Formatting Rules
*By clicking the Edit page button on Alpine Linux Wiki articles to read the source
*By experimenting
=Basic HOWTO Template=

A WikiText skeleton of a basic HOWTO:
=How To Do Something=

Summarize your article here so readers can decide
quickly whether to read it.

=Before You Start Title=
Your readers might need to get ready before they can do the work.
If so explain those prerequisites first. This section might alternatively
contain background information readers need to know before they can make
sense of your example or carry out your instructions.

=Doing Something Title=
Write the steps of how to do something in this section.
If possible, show an example first, then tell your readers the steps.
Break this procedure into separate procedures to avoid more than
about 7-9 steps per procedure.

INSERT GREAT EXAMPLE HERE

#Answer the following three questions, at least in your head.
##What do I explain how to do?
##How do I do that?
##What do HOWTO readers already know about doing that?
#Write up a good example. This ensures you can do it.
#Write up the steps to do it.
#Write the background info/prerequisites readers need.
#Write the summary.
#Clean up your work.
#Revise, revise, revise.

=See Also=
If you ought to point your readers to related information
they no doubt need but that does not fit in your HOWTO, add links here.

=See Also=
*[[Text Formatting Rules]]
*[[Wiki Etiquette]]
*[[Alpine Linux Wiki templates]]

EyeOS

2012-02-19T21:29:40Z

Rxbrdn: /* Config your eyeos */

eyeOS is an open source web desktop following the cloud computing concept that leverages collaboration and communication among users. It is mainly written in PHP, XML, and JavaScript. It acts as a platform for web applications written using the eyeOS Toolkit. It includes a Desktop environment with 67 applications and system utilities

= Set up eyeOS on Alpine Linux =

This document will be a quick c/p guide to setup eyeOS on Alpine linux. What we will setup is the following:

* Lighttpd with PHP
* eyeOS

= Install lighttpd, and PHP =

{{:Setting Up Lighttpd With FastCGI}}

= Installing and configuring eyeOS =
Make webapps folder

{{Cmd|mkdir /usr/share/webapps/ -p}}

Download previous version:

{{Cmd|cd /usr/share/webapps/
wget http://sourceforge.net/projects/eyeos/files/eyeos/1.9.0.1/eyeOS_1.9.0.1.zip/download}}

Unpack and delete zip file

{{Cmd|unzip download
rm download}}

Also you can download latest version:

{{Cmd|cd /usr/share/webapps/
wget http://sourceforge.net/projects/eyeos/files/eyeos2/eyeos-2.5.tar.gz/download}}

Unpack and delete tar.gz file

{{Cmd|cd /usr/share/webapps/
tar -xvzf download}}

Change Folder Persmissions

{{Cmd|chmod -R 777 /usr/share/webapps/eyeOS/}}

Make symlinks to eyeOS

{{Cmd|ln -s /usr/share/webapps/eyeOS/ /var/www/localhost/htdocs/eyeos}}

Unpack main package

{{Cmd|cd /usr/share/webapps/eyeOS/
mv /usr/share/webapps/eyeOS/package.eyepackage /usr/share/webapps/eyeOS/package.tar.gz
tar zxvf /usr/share/webapps/eyeOS/package.tar.gz}}

== Starting ==

Starting http service and adding to boot

{{Cmd|/etc/init.d/lighttpd start && rc-update add lighttpd default}}

== Config your eyeos ==
Browse to: http://WEBSERVER_IP_ADDRESS/eyeos

Please fill out the following form to install eyeOS:

Root Password
Retype Password
System Name
Allow users to create accounts

When you finish, press "Install eyeOS!" button, and thats all. :)
You have eyeOS cloud computing system working. To access it, go to http://WEBSERVER_IP_ADDRESS/eyeOS and enjoy!

Tutorials and Howtos

2012-02-19T21:22:43Z

Rxbrdn:

[[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 example. The output in one step is the starting point for the following step.<br/>
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]].

=System=
==Initial setup==
* [[Setting up a basic vserver]]
* [[Alpine Linux package management#Local_Cache | How to enable APK caching]]
* [[Enable Serial Console on Boot]]
* [[Upgrading to Edge]]
==Storage==
* [[Setting up Logical Volumes with LVM]]
* [[Setting up a software raid1 array]]
* [[iSCSI Target and Initiator Configuration]]
* [[iSCSI Raid and Clustered File Systems]]
* [[High performance SCST iSCSI Target on Linux software Raid]]
==Networking==
* [[Configure Networking]]
* [[Howto Configure a Network Bridge]]
* [[Howto Configure static routes]]
* [[Using serial modem]]
* [[Using HSDPA modem]]
* [[Setting up Satellite Internet Connection]]
* [[Connecting to a wireless accesspoint]]
* [[Using Alpine on Windows domain with IPSEC isolation]]
==Desktop Environment==
* [[XFCE Setup]]
* [[Gnome Setup]]
==Misc==
* [[Manually editing a existing apkovl]]
* [[Changing passwords for ACF]]
* [[Formatting HD/Floppy/Other]]
* [[Back Up a Flash Memory Installation]]

=Applications=
==Networking==
* [[Setting up a OpenVPN-server with Alpine]]
* [[Setting up a ssh-server]]
* [[Generating SSL certs with ACF]]
* [[Setting up traffic monitoring using rrdtool (and snmp)]]
* [[Setting up unbound DNS server]]
* [[Setting up nsd DNS server]]
* [[Setting up a git repository server with gitolite and cgit]]

==VoIP==
* [[Setting up Zaptel/Asterisk on Alpine]]
* [[Freepbx on Alpine Linux]]
==Web==
* [[Cherokee]]
* [[Setting Up Lighttpd With FastCGI]]
* [[Apache authentication: NTLM Single Signon]]
===Webapps===
* [[2600hz]] ''FreeSWITCH, Asterisk GUI web acces tool.''
* [[Awstats]] ''Free log file analyzer.''
* [[Setting up Cacti|Cacti]]
* [[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''
* [[Setting Up Fprobe And Ntop|Ntop]] ''NetFlow collection and analysis using a remote fprobe instance''
* [[Pastebin]] ''Pastebin software application''
* [[Phpizabi]] ''Social Networking Platform.''
* [[PhpPgAdmin]] ''Web-based administration tool for PostgreSQL.''
* [[Phpmyadmin]] ''Web-based administration tool for MYSQL.''
* [[Piwik]] ''A real time web analytics software program.''
* [[Phpsysinfo]] ''A simple application that displays information about the host it's running on''
* [[Redmine]] ''Project management system ''
* [[Request-Tracker]] ''Ticket system''
* [[Roundcube]] ''Webmail system''
* [[Setting up Smokeping|Smokeping]] ''Network latency monitoring''
* [[Statusnet]] ''Microblogging Platform.''
* [[Sqstat]] ''Script to look active squid users connections.''
* [[Setting up trac wiki|Trac]] ''Enhanced wiki and issue tracking system for software development projects.''
* [[Webmin]] ''A web-based interface for Linux system.''
* [[WordPress]] ''Web software to create website or blog. ''
* [[Setting up Zabbix|Zabbix]]

==Mail==
* [[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]]
==Misc==
* [[Multiple Instances of Services]]
* [[Setting up Transmission (bittorrent) with Clutch WebUI]]
* [[Freeradius Active Directory Integration]]
* [[Traffic monitoring]] ''(For Alpine Linux firewalls)''
* [[Setting up NRPE daemon]] ''(Performs remote Nagios checks)''
* [[Setting up lm_sensors]]
* [[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]]
=Complete Solutions=
* [[Replacing non-Alpine Linux with Alpine remotely]]
* [[Fault Tolerant Routing with Alpine Linux]]
* [[ISP Mail Server HowTo]] ''(Postfix+PostfixAdmin+DoveCot+Roundcube+ClamAV+Spamd - A full-serivce ISP mail server)''
** [[ISP Mail Server Upgrade 2.x]]
** [[ISP Mail Server 2.x HowTo]] ''(Beta, please test)''
* [[High Availability High Performance Web Cache]] ''uCarp + HAProxy for High Availability Services such as Squid web proxy''
= Drafts =
Currently unfinished docs.
* [[Install Alpine on coLinux]]
* [[Using Racoon for Remote Sites]]
* [[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''
* [[Xen Dom0]] ''Setting up Alpine as a dom0 for Xen hypervisor''
* [[Disk Replication with DRBD]]

= Obsolete Docs =
Those are candidates for rewriting/removal.
* [[Bootstrapping Alpine on Soekris net4xxx]]
* [[Bootstrapping Alpine on PC Engines ALIX.3]]
* [[Installing XUbuntu using Alpine boot floppy]]