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



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

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

Das Men"u bietet folgende M"oglichkeiten:

\begin{tabular}{llll}
 & 1. & \jump{MENUPACKAGELIST}{List installed packages} -- Installierte Pakete
              anzeigen \\
 & 2. & \jump{MENUPACKAGEINSTALL}{Install package from URL} -- Pakete von
              einer einzelnen URL installieren \\
 & 3. & \jump{MENUPACKAGECHANGE}{Download URL administration} -- Download-URL
              bearbeiten \\
 & 4. & \jump{MENUREMOVEPACKAGE}{Remove Package} -- Pakete l"oschen \\
 & 5. & \jump{MENUEPACKEIS}{Search package} -- Pakete suchen  \\
 & 6. & \jump{MENUEINSTALLLOG}{Logfile view} -- Anzeige der Download
              URL error-log\\
% & 0. & \jump{MENUMAIN}{Exit} -- Zur"uck ins Hauptmen"u \\
\end{tabular}


An dieser Stelle noch ein paar Worte zu der Aufteilung der Pakete. Das
Installationsprogramm liest "Ubersichtsdateien (sie hei"sen gew"ohnlich
"`eis-list.txt\grqq), in der Angaben zu den einzelnen Paketen gemacht werden.
Daneben k"onnen auch noch andere "Ubersichtsdateien auf anderen Paket-Server
verlinkt sein. Daraus ergibt sich eine vorz"ugliche M"oglichkeit, die
komplette Paketstruktur dezentral zu organisieren, und die Entwicklung und
Wartung auf bestimmte Personen zu delegieren, die ihrerseits ihr Aufgabengebiet
weiter aufteilen k"onnen, indem sie wiederum andere Paket-Server verlinken.

F"ur das Aufbauen einer lokalen Mirrorhierarchie siehe auch im Anhang
\jump{APPENDIXMIRROR}{Aufbau eines Mirrors}





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

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.






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

Hinter diesem Punkt verbergen sich die Funktionen zum Durchsuchen der
\eisfair-Paketstruktur. Hier im \index{Packagebrowser} wird stets der Inhalt
einer kompletten "Ubersichtsdatei angezeigt. Bei dieser Auswahl wird die
Liste der hinterlegten Download URL angezeigt, die im Men"upunkt
\jump{MENUPACKAGECHANGE}{Download URL administration} bearbeitet wird. Es
besteht auch die M"oglichkeit, eine bestimmte "Ubersichtsseite darstellen
zu lassen, indem man einem 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}


Nach Auswahl von '1' gibt es das Angebot vom Haupt-Download-Server Pack-Eis.

\begin{small}
\begin{verbatim}
Install package - http://download.eisfair.org/packages/eis-list.txt

  Welcome to the official eisfair package server download.eisfair.org

  Main eis-list

  Your eisfair server, base version, is up to date.

     1. >     eisfair system updates
     2. >     web - Webtools (Apache / Squid / ...)
     3. >     backup - Packages for backup jobs
     4. >     base - System and kernel packages
     5. >     chat - Packages all types of chat
     6. >     communication - Office communication
     7. >     contrib - Helper packages for multiple usage
     8. >     database - Database packages
     9. >     devel - Packages for development
    10. >     drivers - Device drivers
    11. >     game - Gameserver and things like that
    12. >     plang - Programming languages and modules
    13. >     printer-file - Printer / File Services
    14. >     dev - Developer Packages - unstable!
    15. >     Pack-Eis uploaded user-packages
    16. >     lib - Libraries
    17. >     libdev - Library header packages
    18. >     mail - Mail packages
    19. >     news - Newsreader
    20. >     misc - Misc packages which fit nowhere else
    21. >     multimedia - Video or audio streaming and things like that
    22. >     netservices - Packages which offer services to your network
    23. >     netutils - Network maintenance
    24. >     security - Packages for server security
    25. >     system - System tools
    26. >     utils - Several utilities

  Last database update: 2015-11-09 08:37:02

? = unknown   - = not installed   n = New   o = Old   i = Installed   > = Link
Use SHIFT + PAGE-UP to scroll up
Select (1-26, ENTER=Return, 0=Exit)?
\end{verbatim}
\end{small}

