Neuerungen / Unterschiede gegenüber alten Paketen/Platform:

• PHP 5.3: Es steht PHP 5.3 statt PHP 5.2 zur Verfügung
• Speicherplatz: Alle Pakete verfügen über mehr oder mindestens gleich viel Speicherplatz wie die alten Pakete
• SharedSSL: Die “Private” Pakte Line unterstützen kein Shared SSL

Migration wann?

Paketwechsel

• PHP 5.3: Prüfen Sie, ob die von Ihnen eingesetzte Software (und Version) unter PHP 5.3 funktioniert (Herstellerangabe)


• PDF-Lib wird auf der neuen Plattfrom NICHT mehr unterstützt. Wenn Sie diese nutzen, muss auf eine freie Alternative, z.B. TCPDF ausgewichen werden. Machen Sie den Wechsel vor der Migration damit die PDF Funktionen weiterhin genutzt werden können.


• Absolute Pfade (/home/i/h/ihrdomain.ch/htdocs/…) sind auf der neuen Platform nicht identisch, notieren Sie sich am besten wo solche Pfade vorkommen (zum Beipsiel in Config-Dateien der entsprechenden Scripte) damit Sie sie nach der Migration umgehend ändern können.


• Ein Paketwechsel ist mit einem Ausfall der Website von bis zu 3h verbunden (DNS-Propagation Delay)


• Datenbanken sind bei einem Wechsel nicht betroffen, da diese auf eigenen Datenbankservern liegen. Trotzdem kann es zu Problemen kommen. Wenn die verwendeten Skripte nicht explizit den Charset gesetzt haben, wurde unter der alten Platfrom latin1 genutzt, unter der neuen wird aber UTF8-verwendet. Falls Sie also Probleme bei der Darstellung von Daten aus der DB haben (falsche Umlaute usw), müssen Sie in Ihrem Script den MySQL-Charset korrekt setzen. Gute Scripts haben hierfür entsprechende Setupeinstellungen. Andernfalls ist z.B. folgender PHP-Befehl am korrekten Ort ins Script einzufügen: mysql_set_charset(“latin1″); .Sie können auch die bestehende Datenbank umwandeln, z.B. von latin1 nach utf8. Dies ist im NetConfig Adminpanel möglich.


• E-Mail ist von einer Migration nicht betroffen und läuft unterbruchsfrei weiter

Wie kann ich eine Migration anfordern?

Rückmigration

- In Ihrer HTML-Seite muss das Formular durch folgende Tags “eingerahmt” werden:

<form method="POST" action="/cgi-bin/form.php">
...
</form>

- Durch versteckte Formularfelder, können Sie das Skript steuern. Sie fügen dazu einfach HTML-Tags der folgenden Art in Ihr Formular ein:

<input type="hidden" name="Feldname" value="Feldwert">

Mögliche Parameter

Feldname und Feldwert sind entsprechend folgender Tabelle anzugeben:

<INPUT TYPE="HIDDEN" NAME="MAILTEXT"
VALUE="Die Adresse des Bestellers ist: {Adresse}  !!">

<INPUT TYPE="HIDDEN" NAME="MAILTEXTURL"
VALUE="http://www.ihrname.ch/mailvorlage.txt">

<INPUT TYPE="HIDDEN" NAME="SUBJECT"
VALUE="Bestellformular">

<INPUT TYPE="HIDDEN" NAME="OKURL"
VALUE="http://www.IhrName.ch/danke.html">

<INPUT TYPE="HIDDEN" NAME="NOTOKURL"
VALUE="http://www.IhrName.ch/fehler.html">

<INPUT NAME="Vorname*">

<INPUT TYPE="HIDDEN" NAME="CC" VALUE="info@IhrName.ch, bestellung@IhrName.ch">

Bemerkung zu EMail-Adressen in Formularfeldern (TO, CC, BCC und FROM)

Spammer suchen mit Hilfe von speziellen Programmen Homepages nach EMail-Adressen ab, um an solche gefundenen Adressen Werbemails zu versenden. Damit Ihre EMail-Adresse nicht als solche erkannt wird, können Sie anstelle dem @-Zeichen auch (AT) schreiben, also z.B. statt: <INPUT TYPE="HIDDEN" NAME="TO" VALUE="info@IhrName.ch"> schreiben Sie dann <INPUT TYPE="HIDDEN" NAME="TO" VALUE="info(AT)IhrName.ch">

