versiondog Upload & Compare Agents

Transkript

1 versiondog Upload & Compare Agents AUVESY GmbH Fichtenstraße 38 B D Landau Deutschland

2 Inhalt versiondog Upload & Compare Agents 3 Lizenzierung 5 Aufbau & Umfang 6 Funktionsweise 8 Anwendungsfälle 10 Agents installieren 14 Agents konfigurieren 16 Agents deinstallieren 19 2

3 versiondog Upload & Compare Agents Ein Agent ist ein weitgehend autonom arbeitendes Computerprogramm, das eine bestimmte Menge von Operationen im Auftrag eines Anwenders bzw. eines anderen Programms ausführt. Eingesetzt werden Agents überall da, wo häufig wiederkehrende Aufgaben zu erledigen sind oder auch große Informationsmengen verarbeitet werden müssen. Zu finden sind Agents beispielsweise im E-Commerce oder auch bei der Informationsrecherche. Im versiondog System finden Agents ebenfalls ihren Einsatzbereich. Mit der Hilfe von Agents kann das versiondog System um dezentrale Stellen für die Sicherung sowie für den Vergleich erweitert werden. Zur Verfügung stehen dafür folgende Agents: versiondog HMI Upload & Compare Agent Agent zur Sicherung und zum Vergleich von HMI Runtimes (im laufenden Betrieb). Aktuell erhältlich für WinCC (weitere HMIs auf Anfrage) versiondog Upload & Compare Agent Allgemeiner Agent zur Sicherung und zum Vergleich von Geräte- und Projektdaten. Der Agent ist universell für alle von versiondog unterstützten Geräte- und Datentypen einsetzbar und umfasst auch den Funktionsumfang des versiondog HMI Upload & Compare Agents In der Dokumentation erhalten Sie Informationen zum Einsatz von Upload & Compare Agents. Ziel der Dokumentation ist es, einem Anwender das notwendige Wissen zu vermitteln, damit er mit Upload & Compare Agents arbeiten kann. Grundwissen über die Konzepte des versiondog Systems und Netzwerkkenntnisse werden zum Verständnis vorausgesetzt. Für den Begriff Agent wird die englische Schreibweise gebraucht. Der Plural beispielsweise endet dadurch auf -s. Integrationsmerkmale Onlinesicherung von HMI Runtimes im laufenden Betrieb Dezentrale Jobausführung zur Leistungssteigerung und Lastverteilung während der Jobausführung Aufgabenverteilung und Parallelisierung 3

4 Vermeidet Editorinstallationen auf dem versiondog Hauptserver Vermeidet Auf- und Umrüstung der Hardware für den versiondog Hauptserver Vermeidet Editorinstallationen und Hardwareumrüstung auf Clients Automatisiertes SmartUpdate der Agents bei Serverupdates Online-Tutorial in versiondog Info verfügbar (neu ab 4.5) Letzte Aktualisierung: November

5 Lizenzierung versiondog HMI Upload & Compare Agent und versiondog Upload & Compare Agent gehören nicht zum Standardumfang des versiondog Systems. Sie werden über ein eigenes Setup installiert und eigens lizenziert. Lizenzen für versiondog HMI Upload & Compare Agent und versiondog Upload & Compare Agent sind gesondert zu erwerben. Sie sind in keinem versiondog Software-Paket inbegriffen. Eine Lizenz beinhaltet einen Upload Agent und einen Compare Agent. Upload Agent und Compare Agent können beide betrieben werden. Es kann aber auch nur ein Agent genutzt werden, also entweder der Upload Agent oder der Compare Agent. Vor der Installation müssen die Agents im versiondog System aktiviert werden. Die notwendigen Informationen dazu erhalten Sie mit Erwerb der Lizenzen. Details zum Thema Lizenzierung erfahren Sie über den Vertrieb von AUVESY. Kontaktdaten finden Sie unter "Kontaktinformationen & Rechtliche Hinweise" 5

