Govello Installationsleitfaden und erste Schritte. Autor: Michael Knoblich Datum: Version: 1.0

Transkript

1 Govello Installationsleitfaden und erste Schritte Autor: Michael Knoblich Datum: Version: 1.0

2 INHALT 1. Vorbereitungen für die Govello - Installation Prüfen der installierten Java Version Installieren von Java Prüfen der Einstellungen für JavaWebStart Govello Installieren Vorraussetzungen für die Installation Durchführen der Installation Eine Verknüpfung zur Anwendung erstellen Erste Schritte Aufruf des Govello-Clients Anzeigen der Benutzer-ID Anlegen weiterer Postfächer Problemlösung Beim Start des Govello-Clients erscheint die Meldung Anwendung konnte nicht gestartet werden...24

3 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

4 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 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: 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: 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.

5 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.

6 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 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.

7 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.

8 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.

9 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.

10 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: - 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.

11 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.

12 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.

13 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,

14 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.

15 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.

16 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.

17 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.

18 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.

19 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 über die Sie die Anwendung aufrufen, in das Eingabefeld. Klicken Sie mit der Maus auf die Schaltfläche Weiter >.

20 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.

21 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

22 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 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.

23 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.

24 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.

25 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.

26 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.