Installation des Clients

HELIUM 5 Client installieren

Laden Sie den Client über folgende Seite herunter:

http://HELIUMV_SERVER:8080/helium-install/

Ersetzen Sie in der URL HELIUMV_SERVER durch den vollständigen Namen Ihres HELIUM 5 Servers.

Windows

Empfohlene einfache Installation

1. Wählen Sie den Windows-Download aus.

2. Bestätigen Sie den Download mit Speichern.

3. Starten Sie nach Abschluss des Downloads die heruntergeladene Datei heliumv-client.exe.

4. Bestätigen Sie bei Bedarf mit Ausführen.

5. Folgen Sie der Menüführung.

Wenn die folgende Meldung erscheint, wählen Sie Anwendungen automatisch schließen.

Wenn die nachfolgende Meldung erscheint, starten Sie Ihren Rechner neu. Beim Neustart werden eventuell hängende Prozesse beendet.

Am Ende der Installation werden Sie aufgefordert, den Servernamen Ihres HELIUM 5 Servers einzugeben. Tragen Sie den bekannt gegebenen Servernamen ein.

Prüfen Sie anschließend die Verbindung mit einem Klick auf Verbindung prüfen. Wenn die Verbindung erfolgreich ist, erscheint ein grüner Haken. Andernfalls besteht keine Verbindung zum eingetragenen Server.

Sobald der grüne Haken angezeigt wird, klicken Sie auf Speichern. Damit ist die Installation abgeschlossen und Ihr HELIUM 5 Client kann gestartet werden.

Für den erneuten Start Ihres HELIUM 5 Clients wurde auf dem Desktop ein entsprechendes Symbol abgelegt.

Installation für erfahrene Anwender

Wenn Sie einen zweiten Client, zum Beispiel für ein Testsystem, installieren möchten, verwenden Sie die Installation für erfahrene Anwender.

1. Installieren Sie zuerst die benötigte Java Runtime von Zulu.

2. Starten Sie anschließend die Installation des Clients.

Linux

1. Wählen Sie den Linux-Download aus.

2. Bestätigen Sie den Download mit Speichern.

3. Starten Sie nach Abschluss des Downloads die heruntergeladene Datei.

4. Bestätigen Sie bei Bedarf mit Ausführen.

5. Folgen Sie der Menüführung.

Anschließend erscheint der Anmeldedialog für Ihren HELIUM 5 Server (Screenshots siehe oben). Tragen Sie die Adresse Ihres HELIUMV_SERVER ein und klicken Sie auf Verbindung. Daneben muss ein Symbol mit einem grünen Haken erscheinen.

Speichern Sie die Einstellungen. Danach wird der eigentliche HELIUM 5 Client gestartet. Melden Sie sich mit Ihrem HELIUM 5 Benutzer an.

Empfehlung: Kunststoff-Look

Wir empfehlen, Linux-Clients im Kunststoff-Look zu starten. Passen Sie dafür die Startdatei lpclientpc.sh an.

#\!/bin/sh
cd /home/ubuntu/helium_v
java -Xms128m -Xmx256m -XX:PermSize=64m -XX:MaxPermSize=256m -Djava.naming.factory.initial=org.jnp.interfaces.NamingContextFactory -Djava.naming.provider.url=jnp://localhost:2099 -Dloc=de_AT -jar lpclientpc.jar --laf-Kunststoff $*

macOS

1. Wählen Sie den Download für macOS aus und laden Sie die Datei herunter.

2. Öffnen Sie Ihr Download-Verzeichnis.

3. Entpacken Sie die Datei.

4. Ziehen Sie die entpackte HELIUM 5 Client-Datei auf Ihren Desktop bzw. Schreibtisch.

Es erscheint eine Warnung. Klicken Sie auf Öffnen. Je nach macOS-Version kann es erforderlich sein, den HELIUM 5 Client beim ersten Start direkt im Finder per Doppelklick zu öffnen und das Öffnen der Datei im folgenden Dialog zu bestätigen.

Anschließend erscheint der Anmeldedialog für Ihren HELIUM 5 Server (Screenshots siehe oben). Tragen Sie die Adresse Ihres HELIUMV_SERVER ein und klicken Sie auf Verbindung. Daneben muss ein Symbol mit einem grünen Haken erscheinen.

Speichern Sie die Einstellungen. Danach wird der eigentliche HELIUM 5 Client gestartet. Melden Sie sich mit Ihrem HELIUM 5 Benutzer an.

Eventuell sehen Sie die folgende Fehlermeldung:

Wenn diese Fehlermeldung erscheint, wurde die Installation ohne die oben beschriebene Freigabe durchgeführt. Starten Sie die Installation erneut mit gedrückter Ctrl-Taste.

Verwendung von Java

Für HELIUM 5 ist eine Java Runtime erforderlich. Wenn Sie auf Ihrem Client unterschiedliche Java-Versionen verwenden müssen, muss die Batch-Datei, die den Client startet (C:\Programme\helium_v\lpclientpc.bat), um die absolute Pfadangabe der richtigen Java Runtime (JRE) erweitert werden.

Beispiel:

start C:\Programme\Java\jre1.6.0_05\bin\javaw.exe -Xms128m

Fehlerbehebung

Server nicht erreichbar

Wenn bei der Installation versehentlich ein falscher Servername oder eine falsche IP-Adresse eingegeben wurde, ändern Sie diese direkt in der Definitionsdatei.

Sie finden die Datei im Benutzerverzeichnis im Unterverzeichnis .heliumv unter dem Namen parameter.properties. Bearbeiten Sie diese Datei mit einem Editor oder löschen Sie sie. Starten Sie anschließend Ihren HELIUM 5 Client erneut. Danach erscheint die Abfrage nach der Serververbindung.

Unter Windows finden Sie die Datei in der Regel unter:

C:\Users\Benutzername\.heliumv\parameter.properties

Updateinstallation startet immer wieder von vorn

Beim Start des Clients wird geprüft, ob die Client-Version mit der Serverversion übereinstimmt. Ist dies nicht der Fall, erscheint die Frage nach der Aktualisierung des Clients.

Wichtig ist, dass der Client in dasselbe Verzeichnis aktualisiert wird, aus dem Ihr HELIUM 5 Client gestartet wird. Erfolgt die Aktualisierung in ein anderes Verzeichnis, wird der von Ihnen gestartete Client nicht aktualisiert. Dadurch erscheint die Frage nach der Aktualisierung erneut.

Wir empfehlen daher, immer den vorgeschlagenen Installationspfad zu verwenden. Für Windows-Installationen ist dies in der Regel:

C:\Programme\helium_v

„Javaw nicht gefunden“

Wenn die Fehlermeldung „Javaw nicht gefunden“ erscheint, muss die Umgebungsvariable Path erweitert werden. Gegebenenfalls benötigen Sie dafür höhere Systemrechte.

1. Suchen Sie nach Umgebungsvariablen.

2. Klicken Sie unten rechts im Fenster auf Umgebungsvariablen ….

Wählen Sie im unteren Bereich Systemvariablen die Variable Path aus und klicken Sie auf Bearbeiten ….

Fügen Sie einen neuen Eintrag hinzu. Der Pfad muss zu Ihrem Java-bin-Verzeichnis führen. Sie finden Ihr Java-bin-Verzeichnis zum Beispiel mit dem Windows-Explorer unter:

C:\Programme\Java\JRE?\Bin

Speichern Sie Ihre Änderungen und starten Sie Ihren HELIUM 5 Client neu.

Fehlermeldung zu Schriftarten

Gegebenenfalls erhalten Sie auf einem Linux-Client folgende Fehlermeldung:

com.lp.editor.LpEditor.setJasperReport(LpEditor.java:1770)] - FontName "Arial"
in default-font-element in JasperReport "dreispalter" not found

Diese Meldung bedeutet, dass die von HELIUM 5 in allen Formularen verwendete Schriftart Arial auf dem Client-System nicht installiert ist. Installieren Sie die Schriftart nach.

Auf einem Ubuntu-System können Sie die Schriftarten wie folgt nachinstallieren:

sudo apt-get install msttcorefonts
sudo fc-cache -fv

Zugriff über VPN

Wichtig ist, dass die in der Hilfe unter System beschriebenen Portadressen über Ihre VPN-Verbindung weitergeleitet werden.

Der einzige Unterschied zur Verbindung im LAN besteht darin, dass üblicherweise direkt die Server-IP-Adresse eingetragen werden muss. Grund dafür ist, dass die Namensauflösung häufig nicht über die VPN-Verbindung funktioniert.

Sie können die Server-IP-Adresse entweder bei der Client-Installation angeben oder direkt im Client-Aufruf anpassen.

Diesen Aufruf finden Sie auf Windows-Systemen in der Regel unter:

C:\programme\Helium_V\lpclientpc.bat

Suchen Sie dort nach einem Eintrag wie ...=jnp://servername:2099.... Tragen Sie anstelle des Servernamens die IP-Adresse Ihres HELIUM 5 Servers ein.