Mit den einzelnen Nummern sind bestimmte Aktionen verbunden; entweder wird
das Paket zur Installation ausgew"ahlt und diese gestartet (siehe weiter unten),
oder man folgt einem Link.

Die Zeichen (Status) nach den Zahlen haben folgende Bedeutung:

\begin{small}
\begin{tabular}{llll}
 & \tt{?} & &  Dieses Paket kann vom Setup-Programm nicht richtig eingeordnet
               werden. \\
 &        & &  Dieses Zeichen sollte nie auftreten. \\
 & \tt{-} & &  Dieses Paket ist noch nicht installiert. \\
 & \tt{n} & &  Auf dem Paketserver ist eine neuere Version vorhanden als auf
               dem \eisfair-Server. \\
 & \tt{o} & &  Auf dem Paketserver ist einen "altere Version als auf dem
               Rechner.\\
 & \tt{i} & &  Dieses Paket ist in dieser Version bereits installiert.\\
 & \tt{>} & &  Diese Zeile bezeichnet einen Link auf eine andere
               "Uberssichtsseite.\\
\end{tabular}
\end{small}



Bezeichnet eine Zeile ein Paket, dann wird direkt nach dem Status die
Versionsnummer des Paketes auf dem Server angezeigt, gefolgt vom Namen
des Paketes.

Die Zeile "`last update\grqq bezeichnet den Zeitpunkt, wann diese
"Ubersichtsseite auf dem Server zuletzt ge"andert wurde.


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





\subsubsection{Installation eines Paketes}

Wenn man im Men"u ein Paket zum Download ausgew"ahlt hat, werden auf eine Reihe von Informationen "uber das zu installierende Paket anzeigt.

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

  URL:       https://www.pack-eis.de/dl.php?l=11516/mail.tar.bz2

  Name:      mail
  Package:   Mail service
  Version:   1.10.6
  Date:      2011-09-17
  Space:     10 MB required
  Author:    Juergen Edner, juergen(at)eisfair(dot)org
  Status:    stable
  Section:   mail
  Mail Services

  ALTERMIME Version: 0.3.10     EXIM        Version: 4.76
  FETCHMAIL Version: 6.3.21     UW-IMAPD    Version: 2007f.404
  MAILX     Version: 8.1        UW-IPOP3D   Version: 2007f.104
  VACATION  Version: 1.2.7.0    UW-MAILUTIL Version: 2007f.13


This package requires the following libraries:

  libssl >= 1.2.14 - Library: OpenSSL


Install (y=yes, n=no, a=all)?
\end{verbatim}
\end{small}

Hier kann man sich eine ausf"uhrliche Beschreibung des Paketes anschauen
und sich informieren, ob das Paket die gew"unschten Anforderungen erf"ullt.
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. Um alles ohne weitere Nachfrage zu installieren erfolgt dies
durch Eingabe von \taste{a}.

Wenn die Installation fortgesetzt werden soll, wird das Paket vom Paketserver
heruntergeladen; dieser Vorgang wird angezeigt, auch ist eine st"andige
Fortschrittsanzeige verf"ugbar. Nachdem das Paket heruntergeladen wurde,
wird es entpackt und installiert. W"ahrend der Installation k"onnen eine
Reihe von Meldungen erscheinen (je nach Paket); 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 das Paket installiert wurde, wird wieder erneut der
\jump{MENUPACKAGEINSTALL}{Packagebrowser} angezeigt.







\marklabel{MENUPACKAGECHANGE}{\subsubsection{Download-URL bearbeiten}}

Mit diesem Men"upunkt kann die Adresse einer "Ubersichtsseite konfiguiriert
und bearbeitet werden.

Die Parameter der URL Konfiguration:

\begin{description}

