Changes for page Unix Agent installieren

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,7 +1,7 @@
1	1	{{aagon.floatingbox/}}
2	2
3	3	(% class="wikigeneratedid" %)
4		-The Unix Agent is the completely renewed and technically revised further development of the Linux and Mac agents. The agent can be deployed and installed without Python using a supplied Client Command. The inventory data is transmitted to the ACMP Server in full and updated.
	4	+The Unix Agent is the completely renewed and technically revised further development of the Linux and Mac agents. The agent can be deployed and installed without Python using a supplied Client Command. The inventory data is transmitted to the acmp Server in full and updated.
5	5
6	6	{{aagon.infobox}}
7	7	If you use Unix clients that are not connected to the network, you can inventory them using the [[Unix Offline Scanner>>doc:ACMP.610.Arbeiten mit der ACMP Console.Clients erfassen.Offline Scanner.WebHome||anchor="“HRunUnixOfflineScanner”"]].
...	...	@@ -8,7 +8,7 @@
8	8	{{/aagon.infobox}}
9	9
10	10	{{aagon.versionierungsbox}}
11		-Please note that the assignment of a maintenance window profile to containers with Unix agents is only supported in its full form starting with AESB version 1.12. Additionally, creating a maintenance window profile is possible starting with ACMP version 6.9.
	11	+Please note that the assignment of a maintenance window profile to containers with Unix agents is only supported in its full form starting with aesb version 1.12. Additionally, creating a maintenance window profile is possible starting with acmp version 6.9.
12	12	{{/aagon.versionierungsbox}}
13	13
14	14	= Installation requirements =
...	...	@@ -15,17 +15,17 @@
15	15
16	16	There are several requirements for you and your system for installing the Unix Agent.
17	17
18		-=== Requirements for your knowledge of ACMP ===
	18	+=== Requirements for your knowledge of acmp ===
19	19
20	20	* You have a basic understanding of how to configure SICS.
21		-* You know how to import Client Commands into ACMP.
	21	+* You know how to import Client Commands into acmp.
22	22	* You know how to execute Client Commands.
23	23
24	24	=== Requirements for your environment ===
25	25
26		-* ACMP is installed.
	26	+* acmp is installed.
27	27	* SICS is installed on a server.
28		-* The ACMP Server is connected to SICS.
	28	+* The acmp Server is connected to SICS.
29	29	* SICS users are allowed to access the public API.
30	30
31	31	=== Requirements for your MacOS and Linux systems ===
...	...	@@ -40,7 +40,7 @@
40	40	* Firewall settings for SICS must be customizable if necessary.
41	41
42	42	{{aagon.infobox}}
43		-Please note that the Unix Agent has been advanced with additional scanners in ACMP version 6.10. The System Scanner requires certain packages for this purpose, which must be installed or downloaded on Linux environments.
	43	+Please note that the Unix Agent has been advanced with additional scanners in acmp version 6.10. The System Scanner requires certain packages for this purpose, which must be installed or downloaded on Linux environments.
44	44
45	45	The Unix Agent reads the TPM information from the physical devices and then populates certain fields (e.g., “TPM enabled,” “TPM on,” or “TPM manufacturer”) with the corresponding values.
46	46
...	...	@@ -63,9 +63,9 @@
63	63
64	64	= Installation with the Client Command =
65	65
66		-An existing SICS connection to the ACMP server is required to install the Unix Agent. If you have not yet configured a SICS connection, you must do so first. Instructions for configuring the SICS connection can be found in the section [[Configuring the SICS connection>>doc:AESB.111.AESB installieren, konfigurieren und aktualisieren.SICS-Verbindung konfigurieren.WebHome]].
	66	+An existing SICS connection to the acmp server is required to install the Unix Agent. If you have not yet configured a SICS connection, you must do so first. Instructions for configuring the SICS connection can be found in the section [[Configuring the SICS connection>>doc:AESB.111.AESB installieren, konfigurieren und aktualisieren.SICS-Verbindung konfigurieren.WebHome]].
67	67
68		-The Unix Agent is installed using a Client Command in ACMP. To do this, the Client Command must first be imported and released.
	68	+The Unix Agent is installed using a Client Command in acmp. To do this, the Client Command must first be imported and released.
69	69
70	70	{{aagon.warnungsbox}}
71	71	Installing the Unix Agent stops and removes the Linux Agent.
...	...	@@ -77,12 +77,12 @@
77	77
78	78	The file for the required Client Command of the Unix Agent is named as in the following example:
79	79
80		-{{{ACMP Unix Agent verteilen & Inventory__{1F5A4238-731B-44B6-84F0-3EFB8F2D3222}.sim}}}
	80	+{{{acmp Unix Agent verteilen & Inventory__{1F5A4238-731B-44B6-84F0-3EFB8F2D3222}.sim}}}
