[debian-edu-commits] [Git][debian-edu/debian-edu-doc][master] Update Debian Edu Bullseye manual from the wiki
Wolfgang Schweer
gitlab at salsa.debian.org
Wed Sep 9 12:43:09 BST 2020
Wolfgang Schweer pushed to branch master at Debian Edu / debian-edu-doc
Commits:
9544a9ee by Wolfgang Schweer at 2020-09-09T13:39:59+02:00
Update Debian Edu Bullseye manual from the wiki
Also doing some unfuzzy prevention before and some unfuzzy after updating
and checking.
Signed-off-by: Wolfgang Schweer <wschweer at arcor.de>
- - - - -
18 changed files:
- debian/changelog
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual-stripped.xml
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.da.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.de.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.es.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.fr.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.it.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.ja.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.nb.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.nl.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.pl.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.pot
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.ro.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.sv.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.xml
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.zh.po
- documentation/debian-edu-bullseye/debian-edu-bullseye-manual.zh_Hant.po
- documentation/debian-edu-bullseye/source/AllInOne-debian-edu-bullseye-manual.xml
Changes:
=====================================
debian/changelog
=====================================
@@ -1,5 +1,7 @@
debian-edu-doc (2.11.12) UNRELEASED; urgency=medium
+ * Update Debian Edu Bullseye manual from the wiki.
+
[ Translation updates ]
* Bullseye manual:
- Norwegian Bokmål: Petter Reinholdtsen
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual-stripped.xml
=====================================
@@ -819,7 +819,7 @@
</title>
<para>After you install from the USB flash drive / Blu-ray disc image, <computeroutput>/etc/apt/sources.list</computeroutput> will only contain sources from that image. If you have an Internet connection, we strongly suggest adding the following lines to it so that available security updates can be installed:
</para><screen><![CDATA[deb http://deb.debian.org/debian/ bullseye main
-deb http://security.debian.org/ bullseye-security/updates main ]]></screen>
+deb http://security.debian.org/debian-security/ bullseye-security main ]]></screen>
</section>
<section>
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.da.po
=====================================
@@ -10,7 +10,7 @@
msgid ""
msgstr ""
"Project-Id-Version: debian-edu-bullseye-manual\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2019-07-07 20:30+0100\n"
"Last-Translator: Joe Hansen <joedalton2 at yahoo.dk>\n"
"Language-Team: Danish <debian-l10n-danish at lists.debian.org>\n"
@@ -2433,16 +2433,13 @@ msgstr ""
"tilgængelige sikkerhedsopdateringer kan blive installeret:"
#. type: CDATA
-#, fuzzy, no-wrap
-#| msgid ""
-#| "deb http://deb.debian.org/debian/ bullseye main \n"
-#| "deb http://security.debian.org/ bullseye/updates main"
+#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.de.po
=====================================
@@ -16,7 +16,7 @@ msgid ""
msgstr ""
"Project-Id-Version: debian-edu-buster-manual.de\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2020-07-12 12:04+0200\n"
"Last-Translator: Wolfgang Schweer <wschweer at arcor.de>\n"
"Language-Team: German <debian-l10n-german at lists.debian.org>\n"
@@ -2345,10 +2345,10 @@ msgstr ""
#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.es.po
=====================================
@@ -11,7 +11,7 @@ msgid ""
msgstr ""
"Project-Id-Version: debian-edu-doc\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2015-03-30 22:30+0000\n"
"Last-Translator: Rafael Ernesto Rivas <tatotat at gmail.com>\n"
"Language-Team: Debian Spanish <debian-l10n-spanish at lists.debian.org>\n"
@@ -2138,10 +2138,10 @@ msgstr ""
#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.fr.po
=====================================
@@ -10,7 +10,7 @@
msgid ""
msgstr ""
"Project-Id-Version: debian-edu-doc\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2019-11-10 12:03+0100\n"
"Last-Translator: Jean-Pierre Giraud <jean-pierregiraud at neuf.fr>\n"
"Language-Team: French <debian-l10n-french at lists.debian.org>\n"
@@ -2478,16 +2478,13 @@ msgstr ""
"jour de sécurité soient disponibles :"
#. type: CDATA
-#, fuzzy, no-wrap
-#| msgid ""
-#| "deb http://deb.debian.org/debian/ bullseye main \n"
-#| "deb http://security.debian.org/ bullseye/updates main"
+#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.it.po
=====================================
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: debian-edu-wheezy-manual\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2019-11-24 18:52+0100\n"
"Last-Translator: Claudio Carboncini <claudio.carboncini at gmail.com>\n"
"Language-Team: Italian <debian-l10n-italian at lists.debian.org>\n"
@@ -2493,16 +2493,13 @@ msgstr ""
"avere disponibili e installare gli aggiornamenti di sicurezza:"
#. type: CDATA
-#, fuzzy, no-wrap
-#| msgid ""
-#| "deb http://deb.debian.org/debian/ bullseye main \n"
-#| "deb http://security.debian.org/ bullseye/updates main"
+#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.ja.po
=====================================
@@ -9,7 +9,7 @@
msgid ""
msgstr ""
"Project-Id-Version: debian-edu-stretch\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2019-06-08 10:11+0000\n"
"Last-Translator: hoxp18 <hoxp18 at noramail.jp>\n"
"Language-Team: Japanese <https://hosted.weblate.org/projects/debian-edu-"
@@ -2450,16 +2450,13 @@ msgstr ""
"リティ更新ができるようになります:"
#. type: CDATA
-#, fuzzy, no-wrap
-#| msgid ""
-#| "deb http://deb.debian.org/debian/ bullseye main \n"
-#| "deb http://security.debian.org/ bullseye/updates main"
+#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.nb.po
=====================================
@@ -21,7 +21,7 @@
msgid ""
msgstr ""
"Project-Id-Version: debian-edu-doc\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2020-08-30 18:35+0000\n"
"Last-Translator: Petter Reinholdtsen <pere-weblate at hungry.com>\n"
"Language-Team: Norwegian Bokmål <https://hosted.weblate.org/projects/debian-"
@@ -2302,13 +2302,13 @@ msgstr ""
"installeres:"
#. type: CDATA
-#, fuzzy, no-wrap
+#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
-"deb http://ftp.debian.org/debian/ buster main \n"
-"deb http://security.debian.org/ buster/updates main"
+"deb http://deb.debian.org/debian/ bullseye main \n"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
@@ -9021,10 +9021,13 @@ msgstr ""
#~ msgid ""
#~ "Note to translators: there is no need to translate the GPL license text.\n"
-#~ "Translations are available at https://www.gnu.org/licenses/old-licenses/gpl-2.0-translations.html."
+#~ "Translations are available at https://www.gnu.org/licenses/old-licenses/"
+#~ "gpl-2.0-translations.html."
#~ msgstr ""
-#~ "Merknad til oversettere: Det er ikke nødvendig å oversette GPLs lisenstekst.\n"
-#~ "Oversettelser er tilgjengelige på https://www.gnu.org/licenses/old-licenses/gpl-2.0-translations.html."
+#~ "Merknad til oversettere: Det er ikke nødvendig å oversette GPLs "
+#~ "lisenstekst.\n"
+#~ "Oversettelser er tilgjengelige på https://www.gnu.org/licenses/old-"
+#~ "licenses/gpl-2.0-translations.html."
#~ msgid ""
#~ "This program is free software; you can redistribute it and/or modify it "
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.nl.po
=====================================
@@ -6,7 +6,7 @@ msgid ""
msgstr ""
"Project-Id-Version: debian-edu-bullseye-manual\n"
"Report-Msgid-Bugs-To: debian-edu-doc at packages.debian.org\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2020-07-22 21:38+0200\n"
"Last-Translator: Frans Spiesschaert <Frans.Spiesschaert at yucom.be>\n"
"Language-Team: Debian Dutch l10n Team <debian-l10n-dutch at lists.debian.org>\n"
@@ -2373,10 +2373,10 @@ msgstr ""
#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.pl.po
=====================================
@@ -1,7 +1,7 @@
msgid ""
msgstr ""
"Project-Id-Version: Polish (Debian Edu Documentation)\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2020-07-22 17:41+0000\n"
"Last-Translator: Stanisław Krukowski <pet209a1 at riseup.net>\n"
"Language-Team: Polish <https://hosted.weblate.org/projects/debian-edu-"
@@ -2224,7 +2224,7 @@ msgstr ""
#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
#. type: Content of: <article><section><section><section><section><title>
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.pot
=====================================
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL at ADDRESS>\n"
"Language-Team: LANGUAGE <LL at li.org>\n"
@@ -1712,7 +1712,7 @@ msgstr ""
#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
#. type: Content of: <article><section><section><section><section><title>
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.ro.po
=====================================
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2019-12-11 17:02+0000\n"
"Last-Translator: Catalin ENE <catalin.ene73 at gmail.com>\n"
"Language-Team: Romanian <https://hosted.weblate.org/projects/debian-edu-"
@@ -2515,16 +2515,13 @@ msgstr ""
"actualizările de securitate disponibile:"
#. type: CDATA
-#, fuzzy, no-wrap
-#| msgid ""
-#| "deb http://deb.debian.org/debian/ buster main \n"
-#| "deb http://security.debian.org/ buster/updates main"
+#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
-"deb http://deb.debian.org/debian/ buster main \n"
-"deb http://security.debian.org/ buster/updates main"
+"deb http://deb.debian.org/debian/ bullseye main \n"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.sv.po
=====================================
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2020-08-21 10:36+0000\n"
"Last-Translator: Luna Jernberg <droidbittin at gmail.com>\n"
"Language-Team: Swedish <https://hosted.weblate.org/projects/debian-edu-"
@@ -1714,10 +1714,10 @@ msgstr ""
#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
#. type: Content of: <article><section><section><section><section><title>
msgid "A note on CD installs"
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.xml
=====================================
@@ -819,7 +819,7 @@
</title>
<para>After you install from the USB flash drive / Blu-ray disc image, <computeroutput>/etc/apt/sources.list</computeroutput> will only contain sources from that image. If you have an Internet connection, we strongly suggest adding the following lines to it so that available security updates can be installed:
</para><screen><![CDATA[deb http://deb.debian.org/debian/ bullseye main
-deb http://security.debian.org/ bullseye-security/updates main ]]></screen>
+deb http://security.debian.org/debian-security/ bullseye-security main ]]></screen>
</section>
<section>
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.zh.po
=====================================
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: debian-edu-doc\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2020-08-03 16:41+0000\n"
"Last-Translator: Ma Yong <debuser at yeah.net>\n"
"Language-Team: Chinese (Simplified) <https://hosted.weblate.org/projects/"
@@ -2083,7 +2083,7 @@ msgstr ""
#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
#. type: Content of: <article><section><section><section><section><title>
=====================================
documentation/debian-edu-bullseye/debian-edu-bullseye-manual.zh_Hant.po
=====================================
@@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2020-08-24 20:56+0200\n"
+"POT-Creation-Date: 2020-09-09 13:14+0200\n"
"PO-Revision-Date: 2019-01-28 08:11+0000\n"
"Last-Translator: Louies <louies0623 at gmail.com>\n"
"Language-Team: Chinese (Traditional) <https://hosted.weblate.org/projects/"
@@ -1756,7 +1756,7 @@ msgstr ""
#, no-wrap
msgid ""
"deb http://deb.debian.org/debian/ bullseye main \n"
-"deb http://security.debian.org/ bullseye-security/updates main"
+"deb http://security.debian.org/debian-security/ bullseye-security main"
msgstr ""
#. type: Content of: <article><section><section><section><section><title>
=====================================
documentation/debian-edu-bullseye/source/AllInOne-debian-edu-bullseye-manual.xml
=====================================
@@ -25,7 +25,7 @@
# or
#apt install ufw
#apt install wondershaper ]]></screen><para>If you need something for an embedded router or accesspoint we recommend using <ulink url="https://openwrt.org">OpenWRT</ulink>, though of course you can also use the original firmware. Using the original firmware is easier; using OpenWRT gives you more choices and control. Check the OpenWRT webpages for a list of <ulink url="https://wiki.openwrt.org/toh/start">supported hardware</ulink>. </para><para>It is possible to use a different network setup (there is a <ulink url="https://wiki.debian.org/DebianEdu/HowTo/ChangeIpSubnet">documented procedure</ulink> to do this), but if you are not forced to do this by an existing network infrastructure, we recommend against doing so and recommend you stay with the default <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Architecture#">network architecture</ulink>. </para><para><ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/CategoryPermalink#">CategoryPermalink</ulink> </para></section></section><para><anchor id="Installation"/> </para><section><title>Installation and download options</title><section><title>Where to find additional information</title><para>We recommend that you read or at least take a look at the <ulink url="https://www.debian.org/releases/bullseye/releasenotes">release notes for Debian Bullseye</ulink> before you start installing a system for production use. There is more information about the Debian Bullseye release available in its <ulink url="https://www.debian.org/releases/bullseye/installmanual">installation manual</ulink>. </para><para>Please give Debian Edu/Skolelinux a try, it should just work. <inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.debian.org/htdocs/debwiki/img/smile.png" width="16"/></imageobject><textobject><phrase>:-)</phrase></textobject></inlinemediaobject> </para><para>It is recommended, though, to read the chapters about <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Requirements#">hardware and network requirements</ulink> and about the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Architecture#">architecture</ulink> before starting to install a main server. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.debian.org/htdocs/debwiki/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> Be sure to also read the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/GettingStarted#">getting started</ulink> chapter of this manual, as it explains how to log in for the first time. </para></section><section><title>Download the installation media for Debian Edu 11 Codename Bullseye</title><section><title>amd64 or i386</title><para><code>amd64</code> and <code>i386</code> are the names of two Debian architectures for x86 CPUs, both are or have been build by AMD, Intel and other manufacturers. <code>amd64</code> is a 64-bit architecture and <code>i386</code> is a 32-bit architecture. New installations today should be done using <code>amd64</code>. <code>i386</code> should only be used for old hardware. </para></section><section><title>netinst iso images for amd64 or i386</title><para>The netinst iso image can be used for installation from CD/DVD and USB flash drives and is available for two Debian architectures: amd64 or i386. As the name implies, internet access is required for the installation. </para><para>Once Bullseye has been released these images will be available for download from: </para><itemizedlist><listitem><para><ulink url="https://get.debian.org/cdimage/release/current/amd64/iso-cd/"/> </para></listitem><listitem><para><ulink url="https://get.debian.org/cdimage/release/current/i386/iso-cd/"/> </para></listitem></itemizedlist></section><section><title>BD iso images for i386 or amd64</title><para>This ISO image is approximately 5 GB large and can be used for installation of amd64 or i386 machines, also without access to the Internet. Like the netinst image it can be installed on USB flash drives or disk media of sufficient size. </para><para>Once Bullseye has been released these images will be available for download from: </para><itemizedlist><listitem><para><ulink url="https://get.debian.org/cdimage/release/current/amd64/iso-bd/"/> </para></listitem><listitem><para><ulink url="https://get.debian.org/cdimage/release/current/i386/iso-bd/"/> </para></listitem></itemizedlist></section><section><title>Verification of downloaded image files</title><para>Detailed instructions for verifying these images are part of the <ulink url="https://www.debian.org/CD/faq/index.en.html#verify">Debian-CD FAQ</ulink>. </para></section><section><title>Sources</title><para>Sources are available from the Debian archive at the usual locations, several media are linked on <ulink url="https://get.debian.org/cdimage/release/current/source/"/> </para></section></section><section><title>Request a CD / DVD by mail</title><para>For those without a fast Internet connection, we can offer a CD or DVD sent for the cost of the CD or DVD and shipping. Just send an email to <ulink url="mailto:cd at skolelinux.no">cd at skolelinux.no</ulink> and we will discuss the payment details (for shipping and media). <inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.debian.org/htdocs/debwiki/img/smile.png" width="16"/></imageobject><textobject><phrase>:)</phrase></textobject></inlinemediaobject> Remember to include the address you want the CD or DVD to be sent to in the email. </para></section><section><title>Installing Debian Edu</title><para>When you do a Debian Edu installation, you have a few options to choose from. Don't be afraid; there aren't many. We have done a good job of hiding the complexity of Debian during the installation and beyond. However, Debian Edu is Debian, and if you want there are more than 57,000 packages to choose from and a billion configuration options. For the majority of our users, our defaults should be fine. Please note: if LTSP is intended to be used, choose a lightweight desktop environment. </para><section><title>Main server installation scenarios</title><orderedlist numeration="upperalpha"><listitem><para>Typical school or home network with Internet access through a router providing DHCP: </para><itemizedlist><listitem><para>Installation of a main server is possible, but after reboot there will be no internet access (due to primary network interface IP 10.0.2.2/8). </para></listitem><listitem><para>See the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Requirements#Internet_router">Internet router</ulink> chapter for details how to set up a gateway if it is not possible to configure an existing one as needed. </para></listitem><listitem><para>Connect all components like shown in the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Architecture#Network">architecture</ulink> chapter. </para></listitem><listitem><para>The main server should have Internet connection once bootet the first time in the correct environment. </para></listitem></itemizedlist></listitem><listitem><para>Typical school or institution network, similar to the one above, but with proxy use required. </para><itemizedlist><listitem><para>Add 'debian-edu-expert' to the kernel command line; see further below for details how this is done. </para></listitem><listitem><para>Some additional questions must be answered, the proxy server related one included. </para></listitem></itemizedlist></listitem><listitem><para>Network with router/gateway IP 10.0.0.1/8 (which does not provide a DHCP server) and Internet access: </para><itemizedlist><listitem><para>As soon as the automatic network configuration fails (due to missing DHCP), choose manual network configuration. </para><itemizedlist><listitem><para>Enter 10.0.2.2/8 as host IP </para></listitem><listitem><para>Enter 10.0.0.1 as gateway IP </para></listitem><listitem><para>Enter 8.8.8.8 as nameserver IP unless you know better </para></listitem></itemizedlist></listitem><listitem><para>The main server should just work after the first boot. </para></listitem></itemizedlist></listitem><listitem><para>Offline (no Internet connection): </para><itemizedlist><listitem><para>Use the BD ISO image. </para></listitem><listitem><para>Make sure all (real/virtual) network cables are unplugged. </para></listitem><listitem><para>Choose 'Do not configure the network at this time' (after DHCP failed to configure the network and you pressed 'Continue'). </para></listitem><listitem><para>Update the system once bootet the first time in the correct environment with Internet access. </para></listitem></itemizedlist></listitem></orderedlist></section><section><title>Desktop choice</title><itemizedlist><listitem><para>KDE and GNOME both have good language support, but too big a footprint for both older computers and for LTSP clients. </para></listitem><listitem><para>MATE is lighter than the two above, but is missing good language support for several countries. </para></listitem><listitem><para>LXDE has the smallest footprint and supports 35 languages. </para></listitem><listitem><para>LXQt is a lightweight desktop (language support similar to LXDE) with a more modern look and feel (based on Qt just like KDE). </para></listitem><listitem><para>Xfce has a slightly bigger footprint than LXDE but a very good language support (106 languages). </para></listitem></itemizedlist><para>Debian Edu as an international project has chosen to use Xfce as the default desktop; see below how to set a different one. </para></section><section><title>Modular installation</title><itemizedlist><listitem><para>When installing a system with profile <emphasis>Workstation</emphasis> included, a lot of education related programs are installed. To install only the basic profile, remove the <emphasis>desktop=xxxx</emphasis> kernel command line param before starting the installation; see further below for details how this is done. This allows one to install a site specific system and could be used to speed up test installations. </para></listitem><listitem><para>Please note: If you want to install a desktop afterwards, don't use the Debian Edu meta-packages like e.g. <ulink url="https://packages.debian.org/stable/education-desktop-mate#">education-desktop-mate</ulink> because these would pull in all education related programs; rather install e.g. <ulink url="https://packages.debian.org/stable/task-mate-desktop#">task-mate-desktop</ulink> instead. One or more of the new school level related meta-packages <emphasis>education-preschool</emphasis>, <emphasis>education-primaryschool</emphasis>, <emphasis>education-secondaryschool</emphasis>, <emphasis>education-highschool</emphasis> could be installed to match the use case. </para></listitem><listitem><para>For details about Debian Edu meta-packages, see the <ulink url="https://blends.debian.org/edu/tasks/">Debian Edu packages overview</ulink> page. </para></listitem></itemizedlist></section><section><title>Installation types and options</title><para><emphasis>Installer boot menu on 64-bit Hardware</emphasis> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=01-Installer_64bit_boot_menu.png"/></imageobject><textobject><phrase>64-bit Installer boot menu</phrase></textobject></inlinemediaobject> </para><para> <emphasis role="strong">Graphical install</emphasis> uses the GTK installer where you can use the mouse.</para><para> <emphasis role="strong">Install</emphasis> uses text mode.</para><para> <emphasis role="strong">Advanced options ></emphasis> gives a sub menu with more detailed options to choose.</para><para><emphasis role="strong">Help</emphasis> gives some hints on using the installer; see screenshot below. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=01a-Installer_64bit_advanced_options.png"/></imageobject><textobject><phrase>64-bit Installer advanced options screen 1</phrase></textobject></inlinemediaobject> </para><para> <emphasis role="strong">Back..</emphasis> brings back to the main menu.</para><para><emphasis role="strong">Graphical expert install</emphasis> gives access to all available questions, mouse usable.</para><para> <emphasis role="strong">Graphical rescue mode</emphasis> makes this install medium become a rescue disk for emergency tasks.</para><para> <emphasis role="strong">Graphical automated install</emphasis> needs a preseed file.</para><para> <emphasis role="strong">Expert install</emphasis> gives access to all available questions in text mode.</para><para> <emphasis role="strong">Rescue mode</emphasis> text mode; makes this install medium become a rescue disk for emergency tasks.</para><para> <emphasis role="strong">Automated install</emphasis> text mode; needs a preseed file. </para><para><emphasis>Help screen</emphasis> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=01c-Installer_help.png"/></imageobject><textobject><phrase>Installer help screen</phrase></textobject></inlinemediaobject> </para><para> This Help screen is self explaining and enables the <F>-keys on the keyboard for getting more detailed help on the topics described. </para><para><emphasis>Add or change boot parameters for installations</emphasis> </para><para>In both cases, boot options can be edited by pressing the TAB key in the boot menu; the screenshot shows the command line for <emphasis role="strong">Graphical install</emphasis>. </para><para> <inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=01b-Installer_64bit_command_line.png"/></imageobject><textobject><phrase>Edit command line options</phrase></textobject></inlinemediaobject> </para><itemizedlist><listitem><para>You can use an existing HTTP proxy service on the network to speed up the installation of the main server profile from CD. Add e.g. <code>mirror/http/proxy=http://10.0.2.2:3128</code> as an additional boot parameter. </para></listitem><listitem><para>If you have already installed the main server profile on a machine, further installations should be done via PXE, as this will automatically use the proxy of the main server. </para></listitem><listitem><para>To install the <emphasis role="strong">GNOME</emphasis> desktop instead of the default <emphasis role="strong">Xfce</emphasis> desktop, replace <code>xfce</code> with <code>gnome</code> in the <code>desktop=xfce</code> parameter. </para></listitem><listitem><para>To install the <emphasis role="strong">LXDE</emphasis> desktop instead, use <code>desktop=lxde</code>. </para></listitem><listitem><para>To install the <emphasis role="strong">LXQt</emphasis> desktop instead, use <code>desktop=lxqt</code>. </para></listitem><listitem><para>To install the <emphasis role="strong">KDE Plasma</emphasis> desktop instead, use <code>desktop=kde</code>. </para></listitem><listitem><para>To install the <emphasis role="strong">Cinnamon</emphasis> desktop instead, use <code>desktop=cinnamon</code>. </para></listitem><listitem><para>And to install the <emphasis role="strong">MATE</emphasis> desktop instead, use <code>desktop=mate</code>. </para></listitem></itemizedlist></section><section><title>The installation process</title><para>Remember the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Requirements#">system requirements</ulink> and make sure you have at least two network cards (NICs) if you plan on setting up an LTSP server. </para><itemizedlist><listitem><para>Choose a language (for the installation and the installed system). </para></listitem><listitem><para>Choose a location which normally should be the location where you live. </para></listitem><listitem><para>Choose a keyboard keymap (the country's default is usually fine). </para></listitem><listitem><para>Choose profile(s) from the following list: </para><itemizedlist><listitem><para><emphasis role="strong">Main Server</emphasis> </para><itemizedlist><listitem override="none"><para>This is the main server (tjener) for your school providing all services pre-configured to work out of the box. You must install only one main server per school! This profile does not include a graphical user interface. If you want a graphical user interface, then select Workstation or LTSP Server in addition to this one. </para></listitem></itemizedlist></listitem><listitem><para><emphasis role="strong">Workstation</emphasis> </para><itemizedlist><listitem override="none"><para>A computer booting from its local hard drive, and running all software and devices locally like an ordinary computer, except that user logins are authenticated by the main server, where the users' files and desktop profile are stored. </para></listitem></itemizedlist></listitem><listitem><para><emphasis role="strong">Roaming workstation</emphasis> </para><itemizedlist><listitem override="none"><para>Same as workstation but capable of authentication using cached credentials, meaning it can be used outside the school network. The users' files and profiles are stored on the local disk. For single user notebooks and laptops this profile should be selected and not 'Workstation' or 'Standalone' as suggested in earlier releases. </para></listitem></itemizedlist></listitem><listitem><para><emphasis role="strong">LTSP Server</emphasis> </para><itemizedlist><listitem override="none"><para>A thin client (and diskless workstation) server, is called an LTSP server. Clients without hard drives boot and run software from this server. This computer needs two network interfaces, a lot of memory, and ideally more than one processor or core. See the chapter about <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/HowTo/NetworkClients#">networked clients</ulink> for more information on this subject. Choosing this profile also enables the workstation profile (even if it is not selected) - an LTSP server can always be used as a workstation, too. </para></listitem></itemizedlist></listitem><listitem><para><emphasis role="strong">Standalone</emphasis> </para><itemizedlist><listitem override="none"><para>An ordinary computer that can function without a main server (that is, it doesn't need to be on the network). Includes laptops. </para></listitem></itemizedlist></listitem><listitem><para><emphasis role="strong">Minimal</emphasis> </para><itemizedlist><listitem override="none"><para>This profile will install the base packages and configure the machine to integrate into the Debian Edu network, but without any services and applications. It is useful as a platform for single services manually moved out from the main-server. </para></listitem></itemizedlist></listitem></itemizedlist><para>The <emphasis role="strong">Main Server</emphasis>, <emphasis role="strong">Workstation</emphasis> and <emphasis role="strong">LTSP Server</emphasis> profiles are preselected. These profiles can be installed on one machine together if you want to install a so called <emphasis>combined main server</emphasis>. This means the main server will be an LTSP server and also be used as a workstation. This is the default choice, since we assume most people will want it. Please note that you must have 2 network cards installed in a machine which is going to be installed as a combined main server or as an LTSP server to become useful after the installation. </para></listitem><listitem><para>Say "yes" or "no" to automatic partitioning. Be aware that saying "yes" will destroy all data on the hard drives! Saying "no" on the other hand will require more work - you will need to make sure that the required partitions are created and are big enough. </para></listitem><listitem><para>Please say "yes" to submitting information to <ulink url="https://popcon.debian.org/"/> to allow us to know which packages are popular and should be kept for future releases. Although you don't have to, it is a simple way for you to help. <inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.debian.org/htdocs/debwiki/img/smile.png" width="16"/></imageobject><textobject><phrase>:)</phrase></textobject></inlinemediaobject> </para></listitem><listitem><para>Wait. If the selected profiles include LTSP Server then the installer will spend quite some time at the end, "Finishing the installation - Running debian-edu-profile-udeb..." </para></listitem><listitem><para>After giving the root password, you will be asked to create a normal user account "for non-administrative tasks". For Debian Edu this account is very important: it is the account you will use to manage the Skolelinux network. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.debian.org/htdocs/debwiki/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> The password for this user <emphasis role="strong">must</emphasis> have a length of <emphasis role="strong">at least 5 characters</emphasis> and <emphasis role="strong">must differ</emphasis> from the <emphasis role="strong">username</emphasis> - otherwise login will not be possible (even though a shorter password and also a password matching the username will be accepted by the installer). </para></listitem><listitem><para>Be happy </para></listitem></itemizedlist></section><section><title>Notes on some characteristics</title><section><title>A note on notebooks</title><para>Most likely you will want to use the 'Roaming workstation' profile (see above). Be aware that all data is stored locally (so take some extra care over backups) and login credentials are cached (so after a password change, logins may require your old password if you have not connected your laptop to the network and logged in with the new password). </para></section><section><title>A note on USB flash drive / Blu-ray disc image installs</title><para>After you install from the USB flash drive / Blu-ray disc image, <code>/etc/apt/sources.list</code> will only contain sources from that image. If you have an Internet connection, we strongly suggest adding the following lines to it so that available security updates can be installed: </para><screen><![CDATA[deb http://deb.debian.org/debian/ bullseye main
-deb http://security.debian.org/ bullseye-security/updates main ]]></screen></section><section><title>A note on CD installs</title><para>A netinst installation (which is the type of installation our CD provides) 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 but stays below a gigabyte (unless you choose to install all possible desktops). Once you have installed the main-server (whether a pure main-server or combi-server does not matter), further installation will use its proxy to avoid downloading the same package several times from the net. </para></section></section><section><title>Installation using USB flash drives instead of CD / Blu-ray discs</title><para>It is possible to directly copy a CD/BD <code>.iso</code> image to USB flash drives (also known as "USB sticks") and boot from them. Simply execute a command like this, just adapting the file and device name to your needs: </para><para><code>sudo cat debian-edu-amd64-XXX.iso > /dev/sdX</code> </para><para>To determine the value of X, run this command before and after the USB device has been inserted: </para><para><code>lsblk -p</code> </para><para>Please note that copying will take quite some time. </para><para>Depending on which image you choose, the USB flash drive will behave just like a CD or Blu-ray disc. </para></section><section><title>Installation and booting over the network via PXE</title><para>For this installation method it is required that you have a running main server. When clients boot via the main network, an iPXE menu with installer and boot selection options is displayed. If PXE installation fails with an error message claiming a XXX.bin file is missing, then most probably the client's network card requires nonfree firmware. In this case the Debian Installer's initrd must be modified. This can be achieved by executing the command: <code>/usr/share/debian-edu-config/tools/pxe-addfirmware </code> on the server. </para><para>This is how the iPXE menu looks with the <emphasis role="strong">Main-Server</emphasis> profile only: </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=30-Main-Server-GRUB_Boot_menu-PXE.png"/></imageobject><textobject><phrase>width=400</phrase></textobject></inlinemediaobject> </para><para>This is how the iPXE menu looks with the <emphasis role="strong">Main Server</emphasis> and <emphasis role="strong">LTSP Server</emphasis> profiles: </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=28-Diskless-WS-GRUB_Boot_menu-PXE.png"/></imageobject><textobject><phrase>width=400</phrase></textobject></inlinemediaobject> </para><para>To install a desktop environment of your choice instead of the default one, press TAB and edit the kernel boot options (like explained above). </para><para>This setup also allows diskless workstations and thin clients to be booted on the main network. Unlike workstations and separate LTSP servers, diskless workstations don't have to be added to LDAP with GOsa². </para><para>More information about network clients can be found in the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/HowTo/NetworkClients#">Network clients HowTo</ulink> chapter. </para><para><anchor id="Installation--Modifying_PXE_installations"/> </para></section><section><title>Modifying PXE installations</title><para>The PXE installation uses a debian-installer preseed file, which can be modified to ask for more packages to install. </para><para>A line like the following needs to be added to <code>tjener:/etc/debian-edu/www/debian-edu-install.dat</code> </para><screen><![CDATA[d-i pkgsel/include string my-extra-package(s)]]></screen><para>The PXE installation uses <code>/srv/tftp/debian-edu/install.cfg</code> and the preseeding file in <code>/etc/debian-edu/www/debian-edu-install.dat</code>. These files can be changed to adjust the preseeding used during installation, to avoid more questions when installing over the net. Another way to achieve this is to provide extra settings in <code>/etc/debian-edu/pxeinstall.conf</code> and <code>/etc/debian-edu/www/debian-edu-install.dat.local</code> and to run <code>/usr/sbin/debian-edu-pxeinstall</code> to update the generated files. </para><para>Further information can be found in the <ulink url="https://www.debian.org/releases/Bullseye/installmanual">manual of the Debian Installer</ulink>. </para><para>To disable or change the use of the proxy when installing via PXE, the lines containing <code>mirror/http/proxy</code>, <code>mirror/ftp/proxy</code> and <code>preseed/early_command</code> in <code>tjener:/etc/debian-edu/www/debian-edu-install.dat </code> need to be changed. To disable the use of a proxy when installing, put '#' in front of the first two lines, and remove the "<code>export http_proxy="http://webcache:3128"; </code>" part from the last one. </para><para>Some settings can not be preseeded because they are needed before the preseeding file is downloaded. These are configured in the PXElinux-based boot arguments available from <code>/srv/tftp/debian-edu/install.cfg</code>. Language, keyboard layout and desktop are examples of such settings. </para></section><section><title>Custom images</title><para>Creating custom CDs, DVDs or Blu-ray discs can be quite easy since we use the <ulink url="https://wiki.debian.org/DebianInstaller/">Debian Installer</ulink>, which has a modular design and other nice features. <ulink url="https://wiki.debian.org/DebianInstaller/Preseed">Preseeding</ulink> allows you to define answers to the questions normally asked. </para><para>So all you need to do is to create a preseeding file with your answers (this is described in the appendix of the Debian Installer manual) and <ulink url="https://wiki.debian.org/DebianInstaller/Modify/CD">remaster the CD/DVD</ulink>. </para></section></section><section><title>Screenshot tour</title><para>The text mode and the graphical installation are functionally identical - only the appearance is different. The graphical mode offers the opportunity to use a mouse, and of course looks much nicer and more modern. Unless the hardware has trouble with the graphical mode, there is no reason not to use it. </para><para>So here is a screenshot tour through a graphical 64-bit Main Server + Workstation + LTSP Server installation and how it looks at the first boot of the main server and a PXE boot on the LTSP client network (thin client session screen - and login screen after the session on the right has been clicked). </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=01-Installer_64bit_boot_menu.png"/></imageobject><textobject><phrase>01-Installer_64bit_boot_menu.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=02-select_a_language.png"/></imageobject><textobject><phrase>02-select_a_language.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=03-select_your_location.png"/></imageobject><textobject><phrase>03-select_your_location.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=04-Configure_the_keyboard.png"/></imageobject><textobject><phrase>04-Configure_the_keyboard.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=05-Detect_network_hardware.png"/></imageobject><textobject><phrase>05-Detect_network_hardware.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=06-Choose_Debian_Edu_profile.png"/></imageobject><textobject><phrase>06-Choose_Debian_Edu_profile.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=07-Really_use_the_automatic_partitioning_tool_0.png"/></imageobject><textobject><phrase>07-Really_use_the_automatic_partitioning_tool_0.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=08-Really_use_the_automatic_partitioning_tool_1.png"/></imageobject><textobject><phrase>08-Really_use_the_automatic_partitioning_tool_1.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=09-Participate_in_the_package_usage_survey_0.png"/></imageobject><textobject><phrase>09-Participate_in_the_package_usage_survey_0.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=10-Participate_in_the_package_usage_survey_1.png"/></imageobject><textobject><phrase>10-Participate_in_the_package_usage_survey_1.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=11-Set_up_users_and_passwords_root.png"/></imageobject><textobject><phrase>11-Set_up_users_and_passwords_root.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=12-Set_up_users_and_passwords_user_full_name.png"/></imageobject><textobject><phrase>12-Set_up_users_and_passwords_user_full_name.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=13-Set_up_users_and_passwords_username.png"/></imageobject><textobject><phrase>13-Set_up_users_and_passwords_username.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=14-Set_up_users_and_passwords_user_password.png"/></imageobject><textobject><phrase>14-Set_up_users_and_passwords_user_password.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=21-Finish_the_Installation-Installation_complete.png"/></imageobject><textobject><phrase>21-Finish_the_Installation-Installation_complete.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=22-Tjener-LightDM-Login.png" width="800"/></imageobject><textobject><phrase>tjener Lightdm Login</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=26-Tjener-Xfce_Desktop_Browser.png" width="800"/></imageobject><textobject><phrase>Xfce and Browser</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=27-Tjener-Xfce_Desktop.png" width="800"/></imageobject><textobject><phrase>Xfce Desktop</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=24-Thin-Client-Welcome.png" width="800"/></imageobject><textobject><phrase>Thin-Client-Welcome</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=25-Thin-Client-Login.png" width="800"/></imageobject><textobject><phrase>Thin-Client-Login</phrase></textobject></inlinemediaobject> </para><para><ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/CategoryPermalink#">CategoryPermalink</ulink> </para></section></section><para><anchor id="GettingStarted"/> </para><section><title>Getting started</title><section><title>Minimum steps to get started</title><para>During installation of the main server a first user account was created. In the following text this account will be referenced as "first user". This account is special, as there's no Samba account (can be added via GOsa²), the home directory permission is set to 700 (so <code>chmod o+x ~</code> is needed to make personal web pages accessible), and the first user can use <code>sudo</code> to become root. </para><para>See the information about Debian Edu specific <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Architecture#File_system_access_configuration">file system access configuration</ulink> before adding users; adjust to your site's policy if needed. </para><para>After the installation, the first things you need to do as first user are: </para><orderedlist numeration="arabic"><listitem><para>Log into the server. </para></listitem><listitem><para>Add users with GOsa². </para></listitem><listitem><para>Add workstations with GOsa² - thin-client and diskless workstation can be used directly without this step. </para></listitem></orderedlist><para>Adding users and workstations is described in detail below, so please read this chapter completely. It covers how to perform these minimum steps correctly as well as other stuff that everybody will probably need to do. </para><para>There is additional information available elsewhere in this manual: the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Features#">New features in Bullseye</ulink> chapter should be read by everyone who is familiar with previous releases. And for those upgrading from a previous release, make sure to read the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Upgrades#">Upgrades</ulink> chapter. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.debian.org/htdocs/debwiki/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> If generic DNS traffic is blocked out of your network and you need to use some specific DNS server to look up internet hosts, you need to tell the DNS server to use this server as its "forwarder". Update /etc/bind/named.conf.options and specify the IP address of the DNS server to use. </para><para>The <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/HowTo#">HowTo</ulink> chapter covers more tips and tricks and some frequently asked questions. </para><para>{{attachment:27-Tjener-Xfce_Desktop.png}} </para><section><title>Services running on the main server</title><para>There are several services running on the main server which can be managed via a web management interface. We'll describe each service below. </para></section></section><section><title>Introduction to GOsa²</title><para>GOsa² is a web based management tool that helps to manage some important parts of your Debian Edu setup. With GOsa² you can manage (add, modify, or delete) these main groups: </para><itemizedlist><listitem><para>User Administration </para></listitem><listitem><para>Group Administration </para></listitem><listitem><para>NIS Netgroup Administrator </para></listitem><listitem><para>Machine Administration </para></listitem><listitem><para>DNS Administration </para></listitem><listitem><para>DHCP Administration </para></listitem></itemizedlist><para>For GOsa² access you need the Skolelinux main server and a (client) system with a web browser installed which can be the main server itself if it was installed as a so called combined server (Main Server + LTSP Server + Workstation profiles). </para><para>If you (probably accidentally) installed a pure main-server profile and don't have a client with a web-browser handy, it's easy to install a minimal desktop on the main server using this command sequence in a (non-graphical) shell as the user you created during the main server's installation (first user): </para><screen><![CDATA[ $ sudo apt update
+deb http://security.debian.org/debian-security/ bullseye-security main ]]></screen></section><section><title>A note on CD installs</title><para>A netinst installation (which is the type of installation our CD provides) 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 but stays below a gigabyte (unless you choose to install all possible desktops). Once you have installed the main-server (whether a pure main-server or combi-server does not matter), further installation will use its proxy to avoid downloading the same package several times from the net. </para></section></section><section><title>Installation using USB flash drives instead of CD / Blu-ray discs</title><para>It is possible to directly copy a CD/BD <code>.iso</code> image to USB flash drives (also known as "USB sticks") and boot from them. Simply execute a command like this, just adapting the file and device name to your needs: </para><para><code>sudo cat debian-edu-amd64-XXX.iso > /dev/sdX</code> </para><para>To determine the value of X, run this command before and after the USB device has been inserted: </para><para><code>lsblk -p</code> </para><para>Please note that copying will take quite some time. </para><para>Depending on which image you choose, the USB flash drive will behave just like a CD or Blu-ray disc. </para></section><section><title>Installation and booting over the network via PXE</title><para>For this installation method it is required that you have a running main server. When clients boot via the main network, an iPXE menu with installer and boot selection options is displayed. If PXE installation fails with an error message claiming a XXX.bin file is missing, then most probably the client's network card requires nonfree firmware. In this case the Debian Installer's initrd must be modified. This can be achieved by executing the command: <code>/usr/share/debian-edu-config/tools/pxe-addfirmware </code> on the server. </para><para>This is how the iPXE menu looks with the <emphasis role="strong">Main-Server</emphasis> profile only: </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=30-Main-Server-GRUB_Boot_menu-PXE.png"/></imageobject><textobject><phrase>width=400</phrase></textobject></inlinemediaobject> </para><para>This is how the iPXE menu looks with the <emphasis role="strong">Main Server</emphasis> and <emphasis role="strong">LTSP Server</emphasis> profiles: </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=28-Diskless-WS-GRUB_Boot_menu-PXE.png"/></imageobject><textobject><phrase>width=400</phrase></textobject></inlinemediaobject> </para><para>To install a desktop environment of your choice instead of the default one, press TAB and edit the kernel boot options (like explained above). </para><para>This setup also allows diskless workstations and thin clients to be booted on the main network. Unlike workstations and separate LTSP servers, diskless workstations don't have to be added to LDAP with GOsa². </para><para>More information about network clients can be found in the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/HowTo/NetworkClients#">Network clients HowTo</ulink> chapter. </para><para><anchor id="Installation--Modifying_PXE_installations"/> </para></section><section><title>Modifying PXE installations</title><para>The PXE installation uses a debian-installer preseed file, which can be modified to ask for more packages to install. </para><para>A line like the following needs to be added to <code>tjener:/etc/debian-edu/www/debian-edu-install.dat</code> </para><screen><![CDATA[d-i pkgsel/include string my-extra-package(s)]]></screen><para>The PXE installation uses <code>/srv/tftp/debian-edu/install.cfg</code> and the preseeding file in <code>/etc/debian-edu/www/debian-edu-install.dat</code>. These files can be changed to adjust the preseeding used during installation, to avoid more questions when installing over the net. Another way to achieve this is to provide extra settings in <code>/etc/debian-edu/pxeinstall.conf</code> and <code>/etc/debian-edu/www/debian-edu-install.dat.local</code> and to run <code>/usr/sbin/debian-edu-pxeinstall</code> to update the generated files. </para><para>Further information can be found in the <ulink url="https://www.debian.org/releases/Bullseye/installmanual">manual of the Debian Installer</ulink>. </para><para>To disable or change the use of the proxy when installing via PXE, the lines containing <code>mirror/http/proxy</code>, <code>mirror/ftp/proxy</code> and <code>preseed/early_command</code> in <code>tjener:/etc/debian-edu/www/debian-edu-install.dat </code> need to be changed. To disable the use of a proxy when installing, put '#' in front of the first two lines, and remove the "<code>export http_proxy="http://webcache:3128"; </code>" part from the last one. </para><para>Some settings can not be preseeded because they are needed before the preseeding file is downloaded. These are configured in the PXElinux-based boot arguments available from <code>/srv/tftp/debian-edu/install.cfg</code>. Language, keyboard layout and desktop are examples of such settings. </para></section><section><title>Custom images</title><para>Creating custom CDs, DVDs or Blu-ray discs can be quite easy since we use the <ulink url="https://wiki.debian.org/DebianInstaller/">Debian Installer</ulink>, which has a modular design and other nice features. <ulink url="https://wiki.debian.org/DebianInstaller/Preseed">Preseeding</ulink> allows you to define answers to the questions normally asked. </para><para>So all you need to do is to create a preseeding file with your answers (this is described in the appendix of the Debian Installer manual) and <ulink url="https://wiki.debian.org/DebianInstaller/Modify/CD">remaster the CD/DVD</ulink>. </para></section></section><section><title>Screenshot tour</title><para>The text mode and the graphical installation are functionally identical - only the appearance is different. The graphical mode offers the opportunity to use a mouse, and of course looks much nicer and more modern. Unless the hardware has trouble with the graphical mode, there is no reason not to use it. </para><para>So here is a screenshot tour through a graphical 64-bit Main Server + Workstation + LTSP Server installation and how it looks at the first boot of the main server and a PXE boot on the LTSP client network (thin client session screen - and login screen after the session on the right has been clicked). </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=01-Installer_64bit_boot_menu.png"/></imageobject><textobject><phrase>01-Installer_64bit_boot_menu.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=02-select_a_language.png"/></imageobject><textobject><phrase>02-select_a_language.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=03-select_your_location.png"/></imageobject><textobject><phrase>03-select_your_location.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=04-Configure_the_keyboard.png"/></imageobject><textobject><phrase>04-Configure_the_keyboard.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=05-Detect_network_hardware.png"/></imageobject><textobject><phrase>05-Detect_network_hardware.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=06-Choose_Debian_Edu_profile.png"/></imageobject><textobject><phrase>06-Choose_Debian_Edu_profile.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=07-Really_use_the_automatic_partitioning_tool_0.png"/></imageobject><textobject><phrase>07-Really_use_the_automatic_partitioning_tool_0.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=08-Really_use_the_automatic_partitioning_tool_1.png"/></imageobject><textobject><phrase>08-Really_use_the_automatic_partitioning_tool_1.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=09-Participate_in_the_package_usage_survey_0.png"/></imageobject><textobject><phrase>09-Participate_in_the_package_usage_survey_0.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=10-Participate_in_the_package_usage_survey_1.png"/></imageobject><textobject><phrase>10-Participate_in_the_package_usage_survey_1.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=11-Set_up_users_and_passwords_root.png"/></imageobject><textobject><phrase>11-Set_up_users_and_passwords_root.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=12-Set_up_users_and_passwords_user_full_name.png"/></imageobject><textobject><phrase>12-Set_up_users_and_passwords_user_full_name.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=13-Set_up_users_and_passwords_username.png"/></imageobject><textobject><phrase>13-Set_up_users_and_passwords_username.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=14-Set_up_users_and_passwords_user_password.png"/></imageobject><textobject><phrase>14-Set_up_users_and_passwords_user_password.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=21-Finish_the_Installation-Installation_complete.png"/></imageobject><textobject><phrase>21-Finish_the_Installation-Installation_complete.png</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=22-Tjener-LightDM-Login.png" width="800"/></imageobject><textobject><phrase>tjener Lightdm Login</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=26-Tjener-Xfce_Desktop_Browser.png" width="800"/></imageobject><textobject><phrase>Xfce and Browser</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=27-Tjener-Xfce_Desktop.png" width="800"/></imageobject><textobject><phrase>Xfce Desktop</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=24-Thin-Client-Welcome.png" width="800"/></imageobject><textobject><phrase>Thin-Client-Welcome</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/Installation?action=AttachFile&do=get&target=25-Thin-Client-Login.png" width="800"/></imageobject><textobject><phrase>Thin-Client-Login</phrase></textobject></inlinemediaobject> </para><para><ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/CategoryPermalink#">CategoryPermalink</ulink> </para></section></section><para><anchor id="GettingStarted"/> </para><section><title>Getting started</title><section><title>Minimum steps to get started</title><para>During installation of the main server a first user account was created. In the following text this account will be referenced as "first user". This account is special, as there's no Samba account (can be added via GOsa²), the home directory permission is set to 700 (so <code>chmod o+x ~</code> is needed to make personal web pages accessible), and the first user can use <code>sudo</code> to become root. </para><para>See the information about Debian Edu specific <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Architecture#File_system_access_configuration">file system access configuration</ulink> before adding users; adjust to your site's policy if needed. </para><para>After the installation, the first things you need to do as first user are: </para><orderedlist numeration="arabic"><listitem><para>Log into the server. </para></listitem><listitem><para>Add users with GOsa². </para></listitem><listitem><para>Add workstations with GOsa² - thin-client and diskless workstation can be used directly without this step. </para></listitem></orderedlist><para>Adding users and workstations is described in detail below, so please read this chapter completely. It covers how to perform these minimum steps correctly as well as other stuff that everybody will probably need to do. </para><para>There is additional information available elsewhere in this manual: the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Features#">New features in Bullseye</ulink> chapter should be read by everyone who is familiar with previous releases. And for those upgrading from a previous release, make sure to read the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/Upgrades#">Upgrades</ulink> chapter. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.debian.org/htdocs/debwiki/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> If generic DNS traffic is blocked out of your network and you need to use some specific DNS server to look up internet hosts, you need to tell the DNS server to use this server as its "forwarder". Update /etc/bind/named.conf.options and specify the IP address of the DNS server to use. </para><para>The <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/HowTo#">HowTo</ulink> chapter covers more tips and tricks and some frequently asked questions. </para><para>{{attachment:27-Tjener-Xfce_Desktop.png}} </para><section><title>Services running on the main server</title><para>There are several services running on the main server which can be managed via a web management interface. We'll describe each service below. </para></section></section><section><title>Introduction to GOsa²</title><para>GOsa² is a web based management tool that helps to manage some important parts of your Debian Edu setup. With GOsa² you can manage (add, modify, or delete) these main groups: </para><itemizedlist><listitem><para>User Administration </para></listitem><listitem><para>Group Administration </para></listitem><listitem><para>NIS Netgroup Administrator </para></listitem><listitem><para>Machine Administration </para></listitem><listitem><para>DNS Administration </para></listitem><listitem><para>DHCP Administration </para></listitem></itemizedlist><para>For GOsa² access you need the Skolelinux main server and a (client) system with a web browser installed which can be the main server itself if it was installed as a so called combined server (Main Server + LTSP Server + Workstation profiles). </para><para>If you (probably accidentally) installed a pure main-server profile and don't have a client with a web-browser handy, it's easy to install a minimal desktop on the main server using this command sequence in a (non-graphical) shell as the user you created during the main server's installation (first user): </para><screen><![CDATA[ $ sudo apt update
$ sudo apt install task-desktop-xfce lightdm education-menus
### after installation, run 'sudo service lightdm start'
### login as first user]]></screen><para>From a web browser use the URL <ulink url="https://www/gosa"/> for GOsa² access, and log in as the first user. </para><itemizedlist><listitem><para>If you are using a new Debian Edu Bullseye machine, the site certificate will be known by the browser. </para></listitem><listitem><para>Otherwise, you will get an error message about the SSL certificate being wrong. If you know you are alone on your network, just tell the browser to accept it and ignore that. </para></listitem></itemizedlist><section><title>GOsa² Login plus Overview</title><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/GettingStarted?action=AttachFile&do=get&target=gosa2_overview.png" width="800"/></imageobject><textobject><phrase>GOsa² overview page after login as the first user</phrase></textobject></inlinemediaobject> </para><para>After logging in to GOsa² you will see the overview page of GOsa². </para><para>Next, you can choose a task in the menu or click any of the task icons on the overview page. For navigation, we recommend using the menu on the left side of the screen, as it will stay visible there on all administration pages offered by GOsa². </para><para>In Debian Edu, account, group, and system information is stored in an LDAP directory. This data is used not only by the main server, but also by the (diskless) workstations, the LTSP servers and the Windows machines on the network. With LDAP, account information about students, teachers, etc. only needs to be entered once. After information has been provided in LDAP, the information will be available to all systems on the whole Skolelinux network. </para><para>GOsa² is an administration tool that uses LDAP to store its information and provide a hierarchical department structure. To each "department" you can add user accounts, groups, systems, netgroups, etc. Depending on the structure of your institution, you can use the department structure in GOsa²/LDAP to transfer your organisational structure into the LDAP data tree of the Debian Edu main server. </para><para>A default Debian Edu main server installation currently provides two "departments": Teachers and Students, plus the base level of the LDAP tree. Student accounts are intended to be added to the "Students" department, teachers to the "Teachers" department; systems (servers, Skolelinux workstations, Windows machines, printers etc.) are currently added to the base level. Find your own scheme for customising this structure. (You can find an example how to create users in year groups, with common home directories for each group in the <ulink url="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/AllInOne/DebianEdu/Documentation/Bullseye/HowTo/AdvancedAdministration#Create_Users_in_Year_Groups">HowTo/AdvancedAdministration</ulink> chapter of this manual.) </para><para>Depending on the task that you want to work on (manage users, manage groups, manage systems, etc.) GOsa² presents you with a different view on the selected department (or the base level). </para></section></section><section><title>User Management with GOsa²</title><para>First, click on "Users" in the left navigation menu. The right side of the screen will change to show a table with department folders for "Students" and "Teachers" and the account of the GOsa² Administrator (the first created user). Above this table you can see a field called <emphasis>Base</emphasis> that allows you to navigate through your tree structure (move your mouse over that area and a drop-down menu will appear) and to select a base folder for your intended operations (e.g. adding a new user). </para><section><title>Adding users</title><para>Next to that tree navigation item you can see the "Actions" menu. Move your mouse over this item and a submenu appears on screen; choose "Create" here, and then "User". You will be guided by the user creation wizard. </para><itemizedlist><listitem><para>The most important thing to add is the template (newstudent or newteacher) and the full name of your user (see image). </para></listitem><listitem><para>As you follow the wizard, you will see that GOsa² generates a username automatically based on the real name. It automatically chooses a username that doesn't exist yet, so multiple users with the same full name are not a problem. Note that GOsa² can generate invalid usernames if the full name contains non-ASCII characters. </para></listitem><listitem><para>If you don't like the generated username you can select another username offered in the drop-down box, but you do not have a free choice here in the wizard. (If you want to be able to edit the proposed username, open <code>/etc/gosa/gosa.conf</code> with an editor and add <code>allowUIDProposalModification="true"</code> as an additional option to the "location definition".) </para></listitem><listitem><para>When the wizard has finished, you are presented with the GOsa² screen for your new user object. Use the tabs at the top to check the completed fields. </para></listitem></itemizedlist><para>After you have created the user (no need to customise fields the wizard has left empty for now), click on the "Ok" button in the bottom-right corner. </para><para>As the last step GOsa² will ask for a password for the new user. Type that in twice and then click "Set password" in the bottom-right corner. <inlinemediaobject><imageobject><imagedata depth="16" fileref="https://wiki.debian.org/htdocs/debwiki/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> Some characters may not be allowed as part of the password. </para><para>If all went well, you can now see the new user in the user list table. You should now be able to log in with that username on any Skolelinux machine within your network. </para></section><section><title>Search, modify and delete users</title><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/GettingStarted?action=AttachFile&do=get&target=filterbox.png" width="800"/></imageobject><textobject><phrase>Filterbox</phrase></textobject></inlinemediaobject> </para><para>To modify or delete a user, use GOsa² to browse the list of users on your system. On the middle of the screen you may open the "Filter" box, a search tool provided by GOsa². If you don't know the exact location of your user account in your tree, change to the base level of the GOsa²/LDAP tree and search there with the option marked "Search in subtrees". </para><para>When using the "Filter" box, results will immediately appear in the middle of the text in the table list view. Every line represents a user account and the items farthest to the right on each line are little icons that provide actions for you: edit user, lock account, set password and remove user. </para><para>A new page will show up where you can directly modify information about the user, change the password of the user and modify the list of groups the user belongs to. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/GettingStarted?action=AttachFile&do=get&target=edit_user.png" width="800"/></imageobject><textobject><phrase>Editing user data</phrase></textobject></inlinemediaobject> </para></section><section><title>Set passwords</title><para>The students can change their own passwords by logging into GOsa² with their own usernames. To ease the access of GOsa², an entry called Gosa is provided in the desktop's System (or System settings) menu. A logged-in student will be presented with a very minimal version of GOsa² that only allows access to the student's own account data sheet and to the set-password dialog. </para><para>Teachers logged in under their own usernames have special privileges in GOsa². They are shown a more privileged view of GOsa², and can change the passwords for all student accounts. This may be very handy during class. </para><para>To administratively set a new password for a user </para><orderedlist numeration="arabic"><listitem><para>search for the user to be modified, as explained above </para></listitem><listitem><para>click on the key symbol at the end of the line that the username is shown in </para></listitem><listitem><para>on the page subsequently presented you can set a new password chosen by yourself </para></listitem></orderedlist><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/GettingStarted?action=AttachFile&do=get&target=change_password_administratively.png" width="800"/></imageobject><textobject><phrase>Set user password</phrase></textobject></inlinemediaobject> </para><para><emphasis role="strong">Beware of security implications due to easy to guess passwords!</emphasis> </para></section><section><title>Advanced user management</title><para>It is possible to mass-create users with GOsa² by using a CSV file, which can be created with any good spreadsheet software (for example <code>localc</code>). At least, entries for the following fields have to be provided: uid, last name (sn), first name (givenName) and password. Make sure that there are no duplicate entries in the uid field. Please note that the check for duplicates must include already existing uid entries in LDAP (which could be obtained by executing <code>getent passwd | grep tjener/home | cut -d":" -f1</code> on the command line). </para><para>These are the format guidelines for such a CSV file (GOsa² is quite intolerant about them): </para><itemizedlist><listitem><para>Use "," as field separator </para></listitem><listitem><para>Do not use quotes </para></listitem><listitem><para>The CSV file <emphasis role="strong">must not</emphasis> contain a header line (of the sort that normally contains the column names) </para></listitem><listitem><para>The order of the fields is not relevant, and can be defined in GOsa² during the mass import </para></listitem></itemizedlist><para>The mass import steps are: </para><orderedlist numeration="arabic"><listitem><para>click the "LDAP Manager" link in the navigation menu on the left </para></listitem><listitem><para>click the "Import" tab in the screen on the right </para></listitem><listitem><para>browse your local disk and select a CSV file with the list of users to be imported </para></listitem><listitem><para>choose an available user template that should be applied during mass import (such as NewTeacher or NewStudent) </para></listitem><listitem><para>click the "Import" button in the bottom-right corner </para></listitem></orderedlist><para>It's a good idea to do some tests first, preferably using a CSV file with a few fictional users, which can be deleted later. </para><para>Same applies to the password management module, which allows to reset a lot of passwords using a CSV file or to re-generate new passwords for users belonging to a special LDAP subtree. </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/GettingStarted?action=AttachFile&do=get&target=reset_passwords.png" width="800"/></imageobject><textobject><phrase>Reset passwords</phrase></textobject></inlinemediaobject> </para></section></section><section><title>Group Management with GOsa²</title><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/GettingStarted?action=AttachFile&do=get&target=create_group.png" width="800"/></imageobject><textobject><phrase>create group</phrase></textobject></inlinemediaobject> </para><para><inlinemediaobject><imageobject><imagedata fileref="https://wiki.debian.org/DebianEdu/Documentation/Bullseye/GettingStarted?action=AttachFile&do=get&target=list_groups.png" width="800"/></imageobject><textobject><phrase>create group</phrase></textobject></inlinemediaobject> </para><para>The management of groups is very similar to the management of users. </para><para>You can enter a name and a description per group. Make sure that you choose the right level in the LDAP tree when creating a new group. </para><para>By default, the appropriate Samba group isn't created. If you forgot to check the Samba group option during group creation, you can modify the group later on. </para><para>Adding users to a newly created group takes you back to the user list, where you most probably would like to use the filter box to find users. Check the LDAP tree level, too. </para><para>The groups entered in the group management are also regular unix groups, so you can use them for file permissions too. </para><section><title>Group Management on the command line</title><screen><![CDATA[# List existing group mapping between UNIX and Windows groups.
View it on GitLab: https://salsa.debian.org/debian-edu/debian-edu-doc/-/commit/9544a9ee001263215f33714e1696916ae0a37bb6
--
View it on GitLab: https://salsa.debian.org/debian-edu/debian-edu-doc/-/commit/9544a9ee001263215f33714e1696916ae0a37bb6
You're receiving this email because of your account on salsa.debian.org.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://alioth-lists.debian.net/pipermail/debian-edu-commits/attachments/20200909/73fbdd38/attachment-0001.html>
More information about the debian-edu-commits
mailing list