Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für...

20
Dokumentinformation: AGIS Ablage …\Installationsanleitung OPENService Client 6.xx.docx Version 1.02 Ausgabedatum 13.12.2010 Autor vil Status Entwurf, Vorschlag, Prüfung, Intern, Public Revision Datum Person Bemerkungen 1.00 23.07.2009 vil Dokument erstellt 1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012 arj Ergänzungen Oracle 11 und Windows 64bit 2.00 26.08.2014 wha Anpassung an AdvancedInstaller AGIS Aktiengesellschaft für Informationsmanagement und –strategie Hauptstrasse 39 CH-9053 Teufen AR Tel. +41 (0)71 335 77 22 Fax +41 (0)71 335 77 23 [email protected] www.agis.ch OPEN Service – Dokumentation Installationsanleitung OPENService Client 6.xx OPENService Client Word Makros für Mischdokumente Windows Registry

Transcript of Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für...

Page 1: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

Dokumentinformation:

AGIS Ablage …\Installationsanleitung OPENService Client 6.xx.docx

Version 1.02

Ausgabedatum 13.12.2010

Autor vil

Status Entwurf, Vorschlag, Prüfung, Intern, Public

Revision Datum Person Bemerkungen

1.00 23.07.2009 vil Dokument erstellt

1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt

1.02 13.12.2010 pku Komplette Überarbeitung

1.03 25.10.2012 arj Ergänzungen Oracle 11 und Windows 64bit

2.00 26.08.2014 wha Anpassung an AdvancedInstaller

AGIS Aktiengesellschaft für Informationsmanagement und –strategie Hauptstrasse 39 CH-9053 Teufen AR Tel. +41 (0)71 335 77 22 Fax +41 (0)71 335 77 23 [email protected] www.agis.ch

OPENService – Dokumentation

Installationsanleitung OPENService Client 6.xx

� OPENService Client

� Word Makros für Mischdokumente

� Windows Registry

Page 2: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 2/20

Inhalt

1 Voraussetzungen ...................................................................................................................... 3

2 OPENService Client .................................................................................................................. 4

2.1 Abschluss ......................................................................................................................... 10

3 Client Installation über Softwareverteilung ............................................................................. 11

3.1 Setup Parameter ............................................................................................................... 11

3.2 Beispiele ........................................................................................................................... 12

3.2.1 Beispiel 1 .................................................................................................................. 12

3.2.2 Beispiel 2 .................................................................................................................. 12

3.2.3 Beispiel 3 .................................................................................................................. 12

3.3 Testen / Debuggen .......................................................................................................... 13

3.3.1 Debug-Mode aktivieren ............................................................................................ 13

3.3.2 Logdatei erstellen ...................................................................................................... 14

4 Word-Makros für Mischdokumente ........................................................................................ 15

4.1 Microsoft Office 2007 ...................................................................................................... 15

4.1.1 Makro-Sicherheit definieren und Zertifikat installieren (Empfehlung) ......................... 16

4.1.2 Vertrauenswürdigen Speicherort hinzufügen (Alternative) ......................................... 16

4.2 Microsoft Office 2010 ...................................................................................................... 17

4.2.1 Makro-Sicherheit definieren und Zertifikat installieren (Empfehlung) ......................... 17

4.2.2 Vertrauenswürdigen Speicherort hinzufügen (Alternative) ......................................... 18

5 Windows-Registry: LOCAL-Eintrag (optional) ........................................................................ 19

Page 3: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 3/20

1 Voraussetzungen

• Oracle Client-Installation, die gemäss Dokumentation

"Oracle 10.2 Client-Installation (Benutzerdefiniert mit Patch)" bzw.

„Oracle 11.2 Client-Installation“ durchgeführt und konfiguriert wurde.

• Installation von OPENService. Die Datenbank muss vom Client aus erreichbar sein.

• Installation des OPENService Workgroup-Servers gemäss Dokumentation

„Installationsanleitung OPENService Server 6.xx“.

Der Workgroup-Server-Zielpfad muss vom lokalen PC aus erreichbar sein.

• .NET Framework 4.0 oder höher

1.1 Installationsdateien

Die aktuellsten Versionen können vom AGIS-FTP Server

„http://www.agis.ch/FTP/AGIS/OPENService“ heruntergeladen werden.

Page 4: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 4/20

2 OPENService Client

Die Server-Installation muss vor der Client-Installation erfolgen. Ausserdem darf nur diejenige Client-

Version installiert werden, die vorgängig auf dem Server installiert worden ist.