81	81
82		-For information on how to import and release a Client Command in ACMP, refer to the section [[Create Client Commands>>doc:ACMP.610.ACMP-Solutions.Desktop Automation.Client Commands.Client Command erstellen.WebHome||anchor="HImport"]].
	82	+For information on how to import and release a Client Command in acmp, refer to the section [[Create Client Commands>>doc:ACMP.610.ACMP-Solutions.Desktop Automation.Client Commands.Client Command erstellen.WebHome||anchor="HImport"]].
83	83
84	84	{{aagon.warnungsbox}}
85		-To ensure that clients are properly detected and can be managed, you must use a version of the Unix Agent that is compatible with your ACMP version. Otherwise, your Linux and macOS clients will not be detected as manageable clients.
	85	+To ensure that clients are properly detected and can be managed, you must use a version of the Unix Agent that is compatible with your acmp version. Otherwise, your Linux and macOS clients will not be detected as manageable clients.
86	86	{{/aagon.warnungsbox}}
87	87
88	88	=== Execute Client Command ===
...	...	@@ -89,7 +89,7 @@
89	89
90	90	After you have released the Client Command, you can execute it.
91	91
92		-In the ACMP Console, navigate to Client Commands > Execute. Then double-click to select the Client Command for the Unix Agent.
	92	+In the acmp Console, navigate to Client Commands > Execute. Then double-click to select the Client Command for the Unix Agent.
93	93
94	94	In the dialog window that opens, click the //Execute// button. The Client Command interface opens, where you can configure the installation of the Unix Agent.
95	95
...	...	@@ -101,7 +101,7 @@
101	101
102	102	=== SSH credentials ===
103	103
104		-The Unix Agent is transferred to the target computers via SSH; valid user data must be entered accordingly. Unlike the Linux Agent, the Unix Agent transfers the scan data directly to the ACMP Server.
	104	+The Unix Agent is transferred to the target computers via SSH; valid user data must be entered accordingly. Unlike the Linux Agent, the Unix Agent transfers the scan data directly to the acmp Server.
