Viper Installationsanleitung Stand: 2017-01-01

1

Inhalt Allgemeines ................................................................................................................................ 3 Viper Connector Standalone ...................................................................................................... 4 Systemvoraussetzungen ........................................................................................................ 4 Installationsanleitung............................................................................................................. 5 Windows 8.1 ...................................................................................................................... 5 Windows 7 ....................................................................................................................... 10 Viper Connector Statusfenster & Funktionen erklärt ...................................................... 14 Viper Connector Service .......................................................................................................... 19 Systemvoraussetzungen ...................................................................................................... 19 Installationsanleitungen ...................................................................................................... 20 Windows Server 2012 R2 ................................................................................................. 20 Windows Server 2008 R2 ................................................................................................. 26 Druckerfreigabe für 32- und 64-Bit Systeme ................................................................... 31 Multi-Mandantenfunktion: Hinzufügen eines weiteren Viper-Printers .......................... 34 FAQ: Frequently Asked Questions ........................................................................................... 36

2

Allgemeines Desktop Version des Connectors Der Viper Connector Standalone enthält zwei Bestandteile, die bei der Installation auf einem Computer eingerichtet werden: Connector und Drucker. Er ist für die Installation auf Einzelplatzsystemen vorgesehen (Windows 10/8.1/7). Die Installation auf Windows Vista oder Windows XP ist möglich, wird von der SGH Service AG aber nicht mehr unterstützt. Server Version des Connectors Für die Installation in Firmennetzwerken mit zentraler Verwaltung gibt es den Viper Connector Service, der auf einem Server Betriebssystem installiert wird (Windows Server 2016/2012 R2/2008 R2). Bei dieser Installation wird der Viper Drucker für andere Rechner freigegeben und Endanwendern durch die IT Abteilung bereitgestellt. Diese Installationsanleitung umfasst die Installation von Viper Connector Standalone und Viper Connector Service auf allen aktuell unterstützten Betriebssystemen.

3

Viper Connector Standalone Die Installation des Viper Connector wird ausschließlich auf Client-Betriebssystemen unterstützt.

Systemvoraussetzungen Betriebssysteme: Windows 10 Windows 8.1 Windows 8 Windows 7 mit installiertem Service Pack 1 Nicht supported aber möglich: Windows Vista mit installiertem Service Pack 2 Mit Einschränkungen: Windows XP mit Service Pack 3 und vollem Patchlevel Zusätzliche Komponenten:  



Microsoft Visual C++ 2012 Redistributable http://www.microsoft.com/de-de/download/details.aspx?id=30679 Microsoft .NET Framework 3.5 http://www.microsoft.com/de-de/download/details.aspx?id=21 Hinweis: Ab Windows 7 via Programme und Funktionen -> Windows Funktionen hinzufügen Microsoft Windows Installer 4.5 Redistributable http://www.microsoft.com/de-de/download/details.aspx?id=8483 Hinweis: Ab Windows 7 bereits im Betriebssystem enthalten.

Die fehlenden Komponenten werden im Laufe der Installation automatisch installiert. Eventuell ist ein Neustart erforderlich bevor die Installation fortgesetzt werden kann.

4

Installationsanleitung Windows 8.1 Der Viper Connector wird auf einem Windows 8.1 System installiert.

Für die Installation sind lokale Administratorrechte notwendig.

Die Systemvoraussetzungen werden nachinstalliert (in den nachfolgenden Bildern die Visual C++ 2012 Runtime).

5

Die Visual C++ 2012 Redistributable Runtime wird installiert.

6

Installation abgeschlossen.

Nach Abschluss der Installation der Systemvoraussetzungen, startet die Installation des Viper Connectors:

Weiter.

7

Das Installationsverzeichnis kann angegeben werden, wir empfehlen die Voreinstellungen zu übernehmen.

Die B4ID muss eingegeben werden. Diese erhalten Sie aus der Kundeninformation in Ihrer Eingangspost im Business Portal oder über den Support.

Die B4ID besteht ausschließlich aus Großbuchstaben und Zahlen. Tippfehler werden hier leider nicht verziehen.

8

Die Abfragen zur Installation sind vollständig, es kann losgehen.

Der Viper Connector ist vollständig installiert und kann nach einem Neustart des Systems verwendet werden.

9

Windows 7 Starten Sie die Installationsroutine ViperConnector.exe.

Das Setup startet und prüft die Systemvoraussetzungen

Weiter.

10