Starten der „OSClientSetup.exe“ und klick auf weiter.

In der folgenden Maske können im Register Features die zu installierenden Sprachen ausgewählt

werden. OPENReport wird für Auswertungen aus OPENService benötigt. XML to PDF or HTML für

den E-Mail Versand von Rechnungen.

Page 5: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 5/20

Im Register „Installationsordner“ kann das Installationsverzeichnis angegeben werden.

Dieses muss im Regelfall nicht geändert werden.

Mit „Weiter“ öffnet sich die Maske für die Lizenzdaten.

Hier wird der Benutzername, die Organisation sowie die Seriennummer eingetragen und

mit „Weiter“ die Eingaben bestätigt.

Page 6: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 6/20

Hier kann ausgewählt werden für welche Benutzer der OPENService Client installiert werden soll.

In der folgenden Maske kann ausgewählt werden ob eine vorherige Version von OPENService

entfernt werden soll, oder ob diese Version von OPENService zusätzlich installiert werden soll.

Dies findet hauptsächlich Anwendung wenn zum Testen das Testsystem bereits auf eine neuere

Version aktualisiert werden soll.

Mit „Weiter“ wird die nächste Maske geöffnet.

Page 7: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 7/20

Hier können Verknüpfungen festgelegt werden, die durch die Installation erstellt werden sollen.

Mit „Weiter“ wird die nächste Maske geöffnet.

Hier kann der Programmordner ausgewählt werden, indem die Programmverknüpfung von

OPENService angelegt werden soll.

Mit „Weiter“ wird die nächste Maske geöffnet.

Page 8: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 8/20

Dort kann mit „Installieren“ die Installation gestartet werden.

„Abbrechen“ beendet das Setup ohne Installtion von OPENService.

Mit „Zurück“ können die Einstellungen nocheinmal geprüft und geändert werden.

Mit „Installieren“ wird die Installation gestartet.

Da bei der Installation auch Word Macros installiert werden, prüft der Installationsvorgang ob Word

geöffnet ist. Die nachfolgende Meldung weisst auf diesen Umstand hin.

Mit OK wird nun Word geschlossen.

Vorher müssen noch nicht gespeicherte Vorgänge abgeschlossen werden.

Page 9: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 9/20

Nachdem die Installation gestartet wurde muss der Pfad für den Workgroup Server eingetragen

werden. Achten Sie darauf, dass der eingegebene Pfad korrekt ist und auch existiert.

Page 10: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 10/20

Die erfolgreiche Installation wird durch nachfolgende Maske dokumentiert.

2.1 Abschluss

OPENService ist nun betriebsbereit. Die Anwendung kann unter Verwendung der bekannten

Passwörter gestartet werden. Der erste Start dauert aus Initialisierungsgründen etwas länger als die

späteren. Er kann, je nach System, bis zu 60 Sekunden in Anspruch nehmen.

Page 11: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 11/20

3 Client Installation über Softwareverteilung

OPENService Clients können auch über Softwareverteilung ausgerollt werden. Die Installation kann

dabei durch nachfolgende Parameter gesteuert werden.

3.1 Setup Parameter

Property Werte Beschreibung

AI_DESKTOP_SH 1 oder 0 Desktop-Icon

AI_STARTMENU_SH 1 oder 0 Startmenu-Icons

AI_UPGRADE Yes oder No Vorversion deinstallieren

ALLUSERS 1 oder 2 1 = angemeldeter Anwender

2 = Alle Anwender

APPDIR „C:\Temp“

Textbausteine:

[ProgramFilesFolder]

[Manufacturer]

[ProductName]

Installationsverzeichnis

PIDKEY 123456 Seriennummer

ADDDEFAULT „Hauptinstallation,Englisch“ Features aktivieren

WORKGROUPSERVERPATH „O:\OSPROD” Workgroup-Serverpfad definieren

WORKGROUPSERVERPATH2 „O:\OSTEST” Workgroup-Serverpfad definieren

PTHFILENAME „SCHULUNG.PTH“ Name der PTH-Datei für den Workgroupserverpfad 2.

Page 12: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 12/20

3.2 Beispiele

Nachfolgende Beispiele zeigen die Möglichkeiten zur Nutzung der Parametern auf.

3.2.1 Beispiel 1

In diesem Beispiel wird die Seriennummer, die gewünschten Features (Hauptinstallation und Deutsch)

und der Workgroupserver-Pfad mitgeben.

OSClientSetup.exe PIDKEY=123456 ADDDEFAULT=” Hauptinstallation,Deutsch“