105	105
106	106	{{aagon.warnungsbox}}
107	107	The user whose user data is specified as SSH credentials for the installation must be created on each of the target computers and have “sudo” rights (superuser do) there.
...	...	@@ -117,7 +117,7 @@
117	117
118	118	**SICS user**
119	119
120		-For the SICS user, you can create an AESB user with minimal permissions. This user must be created in the AESB console. For more info, see the section [[managing AESB users>>https://doc.aagon.com/bin/view/AESB/111/Workspaces/Benutzer/#HBenutzerverwalten]].
	120	+For the SICS user, you can create an aesb user with minimal permissions. This user must be created in the aesb console. For more info, see the section [[managing aesb users>>https://doc.aagon.com/bin/view/AESB/111/Workspaces/Benutzer/#HBenutzerverwalten]].
121	121
122	122	**SICS server**
123	123
...	...	@@ -127,7 +127,7 @@
127	127	* wss:~/~/hostname:port
128	128	* wss:~/~/FQHN:port (Fully Qualified Host Name)
129	129
130		-Please note that all target computers require access to this endpoint. You assigned the additional user credentials for the operator during the AESB installation.
	130	+Please note that all target computers require access to this endpoint. You assigned the additional user credentials for the operator during the aesb installation.
131	131
132	132	**SICS Fallbacks**
133	133
...	...	@@ -143,7 +143,7 @@
143	143
144	144	**Enable logging**
145	145
146		-By selecting the //Enable logging// option, you can load the logs to your machine (or the machine with the ACMP Console) after installation or execution. Enabling logging is already available at this point in the Client Command and can be useful, as errors may occur during installation or execution as Inventory One-Time-Scan.
	146	+By selecting the //Enable logging// option, you can load the logs to your machine (or the machine with the acmp Console) after installation or execution. Enabling logging is already available at this point in the Client Command and can be useful, as errors may occur during installation or execution as Inventory One-Time-Scan.
147	147
148	148	**One-time scan**
149	149
...	...	@@ -151,11 +151,11 @@
151	151
152	152	**Agent installation**
153	153
154		-To install the Unix Agent as a permanent resource, you can execute the agent in the //Agent Installation// mode. The Unix Agent is now transferred to the target computer and registered as a service. Following installation, the agent starts automatically and obtains its configuration from ACMP within 10 minutes. The agent is now entered as a client in ACMP and contains the basic client details. The execution file can be found under the path: ##/usr/local/sbin/aagon/ACMPUnixAgent/##
	154	+To install the Unix Agent as a permanent resource, you can execute the agent in the //Agent Installation// mode. The Unix Agent is now transferred to the target computer and registered as a service. Following installation, the agent starts automatically and obtains its configuration from acmp within 10 minutes. The agent is now entered as a client in acmp and contains the basic client details. The execution file can be found under the path: ##/usr/local/sbin/aagon/ACMPUnixAgent/##
155	155
156	156	The agent also uses another directory to store various resources that are relevant to the agent. This directory can be found under the path:## /etc/aagon/ACMPUnixAgent/##
157	157
158		-The Agent Tasks templates are used to execute the scanners. These can be used in exactly the same way as with the ACMP Windows Agent (Container). The following jobs are currently taken into account within the Agent Tasks:
	158	+The Agent Tasks templates are used to execute the scanners. These can be used in exactly the same way as with the acmp Windows Agent (Container). The following jobs are currently taken into account within the Agent Tasks:
159	159
160	160	* System scanner
161	161	* Software scanner
...	...	@@ -209,7 +209,7 @@
209	209
210	210	----
211	211
212		-**Symptom:** After distributing the Unix Agent using the Client Command, the Unix client does not appear in ACMP.
	212	+**Symptom:** After distributing the Unix Agent using the Client Command, the Unix client does not appear in acmp.
213	213
214	214	**Cause:** An error occurred during the execution of the Client Command, but was not immediately apparent due to the settings.
215	215
...	...	@@ -216,11 +216,11 @@
216	216	**Action:** In the properties of the Client Command in the plugin //Options //in the Combobox //Show console log// enable the option //Only on errors// and confirm the
217	217	dialog with //OK//. After executing the Client Command again, a console log should now be displayed in the event of an error, which may provide information about the cause of the problem.
218	218
219		-If the Unix systems still do not appear in ACMP, there may be many reasons for this. It is therefore recommended to activate logging for the agent and the SICS. Then go through the chain from start to end.
	219	+If the Unix systems still do not appear in acmp, there may be many reasons for this. It is therefore recommended to activate logging for the agent and the SICS. Then go through the chain from start to end.
220	220
221	221	----
222	222
223		-**Symptom:** After distributing the Unix Agent using the Client Command, the Unix client does not appear in ACMP. The error “Invalid input detected: endpoint” is displayed in the SmartInspect log.
	223	+**Symptom:** After distributing the Unix Agent using the Client Command, the Unix client does not appear in acmp. The error “Invalid input detected: endpoint” is displayed in the SmartInspect log.
224	224
225	225	**Cause:** An error occurred during the connection to SICS because the protocol may not have been prefixed during the connection. You can see this in the SmartInspect log in the row //Application settings//: ##“SicsEndpoint: <AESB-SICS-NAME_IP>:3950”##
226	226
...	...	@@ -256,17 +256,17 @@
256	256
257	257	----
258	258
259		-**Symptom:** The Unix Agent is running, but the corresponding Unix client does not appear in an ACMP query.
	259	+**Symptom:** The Unix Agent is running, but the corresponding Unix client does not appear in an acmp query.
260	260
261		-**Cause:** The SICS cannot forward the scan data of the Unix Agent to the ACMP Server because the connection is not available.
	261	+**Cause:** The SICS cannot forward the scan data of the Unix Agent to the acmp Server because the connection is not available.
262	262
263		-**Action:** Check in the ACMP Console settings whether the SICS connection of the ACMP Server is still working (in the ACMP Server / SICS connection plugin) and whether the checkbox for SICS users to access the public API is activated. Further information on this problem can be found in the log of the ACMP Server or the Unix Agent.
	263	+**Action:** Check in the acmp Console settings whether the SICS connection of the acmp Server is still working (in the acmp Server / SICS connection plugin) and whether the checkbox for SICS users to access the public API is activated. Further information on this problem can be found in the log of the acmp Server or the Unix Agent.
264	264
265	265	----
266	266
267		-**Symptom:** The Unix client appears in an ACMP query, but no scan data is available.
	267	+**Symptom:** The Unix client appears in an acmp query, but no scan data is available.
268	268
269		-**Cause:** During installation, the system waits between 2 and 10 minutes until the scan settings for this Unix client are retrieved by sending a request to the ACMP Server.
	269	+**Cause:** During installation, the system waits between 2 and 10 minutes until the scan settings for this Unix client are retrieved by sending a request to the acmp Server.
270	270
271	271	**Action: **If necessary, wait a little longer until the scan data has been loaded. If no scan data appears after significantly more than 10 minutes, you should enable logging for all components involved and check the entire chain from start to end for errors.
272	272
...	...	@@ -274,9 +274,9 @@
274	274
275	275	Updating the Unix Agent is done in the same way as its [[installation via a Client Command.>>||anchor="HInstallationwiththeClientCommand"]]
276	276
277		-In this process, the agent is redistributed and installed on the target systems via the ACMP Console. The transfer takes place via SSH using the appropriate permissions. During execution, the existing agent is replaced by the current version and reconfigured as a service.
	277	+In this process, the agent is redistributed and installed on the target systems via the acmp Console. The transfer takes place via SSH using the appropriate permissions. During execution, the existing agent is replaced by the current version and reconfigured as a service.
278	278
279		-The agent then starts automatically and takes over the existing communication with the ACMP Server.
	279	+The agent then starts automatically and takes over the existing communication with the acmp Server.
280	280
281	281	= Administration of Linux and MacOS Clients =
282	282