Sie können jetzt das Installationsverzeichnis anpassen. Wir empfehlen die Vorgaben zu übernehmen.

Sie müssen jetzt die B4ID angeben. Sie finden diese in der Kundeninformation im Posteingang auf dem Businessportal oder erhalten diese durch den Support.

Die B4ID besteht ausschließlich aus Großbuchstaben und Zahlen. Tippfehler werden hier leider nicht verziehen.

11

Die Abfragen zur Installation sind vollständig, es kann losgehen.

Der Viper Connector ist vollständig installiert und kann nach einem Neustart des Systems verwendet werden

12

Der Viper-Printer ist ebenfalls eingerichtet.

13

Viper Connector Statusfenster & Funktionen erklärt Der Viper Connector ist als Systemtray Anwendung im Symbolbereich neben der Uhr zu sehen.

Mit einem Rechtsclick auf das ViperConnector Symbol kann der Status des ViperConnector aufgerufen werden.

Zu sehen ist die Upload-Historie des Connectors sowie das aktuelle Uploadverzeichnis für den angemeldeten Benutzer.

14

In den Einstellungen können Proxy-Informationen angegeben werden. Dies ist dann notwendig, wenn der Proxy eine Benutzerauthentifizierung benötigt. Wenn der Proxy keine Authentifizierung benötigt nutzt der Connector per Default die Einstellungen des Internet Explorer.

Durch einen Click auf den Button "Stop" lässt sich der Verbindungstest des Connectors freischalten. Er wird ausgelöst durch einen Click auf "Verbindung testen"

Wenn die Verbindung zum Server erfolgreich war und der Account bestätigt wurde funktioniert die Verbindung zum Portal und Dokumente können hochgeladen werden. Kommt keine Verbindung zustande handelt es sich meist um Netzwerk oder Proxy Probleme.

15

Ggf. Muss dem Viper Connector ein Login für die ProxyAuthentifizierung mitgegeben werden. Hier ist darauf zu achten, dass bei Kennwortablauf auch im Viper Connector das Passwort manuell angepasst werden muss.

Der Viper-Printer wird bei der Installation des Viper Connectors automatisch angelegt.

16

Ggf. muss hier die Papiergröße angepasst werden wie im obigen Bild zu sehen (Letter statt A4). Dies ist abhängig von den Einstellungen Ihres Betriebssystems.

Die Ende-zu-Ende Funktionalität des ViperConnectors testen Sie, indem sie eine Testseite auf dem Drucker ausgeben.

Im ViperConnector Statusfenster sind die Dokumente in Warteschlange jetzt zu sehen.

17

Sobald ein Dokument erfolgreich ins Portal übertragen wurde erhält es einen Bestätigungscode. Im nachfolgenden Bild sehen Sie drei erfolgreich übertragene Dokumente.

18

Viper Connector Service Die Installation des Viper Connector Service wird ausschließlich auf Server-Betriebssystemen unterstützt.