6 Aufbau & Umfang Dezentrales Sichern und Vergleichen von Geräte- und Projektdaten erfolgt im versiondog System über die versiondog Backup & Compare Agents. versiondog Backup & Compare Agents gehören nicht zum Standardumfang des versiondog Systems. Beim Betrieb ist zu beachten, dass auf einem Rechner nie mehr als ein Upload Agent und ein Compare Agent zusammen eingesetzt werden können. Ist auf einem Rechner ein Agent aktiv, können keine weiteren Agents der gleichen Art auf dem Rechner betrieben werden. Auch sollten Agents nicht auf dem Server installiert werden. Upload Agents werden stellenweise auch als Backup Agents oder Speicheragents bezeichnet. Für Compare Agents findet sich noch die Bezeichnung Vergleichsagents. Im Folgenden ein Überblick über die verschiedenen Agents und ihre Funktionen. versiondog HMI Upload & Compare Agent Der versiondog HMI Upload & Compare Agent ist ein Agent zur Sicherung und zum Vergleich von HMI Runtimes (im laufenden Betrieb). Erhältlich ist er aktuell für WinCC (weitere HMIs auf Anfrage). Ein versiondog HMI Upload & Compare Agent setzt sich aus einem Upload Agent und einem Compare Agent zusammen. Die Aufgaben der einzelnen Agents sind wie folgt: Upload Agent Dezentrale Sicherung von HMI Runtimes (im laufenden Betrieb) Compare Agent Dezentraler Vergleich von HMI Runtimes versiondog Upload & Compare Agent Der versiondog Upload & Compare Agent ist ein allgemeiner Agent zur Sicherung und zum Vergleich von Geräte- und Projektdaten. Der Agent ist universell für alle von versiondog unterstützten Geräteund Datentypen einsetzbar und umfasst auch den Funktionsumfang des versiondog HMI Upload & Compare Agents. Ein versiondog Upload & Compare Agent setzt sich aus einem Upload Agent und einem Compare Agent zusammen. Die Aufgaben der einzelnen Agents sind wie folgt: Upload Agent Dezentrale Sicherung von Geräte- und Projektdaten 6

7 Compare Agent Dezentraler Vergleich von Geräte- und Projektdaten 7

8 Funktionsweise versiondog Upload & Compare Agents werden über ein eigenes Setup installiert und müssen vor dem Einsatz konfiguriert werden. Installiert wird ein Agent auf dem Client PC. Damit ein Agent nach der Installation mit dem versiondog- Server über TCP/IP kommunizieren und Aufgaben ausführen kann, müssen auf dem versiondog-server noch bestimmte Einstellungen konfiguriert werden. Die Einstellungen zur Konfiguration finden sich im versiondog AdminClient. Die Kommunikation wird über die Agent-Konfiguration eingerichtet. In der Agent-Konfiguration ist die IP-Adresse des Clients anzugeben, auf dem der Agent installiert ist und seine Aufgaben ausführen soll. Ferner sind die Ports anzugeben. Standard-Ports sind: Port für Upload Agents Port für Compare Agents Die Standard-Ports werden bei der Installation des versiondog Systems in der Firewall für die Agents freigeschaltet. Wenn die Ports nicht von anderen Applikationen blockiert werden, können sie für die Kommunikation ungeändert übernommen werden. Bei Bedarf können die Ports aber auch geändert werden. Die Änderungen der Ports erfolgt über die Datei Csc.ini (Pfad zur Datei: vdagentarchive\vd$a\configuration). Nach Änderungen in der Datei Csc.ini sind die Agent-Dienste neu zu starten! Die Aufgaben werden entweder manuell in einer Clientanwendung gestartet oder als Jobs angelegt. Im ersten Fall überträgt die Clientanwendung die für die Aufgabe benötigten Daten über den Server auf den Agent, der die Aufgabe ausführt und die Ergebnisse über den Server an die Anwendung zurück sendet. Beachten Sie dabei folgendes: In versiondog 4.5 können folgende Aufgaben aus den Clientanwendungen ausgelagert werden: Online/Online-Vergleich, Offline/Offline-Vergleich, Online/Offline-Vergleich, Vergleich des Arbeitsverzeichnisses 8

