KUKA System Technology

[Link] 1.0
[Link] 1.1
Für KUKA System Software 8.3, 8.5, 8.6 und 8.7
Für VW System Software 8.3, 8.6 und 8.7

Stand: 07.09.2023
[Link] 1.1 V7
KUKA Deutschland GmbH
[Link] 1.0 [Link] 1.1

© Copyright 2023
KUKA Deutschland GmbH
Zugspitzstraße 140
D-86165 Augsburg
Deutschland

Diese Dokumentation darf – auch auszugsweise – nur mit ausdrücklicher Genehmigung der
KUKA Deutschland GmbH vervielfältigt oder Dritten zugänglich gemacht werden.
Es können weitere, in dieser Dokumentation nicht beschriebene Funktionen in der Steuerung
lauffähig sein. Es besteht jedoch kein Anspruch auf diese Funktionen bei Neulieferung oder im
Servicefall.
Wir haben den Inhalt der Druckschrift auf Übereinstimmung mit der beschriebenen Hard- und
Software geprüft. Dennoch können Abweichungen nicht ausgeschlossen werden, so dass wir für
die vollständige Übereinstimmung keine Gewähr übernehmen. Die Angaben in dieser Druck-
schrift werden jedoch regelmäßig überprüft und notwendige Korrekturen sind in der nachfolgen-
den Auflage enthalten.
Technische Änderungen ohne Beeinflussung der Funktion vorbehalten.
KIM-PS5-DOC
Original-Dokumentation

Publikation: Pub [Link] 1.1 (PDF) de

PB9944

Buchstruktur: [Link] 1.1 V5.1

BS9275

Version: [Link] 1.1 V7

2/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Inhaltsverzeichnis

1 Einleitung.................................................................................................. 5
1.1 Zielgruppe.............................................................................................................. 5
1.2 Dokumentation des Industrieroboters................................................................... 5
1.3 Darstellung von Hinweisen.................................................................................... 5
1.4 Marken................................................................................................................... 6
1.5 Verwendete Begriffe.............................................................................................. 6

2 Produktbeschreibung.............................................................................. 7
2.1 Produktbeschreibung............................................................................................. 7
2.1.1 ScatterJob.............................................................................................................. 7
2.1.2 ScatterPackage...................................................................................................... 7
2.2 [Link]....................................................................... 7
2.3 Bestimmungsgemäße Verwendung....................................................................... 8

3 Sicherheit.................................................................................................. 9
3.1 Betriebsarten des Roboters.................................................................................. 9

4 Installation................................................................................................ 11
4.1 Systemvoraussetzungen........................................................................................ 11
4.2 [Link] von der Steuerung kopieren.......................................................... 11

5 Konfiguration............................................................................................ 13
5.1 UpdateNotificationConfiguration............................................................................ 13

6 Bedienung................................................................................................. 15
6.1 Bedienung über Scatter........................................................................................ 15
6.1.1 [Link] Menü.............................................................................................. 15
6.1.2 ScatterJob erstellen............................................................................................... 16
[Link] Aufbau eines ScatterJobs..................................................................................... 16
[Link] ScatterJob aus Vorlage erstellen.......................................................................... 18
[Link] ScatterJob ohne Vorlage erstellen........................................................................ 18
6.1.3 Aufträge an die Steuerung schicken.................................................................... 19
[Link] Pakete über [Link] an eine Steuerung schicken..................................... 19
[Link] ScatterJob/ScatterPackage über [Link] an eine Steuerung schicken.... 19
[Link] ScatterJob/ScatterPackage manuell starten......................................................... 20
[Link] Software-Pakete deinstallieren.............................................................................. 20
6.2 Bedienung über Kommandozeilen........................................................................ 21
6.2.1 [Link] Hilfe................................................................................................ 21
6.2.2 Allgemeine Scatter-Kommandos........................................................................... 21
6.2.3 ScatterJob erstellen............................................................................................... 22
[Link] Parameter zu createjob......................................................................................... 22
6.2.4 ScatterPackage erstellen....................................................................................... 23
[Link] Parameter zu createpackage................................................................................ 24
6.2.5 Skript erstellen....................................................................................................... 25
[Link] Dateien für ein Skript............................................................................................ 26
6.2.6 Checksumme berechnen....................................................................................... 26
[Link] Parameter zu computechecksum.......................................................................... 27
6.2.7 Pakete über Kommandozeilen an eine Steuerung senden................................. 27

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 3/52

[Link] 1.0 [Link] 1.1

6.2.8 ScatterJob/ScatterPackage über Kommandozeilen an eine Steuerung schi-

cken....................................................................................................................... 27
[Link] Parameter zu execute........................................................................................... 28
6.2.9 ScatterJob/ScatterPackage über Kommandozeilen an mehrere Steuerungen
schicken................................................................................................................. 31
[Link] Parameter zu executemany.................................................................................. 32
6.2.10 ScatterJob/ScatterPackage manuell starten......................................................... 33
[Link] Parameter zu forcestart......................................................................................... 33
6.2.11 ScatterPackage über Kommandozeilen deinstallieren......................................... 34
[Link] Parameter zu remove............................................................................................ 35
6.2.12 Meldung zum Returncode anzeigen..................................................................... 36
6.3 [Link]....................................................................... 36
6.3.1 Bedien- und Systembedingungen konfigurieren................................................... 36
[Link] Aufbau einer Konfiguration zur Update-Freigabe................................................. 37
[Link] Aufbau der Konfiguration der Systembedingungen.............................................. 38
[Link] Bedienbedingungen über XML-Datei konfigurieren.............................................. 39
[Link] Systembedingungen über XML-Datei konfigurieren............................................. 40
6.3.2 Auftrag an der Steuerung bestätigen................................................................... 41
6.3.3 Auftrag an der Steuerung starten......................................................................... 41

7 Meldungen................................................................................................ 43
7.1 Systemmeldungen aus Modul: UpdateService..................................................... 43
7.1.1 UpdateService 00019............................................................................................ 43
7.1.2 UpdateService 00020............................................................................................ 43

8 Fehlerbehebung....................................................................................... 47
8.1 Verbindung von Laptop/PC zu Steuerung nicht möglich..................................... 47
8.2 ScatterJob senden nicht möglich.......................................................................... 47

9 KUKA Service........................................................................................... 49
9.1 Support-Anfrage..................................................................................................... 49
9.2 KUKA Customer Support...................................................................................... 49

Index 51

4/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Einleitung
1 Einleitung

1.1 Zielgruppe

Diese Dokumentation richtet sich an Benutzer mit folgenden Kenntnissen:

• Systemkenntnisse der Robotersteuerung
• Fortgeschrittene Kenntnisse des Windows-Betriebssystems
• Kenntnisse im Umgang mit Kommandozeilen-Tools

Für den optimalen Einsatz der KUKA Produkte empfehlen wir Schulun-
gen im KUKA College. Informationen zum Schulungsprogramm sind un-
ter [Link] oder direkt bei den Niederlassungen zu finden.

1.2 Dokumentation des Industrieroboters

Die Dokumentation zum Industrieroboter besteht aus folgenden Teilen:

• Dokumentation für die Robotermechanik

• Dokumentation für die Robotersteuerung
• Dokumentation für das smartPAD-2 oder smartPAD pro (wenn verwen-
det)
• Dokumentation für die Systemsoftware
• Anleitungen zu Optionen und Zubehör
• Ersatzteilübersicht in KUKA Xpert
Jede Anleitung ist ein eigenes Dokument.

1.3 Darstellung von Hinweisen

Sicherheit

Diese Hinweise dienen der Sicherheit und müssen beachtet werden.

GEFAHR
Diese Hinweise bedeuten, dass Tod oder schwere Verletzungen sicher
oder sehr wahrscheinlich eintreten werden, wenn keine Vorsichtsmaß-
nahmen getroffen werden.

WARNUNG
Diese Hinweise bedeuten, dass Tod oder schwere Verletzungen eintre-
ten können, wenn keine Vorsichtsmaßnahmen getroffen werden.

VORSICHT
Diese Hinweise bedeuten, dass leichte Verletzungen eintreten können,
wenn keine Vorsichtsmaßnahmen getroffen werden.

HINWEIS
Diese Hinweise bedeuten, dass Sachschäden eintreten können, wenn
keine Vorsichtsmaßnahmen getroffen werden.

Diese Hinweise enthalten Verweise auf sicherheitsrelevante Informatio-

nen oder allgemeine Sicherheitsmaßnahmen.
Diese Hinweise beziehen sich nicht auf einzelne Gefahren oder einzelne
Vorsichtsmaßnahmen.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 5/52

 [Link] 1.0 [Link] 1.1

Dieser Hinweis macht auf Vorgehensweisen aufmerksam, die der Vorbeu-

Einleitung

gung oder Behebung von Not- oder Störfällen dienen:

SICHERHEITSANWEISUNG
Die folgende Vorgehensweise genau einhalten!

Mit diesem Hinweis gekennzeichnete Vorgehensweisen müssen genau

eingehalten werden.

Hinweise

Diese Hinweise dienen der Arbeitserleichterung oder enthalten Verweise

auf weiterführende Informationen.
Hinweis zur Arbeitserleichterung oder Verweis auf weiterführende Infor-
mationen

1.4 Marken

.NET Framework 4.6.1 ist eine Marke der Microsoft Corporation

Windows ist eine Marke der Microsoft Corporation.

1.5 Verwendete Begriffe

Begriff Beschreibung
AUT Automatikbetrieb
AUT EXT Automatikbetrieb Extern
KRL KUKA Roboter Programmiersprache (KUKA Robot
Language)
KSS KUKA System Software
T1 Test-Betriebsart Manuell Reduzierte Geschwindig-
keit (<= 250 mm/s)
T2 Test-Betriebsart Manuell Hohe Geschwindigkeit (>
250 mm/s erlaubt)
VSS VW System Software

6/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Produktbeschreibung
2 Produktbeschreibung

2.1 Produktbeschreibung

Beschreibung

[Link] ist ein Optionspaket, mit der die Verwaltung der

Software auf einer Robotersteuerung über einen PC ermöglicht wird. Das
Optionspaket besteht aus zwei Teilen, dem Service und einem Komman-
dozeilentool zum Verteilen der Aufträge. Der Windowsservice [Link]-
teService ist auf der Steuerung vorinstalliert und sorgt für die korrekte
Ausführung des Auftrags. Das Kommandozeilen-Tool [Link] sendet
Aufträge an eine oder mehrere Steuerungen.

Funktionen

[Link] übernimmt folgende Funktionen:

• Installation, Update oder Deinstallation von KSS-, VSS- und Techpake-
ten und Skripten
• SelfUpdate, d. h. Update des [Link] ohne Unterbre-
chung der KSS bzw. VSS
[Link] übernimmt folgende Funktionen:
• Senden von Installations-, Update-, oder Deinstallations-Aufträgen an
eine oder mehrere Steuerungen
• Installations-, Update- oder Deinstallationspakete erstellen
• Monitoring, d. h. Updateverlauf einer Steuerung beobachten

2.1.1 ScatterJob

Ein ScatterJob ist eine Liste von Anweisungen. Wird ein ScatterJob an ei-
ne oder mehrere Steuerungen geschickt, wird zuerst das Paket herunter-
geladen und anschließend die Anweisung ausgeführt. Die
Programmierung des Jobs erfolgt in dem Dateiformat Json. Ein ScatterJob
kann auch in XML geschrieben werden.

2.1.2 ScatterPackage

Ein ScatterPackage enthält eine ScatterJob-Datei und alle zu installieren-

den bzw. zu deinstallierenden Software-Pakete. Ein ScatterPackage ent-
hält folglich alle Informationen, um einen Auftrag auszuführen.

2.2 [Link]

[Link] ist ein Optionspaket, das zusätzlich

zum [Link] angeboten wird. Das Optionspaket ist eine Er-
weiterung des [Link], die Plugins und Meldungen auf dem
smartPAD liefert. [Link] ist auf der Steuerung
vorinstalliert.
[Link] ist für die KUKA System Software
8.3 und die VW System Software 8.3 nicht verfügbar.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 7/52

Produktbeschreibung [Link] 1.0 [Link] 1.1

2.3 Bestimmungsgemäße Verwendung

Bestimmungsgemäße Verwendung

Das Optionspaket [Link] ist ausschließlich zur Software-In-

stallation und Deinstallation auf KR C4- oder KR C5-Steuerungen be-
stimmt. Das Optionspaket [Link] darf ausschließlich unter
den spezifizierten Systemvoraussetzungen betrieben werden.

Fehlanwendung

Alle von der bestimmungsgemäßen Verwendung abweichenden Anwen-

dungen gelten als Fehlanwendung und sind unzulässig. Für Schäden, die
aus einer Fehlanwendung resultieren, haftet die KUKA Deutschland GmbH
nicht. Das Risiko trägt allein der Betreiber.
Zu den Fehlanwendungen zählen z. B.:
• Einspielen von nicht verifizierten Software-Paketen
• Verpasste Sicherstellung eines erfolgreichen Software-Updates
• Betreiben von [Link] unter anderen als den spezifizier-
ten Systemvoraussetzungen

8/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Sicherheit
3 Sicherheit
Diese Dokumentation enthält Sicherheitshinweise, die sich spezifisch auf
das hier beschriebene Produkt beziehen. Die grundlegenden Sicherheitsin-
formationen zum Industrieroboter sind im Kapitel "Sicherheit" der Betriebs-
anleitung oder Montageanleitung für die Robotersteuerung zu finden.
Sicherheitsrelevante Informationen beachten
Die sichere Nutzung dieses Produkts erfordert die Kenntnis und Einhal-
tung grundlegender Sicherheitsmaßnahmen. Tod, schwere Verletzungen
oder Sachschäden können sonst die Folge sein.
• Das Kapitel "Sicherheit" in der Betriebs- oder Montageanleitung der
verwendeten Robotersteuerung muss beachtet werden.

3.1 Betriebsarten des Roboters

Damit ein ScatterJob oder ein ScatterPackage auf einer Steuerung ausge-
führt werden kann, muss der Roboter unbewegt sein. Die folgende Tabelle
gibt die Betriebsarten und die jeweilige Voraussetzung für die Ausführung
eines ScatterJobs oder eines ScatterPackages an.
Betriebsart Bedingung
T1 Der Roboter ist im T1-Betrieb und der Benutzer
ist mit dem Benutzerrecht der Funktionsgruppe
Allgemeine Konfigurationen. Über [Link]-
teServiceConfiguration wird eine Benutzerbe-
stätigung abgefragt. Der Benutzer kann den
Auftrag bestätigen, ablehnen oder auf einen
anderen Zeitpunkt verschieben.
AUT Der Roboter ist im Automatikbetrieb und steht
still. Das angewählte Programm muss angehal-
ten sein, der Roboter-Interpreter befindet sich
am Ende des Programms oder es ist kein Pro-
gramm angewählt.
AUT EXT Der Roboter ist im Automatikbetrieb und steht
still. Das angewählte Programm muss angehal-
ten sein, der Roboter-Interpreter befindet sich
am Ende des Programms oder es ist kein Pro-
gramm angewählt.

Die Voraussetzungen für die Ausführung eines ScatterJobs oder eines

ScatterPackages können für jede Steuerung angepasst werden. So kön-
nen auch die Betriebsarten angepasst werden, in denen die aus Ausfüh-
rung eines Auftrags möglich ist:
(>>> [Link] "Aufbau einer Konfiguration zur Update-Freigabe" Sei-
te 37)
(>>> [Link] "Aufbau der Konfiguration der Systembedingungen" Sei-
te 38)

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 9/52

Sicherheit [Link] 1.0 [Link] 1.1

10/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Installation
4 Installation

4.1 Systemvoraussetzungen

Hardware

• Robotersteuerung KR C4 oder KR C5

Software

Robotersteuerung
• KUKA System Software 8.3
oder
• KUKA System Software 8.5
oder
• KUKA System Software 8.6
oder
• KUKA System Software 8.7
oder
• VW System Software 8.3
oder
• VW System Software 8.6
oder
• VW System Software 8.7
Laptop/PC
• Windows 7 oder höher
• .NET Framework 4.6.1

4.2 [Link] von der Steuerung kopieren

Beschreibung

[Link] ist auf der KSS oder VSS vorinstalliert. Lediglich bei
KSS 8.3 und VSS 8.3 ist eine manuelle Installation erforderlich.
[Link] muss auf den Laptop/PC kopiert werden, um die Scatter-
Jobs oder ScatterPackages zu erstellen und verschicken.

Voraussetzungen

• Steuerung ist hochgefahren.

• Benutzerrechte: Funktionsgruppe Kritische Konfigurationen
• USB-Tastatur liegt vor

Vorgehensweise

1. USB-Tastatur am smartPad anschließen.

2. Im Menü über die Inbetriebnahme > Service > HMI minimieren
smartHMI minimieren.
smartHmi wird minimiert, sodass zur Windows-Ebene gewechselt wird.
3. Windows Explorer öffnen.
4. Den Dateipfad C:\KUKA\Tools öffnen und den Ordner Scatter markie-
ren.
5. Den Ordner über die Menüfolge Datei > Kopieren kopieren.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 11/52

Installation [Link] 1.0 [Link] 1.1

6. Zielverzeichnis öffnen.
7. Den Ordner über die Menüfolge Datei > Einfügen einfügen.
8. Den Ordner "Scatter" auf dem Laptop/PC ablegen.

12/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Konfiguration
5 Konfiguration

5.1 UpdateNotificationConfiguration

In der [Link] können Meldungen definiert

werden, die in das Logbuch der Steuerung geschrieben werden. Zu jeder
Meldung kann zusätzlich ein "Setter" für ein SPS-Signal bzw. ein Aus-
gangssignal gesetzt werden.
Die [Link] ist auf der Steuerung unter dem
folgenden Pfad abgelegt:
• C:\ KRC\ROBOTER\Config\System\Common\

Die UpdateNotificationConfiguration ist Teil der UpdateServiceConfigura-

tion. Nur wenn die UpdateServiceConfiguration installiert ist, ist die
Datei verfügbar und verwendbar.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 13/52

Konfiguration [Link] 1.0 [Link] 1.1

14/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
6 Bedienung

6.1 Bedienung über Scatter

6.1.1 [Link] Menü

[Link] wird über das Kommandozeilen-Tool [Link]

bedient. Das Kommandozeilen-Tool [Link] bietet die Bedienung
per Skript über Kommandozeilenparameter und per Kommandozeilenme-
nü. Sämtliche Befehle und Aufträge können auch in einem externen Kom-
mandozeilen-Tool erstellt werden (>>> 6.2.1 "[Link] Hilfe" Sei-
te 21).
Es können einzelne ScatterJobs oder ScatterPackages gesendet werden.
Ein ScatterJob enthält sämtliche Befehle und eine Angabe, wo die Soft-
ware oder das Update abgelegt ist. Bei einem ScatterPackage ist neben
dem ScatterJob die zu installierende Software oder das zu installierende
Update im Paket enthalten.

Abb. 6-1: [Link] Startmenü

Menüpunkt Beschreibung
UpdateJobs Anzeige aller abgeschlossenen, laufenden und
anstehenden Aufträge.
Packages Öffnet ein Untermenü zur Verwaltung und Vor-
abverteilung der Pakete.
Execute ScatterJobs, ScatterPackages und Pakete (zip-
oder kop-Dateien), die im Ordner "\Packages"
abgelegt sind, werden angezeigt und können
direkt von hier an die verbundene Steuerung
geschickt werden.
Monitor Statusanzeige aktuell laufender ScatterJobs.
Settings Öffnet ein Untermenü, in dem Einstellungen
vorgenommen werden können.
Change destination Öffnet Untermenü, um die Verbindung zu ande-
ren Steuerungen aufzubauen.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 15/52

Bedienung [Link] 1.0 [Link] 1.1

Menüpunkt Beschreibung
Templates Öffnet ein Untermenü mit Vorlagen für Scatter-
Jobs. Durch Doppelklicken wird die jeweilige
Vorlage geöffnet und in den Ordner "\Pack-
ages" kopiert.
Exit Beendet das Kommandozeilentool.

Des Weiteren steht die Funktion ExecuteMany zur Verfügung, um einen

ScatterJob oder ein ScatterPackage an mehrere Steuerungen auf ein-
mal zu verschicken (>>> 6.2.8 "ScatterJob/ScatterPackage über Kom-
mandozeilen an eine Steuerung schicken" Seite 27). Diese Funktion ist
allerdings ausschließlich über eine Parametereingabe in einem externen
Kommandozeilen-Tool möglich.

6.1.2 ScatterJob erstellen

[Link] Aufbau eines ScatterJobs

Der Aufbau eines ScatterJobs kann dem folgenden Beispiel entnommen

werden.
Das folgende Beispiel zeigt den Aufbau eines ScatterJobs in einer json-
Datei. Ein ScatterJob kann ebenso in einer XML-Datei abgelegt werden.
Der Aufbau des ScatterJobs in einer XML-Datei kann der Vorlage ent-
nommen werden. Weitere Informationen zu dem Erstellen eines Scatter-
Jobs mit aus einer Vorlage sind dem folgenden Abschnitt zu entnehmen
(>>> [Link] "ScatterJob aus Vorlage erstellen" Seite 18).

{
"Instructions": [
{
"PackageName": "SamplePackage_1",
"PackageType": "script",
"Condition": "IsInstalled AND (InstalledVersion < '1.0')",
"ErrorBehaviour": "ContinueExecuting",
"RestartBehaviour": "AfterPackage",
"Package": {
"Version": "1.0",
"DownloadURL": "D:\\SamplePackage_1.zip",
"PackageFormat": "zip",
}
},
{
"PackageName": "SamplePackage_2",
"PackageType": "option",
"Condition": "InstalledVersion <> '[Link]'",
"UpgradeStrategy": "CleanInstall",
"RestartBehaviour": "AfterJob",
"Package": {
"Version": "[Link]",
"DownloadURL": "D:\\SamplePackage_2.zip",
"PackageFormat": "zip",
"ChecksumType": "Sha1",
"Checksum": "5b862caddbdba156646d6a8b8d9d55d49f2e87cd"
}
}
],
"Attributes": {"Force": "true"},

16/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
"StartType": "Automatic",
"ScheduledStartTime": "0001-01-01T[Link]"
}

Zeile Beschreibung
Instructions Ab dieser Zeile werden alle zu installierenden, aktualisierende oder
deinstallierende Pakete aufgeführt.
PackageName Angabe des Paketnamens
PackageType Angabe des Typs des Pakets. Folgende Pakettypen werden unter-
stützt:

• msi
• kss
• option
KOP-Dateien werden für KSS 8.3 und VSS 8.3 nicht unterstützt.
• script: .bat, .exe, .VBS, .PS1
DesiredAction Angabe der gewünschte Aktion. Folgende Aktionen können
ausgeführt werden:

• install: installieren und updaten

• uninstall: deinstallieren
Condition Angabe der Bedingungen für die Ausführung des Jobs. Es sind kom-
plexe Ausdrücke mit C++- und KRL-Operatoren möglich.
Außerdem stehen die folgenden Parameter zur Verfügung:

• IsInstalled: Prüft, ob die Software installiert ist.

• InstalledVersion: Prüft, ob die angegebene Software-Version
installiert ist.
Wird keine Bedingung angegeben, wird der Job unabhängig davon
ausgeführt, ob die entsprechende Version schon installiert ist.
UpgradeStrategy Angabe der Strategie bei Ausführung des Jobs. Folgende Strategien
können ausgeführt werden:

• KeepExistingData: vorhandene Daten behalten

• CleanInstall: vorhandene Daten löschen und zurücksetzen
ErrorBehaviour Angabe des Installationsverhaltens in einem Fehlerfall. Folgende In-
stallationsverhalten können installiert werden:

• StopExecuting: Ausführung des Jobs wird angehalten

• ContinueExecuting: Ausführung des Jobs wird fortgesetzt
RestartBehaviour Definiert den Zeitpunkt zu dem das Sytem neu gestartet wird:

• AfterPackage: der Systemneustart findet nach der Installation

des aktuellen Pakets statt.
• AfterJob: der Systemneustart wird nach der Installation sämtli-
cher Pakete durchgeführt.
Package Ab dieser Zeile werden die Informationen zu dem zu installierenden
bzw. zu deinstallierenden Software-Paket gegeben.
Version Angabe der Version des Pakets
DownloadURL Angabe des Speicherorts des Pakets. Es können lokale und Server-
Pfade angegeben werden.
PackageFormat Angabe des Dateiformats für das Paket.
ChecksumType Angabe des Checksummen-Typs.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 17/52

Bedienung [Link] 1.0 [Link] 1.1

Zeile Beschreibung
Checksum Angabe der tatsächlichen Checksumme.
Attributes Angabe von Attributen mit Wert.
Diese können als Bedingungen für die Update-Freigabe genutzt wer-
den.
(>>> 6.3.1 "Bedien- und Systembedingungen konfigurieren" Seite 36)
StartType Angabe, wie der Job gestartet werden soll. Folgende Möglichkeiten
für den Start eines Jobs stehen zur Verfügung:

• Automatic: Der Job wird sofort gestartet.

• Manual: Der Job wird durch einen manuellen Trigger gestartet.
(>>> [Link] "ScatterJob/ScatterPackage manuell starten" Sei-
te 20)
• Scheduled: Der Job wird zeitgesteuert gestartet.
ScheduledStartTime Zeitangabe für die zeitgesteuerte Ausführung des Jobs.

[Link] ScatterJob aus Vorlage erstellen

Beschreibung

Um einen ScatterJob zu erstellen, kann eine Vorlage aus dem

[Link] verwendet werden.

Voraussetzung

• [Link] ist geöffnet.

Vorgehensweise

1. Im Menü von [Link] Menüpunkt Templates öffnen.

2. Eine Vorlage auswählen und mit Doppelklick oder der Return-Taste be-
stätigen.
Die Vorlage wird automatisch in den Ordner "\Packages" kopiert.
3. Vorlage aus dem Ordner "\Packages" in einem Editor öffnen und die
Vorlage nach Wunsch ausfüllen und bearbeiten.
Die Anweisungen für einen ScatterJob sind in (>>> [Link] "Aufbau ei-
nes ScatterJobs" Seite 16) beschrieben. Weitere Informationen zu den
Scatter-Kommandos sind der Hilfe zu entnehmen
(>>> 6.2.1 "[Link] Hilfe" Seite 21).
4. ScatterJob speichern.

[Link] ScatterJob ohne Vorlage erstellen

Beschreibung

Im Folgenden wird beschrieben, wie ein ScatterJob ohne Verwendung ei-

ner Vorlage erstellt wird.

Voraussetzung

• [Link] ist geöffnet.

Vorgehensweise

1. Editor öffnen.
2. ScatterJob anlegen.

18/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Die Anweisungen für einen ScatterJob sind in (>>> 2.1.1 "ScatterJob"

Bedienung
Seite 7) beschrieben. Weitere Informationen zu den Scatter-Komman-
dos sind der Hilfe zu entnehmen (>>> 6.2.1 "[Link] Hilfe" Sei-
te 21).
3. ScatterJob in den Ordner "\Packages" speichern.
4. ScatterJob speichern.

6.1.3 Aufträge an die Steuerung schicken

[Link] Pakete über [Link] an eine Steuerung schicken

Beschreibung

Wenn die Verbindung zu einer Steuerung hergestellt ist, können Pakete

über [Link] an die Steuerung geschickt werden, ohne dass der
Auftrag ausgeführt wird.
Wenn ein Paket bereits auf die Steuerung hochgeladen wurde, wird die-
ses bei der Ausführung des ScatterJobs nicht noch einmal gesendet.

Voraussetzung

• [Link] ist geöffnet.

• Verbindung zu gewünschter Steuerung ist hergestellt.
• Paket ist im Ordner "\Packages" gespeichert.

Vorgehensweise

1. Den Menüpunkt Package > Provide Packages öffnen.

2. Paket, das an die Steuerung geschickt werden soll, auswählen und
mit Doppelklick oder der Eingabe-Taste bestätigen.
Das Paket wird an die Steuerung geschickt. Es erfolgt keine Installati-
on und kein Update. Wird ein ScatterJob über das Kommando an die
Stuerung gesendet, werden die verlinkten Pakete an die Steuerung
gesendet, der Auftrag wird aber nicht ausgeführt.

[Link] ScatterJob/ScatterPackage über [Link] an eine Steuerung schi-

cken

Beschreibung

Wenn die Verbindung zu einer Steuerung hergestellt ist, können Scatter-

Jobs oder ScatterPackages über [Link] an die Steuerung ge-
schickt werden.

Voraussetzung

• [Link] ist geöffnet.

• Verbindung zu gewünschter Steuerung ist hergestellt.
• ScatterJob oder ScatterPackage ist im Ordner "\Packages" gespei-
chert.

Vorgehensweise

1. Den Menüpunkt Execute öffnen.

2. Auszuführenden ScatterJob oder auszuführende ScatterPackage aus-
wählen und mit Doppelklick oder der Eingabe-Taste bestätigen.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 19/52

 [Link] 1.0 [Link] 1.1

Die Installation oder das Update wird gemäß den gesetzten Parame-
Bedienung

tern ausgeführt.
Während ein Auftrag über Scatter auf einer Steuerung ausgeführt
wird, leuchtet die grüne LED und blinken die beiden weißen LEDs
an dem KUKA System Panel.
Weitere Informationen sind der Betriebsanleitung der jeweiligen Ro-
botersteuerung zu entnehmen.

[Link] ScatterJob/ScatterPackage manuell starten

Beschreibung

Im ScatterJob kann hinterlegt werden, dass ein ScatterJob manuell gestar-

tet werden soll. Wenn die Verbindung zu einer Steuerung hergestellt ist
und ein ScatterJob nicht automatisch oder zeitgesteuert gestartet wird,
kann der ScatterJob manuell gestartet werden.

Voraussetzung

• [Link] ist geöffnet.

• Verbindung zu gewünschter Steuerung ist hergestellt.

Vorgehensweise

1. Den Menüpunkt UpdateJobs öffnen.

Eine Liste der abgeschlossenen, laufenden und anstehenden Scatter-
Jobs wird geöffnet.
2. Auszuführenden ScatterJob auswählen und mit Doppelklick oder der
Eingabe-Taste bestätigen.
Eine Liste mit einer Auswahl an Aktionen wird geöffnet.
3. Den Menüpunkt Force start auswählen.
Der ausgewählte ScatterJob wird gestartet.
Während ein Auftrag über Scatter auf einer Steuerung ausgeführt
wird, leuchtet die grüne LED und blinken die beiden weißen LEDs
an dem KUKA System Panel.
Weitere Informationen sind der Betriebsanleitung der jeweiligen Ro-
botersteuerung zu entnehmen.

[Link] Software-Pakete deinstallieren

Beschreibung

Wenn die Verbindung zu einer Steuerung hergestellt ist, können die

darauf installierten Software-Pakete direkt über [Link] deinstalliert
werden.

Voraussetzung

• [Link] ist geöffnet.

• Verbindung zu gewünschter Steuerung ist hergestellt.

Vorgehensweise

1. Den Menüpunkt Execute > Uninstall Packages öffnen.

Eine Liste der installierten Software-Pakete wird geöffnet.
2. Software-Paket anwählen, das deinstalliert werden soll und mit Dop-
pelklick oder der Eingabe-Taste bestätigen.

20/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
Während ein Auftrag über Scatter auf einer Steuerung ausgeführt
wird, leuchtet die grüne LED und blinken die beiden weißen LEDs
an dem KUKA System Panel.
Weitere Informationen sind der Betriebsanleitung der jeweiligen Ro-
botersteuerung zu entnehmen.

6.2 Bedienung über Kommandozeilen

Sämtliche Kommandos können auch über die Windows Eingabeaufforde-

rung eingegeben werden. Im Folgenden werden die für Scatter spezifi-
schen Kommandos erklärt und Beispiele gezeigt.
Für die Arbeit in der Eingabeaufforderung werden fortgeschrittene
Kenntnisse im Umgang mit Kommandozeilen-Tools vorausgesetzt.

6.2.1 [Link] Hilfe

Zu [Link] gibt es eine Hilfe. Die allgemeine Hilfe kann über den
Parameter [Link] -? aufgerufen werden.
Neben der allgemeinen Hilfe kann die Hilfe auch für bestimmte Parameter
aufgerufen werden. Dazu wird der jeweilige Parameter hinter das Frage-
zeichen gesetzt, z. B. wenn die Hilfe zu dem Parameter -cp aufgerufen
werden soll, ist [Link] -? -cp einzugeben.

6.2.2 Allgemeine Scatter-Kommandos

Kommando Beschreibung
providepacka- Mit dem Kommando providepackages können Pakete von einem Scatter-
ges Job auf eine spezifizierte Steuerung gesendet werden. Wird ein ScatterJob
zur Installation des Pakets an die jeweilige Steuerung geschickt, wird das
pp
Paket von der Steuerung installiert und nicht erneut gesendet.
Für weitere Informationen s. (>>> "Parameter zu providepackages" Sei-
te 30)
execute Mit dem Kommando execute wird ein ScatterJob oder ein ScatterPackage
an eine spezifische Steuerung gesendet.
e
Für weitere Informationen s. (>>> 6.2.8 "ScatterJob/ScatterPackage über
Kommandozeilen an eine Steuerung schicken" Seite 27).
executemany Mit dem Kommando executemany können mehrere ScatterJobs auf mehre-
ren Steuerungen auf einmal aufgeführt werden.
em
Für weitere Informationen s. (>>> 6.2.9 "ScatterJob/ScatterPackage über
Kommandozeilen an mehrere Steuerungen schicken" Seite 31).
remove Mit dem Kommando remove kann ein ScatterPackage auf einer spezifi-
schen Steuerung deinstalliert werden.
r
Für weitere Informationen s. (>>> 6.2.11 "ScatterPackage über Komman-
dozeilen deinstallieren" Seite 34).
createpackage Mit dem Kommando createpackage kann ein ScatterPackage erstellt wer-
den.
cp
Für weitere Informationen s. (>>> 6.2.4 "ScatterPackage erstellen" Sei-
te 23).
createjob Mit dem Kommando createjob kann ein ScatterJob erstellt werden, der mit
dem Kommando execute ausgeführt werden kann.
cj
Für weitere Informationen s. (>>> 6.2.3 "ScatterJob erstellen" Seite 22).

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 21/52

Bedienung [Link] 1.0 [Link] 1.1

Kommando Beschreibung
cancel Mit dem Kommando cancel kann ein aktiver ScatterJob abgebrochen wer-
den, sofern es zu dem jeweiligen Zeitpunkt möglich ist.
c
forcestart Das Kommando forcestart erzwingt den Start eines aktiven ScatterJobs
zum nächstmöglichen Zeitpunkt.
fs
Für weitere Informationen s. (>>> 6.2.10 "ScatterJob/ScatterPackage ma-
nuell starten" Seite 33).
computecheck- Mit dem Kommando computechecksum wird eine Berechnung der Check-
sum summe für eine Datei veranlasst.
Für weitere Informationen s. (>>> [Link] "Parameter zu computecheck-
cc
sum" Seite 27).
showreturncode Mit dem Kommando showreturncode wird eine Meldung für den Rückga-
becode angezeigt, der als Integer von Scatter zurückgegeben wird.
rc
Für weitere Informationen s. (>>> 6.2.12 "Meldung zum Returncode anzei-
gen" Seite 36).
show Mit dem Kommando show werden die Informationen den ScatterJobs,
ScatterPackages und Paketen auf einer spezifizierten Steuerung angezeigt.
s
help Mit dem Kommando help wird die Hilfe aufgerufen.
Für weitere Informationen s. (>>> 6.2.1 "[Link] Hilfe" Seite 21).
?

6.2.3 ScatterJob erstellen

Beschreibung

Ein ScatterJob kann auch über Kommandozeilen erstellt werden.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Windows Eingabeaufforderung öffnen.

2. Parameter -cj -s mit Pfad zu Quelldatei -jn mit Pfad zum Ausga-
beverzeichnis eingeben.
Beispiel: [Link] -cj -s:"D:/AFolderContainingMyS-
tuff" jn:"D:/[Link]"
3. Es können weitere Parameter festgelegt werden. Weitere Informatio-
nen dazu sind der Hilfe zu entnehmen (>>> 6.2.1 "[Link] Hilfe"
Seite 21).

[Link] Parameter zu createjob

Parameter Beschreibung
source Pfad zu der gewünschten Datei mit dem Inhalt für das ScatterPackage
oder zu dem Verzeichnis für den Inhalt mehrerer ScatterPackages.
s
jobname Bezeichnung des ScatterJobs, der angelegt wird.
jn

22/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
Parameter Beschreibung
format Angabe des Formats des ScatterJobs. Die folgende Formate werden un-
terstützt:
fmt
• Json
• XML
relativepathes Relative Pfadnamen
Wird der Parameter gesetzt, wird ein relativer Pfadname gesetzt.
rp
overwrite Wenn dieser Parameter gesetzt ist, wird ein bestehender ScatterJob über-
schrieben.
r
checksumtype Angabe des Checksummen-Typs. Folgende Typen können ausgegeben
werden:
cs
• Sha1:
Standardeinstellung
• Md5
• None
upgradestrategy Angabe der Strategie bei Ausführung des Jobs. Folgende Strategien kön-
nen ausgeführt werden:
us
• KeepExistingData: vorhandene Daten behalten
• CleanInstall: vorhandene Daten löschen und zurücksetzen
logfile Verzeichnis, in dem die LOG-Datei abgelegt wird
log
lf
loglevel Angabe, wie detailliert das Log erstellt wird. Der Umfang der geloggten
Ereignisse nimmt von Off zu Trace zu.
level
ll • Trace: detailliertes Log für Fehlersuche durch Experten
• Debug: detailliertes Log für Fehlersuche durch Experten
• Info: Standardeinstellung
• Warn
• Error
• Fatal
• Off

6.2.4 ScatterPackage erstellen

Beschreibung

Ein ScatterPackage wird über Kommandozeilen erstellt.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Windows Eingabeaufforderung öffnen.

2. Parameter -cp -s mit Pfad zu Quelldatei -o mit Pfad zum Ausgabe-
verzeichnis eingeben.
Beispiel: [Link] -cp -s:"D:/AFolderContainingMyS-
tuff" o:"D:/MyPackages"

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 23/52

Bedienung [Link] 1.0 [Link] 1.1

3. Es können weitere Parameter festgelegt werden. Weitere Informatio-

nen dazu sind der Hilfe zu entnehmen (>>> 6.2.1 "[Link] Hilfe"
Seite 21).

[Link] Parameter zu createpackage

Parameter Beschreibung
source Pfad zu der gewünschten Datei mit dem Inhalt für das ScatterPackage
oder zu dem Verzeichnis für den Inhalt mehrerer ScatterPackages.
s
output Verzeichnis, in dem das erstellte ScatterPackage abgelegt wird.
Die Standardeinstellung ist ".\", mit der das ScatterPackage im Verzeichnis
o
der Quelle abgelegt wird.
force Das ScatterPackage wird ohne Prüfung bestehender Software-Versionen
ausgeführt.
f
packagename Benennung des ScatterPackages
Standardmäßig wird die Bezeichnung des Inputs für das Packet übernom-
pn
men.
updatestrategy Strategie bei Ausführung des Jobs. Folgende Strategien können
ausgeführt werden:
us
• KeepExistingData: vorhandene Daten behalten
Standardeinstellung
• CleanInstall: vorhandene Daten löschen und zurücksetzen
checksumtype Angabe des Checksummen-Typs. Folgende Typen können ausgegeben
werden:
cs
• Sha1:
Standardeinstellung
• Md5
• None
logfile Verzeichnis, in dem die LOG-Datei abgelegt wird
log
lf
loglevel Angabe, wie detailliert das Log erstellt wird. Der Umfang der geloggten
Ereignisse nimmt von Off zu Trace zu.
level
ll • Trace: detailliertes Log für Fehlersuche durch Experten
• Debug: detailliertes Log für Fehlersuche durch Experten
• Info: Standardeinstellung
• Warn
• Error
• Fatal
• Off
overwrite Wenn dieses Kommando gesetzt ist, werden bestehende ScatterPackages
überschrieben.
r

Beispiele

In dem folgenden Beispiel wird ein Scatterpackage für alle Elemente in

dem Verzeichnis AFolderContainingMyStuff erstellt und unter dem Pfad D:/
MyPackages/[Link] abgelegt.

24/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
[Link] -cp -source:"D:/AFolderContainingMyStuff"
output:"D:/MyPackages"
-pn:[Link]

In dem folgenden Beispiel wird ein ScatterPackage mit einer einzelnen

kop-Datei erstellt und unter dem Pfad D:/MyPackages/[Link]-
ge abgelegt. Wenn bereits ein ScatterPackage unter diesem Pfad liegt,
wird dieses ohne Meldung überschrieben.

[Link] -cp -source:"D:/MyKops/ProConOS 4 - [Link]" -

output:"D:/MyPackages" -r

In den folgenden beiden Beispielen wird ein ScatterPackage mit einer ein-
zelnen kop-Datei erstellt und unter dem Quellpfad mit dem Namen
[Link] abgelegt. Wenn bereits ein ScatterPackage unter die-
sem Pfad liegt, wird dieses ohne Meldung überschrieben. Das ScatterPa-
ckage wird ohne Prüfung bereits installierter Software-Versionen ausge-
führt.

[Link] -cp- s:"KOPs\[Link]" o:"." -r -

pn="[Link]" -f

oder

[Link] -cp - source:"KOPs\[Link]" output:"." -

overwrite
-packagename="[Link]" -force

6.2.5 Skript erstellen

Beschreibung

Ein ScatterPackage kann als Skript erstellt und an die Steuerung ge-
schickt werden.
Wenn [Link] auf der Steuerung installiert ist, ist die Ausführung ei-
nes Skripts auf dieser Steuerung nicht möglich.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Ordner erstellen mit folgenden Dateien:

• eine Datei mit dem Namen run
• [Link]
• optional: nolog, stoppedsystem, runningsystem
2. Ordner zippen und im Ordner "Packages" speichern.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 25/52

 [Link] 1.0 [Link] 1.1

[Link] Dateien für ein Skript

Bedienung

Datei Beschreibung
run Es muss eine Datei mit dem Namen "run" enthalten sein.
Die Datei kann folgende Formate haben:

• .exe
• .bat
• .vbs
• .ps1
[Link] Optional
Diese Datei wird verwendet, um eine Version der zu installierenden
Software anzugeben. Der Name, der in der [Link] vergeben wer-
den, wird als Name für die .zip-Datei verwendet.
nolog Optional
Keine Datei-Endung. Die Datei verhindert das Schreiben einer Log-
Datei für dieses Skript.
stoppedsystem Optional
Die Systemsoftware wird gestoppt oder bleibt gestoppt, sofern sie be-
reits gestoppt ist.
runningsystem Optional
Die Systemsoftware wird gestartet oder bleibt am Laufen, sofern sie
bereits gestartet ist.
fireandforget Optional
simplemonitoring Es findet keine weitere Update-Überwachung statt. Ein Skript kann
longrunning ein Service oder ein Prozess starten, ohne den Update-Auftrag zu
blockieren.

6.2.6 Checksumme berechnen

Beschreibung

Um sicherzustellen, dass ein Auftrag vollständig heruntergeladen wurde,

kann eine Checksumme berechnet und verglichen werden.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Windows-Eingabeaufforderung öffnen.
2. Parameter -cc -f:-t: mit Pfad zu der Datei eingeben, für die eine
Checksumme berechnet wird und der Checksummen-Typ eingegeben.
Beispiel: [Link] -cc -f:"C:\packages\[Link]"
t:Sha1

26/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

[Link] Parameter zu computechecksum

Bedienung
Parameter Beschreibung
file Angabe des Pfades zu der Datei, für die eine Checksumme berechnet
wird.
f
type Angabe des Checksummen-Typs.
Folgende Typen stehen zur Verfügung:
t
• Sha1
• Md5

6.2.7 Pakete über Kommandozeilen an eine Steuerung senden

Beschreibung

Über das Kommando providepackages kann ein Paket an eine Steuerung

gesendet werden.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Windows-Eingabeaufforderung öffnen.
2. Parameter -providepackages -f: mit Pfad zu der Datei des jewei-
ligen Paketes eingeben.
Alternativ kann auch der Pfad zu einem ScatterJob eingegeben wer-
den, in dem Fall werden nur die verlinkten Pakete an die Steuerung
gesendet.
Beispiel: [Link] -providepackages -f:"C:\packages
\[Link]"
Während ein Auftrag über Scatter auf einer Steuerung ausgeführt
wird, leuchtet die grüne LED und blinken die beiden weißen LEDs
an dem KUKA System Panel.
Weitere Informationen sind der Betriebsanleitung der jeweiligen Ro-
botersteuerung zu entnehmen.

3. Es können weitere Parameter festgelegt werden. Weitere Informatio-

nen sind (>>> "Parameter zu providepackages" Seite 30) oder der
Hilfe zu entnehmen (>>> 6.2.1 "[Link] Hilfe" Seite 21).

6.2.8 ScatterJob/ScatterPackage über Kommandozeilen an eine Steuerung

schicken

Beschreibung

Über das Kommando execute kann ein ScatterJob oder ein ScatterPacka-
ge an eine Steuerung gesendet werden. Das Vorgehen ist gleich, unab-
hängig davon, ob ein ScatterJob oder ein ScatterPackage ausgeführt wird.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 27/52

Bedienung [Link] 1.0 [Link] 1.1

Vorgehensweise

1. Windows-Eingabeaufforderung öffnen.
2. Parameter -execute -f: mit Pfad zu der Datei des jeweiligen Scat-
terJobs oder ScatterPackages eingeben.
Beispiel: [Link] -execute -f:"C:\packages\mapacka-
[Link]"
Während ein Auftrag über Scatter auf einer Steuerung ausgeführt
wird, leuchtet die grüne LED und blinken die beiden weißen LEDs
an dem KUKA System Panel.
Weitere Informationen sind der Betriebsanleitung der jeweiligen Ro-
botersteuerung zu entnehmen.

3. Es können weitere Parameter festgelegt werden. Weitere Informatio-

nen sind (>>> [Link] "Parameter zu execute" Seite 28) oder der Hil-
fe zu entnehmen (>>> 6.2.1 "[Link] Hilfe" Seite 21).

[Link] Parameter zu execute

Parameter Beschreibung
file Pfad zu der Datei mit allen Dateien, die Scatter ausführen soll.
f
address Adresse der Steuerung, an die der Auftrag gesendet werden soll.
Wird keine Adresse angegeben, ist die Standardadresse localhost.
a
provisionme- Beeinflusst das Verhalten, wie Scatter die PAckete bei Ausführung eines
thod Auftrags zur Verfügung stellt.
pm • auto: Das Verhalten wird automatisch gewählt.
‒ Wird Scatter auf dem Zielsystem ausgeführt, wird "None" verwen-
det.
‒ In allen anderen Fällen wird "Upload" verwendet, sofern dasn Ziel-
system einen Upload unterstützt.
Standardeinstellung
• Upload: Die ScatterPackages werden auf die Steuerung geschoben.
Diese Einstellung kann verwendet werden, wenn das Zielsystem kei-
nen Zugriff aud den Pfad hat.
• FileServer: Scatter startet einen FileServer. Damit wird dem Zielsystem
ermöglicht, Pakete vom lokalen PC herunterzuladen.
• None: Kein Eingriff in die Paketbereitstellung. Es weder ein Fileserver
gestartet noch ein Upload durchgeführt.
wait Angabe, wann die Anwendung zu dem Auftrag geschlossen wird.
w • immediately: Anwendung wird direkt nach dem Start des Autrags ge-
schlossen.
• downloads completed: Anwendung wird geschlossen, sobald alle not-
wendigen Scatterpackages heruntergeladen wurden.
• finished: Anwendung wird geschlossen, wenn der Auftrag geschlossen
wird.
Standardeinstellung
timeout Zeitspanne, nach der die Anwendung mit einer Fehlermeldung geschlos-
sen wird.
t
Angabe in ms.

28/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
Parameter Beschreibung
password Passwort des Windows-Benutzerkontos.
pw
username Entspricht dem Windows-Benutzernamen, der zur Authentifizierung ver-
wendet wird.
un
credentialsfile Pfad zu einer Datei, in der die Anmeldedaten für den Zugriff auf die Down-
load-URLs hinterlegt. Der Parameter ist nur dann relevant, wenn die "pro-
cf
visionmethod" None verwendet wird.
Der Aufbau einer Credential-Datei kann der Vorlage in Scatter entnommen
werden.
logfile Verzeichnis, in dem die LOG file abgelegt wird.
log
lf
loglevel Angabe, wie detailliert das Log erstellt wird. Der Umfang der geloggten
Ereignisse nimmt von Off zu Trace zu.
level
ll • Trace: detailliertes Log für Fehlersuche durch Experten
• Debug: detailliertes Log für Fehlersuche durch Experten
• Info: Standardeinstellung
• Warn
• Error
• Fatal
• Off

Beispiele

In dem folgenden Beispiel wird ein ScatterPackage mit den folgenden Pa-
rametern an eine Steuerung geschickt:
• Dateiname: [Link]
• Adresse der Steuerung: PCRC40961
• Benutzername: KukaUser
• Passwort: Passwort123

[Link] -e f:"[Link]" a:PCRC40961

un:KukaUser pw:Passwort123

In dem folgenden Beispiel wird ein ScatterJob mit den folgenden Parame-
tern an eine Steuerung geschickt:
• Dateiname: [Link]
• Adresse der Steuerung: PCRC40961
• Log-Level: Debug
• Benutzername: KukaUser
• Passwort: Passwort123

[Link] -e: f:"[Link]" a:PCRC40961 ll:Debug

un:KukaUser pw:Passwort123

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 29/52

 [Link] 1.0 [Link] 1.1

Parameter zu providepackages
Bedienung

Parameter Beschreibung
file Pfad zu der Datei mit allen Dateien, die Scatter an die Steuerung senden
soll.
f
address Adresse der Steuerung, an die die Pakete gesendet werden soll.
Wird keine Adresse angegeben, ist die Standardadresse localhost.
a
provisionme- Beeinflusst das Verhalten, wie Scatter die Pakete bei Ausführung eines
thod Auftrags zur Verfügung stellt.
pm • auto: Das Verhalten wird automatisch gewählt.
‒ Wird Scatter auf dem Zielsystem ausgeführt, wird "None" verwen-
det.
‒ In allen anderen Fällen wird "Upload" verwendet, sofern dasn Ziel-
system einen Upload unterstützt.
Standardeinstellung
• Upload: Die ScatterPackages werden auf die Steuerung geschoben.
Diese Einstellung kann verwendet werden, wenn das Zielsystem kei-
nen Zugriff aud den Pfad hat.
• FileServer: Scatter startet einen FileServer. Damit wird dem Zielsystem
ermöglicht, Pakete vom lokalen PC herunterzuladen.
• None: Kein Eingriff in die Paketbereitstellung. Es weder ein Fileserver
gestartet noch ein Upload durchgeführt.
wait Angabe, wann die Anwendung zu dem Auftrag geschlossen wird.
w • immediately: Anwendung wird direkt nach dem Start des Autrags ge-
schlossen.
• downloads completed: Anwendung wird geschlossen, sobald alle not-
wendigen Scatterpackages heruntergeladen wurden.
• finished: Anwendung wird geschlossen, wenn der Auftrag geschlossen
wird.
Standardeinstellung
timeout Zeitspanne, nach der die Anwendung mit einer Fehlermeldung geschlos-
sen wird.
t
Angabe in ms.
password Passwort des Windows-Benutzerkontos.
pw
username Entspricht dem Windows-Benutzernamen, der zur Authentifizierung ver-
wendet wird.
un
credentialsfile Pfad zu einer Datei, in der die Anmeldedaten für den Zugriff auf die Down-
load-URLs hinterlegt. Der Parameter ist nur dann relevant, wenn die "pro-
cf
visionmethod" None verwendet wird.
Der Aufbau einer Credential-Datei kann der Vorlage in Scatter entnommen
werden.
logfile Verzeichnis, in dem die LOG file abgelegt wird.
log
lf

30/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
Parameter Beschreibung
loglevel Angabe, wie detailliert das Log erstellt wird. Der Umfang der geloggten
Ereignisse nimmt von Off zu Trace zu.
level
ll • Trace: detailliertes Log für Fehlersuche durch Experten
• Debug: detailliertes Log für Fehlersuche durch Experten
• Info: Standardeinstellung
• Warn
• Error
• Fatal
• Off

Beispiele

In dem folgenden Beispiel werden die Pakete, die mit dem ScatterPacka-
ge verlinkt sind, mit den folgenden Parametern an eine Steuerung gesen-
det:
• Dateiname: [Link]
• Adresse der Steuerung: PCRC40961
• Benutzername: KukaUser
• Passwort: Passwort123

[Link] -e f:"[Link]" a:PCRC40961

un:KukaUser pw:Passwort123

In dem folgenden Beispiel werden die Pakete, die mit dem ScatterJob ver-
linkt sind, mit den folgenden Parametern an eine Steuerung gesendet:
• Dateiname: [Link]
• Adresse der Steuerung: PCRC40961
• Log-Level: Debug
• Benutzername: KukaUser
• Passwort: Passwort123

[Link] -e: f:"[Link]" a:PCRC40961 ll:Debug

un:KukaUser pw:Passwort123

6.2.9 ScatterJob/ScatterPackage über Kommandozeilen an mehrere Steue-

rungen schicken

Beschreibung

Über das Kommando executemany kann ein ScatterJob oder ein Scatter-
Package auf mehreren Steuerungen parallel ausgeführt werden.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Editor öffnen.
2. Für jede Steuerung, auf der ein ScatterJob oder ein ScatterPackage
ausgeführt werden soll, die Parameter -execute -a: file: mit der
jeweiligen Adresse der Steuerung und der Datei des jeweiligen Scat-
terJob und ScatterPackage eingeben.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 31/52

 [Link] 1.0 [Link] 1.1

Beispiel: -execute -a:PCRC40961 file="[Link]"

Bedienung

-execute -a:PCRC41011 file="[Link]"

3. Als .txt-Datei speichern.
4. Windows-Eingabeaufforderung öffnen.
5. Parameter -em - jobs: mit Pfad zu der .txt-Datei eingeben, in der
die jeweiligen Steuerungen und die darauf auszuführenden Scatter-
Jobs oder ScatterPackages gelistet sind.
Beispiel: [Link] -em -jobs:"C:\[Link]"
Während ein Auftrag über Scatter auf einer Steuerung ausgeführt
wird, leuchtet die grüne LED und blinken die beiden weißen LEDs
an dem KUKA System Panel.
Weitere Informationen sind der Betriebsanleitung der jeweiligen Ro-
botersteuerung zu entnehmen.

6. Es können weitere Parameter festgelegt werden. Weitere Informatio-

nen sind (>>> [Link] "Parameter zu executemany" Seite 32) oder
der Hilfe zu entnehmen (>>> 6.2.1 "[Link] Hilfe" Seite 21).

[Link] Parameter zu executemany

Parameter Beschreibung
jobfile Pfad zu einer Textdatei mit Kommandos, die Scatter ausführen soll.
jobs
parallelmaxi- Anzahl der parallel durchgeführten ScatterJobs. Wird die Anzahl der paral-
mum lel durchzuführenden ScatterJobs in der Textdatei überschritten, so wird
die maximale Anzahl an ScatterJobs parallel ausgeführt. Sowie ein Scat-
p
terJob beendet ist, wird der nächste begonnen, bis alle ScatterJobs ausge-
führt wurden.
Der Standardwert ist 5.
file Pfad zu der Datei mit allen Dateien, die Scatter ausführen soll.
f
password Passwort des Windows-Benutzerkontos.
pw
username Entspricht dem Windows-Benutzernamen, der zur Authentifizierung ver-
wendet wird.
un
logfile Verzeichnis, in dem die LOG file abgelegt wird.
log
lf
loglevel Angabe, wie detailliert das Log erstellt wird. Der Umfang der geloggten
Ereignisse nimmt von Off zu Trace zu.
level
ll • Trace: detailliertes Log für Fehlersuche durch Experten
• Debug: detailliertes Log für Fehlersuche durch Experten
• Info: Standardeinstellung
• Warn
• Error
• Fatal
• Off

32/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
Beispiel

In dem folgenden Beispiel werden alle ScatterJobs ausgeführt, die in der

Text-Datei [Link] spezifiziert sind.

-[Link] -em jobs:"[Link]" un:KukaUser

pw:Passwort123

In der folgenden Textdatei wird spezifiziert, dass der ScatterJob Ether-

[Link] auf zwei Steuerungen ausgeführt wird.

-execute -a:PCRC40961 file="[Link]"

-execute -a:PCRC41011 file="[Link]"

6.2.10 ScatterJob/ScatterPackage manuell starten

Beschreibung

Anstehende ScatterJobs mit den Starttypen "Schedule" oder "Manuell"

können mit dem Kommando forcestart gestartet werden.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Windows-Eingabeaufforderung öffnen.
2. Parameter -fs -a: mit Adresse der Steuerung eingeben, auf der ein
ScatterJob gestartet werden soll.
Beispiel: :\[Link] -fs -a:PC69666
Während ein Auftrag über Scatter auf einer Steuerung ausgeführt
wird, leuchtet die grüne LED und blinken die beiden weißen LEDs
an dem KUKA System Panel.
Weitere Informationen sind der Betriebsanleitung der jeweiligen Ro-
botersteuerung zu entnehmen.

3. Es können weitere Parameter festgelegt werden. Weitere Informatio-

nen sind (>>> [Link] "Parameter zu forcestart" Seite 33) oder der
Hilfe zu entnehmen (>>> 6.2.1 "[Link] Hilfe" Seite 21).

[Link] Parameter zu forcestart

Parameter Beschreibung
address Adresse der Steuerung, an die der Auftrag gesendet werden soll.
Wird keine Adresse angegeben, ist die Standardadresse localhost.
a
password Passwort des Windows-Benutzerkontos.
pw
username Entspricht dem Windows-Benutzernamen, der zur Authentifizierung ver-
wendet wird.
un
logfile Verzeichnis, in dem die LOG file abgelegt wird.
log
lf

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 33/52

Bedienung [Link] 1.0 [Link] 1.1

Parameter Beschreibung
loglevel Angabe, wie detailliert das Log erstellt wird. Der Umfang der geloggten
Ereignisse nimmt von Off zu Trace zu.
level
ll • Trace: detailliertes Log für Fehlersuche durch Experten
• Debug: detailliertes Log für Fehlersuche durch Experten
• Info: Standardeinstellung
• Warn
• Error
• Fatal
• Off

Beispiel

In dem folgenden Beispiel wird ein ScatterJob auf der Steurung mit dem
Namen "PCRC40961" manuell gestartet.
Für den Start wird der Benutzernamen und das Passwort benötigt. Sobald
das Kommando versendet ist, wird die Update-Freigabe abgefragt.

[Link] -fs a:"PCRC40961" un:"KukaUser" pw:"Passwort123"

6.2.11 ScatterPackage über Kommandozeilen deinstallieren

Beschreibung

Das Kommando remove ist eine spezielle Form des Kommandos execute.
Auf diese Weise kann vermieden werden, einen ScatterJob mit dem fol-
genden Parameter anzulegen und auszuführen:
• DesiredAction: Uninstall

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Windows-Eingabeaufforderung öffnen.
2. Parameter -remove -a: pn: mit Name der Steuerung und des je-
weiligen ScatterPacakges eingeben.
Beispiel: [Link] -remove -a:PCRC12345 pn:MyOption-
Name
Während ein Auftrag über Scatter auf einer Steuerung ausgeführt
wird, leuchtet die grüne LED und blinken die beiden weißen LEDs
an dem KUKA System Panel.
Weitere Informationen sind der Betriebsanleitung der jeweiligen Ro-
botersteuerung zu entnehmen.

3. Es können weitere Parameter festgelegt werden. Weitere Informatio-

nen sind (>>> [Link] "Parameter zu remove" Seite 35) oder der Hil-
fe zu entnehmen (>>> 6.2.1 "[Link] Hilfe" Seite 21).

34/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

[Link] Parameter zu remove

Bedienung
Parameter Beschreibung
packagename Name des Packages, das deinstalliert wird.
pn
address Adresse der Steuerung, an die der Auftrag gesendet werden soll.
Wird keine Adresse angegeben, ist die Standardadresse localhost.
a
condition Bedingung, die vor Deinstallation abgefragt werden soll.
c
packagetype Angabe des Pakettyps des zu deinstallierenden Packages.
type
pt
wait Angabe, wann die Anwendung zu dem Auftrag geschlossen wird.
w • immediately: Anwendung wird direkt nach dem Start des Autrags ge-
schlossen.
• downloadscompleted: Anwendung wird geschlossen, sobald alle not-
wendigen Scatterpackages heruntergeladen wurden.
• finished: Anwendung wird geschlossen, wenn der Auftrag geschlossen
wird.
Standardeinstellung
timeout Zeitspanne, nach der die Anwendung mit einer Fehlermeldung geschlos-
sen wird.
t
Angabe in ms.
password Passwort des Windows-Benutzerkontos.
pw
username Entspricht dem Windows-Benutzernamen, der zur Authentifizierung ver-
wendet wird.
un
logfile Verzeichnis, in dem die LOG file abgelegt wird.
log
lf
loglevel Angabe, wie detailliert das Log erstellt wird. Der Umfang der geloggten
Ereignisse nimmt von Off zu Trace zu.
level
ll • Trace: detailliertes Log für Fehlersuche durch Experten
• Debug: detailliertes Log für Fehlersuche durch Experten
• Info: Standardeinstellung
• Warn
• Error
• Fatal
• Off

Beispiele

In dem folgenden Beispiel wird ein ScatterPackage mit den folgenden Pa-
rametern deinstalliert:
• Dateiname: EthernetKRL
• Bedingung: Installierte Version entspricht einer Version 1.2.4 oder hö-
her
• Adresse der Steuerung: PCRC40961

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 35/52

Bedienung [Link] 1.0 [Link] 1.1

• Benutzername: KukaUser
• Passwort: Passwort123

[Link] -remove -packagename:EthernetKRL -

condition:"InstalledVersion > '1.2.3' "
a:PCR40961 un:KukaUser pw:Passwort123

6.2.12 Meldung zum Returncode anzeigen

Beschreibung

Mit dem Kommando showreturncode wird eine Meldung für den Rückga-
becode angezeigt, der als Integer von Scatter zurückgegeben wird.

Voraussetzung

• [Link] ist auf dem Laptop/PC installiert.

Vorgehensweise

1. Windows-Eingabeaufforderung öffnen.
2. Parameter -returncode eingeben.
Es werden alle Meldungen angezeigt.
oder
3. Parameter -showreturncode -c: mit dem Rückgabecode einge-
ben.
Beispiel: [Link] -showreturncode -c:101
Die Meldung zu dem spezifischen Rückgabecode wird angezeigt.

6.3 [Link]

[Link] liefert Plugins und Meldungen auf dem

smartPAD. Im Folgenden werden die verschiedenen Tätigkeiten erklärt,
die durch diese Option auf dem smartPAD durchgeführt werden können.
[Link] ist für die KUKA System Software
8.3 und die VW System Software 8.3 nicht verfügbar.

6.3.1 Bedien- und Systembedingungen konfigurieren

Beschreibung

Für jede Steuerung können individuell Bedien- und Systembedingungen

konfiguriert werden. Diese müssen erfüllt sein, damit Aufträge vom
[Link] gestartet werden können.
Für die KSS 8.3 und VSS 8.3 müssen die Bedien- und Systembedin-
gungen über eine xml-Datei konfiguriert werden:
(>>> [Link] "Bedienbedingungen über XML-Datei konfigurieren" Sei-
te 39)
(>>> [Link] "Systembedingungen über XML-Datei konfigurieren" Sei-
te 40)

Voraussetzung

• Die Robotersteuerung und die KUKA smartHMI sind gestartet.

• Benutzerrechte: Funktionsgruppe Kritische Konfigurationen

36/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
Vorgehensweise

1. Im Hauptmenü Inbetriebnahme > Software Update > Updatefreiga-

be wählen.
Ein Fenster mit den Registerkarten Konfiguration zur Updatefreiga-
be und Konfiguration der Systembedingung öffnet sich.
2. In der Registerkarte Konfiguration zur Updatefreigabe die Bedienbe-
dingungen konfigurieren:
• Logik hinterlegen, unter welchen Voraussetzungen ein Update vom
[Link] auf die Steuerung aufgespielt werden darf.
Es sind UND-Verknüpfungen und ODER-Verknüpfungen möglich.
Dabei können alle KRL-Variablen abgefragt werden.
• Bedingungen über die Checkboxen aktivieren oder deaktivieren.
3. Zur Registerkarte Konfiguration der Systembedingung wechseln.
4. Bei Bedarf einzelne Systembedingungen deaktivieren. Es wird jedoch
empfohlen, die Default-Einstellungen zu belassen.
HINWEIS
Sachschäden durch Deaktivierung von Systembedingungen
Für die Ausführung von Aufträgen des [Link] wird die
Robotersteuerung heruntergefahren. Wenn die Systembedingungen
deaktiviert sind und zu diesem Zeitpunkt ein Programm abgefahren
wird, kann dies dazu führen, dass der Roboter an einer ungeeigne-
ten Stelle stehen bleibt oder mit der Umgebung kollidiert. Sachschä-
den können die Folge sein.
‒ Sicherstellen, dass bei der Ausführung von Aufträgen des
[Link] das angewählte Programm angehalten ist
und der Roboter-Interpreter sich am Ende des Programms befin-
det.

5. Das Fenster schließen. Eine Abfrage wird angezeigt, ob die Änderun-

gen gespeichert werden sollen.
6. Die Abfrage mit Ja bestätigen. Die Konfiguration wird gespeichert und
das Fenster schließt sich.
Die Konfiguration wird auch im Fall eines Fehlers gespeichert. Es
erscheint dann eine Meldung, dass die Konfiguration Fehler enthält.
Diese kann bestätigt und der Speichervorgang abgeschlossen wer-
den.

[Link] Aufbau einer Konfiguration zur Update-Freigabe

Der Aufbau einer Konfiguration zur Update-Freigabe kann dem folgenden

Beispiel entnommen werden.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 37/52

Bedienung [Link] 1.0 [Link] 1.1

Abb. 6-2: Konfiguration zur Update-Freigabe

Pos. Beschreibung
1 • Grün: Die Bedingung ist "wahr".
• Grau: Die Bedingung ist "falsch".
• Rot: Die Bedingung enthält einen Fehler. Übergeordnete
Elemente werden in der Folge ebenfalls mit einer roten LED
gekennzeichnet. Die jeweilige Fehlermeldung wird über ei-
nen einfachen Klick geöffnet.
2 Der Fokus ist auf dieser Bedingung. In den Feldern Bedingung
und Beschreibung werden die Parameter zu dieser Bedingung
angezeigt.
3 Angabe der KRL-Variablen und des Werts für die jeweilige Be-
dingung.
4 Optional: Beschreibung für die Bedingung, die für ein einfache-
res Verständnis angezeigt werden kann.
5 • Mit Häkchen: Die ausgewählte Bedingung ist aktiv gesetzt.
• Ohne Häkchen: Die ausgewählte Bedingung ist inaktiv ge-
setzt.

[Link] Aufbau der Konfiguration der Systembedingungen

Die Konfiguration der Systembedingungen ist folgendermaßen aufgebaut.

Standardmäßig sind beide Bedingungen aktiv gesetzt.

38/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
Abb. 6-3: Konfiguration der Systembedingung

Pos. Beschreibung
1 • Mit Häkchen: Die ausgewählte Bedingung ist aktiv gesetzt.
• Ohne Häkchen: Die ausgewählte Bedingung ist inaktiv ge-
setzt.
2 Wenn eine Bedingung inaktiv gesetzt wird, wird dieses Warn-
symbol angezeigt.

[Link] Bedienbedingungen über XML-Datei konfigurieren

Beschreibung

Die Bedienbedingungen für die Update-Freigabe können auch in der Datei

[Link] konfiguriert werden.

Voraussetzung

• Benutzerrechte: Funktionsgruppe Kritische KRL-Programmänderun-

gen
• Betriebsart T1

Vorgehensweise

1. Im Navigator unter C:\KRC\ROBOTER\Config\User\Common die Datei

[Link] markieren und Öffnen drücken.
Die Datei wird im Editor angezeigt.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 39/52

Bedienung [Link] 1.0 [Link] 1.1

2. Die Bedingungen wie gewünscht anpassen.

3. Datei schließen und die Sicherheitsabfrage, ob die Änderungen ge-
speichert werden sollen, mit Ja beantworten.

Beispiel

<?xml version="1.0" encoding="utf-8"?>

<Condition>
<And>
<KssRunning />
<Or>
<Condition>($MODE_OP == #AUT) AND (NOT $COULD_START_MOTION)</Condition>
<Condition>($MODE_OP == #EX) AND (NOT $COULD_START_MOTION)</Condition>
<And>
<Condition>$MODE_OP == #T1</Condition>
<Attribute>
<Value>true</Value>
<Name>IsForced</Name>
</Attribute>
</And>
</Or>
</And>
</Condition>

[Link] Systembedingungen über XML-Datei konfigurieren

Beschreibung

Die Systembedingungen für die Update-Freigabe können auch in der Da-

tei [Link] konfiguriert werden.

Voraussetzung

• Benutzerrechte: Funktionsgruppe Kritische KRL-Programmänderun-

gen
• Betriebsart T1

Vorgehensweise

1. Im Navigator unter C:\KRC\ROBOTER\Config\User\Common die Datei

[Link] markieren und Öffnen drücken.
Die Datei wird im Editor angezeigt.
2. Um eine Bedingung zu deaktivieren, in der gewünschten Zeile Enab-
led="false" hinzufügen:
• Roboter steht: <RobotStopped Enabled="false" />
• Roboter Interpreter nicht aktiv: <InterpreterStopped Enab-
led="false" />
3. Datei schließen und die Sicherheitsabfrage, ob die Änderungen ge-
speichert werden sollen, mit Ja beantworten.

Beispiel

Im folgenden Beispiel ist die Bedingung für Roboter steht aktiv gesetzt
und die Bedingung für Roboter Interpreter nicht aktiv ist inaktiv gesetzt.

<?xml version="1.0" encoding="utf-8"?>

<SystemCondition>
<And>
<RobotStopped />

40/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Bedienung
<InterpreterStopped Enabled="false" />
</And>
</SystemCondition>

6.3.2 Auftrag an der Steuerung bestätigen

Beschreibung

Wenn ein Auftrag über Scatter an eine Steuerung geschickt wird und die
Benutzerbestätigung aktiv ist, geht eine Meldung auf. Mit dieser Meldung
hat der Benutzer die Möglichkeit, den Auftrag zu bestätigen, abzulehnen
oder auf einen späteren Zeitpunkt zu verschieben.
Für die KSS 8.3 und die VSS 8.3 ist diese Funktion nicht verfügbar.

Voraussetzung

• Steuerung ist hochgefahren.

• Benutzerrechte: Funktionsgruppe Allgemeine Konfiguration
• Betriebsmodus: T1

Vorgehensweise

Antwort Beschreibung
Ja Mit "Ja" wird der Auftrag akzeptiert und ausgeführt.
Nein Mit "Nein" wird der Auftrag abgebrochen. In [Link]-
ter wird unter dem Menüpunkt "UpdateJobs" angezeigt,
dass der Zugriff verweigert wurde und der Auftrag fehlge-
schlagen ist. Um den Job auf der Steuerung durchzufüh-
ren, muss dieser wieder neu gestartet werden.
Später Mit "Später" wird die Ausführung des Auftrags auf einen
späteren Zeitpunkt verschoben. Der Auftrag muss an der
Steuerung gestartet werden (>>> 6.3.3 "Auftrag an der
Steuerung starten" Seite 41) und wird solange im Mel-
dungsfenster angezeigt.

6.3.3 Auftrag an der Steuerung starten

Beschreibung

Wenn im Meldungsfenster des smartPADs ein Auftrag vom [Link]-

Service angezeigt wird, kann dieser manuell gestartet werden. Ein Auftrag
wird dann im Meldungsfenster angezeigt, wenn der Auftrag so eingestellt
ist, dass er manuell gestartet werden soll oder wenn die Benutzerbestäti-
gung aktiv ist und mit "Später" quittiert wurde.

Voraussetzung

• Steuerung ist hochgefahren.

• Benutzerrechte: Funktionsgruppe Allgemeine Konfiguration

Vorgehensweise

1. Im Hauptmenü Inbetriebnahme > Software Update > Anstehendes

Update wählen.
Anstehende Aufträge werden ausgeführt.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 41/52

Bedienung [Link] 1.0 [Link] 1.1

42/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Meldungen
7 Meldungen

Für die KSS 8.3 und VSS 8.3 werden keine Meldungen des [Link]-
dateService auf der smartHMI angezeigt.

7.1 Systemmeldungen aus Modul: UpdateService

7.1.1 UpdateService 00019

Meldungscode UpdateService 00019

Meldungstext Ein Software Update steht zur Ausführung bereit.
Meldungstyp Zustandsmeldung

Mögliche Ursa- Ursache: Warte auf Installationsfreigabe (>>> Seite 43)

che(n) Lösung: Systeminformation: keine Bedienaktion notwendig (>>> Sei-
te 43)

Ursache: Warte auf Installationsfreigabe

Beschreibung

Ein Software-Update wurde gestartet und wartet auf die Installationsfreiga-

be der Steuerung.

Lösung: Systeminformation: keine Bedienaktion notwendig

Beschreibung

Diese Meldung ist eine Systeminformation für den Bediener und erfordert
keine Aktion.

7.1.2 UpdateService 00020

Meldungscode UpdateService 00020

Meldungstext Ein Software Update steht zur Ausführung bereit. Benutzer "{Benut-
zerbezeichnung}" wird für den Start benötigt.
Meldungstyp Zustandsmeldung

Mögliche Ursa- Ursache: Warte auf Installationsfreigabe (>>> Seite 44)

che(n) Lösung: Systeminformation: keine Bedienaktion notwendig (>>> Sei-
te 44)

Ursache: Fehlende Berechtigungen (>>> Seite 44)

Lösung: Benutzergruppe wechseln (>>> Seite 44)

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 43/52

 [Link] 1.0 [Link] 1.1

Ursache: Warte auf Installationsfreigabe

Meldungen

Beschreibung

Ein Software-Update wurde gestartet und wartet auf die Installationsfreiga-

be der Steuerung.

Lösung: Systeminformation: keine Bedienaktion notwendig

Beschreibung

Diese Meldung ist eine Systeminformation für den Bediener und erfordert
keine Aktion.

Ursache: Fehlende Berechtigungen

Beschreibung

Die Berechtigungen des angemeldeten Benutzers sind nicht ausreichend.

Lösung: Benutzergruppe wechseln

Beschreibung

In der KSS stehen je nach Benutzergruppe unterschiedliche Funktionen

zur Verfügung. Es gibt folgende Benutzergruppen:
• Bediener
Benutzergruppe für den Bediener. Dies ist die Default-Benutzergruppe.
• Anwender
Benutzergruppe für den Bediener. (Die Benutzergruppen Bediener und
Anwender sind defaultmäßig für die gleiche Zielgruppe angelegt.)
• Experte
Benutzergruppe für den Programmierer. Diese Benutzergruppe ist
durch ein Passwort geschützt.
• Sicherheitsinstandhalter
Benutzergruppe für den Inbetriebnehmer. Dieser Benutzer kann die Si-
cherheitskonfiguration des Roboters aktivieren und konfigurieren.
Diese Benutzergruppe ist durch ein Passwort geschützt.
• Sicherheitsinbetriebnehmer
Diese Benutzergruppe ist nur relevant, wenn [Link]
oder [Link] verwendet wird. Die Benutzergruppe
ist durch ein Passwort geschützt.
• Administrator
Funktionen wie bei der Benutzergruppe Experte. Zusätzlich ist die In-
tegration von Plug-Ins in die Robotersteuerung möglich.
Diese Benutzergruppe ist durch ein Passwort geschützt.
Beim Neustart ist die Default-Benutzergruppe ausgewählt.
Wenn in die Betriebsart AUT oder AUT EXT gewechselt wird, wechselt
die Robotersteuerung aus Sicherheitsgründen in die Default-Benutzergrup-
pe. Wenn eine andere Benutzergruppe gewünscht ist, muss danach in
diese gewechselt werden.
Wenn während einer bestimmten Zeitdauer an der Bedienoberfläche keine
Handlung erfolgt, wechselt die Robotersteuerung aus Sicherheitsgründen
in die Default-Benutzergruppe. Die Default-Einstellung ist 300 s.

44/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Meldungen
In der VSS wird ein USB-Stick mit einer Schlüsseldatei für die ge-
wünschten Benutzergruppen benötigt. Die Schlüsseldatei kann mit der
Software [Link] erzeugt werden.

Vorgehensweise

1. Im Hauptmenü Konfiguration > Benutzergruppe wählen. Die aktuelle

Benutzergruppe wird angezeigt.
2. Um in die Default-Benutzergruppe zu wechseln: Standard drücken.
(Standard steht nicht zur Verfügung, wenn man sich bereits in der De-
fault-Benutzergruppe befindet.)
Um in eine andere Benutzergruppe zu wechseln: Anmelden… drü-
cken. Die gewünschte Benutzergruppe markieren.
3. Falls gefordert: Passwort eingeben und mit Anmelden bestätigen.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 45/52

Meldungen [Link] 1.0 [Link] 1.1

46/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Fehlerbehebung
8 Fehlerbehebung

8.1 Verbindung von Laptop/PC zu Steuerung nicht möglich

Beschreibung

Um den [Link] nutzen zu können, muss der Port 443 frei-

geschaltet sein. Andernfalls können keine Aufträge vom Laptop/PC an die
Steuerungen gesendet werden.
Ein weiterer möglicher Grund für diesen Fehler ist, dass die Verbindung
mit unterschiedlichen Zertifikaten verschlüsselt wird. In diesem Fall
muss eine höhere Version von WorkVisual verwendet werden. Die pas-
sende Version von WorkVisual kann der Datei [Link] entnom-
men werden. Die Datei befindet sich auf dem Datenträger mit [Link]-
dateService 1.1.

Voraussetzung

• Benutzerrechte: Funktionsgruppe Kritische Konfigurationen

• Betriebsart T1 oder T2
• Es ist kein Programm angewählt.

Vorgehensweise

1. Im Hauptmenü Inbetriebnahme > Netzwerkkonfiguration wählen.

Das Fenster Netzwerkkonfiguration öffnet sich.
2. Auf Erweitert... drücken. Das Fenster für die erweiterte Netzwerkkonfi-
guration öffnet sich.
3. Die Registerkarte NAT wählen.
4. Auf Port hinzufügen drücken. Der Liste wird ein neuer Port mit der
Nummer "0" hinzugefügt.
5. Im Feld Portnummer: die Nummer 443 eingeben und im Feld Zuge-
lassene Protokolle: den Eintrag tcp auswählen.
6. Auf Speichern drücken.
7. Das Fenster schließen.
8. Die Robotersteuerung neu starten, mit Einstellung Dateien neu einle-
sen.

8.2 ScatterJob senden nicht möglich

Beschreibung

Wenn ein Auftrag an eine Steuerung gesendet werden soll, darf kein Auf-
trag in der Warteschlange stehen. Ist bereits ein Auftrag in der Warte-
schlange, so kann kein weiterer Auftrag gesendet werden.

Voraussetzung

• [Link] ist geöffnet.

• Verbindung zu gewünschter Steuerung ist hergestellt.
• ScatterJob oder ScatterPackage ist im Ordner "\Packages" gespei-
chert.

Vorgehensweise

1. Den Menüpunkt UpdateJobs öffnen.

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 47/52

 [Link] 1.0 [Link] 1.1

Eine Liste der abgeschlossenen, laufenden und anstehenden Scatter-

Fehlerbehebung

Jobs wird geöffnet.

2. Liste nach einem ScatterJob mit dem Status WaitForConfirmation
durchsuchen.
3. ScatterJob mit dem Status WaitForConfirmation abbrechen.
4. Auftrag, der aktuell an die Steurung gesendet werden soll, erneut sen-
den.

48/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

KUKA Service
9 KUKA Service

9.1 Support-Anfrage

Einleitung

Diese Dokumentation bietet Informationen zu Betrieb und Bedienung und

unterstützt Sie bei der Behebung von Störungen. Für weitere Anfragen
steht Ihnen die lokale Niederlassung zur Verfügung.

Informationen

Zur Abwicklung einer Anfrage werden folgende Informationen benö-

tigt:
• Problembeschreibung inkl. Angaben zu Dauer und Häufigkeit der Stö-
rung
• Möglichst umfassende Informationen zu den Hardware- und Software-
Komponenten des Gesamtsystems
Die folgende Liste gibt Anhaltspunkte, welche Informationen häufig re-
levant sind:
‒ Typ und Seriennummer der Kinematik, z. B. des Manipulators
‒ Typ und Seriennummer der Steuerung
‒ Typ und Seriennummer der Energiezuführung
‒ Bezeichnung und Version der Systemsoftware
‒ Bezeichnungen und Versionen weiterer/anderer Software-Kompo-
nenten oder Modifikationen
‒ Diagnosepaket der Systemsoftware
Für KUKA Sunrise zusätzlich: Vorhandene Projekte inklusive Appli-
kationen
Für Versionen der KUKA System Software älter als V8: Archiv der
Software (Diagnosepaket steht hier noch nicht zur Verfügung.)
‒ Vorhandene Applikation
‒ Vorhandene Zusatzachsen

9.2 KUKA Customer Support

Die Kontaktdaten der lokalen Niederlassungen finden Sie unter:

[Link]/customer-service-contacts

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 49/52

KUKA Service [Link] 1.0 [Link] 1.1

50/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023

 [Link] 1.0 [Link] 1.1

Index J
-cj.................................................................... 22 jobfile...............................................................32
-cp................................................................... 24 jobname.......................................................... 22

A K
address........................................28, 30, 33, 35 Konfiguration...................................................13
Administrator...................................................44 KRL................................................................... 6
KSS...................................................................6
KUKA Customer Support............................... 49
B KUKA Service.................................................49
Bedienbedingungen, konfigurieren.................36
Bedienbedingungen, über XML..................... 39
Bediener..........................................................44 L
Bedienung.......................................................15 logfile........................ 23, 24, 29, 30, 32, 33, 35
Benutzergruppe, Default.................................44 loglevel..................... 23, 24, 29, 31, 32, 34, 35
Bestimmungsgemäße Verwendung..................8 longrunning..................................................... 26
Betriebsarten, Roboter..................................... 9

M
C Meldungen...................................................... 43
cc.................................................................... 27
checksumtype...........................................23, 24
computechecksum.......................................... 27 N
condition..........................................................35 nolog............................................................... 26
createpackage.......................................... 22, 24
credentialsfile............................................29, 30
O
output.............................................................. 24
D overwrite................................................... 23, 24
Diagnosepaket................................................ 49
Dokumentation, Industrieroboter...................... 5
P
packagename........................................... 24, 35
E packagetype....................................................35
Einleitung.......................................................... 5 parallelmaximum.............................................32
execute........................................................... 28 password...............................29, 30, 32, 33, 35
executemany...................................................32 Produktbeschreibung........................................ 7
Programmierer................................................ 44
providepackages.............................................30
F provisionmethod....................................... 28, 30
Fehlerbehebung..............................................47
file.......................................................28, 30, 32
fireandforget....................................................26 R
force................................................................ 24 r.......................................................................35
forcestart......................................................... 33 relativepathes..................................................23
format..............................................................23 remove............................................................ 35
fs..................................................................... 33 Roboter, Betriebsarten......................................9
run...................................................................26
runningsystem.................................................26
H
Hinweise........................................................... 5
S
Schulungen....................................................... 5
I Sicherheit.......................................................... 9
Installation....................................................... 11 Sicherheitshinweise.......................................... 5
simplemonitoring.............................................26
Skript...............................................................26

[Link] 1.1 V7 | Stand: 07.09.2023 [Link] | 51/52

[Link] 1.0 [Link] 1.1

source.......................................................22, 24
stoppedsystem................................................26
Support-Anfrage..............................................49
Systembedingungen, konfigurieren................ 36
Systembedingungen, über XML.....................40
Systemvoraussetzungen.................................11
Hardware....................................................11

T
timeout............................................... 28, 30, 35

U
updatestrategy................................................ 24
upgradestrategy.............................................. 23
username.............................. 29, 30, 32, 33, 35

V
[Link]....................................................... 26
VSS...................................................................6

W
wait.....................................................28, 30, 35

52/52 | [Link] [Link] 1.1 V7 | Stand: 07.09.2023