Systemvoraussetzungen Betriebssysteme: Windows Server 2012 R2 Windows Server 2012 Windows Server 2008 R2 mit Service Pack 1 Windows Server 2008 mit Service Pack 2 Mit Einschränkungen: Windows Server 2003 mit Service Pack 2 und vollem Patchlevel sowie zusätzlich KB938397 (https://support.microsoft.com/en-us/kb/938397) und KB968730 (https://support.microsoft.com/en-us/kb/968730) Zusätzliche Komponenten:  



Microsoft Visual C++ 2012 Redistributable http://www.microsoft.com/de-de/download/details.aspx?id=30679 Microsoft .NET Framework 3.5 http://www.microsoft.com/de-de/download/details.aspx?id=21 Hinweis: Ab Windows Server 2008 R2 via Programme und Funktionen -> Windows Funktionen hinzufügen Microsoft Windows Installer 4.5 Redistributable http://www.microsoft.com/de-de/download/details.aspx?id=8483 Hinweis: Ab Windows Server 2008 R2 bereits im Betriebssystem enthalten.

Die fehlenden Komponenten werden im Lauf der Installation automatisch installiert. Eventuell ist ein Neustart erforderlich bevor die Installation fortgesetzt werden kann.

19

Installationsanleitungen Windows Server 2012 R2 Starten Sie die ViperConnectorService.exe Setup-Datei.

Die Installation benötigt erhöhte Rechte.

Sie können den Installationspfad anpassen, wir empfehlen der Voreinstellung zu folgen.

20

Klicken Sie auf „Installieren“ um die Installation zu beginnen.

Installation läuft.

Die Installation ist abgeschlossen.

21

Im Startmenü gibt es nun den „Service Configurator“. Dieser wird verwendet um den Viper Connector Service zu konfigurieren und einzurichten.

Der Service Configurator muss mit erhöhten Rechten ausgeführt werden. Per Rechtsclick erhalten Sie das Auswahlmenü und starten das Programm über den Punkt „Als Administrator ausführen“.

Sie müssen die Rechteerhöhung bestätigen.

22

Zuallererst muss ein Root-Pfad angegeben werden. Dieser Pfad muss auf einem lokalen Laufwerk des Servers liegen, die Verwendung eines Netzwerklaufwerks wird nicht unterstützt. Bitte achten Sie darauf, dass ausreichend freier Speicherplatz (mindestens 10GB, abhängig vom Dokumentvolumen) auf dem gewählten Laufwerk verfügbar ist.

Im Beispiel wurde das Verzeichnis C:\Viper als RootPfad für den Connector Service gewählt. Über den Button „Create“ wird es angelegt.

Als "Viper-Name" empfehlen wir die Verwendung des Firmennamens bzw. der Portalmandantenbezeichnung. Anhand des Viper-Namens wird der Drucker später benannt.  Die B4ID muss, wie vom Portal vergeben, angegeben werden. Der Eintrag wird im ServiceConfigurator nicht auf Validität geprüft. Die B4ID besteht nur aus Großbuchstaben A-Z und Ziffern 0-9.  Der Viper Connector Service erlaubt keine Sonderzeichen oder Leerzeichen im ViperNamen um Probleme mit

23

Freigaben unter Windows zu vermeiden. Speichern Sie die Konfiguration mit Click auf den Button "Save".

Nachdem eine Konfiguration gespeichert wurde kann der Drucker über den Button "Add Printer" angelegt werden:

24

Der Drucker wurde angelegt:

25

Windows Server 2008 R2 Starten Sie die ViperConnectorService.exe Setup-Datei.

Sie können den Installationspfad anpassen, wir empfehlen der Voreinstellung zu folgen.

26

Klicken Sie auf „Installieren“ um die Installation zu beginnen.

Installation läuft.

Die Installation ist abgeschlossen.

27

Nach abgeschlossener Installation muss der ServiceConfigurator mit Administratorrechten ausgeführt werden:

Zuerst muss ein Basisverzeichnis angelegt werden. Dieses muss sich auf einem lokalen Laufwerk (keine Netzwerkfreigabe) befinden und ausreichend freien Speicherplatz für den geplanten Dokumentenversand von 10 Tagen haben. Wir empfehlen C:\Viper

Als "Viper-Name" empfehlen wir die Verwendung des Firmennamens bzw. der Portalmandantenbezeichnung. Anhand des Viper-Namen wird der Drucker später benannt.  Die B4ID muss wie vom Portal vergeben angegeben werden. Der Eintrag wird im ServiceConfigurator nicht auf Validität geprüft. Die B4ID besteht nur aus Großbuchstaben A-Z und Ziffern 0-9.  Der ViperConnectorService erlaubt keine Sonderzeichen oder Leerzeichen im Viper-

28

Namen um Probleme mit Freigaben unter Windows zu vermeiden. Speichern Sie die Konfiguration mit Click auf den Button "Save":

Nachdem eine Konfiguration gespeichert wurde kann der Drucker über den Button "Add Printer" angelegt werden:

29

Der Drucker wurde angelegt.

30

Druckerfreigabe für 32- und 64-Bit Systeme Finden Sie den Viper-Drucker in Geräte und Drucker.

In den Eigenschaften des Druckers wechseln Sie auf den Reiter Freigabe. Clicken Sie auf Ändern der Freigabe-Optionen

Der Button Zusätzliche Druckertreiber ist jetzt erreichbar.

31

Es wurde nur der Druckertreiber in 64-Bit installiert. Wenn Sie den Drucker für 32-Bit Clients freigeben möchten, müssen noch die 32-Bit Treiber hinzugefügt werden.

Starten Sie das zu Ihrem ServerBetriebssystem passende Treiber Paket:  Viper-Drivers_Win812012R2.exe  Viper-Drivers_Win72008R2.exe

Das Setup fragt nach erhöhten Rechten.

32

Es werden die nötigen Treiber eingespielt und Registry Einträge gesetzt. Der Druckerwarteschlangendienst wird neu gestartet.

Wenn Sie jetzt erneut auf die Druckerfreigabe navigieren sehen sie jetzt , dass Treiber für 32- wie 64-Bit Systeme vorhanden sind.

33

Multi-Mandantenfunktion: Hinzufügen eines weiteren Viper-Printers Öffnen Sie den ServiceConfigurator mit Administratorrechten, die existierende Konfiguration wird automatisch geladen bzw. kann über den Button "Load" erneut eingelesen werden:

Mit dem Button "Add" wird eine neue Konfiguration für einen weiteren Viper-Printer eröffnet. Über die Buttons "Previous" und "Next" kann zwischen den bestehenden Konfigurationen gewechselt werden, die Auswahl und Anzahl der vorhanden Konfigurationen wird oben rechts unter "Loaded Config 2/2" angezeigt.

Ergänzen Sie den Viper-Namen und die B4ID und speichern Sie mit "Save":

34

Fügen Sie über "Add Printer" den zu der neu hinzugefügten Konfiguration zugehörigen Drucker hinzu:

Der neue Drucker ist wird in der Druckerverwaltung gelistet:

35

FAQ: Frequently Asked Questions Wie stelle ich einen Proxy-Server ein? Beim Viper Connector kann ein Proxy-Server im Status-Fenster eingestellt werden. Per Default verwendet der Viper Connector den im Internet Explorer eingestellten Proxy Server. Sollte der Proxy eine Authentifizierung verlangen, müssen Sie hier noch einen Benutzernamen und ein Passwort ergänzen, die Anmeldung des Benutzers am Rechner kann nicht übernommen werden. Bitte achten Sie darauf, dass das Kennwort bei Kennablauf auch im Viper Connector geändert werden muss. Im Viper Connector Service wird der Proxy im Service Configurator eingestellt. Dies muss manuell erfolgen. Es kann auch hier ein Benutzername und Kennwort für die Authentifizierung am Proxy eingetragen werden. ACHTUNG: Der für den Proxy eingetragene Benutzername und das Passwort werden im Klartext auf dem Computer gespeichert und sind somit als nicht sicher zu erachten. Wir empfehlen die Business Portal Website in den Einstellungen des Proxy-Servers auf die Whiteliste ohne Authentifizierung zu stellen. Wie kann ich den Root-Pfad des Viper Connector Service auf ein Netzwerklaufwerk legen? Der Viper Connector Service wird bei Installation als Lokaler Dienst unter dem Systemkonto gestartet. In diesem Kontext existieren für den Viper Connector Service keine Netzwerklaufwerke. Sie können ggf. einen UNC Pfad angeben, hierfür muss auf der Freigabe entweder das PC Domänenkonto des Servers eingetragen sein oder der Viper Connector Service muss unter einem Service-User mit passenden Rechten gestartet werden. Bitte beachten Sie, dass es bei einer solchen Installation zu zusätzlichen Fehlern aufgrund Ihrer Netzwerkstruktur kommen kann und kein Support geleistet werden kann. Der Viper Connector Service startet nicht automatisch, kann aber manuell gestartet werden. Wir kennen diesen Fehler aus Virtualisierten Umgebungen. Vermutlich ist nach einem Neustart Ihr Speichersystem überlastet und der Start des Viper Connector Service ist dadurch stark verzögert. Versuchen Sie, den Startmodus des Viper Connector Service auf Automatisch (Verzögerter Start) zu stellen. Sollte dies das Problem beheben raten wir Ihnen eine Performance-Analyse Ihrer Umgebung durchzuführen. Wo finde ich Log Dateien? Im Viper Connector Service finden Sie unter dem Root-Pfad für jeden Mandanten ein eigenes Log-Verzeichnis. Zusätzlich finden sie unter dem Installationspfad des Viper Connector Service ein Log-Verzeichnis, das Mandantenübergreifende Log Einträge schreibt. Der Viper Connector legt Log Dateien in Ihrem Benutzerprofil im unter %userprofile%\ ViperConnector\Upload\Logs ab. Hinweis zur Verwendung auf Windows XP und Server 2003 Da der Support für die Betriebssysteme Windows XP und Server 2003 ausgelaufen ist, gibt es keine weiteren Updates vom Hersteller Microsoft. Beide Betriebssysteme erhalten aus 36

diesem Grund insbesondere keine neuen Verschlüsselungsfunktionen wie sie im Internet eingesetzt werden (insbesondere TLS für https Webserver). Es kann daher sein, dass die Verbindung zu den Portalservern abgeschnitten wird wenn alte Standards als unsicher deklariert werden.

37