
% administration_packages_menu_eisman.tex
% Last Update: $Id$
% wird in administration.tex ab Zeile 852 eingefuegt



In diesem Untermen"u sind alle Funktionen untergebracht, mithilfe derer man
Pakete installieren kann.

\achtung{Die Pakete (engl. Packages) werden direkt aus dem Internet geladen
         und auf dem \eisfair-Server installiert. Es ist kein Zwischenschritt
         "uber einen anderen Rechner erforderlich, auf dem dieses Paket
         konfiguriert wird. Die Konfiguration wird direkt auf dem \eisfair-Server
         vorgenommen.}

Das Men"u bietet folgende Auswahlm"oglichkeiten:

\begin{tabular}{lrll}
 & 1. & View documentaion \\
 & 2. & \jump{MENUPACKAGECHANGE}{Administration of package URLs} -- Download-URLs
              bearbeiten \\
 & 3. &      Advanced configuration file handling \\
 & 4. &      Show status \\
 & 5. & \jump{MENUPACKAGEUPDATE}{Update local database} -- Lokale Datenbank
              aktualisieren \\
 & 6. & \jump{MENUPACKAGELIST}{Manage installed packages} -- Installierte Pakete
              bearbeiten \\
 & 7. & \jump{MENUEPACKEINSTALL}{Install package} -- Pakete installieren  \\
 & 8. & \jump{MENUEPACKEIS}{Install package by search} -- Pakete suchen
              und installieren  \\
 & 9. & \jump{MENUPACKAGEINSTALLURL}{Install package from URL} -- Pakete von
              einem bestimmten Paketserver installieren \\
 & 10. & \jump{MENUREMOVEPACKAGE}{Uninstall package} -- Pakete l"oschen \\
 & 11. & \jump{MENUEINSTALLLOG}{Logfile view} -- Anzeige der Download
              URL error-log\\

\end{tabular}



Auf Wunsch kann der Inhalt des eisfair-Installationsservers gespiegelt
werden um ein lokales Installationsrepository (Mirror) zu erstellen.
Eine detaillierte Beschreibung findet sich hierzu im Anhang im Kapitel
\jump{APPENDIXMIRROR}{Aufbau eines Mirrors}.



\marklabel{MENUPACKAGECHANGE}{\subsubsection{Administration of package URLs}}

"Uber diesen Men"upunkt k"onnen die Adressen (URL) von \eisfair Paketservern
konfiguriert, sowie die automatische Aktualisierung der Paketdatenbank
gesteuert werden.


Die Parameter der Konfiguration:

\begin{description}

\config{URL\_UPDATE\_PACKAGES\_DB}
{URL\_UPDATE\_PACKAGES\_DB}
{URLUPDATEPACKAGESDB}
{
    "Uber diesen Parameter legt man fest, ob die Paketdatenbank
    automatisch aktualisiert werden soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{URL\_UPDATE\_PACKAGES\_DB='no'}
}


\config{URL\_UPDATE\_PACKAGES\_DB\_SCHEDULE}
{URL\_UPDATE\_PACKAGES\_DB\_SCHEDULE}
{URLUPDATEPACKAGESDBSCHEDULE}
{
    "Uber diesen Parameter legt man fest, ob die Datenbank automatisch
    aktualisert werden soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{URL\_UPDATE\_PACKAGES\_DB\_SCHEDULE='no'}
}


\config{URL\_UPDATE\_PACKAGES\_DB\_SCHEDULE\_TIME}
{URL\_UPDATE\_PACKAGES\_DB\_SCHEDULE\_TIME}
{URLUPDATEPACKAGESDBSCHEDULETIME}
{
    "Uber diesen Parameter legt man fest, zu welchen Zeiten die Datenbank
    aktualisert werden soll.

\input{systemd_time_definition}

    Standardeinstellung: \texttt{URL\_UPDATE\_PACKAGES\_DB\_SCHEDULE\_TIME='*-*-* 05:00:00'}
}


\config{URL\_UPDATE\_PACKAGES\_DB\_INIT}
{URL\_UPDATE\_PACKAGES\_DB\_INIT}
{URLUPDATEPACKAGESDBINIT}
{
    "Uber diesen Parameter legt man fest, ob die Paketdatenbank beim
    Start des Systems aktualisiert werden soll. Diese Variante ist
    bei Systemen hilfreich, die nicht kontinuierlich laufen.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{URL\_UPDATE\_PACKAGES\_DB\_INIT='no'}
}


