
Copyright (c) 1994 by Hochschulrechenzentrum der Universit"at Gie"sen
All rights reserved.

Author: Markus Porto
        Markus Porto@physik.uni-giessen.de

This software may be freely copied, modified, and redistributed
provided that this copyright notice is preserved on all copies.

You may not distribute this software, in whole or in part, as part of
any commercial product without the express consent of the author.

There is no warranty or other guarantee of fitness of this software
for any purpose. It is provided solely "as is".

Revision: 25. September 1994

Hallo!

Bitte lesen Sie sich diese Datei *genau* durch. Falls Sie danach immer noch
Fragen haben, haben Sie bitte keine Scheu, mit mir Kontakt aufzunehmen, meine
EMail--Adresse lautet: Markus.Porto@physik.uni-giessen.de.

Inhalt dieses Paketes:

1) .Please_read_me_first
   Dies ist die Datei, die Sie gerade lesen.

2) Configuration
   Dies ist die Konfigurationsdatei; das ist die einzige Datei, die von Ihnen
   ver"andert werden mu"s.

3) Configuration.original
   Dies ist eine Kopie der Konfigurationsdatei; dies ist gewisserma"sen eine
   Sicherheitskopie der Datei Configuration, falls Sie mal den Originalzustand
   brauchen sollten.

4) DeinstallTeXService
   Dies ist das Deinstallationsskript; diese Datei starten Sie, wenn Sie eine
   bestehende Version des TeX--Service l"oschen m"ochten, *nachdem* Sie
   die Datei Configuration an Ihre Bed"urfnisse angepa"st haben. Bitte
   verwenden Sie die alte Konfigurationsdatei *nicht*, da m"oglichweise neue
   Variablen hinzugekommen sind.

5) InstallTeXService
   Dies ist das Installationsskript; diese Datei starten Sie, *nachdem* Sie
   die Datei Configuration an Ihre Bed"urfnisse angepa"st haben. Bitte
   verwenden Sie bei einem Update die alte Konfigurationsdatei *nicht*, da
   m"oglichweise neue Variablen hinzugekommen sind.

6) tex.cgi-bin.tar
   Dies ist das Teilpaket mit den Skripten; dieses Teilpaket wird vom
   Installationsskript ausgepackt.

7) tex.html.tar
   Dies ist das Teilpaket mit den HTML--Seiten; dieses Teilpaket wird vom
   Installationsskript ausgepackt.

8) trimlogfile
   Dieses Skript k"onnen Sie zum Trimmen der von den Skripten erzeugten
   Logfiles verwenden.

Vorgehensweise zur Deinstallation:

1) Passen Sie die Datei Configuration an Ihre lokalen Bed"urfnisse an.

2) Stellen Sie sicher, das die UID/GID, unter der Sie eingeloggt sind,
   Schreibrechte auf die entsprechenden Verzeichnisse hat.

3) Starten Sie das Deinstallationsskript, der TeX--Service wird deinstalliert
   (gel"oscht). Dies wird ein paar Minuten in Anspruch nehmen.

Vorgehensweise zur Installation:

1) Stellen Sie sicher, das bei Ihnen auf dem Server folgende Programme
   installiert sind (jeweils in den neuesten Version):

   - ein C-Compiler (Standard ANSI--C) (~)(*)
   - strip (~)(*)
     Strip--Kommando

   - sh (*)
     Standard--Unix--Shell
   - date (*)
     Date--Kommando
   - perl
     Perl--Interpreter
   - archie (*)
     Archie--Client
   - sendmail (*)
     Sendmail f"ur EMail
   - virtex (+)
     TeX inklusive Eingabedateien
     Dieses Programm sollte bei einem Aufruf
       virtex '&latex \nonstopmode \input <file>'
     *nur* die Dateien <file>.dvi, <file>.aux, <file>.log usw. erzeugen und
     *nichts* sonst! (also z.B. keine Protokollierung von Aufrufen o. "a.)
   - dvips
     dvips--Umwandler
     Dieses Programm sollte bei einem Aufruf
       dvips <file>
     *nur* aus der Datei <file>.dvi die Datei <file>.ps erzeugen und *nichts*
     sonst! (einige Konfigurationen von dvips fangen bei dem obigen Aufruf an
     zu drucken o. "a.)
   - gs
     Ghostscript
   - ppmtogif
     Teil der Pbmplus--Library
   - pnmcrop
     Teil der Pbmplus--Library

   (~) wird nur w"ahrend der Installation ben"otigt
   (*) geh"ort normalerweise zu einem UNIX--System, aber man wei"s ja nie...
   (+) dies beinhaltet nat"urlich auch die Standard--Dateien f"ur Plain und
       LaTeX

   Falls auch nur eines dieser Programme fehlt, ist eine sichere Funktion des
   TeX--Service nicht gew"ahrleistet! Installieren Sie bitte in einem solchen
   Fall erst die fehlenden Programme und stellen Sie deren Funktionsf"ahigkeit
   sicher.

2) Passen Sie die Datei Configuration an Ihre lokalen Bed"urfnisse an.

3) Stellen Sie sicher, das die UID/GID, unter der Sie eingeloggt sind,
   Schreibrechte auf die entsprechenden Verzeichnisse hat.

4) Falls Sie ein Update des TeX--Service aufspielen m"ochten, l"oschen Sie
   bitte die alte Version erst mit DeinstallTeXService.

5) Starten Sie das Installationsskript, der TeX--Service wird installiert. Dies
   wird ein paar Minuten in Anspruch nehmen.

6) Kopieren Sie bitte den Inhalt der erzeugte Datei LinkTeXService.html als
   Anker f"ur den TeX--Service in die HTML--Seite, von der aus man die lokale
   Version des TeX--Services erreichen k"onnen soll. Achtung! Die Datei 
   LinkTeXService.html ist keine eigenst"andige HTML--Seite!

Falls Sie das Paket nicht direkt von mir bezogen haben, w"are eine kurze
Nachricht an mich sehr nett, damit ich Sie "uber Updates oder "ahnliches
informieren kann. In einem solchen Fall kommen Sie auch auf die
deutschlandweite Homepage dieses Services

  http://www.uni-giessen.de/hrz/texhomepage.html

in Gie"sen.

Bitte beachten Sie:

1) Die Skripte erzeugen drei Logfiles im Verzeichnis /tmp des Servers:

   - archie.logfile
   - sendmail.logfile
   - latex.logfile
   
   Diese Dateien werden *nicht* automatisch gek"urzt! Wenn Sie eine
   automatische K"urzung w"unschen, sollten Sie das Skript trimlogfile in die
   crontab eintragen.

2) Die vom Skript latex in tex/cookbook/.tmplatex erzeugten Dateien werden von
   diesem automatisch wieder gel"oscht, sobald sie "alter als 24 Stunden sind.

Ansonsten: Viel Spa"s mit dem TeX--Service!

Markus Porto
Markus.Porto@physik.uni-giessen.de
