Wiki-Quellcode von ACMP Agenten installieren

Zuletzt geändert von Sabrina V. am 2024/10/31 07:37

version	line-number	content
1.1	1	{{aagon.priorisierung}}
	2	160
	3	{{/aagon.priorisierung}}
	4
	5	{{aagon.floatingbox/}}
	6
	7	= Manuelle Agenteninstallation über eine MSI =
	8
	9	Neben der ACMP Console können Sie auch den ACMP Agenten manuell über eine MSI-Datei installieren. Diese befindet sich standardmäßig unter folgendem Pfad und ist über den Ordner abrufbar:
	10
	11	\|MSI.exe\|Pfad
	12	\|ACMP Agent.msi\|C:\Program Files (x86)\Aagon\ACMP Server\Clients\Client
	13
8.1	14	Bei der Agenteninstallation können Sie neben der ACMP Agent.msi auch eine Launcher.exe verwenden. Die Launcher.exe führt die Installation automatisch aus und bezieht die Parameter für die MSI aus der Client.ini-Datei. Alternativ dazu können Sie auch die nötigen Parameter für eine Silent Installation der MSI angeben und ausführen und diese im Hintergrund laufen lassen.
1.1	15
8.1	16	Sollten Sie sich für die manuelle Installation über die MSI-Datei entscheiden, führt Sie ein Wizard Schritt für Schritt durch.
1.1	17
	18	== ACMP Agent Installer MSI ==
	19
	20	Um den Agenten manuell auf Ihren Computer zu installieren, öffnen Sie //ACMP Agent.msi //in dem oben genannten Ordnerpfad. Es öffnet sich ein Wizard, der Sie im Setup-Assistenten unterstützt. Klicken Sie auf //Next//, um mit der Installation zu beginnen.
	21
8.1	22	Geben Sie auf der ersten Seite die ACMP Server / Gateway Details ein. Dazu gehören die Adresse, die Portnummer, die Server ID (abrufbar über die Settings.ini des Servers (Pfad des ACMP Servers)) und der Pfad zur ACMP Server-Zertifikatsdatei. Letztere wird nur benötigt, wenn Sie ein abweichendes Zertifikat benutzen wollen, ansonsten kann der Wert auch leer bleiben. Klicken Sie danach auf //Next//.
1.1	23
	24	{{figure}}
8.1	25	[[image:67_Update Mechanismus_ACMP Agent Setup Wizard 2_495.png\|\|alt="66_Update Mechanismus_ACMP Agent Setup Wizard 2_495.png" data-xwiki-image-style-alignment="center"]]
1.1	26
	27	{{figureCaption}}
	28	ACMP Server und Gateway Einstellungen
	29	{{/figureCaption}}
	30	{{/figure}}
	31
8.1	32	Auf der nächsten Seite geben Sie an, in welches Verzeichnis der ACMP Agent installiert werden soll. Dazu können Sie zwischen zwei Pfaden per Radiobutton entscheiden. Der Agentenport dient dazu, dass der ACMP Server dem Agenten die Jobs direkt zusenden kann und sollte damit bei allen Clients identisch sein. Setzen Sie nach Bedarf unter //Enable debug logging //(nur, wenn es z.B. kurz nach der Installation zu Problemen kommt) und //Create a new ClientID for this Client //(wenn es Duplikate am Server gibt, falls sich also zwei Rechner mit derselben Client ID melden) einen Haken in die Checkbox und klicken Sie erneut auf //Next//.
1.1	33
	34	{{figure}}