\config{URL\_UPDATE\_PACKAGES\_DB\_MAIL}
{URL\_UPDATE\_PACKAGES\_DB\_MAIL}
{URLUPDATEPACKAGESDBMAIL}
{
    "Uber diesen Parameter legt man fest, ob man "uber das Ergebnis
    der Aktualisierung der Paketdatenbank per E-Mail informiert werden
    m"ochte.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{URL\_UPDATE\_PACKAGES\_DB\_MAIL='no'}
}


\config{URL\_UPDATE\_PACKAGES\_DB\_MAIL\_TYPE}
{URL\_UPDATE\_PACKAGES\_DB\_MAIL\_TYPE}
{URLUPDATEPACKAGESDBMAILTYPE}
{
    "Uber diesen Parameter legt man den Umfang der Benachrichtigungen
    fest, d.h. ob man "uber Paketaktualisierungen f"ur alle oder nur
    die installierten Pakete informiert werden m"ochte.

    G"ultige Werte: all, installed

    Standardeinstellung: \texttt{URL\_UPDATE\_PACKAGES\_DB\_MAIL\_TYPE='all'}
}


\config{URL\_UPDATE\_PACKAGES\_DB\_MAIL\_ADDR}
{URL\_UPDATE\_PACKAGES\_DB\_MAIL\_ADDR}
{URLUPDATEPACKAGESDBMAILADDR}
{
    "Uber diesen Parameter legt man die E-Mail Adresse fest, an welche
    das Ergebnis der Aktualisierung der Paketdatenbank gesandt werden
    soll.

    G"ultige Werte: Mailadresse

    Standardeinstellung: \texttt{URL\_UPDATE\_PACKAGES\_DB\_MAIL\_ADDR='{}'}
}


\config{URL\_N}
{URL\_N}
{URRLN}
{
    "Uber diesen Parameter legt man fest wie viele \eisfair Paketserver
    konfiguriert werden sollen.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{URL\_N='2'}
}


\config{URL\_x\_NAME}
{URL\_x\_NAME}
{URLxNAME}
{
    "Uber diesen Parameter kann auf Wunsch ein Name f"ur den angegebenen
    \eisfair Paketserver festgelegt werden, von dem zuk"unftig Pakete
    abgerufen bzw. installiert werden sollen. Der Name wird nicht
    ausgewertet und dient lediglich der "Ubersichtlichkeit. Wird dieses
    Parameter leer gelassen, wird bei der Paketinstallation die
    konfigurierte Adresse (URL) des Paketservers angezeigt, sonst wird
    der hier festgelegte Name verwendet.

    G"ultige Werte: Name des \eisfair Paketservers

    Standardeinstellung: \texttt{URL\_x\_NAME='{}'}
}


\config{URL\_x\_PATH}
{URL\_x\_PATH}
{URLxPATH}
{
    "Uber diesen Parameter wird der komplette Pfad zur eislist eingeben.
    Dieser kann entweder eine URL ('http://...' bzw. 'https://...') oder
    auch ein Pfad im Dateisystem ('file:///...') sein. Bitte die drei
    Slashes im letzten Fall beachten!

    G"ultige Werte: Pfad

    Standardeinstellung: \texttt{URL\_x\_PATH='{}'}
}


\config{URL\_x\_SEARCH}
{URL\_x\_SEARCH}
{URLxSEARCH}
{
    "Uber diesen Parameter wird festgelegt, ob die angegebene
    Adresse (URL) auch zum Suchen von Paketen verwendet werden
    soll.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{URL\_x\_SEARCH='yes'}
}


\config{URL\_x\_PRIORITY}
{URL\_x\_PRIORITY}
{URLxPRIORITY}
{
    "Uber diesen Parameter wird festgelegt welchen Rang die
    angegebene Adresse (URL) bei der Installation einnehmen
    soll. Dies erm"oglicht z.B. die Installation erforderlicher
    Zusatzpakete von einem lokalen Installationsrepository
    (Mirror).

    G"ultige Werte: high, normal, low

    Standardeinstellung: \texttt{URL\_x\_PRIORITY='low'}
}