WORKGROUPSERVERPATH=”O:\OSPROD”

3.2.2 Beispiel 2

In diesem Beispiel soll die Vorversion eines OPENService Client nicht deinstalliert werden. Dies

geschieht mit dem Property “AI_UPGRADE“

OSClientSetup.exe PIDKEY=123456 ADDDEFAULT=” Hauptinstallation,Deutsch“

WORKGROUPSERVERPATH=”O:\OSPROD” AI_UPGRADE=No

3.2.3 Beispiel 3

In diesem Beispiel soll eine zweite PTH-Datei für eine weitere OPENService Instanz angeben werden.

OSClientSetup.exe PIDKEY=123456 APPDIR="C:\Temp" AI_UPGRADE=No ADDDEFAULT=”

Hauptinstallation,Deutsch,English,Francais“ WORKGROUPSERVERPATH=”O:\OSPROD”

WORKGROUPSERVERPATH2=”O:\OSTEST” PTHFILENAME=“SCHULUNG.PTH“

Page 13: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 13/20

3.3 Testen / Debuggen

3.3.1 Debug-Mode aktivieren

Die OSClientSetup.exe kann optional mit dem Parameter Debug=1 aufgerufen werden. Damit

werden während der Installation nützliche Informationen in der Windows Ereignisanzeige

protokolliert.

Abbildung Windows Ereignisanzeige, Anwendungen (Quelle: OPENService)

Beispiel:

OSClientSetup.exe PIDKEY=123456 ADDDEFAULT=” Hauptinstallation,Deutsch“

WORKGROUPSERVERPATH=”O:\OSPROD”Debug=1

Page 14: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 14/20

3.3.2 Logdatei erstellen

Mit dem Parameter „/L*V“ kann eine Log-Datei angegeben werden. Darin werden die einzelnen

Schritte des AdvancedInstallers (Info, Warnung, Error) ausgegeben.

Beispiel:

OSClientSetup.exe /L*V "D:\TEMP\OSClientSetup\OSClientSetup.log"

Weitere Informationen unter folgender Webseite:

� http://www.advancedinstaller.com/user-guide/qa-log.html

Page 15: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 15/20

4 Word-Makros für Mischdokumente

Im Rahmen der OPENService Installation wird ein Add-In zu Microsoft Office Word installiert. Sollte

dies durch eventuelle Fehlermeldungen verhindert werden, so ist Word zu schliessen. Die Installation

von OPENService kann normal beendet werden.

Die Makros können dann auch nachträglich eingefügt werden. Dazu öffnen Sie das Dokument

„OSMakros.dot“. Dieses befindet sich standardmässig unter „C:\Program Files (x86)\Microsoft

Office\Office12\STARTUP\“. Wenn alles korrekt durchgeführt werden konnte, wird Word

automatisch geschlossen.

4.1 Microsoft Office 2007

Damit Mischdokumente aus OPENService korrekt erstellt werden können, müssen die Makros für

OPENService korrekt eingerichtet sein. Dies bedingt, dass die Sicherheitseinstellungen in Microsoft

Word so angepasst werden, dass die Makros ausgeführt werden dürfen.

Um die Ausführung der Makros zu ermöglichen gibt es zwei Möglichkeiten, wobei wir die erste

empfehlen:

Page 16: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 16/20

4.1.1 Makro-Sicherheit definieren und Zertifikat installieren (Empfehlung)

1. Klicken Sie auf die Microsoft Office-Schaltfläche , und klicken Sie dann auf

Word-Optionen.

2. Klicken Sie auf Vertrauensstellungscenter und dann auf Einstellungen für das

Vertrauensstellungscenter.

3. Aktivieren Sie „Alle Makros ausser digital signierten Makros deaktivieren“

4. Aktivieren Sie nun den "Zugriff auf das VBA-Projektobjektmodell vertrauen" unter der Rubrik

"Entwicklermakroeinstellungen“

5. Beim Start von Word sollte nun im oberen Bereich eine Sicherheitswarnung „Makros wurden

deaktiviert“ erscheinen

6. Nach dem Klick auf „Optionen“ sollten die folgenden Informationen erscheinen:

7. Falls dies zutrifft, können Sie „Allen Dokumenten von diesem Herausgeber vertrauen“ anklicken und mit „OK“ bestätigen

4.1.2 Vertrauenswürdigen Speicherort hinzufügen (Alternative)

1. Klicken Sie auf die Microsoft Office-Schaltfläche , und klicken Sie dann auf Word-

Optionen.