8.1	35	[[image:66_Update Mechanismus_ACMP Agent Setup Wizard 3_495.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	36
	37	{{figureCaption}}
	38	Einrichtung des ACMP Agent
	39	{{/figureCaption}}
	40	{{/figure}}
	41
8.1	42	Aktivieren Sie optional die Checkbox auf der nächsten Seite, wenn Sie die Pfade zu Ihren Gateway-Zertifikatsdateien eingeben möchten.
1.1	43
	44	{{figure}}
8.1	45	[[image:66_Update Mechanismus_ACMP Agent Setup Wizard 4_495.png\|\|data-xwiki-image-style-alignment="center"]]
1.1	46
	47	{{figureCaption}}
	48	Gateway Zertifikate hinterlegen
	49	{{/figureCaption}}
	50	{{/figure}}
	51
	52	Beenden Sie Ihre Arbeiten im Wizard, indem Sie auf der letzten Seite auf //Install //klicken. Die Installation startet und Sie können über den Status und den Ladebalken den Fortschritt einsehen. Klicken Sie zum Schluss auf //Finish//, um den Einrichtungsassistenten abzuschließen.
	53
	54	{{aagon.infobox}}
8.1	55	Wenn Sie den Installationsvorgang abbrechen, wird das System nicht geändert.
1.1	56	{{/aagon.infobox}}
	57
	58	== Parameter des ACMP Agent Installer MSIs ==
	59
8.1	60	Nachfolgend werden einige Parameter aufgelistet, die Sie für die ACMP Agent.msi anpassen können, wenn Sie das ACMP Agent Setup beispielsweise als Silent Installation starten wollen. Beachten Sie, dass die Parameter nicht sensitiv sind.
1.1	61
	62	{{aagon.infobox}}
8.1	63	Die genannten Parameter werden in der Reihenfolge überprüft, wie sie hier abgebildet werden.
1.1	64	{{/aagon.infobox}}
	65
	66	\|Parameter\|Beschreibung
8.1	67	\|CLIENTPORT\|Geben Sie hier den Clientport an. Sollten Sie den Parameter nicht verwenden, wird hier Wert 2108 verwendet.
1.1	68	\|DEBUGENABLED\|Das Debugging kann aktiviert (1) oder deaktiviert (0) werden. Sollte keine Eingabe gemacht werden, bleibt es deaktiviert und der Wert (0) wird eingefügt.
	69	\|CLTDEFLOC\|Legen Sie fest, wo der Standard Speicherort des Clients (Client Default Location) sein soll. Mit dem Wert (0) ist es //C:\ACMPClient// und mit dem Wert (1) //%ProgramFiles(x86)%\ACMPClient//. Sollten Sie keine Angaben machen, wird der Wert (1) verwendet.
8.1	70	\|SERVERNAME\|Fügen Sie hier den Servernamen ein, zu dem sich der ACMP Agent verbinden soll.
1.1	71	\|SERVERCERTIFICATESDIR\|Gibt das Verzeichnis an, aus dem die Serverzertifikate bezogen werden. Es handelt es sich um einen optionalen Parameter, der aber bei angezeigter Benutzeroberfläche mit dem Verzeichnis, wo auch das MSI liegt, vorbefüllt ist. Sollte das Verzeichnis nicht vorhanden sein oder leer sein, wird kein Zertifikat kopiert und es greift ein //Trust On First Use//.
	72	\|SERVERID\|Geben Sie die Server-ID an.
	73	\|SERVERPORT\|Geben Sie den Serverport an. Sollten Sie keinen anderen Wert eingeben, wird hier 2106 verwendet.
	74	\|MAKENEWCLIENTID\|Erzwingt mit dem Wert (1) eine neue Client-ID für den Installationsmechanismus. Mit dem standardmäßigen Wert (0) wird keine neue Client-ID erzwungen.
	75	\|GATEWAYCERTIFICATE\|Geben Sie Ihr Gateway Zertifikat an.
	76	\|GATEWAYKEY\|Geben Sie hier Ihren Gateway Schlüssel an.
	77	\|/qn\|Es wird eine komplette Silent Installation ohne Änderungen in der UI vorgenommen.{{aagon.infobox}}Hier werden die üblichen Parameter der gängigen MSI Befehle verwendet, die Sie auf der [[Microsoft Seite>>https://learn.microsoft.com/de-de/windows-server/administration/windows-commands/msiexec#parameters-1]] nachlesen können.{{/aagon.infobox}}
	78
	79	Tragen Sie die Parameter ein und führen Sie danach die Silent Installation des ACMP Agents durch.