Wichtig!! Als Zieladresse für Ihr Formular (Felder TO,CC,BCC) werden nur EMail-Adressen, welche Sie bei NetZone eingerichtet haben akzeptiert, also keine Fremdadressen von gmx, hotmail usw! Falls Sie die Formulardaten trotzdem an eine solche Adresse senden möchten, muss mit NetConfig eine entsprechende EMail- Weiterleitung eingerichtet werden.

Beispiel-Formulare finden Sie hier

Sicherheitscode gegen Spam

Aufgrund vermehrter Spammail über Kontaktformulare haben wir unser Formularscript angepasst, um Sie vor Spam besser zu schützen. Es wird dasselbe Verfahren wie bei den Gästebüchern namens ‘Captcha’ verwendet. Zur Aktivierung sind zwei Anpassungen erforderlich. Die Anpassung Ihres Formulares selbst und die Aktiverung der Captcha Unterstützung für Formulare:

HTML Code Folgendes Beispiel können Sie direkt in Ihren HTML-Code übernehmen, üblicherweise ist dies sinnvoll am Ende des Formulares, beispielsweise vor dem Submit-Button (Sendeknopf)

<img name='captcha' id='captcha' src='/cgi-bin/captcha.php?action=pic'>
<br>
<div style="text-decoration: underline;" OnClick="javascript:var datum = new Date(); 
document.getElementById('captcha').src='/cgi-bin/captcha.php?action=pic&rnd=' + 
Date.UTC(datum.getFullYear(), datum.getMonth(), datum.getDate(), datum.getHours(), datum.getMinutes(), datum.getSeconds() ) +
datum.getMilliseconds();">Neues Bild / Reload</div><br>

Bitte obenstehenden, f&uuml;nfstelligen Buchstabencode eingeben
<br><input type='text' name='captcha'>

NetConfig anpassungen Desweiteren muss im NetConfig unter WWW-Domains die ‘Option Captcha bei Formularen’ aktiviert werden. Beachten Sie, dass diese Option bewirkt, dass Formulare nur noch versendet werden, wenn der Captcha Code korrekt eingegeben wurde. Sie müssen also all Ihre Kontaktformulare anpassen, unveränderte werden danach nicht mehr funktionieren.

Sollten Sie Hilfe beim Aktivieren des Sicherheitscodes benötigen, können wir die Anpassung Ihres Formulares für CHF 15.- pro Formular übernehmen. Senden Sie uns hierzu einen Link zu jedem Formular, welches angepasst werden muss.

Folgende Servervariabeln ($_SERVER[]) werden von NetZone unterstützt:

• DOCUMENT_ROOT
• HTTP_HOST
• HTTP_USER_AGENT
• PATH_INFO
• PHP_AUTH_USER
• PHP_AUTH_PW
• PHP_SELF
• QUERY_STRING
• REMOTE_ADDR (ausser secure)
• REQUEST_URI
• SCRIPT_FILENAME
• SCRIPT_NAME
• SCRIPT_URL
• SCRIPT_URI
• SERVER_ADMIN
• SERVER_NAME

Andere Variabeln sind zwar teilweise verfügbar, können bei späteren Updates aber eventuell entfallen. Wir garantieren nur die Verfügbarkeit obenstehender Variablen. Statt der Environment-Variablen ($_ENV[]) müssen immer die Servervariablen ($_SERVER[]) genutzt werden.

PHP und MySQL

Mit Hilfe von PHP und z.B. MySQL realisieren Sie z.B. dynamische Webseiten mit Datenbankunterstützung. Selbstverständlich sind damit noch nicht alle Möglichkeiten dieser Sprache ausgereizt.

Um in Ihren PHP Scripts eine MySQL Datenbank einzubinden benötigen Sie die MySQL Funktionen. Die Dokumentation finden Sie unter http://www.php.net/manual/de/ref.mysql.php

MySQL-Datenbanken können Sie selber mit NetConfig einrichten. Sie finden diese Funktion unter [Praesenzinformationen] und dann [MySQL]. Die angelegte Datenbank können Sie mit MySQLAdmin per Webbrowser verwalten.

Deaktivierte Funktionen

PHP bietet eine Vielzahl an Funktionen welche im normalen Betrieb nicht benötigt werden, jedoch potentielle Sicherheitsrisiken darstellen. Wir haben eine Anzahl dieser Funktionen standardmässig deaktiviert. Sie können jede deaktivierte Funktion aber jederzeit im NetConfig unter WWW-Domains -> PHP wieder aktivieren.

Wenn Sie folgende Fehlermeldung auf einer Seite erhalten, ist dies aufgrund einer deaktivierten Funktion:

