Quick Actions

Each XMPP relay has a setof quick actions that allow you to interact directly with the machines it manages. These actions are accessible from the list of relays and are designed to simplify common administration, diagnostic, or configuration tasks without requiring advanced technical knowledge.

Here is a detailed overview of each action, its purpose, and the procedure for using it.

1. View the list of installed packages

Purpose
View the software installed on the machines attached to a relay.

Procedure

1. Click the "List of packages" button to the right of the relevant relay.

2. A window opens displaying the installed software, along with their names and versions.

When to use

• To verify the presence of a program.

• To check the software versions deployed.

2. Reconfigure the machines connected to the relay

Objective
Automatically reapply the active configuration to machines connected to the relay.

Procedure

1. Click "Reconfigure".

2. Confirm the action if prompted.

3. The machines will receive the current configuration again.

When to use

• After modifying settings, rules, or configuration files.

• If a machine appears to be out of sync or non-compliant.

3. Change the relay on one or more machines (Switch function)

Objective
Move one or more machines from one relay to another.

Procedure

1. Click "Switch" to the right of the original relay.

2. Select the machines to move.

3. Select the destination relay.

4. Confirm to apply the change.

When to use it

• When performing maintenance or removing a relay.

• When reorganizing the network architecture.

4. Modify the configuration files

Objective
Manually modify the configuration files of a relay or its machines.

Procedure

1. Click "Edit configuration files" (first gear icon)

2. An editing interface opens.

3. Make the necessary changes.

4. Save the changes.

When to use it

• To adjust a specific configuration for a one-time need.

• During a test or manual intervention.

Note: This operation directly affects the system. Use with caution.

5. View current or past quality assurance (QA) checks

Objective
View compliance, security, or quality tests performed on the machines.

Procedure

1. Click "QA Launched".

2. A window displays the list of tests run and their status (passed or failed).

When to use

• To verify that the rules are being properly applied.

• To identify potential malfunctions.

6. Access system actions (advanced diagnostics)

Objective
To use diagnostic or remote intervention tools on a machine.

Procedure

1. Click "Actions" next to the relay.

2. Select one of the available options:

   • Reboot: Restart the machine.

   • Process: View running processes.

   • Disk usage: View the disk space used.

   • Agent version: View the version of the installed software agent.

   • Netstat: displays active network connections.

   • Console: opens a command-line interface.

When to use it

• When a machine is down, running slowly, or unstable.

• For quick diagnostics or manual verification.

7. Banning a machine

Objective
Temporarily block a machine’s access to the system.

Procedure

1. Click "Ban" next to the relay.

2. Confirm the ban.

3. The machine is isolated from the rest of the network.

When to use

• In case of abnormal behavior, suspected compromise, or a critical error.

8. Unbanning a machine

Objective
To lift the block applied to a previously banned machine.

Procedure

1. Click "Unban".

2. The machine regains its normal communication privileges.

When to use

• After the initial problem has been resolved.

• If the machine was blocked incorrectly.

9. Remote Access

Objective
To control a machine remotely as if you were physically in front of it.

Procedure

1. Click "Remote Control".

2. A remote session opens, allowing you to interact with the machine’s graphical interface.

When to use it

• To perform manual operations.

• To diagnose a specific problem.

• When no other automated action is sufficient.

10. Manage relay rules

Objective
View, modify, or add operating rules specific to a relay.

Procedure

1. Click on "Relay Rules" (last gear icon)

2. From the interface:

   • View existing rules.

   • Edit or delete obsolete rules.

   • Add new rules as needed.

When to use it

• To automate repetitive actions.

• To dynamically adapt the relay's behavior to a specific use case.