Installationsanleitung fuer das CheckCom ccWAP-Gateway unter 32-Bit Windows


Das ZIP-Archiv "gwprowin.zip" enthaelt folgende Dateien und Verzeichnisse in einem Unterverzeichnis namens "wapgwsrv":

- wapgwsrv.exe    Hauptprogramm des ccWAP-Gateways
- gethost.exe    Hilfsprogramm zum Aufloesen von DNS-Adressen
- autorun.exe    Programm zum Starten des Gateways
- wapgwsrv.cfg    Konfigurationsdatei, beinhaltet Einstellungen des Gateways
- wml-docs/    Verzeichnis mit WML-Dokumenten, dies ist die "Homepage" des Servers, erreichbar unter der URL "http://local/"
- log/    Verzeichnis fuer Log-Dateien
- cgi-bin/    Verzeichnis fuer CGI-Programme
- install.txt    Installationsanleitung in Deutsch
- ccwap.wuc    WTLS-Server-Zertifikat
- ccwap.key    Verschluesselter privater RSA-Schluessel, passend zum Server-Zertifikat


Installation

1. In einem Verzeichnis die Datei "gwprowin.zip" entpacken, es wird
hierbei das Unterverzeichnis "wapgwsrv" erzeugt.

2. Die Lizenz-Datei "wapgwsrv.lic" muss gesondert beschafft und in das erzeugte Verzeichnis kopiert werden, sofern keine im ZIP-Archiv enthalten war ( www.checkcom.de )


Konfiguration

Die Konfigurationseinstellungen des ccWAP-Gateways sind in der Datei
"wapgwsrv.cfg" gespeichert und koennen z.B. mit "notepad" bearbeitet werden.
Zeilen, die mit "#" beginnen oder kein "=" enthalten oder leer sind,
werden ignoriert. Jede Zeile hat die Form "Name=Wert", wobei "Name" der
Name eines Parameters und "Wert" seinen Wert darstellt. Die Angabe
"~dat/" repraesentiert das Installationsverzeichnis des Gateways.

host=localhost:9200

DNS-Name des Serverrechners oder dessen IP-Adresse. Die Port-Angabe
ist der Basis-Port. Es werden insgesamt vier UDP-Ports (BasisPort+0,
BasisPort+1, BasisPort+2 und BasisPort+3) belegt.
Default: host=localhost:9200

bindhost=0.0.0.0

Ermoeglicht die Sockets, an dem das Gateway auf eingehende
Pakete wartet, an eine bestimmte IP-Adresse zu binden,
wobei die Angabe "*" oder "0.0.0.0" fuer alle Adressen steht.
Wenn "bindhost=" leer ist oder nicht angegeben wurde, wird
"0.0.0.0" benutzt, d.h. die Sockets werden an alle IP-Adressen
gebunden.

proxy=hostname:port

Falls das ccWAP-Gateway einen Proxy-Server benutzen soll, um
WML-Dokumente und Graphiken von anderen Servern zu holen, dann
kann dieser hier angegeben werden. "hostname" ist entweder der
DNS-Name des Proxys oder dessen IP-Adresse und "port" ist seine
Portnummer.

wmldocs=~dat/wml-docs/

Pfad des Verzeichnisses mit WML-Dokumenten und Graphiken, die
die "Homepage" des Gateways bilden. Diese "Site" ist unter der
URL "http://local/" ansprechbar. Wenn die Angabe "wmldocs=" nicht
vorhanden oder leer ist, ist die "WML-Homepage" deaktiviert.

cgidir=~dat/cgi-bin/

Legt ein Verzeichnis fest, in dem sich CGI-Programme befinden.
Dieses Verzeichnis erscheint unter der URL "http://local/cgi-bin/"
im Gateway. Eine fehlende oder leere Angabe unterbindet das Feature.

logdir=log/

Definiert das Verzeichnis, im dem die Log-Dateien angelegt werden
sollen. Sie haben den Namen "access_NNNN.log", wobei NNNN fuer
die Nummer des Ports steht, auf dem eingehende Zugriffe auf den
Server im erweiterten Common-Logfile-Format (mit "Referer" und
"User-Agent") aufgezeichnet werden. Fehlt die Angabe "logdir="
oder ist sie leer, so werden keine Logdaten erzeugt.

logopts=dns

Die Option "logopts=dns" aktiviert die Aufloesung der
Client-IP-Adressen in DNS-Namen. Dieser Vorgang kann viel Zeit
in Anspruch nehmen und setzt einen (guten) Name-Server voraus.
Eine fehlende oder leere Angabe deaktiviert das Feature, d.h.
es werden nur die IP-Adressen der Clients aufgezeichnet.

wtlscert=ccwap.wuc

Definiert eine Datei mit einem WTLS-Server-Zertifikat, welches
das ccWAP-Gateway verwenden soll, um sich gegenueber WAP-Clients
zu authentisieren. Das zugehoerige Root-Zertifikat (checkcom.wcc)
ist im Verzeichnis "wml-docs/" enthalten und kann in Mobilgeraete
geladen werden, die dies unterstuetzen. Erst beide Zertifikate
zusammen ermoeglichen eine Server-Authentisierung nach WTLS Class 2.

wtlskey=ccwap.key

Definiert eine Datei, die einen verschluesselten privaten
RSA-Schluessel enthaelt, der zum Server-Zertifikat gehoert.


Starten und Stoppen des Gateways

Das Programm "autorun.exe" dient zum Starten des ccWAP-Gateways und ist
aequivalent zu

\PATH\TO\SERVER\wapgwsrv.exe @wapgwsrv.cfg

Das Gateway kann durch "Beenden" im Taskmanager gestoppt werden.

Es ist (natuerlich) auch moeglich, das Gateway "von Hand" zu starten. Der
allgemeine Aufruf ist:

\PATH\TO\SERVER\wapgwsrv.exe { Parameter | @filename }

\PATH\TO\SERVER ist durch den kompletten Pfad des Verzeichnisses zu ersetzen,
in dem das ccWAP-Gateway installiert wurde. Die Namen von Logfiles und
Konfigurationsdateien werden relativ zu diesem Verzeichnis ausgewertet, wenn
deren Dateiname nicht "absolut" ist. Bei der Angabe von Dateinamen ist zu
beachten, dass alle "\" als "/" angegeben werden muessen (Ausnahme wegen
Windows: \PATH\TO\SERVER)!

Die Aufrufparameter von "wapgwsrv.exe" sind:

{Parameter} Alle Parameter sind Konfigurationseinstellungen
(siehe Kapitel "Konfiguration"). Bei der Angabe auf der
Befehlszeile ist zu beachten, dass die Parameter vor der
Auswertung durch Windows geschuetzt werden muessen. Am
besten ist es, jeden Parameter in Anfuehrungsstriche (") zu
setzen.
@filename Spezieller Operator, der es erlaubt, Parameterangaben aus
der Datei "filename" zu lesen.

Parameterangaben auf der Befehlszeile und aus Dateien koennen beliebig
gemischt werden, der zuletzt gesetzte Wert eines Parameters gilt!


-----------------------------------------------------------------------------
CheckCom ccWAP-Gateway/Server
Copyright (C) 2001 CheckCom Inc.

wapgwsrv@checkcom.de
All rights reserved
install.txt

05.09.2001

www.CheckCom.de

-----------------------------------------------------------------------------