9 Die Kommunikation zwischen Clientanwendung und Compare Agent erfolgt nicht direkt, sondern immer über den versiondog-server. Das bedeutet, dass sowohl der Recher auf dem die Clientanwendung als auch der Recher auf dem der Agent installiert ist, für den Server erreichbar sein müssen. Daher können Compare Agents bei lokaler Anmeldung in der Clientanwendung und im BackupClient generell nicht verwendet werden Die Beschränkungen für die maximale Anzahl gleichzeitig ausführbarer Jobs und Vergleiche bezieht auch die Anzahl an Vergleichen mit ein, die von Clientanwendungen über Agents abgewickelt werden Die Ausführung von Clientskripten ist nicht möglich, wenn Aufgaben von einer Clientanwendung an einen Agent ausgelagert werden. Serverskripte werden normal ausgeführt Der Vergleich bei der Versionierung von Komponenten mit zugewiesenen Standardbausteinen kann nicht an einen Agent ausgelagert werden Im zweiten Fall wertet der zeitgesteuerte Arbeitsplaner des versiondog-servers die Konfiguration des Jobs aus und sendet zu den festgelegten Zeitpunkten einen Auftrag an den entsprechenden Agent. Dieser arbeitet den Auftrag ab, d. h., er sichert Daten und/oder führt einen Vergleich durch. Sobald der Agent seine Aufgabe erledigt hat, sendet er eine Nachricht an den versiondog-server, dass die entsprechenden Daten bereit stehen. Die Funktionsweise von versiondog HMI Upload & Compare Agents und versiondog Upload & Compare Agents ist gleich. 9

10 Anwendungsfälle Mit der Hilfe von Agents kann das versiondog System um dezentrale Stellen für die Sicherung sowie für den Vergleich erweitert werden. Im Folgenden eine Auswahl von möglichen Anwendungsfällen aus der Praxis. Fall 1: Online-Sicherung von HMI-Runtimes Situation: Sie wollen HMI-Runtimes im laufenden Betrieb (= online) sichern. Lösungsmöglichkeit: Sie lassen die Online-Sicherung über einen versiondog HMI Upload & Compare Agent laufen. Pro HMI-Station ist ein versiondog HMI Upload & Compare Agent erforderlich. Fall 2: Sichern und Vergleichen mit zusätzlicher Software Situation: Sie wollen ein Gerät sichern und/oder einen Vergleich durchführen. Dafür ist zusätzliche Software erforderlich, z. B. die entsprechende Entwicklungsumgebung für das Gerät. Für den Einsatz zusätzlicher Software gilt Folgendes: a. Die zusätzliche Software darf oder kann nicht auf dem Server/Client installiert werden b. Es sind unterschiedliche Versionen der zusätzlichen Software im Einsatz. Die unterschiedlichen Versionen können aber nicht gleichzeitig auf einem PC-System installiert werden c. Es gibt bestimmte Voraussetzungen für die Sicherung / den Vergleich, z.b. SQL- Datenbankserver, Sicherheitskonzepte, Firewall-Regeln,... Lösungsmöglichkeit: Sie verteilen die Aufgaben auf mehrere Systeme. Zur Verteilung der Aufgaben auf mehrere Systeme setzen Sie versiondog Upload & Compare Agents ein. Auf jedem System, das Aufgaben vom Server/Client übernimmt, muss ein versiondog Upload & Compare Agent installiert sein. Fall 3: Zeitgleiches Sichern und Vergleichen 10

11 Situation: Sie wollen auf einem System zeitgleich ein Gerät sichern und einen Vergleich durchführen. Dies ist jedoch nicht möglich, beispielsweise aus technischen Gründen, und es kann auf dem System immer nur genau eine Aktion ausgeführt werden. Erst nach Abschluss einer Aktion kann eine andere ausgeführt werden. Lösungsmöglichkeit: Sie verteilen die Aufgaben auf mehrere Systeme. Der Einsatz von versiondog Upload & Compare Agents ermöglicht eine Verteilung der Aufgaben auf mehrere Systeme. Die Aufgaben können parallel ausgeführt werden. Die Bearbeitungszeit reduziert sich, Ergebnisse werden schnell geliefert und die Last wird auf mehrere Systeme verteilt. Fall 4: Zugriff auf Systemressourcen, die nicht über das Netzwerk adressiert werden können Situation: Sie wollen auf Systemressourcen zugreifen, die nicht über das Netzwerk adressiert werden können. Beispiel: Sie wollen ein Automatisierungsgerät sichern, das vom versiondog-server nicht direkt über TCP/IP erreicht werden kann. Das Automatisierungsgerät ist über MPI oder PROFIBUS mit einem Visualisierungsgerät verbunden. Das Visualisierungsgerät wiederum kann vom versiondog-server direkt über TCP/IP erreicht werden. Lösungsmöglichkeit: Um Zugriff auf Systemressourcen zu erhalten, die nicht über das Netzwerk adressiert werden können, setzen Sie einen versiondog Upload & Compare Agent ein. Der Agent wird direkt auf dem System installiert, über das Zugang zu den gewünschten Ressourcen besteht. Im Beispielfall installieren Sie den Agent auf dem Visualisierungspanel, um Zugriff auf das Automatisierungsgerät zu erhalten. Fall 5: Übergang in ein BUS-System Situation: Der Übergang in ein BUS-System (MPI/Profibus/Profinet/Modbus/...) ist auf dem Server nicht möglich, z. B. weil der Server keine Schnittstellenkarte besitzt. Lösungsmöglichkeit: 11

12 Die Kommunikation ins BUS-System kann über einen Agent eingerichtet werden, der auf einem System mit der entsprechenden BUS-Schnittstelle installiert ist. Tabellarischer Überblick: Geräte-/Projektintegration Fall HMI Upload & Compare Agent Agent Upload & Compare 3S CODESYS 2a, 2b, 2c ABB Freelance 2a ABB Roboter 2a, 2b ATLAS COPCO 2a B&R Automation Studio 2a Beckhoff TwinCat 2a, 2b, 2c, 3 COPA-DATA zenon 2a FANUC CNC 2a, 2b GE Proficy ME 2a KUKA Roboter 2b Mitsubishi MELSOFT GX Works 2 2a, 2b Rockwell Automation RSLogix 5 2a Rockwell Automation RSLogix 500 2a Rockwell Automation RSLogix a, 2b Schneider Unity 2a, 2b, 3 SEW Movitools 2a, 2b,2c SICK Scanner 2a, 2c Siemens PCS7 2c Siemens S7 mit Simotion-Anteil 2c 12

13 Siemens TIA 2a, 2b, 2c Siemens WinCC 1, 2c, 4 Siemens WinCC flexible auf windowsbasierten PC-Systemen 1, 2c, 4 Stand: November 2016, versiondog 4.5 Grafischer Überblick: 13

14 Agents installieren Die Installation von Agents läuft über ein eigenes Setup. Die Setup-Datei für Agents ist standardmäßig in jedem versiondog Software-Paket enthalten. Der Name der Datei lautet AgentSetup.exe. Mit der Installation des versiondog-serversystems wird eine Netzwerkfreigabe erstellt, in der sich alle für den Client relevanten Setup-Dateien befinden. Die Datei AgentSetup.exe findet sich im Verzeichnis..\vdog agent setup. Über das Agent-Setup werden sowohl versiondog HMI Upload & Compare Agents als auch versiondog Upload & Compare Agents installiert. Voraussetzungen für die Installation: Die Agent-Lizenzierung ist erfolgt Die Agent-Setup-Datei ist zugänglich Wenn Sie die Datei nicht finden oder keinen Zugriff auf die Datei haben, wenden Sie sich an Ihren Systemadministrator Der Benutzer bzw. das Benutzerkonto, von dem aus die Installation durchgeführt wird, verfügt über Administratorrechte Die Installation kann nur über ein Benutzerkonto mit Administratorrechten durchgeführt werden Um einen Agent auf einem Client PC zu installieren, gehen Sie folgendermaßen vor: 1. Starten Sie das Setup auf dem Client PC (auch Agent PC genannt), beispielsweise über Doppelklick auf die Datei AgentSetup.exe 2. Im sich öffnenden Installationsassistent wählen Sie eine Sprachversion aus. Aktuell stehen Englisch und Deutsch zur Verfügung 3. Auf der Willkommensseite des Installationsassistenten klicken Sie auf Weiter, um mit der Installation zu beginnen 4. Geben Sie ein Verzeichnis für die Agent-Programmdateien und ein Verzeichnis für das Agentarchiv an. Das Verzeichnis kann direkt eingegeben oder über Selektion... ausgewählt werden. 14

15 AUVESY empfiehlt, die im Installationsassistenten vorgeschlagenen Pfade beizubehalten: C:\Programme\vdAgents D:\vdAgentArchive 5. Klicken Sie auf Weiter 6. Geben Sie das Benutzerkonto an, von dem die versiondog Dienste gestartet werden. Sie haben die Wahl zwischen den Optionen Systemkonto und Benutzername. AUVESY empfiehlt die Option Benutzername auszuwählen und ein Konto mit Administratorrechten auf dem Client PC anzugeben Die Installation kann nur über ein Benutzerkonto mit Administratorrechten durchgeführt werden. Das Systemkonto ist eventuell nicht mit den notwendigen Rechten ausgestattet 7. Klicken Sie auf Weiter Eine Zusammenfassung erscheint 8. Prüfen Sie Ihre Eingaben. Wenn alles korrekt ist, klicken Sie auf Weiter Das Setup wird ausgeführt. Der Abschluss des Installationsvorgangs wird über eine Meldung angezeigt 9. Klicken Sie auf Fertig stellen, um den Assistenten zu schließen Einmal installiert, werden die Agents automatisch aktualisiert, sobald der Server aktualisiert wird. Voraussetzung: Ein Agent-Dienst hat Lese- und Schreibrechte auf sein Applikationsverzeichnis. 15

16 Agents konfigurieren Damit ein Agent nach der Installation mit dem versiondog-server über TCP/IP kommunizieren und Aufgaben ausführen kann, müssen auf dem versiondog-server noch bestimmte Einstellungen konfiguriert werden. Die Einstellungen zur Konfiguration finden sich im versiondog AdminClient. Die Konfiguration ist für versiondog HMI Upload & Compare Agents und versiondog Upload & Compare Agents gleich. Um einen Agent zu konfigurieren, gehen Sie folgendermaßen vor: 1. Starten Sie den versiondog AdminClient und melden Sie sich mit dem Benutzernamen und dem Passwort am versiondog System an 2. Stellen Sie die Kommunikation zwischen Agent und versiondog-server her. Konfigurieren Sie dazu die notwendigen Einstellungen in der Agent-Konfiguration Einzelne Schritte a. Öffnen Sie im AdminClient das Modul Jobs b. Wählen Sie die Registerkarte Start c. Klicken Sie in der Gruppe Allgemein auf die Schaltfläche Agent-Konfiguration d. Klicken Sie im Dialog vd - Agent-Konfiguration auf die Schaltfläche Agent hinzufügen e. Wählen Sie die Option IP Adresse und geben Sie die IP-Adresse des Clients ein, auf dem der Agent installiert ist und seine Aufgaben ausführen soll. Wahlweise können Sie auch die Option Computername auswählen und den Namen des Clients eintragen, auf dem der Agent installiert ist und seine Aufgaben ausführen soll f. Aktivieren Sie die Option Port für Upload Agent und/oder Port für Compare Agent Sie können beide Agents einsetzen, müssen es aber nicht. Je nach Bedarf können Sie auch nur einen der beiden Agents einsetzen 16

17 g. Geben Sie den Port für den Compare Agent und/oder Port für den Upload Agent ein Standardmäßig vorgeblendet werden Port für den Upload Agent und Port für den Compare Agent. Die standardmäßig vorgeblendeten Ports werden bei der Installation des versiondog Systems in der Firewall für die Agents freigeschaltet. Wenn die Ports nicht von anderen Applikationen blockiert werden, können sie für die Kommunikation ungeändert übernommen werden h. Speichern Sie die Einstellungen ab und schließen Sie den Dialog 3. Agents auswählen a. Agents für Jobs auswählen Einzelne Schritte a. Erstellen Sie einen neuen Job und konfigurieren Sie ihn oder wählen Sie einen bestehenden Job aus, für den Sie Agents hinzufügen wollen b. Wählen Sie im Abschnitt Upload und Vergleich den Upload und/oder den Compare Agent aus, der die entsprechenden Aufgaben übernehmen soll c. Führen Sie den Job einmalig aus b. Compare Agent im UserClient auswählen Einzelne Schritte a. Öffnen Sie den UserClient 17

18 b. Klicken Sie im Kontextmenü der Komponente, für die Sie einen Compare Agent auswählen wollen auf Compare Agent auswählen c. Wählen Sie im Dialog Compare Agent auswählen den Compare Agent aus, der die entsprechenden Aufgaben übernehmen soll und klicken Sie auf OK Die Einstellung für den Vergleich einer Komponente per Agent wird über den Server an alle Clients verteilt und in Parallelserververbänden zwischen beiden Servern synchronisiert. Um Inkonsistenzen zu vermeiden kann der Dialog Compare Agent auswählen immer nur in einem UserClient gleichzeitig geöffnet werden. Ist er bereits in einem anderen UserClient geöffnet, wird eine Fehlermeldung angezeigt. 18

19 Agents deinstallieren Für Agents gibt es keine automatische Deinstallationsroutine. Im Folgenden finden Sie eine Beschreibung, wie Sie Agents deinstallieren können. Um einen Agent auf einem Client PC zu deinstallieren, gehen Sie folgendermaßen vor: 1. Öffnen Sie die Windows Eingabeaufforderung über Start/Alle Programme/Zubehör/Eingabeaufforderung Die Eingabeaufforderung wird auch als Kommandozeilenfenster bezeichnet. Es gibt verschiedene Möglichkeiten, die Windows Eingabeaufforderung zu öffnen. Die aufgeführte Möglichkeit zum Öffnen der Windows Eingabeaufforderung bezieht sich auf das Betriebssystem Windows 7 2. Wählen Sie das Verzeichnis für die Agent-Programmdateien aus Einzelne Schritte a. Geben Sie folgenden Befehl ein: cd <Laufwerk:>\<Pfad>\<Agent-Programmverzeichnis> Beispiel: Liegen die Agent-Programmdateien unter C:\Programme\vdAgents, geben Sie folgenden Befehl ein: cd C:\Programme\vdAgents b. Drücken Sie die Eingabetaste 3. Stoppen Sie die Agentdienste Einzelne Schritte a. Stoppen Sie den Dienst für den Upload Agent, indem Sie folgenden Befehl eingeben: VDogUploadAgent.exe /rd:<laufwerk:>\<pfad>\<agentarchiv-verzeichnis> /at:s /deinstall Beispiel: Liegt das Agentarchiv unter D:\vdAgentArchive, geben Sie folgenden Befehl ein: VDogUploadAgent.exe /rd:d:\vdagentarchive /at:s /deinstall b. Drücken Sie die Eingabetaste 19

20 c. Stoppen Sie den Dienst für den Compare Agent, indem Sie folgenden Befehl eingeben: VDogCompareAgent.exe /rd:<laufwerk:>\<pfad>\<agentarchiv-verzeichnis> /at:s /deinstall Beispiel: Liegt das Agentarchiv unter D:\vdAgentArchive, geben Sie folgenden Befehl ein: VDogCompareAgent.exe /rd:d:\vdagentarchive /at:s /deinstall d. Drücken Sie die Eingabetaste 4. Schließen Sie die Eingabeaufforderung 5. Löschen Sie die Datei Csc.ini im Verzeichnis <Laufwerk:>\vdAgentArchive\VD$A\Configuration 6. Löschen Sie die Datei licence.bin im Verzeichnis <Laufwerk:>\vdAgentArchive\VD$A\Configuration 7. Löschen Sie das Verzeichnis für die Agent-Programmdateien Beispiel: Liegen die Agent-Programmdateien unter C:\Programme\vdAgents, löschen Sie dort das Verzeichnis vdagents 20