Installation «Helper»: Unterschied zwischen den Versionen

Aus Helper
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Zeile 1: Zeile 1:
== Installation von Omnis Studio  (Clientseite)==  
== Vorbemerkung ==
Die Installation läuft wie bei den meisten Programmen mit einem Installer. In der Regel legen wir den Installer bei Ihnen auf dem Fileserver ab im Helper-Ordner, in einem Unterordner "Z_Install", damit Sie die Installation nach einem Systemabsturz selber vornehmen können. Die meisten Kunden verwenden mittlerweile die Version Omnis Studio 4.3.2.1.
'''Profile GmbH''' unterstützt Sie beim gesamten Installationsprozess. Wir kümmern uns um die SQL-Server-Installation und stellen '''fertige Programm-''' (macOS) oder '''Installationspakete''' (Windows) für die Clients zur Verfügung. Hier möchten wir zu Ihrem Verständnis die Installationsarchitektur von Helper beschreiben.
Wenn Sie nicht sicher sind welche Version bei Ihnen verwendet wird, wenden Sie sich bitte an Profile GmbH.


In der Regel legen wir auf Ihrem Fileserver sowohl den Installer für die Runtime als auch für die Entwickler-Versionen von Omnis ab. Zum normalen Arbeiten im Helper genügt die Runtime-Version. Sie ist durch einen Zusatz "RT" gekennzeichnet, wohingegen die Entwicklerversion den Zusatz "DV" (für "Development") im Namen trägt.
== Mögliche  Installationsarten ==
'''Einzelplatz-Installation'''


Arbeiten Sie in Ihrer Firma auf unterschiedlichen Plattformen mit dem Helper (zB Mac OS X ''und'' Windows), dann finden Sie auf Ihrem Fileserver auch die Omnis-Installer für die verschiedenen Plattformen.
Bei der Einzelplatzinstallation werden sowohl Verwaltungs- als auch Applikationsdaten auf nur einem Gerät installiert.
===Was brauche ich für die Installation?===
*Den richtigen Omnis-Installer für das Betriebsystem, auf dem Sie mit dem Helper arbeiten wollen.
*Die Omnis-Erweiterungen ACWrite.n_xcomp und pdfdevice.n_xcomp (Mac) bzw. acwrite.dll und pdfdevice.dll (Win), sowie
*Die Seriennummer für Omnis (sollte in einem Textfile auf Ihrem Fileserver liegen)
*Die Datei "StartHL.lbs" (können Sie hier runterladen)
*Die Dateien "Helper.lbs" und "Replib.lbs" (Sollten auf Ihrem Fileserver liegen)
*Die Dateien, die Ihren Firmennamen tragen mit den Endungen ".df1" und ".lbs", zB, wenn Ihre Firma "Giovannis Medien-Bude" heisst, sollten die Dateien zB "Giovanni.lbs" und "Giovanni.df1" heissen. Eventuell kann es auch noch Dateien mit den Endungen .df2/3/4/5... geben. Sie wird dann auch benötigt.
*Die Schriften, die in den Belegen des Helper benutzt werden, also idR Ihre Hausschriften. Wenn Sie orange Einzahlungscheine bedrucken, benötigen Sie auch die Schrift OCRB.


=== Windows Vista/7/8/10 ===
''Folgende Komponenten werden dabei installiert (Stand 06-19):''
====Omnis Studio 6.1.3====
In der Regel haben Sie einen Installer erhalten, der alle nötigen Dateien komplett installiert.


====Omnis Studio 8.1.3====
*'''PostgreSQL-Server''' 9.6 (freies Datenbankmanagementsystem)
In der Regel haben Sie einen Installer erhalten, der alle nötigen Dateien komplett installiert.
*'''pgAdmin''' 4.x (Open-Source-Software zur Administration von PostgreSQL-Datenbanken)
*'''Omnis RT''' 8.1.3 (Runtime-Version der Omnis Entwicklungsumgebung)


=====Hinweise=====
Im Benutzerverzeichnis werden unter «Profile GmbH\Helper 22\startup» die eigentliche Programmbibliothek «'''Helper.lbs'''» und die Belegsammlungen «'''Replib.lbs'''» (Standard) und «'''Kundenname.lbs'''» (individuelle Belege) abgelegt.
Omnis benötigt VC++ Runtime 2015 (oder 2010), für die Verbindung zur PostgresDatenbank wird VC++ Runtime 2013 benötigt (Fehlermeldung 'Interface or Client Function not avaliable').