\config{URL\_x\_SECTION}
{URL\_x\_SECTION}
{URLxSECTION}
{
    "Uber diesen Parameter wird festgelegt ob die Pakete die an
    dieser URL angeboten werden, in Sektionen unterteilt werden
    oder alles in einer einzigen Liste aufgelistet wird.

    G"ultige Werte: yes, no

    Standardeinstellung: \texttt{URL\_x\_SECTION='no'}
}


\config{URL\_LOGROTATE\_COUNT}
{URL\_LOGROTATE\_COUNT}
{URLLOGROTATECOUNT}
{
    "Uber diesen Parameter wird festgelegt, wie viele Logdateien
    (URL download error) vorgehalten werden sollen. Wird dieser
    Wert "uberschritten, so wird jeweils die "alteste Logdatei
    gel"oscht.

    G"ultige Werte: Zahl

    Standardeinstellung: \texttt{URL\_LOGROTATE\_COUNT='6'}
}


\config{URL\_LOGROTATE\_INTERVAL}
{URL\_LOGROTATE\_INTERVAL}
{URLLOGROTATEINTERVAL}
{
    "Uber diesen Parameter legt man den Intervall fest, in dem die
    Logdatei archiviert werden soll. Es kann zwischen folgenden
    Einstellungen gew"ahlt werden:\\
    'daily' - t"aglich \\
    'weekly' - w"ochentlich \\
    'monthly' - monatlich \\

    G"ultige Werte: daily, weekly, monthly

    Standardeinstellung: \texttt{URL\_LOGROTATE\_INTERVAL='monthly'}
}

\end{description}


\marklabel{MENUPACKAGEUPDATE}{\subsubsection{Lokale Datenbank aktualisieren}}

Dieser Men"upunkt muss immer vor der Installation eines neuen Paketes
aufgerufen werden, um die Paketdatenbank zu aktualisieren. Es sei denn
die automatische Aktualisierung der Paketdatenbank wurde bereits "uber
den Men"upunkt \jump{MENUPACKAGECHANGE}{Administration of package URLs}
aktiviert.


\marklabel{MENUPACKAGELIST}{\subsubsection{Installierte Pakete bearbeiten}}

Dieser Men"upunkt bietet keine weiteren Auswahlm"oglichkeiten, sondern
listet nur alle bereits installierten Pakete, ihre Versionsnummer und
deren letztes "Anderungsdatum auf. Mit \taste{Enter} kann diese Ansicht
verlassen werden. Auf Wusch k"onnen "uber diesen Men"upunkt auch einzelne
Pakete deinstalliert werden.


\marklabel{MENUEPACKEINSTALL}{\subsubsection{Installation eines Paketes}}

Wenn man im Men"u ein Paket zum Installation bzw. Download ausgew"ahlt
hat, werden eine Reihe von Informationen "uber dieses angezeigt.


% hier mal was neueres
\begin{small}
\begin{verbatim}
Package: Mail service

  Name:      mail
  Package:   Mail service
  Version:   1.12.9
  Date:      2016-07-04
  Author:    Juergen Edner, juergen(at)eisfair(dot)org
  Status:    stable
  Section:   mail
  Url:       https://www.pack-eis.de/dl.php?l=18300/mail.tar.bz2

  Mail Services

  Reminder:
  By default the included program components are licensed
  under GPLv2 or later, except for the following components:

  alterMIME  - Copyright (c) 2000 P.L.Daniels, All rights reserved.
  Panda-IMAP - Licensed under the Apache v2.0 license.

  ALTERMIME Version: 0.3.10     EXIM           Version: 4.87
  FETCHMAIL Version: 6.3.26     PANDA-IMAPD    Version: 2010.417
  MAILX     Version: 8.1        PANDA-IPOP3D   Version: 2010.104
  VACATION  Version: 1.2.7.1    PANDA-MAILUTIL Version: 2010



  The following packages will be installed:

  version  status   name              source
  ---------------------------------------------------------
  2.6.1    stable   libmetalink       https://www.pack-eis.de/dl.php?l=177...
  2.6.0    stable   libcares          https://www.pack-eis.de/dl.php?l=162...
  2.6.6    stable   libcurl           https://www.pack-eis.de/dl.php?l=180...
  2.6.1    stable   geoip             https://www.pack-eis.de/dl.php?l=183...
  2.6.0    stable   libtidyp          https://www.pack-eis.de/dl.php?l=162...
  2.6.1    stable   libkrb5           https://www.pack-eis.de/dl.php?l=174...
  1.4.4    stable   libpq-5           https://www.pack-eis.de/dl.php?l=157...
  2.8.1    stable   libmysql          https://www.pack-eis.de/dl.php?l=178...
  2.6.3    stable   perl_addons_01    https://www.pack-eis.de/dl.php?l=178...
  1.0.2    stable   djbdns            https://www.pack-eis.de/dl.php?l=145...
  2.2.0    stable   detox             https://www.pack-eis.de/dl.php?l=142...
  1.4.5    stable   certs             https://www.pack-eis.de/dl.php?l=178...
  1.12.9   stable   mail              https://www.pack-eis.de/dl.php?l=183...

  13 package(s) using approx. 104 MB of disk space.