\config{URL\_N}{URL\_N}{URRLN}
{
    Bei diesem Parameter wird angegeben, wieviele URL
    konfiguriert werden sollen.

    G"ultige Werte: Zahl

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


\config{URL\_x\_NAME}{URL\_x\_NAME}{URLxNAME}
{
    Hier kann ein Name f"ur diese URL angegeben werden. Der Name wird nicht
    ausgewertet und dient lediglich der "Ubersichtlichkeit. Wird dieses Feld
    leer gelassen, wird bei der Paketinstallation die URL angezeigt,
    anderenfalls der hier angegebene Wert.

    G"ultige Werte: Name

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


\config{URL\_x\_PATH}{URL\_x\_PATH}{URLxPATH}
{
    Hier wird der komplette Pfad zur eislist eingeben. Das 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}
{
    Hier wird angegeben, ob diese URL zus"atzlich zum suchen von
    Paketen aktiviert werden soll.

    G"ultige Werte: yes, no

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


\config{URL\_x\_PRIORITY}{URL\_x\_PRIORITY}{URLxPRIORITY}
{
    Hier wird angegeben, welchen Rang diese URL bei der Installation
    hat, damit ist es m"oglich Zusatzpakete die erforderlich sind,
    (require) z.B. von einem eigenen Mirror zu installieren.

    G"ultige Werte: high, normal, low

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


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

    G"ultige Werte: Zahl

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


\config{URL\_LOGROTATE\_INTERVAL}{URL\_LOGROTATE\_INTERVAL}{URLLOGROTATEINTERVAL}
{
    Dieser Parameter bestimmt in welchen Intervallen die Logdateien
    archiviert werden sollen. Zur Auswahl stehen die
    Schluesselw"orter. \\
    'daily' - t"aglich \\
    'weekly' - w"ochentlich \\
    'monthly' - monatlich \\

    G"ultige Werte: daily, weekly, monthly

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

\end{description}








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

Durch Auswahl '4 Remove Package' erscheint eine Liste aller "uber das
Installationsmen"u installierten Programmpakete samt Versionsnummer und
Erstelldatum.

\begin{small}
\begin{verbatim}
Remove packages (only removeable packages are listed)

  1. a2ps                           1.4.0                    2008-05-18
  2. antispam                       1.9.0                    2010-09-21
  3. apache2                        1.4.5                    2010-09-13
  4. apache2_php5                   1.4.2                    2010-09-06
  5. apache2_webalizer              1.1.0                    2009-05-26
  6. apcupsd                        0.3.3                    2008-12-14
  7. archimap                       1.1.0                    2006-03-25
  8. avm_fritz-1_pci_2.6.32-eisfair 1.1.0                    2011-02-24
  9. avm_fritz_pci_2.4.26-1         1.3.1                    2007-02-18
 10. avm_fritz_pci_2.4.35-wt1       1.0.3                    2009-09-09
 11. avm_fritz_usb2x_2.4.35-wt1     1.0.1                    2008-04-04
 12. babel                          0.8.0                    2011-03-13
 13. bind9                          1.2.9                    2010-03-20
 14. capi                           1.10.3                   2011-06-18
 15. capi2text                      1.1.3                    2011-07-24
 16. certs                          1.2.2                    2011-09-11
 17. clamav                         1.2.20                   2011-06-29
 18. clearsilver                    0.4.0                    2010-02-27
 19. conexant_hsf_2.4.35-wt1        0.1.2                    2008-09-21
 20. detox                          0.3.0                    2009-02-28
\end{verbatim}
\end{small}

Bei mehr als 18 installierten Paketen wird die Liste seitenweise
fortgesetzt, dazwischen erhalten Sie eine Abfrage.


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

Merken Sie sich die Nummer, die links von Ihrem zu deinstallierendem
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 Paketezahl 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 sie keine weiteren Pakete l"oschen wollen, sollten Sie wieder durch
alle Seiten mittels ENTER gehen, und auch auf der letzten dieses so
best"atigen, um zum Untermen"u 'Package Administration' zur"uckzukehren.





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


"Uber diesen Men"upunkt k"onnen Pakete gesucht werden, es wird dabei der
Index durchsucht. Welcher Index genommen wird, kann "uber den Men"upunkt
\texttt{URL\_x\_SEARCH} im \jump{MENUPACKAGECHANGE}{Download URL administration}
eingestellt werden. Der Index von Pack-Eis wird dabei immer mit
ber"ucksichtigt.

\vspace{5mm}

\achtung{Das einstellen vieler URL zum suchen, kann den Aufbau der Index
         Datei sehr beeinflussen}


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

"Uber diesen Men"upunkt k"onnen die error Meldungen angesehen, die beim
Download einer eis-list auftreten.

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

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