====== Installation - Sefrengo frisch installiert ====== ===== Mindestanforderungen ===== ==== Anforderungen an den Server ==== === Serversettings === * PHP (ab Version 5.3) * MySQL (ab Version 5.0) * zlib (empfohlen, damit komprimierte tar-Archive verarbeitet werden können) * gdlib (empfohlen, dient zum Erstellen der Thumbnails) * zip-support (empfohlen, damit im Dateimanager zip-Dateien hochgeladen und auf dem Server entpackt werden können) * Safe Mode OFF (bei aktiviertem Safemode kann es zu Problemen kommen) * File Uploads ON (erforderlich, damit in Sefrengo Dateien hochgeladen werden können) === Dateirechte === Folgende Ordner benötigen die Dateirechte auf 777: * backend/logs/ * backend/plugins/ * backend/upload/in/ * backend/upload/out/ * projekt01/cms/css/ * projekt01/cms/files/ * projekt01/cms/js/ * projekt01/media/ * projekt01/logs/ ==== Anforderungen an den Client ==== * Webbrowser * Interne Explorer >= 8 * Mozilla Firefox >= 4 * JavaScript muss aktiviert sein * Optimalerweise sind Cookies erlaubt ====== Durchführung des Setups ====== === Setup vorbereiten und Sprache === Entpacken Sie die heruntergeladene Sefrengo-ZIP-Datei und laden Sie die Dateien auf Ihren Webserver oder in eine lokale Serverumgebung (localhost). Geben Sie in die Adresszeile Ihres Browsers die URL http://www.meine-domain.de/pfad/setup/ ein, wobei Sie ww.meine-domain.de/pfad/ durch Ihren Installationspfad ersetzen. Nun sollten Sie das Setup-Fenster sehen: {{:handbuch:install_1.jpg|}} In diesem Fenster wählen Sie die Installationssprache aus (aktuell ist nur Deutsch verfügbar). Klicken Sie auf "weiter". === Lizenzbedingungen=== Danach müssen Sie die GPL-Lizenz akzeptieren, andernfalls können Sie nicht fortfahren, weil der "weiter"-Button blockiert ist. Nachdem Sie die Lizenzbestimmung bestätigt haben, klicken Sie auf "weiter". {{:handbuch:install_2.jpg|}} === Pre-Test === Damit die Installation und der spätere Betrieb reibungslos funktioniert, werden nun Ihre PHP-Einstellungen geprüft. Mit Klicken auf "Info" oder der geprüften Einstellung erhalten Sie nähere Informationen zu den Anforderungen. Wenn einer der Punkte nicht erfüllt ist, klicken Sie auf "Info", um Näheres über das auftretende Problem zu erfahren. Sefrengo kann auch bei hier auftretenden Schwierigkeiten funktionieren, dies ist jedoch Server abhängig. Erst wenn alle erfüllt sind, klicken Sie auf "weiter". {{:handbuch:install_3.jpg|}} ===Installationsart=== Wie die Überschrift suggeriert können Sie auswählen, ob Sie eine bestehende Installation aktualisieren möchten, oder ob es sich um eine Neuinstallation handelt. Wir gehen im folgenden davon aus, dass Sie Sefrengo neu installieren möchten. Bestätigen Sie mit "weiter". {{:handbuch:install_4.jpg|}} ===Installationspfad=== Als nächstes legen Sie den Installationspfad für Sefrengo fest. Hier sehen Sie beispielsweise eine Installation für eine lokale Serverumgebung (xampp). Die Pfade werden normalerweise richtig gesetzt. Klicken Sie auf "weiter". {{:handbuch:install_5.jpg|}} ===Kennwort=== Um sich später in Sefrengo einzuloggen, benötigen Sie als Administrator ein Login-Passwort, welches Sie jetzt festlegen und mit "weiter" bestätigen. {{:handbuch:install_6.jpg|}} ===Datenbank-Zugang=== Damit sich Sefrengo erfolgreich mit Ihrer Web-Datenbank oder lokalen Datenbank verbinden kann, müssen Sie dem CMS den Zugang gewähren. Das wird in diesem Installationsschritt bewerkstelligt. Die Zugangsdaten erfahren Sie von Ihrem Provider, bei einer lokalen Datenbank finden Sie sie in deren Konfigurationsdatei - bei XAMPP zu finden in der Datei config.inc.php im XAMPP-Unterverzeichnis phpmyadmin. Unter "Datenbankname" muss der Name einer auf dem Webserver **existierenden** Datenbank genannt werden. Um eine Datenbank auf ihrem Webserver anzulegen, können Sie ein Tool wie phpMyAdmin verwenden - oder aber der Provider hat bereits eine Datenbank mit Namen für Sie bereit gestellt. Dann geht es "weiter". {{:handbuch:install_7.jpg|}} ===Bereit zur Installation=== Wenn alle Eingaben getätigt worden sind, können Sie die Installation beginnen. Die Installationsroutine fügt die nötigen Tabellen in die Datenbank ein und erzeugt die Konfigurationsdatei. Klicken Sie auf "weiter". {{:handbuch:install_8.jpg|}} ===Konfigurationsdatei=== Nun erhalten Sie die Konfigurationsdatei, die Sie mit einem Klick auf "Konfigurationsdatei downloaden" auf Ihre Festplatte speichern und dann auf den Webserver in das Sefrengo-Verzeichnis backend/inc laden. In der Konfigurationsdatei können Sie z.B. den Datenbankzugang (Passwort, Benutzername) verändern. Die Datei muss config.php heißen! {{:handbuch:install_9.jpg|}} ===Glückwunsch!=== Sefrengo wurde erfolgreich auf Ihrem Webserver installiert. Bedenken Sie, wie oben ebenfalls angegeben, dass für die angegebenen Ordner volle Schreib-, Lese- und Ausführrechte vorhanden sein müssen. Dies trifft insbesondere auf Linux-Systeme zu und wird mit einem Klick auf "weiter" getestet. {{:handbuch:install_10.jpg|}} ===Ordnerrechte-Test=== Ist der Test erfolgreich - unter Windows gibt es normalerweise keine Probleme - dann können Sie ab sofort sich in Ihr Sefrengo CMS einloggen. {{:handbuch:install_11.jpg|}} ====== Installation einer Test- und Trainingsumgebung mit XAMPP ====== Um sich mit Sefrengo vertraut zu machen, sollten Sie auf Ihrem Computer eine Test- und Trainingsumgebung aufsetzen, ehe Sie Ihre Änderungen online übertragen. Um einen lokalen Server einzurichten, auf dem das CMS laufen kann, gibt es verschiedene Möglichkeiten. XAMPP stellt eine solche Serverumgebung dar. Unter einem Dach sind verschiedene Programme versammelt. XAMPP installiert auf einfache Weise den Webserver Apache, das Datenbanksystem MySQL und die Skriptsprache PHP. Neben weiteren Tools installiert XAMPP auch das nützliche phpMyAdmin, mit dem man die MySQL-Datenbank bearbeiten und Skripte testen kann. Kurz: XAMPP installiert alles, was man für Sefrengo braucht. === Installation === Download und Hinweise zur Installation von XAMPP finden sich für * Windows unter http://www.apachefriends.org/de/xampp-windows.html * Linux unter http://www.apachefriends.org/de/xampp-linux.html * Mac OS X unter http://www.apachefriends.org/de/xampp-macosx.html Folgen Sie den ausgezeichneten Installationsanweisungen auf der Website. === XAMPP für Sefrengo vorbereiten === Legen Sie im XAMPP-Unterverzeichnis htdocs einen Ordner mit dem Namen "Sefrengo" an und kopieren Sie die heruntergeladenen und entpackten Sefrengo-Daten hier hinein. In dieses Verzeichnis wird später dann Sefrengo installiert. Davor müssen Sie jedoch erst einmal eine Datenbank erzeugen, damit das Sefrengo-Setup funktioniert. Dazu eignet sich phpMyAdmin, dass mit XAMPP installiert wurde. Tippen Sie in Ihren Browser http://localhost/phpmyadmin/ ein, dadurch sollten Sie auf die phpMyAdmin Hauptseite oder den Login für phpMyAdmin gelangen. Direkt auf der Hauptseite sollte sich Ihnen bereits die Möglichkeit bieten, eine neue Datenbank anzulegen: {{:handbuch:install_12.jpg|}} Auf "anlegen" klicken und die Datenbank erscheint im linken Dropdown-Menü. Jetzt können Sie das Sefrengo-Setup durchführen! Zum Start des Sefrengo-Setups gehen Sie auf die Browseradresse http://localhost/sefrengo/setup/ ein. Führen Sie die Setup-Schritte wie oben beschrieben durch. === Klarmachen zum Login! === Vergewissern Sie sich vor jeder lokalen Sefrengo-Nutzung durch das XAMPP Control Panel, dass sowohl MySQL als auch der Webserver Apache ausgführt werden ("running"). Läuft einer der beiden nicht, dann klicken Sie auf "Start". {{:handbuch:install_13.jpg|}} Sollte der Webserver nicht starten, so kann das manchmal an einem Port-Konflikt liegen - beispielsweise bei der Nutzung von Skype oder anderer VoIP-Software. Deaktivieren Sie Skype, starten Sie Apache und starten Sie danach das VoIP-Programm erneut. Nun gehen Sie auf http://localhost/sefrengo/backend/ und Sie müssten sich nun einloggen können: {{:handbuch:install_14.jpg|}} Glückwunsch! Jetzt kann es losgehen! * [[profil>16|Andi Portmann]] * Daniel Schuler * [[profil>1|Björn Brockmann]]