Warning: function ''Funktionsname()'' has been disabled for security reason

Aktivieren Sie die unter ‘Funktionsname’ genannte Funktion im NetConfig, um den Fehler zu beseitigen.

PHP Execution Error

Dieser Fehler tritt auf, wenn Ihre Datei ein Sicherheitsrisiko darstellt. Stellen Sie sicher, dass die Datei nicht von jedermann veränderbar ist (CHMOD 600 ist für PHP Files ideal).

Dateizugriff auf externe Quellen

Probleme mit fopen

Der Befehl fopen und artverwandte bieten die Möglichkeit, auf einfache Art und Weise eine Datei zu öffnen um aus dieser zu lesen oder zu schreiben. Mit fopen ist es ausserdem möglich, eine URL direkt anzugeben, um den Inhalt dieser Website auszulesen. Dies ist jedoch ein grosses Sicherheitsrisiko, da bei unsicher programmierten Scripten die Möglichkeit besteht, PHP Code aus einer fremden Quelle auf unseren Servern auszuführen. Dies ermöglicht es dann von Ihrer Homepage aus und somit in Ihrem Namen Spam zu versenden oder gar schwere Attacken gegen andere Rechner, Banken usw durchzuführen.

Um unsere Kunden zu schützen, haben wir wie auch zahlreiche andere sicherheitsbewussten Provider fopen und verwandte Befehle eingeschränkt, sodass nur noch lokale Dateien geöffnet werden können. Wenn Sie jedoch trotzdem eine Fremdseite auslesen möchten, müssen Sie dies über die alternative fsockopen tun oder über von NetZone zur Verfügung gestellte Ersatzbefehle.

Reaktivierung von allow_url_fopen

Sollte es unumgänglich sein, auf externe Datenquellen zuzugreifen, können wir url_fopen für Sie reaktivieren. Beachten Sie aber unbedingt folgende Punkte:

• Halten Sie all Ihre Scripte immer auf dem neusten Stand – Sicherheitslücken in Verbindung mit url_fopen können Angreifern uneingeschränkten Zugriff gewähren.
• Wir Ihre Homepage von Angreifern übernommen, behalten wir uns vor, diese ohne Benachrichtigung sofort zu sperren.

fsockopen als alternative

Wenn Sie eine externe Seite auslesen wollen, muss dies über den Befehl fsockopen geschehen. Mit fsockopen wird jedoch kein Filepointer wie bei fopen erzeugt, sondern eine direkte Verbindung zum Fremdserver hergestellt. Sie müssen diesem per HTTP Befehlen mitteilen, welche Seite abgerufen werden soll.

NetZone Funktion

Wir haben für Sie eine Funktion geschrieben, welche es einfacher machen sollte, bestehende Scripte anzupassen. Fügen Sie am Anfang der Datei (innerhalb der PHP Tags)

include_once('/home/httpd/php/fopen_http.php');

Danach können Sie jeden fopen oder file Befehl, der auf eine HTTP Adresse zugreift, durch den Befehl fopen_http bzw. file_http ersetzen.

Reaktivierung von fopen auf Anfrage

Unter Umständen lässt sich die Verwendung von url_fopen nicht umgehen, beispielsweise bei Webapplikationen die Sie nicht selbst entwickelt haben, wie z.B. Weblication. Aus Sicherheitsgründen benötigen Sie PHP5 ist als Standardinterpreter für alle PHP Files, keine Dateiendung darf mehr von PHP4 interpretiert werden. Da PHP4 keinen Unterschied zwischen url_include und url_fopen kennt, und url_include ein äusserst gefährliches Sicherheitsrisiko darstellt kann PHP4 nicht länger verwendet werden.

Wenn Sie die Einstellungen entgegen dieser Richtlinien verändern, wird url_fopen kommentarlos wieder deaktiviert.

Sind Sie mit diesen Einschränkungen einverstanden, senden Sie uns eine Mail. Vergessen Sie nicht, den betroffenen Domainnamen zu erwähnen.

Optimierer und Decoder

Wir bieten Ihnen mehrere Optimizer/Decoder an, welche jedoch nicht alle zusammen verwendet werden können. Grundsätzlich empfiehlt es sich, APC (ohne stat) zu verwenden. ZendOptimizer ist inkompatibel zu APC und sollte nur genutzt werden, wenn ZendEncoded Files bestehen. Der IonCube Loader kann immer verwendet werden, sollte jedoch nur aktiviert werden, wenn Sie diesen benötigen, um unnötigen Overhead und dadurch langsamere Scriptausführung zu vermeiden.

