Merge branch 'master' of web-redpill@coreander:public_websites/source.redpill.dk/support_content

13 files changed, 417 insertions, 0 deletions

diff --git a/address/commands.mdwn b/address/commands.mdwn
new file mode 100644
index 0000000..49eecca
--- /dev/null
+++ b/address/commands.mdwn
@@ -0,0 +1,2 @@
+# Directory services maintainance commands
+
diff --git a/address/setup.mdwn b/address/setup.mdwn
new file mode 100644
index 0000000..86242a2
--- /dev/null
+++ b/address/setup.mdwn
@@ -0,0 +1,67 @@
+# Setting up and using central addresses
+
+## Looking up addresses
+
+### Web access
+
+ * Public search page
+
+ * Horde webmail
+
+### Desktop applications
+
+ * Mozilla Thunderbird
+
+### Cell phone
+
+ * SMS lookup
+
+## Adding and editing
+
+### Web access
+
+ * Horde webmail
+
+### Desktop applications
+
+ * Directory assistant (Linux, MacOS w/ X11)
+
+## Exchanging data
+
+### Importing addresses
+
+#### Well-structured address databases
+
+Some address book applications can export entries as an LDIF file.
+This often means the data is well-structured and easy to feed into the central database.
+
+Import of LDIF files is supported from the following applications:
+
+ * Mozilla Thunderbird
+
+If you use a different application and it can export LDIF files, then try if it works.
+Tell us your experiences, so we can (maybe improve the import routines and) add it to this list.
+
+#### Other sources
+
+For applications that cannot export LDIF, first feed the data into an application that does,
+and then import from there.
+
+Here's a possible recipe for a list of addresses stored in an Excel spreadsheet:
+
+ 1. Remove noise (eg. non-tabular comments)
+ 2. Export as comma-separated file
+   * Use "Western european (ISO-8859-1)" as character codepage (not Unicode)
+ 3. Open Mozilla Thunderbird, and select "Import..." from the Tools menu
+ 4. Import addressbook, choose "Comma Separated" and open the exported data file
+ 5. Match Address Book fields with records to import
+   * Use "Display Name" as full name, if first and last name was not previously stored separately
+   * Use company fields for company info, if each previous record contained both company and contact person info
+   * Use custom fields for custom data (avoid reusing standard fields for new purposes!)
+ 6. Review the imported data now stored in a new Address Book
+   * Re-import if not satisfied: The field matching is remembered from last import
+ 7. Edit entries as needed
+   * Each personal entry *must* contain both first name and last name
+   * Each company-only entry must contain *no* personal data
+
+### Two-way syncronization
diff --git a/address/timeline.mdwn b/address/timeline.mdwn
new file mode 100644
index 0000000..1c32879
--- /dev/null
+++ b/address/timeline.mdwn
@@ -0,0 +1,26 @@
+# Timeline of (planned and effectuated) events relate to central address handling
+
+## TODO
+
+ * Public addressbook lookup through raw LDAP interface
+ * User-friendly access to public addressbook
+  * Integration with HORDE webmail framework
+  * Integration with Mozilla Thunderbird (documentation and possibly semi-automation)
+  * Web lookup page
+  * Wap lookup page
+  * SMS lookup routine
+ * Shared addressbooks for closed groups
+ * User-friendly access to shared addressbooks
+  * Integration with HORDE webmail framework
+  * Integration with Mozilla Thunderbird (documentation and possibly semi-automation)
+  * Web lookup page
+  * Wap lookup page
+  * SMS lookup routine
+ * Personal addressbooks (both discrete and public accessible)
+ * Semi-automated import (batch-adding) entries
+ * User-friendly access to adding and editing entries
+  * Integration with HORDE webmail framework
+  * Desktop apps (integration with system tools, use of generic tools, or design of custom tools)
+  * Web administration tool
+  * SMS add/overwrite routine
+ * Two-way syncronization with other personal (and shared?) directory databases
diff --git a/files.mdwn b/files.mdwn
new file mode 100644
index 0000000..ce2f843
--- /dev/null
+++ b/files.mdwn
@@ -0,0 +1,15 @@
+# Overview of file sharing info
+
+Each user [[account]] provides access to personal and shared files.
+
+
+## Setup
+
+ * Short [[files/intro]] to accessing file shares
+ * [[Configuration|files/setup]] more detailed
+
+
+## Use
+
+ * The file shares are restricted by a disk [[quota]]
+ * [[Problem]] reporting
diff --git a/files/intro.mdwn b/files/intro.mdwn
new file mode 100644
index 0000000..afc288d
--- /dev/null
+++ b/files/intro.mdwn
@@ -0,0 +1,32 @@
+# Introduction to filesharing
+
+Your account provides access to file shares. Some personal shares and
+some shares common to the groups you are member of.
+
+
+## Access from Macintosh
+
+ 1. Change to the application "Finder" (switch to the desktop)
+ 2. Choose "Go" from the menu, and then "Connect to server..." at the bottom
+ 3. Type in the server address (ask your technicians for the hostname)
+ 3. Provide your username and password
+ 4. Choose the file shares to use
+
+
+## Access from Windows
+
+ 1. Download and install the application [WinSCP](http://winscp.org/)
+ 2. Start the application "WinSCP"
+ 3. Type in the server address (ask your technicians for the hostname), and
+    your username and password
+ 4. Work only in the supfolders containing normal documents!
+
+/!\ Contact your technicians if you need access to **shared** documents from
+Windows, as it requires a few adjustments on the server.
+
+
+## More info
+
+ * [[Setup]] more detailed.
+ * [[Overview|files]] of filesharing info.
+ * [[Overview|account]] of possibilities with your account.
diff --git a/files/setup.mdwn b/files/setup.mdwn
new file mode 100644
index 0000000..aaddcac
--- /dev/null
+++ b/files/setup.mdwn
@@ -0,0 +1,75 @@
+# Filesharing setup
+
+[[File_shares|intro]] is accessible in different ways. Via the
+Macintosh-friendly **afp** or the more generic **sftp**.
+
+
+## Macintosh-friendly access (afp)
+
+The easiest method is using the "Apple Filesharing Protocol", **afp**.
+It is integrated in both MacOS X and the older MacOS Classic, and provides
+separate access to each personal and group share.
+
+
+ 1. Open filesharing:
+   * With MacOS X choose "Connect to server..." from the desktop.
+   * With MacOS Classic choose "AppleShare" from "Chooser" in the apple
+     menu.
+
+ 2. Connect to the server (ask your technicians for the hostname)
+
+ 3. Log on using your personal access info, and choose the file shares
+    you want bound to your machine.
+
+Alternatively in some cases, e.g. with the MacOS X web-browser Safari,
+you can double-click the address if written with "afp://" in front of the
+hostname.
+
+When finished using the shares, "eject" it by dropping it in the trash
+can.
+
+
+## General access (sftp)
+
+Windows and Linux unfortunately cannot (in a simple way) use afp, and
+their own similar builtin methods are either too insecure (ftp, nfs) or
+problematic to get to work through the Internet (smb).
+
+The alternative SSH-based **sftp** works on all three platforms with a helper
+application installed:
+
+ 1. Use an sftp application:
+    * With Windows the Free Software application
+      [WinSCP](http://winscp.org/) is recommended.
+    * With MacOS X the Free Software application
+      [Fugu](http://rsug.itd.umich.edu/software/fugu/) is recommended.
+    * With MacOS X for terminal use you can use the builtin command line
+      tool "sftp".
+    * With MacOS Classic you can use the shareware application
+      [MacSFTP](http://pros.orange.fr/chombier/MacSFTP/SFTP_info.html)
+    * With Linux on X11 desktop, both Gnome and KDE have sftp support builtin.
+    * With Linux on a text terminal, the application "Midnight Commander" (the
+      command "mc") is recommended.
+
+ 2. Type in the server address (ask your technicians for the hostname), and
+    your personal access info.
+
+Alternatively your can in some cases double-click the address if written with
+"sftp://" in front of the hostname.
+
+/!\ Sftp provides access to all of your personal account, without any
+userfriendly wrapping. Avoid moving around folders and files you do not
+know what is. For example the "Maildir" folder, containing all of your
+emails.
+
+Sftp only provides access to your personal account. With some adjustment
+on the server you can also be granted access to some types of group
+shares as well. If you can only access personal file shares using sftp, and you
+need access to group shares too, then please tell your technicians to adjust
+your access on the server.
+
+
+## More info
+
+ * [[Overview|files]] of filesharing info.
+ * [[Overview|account]] of possibilities with your account.
diff --git a/quota.mdwn b/quota.mdwn
new file mode 100644
index 0000000..3f0f3cd
--- /dev/null
+++ b/quota.mdwn
@@ -0,0 +1,5 @@
+# Overview of disk quota documentation
+
+ * Short [[quota/intro]] to disk quota
+ * [[Use|quota/use]] of disk quota - eg. hints to freeing disk space
+ * [[Configuration|quota/setup]] to continuously show current disk quota status
diff --git a/quota/intro.mdwn b/quota/intro.mdwn
new file mode 100644
index 0000000..19d6240
--- /dev/null
+++ b/quota/intro.mdwn
@@ -0,0 +1,17 @@
+# Introduction to disk quota
+
+Your account has limited disk space. All of your personal files and emails have
+a sharing maximum.
+
+You will automatically receive email warnings if you reach your "quota" limit.
+You will then need to delete either some of your personal files or some of your
+emails.
+
+/!\ If you ignore quota warnings, then your account will be locked, and all
+emails sent to you will be rejected!
+
+
+## More info
+
+ * [[Use|quota/use]] of disk quota - eg. hints to freeing disk space
+ * [[Configuration|quota/setup]] to continuously show current disk quota status
diff --git a/quota/setup.mdwn b/quota/setup.mdwn
new file mode 100644
index 0000000..2997cc3
--- /dev/null
+++ b/quota/setup.mdwn
@@ -0,0 +1,28 @@
+# Setting up disk quota
+
+Your account has limited disk space. You will automatically receive warnings if
+you reach your "quota" limit.
+
+/!\ If you fail keep your account below your quota limit, then after some days
+your account will be locked. This affects several services, e.g. all emails
+sent to you will be rejected!
+
+## Disk quota status
+
+Some imap email programs can be configured to show your current quota status.
+
+### Mozilla Thunderbird
+
+  1. Install the [Display Quota](https://addons.mozilla.org/thunderbird/881/)
+     plugin. 
+
+### IMP webmail
+
+  1. Enter "Layout" in the top panel to the right
+  2. Select "Account information" and choose "Add"
+  3. Select "Save"
+
+
+## More info
+
+ * [[Use|quota/use]] of disk quota - eg. hints to freeing disk space
diff --git a/quota/use.mdwn b/quota/use.mdwn
new file mode 100644
index 0000000..b0f7df6
--- /dev/null
+++ b/quota/use.mdwn
@@ -0,0 +1,46 @@
+# Disk quota usage
+
+Your account has limited disk space. All of your personal files and emails have
+a shard maximum.
+
+Your use of disk space is monitored, and if you use more space than allowed,
+you will automatically receive warnings to free some space: Either delet some
+of your personal files or some of your emails.
+
+/!\ If you fail to free enough disk space to get you below your quota limit,
+then after some days your account will be locked. This affects several
+services, e.g. all emails sent to you will be rejected!
+
+
+## Files
+
+If you use some of your personal [[file_shares|files]], then they probably
+consume more space than your emails: Sound, graphics and multimedia files
+are much larger than simple text messages like emails.
+
+## Emails
+
+Consider deleting emails with big attachments. Save the attachements as plain
+files first, if you want them preserved: email attachments consume up to the
+double amount of that used by same documents stored normally.
+
+If you use Apple Mail, your emails may fill up space on the server even when
+deleted in the application. See [[email_setup|mail/setup]] for more about the
+problem. To immediately purge deleted emails, do this:
+
+ 1. Open Apple Mail
+ 2. Go to Preferences > Accounts > Advanced
+ 3. Click the button 'Remove Now'. 
+
+When you use imap (you probably do), then some routines may not behave as you
+would expect:
+
+ * You may have more folders on the server than shown in your email program.
+   You need to "subscribe" to additional email folders to see them.
+ * It is not enough to "delete" emails. You need to also "purge" the deleted
+   emails to have them completely removed from the system.
+
+
+## More info
+
+ * [[Configuration|quota/setup]] to continuously show current disk quota status
diff --git a/redpill/admin.mdwn b/redpill/admin.mdwn
new file mode 100644
index 0000000..b7c3985
--- /dev/null
+++ b/redpill/admin.mdwn
@@ -0,0 +1,52 @@
+# Redpill for technicians
+
+## Recommended hardware and software
+
+### Servere
+
+Hardware:
+
+ * Noname x86 machines
+ * software RAID
+ * All user data mirrored to remote host
+
+Software:
+
+ * Debian GNU/Linux (distribution)
+ * Postfix
+ * Apache
+ * AMaVis
+ * Dovecot
+ * HORDE/IMP
+
+### Workstations
+
+For creative use:
+
+ * Apple Macintosh
+
+For classical administrative use:
+
+ * Debian GNU/Linux or Microsoft Windows
+
+For use in schools or Internet cafés, at fairs or other demanding places:
+
+ * Debian GNU/Linux
+
+## Redpill in an alien environment
+
+It is possible to run a Redpill system at a host organisation not using (and
+with no interest in) the Redpill concept. The system usually need _not_ submit
+to a strict foreign policy.
+
+You need from the ICT staff of your host organisation...:
+
+ * A single static public IP number with port 22 open inbound and standard
+   ports open outbound (or ideally fully open)
+ * Space for a single standard-sized computer (or preferrably 2)
+
+
+## More info
+
+ * Strategic [[arguments|purpose]]
+ * Daily [[use]]
diff --git a/redpill/purpose.mdwn b/redpill/purpose.mdwn
new file mode 100644
index 0000000..e0e8928
--- /dev/null
+++ b/redpill/purpose.mdwn
@@ -0,0 +1,27 @@
+# Redpill for decision makers
+
+Redpill is the opposite of outsourcing: As much as possible of your precious
+data and infrastructure in kept in-house, and the rest uses only simple and
+generic services to avoid depending on unique features of a single provider.
+
+An "ICT guide" is hired part-time to help setup your resources as
+self-sustainable as possible, and to train one or more of your own staff to
+work with the system on a day-to-day basis.
+
+When the setup is completed, smaller tasks like restarting services or
+adding/changing user accounts can be done by the "superusers" among your staff.
+Beyond that, your network can in principle run on its own. In reality you are
+recommended to keep your ICT guide in the loop as a technical advisor,
+continuously checking security and optimize/improve/extend services.
+
+You keep your ICT guide only for as long as the relationship is mutually
+beneficial: Your data, services and know-how stays with you. Your system keeps
+running, it just slowly becomes "oldfashioned". And you can take in other ICT
+guides or ordinary technicians - all code is Free Software, tied to the Debian
+GNU/Linux distribution with one of the largest userbases worldwide and favoured
+especially amongst skilled networks administrators.
+
+## More info
+
+ * Daily [[use]]
+ * Technical [[overview|admin]]
diff --git a/redpill/use.mdwn b/redpill/use.mdwn
new file mode 100644
index 0000000..d96fcfc
--- /dev/null
+++ b/redpill/use.mdwn
@@ -0,0 +1,25 @@
+# Redpill for users
+
+At a Redpill system you are the hero! You are offered various tools to use as
+you please, at your own pace.
+
+If problems occur along the way, then no god or magician wipes it off for you,
+but you are not all alone either...
+
+At some other systems, technical stuff is considered too important to involve
+you - or you are too important to get involved. Technicians are your servants
+and superheroes, taking care of technical challenges on your behalf.
+
+With Redpill, however, [[communicating|internet]] is considered too important
+to leave to others. Computers are servants (but sometimes clumsy at that),
+while technicians are skilled friends helping you if in trouble - not by
+carrying you, but by guiding and enlightening. And maybe use a little magic
+now and then too, but too much would spoil you.
+
+Redpill makes you the hero!
+
+## More info
+
+ * Strategic [[arguments|purpose]]
+ * Technical [[overview|admin]]
+ * [[../Intro]] to this Redpill-based system