Exemplarische Bereitstellung und Ausführung einer Datei über das File Repository (MSI-Datei)

Zuletzt geändert von Sabrina V. am 2024/10/14 06:02

Ausgangslage

Im normalen Arbeitsalltag kommt es oft vor, dass Sie den Mitarbeitern Ihres Unternehmens neue Software zur Verfügung stellen wollen. Entweder können Sie die Installationsressourcen manuell an jeden einzelnen Client verteilen oder Sie stellen die Dateien einfach als Client Command bereit, sodass jeder darauf zugreifen kann.
In diesem Beispiel erfahren Sie, wie Sie eine MSI-Datei an die Clients verteilen. Hierbei wird exemplarisch das Datenkompressionsprogramm 7-Zip über Ihren Agent hochgeladen und anschließend bereitgestellt. Grundsätzlich kann es mehrere Wege geben, wie Sie so eine Datei verteilen können. An dieser Stelle soll nur aufgezeigt werden, wie Sie dies über die File Repositories von ACMP erledigen können. Durch das File Repository stellen Sie sicher, dass trotz unterschiedlicher oder wechselnder Standorte alle Mitarbeiter die Ressource erhalten. Gehen Sie dafür wie folgt vor:

Skript auswählen

  1. Navigieren Sie ins Modul Client Commands > Erstellen.
  2. Klicken Sie in der Ribbonleiste auf Hinzufügen. Es öffnet sich der Client Command Editor, in dem Sie entscheiden müssen, ob es sich um ein Console- oder Clientskript handelt. In diesem Fall wählen Sie das Clientskript aus.

Dateiupload in das File Repository

Um mit den eigentlichen Arbeiten am Client Command zu beginnen, müssen Sie zunächst die Installationsressource im File Repository hinterlegen.

  1. Öffnen Sie das File Repository über die Commandliste (image-20230809131053-1.png).
  2. Klicken Sie auf die Spalte des File Repositories, sodass sich die Unterordner öffnen.
  3. Wählen Sie den Ordner Private aus.

Hinweis  Hinweis: 

Es ist wichtig, dass Sie den Ordner Private auswählen, da die Installationsressource nur für das Client Command genutzt werden soll. 

      4. Fügen Sie die Datei dem privaten File Repository hinzu, indem Sie auf das entsprechende Icon (image-20230809131133-3.png) klicken.
      5. Es öffnet sich ein Dialog. Wählen Sie die Installationsressource aus, die Sie im Client Command zur Verfügung stellen wollen. In diesem Beispiel wird 7-Zip verwendet.
      6. Laden Sie die MSI-Datei per Doppelklick hinein.
          Es erscheint ein Ladebalken, der Sie über den Fortschritt informiert. In diesem Beispiel wurde die 7x2201-x64.msi Datei von 7-Zip erfolgreich in das File Repository geladen.
      7. Klicken Sie abschließend auf Schließen.

65_Use Case Client Commands_Installationsressource im File Repository hinterlegen.png

Installationsressource im File Repository hinterlegen

Command Download File einfügen und anpassen

  1. Navigieren Sie in die Commandliste und wählen Sie den Befehl File Repository > Download File aus.
  2. Öffnen Sie den Befehl per Doppelklick.
  3. Klicken Sie unter Datei(en) auswählen auf das Icon rechts neben dem Feld.
  4. Öffnen Sie im File Repository unter dem Ordner Private die hinzugefügte Datei (7x2201-x64.msi), indem Sie einen Haken vor der Datei setzen. Es müssen nun die Punkte File Repository, Private und 7x2201-x64.msi angehakt sein.
  5. Klicken Sie anschließend auf Schließen, um wieder zum vorherigen Fenster zu gelangen.
  6. Navigieren Sie zu Speichern unter. Dort können Sie entweder den Pfad, wo die Datei gespeichert werden soll, unter dem Icon rechts neben dem Feld auswählen. Alternativ können Sie aber auch die %PROJECTDIR% Variable verwenden. 

Hinweis  Hinweis: 

