Govello Installationsleitfaden und ersrte Schritte

Govello Installationsleitfaden
und erste Schritte
Autor:
Michael Knoblich
Datum: 30.04.2010
Version: 1.0
INHALT
1. Vorbereitungen für die Govello - Installation ........................................................................ 3
1.1.
Prüfen der installierten Java Version...................................................................... 3
1.2.
Installieren von Java 1.5 ........................................................................................ 4
1.3.
Prüfen der Einstellungen für JavaWebStart............................................................ 6
2. Govello Installieren ............................................................................................................ 10
2.1.
Vorraussetzungen für die Installation ....................................................................10
2.2.
Durchführen der Installation ..................................................................................10
2.3.
Eine Verknüpfung zur Anwendung erstellen..........................................................19
3. Erste Schritte ..................................................................................................................... 21
3.1.
Aufruf des Govello-Clients ....................................................................................21
3.2.
Anzeigen der Benutzer-ID.....................................................................................22
3.3.
Anlegen weiterer Postfächer .................................................................................23
4. Problemlösung................................................................................................................... 24
4.1.
Beim Start des Govello-Clients erscheint die Meldung „Anwendung konnte nicht
gestartet werden“..............................................................................................................24
1.
Vorbereitungen für die Govello - Installation
1.1. Prüfen der installierten Java Version
Für die Installation als auch für die Ausführung der Govello-Software wird Java ab Version
1.5 (auch bezeichnet als Version 5.0) benötigt.
Um zu Prüfen, ob auf Ihrem Rechner die benötigte Java – Version installiert ist, gehen Sie
wie folgt vor.
1. Öffnen Sie die Windows Systemsteuerung durch Klick auf Start -> Einstellungen ->
Systemsteuerung.
2. Öffnen Sie den Punkt Software mit einem Doppelklick auf das folgende Symbol.
Das Laden der Software-Liste kann einige Augenblicke Dauern, abhängig davon wie
viel unterschiedliche Programme auf Ihrem Rechner installiert sind, die Liste bleibt
solange leer.
Wenn die Liste der Programme geladen wurde, suchen Sie einen Eintrag mit einem
der folgenden Namen:
„J2SE Runtime Environment 5.0 …“ oder
„J2SE Development Kit 5.0 …“
Sollten Sie über eine höhere Version als hier angegeben verfügen, brauchen Sie Java nicht
neu zu installieren. In diesem Fall fahren Sie mit dem Kapitel 1.3 Prüfen der Einstellungen für
JavaWebStart in dieser Beschreibung fort.
Sollten Sie keinen Eintrag in der Liste finden, oder über eine niedrigere Versionsnummer als
5.0 verfügen, befolgen Sie die nächsten Schritte um Java in zu installieren.
1.2. Installieren von Java 1.5
Für die Ausführung von Govello ist die Version 1.5 ausreichend. Sie können diese Version
direkt von unserem Server herunterladen. Beachten Sie dafür folgende Schritte:
1. Verwenden Sie den folgenden Link:
http://www.mvnet.de/fms/downloads/jre_1_5_windows.exe
Kopieren Sie den Link in die Adresszeile ihres Browsers und bestätigen dies mit der
Enter-Taste.
Sollte der oben angegebene Link nicht erreichbar sein, können Sie die Software auch von
der Herstellerseite unter dem folgenden Link herunterladen:
http://java.sun.com/javase/downloads/index.jsp
Der Download startet automatisch. Bei Verwendung des InternetExplorers erscheint
ein Dialog, in dem Sie aufgefordert werden, den Speicherort der Datei festzulegen.
Wählen Sie hier ein Verzeichnis auf Ihrem Rechner.
2. Ist der Dateidownload abgeschlossen, wechseln Sie in das Verzeichnis, das Sie vor
dem Download angegeben habe. Haben Sie kein Zielverzeichnis auswählen können,
wie dies z.B. bei Firefox der Fall sein kann, so wechseln Sie in das Verzeichnis, das
als Standard Downloadverzeichnis in den Einstellungen des Browsers angegeben ist.
3. Führen Sie die Datei mit einem Doppelklick aus. Der Installationsassistent startet
daraufhin automatisch. Folgen Sie den Anweisungen auf dem Bildschirm. Nach der
Installation müssen Sie Ihrem Rechner ggf. neu Starten, um die Installation
abzuschließen.
Für die Installation sind erweiterte Rechte im System erforderlich. Aus diesem
Grund kann es erforderlich sind, dass Sie als Administrator an Ihrem System
angemeldet sein müssen. Sollten Sie die Installation nicht erfolgreich beenden
können, weil Sie die erforderlichen Rechte nicht besitzen, so wenden Sie sich ggf.
an entsprechendes IT Personal in Ihrem Haus.
1.3. Prüfen der Einstellungen für JavaWebStart
Für die Installation der Govello-Software haben Sie einen Link zu einer Internetseite per Mail
erhalten. Die Installation wird durch den Aufruf dieses Links automatisch von Java
durchgeführt. Um zu prüfen, ob die Einstellungen für diesen Vorgang auf Ihrem System
gesetzt sind, führen Sie folgende Schritte durch.
Öffnen Sie die Windows Systemsteuerung durch Klick auf Start -> Einstellungen ->
Systemsteuerung.
1. Öffnen Sie den Punkt „Ordneroptionen“ durch einen Doppelklick auf das folgende
Symbol:
2. Es öffnet sich ein neuer Dialog. Wählen Sie die Registerkarte „Dateitypen“.
3. Suchen Sie in der Liste „Registrierte Dateitypen“ den Eintrag „JNLP“ in der Spalte
„Erweiterungen“.
Ist der Eintrag nicht vorhanden, führen Sie die Installation von Java erneut aus. Lesen Sie
dazu das Kapitel Installieren von Java 1.5 in diesem Dokument.
Ist der Eintrag vorhanden, prüfen Sie die bestehende Dateiverknüpfung. Gehen Sie dazu wie
folgt vor.
1. Klicken Sie mit der linken Maustaste auf die Schaltfläche „Erweitert“. Es öffnet sich
ein neuer Dialog mit dem Titel „Dateityp bearbeiten“. Wählen Sie in diesem Dialog die
Schaltfläche „Bearbeiten“ um die Details der Verknüpfung anzuzeigen.
Es öffnet sich der Dialog „Vorgang Bearbeiten für Typ: JNLP File“. Als Verknüpfte
Anwendung muss das Programm „javaws.exe“ im Eingabefeld „Anwendung für
diesen Vorgang“, angegeben sein. Zudem muss die Datei „javaws.exe“ mindestens
zu der Java Version 1.5 gehören. Sie erkennen dies am Verzeichnisnamen (z.B.:
„…jre1.5…“ oder „…jre1.6…“), der dem Programmnamen vorangestellt ist.
Ist dies der Fall, sind die Einstellungen auf Ihrem Rechner korrekt, und Sie können mit der
Installation der Govello Software beginnen. Schließen Sie alle zuvor geöffneten
Dialogfenster über die Schaltfläche „Abbrechen“.
Für die Installation von Govello lesen Sie das Kapitel Govello Installieren in diesem
Dokument.
Sind die Einstellungen nicht wie hier beschrieben, haben Sie zwei Möglichkeiten, diese zu
setzen.
Möglichkeit 1
Unerfahrene Nutzer sollten Java erneut installieren. Bei der Installation werden
die Einstellungen im System neu gesetzt. Zur Installation beachten Sie das
Kapitel Installieren von Java 1.5 in diesem Dokument.
Möglichkeit 2
Erfahrene Nutzer können die Einstellungen im Dialog „Vorgang bearbeiten für
Typ: JNLP File“ manuell setzen.
1. Klicken Sie dazu auf die Schaltfläche „Durchsuchen“, es öffnet sich ein Dialog
mit der Verzeichnisstruktur Ihres Systems
2. Suchen Sie das Verzeichnis, in dem Java (mind. Version 1.5 ) installiert
wurde. Die verschiedenen Java-Versionen werden typischerweise unter dem
Verzeichnis „C:\Programme\Java“ abgelegt.
3. Wechseln Sie in das Unterverzeichnis „\bin“ und wählen die ausführbare Datei
„javaws.exe“ aus.
4. Mit einem Klick auf die Schaltfläche „Öffnen“ wird die Dateiauswahl in den
vorherigen Dialog übernommen.
5. Sie Speichern die Einstellungen, in dem Sie alle Dialog mit einem Klick auf
„Übernehmen“ oder „Ok“ bestätigen.
2.
Govello Installieren
2.1. Vorraussetzungen für die Installation
Bei der Installation handelt es sich um eine auf Java basierende online Installation. Der
Installationsprozess bezieht seine Daten dabei direkt von einem Server aus dem Internet.
Folgende Vorraussetzungen müssen für die Installation erfüllt sein:
-
Verbindung zum Internet besteht
-
Java ab Version 1.5 (5.0)
Folgende Daten werden für die Ausführung und Konfiguration benötigt:
-
Web-Link zu Anwendung: http://bundesland.govello.de/produktiv/mvp/backend.jnlp
-
Kennwort für die Verschlüsselungs- und Signaturdateien
2.2. Durchführen der Installation
Für die Installation der Govello Software haben Sie einen Weblink von uns erhalten. Dieser
ist u.a. Bestandteil des Antwortschreibens welches Sie auf Ihren Antrag zur Govello
Zugangseröffnung von uns erhalten haben.
Für die Installation gehen Sie wie folgt vor:
1. Richten Sie zunächst ein Verzeichnis auf Ihrem System ein. In diesem werden
später die Nachrichten, welche Sie über die Govello-Software versenden oder
empfangen, abgelegt. Dieses Verzeichnis sollte sich in der obersten
Verzeichnisebene befinden. Geben Sie dem Verzeichnis einen kurzen aber
aussagekräftigen Namen, zum Beispiel „Govello“.
2. Kopieren Sie die ZIP-Datei, welche Sie in unserem Antwortschreiben per Mail
erhalten haben, in das soeben eingerichtete Verzeichnis
3. Extrahieren Sie die ZIP-Datei in das gleiche Verzeichnis. Klicken Sie dazu mit der
rechten Maustaste auf den Dateinamen und wählen „Alle extrahieren …“. Es
öffnet sich ein Windows Assistent.
4. Folgen Sie den Anweisungen. Sie können die voreingestellten Werte belassen.
Im Letzten Dialog „Extrahiervorgang abgeschlossen“ können Sie den Haken bei
„Extrahierte Dateien anzeigen“ entfernen.
In Ihrem erstellten Verzeichnis befindet sich nun ein neues Unterverzeichnis mit vier
Dateien. Diese werden für die spätere Einrichtung der Govello-Software benötigt.
5. Öffnen Sie den Weblink aus dem Antwortschreiben. Klicken Sie dazu auf den Link
oder kopieren Sie ihn in die Adresszeile Ihres Browsers.
Bei Verwendung des Internet Explorers:
Nach einigen Augenblicken sollte Java die Installation starten. Es erscheint dann
folgende Grafik gefolgt vom Installationsdialog.
Sollten Sie anstatt der oben gezeigten Grafik bzw. des Dialoges eine
Aufforderung erhalten, die angeforderte Datei zu speichern oder auszuführen, ist
Java bzw. JavaWebStart auf Ihrem System nicht ordnungsgemäß installiert.
Lesen Sie in diesem Fall die Kapitel: Prüfen der Einstellungen für JavaWebStart
und / oder Installieren von Java 1.5 in diesem Dokument.
Bei Verwendung von FireFox:
FireFox erkennt die Datei, und fordert Sie in einem Dialog auf, diese mit dem
dazugehörigen Programm (Java Web Start Launcher) zu öffnen.
Ist dies der Fall, belassen Sie die Voreinstellung und Klicken mit der Maustaste
auf die OK Taste. Der Installationsprozess beginnt automatisch.
Ist dies nicht der Fall, wird also der „Java Web Start Launcher“ nicht für „Öffnen
mit“ angeboten, so ist Java nicht korrekt auf Ihrem System installiert. Lesen Sie in
diesem Fall die Kapitel: Prüfen der Einstellungen für JavaWebStart und / oder
Installieren von Java 1.5 in diesem Dokument.
6. Der Installationsprozess läuft automatisch. Die Anwendung wird im Hintergrund
aus dem Internet geladen und auf Ihrem System eingerichtet.
Im Laufe dieses Prozesses werden sie ggf. darauf hingewiesen, dass die Signatur
der Anwendung verifiziert bzw. nicht verifiziert werden konnte. In beiden Fällen
setzen Sie die Ausführung durch Klick auf die Schaltfläche „Ausführen“ fort.
7. Am Ende des Installationsprozesses werden Sie aufgefordert, die
Lizenzbedingungen anzunehmen. Setzen Sie die Auswahl auf „Annehmen“.
Wenn Sie den Lizenzbedingungen nicht zustimmen, kann die Anwendung nicht
ausgeführt werden, die „OK“ Schaltfläche bleibt solange deaktiviert.
Im zweiten Teil des Fensters werden Sie aufgefordert ein Verzeichnis anzugeben,
in dem Govello die Nachrichten ablegen soll. Hierbei können Sie das Verzeichnis,
welches Sie am Anfang angelegt haben, oder ein beliebig anderes, verwenden.
Bitte beachten Sie, dass Sie dieses Verzeichnis im Nachhinein NICHT mehr
ändern können.
8. Um das Verzeichnis auszuwählen, klicken Sie mit der Maus auf die Schaltfläche
„Auswählen“. Es öffnet sich der Standard Datei-Dialog von Windows. Wählen Sie
das gewünschte Verzeichnis, und bestätigen Sie Ihre Auswahl mit der
Schaltfläche „Auswählen“.
Das ausgewählte Verzeichnis wird nun im unteren Teil des Installationsdialoges
angezeigt.
Haben Sie alle Einstellungen getroffen, bestätigen Sie diese mit einem Klick auf die
Schaltflache „OK“.
Sollte der Pfad des ausgewählten Verzeichnisses zu lang sein, erscheint eine
Warnung.
Wählen Sie in diesem Fall ein Verzeichnis mit kürzerem Namen oder ein Verzeichnis,
welches nicht ein Unterverzeichnis eines anderen Verzeichnisses ist.
9. Unter Umständen müssen zusätzliche Softwareerweiterungen für Java
nachinstalliert werden. Es erscheint dann ein Dialog ähnlich dem folgenden:
Bestätigen Sie in diesem Fall den Dialog mit der Schaltfläche „Ja“.
10. Ist die Installation der Anwendung und der zusätzlich geladenen Java
Erweiterungen abgeschlossen, wird die Anwendung automatisch gestartet.
11. Beim ersten Ausführen der Anwendung, wird der Assistent zum Einrichten eines
Postfaches gestartet. Es erscheint die folgende Maske.
Alle Pflichtfelder sind rot markiert. Sobald ein gültiger Wert eingegeben wurde, entfällt
die rote Markierung. Sie können diese Angaben zu einem späteren Zeitpunkt ändern.
Ihre Eingaben bestätigen Sie mit einem Klick auf die Schaltfläche „OK“. Sie gelangen
daraufhin automatisch zur Registerkarte „Grundeinstellungen“.
12. Im letzten Schritt zum Einrichten eines Postfaches, müssen Sie einen Name und
ein Zertifikat angeben.
Der „Postfachname“ kann beliebig gewählt werden. Er stellt für Sie eine Möglichkeit
dar, bei mehreren Postfächern auf dem System, den Überblick zu behalten.
13. Zum Festlegen des Zertifikates wählen Sie die Schaltfläche „Auswählen“, auf der
linken Seite.
Es öffnet sich der Standard Windows Dateidialog. Suchen Sie das Verzeichnis, in
dem Sie zuvor die Zip-Datei aus der Mail extrahiert haben (Seite 10 in diesem
Dokument). Wechseln Sie in das Unterverzeichnis „…_GRP“ welches beim
Extrahieren automatisch angelegt wurde.
Wählen Sie die Datei, die mit „…cry.pfx“ endet. Es ist die erste Datei, die im Dialog
angezeigt wird.
Das x steht in der Darstellung für eine beliebige Zeichenkette. Der vordere Teil des
Dateinamens kann daher von Ihrem Dateinamen abweichen.
14. Haben Sie die korrekte Datei ausgewählt, erscheint ein weiterer Dialog. In diesem
werden Sie aufgefordert, die zum Zertifikat gehörende PIN einzugeben. Diese
haben Sie ebenfalls mit unserer Mail erhalten.
Die eingegebene Pin bestätigen Sie mit einem Klick auf die Schaltfläche „OK“.
15. Nach der Bestätigung Ihrer Eingaben, werden Ihre Daten online verifiziert. Ist das
Zertifikat und der PIN korrekt, erscheint die Anwendung wie auf der folgenden
Abbildung.
War der Vorgang nicht erfolgreich, versuchen Sie das Postfach erneut
einzurichten. Klicken Sie dazu im Menü auf den Eintrag „Postfach“ und darunter
auf „Neu“. Der Assistent startet erneut. Befolgen Sie dazu erneut die Schritte ab
Seite 16 in diesem Dokument.
Mit manchen Versionen von Mozilla Firefox kann die Verifizierung auch mit
einem korrekten PIN nicht durchgeführt werden. Bitte führen Sie in diesem
Fall die Installation / Start der Anwendung aus dem Internet Explorer durch.
War der Vorgang auch bei mehrmaligem Versuch nicht erfolgreich, so wenden
Sie sich bitte an die DVZ – MV GmbH.
2.3. Eine Verknüpfung zur Anwendung erstellen
Bei der Installation wird nicht wie sonst üblich, bei klassischen Windows Anwendungen, eine
Verknüpfung auf den Desktop erstellt. Dies können Sie jedoch nachträglich per Hand tun.
Gehen Sie dazu wie folgt vor.
1. Minimieren Sie alle aktiven Anwendungen, und klicken mit der rechten Maustaste in
einen freien Bereich auf dem Desktop. Das Kontextmenü wird öffnet sich.
2. Wählen Sie im Kontextmenü den Eintrag „Neu“ und darunter den Eintrag
„Verknüpfung“.
3. Es öffnet sich ein Windows-Assistent. Kopieren Sie die Web-Adresse
„http://bundesland.govello.de/produktiv/mvp/backend.jnlp“, über die Sie die
Anwendung aufrufen, in das Eingabefeld.
Klicken Sie mit der Maus auf die Schaltfläche „Weiter >“.
4.
Im letzten Schritt können Sie einen Namen vergeben. Verwenden Sie zum Beispiel
„Govello-Client“. Sie schließen den Vorgang mit einem Klick auf die Schaltfläche
„Fertig stellen“ ab.
5. Es erscheint nun eine neue Verknüpfung auf dem Desktop. Darunter sehen Sie den
Text, welchen Sie für die Verknüpfung vergeben haben.
Durch einen Doppelklick wird die Anwendung nun automatisch gestartet. Beachten
Sie, dass der Standardbrowser dazu gestartet, und im Hintergrund geöffnet bleibt.
Sie können Ihn schließen, sobald die Govello-Software vollständig gestartet ist.
3.
Erste Schritte
3.1. Aufruf des Govello-Clients
Der Govello-Client wird über einen Weblink aufgerufen. Sie müssen diesen Weblink
mindestens einmal ausführen, um die Software auf Ihrem Rechner zu installieren. Bei jedem
weiteren Aufruf des Links wird die Benutzeroberfläche angezeigt.
Der Link ist u.a. Bestandteil des Antwortschreibens, welches Sie auf Ihren Antrag zur
Govello Zugangseröffnung von uns erhalten haben.
Haben Sie eine Verknüpfung angelegt, so wie unter Kapitel 2.3
Eine Verknüpfung zur Anwendung erstellen beschrieben, können Sie die Anwendung auch
über einen Doppelklick auf diese Verknüpfung starten.
Nach dem Start wird das Kennwort für das Postfach abgefragt. Dieses haben Sie ebenfalls
mit unserem Antwortschreiben erhalten. Nur Sie kennen dieses Kennwort. Bitte bewahren
Sie das Kennwort an geeigneter Stelle auf.
3.2.
Anzeigen der Benutzer-ID
Jedes Govello-Postfach verfügt über eine einmalige Identifizierungsnummer.
Sie wird u.a. verwendet, um Sie als Empfänger für eingereichte Anträge aus dem Formular
Management System zu identifizieren. Diese Einstellungen werden in einem separaten
Programm vorgenommen.
Die ID eines Postfaches können Sie sich im Govello-Client unter Beachtung der folgenden
Schritte anzeigen lassen.
1. Öffnen Sie den Govello-Client.
2. Wählen Sie „Server“ in der Menüleiste, und dort den Eintrag „Verzeichnisdienst“ aus.
3. In dem sich nun öffnenden Dialog „Einstellungen des Verzeichnisdienstes“ finden Sie
die „Benutzer-ID“ an erster Stelle.
3.3. Anlegen weiterer Postfächer
Mit dem Govello-Client sind Sie in der Lage, mehrere Govello-Postfächer zu verwalten. Um
ein Govello-Postfach einzurichten gehen Sie wie folgt vor.
1. Wählen Sie in der Menüleiste „Postfach“ und im darunter aufklappenden Menü den
Eintrag „Neu…“.
2. Es öffnet sich ein Formular, in dem Sie Ihre Adressdaten eingeben sowie die
Zertifikatsdatei auswählen können.
Das weitere Vorgehen entspricht dem Kapitel Durchführen der Installation ab Schritt
11.
4.
Problemlösung
4.1. Beim Start des Govello-Clients erscheint die Meldung „Anwendung
konnte nicht gestartet werden“.
Es wird eine Fehlermeldung, ähnlich der folgenden Abbildung angezeigt.
Folgende Einstellungen sollten von einem erfahrenen PC-Nutzer mit administrativen Rechten
vorgenommen werden.
Um das Problem zu lösen, gehen Sie wie folgt vor.
1. Erstellen Sie eine Kopie der Konfigurationsdatei. Kopieren Sie die Datei
C:\Dokumente und Einstellungen\<Nutzername>\govello20.properties
in ein anderes Verzeichnis Ihrer Wahl. Zum Beispiel: C:\temp.
2. Löschen Sie den Java-Cache. Gehen Sie dazu wie folgt vor:
a. Öffnen Sie die Eingabeaufforderung. Zum Beispiel über „Start“ ->
„Ausführen“. Geben Sie „cmd“ in das Eingabefeld. Bestätigen Sie die
Eingabe mit der Schaltfläche „OK“.
b. Geben Sie folgenden Befehl an der Eingabeaufforderung ein:
javaws –viewer
Bestätigen Sie den Befehl mit einem Druck auf die „Enter“ Taste.
c. Es öffnet sich die Windows Anwendungen „Java Cache View“ und das
„Java Control Panel“.
Wählen Sie die den Eintrag „Govello-MV Backend“ im „Java Cache
View“ mit der rechten Maustaste aus. Wählen Sie in dem sich öffnen
Menü den Eintrag „Löschen“. Der Eintrag sollte daraufhin aus der Liste
verschwinden.
d. Schließen Sie den „Java Cache Viewer „.
e. Klicken Sie im „Java Control Panel“ auf die Schaltfläche
„Einstellungen“.
f. Klicken Sie im nächsten Dialog auf die Schaltfläche „Dateien löschen“.
g. Wählen Sie im danach angezeigten Dialog „Anwendungen und Applets“
und „Verfolgungs- und Protokolldateien“ zum Löschen aus.
h. Schließen Sie nach dem Löschvorgang alle geöffneten Fenster.
3. Starten Sie den Govello-Client erneut. Sie Fehlermeldung sollte nun nicht mehr
angezeigt werden.
4. Sollten Konfigurationen verloren gegangen sein, können Sie diese mit dem
zurück kopieren der zuvor gesicherten Konfigurationsdatei wieder herstellen.
Kopieren Sie die Datei dazu in das ursprüngliche Verzeichnis.