Install package (y/n) [no]?
\end{verbatim}
\end{small}

"Uber die ausf"uhrliche Beschreibung des Paketes kann man sich "uber
dessen Funktion informieren und entscheiden ob das Paket den gew"unschten
Anforderungen entspricht.
Mit der Eingabe von \taste{y} kann die Installation fortgesetzt werden,
mit der Eingabe von \taste{n} wird sie abgebrochen. Wenn das Paket weitere
Pakete ben"otigt die aktualisiert werden m"ussen, wird dies zus"atzlich
angezeigt.

Hat man sich zur Installation des Paketes entschlossen, wird dieses inklusive
eventuell erforderlicher Zusatzpakete vom Paketserver herunter geladen.
Eine Fortschrittsanzeige gibt Auskunft dar"uber wie weit die Installation
fortgeschritten ist. Nachdem das Paket heruntergeladen wurde, wird es
entpackt und installiert. W"ahrend der Installation k"onnen paketabh"angig
eine Reihe von Meldungen angezeigt werden. Diese Meldungen sollte man sich
genau anschauen und eventuelle Fehlermeldungen aufschreiben, um sie dann
dem Paketautor "uber die \link{https://www.eisfair.org/newsgroup/}{\eisfair-Newsgroup}
mitzuteilen.

Nachdem ein Paket erfolgreich installiert wurde, wird erneut der
\jump{MENUPACKAGEINSTALL}{Packagebrowser} angezeigt.


\marklabel{MENUEPACKEIS}{\subsubsection{Pakete suchen}}


"Uber diesen Men"upunkt k"onnen Pakete "uber den Paketindex gesucht werden.
Der Umfang des Paketindexes, wird "uber den Men"upunkt \texttt{URL\_x\_SEARCH}
im \jump{MENUPACKAGECHANGE}{Administration of package URLs} eingestellt.
Der Paketindex des zentralen \eisfair Paketservers (Pack-Eis) wird dabei
immer ber"ucksichtigt.

\achtung{Werden viele URLs f"ur die Suche aktiviert, o kann dies den
         Aufbau der Paketindexdatei deutlich verlangsamen}

\marklabel{MENUPACKAGEINSTALLURL}{\subsubsection{Pakete von einer einzelnen URL installieren}}

Hinter diesem Punkt verbergen sich die Funktionen zum Durchsuchen der
\eisfair-Paketstruktur. Im \index{Packagebrowser} wird dabei stets der
Inhalt einer kompletten "Ubersichtsdatei angezeigt. Bei dieser Auswahl
wird die Liste der hinterlegten Download URL angezeigt, die im Men"upunkt
\jump{MENUPACKAGECHANGE}{Administration of package URLs} bearbeitet wird.
Es besteht auch die M"oglichkeit, sich eine bestimmte "Ubersichtsseite
darstellen zu lassen, indem man dem Link von der aktuellen Seite folgt,
die auf die gew"unschte "Ubersichtsseite verweist.

\begin{small}
\begin{verbatim}
  Available package sources:

    1. >  Pack-Eis - Standard eisfair download server
    2. >  CD-ROM - local installation

Select (1-2, ENTER=Return, 0=Exit)?
\end{verbatim}
\end{small}

\achtung{Durch Auswahl dieses Men"upunktes wird eine Verbindung zum Server,
         auf dem die eingestellte "Ubersichtsdatei liegt, hergestellt. Dies
         kann bedeuten, das eine Einwahl ins Internet stattfindet.}


