AF1 News-Manager - Installation
Wichtig! Bitte lesen Sie vor der Installation die Lizenzvereinbarung.
Wenn Sie den AF1 News-Manager installieren, stimmen Sie automatisch der Lizenzvereinbarung zu.
 Manuelle Installation
Alle Programmdateien des AF1 News-Manager für eine manuelle Installation sind in einer komprimierten Datei hinterlegt.
Die zip-Datei (AF1NewsManager.zip) befindet sich im Verzeichnis /programfiles.
Die Vorgehensweise:
1. Entpacken Sie die Datei AF1NewsManager.zip auf Ihrem lokalen Rechner. (z.B. mit WinZip )
2. Lesen Sie bitte die nachfolgende Installationsanleitung.
Inhaltsübersicht - Manuelle Installation
 Installation
Benötigte Systemumgebung
Benötigte Server- und Webdaten
Konfiguration der Sciptdateien (*.pl)
Konfigurationsdatei setup.pl
Dateien auf den Webserver kopieren
Dateiberechtigungen vergeben
Inbetriebnahme
Erster Login
Fehlerbehandlung
Anhang
Dateiübersicht
Installation
Benötigte Systemumgebung
- Beliebiges Betriebssystem mit installiertem Webserver (z.B. UNIX, Windows)
- PERL/CGI ab Version 5.04
Benötigte Server- und Webdaten (Umgebungsvariablen)
Für die Konfiguration notieren Sie sich bitte die nachfolgenden Daten Ihres Webservers (diese Daten werden in die Konfigurationsdatei eingetragen). Fragen Sie ggf. Ihren Internetprovider. Wenn Sie das im Beispiel vorgegebene Installationsverzeichnis "/af1news/" übernehmen, benötigen Sie die geringsten Anpassungen.
Serverpfade zu den Verzeichnissen, in dem die Programm-Dateien abgelegt werden.
CGI-Verzeichnis (UNIX):
/home/www/domainname/cgi-bin/af1news/
CGI-Verzeichnis (Windows):
c:/domainname/wwwroot/cgi-bin/af1news/
Web-URL´s zu den Verzeichnissen, in dem die Programm-Dateien abgelegt werden:
CGI-URL:
http://www.domainname.de/cgi-bin/af1news/
Konfiguration der Sciptdateien (*.cgi)
Passen Sie ggf. in der erste Zeile aller *.cgi - Dateien den Pfad zu Ihrem Perl-Verzeichnis an. Als Standard ist dort #!/usr/bin/perl eingetragen. (Entspricht dieser Eintrag dem Ihres Servers, dann sind Änderungen nicht notwendig)
Beispiel-Pfade unter UNIX / Linux:
#!/usr/bin/perl oder #!/usr/local/bin/perl
Beispiel-Pfade unter Windows:
#c:\perl oder #c:\perl\bin\perl
Konfigurationsdatei setup.pl
In der Datei setup.pl werden alle zum Betrieb des AF1 News-Manager erforderlichen Daten und Pfade eingetragen. Sie können die Datei mit einem Texteditor wie „Wordpad“ oder dem „Notepad“ bearbeiten. Weitere Details sind direkt in der Konfigurationsdatei dokumentiert.
Dateien auf den Webserver kopieren
Nachdem Sie die notwendigen Änderungen in der Datei setup.pl vorgenommen haben, können Sie die Dateien auf Ihren Webserver übertragen.
Bitte übernehmen Sie (sofern möglich) die vorgegebene Verzeichnisstruktur entsprechend der im Anhang abgedruckten Dateiübersicht. Dateien und Verzeichnisse die sich im Installations-Archiv im Verzeichnis (Ordner) /cgi-bin befinden, bitte in Ihr /cgi-bin Verzeichnis auf dem Webserver kopieren.
Im Webserver – Rootverzeichnis (dort liegt z.B. die Startdatei index.html Ihrer Website) legen Sie ein Verzeichnis /af1news an und kopieren dorthin die Dateien und Verzeichnisse die sich im Installations-Archiv im Verzeichnis (Ordner) /af1news befinden.
Zum Kopieren der Dateien benutzen Sie bitte ein FTP-Programm. Ein Upload mittels Browser (viele Provider bieten so ein Tool an) ist für den Upload nicht geeignet. Die Dateien werden auf diese Art im falschen Modus übertragen.
Beachten Sie unbedingt, dass alle Dateien im richtigen Modus (gemäß der Liste im Anhang) übertragen werden. Sollten Sie dies nicht berücksichtigen, werden Sie den AF1 News-Manager nicht erfolgreich in Betrieb nehmen können. Ein passendes FTP Programm finden Sie u.a. auf der Website freeware.de. In den Dokumentationen der entsprechenden FTP-Programme finden Sie auch weiterführende Informationen zum Thema Übertragungsmodus. |
Dateiberechtigungen vergeben
Nach dem Kopieren der Dateien versehen Sie per FTP-Programm alle Dateien im cgi-bin Verzeichnis mit der entsprechenden Berechtigung gemäß der Liste im Anhang (chmod). Weitere Informationen zum Setzen von Rechten finden Sie z.B. bei SELFHTML.
Inbetriebnahme
Erster Login
Die Administration rufen Sie im Webbrowser mit der URL zur Datei admin.cgi auf.
Beispiel: http://www.domainname.de/cgi-bin/af1news/admin.cgi
Wichtig!
Rufen Sie bitte unverzüglich nach der Installation die Administration auf.
Bei diesem ersten Aufruf wird der Standard-Benutzername und -Passwort ersetzt mit Ihrer persönlichen Zugangskennung.
Login-Daten nach Erstinstallation:
Benutzer: admin
Passwort: admin
Fehlerbehandlung
Internal Server Error:
Die Dateien müssen im ASCII-Modus auf den Webserver übertragen werden. Meistens tritt dieser Fehler auf, wenn die Dateien als Binary übertragen wurden.
Dieser Fehler tritt ebenfalls häufig auf, wenn die Berechtigungen der einzelnen Script-Dateien falsch gesetzt wurden.
Sie können die Fehlerquelle mit Hilfe des Error-Logfiles des Servers (falls Zugriff besteht) analysieren.
Anhang
Dateiübersicht
Übersicht aller Dateien, deren benötigten Dateiberechtigungen und den Übertragungsmodus (ASCII).
Hinweis: In der Regel brauchen Sie die Rechte nur im cgi-bin-Bereich vergeben. Im HTML-Bereich (erste Tabelle) vergibt der Server automatisch beim Upload die richtigen Rechte. Achten Sie also im HTML-Bereich nur auf den richtigen Modus (alle Dateien binär) und verändern Sie die Rechte anschließend nicht.
Verzeichnisse und Dateien unterhalb Root:
| Verzeichnis/Datei
|
chmod |
Transfer |
| /af1news |
(755) |
|
/af1news/images
*.gif |
(644)
(644) |
binary |
Verzeichnisse und Dateien unterhalb cgi-bin:
| Verzeichnis/Datei
|
chmod |
Transfer |
/cgi-bin/af1news
*.cgi |
(755)
(755) |
ascii |
/cgi-bin/af1news/archiv
*.dat |
(777)
(666) |
ascii |
/cgi-bin/af1news/routinen
*.pl |
(755)
(755) |
ascii |
/cgi-bin/af1news/routinen/module
*.pl |
(755)
(755) |
ascii |
/cgi-bin/af1news/routinen/module/Archive
*.pm |
(755)
(755) |
ascii |
/cgi-bin/af1news/setup
*.dat
*.pl |
(777)
(666)
(666) |
ascii
ascii |
/cgi-bin/af1news/templates
*.html |
(755)
(644) |
ascii |
/cgi-bin/af1news/templates/admin
*.html |
(755)
(644) |
ascii |
/cgi-bin/af1news/tmpuser
*.html |
(777)
(644) |
ascii |
Bei einigen Servern ist evtl. eine andere Vergabe der Rechte nötig. Fragen Sie im Zweifelsfall Ihren Provider.
Grundsätzlich gelten folgende Regeln:
- Verzeichnisse in denen Skripte ausgeführt werden, benötigen das Recht 755.
- Verzeichnisse in denen von Skripten geschrieben wird, benötigen das Recht 777.
- Dateien die ausgeführt werden, benötigen das Recht 755.
- Dateien in denen geschrieben wird, benötigen das Recht 666.
Benutzen Sie bitte immer zuerst die, innerhalb der Tabelle, angegebenen Rechte. Mit diesen Rechten arbeiten die meisten Server. Verändern Sie erst, falls eine Fehlermeldung ausgegeben wurde, die Rechte einzelner Dateien oder Verzeichnisse. Hinweis: Bei einer Fehlermeldung, alle Rechte auf 777 zu setzen ist keine Lösung. Im Gegenteil, dadurch blockiert der Server im Regelfall die Ausführung der Skripte.
|
Automatische Installation 