home *** CD-ROM | disk | FTP | other *** search
/ M.u.C.S. Disc 2000 / MUCS2000.iso / anwend / gemar306 / tar_imp / tar_imp.doc < prev    next >
Text File  |  1997-01-21  |  9KB  |  224 lines
  1.  
  2.   TAR-Importer für GEMAR                                 ╛ Carsten Friehe 1995
  3.  
  4.  
  5.   Dieses Programm (Plugin) dient dazu, Bänder, die mit tar beschrieben worden 
  6.   sind, mit Hilfe von GEMAR zu restaurieren. Dazu notwendig ist ein Computer 
  7.   auf dem GEMAR läuft und eine GEMAR-Version >= 3.00.
  8.  
  9.  
  10. Inhalt dieses Textes:
  11.  
  12.     Lieferumfang
  13.     Copyright
  14.     Preis
  15.     Einschränkung
  16.     Installation
  17.     Registrierung
  18.     Wartezeit
  19.     Problemfälle
  20.     Datum und Uhrzeit
  21.     History
  22.     Haftungsausschlüsse
  23.     Danksagungen
  24.     Adresse
  25.  
  26.  
  27. LIEFERUMFANG
  28.  
  29.   Zur öffentlichen Version vom TAR-Importer gehören die folgenden Dateien:
  30.  
  31.     TAR-IMP.DOC          Diese Datei
  32.     TAR-IMP.PLG          Das Plugin
  33.     TAR-IMP.UPL          Uploadinformation
  34.     TAR-IMP.TIC          Uploadinformation für Schnulli (mit MakeNews erzeugt!)
  35.     REGISTER.TTP         Programm, um eine registrierte Version zu erzeugen
  36.  
  37.  
  38. COPYRIGHT
  39.  
  40.   Der TAR-Importer ist Shareware. Die Weitergabe ist jedoch (ausschlie₧lich frei)
  41.   erlaubt.
  42.  
  43.   Eine Aufnahme in PD-Pools (Disketten, CD-ROMs und beliebige andere Form) 
  44.   bedarf meiner schriftlichen Genehmigung.
  45.  
  46.  
  47. PREIS
  48.  
  49.   Der TAR-Importer kostet ganze 20,- DM.
  50.   Durch die Bezahlung des Betrages und Zusendung der Registrierungsdatei, 
  51.   erhalten Sie einen Schlüssel, der die öffentliche Version zu einer 
  52.   vollständigen Version macht.
  53.   Updates können Sie erhalten, indem Sie mir eine Diskette und einen 
  54.   adressierten und frankierten Rückumschlag zusenden. Die neueste öffentliche 
  55.   Version ist auch immer in der Maus Hannover zu bekommen.
  56.  
  57.  
  58. EINSCHRÄNKUNG
  59.  
  60.   Die einzige Einschränkung der öffentlichen Version ist die, da₧ am Anfang
  61.   eine Meldung erscheint, da₧ man sich registrieren lassen soll und da₧ am 
  62.   Anfang des Restore ein Hinnweis auf die fällige Registrierung erscheint.
  63.  
  64.  
  65. INSTALLATION
  66.  
  67.   -Kopieren Sie TAR-IMP.PLG in das Plugin-Verzeichnis von GEMAR.
  68.   -Starten Sie GEMAR (mindestens Version 3.00) und lassen Sie GEMAR einen Index 
  69.    von einem Band einlesen, das mit tar beschrieben wurde, und freuen Sie sich 
  70.    über das Ergebnis.
  71.  
  72.   ACHTUNG: Bei Backups über mehrere Bänder wird GEMAR das Band mit dem Index
  73.            (das letzte Band) als TAR-Band identifizieren. Für User, die Backups 
  74.            über mehrere Bänder machen, empfiehlt es sich daher, den TAR-Importer 
  75.            nur bei Bedarf einzuschalten, oder Steffen zu nerven, da₧ GEMAR eine 
  76.            Identifikationsmöglichkeit dafür bekommt.
  77.  
  78.  
  79. REGISTRIERUNG
  80.  
  81.   Um sich registrieren zu lassen, müssen sie das Plugin einmal starten, indem Sie 
  82.   in GEMAR ein Band im tar-Format einlesen. Beim Start des Plugins erscheint 
  83.   eine Abfrage, ob die Registrierungsinformationen geschrieben werden sollen. 
  84.   Diese beantworten Sie mit "Ja". Daraufhin können Sie GEMAR wieder verlassen. 
  85.   Im Plugin-Verzeichnis existiert jetzt eine Datei namens "tar-imp.txt". Diese 
  86.   Datei können Sie jetzt ausdrucken und mir zusenden.
  87.  
  88.   Wenn Sie den Schlüssel erhalten haben, starten sie einfach das Programm 
  89.   "register.ttp" mit dem Plugin als Argument. Daraufhin werden sie nach Ihrem 
  90.   Namen und dem Schlüssel gefragt. Das Programm schreibt jetzt die 
  91.   Registrierungsinformation in das Plugin und die Datei tar-imp.reg, womit Sie
  92.   jetzt eine registrierte Version haben.
  93.  
  94.  
  95. WARTEZEIT
  96.  
  97.   Bitte bedenken sie, bevor Sie über die Zeit meckern, die der Importer für ein 
  98.   tar-Band benötigt, da₧ tar eben keine Index-Information über das Backup anlegt,
  99.   die sich einfach laden lä₧t. Es mu₧ deshalb einmal die ganze Sicherung bis zum 
  100.   Ende gelesen werden um die Informationen der gesicherten Dateien zu Lesen.
  101.  
  102.   Sie können in der Zwischenzeit ja Ihre zwischenmenschlichen Beziehungen 
  103.   pflegen, anstatt den Monitor anzustarren.
  104.  
  105.  
  106. PROBLEMFÄLLE
  107.  
  108.   Bis jetzt gibt es Probleme, wenn in einem tar-Archiv ein Verzeichnis doppelt 
  109.   vorkommt. Beispiel:
  110.   willi/
  111.   willi/datei1
  112.   willi/datei4
  113.   petra/dummy2
  114.   willi/
  115.   willi/datei3
  116.   Wenn der zweite willi/ Eintrag fehlt, dann gibt es keine Probleme!
  117.   Wenn allerdings ein Verzeichnis erst nach den darin enthaltenen Dateien folgt, 
  118.   kommt der Importer auch nicht damit klar. Beispiel:
  119.   willi/datei1
  120.   willi/datei4
  121.   petra/dummy2
  122.   willi/datei3
  123.   willi/
  124.  
  125.   Ausprobiert habe ich den Importer bis jetzt mit einem GNU-tar, einem 
  126.   SINIX-tar und einem HP-UX-tar. Falls jemand Probleme mit einer anderen 
  127.   tar-Version haben sollte, benötige ich das Header-Format dieser Version. 
  128.   Dazu hilfreich ist z.B. ein kleines Archiv auf Diskette oder per eMail.
  129.  
  130.   Unterstützt werden bis jetzt auch nur normale Dateien und Verzeichnisse. Alles 
  131.   andere wird in Dateien umgewandelt.
  132.  
  133.   Wenn mehrere Sicherungen auf einem Band hinterenander stehen, kann es auch zu 
  134.   Problemen kommen, da jede tar-Version hier ihre eigene Vorstellungen der 
  135.   Trennung hat. Bis jetzt kenne ich Versionen, bei denen die Archive durch 
  136.   nichts getrennt sind, durch ein Filemark, oder durch einen leeren Sektor und 
  137.   ein Filemark.
  138.   Dewegen unterstützt die Version 1.90 noch nicht mehrere Sicherungen auf einem
  139.   Band!
  140.  
  141.   Wichtig:
  142.   Eine Sache ist mir bei Bändern, die ich mit dem HP-UX-tar geschrieben habe, 
  143.   aufgefallen. Es mu₧ unbedingt ein Blockingfaktor von 1 angegeben werden
  144.   (-b 1), da sonst die Blockgrö₧e auf dem Streamer nicht mit dem übereinstimmt, 
  145.   was der tar-Importer verarbeiten kann (512-Byte Blöcke). Dies dürfte auch auf 
  146.   andere Systeme zutreffen!
  147.  
  148.  
  149. DATUM UND UHRZEIT
  150.  
  151.   Die in GEMAR angezeigten Werte für Datum und Uhrzeit sind als UTC Zeiten zu 
  152.   interpretieren. Dies ist die Zeit die tar auf das Band schreibt. Es wird 
  153.   hierbei keine Winter-/Sommerzeit Umschaltung vorgenommen!
  154.  
  155.  
  156. HISTORY
  157.  
  158.   0.00 bis 1.70      Erste Versuche noch ohne GEMAR.
  159.  
  160.   1.80   21.01.1995  Erste Version, die mit GEMAR läuft.
  161.   1.81   10.03.1995  Erste zum Betatest freigegebene Version.
  162.   1.82   18.03.1995  Abfrage des Streamers entwanzt.
  163.   1.83   16.04.1995  Erste Anpassungen an QFA.
  164.   1.84   30.04.1995  Fehler beim Restore eventuell behoben.
  165.   1.85   11.06.1995  Debugausgaben in eine Datei (nur bei mir!)
  166.   1.86   06.07.1995  Debugausgaben ausgeschaltet. Is' ja die Hölle
  167.                      (O-Ton Steffen)
  168.   1.87   06.07.1995  Gab es nie.
  169.   1.88   06.07.1995  War überhaupt nicht notwendig.
  170.   1.89   06.07.1995  CountEntries an die Anforderungen von GEMAR angepa₧t.
  171.                      Zusammen mit den Anpassungen in GEMAR, funktioniert
  172.                      das Restore jetzt einwandfrei.
  173.   1.90   09.09.1995  Änderung der Einschränkungen in der nicht registrierten
  174.                      Version.
  175.                      Verwaltung mehrerer Sicherungen auf einem Band abgeklemmt,
  176.                      das es doch nur zu Problemen kam.
  177.   1.91   24.09.1995  Es gibt jetzt keine Einschränkungen mehr, sondern nur noch
  178.                      einen Hinweis am Anfang des Einlesens des Bandes und einen
  179.                      am Anfang des Restore.
  180.   1.92   28.10.1995  Probleme beim Inquiry hoffentlich behoben.
  181.   1.93   30.10.1995  Durch Speicherung des Schlüssels in einer Datei, sind jetzt
  182.                      auch mehrere Streamer (maximal 20) möglich.
  183.   1.94   18.11.1995  Wenn ein fehlerhafter tar-Header eingelesen wurde, hat man
  184.                      jetzt die Auswahl, ob man weitermachen möchte oder nicht.
  185.                      Der Index wird aber auf jeden Fall bis dahin an Gemar
  186.                      übermittelt.
  187.   1.95   20.11.1995  Eine weitere Fehlerquelle beim Inquiry hoffentlich gefixt.
  188.  
  189.   2.00   01.12.1995  Erste veröffentlichte Version.
  190.  
  191.  
  192. HAFTUNGSAUSSCHLÜSSE
  193.  
  194.   Ich kann Fehler im tar-Importer natürlich nicht völlig ausschlie₧en. Die 
  195.   Benutzung dieses Programmes geschieht auf eigene Gefahr! Ich übernehme keinerlei
  196.   Haftung für Schäden, die direkt oder indirekt aufgrund der Verwendung des
  197.   tar-Importers entstehen.
  198.  
  199.   Wenn sie trotzdem einen Fehler gefunden haben, bitte ich sie, mir eine 
  200.   möglichst genauen Beschreibung dieses Fehlers an eine der unten genannten 
  201.   Adressen zuzusenden. 
  202.  
  203.  
  204. DANKSAGUNGEN
  205.  
  206.   Hiermit möchte ich mich bei Steffen Engel für seine sehr weitgehende 
  207.   Unterstützung bedanken. Denn ohne seine Idee und Hilfestellungen wäre dieses 
  208.   Projekt wohl nie zustande gekommen.
  209.  
  210.   Bei meinen Betatestern möchte ich mich für die, wenn auch nicht sehr 
  211.   zahlreichen, Bugreports bedanken.
  212.  
  213. ADRESSE
  214.  
  215.  Carsten Friehe                  Bankverbindung:
  216.  Alte Döhrener Str. 76D          Stadtsparkasse Hannover
  217.                                  BLZ 250 50 180
  218.  30173 Hannover                  Konto-Nr. 15038394
  219.  
  220.  
  221.  MausNet: Carsten Friehe @ H2
  222.  
  223.  
  224. Carsten Friehe, 01.12.1995