SCADA SOFT AG. Technische Fragen zu Wizcon (TFW035): Installation von Apache 1.3.x / 2.0.x

Transkript

1 Wiesengasse 20 CH-8222 Beringen TFW035_Installation_von_Apache.doc Tel: Fax: Technische Fragen zu Wizcon (TFW035): Installation von Apache 1.3.x / 2.0.x Voraussetzung Um den aktuellsten Build des Apache Web-Servers zu erhalten, laden Sie sich bitte von die aktuellste Version der 1.3.x oder 2.0.x Windows Binaries herunter ( Bitte beachten Sie, dass Sie für die Installation unter Windows XP mindestens Service Pack 1 benötigen und für Windows NT allenfalls zuerst den Microsoft Installer installieren müssen. Bitte beachten Sie auch das Kapitel Apache und Wizcon am Ende dieses Dokuments. Apache 1.3.x Der Apache 1.3-Stamm wird derzeit noch aktiv vom Apache Team unterstützt. Neue Funktionen werden jedoch eher in Apache 2.0.x implementiert. Allerdings sind gewisse Module noch nicht für Apache 2.0.x verfügbar, weshalb der 1.3-Stamm die bessere Wahl ist, wenn Sie auf zusätzliche Module angewiesen sind. Installation von Apache 1.3.x Nachdem Sie das MSI-Paket heruntergeladen haben, können Sie dieses doppelklicken, womit die Installation gestartet wird. Der Installationsassistent wird Sie nun durch die weiteren Schritte der Installation führen. Nach dem Akzeptieren der Lizenzvereinbarung gelangen Sie in einen Dialog, bei dem Sie die grundlegende Serverkonfiguration festlegen können: Tel. 052 / Seite 1 von 9 info@scada.ch

2 Domain: Wenn Ihr Server im Internet ansprechbar sein soll und Sie bereits eine Domäne bei einem Provider reserviert haben, geben Sie diese hier ein. Wenn Sie den Server nur im internen Netz über die IP-Adresse ansprechen wollen, können Sie hier beispielsweise auch firma.local angeben. Server Name: Dies ist der Rechnername des Servers. Für einen Webserver kann dies z.b. oder demoserver.firma.ch sein. Adresse: Geben Sie hier die Adresse des Server-Administrators ein. Diese wird bei Fehlermeldungen mitgeliefert, damit der Benutzer weiss, an wen er sich im Fehlerfall wenden muss (meist Installationsart: Besondere Beachtung gilt der Wahl der Installationsart (automatisch oder manuell gestartet). Wenn Sie Apache als einzigen Webserver auf dem PC betreiben oder wenn Sie Apache und einen weiteren Web-Server (z.b. Internet Information Server von Microsoft) auf getrennten Ports installieren, können Sie Apache automatisch starten. Möchten Sie beispielsweise Apache und den Internet Information Server alternativ auf dem selben Port verwenden, müssen Sie Apache manuell starten (mehr zur Konfiguration später im Dokument). Im weiteren Verlauf der Installation können Sie wählen, ob Sie Apache komplett oder benutzerdefiniert installieren möchten sowie den Installationspfad. Diese Dokumentation geht davon aus, dass Sie Apache komplett und im Standard-Pfad (\programme\apache group) installieren. Eine weitere Konfiguration ist zur Fertigstellung des Assistenten nicht erforderlich. Wenn Sie die Installation abgeschlossen haben und den Apache-Server gestartet haben, können Sie im Browser mit (resp wenn Sie Apache auf einem anderen Port als 80 installiert haben, siehe unten) prüfen, ob der Server ordnungsgemäss installiert wurde: Tel. 052 / Seite 2 von 9 info@scada.ch

3 Konfigurieren von Apache 1.3.x Wenn Sie Apache 1.3.x im Standardverzeichnis (\programme\apache group) installiert haben, finden Sie unter \programme\apache group\apache\conf die Konfigurationsdatei httpd.conf. Neben verschiedenen Feineinstellungen sowie dem Laden von zusätzlichen Modulen (z.b. PHP) können Sie hier die Grundkonfiguration des Servers ändern. Suchen Sie hierzu in der httpd.conf die Zeile Section 2: 'Main' server configuration. Hier sind vor allem folgende Parameter von Bedeutung: port ServerAdmin ServerName DocumentRoot Gibt den TCP/IP Port an, auf dem Apache Verbindungen akzeptiert. Standardmässig steht dieser Wert auf 80, wenn Sie Apache und den Internet Information Server (oder einen anderen Webserver) gleichzeitig betreiben möchten, müssen Sie hier Apache z.b. auf Port 81 binden. Andernfalls müssen Sie stets einen der beiden Server deaktivieren, um Konflikte zu vermeiden. Die -adresse des Server-Administrators, wie Sie sie bei der Installation angegeben haben. Der Name des Servers, wie Sie ihn bei der Konfiguration angegeben haben. Dies entspricht dem Basisverzeichnis im Internet Information Server, d.h. Apache wird die html-seiten in diesem Verzeichnis suchen. Dieses Verzeichnis können Sie z.b. auf das Docs-Verzeichnis Ihrer Wizcon-Applikation legen. Bitte beachten Sie, dass Wizcon diesen Pfad in Apache nicht automatisch anpassen kann, wenn Sie eine neue Applikation laden und dass Sie Apache neu starten müssen, wenn Sie Änderungen am config-file vorgenommen haben. Tel. 052 / Seite 3 von 9 info@scada.ch

4 <directory c:\programme... Dieser Parameter legt die Sicherheitseinstellungen für das Web-Verzeichnis fest. Bitte ändern Sie den Pfad auf das selbe Verzeichnis wie Sie unter DocumentRoot angegeben haben. Bitte beachten Sie, dass der Eintrag ServerRoot, welchen Sie in der Datei httpd.conf finden, nicht dem html-verzeichnis entspricht! ServerRoot beinhaltet den Pfad, in dem Apache installiert ist und gibt dem Server an, wo nach Konfigurationsfiles und Logdateien gesucht werden muss und sollte nicht geändert werden. Alle weiteren Optionen sind in der Regel für den normalen Betrieb von Apache bereits richtig konfiguriert und sollten nur von versierten Benutzern verändert werden. Starten / Stoppen von Apache Um den Apache Web-Server zu stoppen resp. zu starten, wenn Sie diesen nicht als Dienst installiert haben, finden Sie im Startmenü die neue Programmgruppe Control Apache Server: Alternativ können Sie Apache, wenn Sie diesen als Dienst installiert haben, auch aus der Dienstverwaltung (Einstellungen -> Systemsteuerung -> Verwaltung -> Dienste unter Windows 2000) stoppen und starten: Tel. 052 / Seite 4 von 9 info@scada.ch

5 Apache 2.0.x Apache 2.0.x ist die Weiterentwicklung des bekannten Apache-Servers und mittlerweile in einer produktiven Version verfügbar. Neben anderen ist ein wesentlicher Vorteil von Apache 2.0.x gegenüber der Version 1.3.x, dass hier auf die speziellen Eigenschaften wie Multitasking etc der verschiedenen Betriebssysteme (wie z.b. Windows) besser eingegangen werden kann, d.h. der Server effizienter und schneller läuft. Ein Nachteil ist, dass noch nicht alle Module für Apache 2.0.x umgeschrieben wurden und die Module von Apache 1.3.x aufgrund verschiedener API-Strukturen nicht für Apache 2 verwendet werden können. Benötigen Sie keine externen Module, können Sie Sich für Apache 2 entscheiden, wenn Sie das optimierte Multitasking verwenden möchten. Installation Nachdem Sie von den neuesten Build der Windows Binaries herunter geladen haben, können Sie das MSI-Paket wie gewohnt doppelklicken. Es erscheint darauf der Installationsagent, der Sie durch die weiteren Schritte der Installation führen wird: Wenn Sie die Lizenzvereinbarung auf dem nächsten Bildschirm akzeptieren, gelangen Sie zum Readme von Apache und schliesslich zu einer Konfigurationsseite, bei der Sie die grundlegende Serverkonfiguration wie beispielsweise Servername und Domain festlegen können: Tel. 052 / Seite 5 von 9 info@scada.ch

6 Domain: Wenn Ihr Server im Internet ansprechbar sein soll und Sie bereits eine Domäne bei einem Provider reserviert haben, geben Sie diese hier ein. Wenn Sie den Server nur im internen Netz über die IP-Adresse ansprechen wollen, können Sie hier beispielsweise auch firma.local angeben. Server Name: Dies ist der Rechnername des Servers. Für einen Webserver kann dies z.b. oder demoserver.firma.ch sein. Adresse: Geben Sie hier die Adresse des Server-Administrators ein. Diese wird bei Fehlermeldungen mitgeliefert, damit der Benutzer weiss, an wen er sich im Fehlerfall wenden muss (meist Installationsart: Besondere Beachtung gilt der Wahl der Installationsart (automatisch oder manuell gestartet). Wenn Sie Apache als einzigen Webserver auf dem PC betreiben oder wenn Sie Apache und einen weiteren Web-Server (z.b. Internet Information Server von Microsoft) auf getrennten Ports installieren, können Sie Apache automatisch starten. Möchten Sie beispielsweise Apache und den Internet Information Server alternativ auf dem selben Port verwenden, müssen Sie Apache manuell starten (mehr zur Konfiguration später im Dokument). Apache 2 sieht beim manuellen Start bereits vor, dass ein weiterer Webserver installiert ist und wird sich daher auf Port 8080 installieren. Im weiteren Verlauf der Installation können Sie wählen, ob Sie Apache komplett oder benutzerdefiniert installieren möchten sowie den Installationspfad. Diese Dokumentation geht davon aus, dass Sie Apache komplett und im Standard-Pfad (\programme\apache group) installieren. Eine weitere Konfiguration ist zur Fertigstellung des Assistenten nicht erforderlich. Wenn Sie die Installation abgeschlossen haben und den Apache-Server gestartet haben, können Sie im Browser mit (resp. wenn Sie Apache 2 mit der Option für manuellen Start installiert haben) prüfen, ob der Server ordnungsgemäss installiert wurde: Tel. 052 / Seite 6 von 9 info@scada.ch

7 Konfigurieren von Apache 2.0.x Wenn Sie Apache 1.3.x im Standardverzeichnis (\programme\apache group) installiert haben, finden Sie unter \programme\apache group\apache2\conf die Konfigurationsdatei httpd.conf. Neben verschiedenen Feineinstellungen sowie dem Laden von zusätzlichen Modulen (z.b. PHP) können Sie hier die Grundkonfiguration des Servers ändern. Suchen Sie hierzu in der httpd.conf die Zeile Section 2: 'Main' server configuration. Hier sind vor allem folgende Parameter von Bedeutung: ServerAdmin Die -adresse des Server-Administrators, wie Sie sie bei der Installation angegeben haben. ServerName Der Name des Servers, wie Sie ihn bei der Konfiguration angegeben haben. Zusätzlich wird hier mit : der Port angegeben, an den sich der Server binden soll. DocumentRoot Dies entspricht dem Basisverzeichnis im Internet Information Server, d.h. Apache wird die html-seiten in diesem Verzeichnis suchen. Dieses Verzeichnis können Sie z.b. auf das Docs-Verzeichnis Ihrer Wizcon-Applikation legen. Bitte beachten Sie, dass Wizcon diesen Pfad in Apache nicht automatisch anpassen kann, wenn Sie eine neue Applikation laden und dass Sie Apache neu starten müssen, wenn Sie Änderungen am config-file vorgenommen haben. <directory c:\programme... Dieser Parameter legt die Sicherheitseinstellungen für das Web-Verzeichnis fest. Bitte ändern Sie den Pfad auf das selbe Verzeichnis wie Sie unter DocumentRoot angegeben haben. Tel. 052 / Seite 7 von 9 info@scada.ch

8 Möchten Sie den Port für den Server generell ändern, so finden Sie unter Section 1 in der httpd.conf den Eintrag Listen. Dieser Parameter gibt an, an welchen Port sich der Server binden soll. Bitte beachten Sie, dass der Eintrag ServerRoot, welchen Sie in der Datei httpd.conf finden, nicht dem html-verzeichnis entspricht! ServerRoot beinhaltet den Pfad, in dem Apache installiert ist und gibt dem Server an, wo nach Konfigurationsfiles und Logdateien gesucht werden muss und sollte nicht geändert werden. Alle weiteren Optionen sind in der Regel für den normalen Betrieb von Apache bereits richtig konfiguriert und sollten nur von versierten Benutzern verändert werden. Starten / Stoppen von Apache 2 Das Starten und Stoppen von Apache 2 erfolgt analog zu Apache 1. Zusätzlich habe Sie die Möglichkeit, Apache 2 über den Apache Monitor ( ), welcher in der Task-Leiste eingeblendet wird, zu kontrollieren: Tel. 052 / Seite 8 von 9 info@scada.ch

9 Apache und Wizcon Bitte beachten Sie, dass Wizcon weder Apache 1 noch Apache 2 automatisch konfigurieren kann, d.h. wenn Sie ein neues Projekt laden, müssen Sie die Pfade für das Docs-Verzeichnis anpassen resp. manuell einrichten. Während dies beim Microsoft Internet Information Server automatisch geschieht, müssen Sie mit Apache sogenannte Alias in der Datei \programme\apache group\apache\conf\httpd.conf einrichten. Die Syntax des Befehls lautet: Alias [Quelle] [Ziel], für ein Wizcon-Projekt könnte dies also lauten: Alias /Docs c:/projekte/webdemo/docs. Dies weist Apache an, alle Anfragen Dateien, die der Client aus /docs abruft, in c:\projekte\webdemo\docs (Ihr Projektverzeichnis) zu suchen. Wenn Sie alle html-seiten im Wizcon Docs-Verzeichnis speichern, können Sie alternativ direkt das Apache DocumentRoot auf das Wizcon Docs-Verzeichnis konfigurieren. Die Verwendung der Alias-Direktive erfordert zusätzlich die Angabe einer <Directory> Direktive, um den Zugriff auf dieses Verzeichnis zu regeln. Vorschläge für Alias-Direktiven, die Wizcon benötigt, sowie die zugehörigen Directory Direktiven sind im folgenden kurz erwähnt und können beispielsweise am Ende der Konfigurationsdatei eingefügt werden. Bitte beachten Sie, dass diese Zeilen nicht innerhalb einer Konfigurationsgruppe eingefügt werden sollten. Solche Blöcke erkennen Sie daran, dass sie durch <befehl> und </befehl> eingeschlossen sind, wie beispielsweise <Directory> und </Directory>. Fügen Sie diese Zeilen daher erst nach dem </...> Tag ein. Wizcon Docs (wenn Docs nicht dem Document Root des Servers entspricht): Alias /docs C:/projekte/applikation <Directory C:/projekte/applikation> Order allow,deny Allow from all </Directory> Webscheduler: Momentan ist es leider noch nicht möglich, den WebScheduler mit Apache zu verwenden, da Apache noch keine in JavaScript programmierten Active Server Pages unterstützt. Es gibt jedoch kommerzielle Server für Unix/Linux Systeme, welche ASP vollständig unterstützen würden. Auf Windows-Systemen ist für die Benutzung des Web-Schedulers der Einsatz von Microsoft IIS noch zwingend. Bitte passen Sie die blau markierten Teile Ihrer Wizcon Installation entsprechend an. Wir wünschen Ihnen viel Erfolg bei der Installation des Apache Servers. Für Fragen stehen wir Ihnen jederzeit zur Verfügung. Ihr Support Team (support@scada.ch) Scada Soft AG Tel. 052 / Seite 9 von 9 info@scada.ch