PROJECTDIR ist eine temporäre Variable, die während der Ausführung vom Client Command ein Verzeichnis generiert und nach der Laufzeit des Client Commands dieses auch automatisch aufräumt. Hierdurch werden Dateien in das PROJECTDIR heruntergeladen.

     7. Rufen Sie die %PROJECTDIR% Variable über STRG + Leertaste auf.
     8. Wechseln Sie in den Allgemein Tab.
     9. Fügen Sie dort eine neue Beschreibung der Aktion ein, zum Beispiel "7-Zip ins %PROJECTDIR% herunterladen.
   10. Beenden Sie Ihre Arbeiten an dem Befehl, indem Sie auf OK klicken.

65_Use Case Client Commands_Datei herunterladen.png

Datei herunterladen

Command Install MSI package einfügen und bearbeiten

  1. Laden Sie den Befehl Install MSI package (MSI) in das Skript, indem Sie es wie die vorherigen aus der Commandliste per Doppelklick auswählen.
  2. Klicken Sie im Bereich Paket auf das Durchsuchen Icon.
  3. Wählen Sie dort die 7-Zip Installationsdatei aus und klicken dann auf Öffnen.
  4. Entfernen Sie den Pfad bis auf den Dateinamen und ersetzen Sie diesen Teil durch die %PROJECTDIR% Variable. Wählen Sie dazu mit STRG + Leertaste die Variable %PROJECTDIR% aus. Es sollte nun an dieser Stelle „%PROJECTDIR%7z2201-x64.msi“ stehen.

Hinweis  Hinweis: 

Zwischen der Variable und dem Dateinamen darf kein Backslash stehen, da sämtliche Verzeichnisvariablen im ACMP auf einen Backslash enden.

      5. Haken Sie unter den Richtlinien den Registry Schlüssel 'Immer mit erhöhten Rechten installieren' setzen an.
      6. Schließen Sie diesen Befehl mit OK.

65_Use Case Client Commands_MSI Paket installieren.png

MSI Paket installieren

Command Run Client Task einfügen und editieren

Diesen Befehl können Sie Ihrem Client Command hinzufügen, um den Software Scanner direkt im Anschluss starten zu lassen. So wird sichergestellt, dass die neue Software direkt inventarisiert wird und in der Console zur Verfügung steht.

  1. Wählen Sie den Befehl ACMP > Run Client Task aus der Commandliste aus.
  2. Öffnen Sie den Allgemein Tab.
  3. Fügen Sie unter Beschreibung der Aktion einen Namen ein, z.B. „Software Scanner als geplante Aufgabe ausführen“.
  4. Wechseln Sie zurück in den Tab Details.
  5. Wählen Sie unter Als geplante Aufgabe ausführen den Software Scanner aus. Hierdurch wird das System inventarisiert und die neu hinzugefügte Software in der Console aktualisiert.
  6. Klicken Sie auf OK.

65_Use Case Client Commands_Software Scanner als geplante Aufgabe ausführen.png

Software Scanner als geplante Aufgabe ausführen

Speichern Sie Ihr Client Command. Es empfiehlt sich, je nach Größe der Umgebung, einen treffenden Namen zu vergeben, damit Sie schnell das Command wiederfinden können. Dieses Beispiel wurde „7-Zip 7x2201-x64 Installation“ genannt und setzt sich aus dem Namen der Software sowie der Versionsnummer zusammen.

65_Use Case Client Commands_Übersicht exemplarische Bereitstellung und Ausführung einer Datei über das File Repository (MSI-Datei)_1377.png

Client Command-Editor: Exemplarische Bereitstellung und Ausführung einer Datei über das File Repository (MSI-Datei)

Client Command-Phasen durchlaufen lassen

Das Client Command muss abschließend die Phasen Testen, Synchronisieren, Freigeben und Ausführen durchlaufen, damit es verwendet werden kann. Danach haben Sie die Möglichkeit die Installationsressource der Software 7-Zip an Ihre Clients zu verteilen und auszuführen.

© Aagon GmbH 2024
Besuchen Sie unsere neue Aagon-Community