\marklabel{MENUREMOVEPACKAGE}{\subsubsection{Pakete l"oschen}}

Durch Auswahl des Men"upunktes 'Uninstall package' wird eine Liste
aller auf dem \eisfair Server "uber das Installationsmen"u installierten
Programmpakete, samt deren Versionsnummer und Erstelldatum, angezeigt.

\begin{small}
\begin{verbatim}
Select one of the available packages by entering the number

  Available packages: (1-15 of 103 total)

      1. i     S: 2.7.5    eisfair base runtime system update to 2.7.5
      2. i     S: 2.6.2    CAPI (Configuration for AVM-Cards)
      3. i     S: 2.2.0    Crack dictionary small
      4. i     S: 2.6.2    DAHDI-Tools - for Hardware Device Interface
      5. i     S: 2.6.2    DAHDI - Configuration for Telephony-Cards
      6. i     S: 2.6.1    D-Bus - Message Bus System
      7. i     S: 1.4.1    DSL - PPPOE
      8. i     T: 2.5.1    FaxServer for Windows- and Linux-Clients
      9. i     S: 2.20.1   eisfair Kernel (Linux 3.2.77-eisfair-1 SMP)
     10. i     T: 0.1.4    Package manager for eisfair
     11. i     S: 2.6.0    FFmpeg - convert/stream audio/video
     12. i     S: 2.18.0   Ghostscript
     13. i     S: 1.4.1    IMonD - ISDN Monitor Daemon
     14. i     S: 2.6.0    LAME - MP3 Encoder
     15. i     S: 2.6.0    Library: HE-AAC+ - High Efficiency Advanced Audio Codec


- = not installed   n = New   o = Old   i = Installed

Select (1-103, n=next page, ENTER=Return, 0=Exit)?
\end{verbatim}
\end{small}

"Ubersteigt die Liste der installierten Pakete die Zeilenzahl des
aktuellen Terminalfensters, so erfolgt die Ausgabe standarm"a"sig
seitenweise. D.h. eine Tasteneingabe ist erforderlich um sich weitere
Pakete anzeigen zu lassen.
Wurde SCROLL=yes gesetzt, wird die ganze Liste ohne Unterbrechung
angezeigt und ein entsprechender Hinweis ausgegeben.


\begin{verbatim}
Use SHIFT + PAGE-UP to scroll up
Select (1-103, ENTER=Return, 0=Exit)?
\end{verbatim}

Merken Sie sich die Nummer, die vor dem zu deinstallierenden
Paket steht.
Auf der letzten Seite wird dann
\begin{verbatim}
Select (1-[x], ENTER=Return, 0=Exit)?
\end{verbatim}
angezeigt,wobei [x] mit der lokal installierten Paketanzahl ersetzt wird.

Geben Sie hier nun die von oben gemerkte Nummer ein.
Auf der Folgeseite wird noch einmal die Paketinformation (Name, Beschreibung,
Version, Erstelldatum und Autor) ausgegeben, und am unteren Bildschirmrand

\begin{verbatim}
Remove package (y/n)?
\end{verbatim}

abgefragt.
Bei \taste{n} wird nach einer Best"atigung mittels \taste{Enter} wiederum die
Deinstallations-Paketliste angezeigt.
Bei \taste{y} erscheinen je nach Paket mehr oder weniger Ausgaben der Deistallationsroutine.

Wenn das Script durchgelaufen ist, wird
\begin{verbatim}
Package [xx] removed.
\end{verbatim}

ausgegeben, wobei statt [xx] der Paketname nochmals ausgegeben wird.
Nach einer weiteren Abfrage wird mittels \taste{Enter} wieder die
Deinstallations-Paketliste angezeigt.
Falls keine weiteren Pakete gel"oscht werden sollen, durchl"auft man
alle Seiten der Deinstallations-Paketliste durch Dr"ucken von ENTER,
um final zum Untermen"u 'Package Administration' zur"uckzukehren.


\marklabel{MENUEINSTALLLOG}{\subsubsection{Logfile view}}

"Uber diesen Men"upunkt k"onnen die Fehlermeldungen angesehen, die
eventuell beim Herunterladen (Download) einer eis-list aufgetreten
sind.

Die Liste in diesem Men"upunkt ist abh"angig von den vorhandenen log
Dateien,

\begin{tabular}{llll}
 & 1. & View log.url-error\\
\end{tabular}
