From b685df6f25bd0fd60755781349d8a76e9753402c Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Sat, 27 Oct 2007 12:26:35 +0200 Subject: Add new topics address, files, quota and redpill. --- address/commands.mdwn | 2 ++ address/setup.mdwn | 67 +++++++++++++++++++++++++++++++++++++++++++++ address/timeline.mdwn | 26 ++++++++++++++++++ files.mdwn | 15 +++++++++++ files/intro.mdwn | 32 ++++++++++++++++++++++ files/setup.mdwn | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++ quota.mdwn | 5 ++++ quota/intro.mdwn | 17 ++++++++++++ quota/setup.mdwn | 28 +++++++++++++++++++ quota/use.mdwn | 46 +++++++++++++++++++++++++++++++ redpill/admin.mdwn | 52 +++++++++++++++++++++++++++++++++++ redpill/purpose.mdwn | 27 +++++++++++++++++++ redpill/use.mdwn | 25 +++++++++++++++++ 13 files changed, 417 insertions(+) create mode 100644 address/commands.mdwn create mode 100644 address/setup.mdwn create mode 100644 address/timeline.mdwn create mode 100644 files.mdwn create mode 100644 files/intro.mdwn create mode 100644 files/setup.mdwn create mode 100644 quota.mdwn create mode 100644 quota/intro.mdwn create mode 100644 quota/setup.mdwn create mode 100644 quota/use.mdwn create mode 100644 redpill/admin.mdwn create mode 100644 redpill/purpose.mdwn create mode 100644 redpill/use.mdwn 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 -- cgit v1.2.3