WebPortal Installationsanleitung
Webserver Installation
IIS Installation
Um das TIMEOFFICE-Webportal nutzen zu können, muss der für den Betrieb vorgesehene Server
die "Internet Information Services" bereitstellen.
Falls diese noch nicht aktiviert sind, müssen Sie diese zunächst einrichten. Informationen darüber,
wie Sie den Webserver (IIS) einrichten, finden Sie in den Anleitungen zu Ihrem Betriebssystem.
Damit das Webportal installiert werden kann und fehlerfrei läuft, sind einige Einstellungen des
Webservers notwendig. Der folgenden Grafik können Sie entnehmen, welche Einstellungen evtl.
ergänzt werden müssen.
Anlegen der Verzeichnisstrukturen
Zunächst müssen Sie auf dem Rechner, auf dem der IIS-Server installiert ist, das Verzeichnis für die
Programmdateien des Webportals anlegen.
Bei der Installation des IIS-Servers wurde dort ein Verzeichnis "Inetpub" angelegt. Legen Sie in diesem
Verzeichnis ein Unterverzeichnis an, etwa:
C:\Inetpub\CSGMAWebPortal\
In dieses Verzeichnis werden später die Programmdateien des Webportals kopiert.
Anlegen der Website
Öffnen Sie den Internetinformationsdienste (IIS)-Manager z. B. über
Start > Systemsteuerung > Verwaltung > Internetinformationsdienste (IIS)-Manager.
Öffnen Sie über einen Rechtsklick das Kontextmenü des Elementes "Sites".
Wählen Sie aus dem Kontextmenü "Websites hinzufügen".
Es wird der Dialog zum Erstellen einer Website gestartet.
Tragen Sie in dem Feld "Sitename" den gewünschten Namen der Website ein. Als Standard
wird "CSGMAWebPortal" empfohlen.Wählen Sie im Feld "physikalischer Pfad" das Basisverzeichis der Website aus:
C:\Inetpub\CSGMAWebPortal\
In dieses Basisverzeichnis werden später die Programmdaten des Webportals kopiert.Wählen Sie in der Gruppe "Bindung" im Feld "Typ" den Wert "http", wenn das Webportal ausschließlich
im Intranet betrieben wird. In allen anderen Fällen sollten Sie hier "https" einstellen.Legen Sie fest, wie das Webportal erreicht werden kann. Wählen Sie dazu im Feld "IP-Adresse" die IP-Adresse des Webservers aus.
Verwenden Sie als Port für die Website den Port 80.
Beenden Sie den Dialog durch Betätigung der Schaltfläche "OK".
Einstellungen des Anwendungspools
Öffnen Sie den Anwendungspool und markieren Sie das CSGMAWebPortal.
Prüfen Sie nun die "Grundeinstellungen" und die "Erweiterten Einstellungen", die Sie über das
Kontextmenü aufrufen können.
Grundeinstellungen
Stellen Sie sicher, dass im Anwendungspool ".Net Framework v4.0.30319" hinterlegt ist.
Erweiterte Einstellungen
Hier müssen Sie die Option "32-Bit-Anwendungen aktivieren" auf "True" setzen.
Einstellungen der Website
Markieren Sie jetzt links unter "Sites" das CSGMaWebportal. Öffnen Sie "Erweiterte Einstellungen”.
Prüfen Sie die Einstellung "Aktivierte Protokolle". Hier muss "http" bzw. “https” stehen, je nachdem ob Sie das Webportal nur intern oder auch extern betreiben möchten. In letzterem Falle müssen Sie zusätzlich ein Serverzertifikat hinterlegen (bspw. dasselbe, wie für die API).
Öffnen Sie die ASP-Konfiguration der Site. Hier müssen Sie noch überprüfen, dass VBScript als Skriptsprache eingestellt ist.
Die Konfiguration des Webservers ist damit abgeschlossen.
Installation und Konfiguration des WebPortals
Download der Programmdateien
Die benötigten Dateien stehen als MSI - Paket im Kundenportal zum Download bereit.
Achten Sie darauf, dass die Programmversion mit der bei Ihnen eingesetzten Version von TIMEOFFICE übereinstimmt (bspw. für Dateiname: “Pradtke WebPortal 10.1.0.100.msi” für TIMEOFFICE Version 10.1.0)
Erstinstallation der Webportal-Programmdateien
Die Erstinstallation der Webportal-Programmdateien sollte ausschließlich über das Benutzerkonto
mit administrativen Rechten erfolgen. Starten Sie die Installation mit dem MSI - Paket.
Ändern Sie während des Installationsverlaufes den Zielordner in den richtigen Pfad, den Sie bereits bei der IIS-Einrichtung spezifiziert haben. Standardmäßig ist dies Folgender:
C:\inetpub\CSGMAWebPortal\
Während des weiteren Verlaufes, werden Sie ggf. aufgefordert, die Webseite zu stoppen. Tun Sie das, indem Sie den IIS aufrufen, die Webseite auswählen und anschließend auf “Beenden” klicken.
Nachdem Sie die Webseite beendet haben. können Sie den Installationsprozess fortsetzen. Treffen Sie dafür die Auswahl “Pradtke WebPortal IIS Site ist beendet” und fahren Sie fort.
Führen Sie den Installationsprozess bis zum Ende durch.
Konfiguration des Webportals
Nun ist das Webportal installiert. Für die Anbindung an die TIMEOFFICE-Datenbank müssen Sie
noch die Verbindungsparameter anpassen. Dies erfolgt über das Konfigurationsprogramm "CsgWebConfigurator", das Sie im Ordner “Config” des Programmverzeichnisses finden.
C:\inetpub\CSGMAWebPortal\Config
Der Ordner "Config" enthält den CsgWebConfigurator. Führen Sie die Datei “Pradtke.WebConfigurator_Any.exe” als Administrator aus.
Wenn Sie gefragt werden, ob Sie die web.config erzeugen möchten, bestätigen Sie das mit Ja.
Um über den "CsgWebConfigurator" die Verbindungsparameter ändern zu können, müssen Sie einmal die Schaltfläche "Bearbeiten" betätigen. Anschließend müssen Sie die Konfigurationsparameter gemäß Ihrer Installation einstellen.
Datenbankverbindung
Unter der Gruppe "Datenbankverbindung" finden sich alle einzustellenden Parameter bezüglich der Verbindung zur TIMEOFFICE-Datenbank. Die Verbindungsparameter können falls nötig auch von den Eigenschaften einer bestehenden TIMEOFFICE-Verknüpfung übernommen werden.
Parameter | Beschreibung |
---|---|
DBHost | Hostname oder IP-Adresse des Datenbankservers |
DBLinks | Benutztes Verbindungsprotokoll: SHMEM oder TCPIP (empfohlen) |
DBName | Name der Datenbank (i.d.R. “timeoffice”) |
DBPwd | Passwort für die Datenbankverbindung (fest vorbelegt, muss in Regel nicht geändert werden) |
DBType | Typ der Datenbank |
DBUid | Benutzername für die Datenbankverbindung (fest vorbelegt, muss in Regel nicht geändert werden) |
Sonstiges
Unter der Gruppe "Sonstiges" finden sich sonstige weitere Steuerparameter wie z.B. die Möglichkeit der Verwendung von Single Sign On. Wenn Sie keine spezielle Konfiguration vornehmen wollen, belassen Sie diese Einstellungen bei den Standardeinstellungen.
Parameter | Beschreibung |
---|---|
DebugMode | Schaltet den Debug-Modus ein oder aus. |
DeleteDeadSessions | Zeit in Minuten, nach der inaktive Benutzersessions gelöscht werden. |
MainContentURL | Verweis auf die Startseite des Webportals. |
ServiceIsLocal | Gibt an, ob die Servicelogik lokal oder durch WebServices bereitgestellt wird. |
SingleSignOn | Kennzeichen, ob Single Sign On für die Anmeldung von Benutzern genutzt werden soll. Ist nur erforderlich und sinnvoll, wenn die Single Sign On-Funktionalitäten auch in TIMEOFFICE aktiviert sind. |
Supported Agents | Unterstützte Browser. Die Einstellung sollte nicht geändert werden. |
Über die Schaltfläche "Verbindung testen" können Sie jederzeit testen, ob mit den aktuellen Parametern eine Datenbankverbindung aufgebaut werden kann.
Speichern Sie Ihre Änderungen mit Klick auf die Schaltfläche “Speichern. Alle Änderungen werden nun direkt in die Konfigurationsdatei "web.config" geschrieben, die im Programmverzeichnis des Webportals abgelegt ist.
Standarddokument der Site
Um einen schnellen Zugriff zu ermöglichen, sollten Sie prüfen, ob die Datei "default.aspx" in der Liste der Standarddateien vorhanden ist und an erster Stelle steht. Öffnen Sie noch einmal den IIS-Manager und markieren Sie die Site "CSGMAWebPortal" und öffnen das Feature “Standarddokument”.
Hier müssen Sie den Eintrag "default.aspx" markieren und mit dem blauen "Pfeil nach oben" auf der rechten Seite ganz nach oben schieben. Nachdem Sie die Schaltfläche das erste mal betätigt haben, erhalten Sie folgende Meldung. Bestätigen Sie mit "Ja" und fahren Sie mit dem Verschieben fort, bis "default.aspx an der obersten Stelle steht.
Website starten
Öffnen Sie den IIS-Server (Start > Systemsteuerung > Verwaltung) und starten Sie das Webportal.
Gehen Sie über den Webbrowser ins TIMEOFFICE-Webportal und prüfen Sie, ob Sie sich anmelden können und ob der Zugriff problemlos möglich ist.