Zuletzt geändert von Sabrina V. am 2025/11/25 08:23
Von Version 1.1
bearbeitet von Sabrina V.
am 2024/11/11 06:46
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 1.2
bearbeitet von Sabrina V.
am 2024/11/11 07:01
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,0 +1,108 @@
1 += Allgemein =
2 +
3 +Die settings.ini ist eine Konfigurationsdatei, in der die Initialisierung der Daten abgespeichert wird. Sie ist dafür da, damit die Agenten, die sich mit dem Server verbunden haben, die Angaben zu den ACMP Clients abrufen und überprüfen können. Die Datei enthält dabei standardmäßig alle relevanten Angaben zum Server (den Namen, Port und die Server ID), sowie die Informationen zum Client Port, über den die Jobs vom Sever an die Clients gepusht werden können.
4 +
5 +Die settings.ini befindet sich im Freigabeordner des ACMP Servers (//C:\Program Files (x86)\Aagon\ACMP Server\Clients//). Öffnen Sie die settings.ini mit einem gängigen Texteditor, um sich den Dateiinhalt anzuschauen.
6 +
7 +[[Inhalt einer settings.ini>>image:66_Settings.ini_Beispiel eines Servers_421.png]]
8 +
9 += Aufbau einer settings.ini =
10 +
11 +Die Konfigurationsdatei kann entweder nur einen einzelnen oder gleich mehrere Servereinträge beinhalten (siehe Use Case: ACMP Gateway über die MSI installieren). Hiermit ist es möglich, direkt mehrere ACMP Server innerhalb nur einer Datei anzusprechen, Netzwerkmappings zu erstellen, Serverumzüge vorzubereiten oder „Multi-Server-Clients“ zu schaffen.
12 +
13 +Die enthaltenen Informationen werden immer zeilenweise genannt und ein Gleichheitszeichen trennt dabei den Schlüssel von seinem Wert:
14 +
15 +{{code language="none"}}
16 +Schlüssel=Wert
17 +SERVERPORT=2106
18 +
19 +{{/code}}
20 +
21 +Für die bessere Übersicht werden die Schlüssel in Gruppen aufgeteilt, die Sektionen heißen. Hierzu muss die Bezeichnung einer eindeutig zu bestimmenden Datei in einer eckigen Klammer erfolgen. Die Schreibweise der Schlüssel ist nicht Case-sensitiv.
22 +
23 +{{aagon.infobox}}
24 +Die Zählung der Selektion beginnt immer bei der Zahl 0 (Null) und wird bei mehreren Einträgen heraufgezählt.
25 +{{/aagon.infobox}}
26 +
27 +Beispiel:
28 +
29 +
30 +{{code language="none"}}[Sektion0]
31 +Schlüssel=Wert
32 +Schlüssel2=Wert
33 +
34 +[Sektion1]
35 +Schlüssel=Wert
36 +Schlüssel2=Wert
37 +Schlüssel3=Wert{{/code}}
38 +
39 +Beachten Sie, dass jede Sektion und jeder verwendete Schlüssel pro Sektion nur einmal vorkommen darf. Sollten Sie Kommentare in der Datei hinterlegen wollen, müssen diese mit einem Semikolon eingeleitet und in eine eigene Zeile gestellt werden. Beispiel:
40 +
41 +{{code language="none"}}
42 +[SERVER|0]
43 +SERVERNAME=server1.acmp.local
44 +SERVERPORT=2106
45 +; Angabe zum Servernamen überprüfen, ob sich die Bezeichnung geändert hat
46 +
47 +{{/code}}
48 +
49 +== Beispiel einer settings.ini ==
50 +
51 +Anbei sehen Sie eine Beispieldatei, die die Konfiguration zweier Servereinträge beinhaltet, sowie das Mapping und den hinterlegten Installationspfad des Clients. Die Spalte //Wert// gibt an, was in einer settings.ini stehen kann. Die Spalte //Erklärung //erläutert und begründet den jeweiligen Inhalt.
52 +
53 +| |(% style="width:392px" %)**Wert**|(% style="width:1261px" %)**Erklärung**
54 +| 1.|(% style="width:392px" %)[Servers]|(% style="width:1261px" %)Gibt die Sektion an, also die [Servers]
55 +| 2.|(% style="width:392px" %)max=1|(% style="width:1261px" %)Gibt den Wert (max) an, sowie die Angabe der verfügbaren Server. Der Inhalt ist 1, wobei bei 0 angefangen wird zu zählen
56 +| 3.|(% style="width:392px" %) |(% style="width:1261px" %)
57 +| 4.|(% style="width:392px" %)[SERVER~|0]|(% style="width:1261px" %)Gibt die Sektion SERVER sowie den ersten Server an, Zählbeginn bei der 0 (Null). Die Schreibweise ist folglich SERVER~|<N>
58 +| 5.|(% style="width:392px" %)SERVERNAME=server1.acmp.local|(% style="width:1261px" %)Der Inhalt ist der Schlüssel (SERVERNAME) sowie durch ein Gleichheitszeichen der getrennte Wert (server1.acmp.local); hier der Servername oder die IP des zu verwendenden ACMP Servers
59 +| 6.|(% style="width:392px" %)SERVERPORT=2106|(% style="width:1261px" %)Der Schlüssel (SERVERPORT) entspricht dem Wert des zu verwendenden ACMP Serverports, in diesem Beispiel dem Port 2106
60 +| 7.|(% style="width:392px" %)ServerId={CA191843-xxxx-494C-9934-xxxxxxxxxxxx}|(% style="width:1261px" %)Der Schlüssel (ServerId) hat den Wert der Server ID ({CA191843-xxxx-494C-9934-xxxxxxxxxxxx}) zugewiesen bekommen
61 +| 8.|(% style="width:392px" %)MaxBandWidth=100000|(% style="width:1261px" %)MaxBandWidth steht für die maximal zu verwendenden Bandbreite (Bit pro Sekunde). Sollte die Angabe unbegrenzt sein, kann auch eine Null eingetragen werden (0=Unbegrenzt)
62 +| 9.|(% style="width:392px" %) |(% style="width:1261px" %)
63 +|10.|(% style="width:392px" %)[SERVER~|1]|(% style="width:1261px" %)Wiederholung der Zeile 4, nur für den zweiten gelisteten Server ([SERVER~|1])
64 +|11.|(% style="width:392px" %)SERVERNAME=server2.acmp.local|(% style="width:1261px" %)Wiederholung der Zeile 5 (Servername oder die IP des ACMP Servers)
65 +|12.|(% style="width:392px" %)SERVERPORT=2106|(% style="width:1261px" %)Wiederholung der Zeile 6 (Angabe des Serverports)
66 +|13.|(% style="width:392px" %)ServerId={FDS1843-xxxx-494C-9934-xxxxxxxxxxxx}|(% style="width:1261px" %)Wiederholung der Zeile 7 (Angabe der Server ID)
67 +|14.|(% style="width:392px" %)MaxBandWidth=0|(% style="width:1261px" %)Wiederholung der Zeile 8 zur maximalen Bandbreite in Bit pro Sekunde
68 +|15.|(% style="width:392px" %) |(% style="width:1261px" %)
69 +|16.|(% style="width:392px" %)[CLIENTPORT]|(% style="width:1261px" %)Gibt die Sektion an, hier also den [CLIENTPORT]. Der Port wird dazu verwendet, dass die Jobs vom Server an die Clients gepusht werden
70 +|17.|(% style="width:392px" %)VALUE=2108|(% style="width:1261px" %)Gibt den Wert (VALUE) sowie den Inhalt des verwendeten ACMP Clientports an
71 +|18.|(% style="width:392px" %) |(% style="width:1261px" %)
72 +|19.|(% style="width:392px" %)[Mappings]|(% style="width:1261px" %)Führt die Sektion [Mappings] ein
73 +|20.|(% style="width:392px" %)max=1|(% style="width:1261px" %)Der Wert (max) gibt die Anzahl der verfügbaren Mappings an, bei 0 (Null) angefangen zu zählen
74 +|21.|(% style="width:392px" %) |(% style="width:1261px" %)
75 +|22.|(% style="width:392px" %)[Mapping~|0]|(% style="width:1261px" %)Führt die Sektion Mappings ein. Das erste Mapping muss mit der Zahl 0 (Null) begonnen werden (Mapping~|<N>)
76 +|23.|(% style="width:392px" %)NetworkAddress=192.168.0.0|(% style="width:1261px" %)Der Schlüssel NetworkAddress gibt die Netzadresse an, auf die das Mapping zutreffen soll. Der Wert dazu wird nach dem Gleichheitszeichen geschrieben
77 +|24.|(% style="width:392px" %)NetworkMask=255.255.255.0|(% style="width:1261px" %)Der Schlüssel NetworkMask gibt die Netzmaske an, auf die das Mapping zutreffen soll (hier: 255.255.255.0)
78 +|25.|(% style="width:392px" %)PreferredServer=Server~|0|(% style="width:1261px" %)Gibt den zu nutzenden Server an (Server~|0), den man zuvor in der Zeile 4 genannt hat
79 +|26.|(% style="width:392px" %) |(% style="width:1261px" %)
80 +|27.|(% style="width:392px" %)[Mapping~|1]|(% style="width:1261px" %)Wiederholung der Zeile 22, wo das zweite Mapping definiert wird ([Mapping~|1])
81 +|28.|(% style="width:392px" %)NetworkAddress=192.168.1.0|(% style="width:1261px" %)Wiederholung der Zeile 23 mit der angepassten Netzadresse für das Mapping
82 +|29.|(% style="width:392px" %)NetworkMask=255.255.255.0|(% style="width:1261px" %)Wiederholung der Zeile 24 mit der Netzmaske
83 +|30.|(% style="width:392px" %)PreferredServer=Server~|1|(% style="width:1261px" %)Wiederholung der Zeile 25 mit der Angabe des zu nutzenden Servers (Server~|1), der in Zeile 10 genannt wurde
84 +|31.|(% style="width:392px" %) |(% style="width:1261px" %)
85 +|32.|(% style="width:392px" %)[CLTDEFLOC]|(% style="width:1261px" %)Die Sektion [CLTDEFLOC] gibt den Standard Speicherort des Clients an
86 +|33.|(% style="width:392px" %)Value=0|(% style="width:1261px" %)Der Wert legt fest, wo der Installationspfad des Clients sein soll:
87 +0=C:\ACMPClient
88 +1=1:\Programme (x86)\ACMPClient
89 +
90 +{{aagon.infobox}}
91 +Die Bandbreitenbeschränkung (Zeilen 8 und 14) wird dann genutzt, wenn keine Client-spezifische Beschränkung innerhalb der Registry des Clients hinterlegt wurde. Eine mögliche Änderung auf dem ACMP Server wird ohne Neustart des Agentendienstes übernommen.
92 +{{/aagon.infobox}}
93 +
94 +[[Konfigurierte settings.ini>>image:66_Settings.ini_Beispiel einer größeren Datei_421.png]]
95 +
96 +{{aagon.infobox}}
97 +Manuelle Änderungen an der settings.ini lassen sich direkt über den Texteditor Ihrer Wahl vornehmen, indem Sie die entsprechende Stelle korrigieren und die Datei dann speichern.
98 +{{/aagon.infobox}}
99 +
100 +== Vorgehen des Clients ==
101 +
102 +Sobald innerhalb einer settings.ini ein oder mehrere Mappings hinterlegt wurden, werden die angegebenen Server zuerst ignoriert. Der Client überprüft alle eingetragenen Mappings und kontrolliert bei jedem einzelnen Mapping, ob die aktuelle IP-Adresse mit den Angaben aus der Sektion übereinstimmt. Falls die IP passt, trägt der Client den Server in seine Serverliste ein, der unter „PreferredServer“ gespeichert wurde. Sollte gar kein Mapping dazu passen, so werden sämtliche Server der Reihe nach in die Serverliste eingetragen.  Sollte der Client den aktuellen Server nicht erreichen, greift er auf den nächsten innerhalb seiner Liste zurück. Bei weiteren Serveranfragen wird als erstes wieder der zuletzt erreichbare Server kontaktiert. Bei einem Agentenneustart wird erneut versucht, den primären Server zu erreichen.
103 +
104 +{{aagon.infobox}}
105 +Sollten die Eingaben unter NetworkAddress oder NetworkMask fehlen oder ungültig sein, werden die Werte mit der Eingabe 0.0.0.0 behandelt. Daraus folgt, dass sich der Client nicht in einem Bereich befindet, der abgedeckt wird. Hierdurch wird der Server nicht in die Serverliste eingetragen.
106 +{{/aagon.infobox}}
107 +
108 +
66_Settings.ini_Beispiel einer größeren Datei_421.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.SV
Größe
... ... @@ -1,0 +1,1 @@
1 +22.8 KB
Inhalt
© Aagon GmbH 2026
Besuchen Sie unsere Aagon-Community