Wiki source code of Unix Scripts

Last modified by jklein on 2025/07/28 08:58
Show last authors
1 {{aagon.floatingbox/}}
2
3 With Unix Scripts, ACMP 6.8 and higher allow you to execute shell scripts on managed Clients with Linux and macOS systems or have them executed on a schedule. Previously, this was only possible for managed Clients with Windows operating systems.
4
5 [[Overview - Unix Scripts>>image:Unix Scripts_Übersicht.png||alt="“Overview"]]
6
7 = Manageability of Linux and MacOS Clients =
8
9 Previously, Clients running a Linux or MacOS operating system could be detected and inventoried with the Unix Agent, but could not be managed. Newly detected Linux and MacOS Clients that are detected with the Unix Agent version 1.11 or higher can now be managed. This also enables the automated, time-controlled execution of Unix Scripts as Jobs.
10
11 {{aagon.infobox}}
12 All Linux and MacOS clients that were detected with Unix Agent version 1.10 or older cannot be managed! To make your clients with Linux or MacOS systems manageable, you must detect your already detected Linux and MacOS clients again using Unix Agent.
13 {{/aagon.infobox}}
14
15 = Registering Linux and MacOS clients with the Unix Agent =
16
17 Linux and MacOS clients are still registered with the Unix Agent, which can be imported and then executed using the corresponding Client Command.
18
19 {{aagon.warnungsbox}}
20 For correct detection, which makes the clients manageable, at least version 1.11 of the Unix Agent must be used. Otherwise, your Linux and MacOS clients will be detected and inventoried, but will not be manageable.
21 {{/aagon.warnungsbox}}
22
23 For more information on the correct execution, configuration, and distribution of the Unix Agent, see the section [[Unix Agent>>doc:ACMP.68.Arbeiten mit der ACMP Console.Clients erfassen.Unix Agent installieren.WebHome||anchor="“HKonfigurationdesUnixAgents”"]].
24
25 = System requirements =
26
27 There are several requirements for your system to use Unix scripts on your managed Linux and macOS Clients.
28
29 * The SICS is installed on a server.
30
31 * The ACMP Server is connected to the SICS.
32
33 * SICS users are allowed access to the public API.
34
35 * Your Linux and MacOS clients have been detected with Unix Agent version 1.11 or higher and marked as manageable clients (see Status of Linux and MacOS clients).
36
37 = Occurrence of Unix scripts =
38
39 In principle, Unix scripts can be created, managed, and versioned in the Desktop Automation > Unix Scripts module. However, you must configure the test and release process for Unix scripts under System > Settings > Unix Scripts. For more info, see the sections Manage Unix Scripts and Configure the test and release process for Unix scripts. The corresponding sections can be identified in the ACMP Console by the script icon [[image:Ico_UnixScript.png||height="“24”" width="24"]]
40
41 [[Occurrence of Unix scripts in ACMP>>image:Unix Scripts_Vorkommen.png||alt="“Occurrence"]]
42
43 The actual execution of Unix scripts takes place via Unix jobs. Unix jobs and options for monitoring jobs can be identified in the ACMP Console by the Unix icon [[image:Ico_UnixClient.png||height="“24”" width="24"]] . You can execute and monitor Unix jobs as follows:
44
45
46 * The [[manual execution>>doc:ACMP.68.ACMP-Solutions.Jobs.WebHome||anchor="“HEinenmanuellenJobausfFChren”"]] of Unix scripts is [[in the Query Actions tab in the ribbon bar>>doc:ACMP.68.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Abfrageaktionen .WebHome]] via the Execute Unix Jobs button.
47
48 * The recurring, time-controlled execution of Unix scripts is possible via the [[Integration of Unix Jobs in Containers>>doc:ACMP.68.ACMP-Solutions.Jobs.WebHome||anchor="“HExecute"]] option.
49
50
51 * Unix jobs can be monitored in the [[Job Dashboard>>doc:ACMP.68.ACMP-Solutions.Jobs.Job Dashboard.WebHome]] and [[in the Monitors tab in the ribbon bar>>doc:ACMP.68.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome]] via the job or client monitor.
52
53 Detailed information on executing the various types of jobs can be found in the section [[Jobs>>doc:ACMP.68.ACMP-Solutions.Jobs.WebHome]].
54
55
56 = Licensing =
57
58 Licensing for Unix scripts is combined with Client Commands under the Desktop Automation solution. Since the license metric for the Desktop Automation solution is specified as floating, each registered Unix client must have its own license so that Unix jobs can be executed on the client.
59
60 {{aagon.infobox}}
61 If a Unix client does not have a license, the execution of a Unix job on this client is skipped.
62 {{/aagon.infobox}}
63
64 (% class="box infomessage" %)
65 (((
66 [[image:https://doc.aagon.com/bin/download/XWiki/Aagon Infobox/WebHome/Information.svg||alt="“Note”" height="32" width="32"]] **Note: **
67
68 If a Unix client does not have a license, the execution of a Unix job on this client will be skipped.
69 )))
70
71 = Status of Linux and macOS clients =
72
73 Scripts and jobs can only be executed on manageable Linux and macOS clients. You can see whether a client is manageable or not in ACMP by looking at the client icon.
74
75 |=(% style="width: 138px;" %)Icon|=(% style="width: 1301px;" %)Meaning
76 |(% style="width:138px" %)[[image:XWiki.Images.WebHome@oslinux.png||height="“24”" width="24"]][[image:XWiki.Images.WebHome@osmac.png||height="“24”" width="24"]]|(% style="width:1301px" %)Linux and MacOS clients with these icons are not manageable. No scripts or jobs can be executed for these clients.
77 |(% style="width:138px" %)[[image:ACMP.68.ACMP-Solutions.Jobs.WebHome@Ico_ClientType_Linux_Managed.png||height="“24”" width="24"]] [[image:ACMP.68.ACMP-Solutions.Jobs.WebHome@Ico_ClientType_MacOs_Managed.png||height="“24”" width="24"]]|(% style="width:1301px" %)Linux and MacOS clients with these icons are manageable. Scripts and jobs can be executed for these Clients.
78
79 [[Display of Client manageability via the Client icon>>image:Client Status_Unix Clients.png||alt="“Display"]]
© Aagon GmbH 2025
Besuchen Sie unsere Aagon-Community