ZendOpimizer

Der ZendOptimizer hat einen trügerischen Namen, es wird nämlich keinerlei Optimierung vorgenommen, diese Erweiterung dient nur zum Dekodieren von ZendEncoded Files. Dies wird meist nur benötigt, wenn Sie PHP-Software einkaufen, welche vom Entwickler durch die Kodierung verschlüsselt wurde. Wichtig: Die Geschwindigkeit der Ausführung von PHP Files kann abnehmen, wenn ZendOptimizer aktiviert ist, aufgrund der zusätzlichen Arbeit die PHP durchzuführen hat.

APC

APC ist ein echter Optimierer und kann die Ausführung von PHP Scripts stark beschleunigen. Dies geschieht, indem alle PHP Files, bei der ersten Ausführung zwischengespeichert werden und für spätere Verwendung nicht mehr komplett gelesen werden müssen. APC profitiert jedoch am meisten, wenn dieser gar nicht mehr prüfen muss, ob die Originaldatei geändert wurde sondern direkt die gecachte Version nutzen kann. Darum gibt es zwei Varianten für APC: mit stat und ohne stat. Bei der Aktivierung von APC ohne stat können enorme Geschwindigkeitvorteile entstehen. Wenn Sie PHP Files aktualisieren, müssen Sie jedoch einige Minuten warten, bis die neue Version zum Zuge kommt. Bei APC mit stat ist der Geschwindigkeitsvorteil geringer, dafür werden geänderte Dateien sofort erkannt. APC mit stat ist somit nur sinnvoll, während Sie Ihre Seite aktualisieren oder anpassen und wird darum jeden Sonntag automatisch auf APC ohne stat umgestellt.

ionCube Loader

Der ionCube Loader kann zum einen generell im NetConfig unter PHP aktiviert werden und gilt dann für alle Ihre PHP Files. Dies ist jedoch nur sinnvoll, wenn die meisten Ihrer Dateien mit IonCube kodiert wurden. Alternativ kann der Loader auch mit dem dl() Befehl eingeladen werden, sofern benötigt. Aktivieren Sie hierfür die dl() funktion im NetConfig unter PHP Einstellungen, da diese standardmässig aus Sicherheitsgründen deaktiviert ist. Anschliessend können Sie den Loader jederzeit mittels der folgenden Zeilen aktiviert werden:

if(!extension_loaded('ionCube Loader')){
    @dl('ioncube_loader_lin_' . substr(phpversion(),0,3) . '.so');
}
if(function_exists('_il_exec')){
    return _il_exec();
}else{
    echo "ionCube Loader konnte nicht geladen werden";
}

Daten auf dem Internet werden normalerweise unverschlüsselt übertragen. Dies ist oftmals sehr problematisch, z.B. wenn Kreditkarteninformationen usw. per Internet verschickt werden. SSL ist ein Protokoll, welches den Datentransport auf dem Internet sicher macht. Bei einer mit SSL gesicherten Verbindung werden die Daten verschlüsselt übertragen. Der Server, zu dem eine SSL-Verbindung aufgebaut wird, muss zudem durch eine offizielle Zertifizierungsstelle “beglaubigt” werden.

SSL eignet sich deshalb sehr gut für die Übertragung von Kreditkarteninformationen, schützenswerten Personendaten usw. Die Sicherheit von SSL ist vergleichbar mit derjenigen eines Bankomaten.

Um einen SSL-Server betreiben zu können, muss für diesen ein beglaubigtes Zertifikat vorliegen. Solche Zertifikate werden derzeit von Thawte, GeoTrust und Verisign ausgestellt. Geotrust-Zertifikate sind deutlich preiswerter als diejenigen von Verisign und Thawte. NetZone ist offizieller Hosting-Partner von GeoTrust und Thawte.

Wie verwenden Sie den NetZone-SSL-Server ?

NetZone hat einen sicheren SSL-Server eingerichtet. Dieser steht auch unseren Kunden kostenlos zur Verfügung! Da der Datenverkehr über den NetZone-SSL-Server-läuft, brauchen Sie dazu auch kein eigenes Zertifikat.

Falls Sie eine sichere Verbindung wünschen, kopieren Sie die entsprechenden Dokumente nicht ins htdocs-Verzeichnins sondern ins Verzeichnis /secure. Der Zugriff auf diese Seiten erfolgt dann folgendermassen