2. Klicken Sie auf Vertrauensstellungscenter und dann auf Einstellungen für das

Vertrauensstellungscenter

3. Klicken Sie auf „Vertrauenswürdige Speicherorte“

4. Klicken Sie auf „Neuen Speicherort hinzufügen“

5. Wählen Sie den Startup-Ordner der Office-Installation, z.B. C:\Programme\Microsoft

Office\Office12\STARTUP

Page 17: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 17/20

4.2 Microsoft Office 2010

Damit Mischdokumente aus OPENService korrekt erstellt werden können, müssen die Makros für

OPENService korrekt eingerichtet sein. Dies bedingt, dass die Sicherheitseinstellungen in Microsoft

Word so angepasst werden, dass die Makros ausgeführt werden dürfen.

Um die Ausführung der Makros zu ermöglichen gibt es zwei Möglichkeiten, wobei wir die erste

empfehlen:

4.2.1 Makro-Sicherheit definieren und Zertifikat installieren (Empfehlung)

1. Klicken Sie auf die Registerkarte „Datei“ und anschliessend auf „Optionen“.

2. Klicken Sie auf „Sicherheitscenter“ und dann auf „Einstellungen für das Sicherheitscenter“.

3. Aktivieren Sie „Alle Makros ausser digital signierten Makros deaktivieren“

4. Aktivieren Sie nun den "Zugriff auf das VBA-Projektobjektmodell vertrauen" unter der

Rubrik "Entwicklermakroeinstellungen“

5. Beim Start von Word sollte nun im oberen Bereich eine Sicherheitswarnung „Makros wurden

deaktiviert“ erscheinen.

6. Klicken Sie auf die Registerkarte „Datei“. Die Microsoft Office Backstage-Ansicht wird

angezeigt.

7. Klicken Sie im Bereich Sicherheitswarnung auf der Schaltfläche „Inhalt aktivieren“ auf den

Pfeil nach unten.

8. Wählen Sie die Option „Erweiterte Optionen“ aus. Das Dialogfeld Microsoft Office-

Sicherheitsoptionen wird angezeigt.

9. Nach dem Klick auf „Optionen“ sollten die folgenden Informationen erscheinen:

Page 18: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 18/20

10. Falls dies zutrifft, können Sie „Allen Dokumenten von diesem Herausgeber vertrauen“

anklicken und mit „OK“ bestätigen.

4.2.2 Vertrauenswürdigen Speicherort hinzufügen (Alternative)

1. Klicken Sie auf die Registerkarte „Datei“ und anschliessend auf „Optionen“.

2. Klicken Sie auf „Sicherheitscenter“ und dann auf „Einstellungen für das Sicherheitscenter“.

3. Klicken Sie auf „Vertrauenswürdige Speicherorte“

4. Klicken Sie auf „Neuen Speicherort hinzufügen“

5. Wählen Sie den Startup-Ordner der Office-Installation, z.B. C:\Programme\Microsoft

Office\Office14\STARTUP

Page 19: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 19/20

5 Windows-Registry: LOCAL-Eintrag (optional)

Damit OPENService standardmässig auf eine bestimmte Datenbank zugreift, kann in der Windows-

Registry ein Default-Eintrag „LOCAL“ erstellt werden. Der Datenbankname muss als Wert

eingetragen werden. Dazu öffnen Sie die Windows-Registry über:

• Start�Ausführen (Win7 „Programme/Dateien durchsuchen“)

� „regedit“ eingeben und mit Enter bestätigen.

• Im Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\KEY_OraClient11g_home1

erstellen Sie die Zeichenfolge „LOCAL“ (LOCAL ist in Grossbuchstaben zu schreiben)

• Weisen Sie der Zeichenfolge „LOCAL“ den Datenbanknamen zu.

Beispiel:

Schliessen Sie den Registrierungs-Editor und starten Sie Ihren Rechner neu. Beim nächsten Öffnen von

OPENService wird in der Benutzeranmeldung die eingestellte Datenbank vorbelegt.

Page 20: Installationsanleitung OPENService Client 6...1.01 10.09.2009 cve Zusätzliche Informationen für MSI-Setup eingefügt 1.02 13.12.2010 pku Komplette Überarbeitung 1.03 25.10.2012

OPENServi c e - Dokumentation

Installationsanleitung OPENService Client 6.xx.docx

AGIS, 19.09.2016 Seite 20/20

Auf einem 64-bit Windows 7 wird der LOCAL String für den 32-bit Oracle Client im Schlüssel

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ORACLE\KEY_OraClient11g_home1_32bit

eingetragen: