Please help write the release documentation
Hi. As we plan to release as soon as the last RC bug is fixed, it is
imporant that the release documentation is up-to-date. It is
currently drafted on wiki.skolelinux.no, under
<URL:http://wiki.skolelinux.no/DebianEdu/Documentation/Etch>. This is
the current content. As you can see, there is still work left for you
and me. :)
Debian-Edu etch 3.0 Codename "Terra"
This will become the documentation for the Debian-Edu etch 3.0
release.
This document was put into the debian-edu-doc package on
$DEBIAN_EDU_DOC_BUILDDATE. (The version at
http://wiki.skolelinux.no/DebianEdu/Documentation/Etch is a wiki and
updated frequently.) Translations are only part of the debian-edu-doc
package.
* Copyright and Authors
* Translations of this document
* About Debian-Edu and Skolelinux
* Architecture
* Requierements
* Installation
* Maintainance
* Upgrades
* HowTo - simple step by step Howtos
* Contribute to Debian-Edu
* Support - how+where to find help
Special pages: Index page - All in one page
Copyright and Authors
This document is written and copyrighted by Holger Levsen 2007 and
released under the GPL2 or any later version. Enjoy!
If you add content to it, please only do so if you are the author of
it and plan to release it under the same conditions! Then add your
name here and release it under the GPL2 or later version.
FIXME: Put full text of GPL into Appendix.
Translations of this document
Translated versions of this document are not yet available, as the
document itself is very incomplete, even the skeleton is unfinished.
Howto translate this document
If you want to start translating, you can! Do
apt-get source debian-edu-doc and in
debian-edu-doc-$version/documentation/wikibook you find information
how to create a .po file for your language, and how to update it
against the source.
FIXME: describe how to work in svn and give a step by step howto.
Potential problems for translators
Remark from Holger: I'm curious to learn if distributed translating
and commiting the .po file into svn works, that is, if svn
automatically merges correctly.
Also we will need to write sed-scripts (or something like that) to
support different images for different translations. Laters :)
Please report any other showstoppers.
AboutDebianEdu
Welcome to DebianEdu / Skolelinux!
Architecture
See http://developer.skolelinux.no/arkitektur/arkitektur.html.en.
FIXME: Copy
http://developer.skolelinux.no/arkitektur/arkitektur.html.en over here
and and mention the source in an extra paragraph or is adding Petter
to the authors enough?
Requirements
* a computer or two
* harddrive space requirements varies between profiles, but any disk
with more than 8 GiB will be sufficient. As always, more disk
space is an advantage.
* whatnot
Installation
Download an installation media for Debian-edu etch rc4
The multiarch dvd ISO image is 4.4 GiB large. To download it, use
either of these methods:
* ftp://ftp.skolelinux.org/skolelinux-cd/debian-edu-etch-amd64-i386-
powerpc-DVD-rc4.iso
http://ftp.skolelinux.org/skolelinux-cd/debian-edu-etch-amd64-i386
-powerpc-DVD-rc4.iso rsync
ftp.skolelinux.org::skolelinux-cd/debian-edu-etch-amd64-i386-power
pc-DVD-rc4.iso
or for the netinstall cd you can download for i386
* ftp://ftp.skolelinux.org/skolelinux-cd/debian-edu-etch-i386-netins
t-rc4.iso
http://ftp.skolelinux.org/skolelinux-cd/debian-edu-etch-i386-netin
st-rc4.iso rsync
ftp.skolelinux.org::skolelinux-cd/debian-edu-etch-i386-netinst-rc4
.iso
and for amd64
* ftp://ftp.skolelinux.org/skolelinux-cd/debian-edu-etch-amd64-netin
st-rc4.iso
http://ftp.skolelinux.org/skolelinux-cd/debian-edu-etch-amd64-neti
nst-rc4.iso rsync
ftp.skolelinux.org::skolelinux-cd/debian-edu-etch-amd64-netinst-rc
4.iso
The powerpc port is still under development, and are currently not
officially a supported part of Debian-Edu. The architecture have been
reported to work. Its available for download at
http://ftp.skolelinux.org/cd-etch-test-powerpc/debian-edu-powerpc-CD-1
.iso.
The netinst installation will fetch some packages from the CD and the
rest from the net. The amount of packages fetched from the net varies
from profile to profile:
* Main server: X of X MiB downloaded
* Main server and Thin client server: 595 of 1059 MiB downloaded.
Installation options
When you do an Debian-Edu installation you have a few options to
choose. But don't be afraid, there aren't many. We have done a good
job hiding the complexity of Debian during the installation and
beyond. Though, DebianEdu is Debian, if you want there are more than
15000 packages to choose from and a billion of configuration options.
But for the majority of our users, our defaults should be fine.
* normal graphical installation is the default on i386 and amd64.
The powerpc installer does not support graphical installation.
Enter FIXME at the bootprompt to do a text-mode install.
* debian-edu-expert boot option adds the barebone profile to the
profile options, and switches to manual partitioning. Enter
"debian-edu-expert" (REALLY/FIXME?) at the syslinux/yaboot prompt
to enter expert mode.
* Choose a language (for the installation and the installed system)
* Choose a time-zone
* Choose a keyboard keymap (usually the countrys default is fine)
* Choose a profile, explain those here (FIXME)
+ server
+ workstation
+ terminal server
+ standalone
* say yes to automatic partioning, it will destroy the data on the
harddrives!
* say yes to partman
* wait
* be happy
Screenshot tour through an i386 main-server installation
HowTo
The HowTos from http://wiki.debian.org/DebianEdu/HowTo/ are either
user- or developer-specific. Let's move the user-specific HowTos over
here!
Other topics the documentation should cover, not neccessarily in the
HowTo Chapter though :)
LDAP Setup
/etc/ in svk
modify Kiosk mode
Flash
Java
Sound & Video
Thin Clients vs Half-Thick Clients
printer managing
Firewall setup (coyote linux)
LTSP in detail
Maintainance
Updating the software
document how to use aptitude upgrade / kde-update-notifier
are cron-apt and apt-listchanges installed and configured?
Backups
document slbackup-php / give pointers
Monitoring
give pointers to munin doc
Upgrades
Upgrades from Debian-Edu sarge
FIXME: document known any issues here!
Upgrades from older Debian-Edu / Skolelinux installations
Upgrades from the woody based Debian-Edu / Skolelinux installation are
not supported. Upgrade to the sarge based version first, a howto can
be found at http://wiki.debian.org/DebianEdu/HowTo/UpgradeFrom1.0
Contribute
Resources
FIXME, for now some basic pointers:
* http://wiki.debian.org/DebianEdu
* http://lists.debian.org/debian-edu
* #debian-edu on irc.debian.org
Translations wanted
FIXME
how to help / translate
explain how to help debian-edu explain how to help debian / upstream
Join a local debian-edu team
FIXME: in Norway, Germany, France, Spain (the region of Extremadura).
start a new local debian-edu team
FIXME: "isolated" contributors and users in schools exist in Greece,
the Netherlands, Japan and elsewhere. Meet up for beer or coffee and
form a new Debian Edu local team!
Support
volunteer based support
professional support
Reply to: