20180818-Bedienungsanleitung IDERI move-V1 1

Inhaltsverzeichnis

1 UMGEBUNG VORBEREITEN ..................................................................................................... 2

1.1 WAS LIEFERN WIR MIT? ............................................................................................................. 2 1.2 DSM SERVER FÜR EXPORT EINRICHTEN ......................................................................................... 2 1.2.1 KONTEXTMENÜ ............................................................................................................................... 2 1.2.2 EXPORTVERZEICHNIS ........................................................................................................................ 3 1.2.3 DSM KONSOLE ............................................................................................................................... 3 1.3 EMPIRUM SERVER ANPASSEN ..................................................................................................... 4

2 FUNKTIONALITÄT ................................................................................................................... 5

2.1 EXPORT AUS DSM ................................................................................................................... 6 2.1.1 EXPORT STRUKTUR FÜR MATRIX42 EMPIRUM ...................................................................................... 6 2.2 IMPORT IN EMPIRUM ................................................................................................................ 7

3 ANHANG A – BENUTZERTEIL UND VARIABLENHANDLING ....................................................... 10

4 ANHANG B - LOGFILES .......................................................................................................... 11

20180818-Bedienungsanleitung IDERI move-V1 2

1 Umgebung vorbereiten

1.1 Was liefern wir mit? IDERI move besteht aus zwei Komponenten, dem Export aus DSM und dem IDERI installer der für die Ausführung aus Empirum heraus zuständig ist. Für den Export stellen wir zwei XML Dateien und drei PowerShell-Skripte sowie ein „M42_PackageTemplate“ zur Verfügung.

• Contextmenu\ _CatalogObject_ExpInfo.xml

• Contextmenu\ _DependentCatalogObject_ExpInfo.xml

• IDERI_DsmToM42_Create_Matrix42_Import_Xml.ps1

• IDERI_DsmToM42_Get_PackageInfosFromDsm.ps1

• IDERIInstaller_DSMToM42Export.ps1

Hinweis: Verändern Sie bitte nur die Dateien, bei denen dies auch beschrieben wird. Für die Ausführung der exportierten Skripte liefern wir den IDERI installer mit, der für Matrix42 Empirum angepasst wurde.

• M42Inst (IDERImove-Ordner)

1.2 DSM Server für Export einrichten Auf dem DSM Server müssen die mitgelieferten Dateien noch angepasst und an die entsprechende Stelle gelegt werden.

1.2.1 Kontextmenü Wir liefern einen Katalog mit, welcher dafür zuständig ist, dass ein Kontextmenü in DSM angelegt wird. In diesem Katalog „_CatalogObject_ExpInfo.xml“ muss der „DSM Servername“ im Bereich <Value> angepasst werden.

Bild 1.2.1 roter Rahmen

20180818-Bedienungsanleitung IDERI move-V1 3

1.2.2 Exportverzeichnis Wir legen die exportierten Pakete unter C:\Temp\niscripts (Default) ab. Falls Sie möchten, dass diese direkt ins Empirum-Verzeichnis exportiert werden sollen (z.B. \\EmpirumServer\Empirum\Configurator\PackageStore), kann dies in der „IDERIInstaller_DSMToM42Export.ps1“-Datei getan werden.

Bild 1.2.2 Exportverzeichnis konfigurieren

Hinweis: Hier bitte nur den markierten Teil anpassen.

1.2.3 DSM Konsole Öffnen Sie die DSM Konsole – Organisation – und machen Sie einen Rechtsklick auf ORG. Wählen Sie anschließend „Benutzerdefinierte Aufgaben verwalten …“ aus.

Bild 1.2.3 Benutzerdefinierte Aufgaben verwalten...

20180818-Bedienungsanleitung IDERI move-V1 4

Durch einen Rechtsklick auf „Aufgaben-Gruppe“ können Sie „Import/Export“ – „Katalog-Objekt importieren“ auswählen.

Bild 1.2.4 Katalogimport 01

Nun führt Sie ein Wizzard weiter. Geben Sie den Pfad zu „_CatalogObject_ExpInfo.xml“ und „_DependentCatalogObject_ExpInfo.xml“ an. Hinweis: Diese müssen auf gleicher Ebene liegen! Legen Sie bitte die PowerShell-Skripte und den „M42_PackageTemplate“-Ordner auf dem DSM Server unter „DSM\EXTERN$\IDERI“ ab. Hinweis: Der Ordner „IDERI“ muss zuvor angelegt werden.

1.3 Empirum Server anpassen Auf dem Empirum Server muss der IDERImove-Ordner in das folgende Verzeichnis gelegt werden.

• Empirum\Configurator\User

Bild 1.3.1 IDERImove Verzeichnis

20180818-Bedienungsanleitung IDERI move-V1 5

Hinweis: Sollten Sie Umgebungsvariablen in DSM erweitert oder angepasst haben, können Sie diese in der „packagesupport.config“-Datei erweitern/anpassen.

Bild 1.3.2 Packagesupport.config

2 Funktionalität Ein Umstieg auf „MATRIX42 Empirum“ bringt viel Arbeit mit sich. Finden Sie heraus wie Ihnen IDERI move bei einem erfolgreichen und stressfreien Umzug zur Seite stehen kann. Dieses Tool integriert sich in Ivanti DSM und MATRIX42 Empirum. Die erstellten Skripte von DSM können so problemlos in eine bestehende Empirum Umgebung eingebunden und verteilt werden. Funktionen wie Maschinen- und Benutzerteiltrennung werden von IDERI move auch in Empirum berücksichtigt.

20180818-Bedienungsanleitung IDERI move-V1 6

2.1 Export aus DSM Um die DSM Skripte/Pakete in einer anderen Umgebung nutzen zu können, müssen sie aus „Ivanti DSM“ exportiert werden und in eine andere Umgebung importiert werden. Hierzu muss erst, wie unter „Umgebung vorbereiten“ beschrieben, ein benutzerdefinierter Kontextmenüpunkt angelegt werden. Anschließend auf das entsprechende Paket mit rechtsklick den neuen Kontextmenüpunkt auswählen (ein Multiselect ist hier möglich). Es öffnet sich ein PowerShell-Fenster und der Export beginnt. Die exportierten Skripte werden an einen benutzerdefinierten Ort abgelegt und stehen dort für den Import zur Verfügung.

Bild 2.1.1

2.1.1 Export Struktur für Matrix42 Empirum Das exportierte Paket wird in einen Ordner mit dem Namen der DSM-Paket-GUID gespeichert. Der Ordner beinhaltet einen weiteren Ordner „Data“ und eine „EmpirumPackageData.xml“. Diese xml-Datei ist später für den Import zuständig. In dem Ordner „Data“ Sind weitere Ordner, die die Empirum-Ordnerstruktur wieder spiegeln – „Custom“, „Files“, „Install“, „Manual“, „Patches“, „Tools“ – sollten Sie hier noch Dateien hinzufügen, die Sie später aus Firmenrichtlinien brauchen können Sie diese vor dem Import noch ergänzen. Z.B. ein Handbuch, angepasste Icons, …

20180818-Bedienungsanleitung IDERI move-V1 7

2.2 Import in Empirum Legen Sie die exportierten Pakete in den Empirum PackageStore (Empirum\Configurator\PackageStore) ab.

Bild 2.2.1 Empirum Importverzeichnis

Öffnen Sie die Matrix42 Management Console und wechseln Sie auf „Konfiguration“ – „Software Management“. Suchen Sie sich hier das gewünschte Importziel aus. Als Beispiel haben wir ein „zzzDSM“ -Ordner angelegt. Machen Sie ein Rechtklick und wählen Sie „Paket Import“ aus.

Bild 2.2.2 Import in die Empirum Konsole

20180818-Bedienungsanleitung IDERI move-V1 8

Klicken Sie den Wizzard durch. (Die Checkbox „Pakete nach erfolgreichem Import aus Verzeichnis löschen“ ist optional)

Bild 2.2.3 Importverzeichnis

Wählen Sie die gewünschten Pakete aus.

Bild 2.2.4 Anzeige aller möglichen Pakete

Das Software-Paket bekommt den gleichen Namen wie bei Ivanti DSM.

20180818-Bedienungsanleitung IDERI move-V1 9

Bild 2.2.5 Paketübersicht

Die Pakete sind nun in der Empirum-Datenbank und werden in der Konsole angezeigt.

Bild 2.2.6 fertiger Import. Pakete sind in Empirum

20180818-Bedienungsanleitung IDERI move-V1 10

3 Anhang A – Benutzerteil und Variablenhandling Die Benutzerteile und Variablen werden aus DSM übernommen.

20180818-Bedienungsanleitung IDERI move-V1 11

4 Anhang B - Logfiles IDERImove logt einen Befehl nach dem anderen. Im Maschinenlog werden die benutzerbezogenen Befehle geskippt. Im Benutzerlog werden die maschinenbezogenen Befehle geskippt.