Damit Sie den SSL-Server nutzen können, müssen Sie diesen mit NetConfig zuerst aktivieren! Sie finden diesen Menüpunkt in NetConfig unter [Homepagedomain] und dann die [Option SSL] aktivieren.

Kunden ohne eigene Domain (z.B.: http://www.netzone.ch/IhrName)

Der Pfad lautet https://secure.netzone.ch/netzone.ch/users/IhrName/ Beachten Sie, dass Sie http:// durch https:// ersetzen. Solche URL’s werden automatisch durch den sicheren SSL-Server verarbeitet!

Beispiel: Um das Dokument geheim.html sicher zu transferieren, kopieren Sie dieses ins secure Verzeichnis und verwenden Sie die URL:

https://secure.netzone.ch/netzone.ch/users/IhrName/geheim.html

Kunden mit eigener Domain: http://www.IhrName.ch

Um den sicheren SSL-Server von NetZone verwenden zu können, ist folgender Pfad zu verwenden: https://secure.netzone.ch/IhrName.ch/ Beachten Sie, dass http:// durch https:// ersetzt wurde.

Beispiel: Um das Dokument geheim.html sicher mit unserem SSL-Server übertragen zu können, kopieren Sie es in Ihr secure Verzeichnis und verwenden Sie die URL:

https://secure.netzone.ch/IhrName.ch/geheim.html

Wie verwenden Sie SSL mit einem eigenen Zertifikat ?

In seltenen Fällen kann es für Sie sinnvoll sein, einen eigenen SSL-Server zu betreiben. Dies ist z.B. notwendig, wenn Sie Tomcat-Applikationen über eine sichere Verbindung laufen lassen möchten. Auch dafür sind Sie bei uns an der richtigen Adresse; NetZone ist offizieller GeoTrust-Partner und Thawte-Partner in der Schweiz. Bitte setzen Sie sich mit unserem Support service@netzone.ch in Verbindung.

Richtig spannend wird es im WWW erst, wenn man dynamische Dokumente erzeugt, also eine Anfrage nicht immer das gleichbleibende Dokument hervorzaubert, sondern dessen Inhalt sich in Abhängigkeit von Anfrage, Uhrzeit oder dergleichen ändert. Eine Möglichkeit dazu bieten CGI-Programme, deren Verwendung aber gewisse Kenntnisse der Programmierung voraussetzen. Eine simplere Methode sind die SSIs. Sie haben damit die Möglichkeit, vor dem Absenden eines Dokumentes, dynamisch einzelne Textstellen zu ändern.

Nachtrag: SSI ist eine heutzutage nur noch selten verwendete Möglichkeit dynamische Seiten zu generieren. Programmiersprachen wie PHP (http://www.php.net) bieten weitaus mehr Möglichkeiten und sind relativ einfach zu erlernen.

Das Konzept der Server Side Includes

Hinter dem Schlagwort SSI verbirgt sich das Konzept, spezielle Direktiven in HTML-Seiten einzubetten, die vom Server vor der Rückgabe des jeweiligen Dokumentes erkannt, ausgewertet und durch anderen Text ersetzt werden. Sollen z.B. auf jeder Seite angezeigt werden, wann diese zuletzt aktualisiert wurde, dann musste bisher der Webmaster bei jeder Änderung auch dieses Datum auf allen Seiten anpassen. Dies ist eine mühsame und fehlerträchtige Aufgabe. Viel einfacher gehts mit SSI. Sie fügen ein speziellen Tag in das HTML-Dokument ein und der Server ersetzt dies beim Abspielen automatisch mit dem gewünschten Datum! Sie können mit SSI auch ganze Dokumente so einfügen. NetZone verwendet diese Möglichkeit z.B. für praktisch alle Seiten! Anstelle des Erstellen von Menübalken auf jeder Page, wird dieser einmal designed und der entsprechende HTML-Code in einer separaten Datei gesichert. In allen Dokumenten wird dann nur noch ein Verweis darauf eingefügt, der Server erledigt den Rest. Ändert sich mal der Menübalken, genügt es diese eine Datei anzupassen und alle Seiten sind sofort aktuell.

Damit der Server weiss, ob ein Dokument SSI-Kommandos enthält, muss die Datei die Endung .shtml tragen. Nur dann wird das Dokument entsprechend verarbeitet!

Natürlich hat das Ganze auch einen kleinen Haken. Da solche .shtml-Seiten vor der Rückgabe durch den Server erst noch geparsed werden müssen, dauert der Seitendownload gegenüber normalen .html-Seiten etwas länger.

SSI-Kommandos werden in HTML Dokumenten in Form von Kommentaren eingebettet.

<!--SSI-Kommando-->

Achtung: Zwischen <!– und SSI-Kommando darf kein weiteres Zeichen stehen, auch kein Leerzeichen!

Beispiel: <!–#echo var=”DATE_LOCAL” –>

Dies fügt die aktuelle Uhrzeit und das Datum in Ihr Dokument ein.

Die SSI-Referenz

#config errmsg=fehlermeldung
#config sizefmt=grössenformat
#config timefmt=zeitformat

Über das #config-Kommando werden die Formate für die Ausgabe der Dateigrösse (s. #fsize) eines Datums oder der Uhrzeit (s. flastmod und echo) definiert. Darüber hinaus kann ein Text definiert werden, der immer dann in die HTML-Seite eingefügt wird, wenn ein Fehler bei der Bearbeitung eines SSI-Kommandos aufgetreten ist

errmsg-Attribut: Fehlermeldung sizefmt-Attribut: “abbrev”=Dateigrösse wird auf kb gerundet, “bytes” Ausgabe in Einheit bytes. timefmt-Attribut: siehe folgende Tabelle:

Beispiel: <!–#config sizefmt=”abbrev” timefmt=”%d.%m.%Y” errmsg=”FEHLER!!!” –>

#include file=datei
#include virtual=/verz/datei

Das #include-Kommando wird verwendet um den Inhalt einer Datei in den Quelltext der HTML-Seite einzubetten. file: Bei Verwendung des file-Attributs ist zu beachten, dass keine Pfadangaben erlaubt sind, d.h. dass die Datei im selben Verzeichnis stehen muss, wie das HTML-Dokument selber. virtual: Bei Verwendung des virtual-Attributs ist ein Pfad relativ zum virtuellen Server möglich.

Beispiel: <!–#include file=”menue.txt” –>

#echo var=cgi_variable

Das #echo-Kommando wird zur Ausgabe von Umgebungsvariablen verwendet. Es stehen folgende Variabeln zur Verfügung:

Beispiel: <!–#echo var=”LAST_MODIFIED” –> Siehe auch SSI-Kommando #printenv.

#exec cmd=datei
#exec cgi=url

Das #exec-Kommando führt das angegeben Programm aus und fügt dessen Ausgabe in das HTML-Dokument ein. Sofern Sie dem aufzurufenden Programm einzelne Parameter übergeben wollen, so sollten Sie die Funktion include verwenden, da exec mit Parametern nicht fehlerfrei arbeitet.

#include file=datei
#include virtual=/verz/datei

Das #include-Kommando wird verwendet um den Inhalt einer Datei in den Quelltext der HTML-Seite einzubetten. file: Bei Verwendung des file-Attributs ist zu beachten, dass keine Pfadangaben erlaubt sind, d.h. dass die Datei im selben Verzeichnis stehen muss, wie das HTML-Dokument selber. virtual: Bei Verwendung des virtual-Attributs ist ein Pfad relativ zum virtuellen Server möglich.

Beispiel: <!–#include file=”menue.txt” –>

#flastmod file=datei
#flastmod virtual=/verz/datei

Das #flastmod-Kommando gibt das Datum der letzten Änderung einer bestimmten Datei aus. Siehe auch #include.

Beispiel: <!–#flastmod file=”index.html” –>

#fsize file=datei
#fsize virtual=/verz/datei

Das #fsize-Kommando gibt die Grösse der angegebenen Datei aus. Siehe auch #include.

Beispiel: <!–#flastmo file=”index.html” –>

#if expr="test_condition"
#elif expr="test_condition"
#else
#endif

Mit diesen Kommandos funktionieren analog wie in einer üblichen Programmiersprache.

wobei mögliche test_condition:

Bemerkungen: Falls für string2 die Form /string2/ hat, wird dieser als regulärer Ausdruck analog dem Unix-Commando egrep interpretiert.

Beispiel:

<!--#if expr="\"$SERVERNAME\" = \"www.netzone.ch\"" -->
Server heisst NetZone
<!--#else -->
Server heisst nicht NetZone
<!--#endif -->

#printenv

Druckt eine Liste aller Umgebungsvariablen.

#set var="X" value="Y"

Weist der Variablen mit dem Namen X den Wert Y zu.

Beispiel: <!–#set var=”category” value=”help” –>

Tomcat ist ein Java Servlet Container. Er ist die Referenz Implementation der Java Servlet und JavaServer Pages. Ein Servlet ist ein Java Programm, welches in einer speziellen Umgebung auf dem Server ausgeführt wird. Tomcat wurde von der Jakarta Projektgruppe entwickelt. Diese wird von der Apache Software Foundation unterstützt. Weitere Informationen (in Englisch) finden Sie auf der http://tomcat.apache.org Website.

Tomcat bei NetZone

Die Tomcat-Umgebung ist bei NetZone als Option in 2 verschiedenen Varianten verfügbar.

1. Shared-Tomcat: Hier teilen sich mehrere User die Tomcat-Instanz. Vorteile: sehr kostengünstig. Nachteile: weniger stabil, da einzelne Applikationen die ganze Instanz in Mitleidenschaft ziehen können.
2. Eigene Tomcat-Instanz: Hier hat der Benutzer seine eigene Tomcatinstanz mit eigenem Speicherbereich. Vorteile: Stabil und somit für kommerzielle Anwendungen sehr gut geeignet. Der User kann seinen Tomcat selber starten und stoppen. Nachteil: Tomcat ist sehr ressourcenhungrig und somit ist diese Installation kostenintensiver. Hier wird nach verwendetem Hauptspeicher (nicht Diskspeicher!) abgerechnet. In der Basisinstallation sind 128 MB verfügbar, Zusatzspeicher kann in 128 MB Paketen hinzugefügt werden

Als Tomcat-Server werden Server mit schnellen Intel XEON-Prozessoren und mit bis zu 48 GB RAM verwendet.

Die Tomcat Manager Application

Um Ihnen das Entwickeln / Administrieren Ihrer Webapplikation möglichst einfach zu gestalten haben wir die Manager Applikation freigeschalten. Die HTML Version ist unter /webapps/manager/html zu finden. Die Bedienung des HTML Managers sollte selbsterklärend sein. Zum Manager allgemein und auch zur Steuerung mit skripts finden Sie unter http://jakarta.apache.org/tomcat/tomcat-5.5-doc/manager-howto.html weitere Information (in Englisch).

Die Tomcat Logfiles

Erstellen Sie im Verzeichnis WEB-INF/classes Ihrer Applikation eine Datei mit dem Namen log4j.properties.

Die Datei hat folgenden Inhalt:

log4j.debug=TRUE
log4j.rootLogger=INFO, R

log4j.appender.R=org.apache.log4j.RollingFileAppender
log4j.appender.R.File=/home/i/h/ihrname.ch/tomcatlogs/tomcat.log
log4j.appender.R.MaxFileSize=100KB
log4j.appender.R.MaxBackupIndex=5
log4j.appender.R.layout=org.apache.log4j.PatternLayout
log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss.SSSS} %p %t %c - %m%n

Ersetzen Sie dabei den roten Teil mit dem Absolutpfad Ihres Logfiles.

Installation von Applikationen unter Tomcat 5.5

Sie finden in Ihrem htdocs/webapps Verzeichnis zwei Unterverzeichnisse, context und example. Im example finden Sie ein kleines .jsp Beispiel, eine .war Datei mit einem Servlet drin, und das entpackte Servlet. Dieses Servlet können Sie mit </nowiki>http://ihredomain.ch/webapps/example/HelloWorld</nowiki> aufrufen. Das .jsp file kann direkt ausgeführt werden.

Im context Verzeichnis finden sie auch zwei .xml Dateien, diese enthalten <Context> Elemente, welche dazu dienen, den Context Ihrer Applikation für Ihre Bedürfnisse zu konfigurieren.

Sie können beliebig eigene Applikationen hinzufügen. Das example kann als Vorlage dienen. Bitte beachten Sie das es für Servlets unbedingt ein “WEB-INF” Verzeichnis und eine web.xml Datei braucht sowie ein context-File im context-Verzeichnis. Die meisten Java IDE’s sind in der Lage ein .war file mit passender web.xml zu erstellen.

Wir empfehlen Ihnen folgendes Vorgehen beim Installieren einer neuen Applikationen abc:

1. Erstellen Sie ein Context-File mit dem Namen webapps#abc.xml für Ihre neue Applikation im Verzeichnis /webapps/context/

2. Laden Sie Ihre Applikation per FTP auf den Server (nicht als .war-File sondern bereits entpackt ins zugehörige Verzeichnis mit dem Namen der Applikation (in unserm Fall also webapps/abc/).

3. Installieren Sie dann Ihre Applikation mit dem Manager.

• Hierzu tragen Sie in das Feld Kontext-Pfad den entsprechenden Pfad ein, in unserem Beispiel wäre das also /webapps/abc
• Im Eingabefelde für die ‘XML-Konfigurationsdatei URL’ tragen Sie den absoluten Pfadnamen zum Kontextfile ein. Schreiben Sie hier also file:/home/i/h/ihrname.ch/htdocs/webapps/context/webapps#abc.xml
• Das dritte Eingabefeld (WAR oder Verzeichnis URL) bleibt leer.
• Drücken Sie die Installieren-Schaltfläche.

Ihre Applikation wird installiert.

Installieren Sie selber KEINE Standardbibliotheken wie z.B. mysql-connector usw. Diese werden von uns bereits in der richtigen Konfiguration vorinstalliert im common/lib und sind somit automatisch verfügbar. Andernfalls belasten Sie unnötig die Tomcat-Umgebung, was Ihre Applikation verlangsamt oder unbrauchbar macht. Insbesondere nach Systemupdates besteht die Gefahr, dass solche Applikationen mit selbstinstallierten Basis-Libraries nicht mehr einwandfrei funktionieren.

Installation von Applikationen unter Tomcat 6.0

Standardmässig wird bei NetZone Apache/Tomcat so konfiguriert, dass nur Anfragen mit /webapps (also www.ihrname.ch/webapps/) an den Tomcat-Server weitergereicht werden. Die anderen Requests werden weiterhin durch den vorgelagerten Apache Webserver verarbeitet. Sie finden in Ihrem htdocs Verzeichnis ein webapps-Verzeichnis wo Ihre Applikation abgelegt werden sollte.

Wir empfehlen Ihnen folgendes Vorgehen beim Installieren einer neuen Applikation abc:

Laden Sie Ihre Applikation abc per FTP auf den Server ins Verzeichnis /htodcs/webapps/ entweder als war-File oder als bereits entpackte Applikation. Das war-File muss dann folgendermassen benannt werden: webapps#abc.war resp beim Upload der entpackten Version muss das Verzeichnis webapps#abc heissen !! Es muss also jeweils “webapps#” vor den Namen der Applikation gesetzt werden.

Sie können danach einfach die Applikation mit dem Manager deployen. Tragen Sie hierzu einfach den Pfad Ihrer Applikation in das Feld Kontext-Pfad ein, in userem Beispiel also /webapps/abc . Die andern beiden Eingabefelder bleiben leer. Drücken Sie die Deploy-Schaltfläche zum Starten der Installation..

Bemerkung: Falls die Applikation direkt unter www.ihrname.ch/webapps starten soll (als ROOT-Applikation), müssen Sie diese wie beschrieben installieren. Nennen Sie dabei das Verzeichnis webapps oder das war-Files webapps.war und geben Sie bei der Installation im Manager alsKontextpfad /webapps ein.

Entwicklung eigener Applikationen

Die Shared-Tomcat Umgebung ist eine produktive Umgebung. Die Entwicklung von eigenen Applikationen ist auf dieser Umgebung nicht erlaubt! Entwickeln Sie Ihre Programme lokal auf eigenen Servern und testen Sie diese ausgiebig, bevor Sie diese produktiv auf unseren Servern installieren! Fehlerhafte Applikationen können den Tomcatbetrieb massiv beeinträchtigen. Wir behalten uns deshalb vor, fehlerhafte Applikationen ohne Vorwarnung zu deaktivieren. Im Wiederholungsfall kann der Tomcatzugang gesperrt werden.

Neustart von Tomcat

Der Shared-Tomcat kann nur durch den NetZone-Support neu gestartet werden. Für die Installation von Applikationen ist ein Neustart jedoch nicht notwendig. Verwenden Sie zum installieren die Managerapplikation. Falls Sie eine eigene Tomcat-Instanz verwalten, können Sie diese mit NetConfig verwalten resp. neu starten. Die restliche Verwaltung erfolgt ebenfalls mit NetConfig.

E-Mail versand unter Tomcat

Beachten Sie, dass wenn Sie von Ihrer Tomcat-Appliaktion aus Mails versenden möchten, Sie als SMTP-Server nicht mail.netzone.ch eintragen können. Verwenden Sie hier localhost oder die direkte IP 127.0.0.1.

Der SSH-Host lautet: ssh.netzone.ch

Die Zugriffsdaten (Benutzernamen/Passwort) sind dieselben wie für den FTP-Zugriff.

Obwohl mehrere FTP-Accounts eingerichtet werden können, kann nur für den Hauptuser SSH aktiviert werden.