Test Client Command

Last modified by Sabrina V. on 2026/07/31 06:19

In the Testing phase, you can execute and test Client Commands on selected clients. If the test fails, you can move the Client Command back to the Create phase using a button or the context menu. Otherwise, you can move the Client Command to the Synchronize phase using a button or the context menu.

34_64_ClientCommands_ClientCommanderstellen_1337.png

Testing phase

The Console lists the Client Commands that are currently in the Test phase. These are displayed with the same properties as in the Creation phase. Using the drop-down list at the top, you can also display all Client Commands or display only those with the status Released (Phase 4).

To test a client command, you need test clients. Using the Test Environment icon, you can view and edit a list of all test clients. Using the corresponding buttons, you can refresh the list, add and remove test clients, and test client commands.

Hinweis  Note:  

Clients added as test clients always retrieve their data directly from the ACMP Server. This applies not only to Client Commands to be tested but also to all other Client Commands and Updates. Therefore, you should only select clients that have sufficient bandwidth to the Server.

Client Command Properties

Script_Console

Part of the client command is executed in the ACMP Console.

Script_Client

Part of the client command is executed on the client.

ClientCommandPhase_Release

The client command has at least one released version.

SelectiveSync.ico

The client command can only be synchronized with selected file repositories.

ClientCommand_Interactive

The client command can be executed via the ACMP Kiosk.

PassWord_Locked.ico

The Client Command is password-protected.

Add Test Clients

To add a test client, click the Test Environment button. A wizard opens with a view similar to the Query Management interface. Here, you can execute all Queries from Query Management. Then select one or more test clients and click the Add button.

Testumgebung konfigurieren
Configure the test environment

You can remove test clients by selecting the corresponding test client and then clicking Remove Clients. Checking the checkboxes next to the client names causes any conditions (such as “If operating system is (not)”) in the Client Command to be ignored when testing the command on the corresponding client. This also allows you to test Client Command versions whose configured conditions you cannot meet in the test environment (e.g., “is user in group”).

Hinweis  Note:  

Use systems as test clients whose hardware and software configurations are as close as possible to those of the target platforms. This ensures that the test results are meaningful for the production environment.

Hinweis  Note:  

Note that clients located in the test environment execute the highest possible phase of the Client Command. This also applies to jobs running on clients that are not on the test interface.

Testing a Client Command

To test a Client Command, click the Execute icon. In the dialog that opens, you can select the Client Commands to be tested from a list. Move the selected Client Commands to the right column. You can do this via drag-and-drop or using the corresponding buttons. Client Commands that were selected before the dialog was opened are automatically added to the right column.

In the second step, you can now select the test clients on which the Client Commands will be tested. Click OK to start the tests.

Test Results

On the right-hand side, all tests executed with the current Client Command are listed. The test clients on which the test was run are listed along with the version being tested. Additionally, the time of each test is displayed, along with an icon indicating whether the test was successful or not. You can view the test protocol for each test by clicking the protocol icon.

© Aagon GmbH 2026
Besuchen Sie unsere aagon-Community