docs/README

   1 README
   2 ------
   3
   4 Diese Software benoetigt InnoDB (kostenlose Datenbank-Engine) unter MySQL, da
   5 Fremdschluessel verwendet werden. Lassen Sie sich dies von Ihrem Support
   6 aktivieren! Im Normalfall sollte dies aber bereits aktiv sein.
   7
   8 Sie koennen dies z.B. mit phpMyAdmin sehr komfortabel herausbekommen. Loggen Sie
   9 sich dazu in phpMyAdmin ein. Auf der Eingangsseite im rechten Frame klicken Sie
  10 oben auf den Reiter 'Engine'. Sollte dort InnoDB nicht ausgegraut sein
  11 (Standart-Theme), ist es aktiv.
  12
  13 Zuerst muss ein SVN-Tool installiert werden, TortoiseSVN
  14 ( http://tortoisesvn.net/downloads ) ist dafuer sehr empfehlenswert und
  15 kostenlos beziehbar (siehe Link in Klammern). Wer der englischen Sprache nicht
  16 maechtig ist, kann sich dort (weiter unten) auch ein deutsches Sprachpaket
  17 installieren. Dieses muss immer erneut runtergeladen werden, wenn TortoiseSVN
  18 aktualisiert wurde. Bitte den Neustart von Windows durchfuehren lassen,
  19 anderfalls ist keine Installation des Sprachpaketes moeglich.
  20
  21 Ist dies installiert, geht es wie folgt weiter:
  22
  23 - Den Arbeitsplatz aufrufen (wie auch immer Sie da hinkommen)
  24 - Z.B. Laufwerk C: oeffnen (doppelt/einfach anklicken)
  25 - Dort ein Verzeichnis "Downloads" anlegen (ohne Anfuehrungszeichen)
  26 - In das neu angelegte Verzeichnis "Downloads" wechseln
  27 - Dort auf die freie Flaeche rechtsklicken und SVN (oder so) auswaehlen
  28 - Dann "Checkout" oder "Auschecken" anklicken
  29 - Als naechstes wird schon die URL http://www.ship-simu.org/repos/ctracker/trunk/
  30   eingetragen
  31 - Einmal auf OK klicken und der Trunk wird runtergeladen
  32 - Das nun neu hinzugekommende Verzeichnis "trunk" sollte z.B. auf
  33   "CTracker-Trunk" umbenannt werden, damit noch mehr runterladbar ist
  34
  35 Ist dies alles getan, haben Sie den ersten Schritt geschafft! Und das war doch
  36 gar nicht so schwer. :-)
  37
  38 Sollten Sie aktualisieren wollen (einmal im Monat reicht), einfach folgendes
  39 ausfuehren:
  40
  41 - Das Verzeichnis C:\Downloads\ wieder oeffnen.
  42 - Rechtsklick auf "CTracker-Trunk" -> SVN -> Aktualisieren/Update anklicken
  43 - Nun sollte alles aktualisiert werden.
  44 - Einmal OK anklicken und der Vorgang ist abgeschlossen
  45
  46 Nun geht es mit dem Einrichten weiter. Dies brauchen Sie nicht bei jedem Update
  47 durchfuehren und ist nur bei der Erstinstallation noetig. Bitte wechseln Sie
  48 dazu in das Verzeichnis "CTracker-Trunk".
  49
  50 Dann geht es wie folgt weiter:
  51
  52 - In das Verzeichnis "config" wechseln
  53 - Dort die Datei db_config.php.dist kopieren (nicht umbenennen). Meistens geht
  54   dies so: Datei markieren -> Rechtsklick -> Kopieren -> Rechtsklick -> Einfuegen.
  55 - Die neue Datei "Kopie von db_config.php.dist" muss nun umbenannt werden, nennen
  56   Sie diese "db_config.php"
  57 - Oeffnen Sie diese Datei mit einem beliebigen Texteditor (WordPad.exe, nicht
  58   aber Word!) und tragen Sie die Konfigurationsdaten Ihrer Datenbank ein (der
  59   Support Ihres Hosters kann Ihnen da weiterhelfen).
  60 - Datei werden die Datei zwischen die einfachen Anfuehrungszeichen rechts vom
  61   Gleichheitszeichen eingetragen werden, das Semikolon bitte stehen lassen!
  62 - Ist dies getan, diese abspeichern.
  63
  64 Ab hier koennen Sie dann immer weitermachen, auch nach dem Update:
  65
  66 - Im Verzeichnis install liegt eine Datei "install.sql"
  67 - Laden Sie diese mit z.B. phpMyAdmin in Ihre eben eingestellte Datenbank hoch
  68   (nicht FTP! Das bringt dort nichts.)
  69 - Ist dies getan, laden Sie die folgenden Verzeichnisse und Dateien auf Ihren
  70   Webspace hoch. Wenn Ihr Script (was Sie mit ctracker ja absichern wollen) ein
  71   Verzeichnis z.B. "inc" hat, wo weitere Include-Dateien sich befinden, so laden
  72   Sie dort folgendes hoch:
  73
  74   + Die Datei ctracker.php
  75   + Das Verzeichnis config und libs
  76
  77 - Den Rest braucht ihr Script nicht, das ist nur fuer Sie etwas.
  78
  79 Nun muss (einmalig) die ctracker.php eingebunden werden. Sie sollten dazu z.B.
  80 die Konfigurationsdatei Ihres abzusichernden Scriptes oeffnen, dann sind
  81 meistens alle Scripte abgesichert. Binden Sie dies nur in index.php ein, ist
  82 nur index.php abgesichert, nicht aber alle anderen Scripte, die oeffentlich
  83 aufgerufen werden duerfen!
  84
  85 Verwenden Sie dazu folgenden Code:
  86
  87 require_once('inc/ctracker.php');
  88
  89 Dabei - wie oben geschrieben - kann das Verzeichnis "inc" von Ihrem Script
  90 abhaengig sein.
  91
  92 Sollten Sie nicht weiterkommen, so kommen Sie in's Forum:
  93 http://forum.ship-simu.org
  94
  95 Bitte sehen Sie von Anrufen (Impressum) ab, ich biete generell keinen Support
  96 per Telefon an.
  97
  98 Vielen Dank fuer Ihr Interesse an meiner erweiterten Fassung von Cracker Tracker
  99 Standalone!
 100
 101 Uebrigens: Die Originalfassun bekommen Sie hier: http://www.cback.de
 102
 103 PS: Wollen Sie einen datenbanklosen Betrieb (wie bei der urspruenglichen Version
 104 es so war), so lassen Sie in der db_config.php einfach alle Eintraege leer, nicht
 105 aber auskommentieren, dann gibt es nicht initialisierte Array-Elemente.