====Omnis Studio 4.3.2.1====
== Mehrplatz-Installation (Server-Client-Installation) ==
*Doppelklicken Sie auf den Installier für Omnis 4.3.2 Runtime (Setup32rt_432.exe) und lassen Sie ihn alles im Standardverzeichnis (idR C:\Programme\Tigerlogic\OS432 RT\ installieren.
*Doppelklicken Sie auf den Installier für Omnis 4.3.2.1 Runtime Update (Setup32rt_4321.exe) und zeigen Sie ihm das wo Sie eben Omnis installiert haben (idR C:\Programme\Tigerlogic\OS432 RT\).
*Starten Sie den Rechner neu.
*Installieren Sie ihre Hausschriften, damit Belege korrekt ausgedruckt werden können.
*Legen Sie die Datei "StartHL.lbs" in den Ordner C:\Programme\TigerLogic\OS4321 RT\firstruninstall\startup\
*Legen Sie die Omnis-Erweiterungen "acwrite.dll" und "pdfdevice.dll" in den Ordner C:\Programme\TigerLogic\OS4321 RT\xcomp
*Starten Sie das Programm Omnis (zB via Start:Programme:Omnis Studio:Omnis Studio 4.3.2.1 Runtime)
*Geben Sie die Seriennummer ein.
*Sie werden dann nach dem Ort der Helper-Library gefragt. Zeigen Sie ihm die Datei "Helper.lbs". Sie sollte auf ihrem Fileserver liegen.
*Er fragt nun nach dem Datenfile. Es sollte auf Ihrem Fileserver liegen und wie Ihre Firma heissen, mit der Endung ".df1". Zeigen Sie es ihm.


=== Mac OS X ===
Bei einer Server-Client-Installation werden Verwaltungs- und Applikationsdaten getrennt installiert.<br>
====Omnis Studio 4.3.2.1====
'''Server-Installation'''
*Doppelklicken Sie auf den Installier für Omnis 4.3.2 und lassen Sie ihn alles im Standardverzeichnis (idR Festplatte:Programme:) installieren.
*Doppelklicken Sie auf den Installier für den Update auf 4.3.2.1 und lassen Sie ihn das eben erstellte Omnis 4.3.2 updaten.
*Installieren Sie ihre Hausschriften, damit Belege korrekt ausgedruckt werden.
*Gehen Sie in den Ordner Programme, klicken Sie einmal mit der rechten Maustaste auf Omnis.4.3.2.1 und wählen Sie aus dem Kontextmenu "Paketinhalt anzeigen"
*Navigieren Sie darin nach Contents: MacOS
*Legen Sie die Datei "StartHL.lbs" in den Ordner startup: (in Contents: MacOS)
*Legen Sie die Omnis-Erweiterungen "ACWrite.n_xcomp" und "pdfdevice.n_xcomp" in den Ordner xcomp: (in Contents: MacOS)
*Starten Sie das Programm Omnis
*Geben Sie die Seriennummer ein.
*Sie werden dann nach dem Ort der Helper-Library gefragt. Zeigen Sie ihm die Datei "Helper.lbs". Sie sollte auf ihrem Fileserver liegen.
*Er fragt nun nach dem Datenfile. Es sollte auf Ihrem Fileserver liegen und wie Ihre Firma heissen, mit der Endung ".df1". Zeigen Sie es ihm.


====Programm kopieren====
''Folgende Komponenten werden dabei installiert (Stand 06-19):''
Auf dem Mac können Sie in der Regel den Helper von einem Arbeitsplatz auf einen anderen kopieren.


====Fehlendes Java====
*'''PostgreSQL'''-Server 9.6 (freies Datenbankmanagementsystem)
Beim ersten Aufstarten des Helpers kann es vorkommen, dass macOS nach einem alten Java verlangt. Dazu gibt es zwei Lösungsmöglichkeiten:
*'''pgAdmin''' 4.x (Open-Source-Software zur Administration von PostgreSQL-Datenbanken)
#Sie installieren das alte Java, gemäss Anleitung bei Apple: https://support.apple.com/kb/dl1572?locale=de_CH
*'''Omnis development''' 8.1.3 (Entwicklungsumgebung von Omnis für den Remotesupport)
#Nur für Fortgeschrittene Benutzer: Der Helper braucht Java eigentlich nicht. Die Abhängigkeit kommt von der Standardinstallation von Omnis 4.3.2.1. Sie können diese Abhängigkeit aufheben, indem Sie folgende Dateien im Helper löschen:
*'''Auto-Update-Funktion''' für die automatische Verteilung an die Clients
*Helper:Contents:MacOS:xcomp:javacore.n_xcomp
*Helper:Contents:MacOS:xcomp:javaobjs.n_xcomp
*Helper:Contents:MacOS:xcomp:damjdbc.n_xcomp


== Serverseitige Installation ==
'''Client-Installation (Arbeitsplatzrechner)'''
Falls Sie eine Einzelplatzinstallation haben, können Sie diesen Teil überspringen.
*'''Omnis RT''' 8.1.3 (Runtime-Version der Omnis Entwicklungsumgebung)
Es gibt drei Arten von serverseitigen Installationen:
=== PostgreSQL Datenbank===
Anleitung folgt.


=== Fileserver ===
Im Benutzerverzeichnis werden unter «Profile GmbH\Helper 22\startup» die eigentliche Programmbibliothek «'''Helper.lbs'''» und die Belegsammlungen «'''Replib.lbs'''» (Standard) und «'''Kundenname.lbs'''» (individuelle Belege) abgelegt.
Diese Art ist sehr einfach. Alle Dateien, die der Helper benötigt liegen in einem Ordner auf dem Fileserver.


=== Omnis Data Bridge (odb) ===
== Spezielle Installationsumgebungen ==
Hier wurde auf dem Server-Computer ein Datenbank-Dienst installiert (ähnlich einem SQL-Server). Als Technologie verwenden wir die Omnis Data Bridge.
Installationen in virtuellen Windows-Umgebungen beispielsweise unter VMware laufen in der Regel gleich ab. Spezielle Cloudinstallationen (z. B. PostgreSQL-Instanz in AWS, Terminalserver-Lösungen) müssten besprochen werden.  


== Dateien kopieren ==
== Benennung und Versionsnummer ==
Nach der Installation von «Helper» ist die aktuelle Version im Namen sichtbar (z. B. «Helper 22a»).
Ist das Modul «Leistungserfassung» installiert so lautet die Benennung entsprechend «LEFA 22a»
 
== Schriften ==
Die Barcode-Schriftart «30F9_NEW.ttf» ist Teil des Installationspaketes.
Spezielle Hausschriften müssen uns vom Kunden zur Verfügung gestellt werden, wenn sie Teil des Installationspaketes sein sollen oder von diesem selber auf allen Clients installiert werden.
 
== Antiviren-Software ==
Es ist empfohlen, dass das Software-Verzeichnis des PostgreSQL-Servers in die Ausschlussliste der installierten Antivirus-Lösung aufgenommen wird.
 
== Firewall-Einstellungen ==
Die Helper-Clients benötigen für die Verbindung zum SQL-Server den offenen TCP/IP-Port 5432 in beide Richtungen.
 
== Sicherung der Datenbank ==
An jedem Wochentag wird im laufenden Betrieb mittags und am späteren Abend ein SQL-Dump als Backup erstellt. Dies wird in Cron (macOS) oder in der Aufgabenplanung (Windows) in der Serverumgebung eingerichtet. Die Backup-Dateien bleiben eine Woche erhalten.
'''Hinweis:''' Der Kunde muss sicherstellen, dass das Backup-Verzeichnis zusätzlich auf Band gesichert wird.<br>
Ausserdem muss regelmässig geprüft werden, dass Sicherungsdateien wunschgemäss erstellt werden.
 
'''Autoupdate-Funktion'''
Profile GmbH erweitert laufend die Funktionalität von «Helper». Diese werden nach Absprache auf den Server geladen und beim nächsten Aufstarten den einzelnen Clients zur Installation angeboten. Diese müssen dann gleich beim ersten Erscheinen des entsprechenden Fensters installiert werden.
 
== Remote-Support ==
Für den schnellen Support arbeitet Profile GmbH mit der Quicksupport-Lösung von Teamviewer. Für Installation, Monitoring und Serverwartung empfiehlt sich die dauerhafte Installation von Teamviewer Host. Sofern vorhanden, sind wir selbstverständlich auch für RDP- und VPN-Verbindungen vorbereitet.


== Helper konfigurieren ==
== Helper konfigurieren ==

Version vom 3. Juni 2019, 01:04 Uhr

Vorbemerkung

Profile GmbH unterstützt Sie beim gesamten Installationsprozess. Wir kümmern uns um die SQL-Server-Installation und stellen fertige Programm- (macOS) oder Installationspakete (Windows) für die Clients zur Verfügung. Hier möchten wir zu Ihrem Verständnis die Installationsarchitektur von Helper beschreiben.

Mögliche Installationsarten

Einzelplatz-Installation

Bei der Einzelplatzinstallation werden sowohl Verwaltungs- als auch Applikationsdaten auf nur einem Gerät installiert.

Folgende Komponenten werden dabei installiert (Stand 06-19):

  • PostgreSQL-Server 9.6 (freies Datenbankmanagementsystem)
  • pgAdmin 4.x (Open-Source-Software zur Administration von PostgreSQL-Datenbanken)
  • Omnis RT 8.1.3 (Runtime-Version der Omnis Entwicklungsumgebung)

Im Benutzerverzeichnis werden unter «Profile GmbH\Helper 22\startup» die eigentliche Programmbibliothek «Helper.lbs» und die Belegsammlungen «Replib.lbs» (Standard) und «Kundenname.lbs» (individuelle Belege) abgelegt.

Mehrplatz-Installation (Server-Client-Installation)

Bei einer Server-Client-Installation werden Verwaltungs- und Applikationsdaten getrennt installiert.
Server-Installation

Folgende Komponenten werden dabei installiert (Stand 06-19):

  • PostgreSQL-Server 9.6 (freies Datenbankmanagementsystem)
  • pgAdmin 4.x (Open-Source-Software zur Administration von PostgreSQL-Datenbanken)
  • Omnis development 8.1.3 (Entwicklungsumgebung von Omnis für den Remotesupport)
  • Auto-Update-Funktion für die automatische Verteilung an die Clients

Client-Installation (Arbeitsplatzrechner)

  • Omnis RT 8.1.3 (Runtime-Version der Omnis Entwicklungsumgebung)

Im Benutzerverzeichnis werden unter «Profile GmbH\Helper 22\startup» die eigentliche Programmbibliothek «Helper.lbs» und die Belegsammlungen «Replib.lbs» (Standard) und «Kundenname.lbs» (individuelle Belege) abgelegt.

Spezielle Installationsumgebungen

Installationen in virtuellen Windows-Umgebungen beispielsweise unter VMware laufen in der Regel gleich ab. Spezielle Cloudinstallationen (z. B. PostgreSQL-Instanz in AWS, Terminalserver-Lösungen) müssten besprochen werden.

Benennung und Versionsnummer

Nach der Installation von «Helper» ist die aktuelle Version im Namen sichtbar (z. B. «Helper 22a»). Ist das Modul «Leistungserfassung» installiert so lautet die Benennung entsprechend «LEFA 22a»

Schriften

Die Barcode-Schriftart «30F9_NEW.ttf» ist Teil des Installationspaketes. Spezielle Hausschriften müssen uns vom Kunden zur Verfügung gestellt werden, wenn sie Teil des Installationspaketes sein sollen oder von diesem selber auf allen Clients installiert werden.

Antiviren-Software

Es ist empfohlen, dass das Software-Verzeichnis des PostgreSQL-Servers in die Ausschlussliste der installierten Antivirus-Lösung aufgenommen wird.

Firewall-Einstellungen

Die Helper-Clients benötigen für die Verbindung zum SQL-Server den offenen TCP/IP-Port 5432 in beide Richtungen.

Sicherung der Datenbank

An jedem Wochentag wird im laufenden Betrieb mittags und am späteren Abend ein SQL-Dump als Backup erstellt. Dies wird in Cron (macOS) oder in der Aufgabenplanung (Windows) in der Serverumgebung eingerichtet. Die Backup-Dateien bleiben eine Woche erhalten. Hinweis: Der Kunde muss sicherstellen, dass das Backup-Verzeichnis zusätzlich auf Band gesichert wird.
Ausserdem muss regelmässig geprüft werden, dass Sicherungsdateien wunschgemäss erstellt werden.

Autoupdate-Funktion Profile GmbH erweitert laufend die Funktionalität von «Helper». Diese werden nach Absprache auf den Server geladen und beim nächsten Aufstarten den einzelnen Clients zur Installation angeboten. Diese müssen dann gleich beim ersten Erscheinen des entsprechenden Fensters installiert werden.

Remote-Support

Für den schnellen Support arbeitet Profile GmbH mit der Quicksupport-Lösung von Teamviewer. Für Installation, Monitoring und Serverwartung empfiehlt sich die dauerhafte Installation von Teamviewer Host. Sofern vorhanden, sind wir selbstverständlich auch für RDP- und VPN-Verbindungen vorbereitet.

Helper konfigurieren

Einrichten der Druckersteuerung

Abgerufen von „https://helper.ch/wiki/index.php?title=Installation_«Helper»&oldid=3443“