# Case Studies

# Dynamic group with multiple criteria

To update applications, we can create a dynamic group using a combination of criteria:

For example, I want to create a dynamic group that contains Windows 11 Pro machines, a specific software, and a specific software version.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/9QGcTFi40Lnce7mX-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/9QGcTFi40Lnce7mX-image.png)

We add a section, "Installed Software," to our group:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/QsHOOX6puwzJjBSk-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/QsHOOX6puwzJjBSk-image.png)

Then another section, "Software Version":

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/mQxReN41asfoB6Tf-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/mQxReN41asfoB6Tf-image.png)

Next, we’ll save our group and orchestrate it by clicking “**<span style="color:rgb(0,0,0);background-color:rgb(255,255,255);">Go to Save Step.”</span>**

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/PplERISRIOA4kbNd-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/PplERISRIOA4kbNd-image.png)

We’ll specify a Boolean operator in the sub-queries and then click “**Save.”**

Once my group is created, I can interact with it and initiate a deployment of a new version of Notepad++.

# Application convergence (Positive convergence)

From the Medulla interface, you can deploy packages to a group, whether static or dynamic.

In the case of a dynamic group, you can enable application convergence.

What is application convergence? :

Application convergence is a deployment task that repeats every 24 hours to verify that the package(s) you have defined for convergence are properly deployed; if a new workstation or an existing workstation in the group does not have the package installed, it will deploy that package.

In summary, application convergence allows you to maintain application compliance across your fleet.

<span style="color:rgb(0,0,0);">How does it work? :</span>

First, once in the Médulla interface, go to the Computers tab. In the left-hand menu, select the group for which you want to enable application convergence.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/1ULlUtrqSiCuCQ6o-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/1ULlUtrqSiCuCQ6o-image.png)

Click the Deployment button: [![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/kFeFBTMsgixJaWhV-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/NP8gGy6bCUdYZ11I-image.png)

You will then enter the menu that allows you to select the package you want to converge:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/D7A44Y5LCKJKF7NB-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/D7A44Y5LCKJKF7NB-image.png)

<span style="color:rgb(0,0,0);"> Click the Application Convergence button [![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/LR2jXkeNFBOQWcG3-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/bq6ByZ9stUwMNn2U-image.png)</span>

You will then enter the convergence scheduling menu:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/t1v8aUdHjDAM6R4A-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/t1v8aUdHjDAM6R4A-image.png)

You can use the following available options:

**Command name:**

**Deployment interval:**

**Queue priority:**

**Peer-to-peer deployment:**

Then click **"Confirm"** and convergence will be activated.

Once enabled, convergence will begin.

You can find information about the execution of your convergences in the Audit tab:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/237nsYRQAy2jbBRu-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/237nsYRQAy2jbBRu-image.png)

Three entries in the left-hand menu allow you to track your convergences:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/QnmfwYt3qrBWmreX-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/QnmfwYt3qrBWmreX-image.png)

**My Convergences:**

Allows you to view the convergences scheduled by the current user of the session.

**Convergences for All Users:**

If you have administrator rights, you can view all convergences that have been scheduled by Medulla users.

**My Team's Convergences:**

Allows you to view the appointments scheduled by users who are in the same group as you.

# Application convergence (Negative convergence)

Negative convergence allows you to uninstall packages that have been installed in dynamic groups.

In the case of a dynamic group, you can enable negative convergence

What is negative convergence? :

Negative convergence is an uninstallation task that repeats every 24 hours to verify that the package(s) you have defined for negative convergence are not deployed; if a new workstation or an existing workstation in the group has the package installed, it will uninstall that package.

In summary, negative convergence allows you to maintain application compliance across your fleet.

How does it work? :

First, once in the Médulla interface, go to the Computers tab. In the left-hand menu, select the group on which you want to enable negative convergence.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/1ULlUtrqSiCuCQ6o-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/k4Sck8mdsa5zdWBs-image.png)

Click the Deployment button: [![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/kFeFBTMsgixJaWhV-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/NP8gGy6bCUdYZ11I-image.png)

You will then enter the menu that allows you to select the package you want to apply negative convergence to:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/oUoY2AxQYOgamQQL-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/oUoY2AxQYOgamQQL-image.png)

 Click the Negative Convergence button [![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/FcSQQEGkJt9Q9Erw-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/Xhoi9M2PFkdttQfQ-image.png)

You will then enter the convergence configuration menu:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/FOgsH8aRD82n7G5C-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/FOgsH8aRD82n7G5C-image.png)

You can use the following available options:

Command name:

Deployment interval:

Then confirm, and negative convergence will be activated.

Once activated, negative convergence begins.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/X8Th6bVPXIfSFgMA-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/X8Th6bVPXIfSFgMA-image.png)

Three entries in the left-hand menu allow you to track your convergences:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/QnmfwYt3qrBWmreX-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/JEhU3xiynZTPs1Gr-image.png)

My Convergences:

Allows you to view the convergences scheduled by the current user of the session.

All Users' Convergences:

If you have administrator rights, you can view all the convergences that have been scheduled by Medulla users.

My Team's Convergences:

Allows you to view the appointments scheduled by users who are in the same group as you.

# Software deployment

Once you have created a package in Medulla (doc: [Create a package](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/page/creer-un-package)), you can deploy it to any computer.

Go to the Computer &gt; Deployment view (quick action) ![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/kFeFBTMsgixJaWhV-image.png) OR, on a computer group, Deployment (quick action).

The list of packages available for deployment is displayed, along with a " ![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/lXxicyLa1bFKxh3b-image.png)" button to start deploying the package:

![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/6DPIqN929mfpVsth-image.png)

The deployment will start immediately and be available in the Audit view: [Audit](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/chapter/chapitre-9-audit)

The " ![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/jz4JZKxh7kOSN0Hc-image.png)" button allows you to customize the deployment launch:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/C1fCd2kiYUWBRguC-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/C1fCd2kiYUWBRguC-image.png)

To launch a positive convergence, go here: [Positive Convergence ](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/page/la-convergence-applicative-convergence-positive)

To launch a negative convergence, go here: [Negative convergence](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/page/la-convergence-applicative-convergence-negative)

# Create a package

In the Packages view, click Add Package in the left-hand menu.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/imZmqi0yZTxkS7mc-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/imZmqi0yZTxkS7mc-image.png)

You may or may not assign an installation (setup) file, and click "Upload pending files" if necessary.

Fill out the various sections.

You can add other packages as dependencies.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/PSwnOmMlE3vYkQil-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/PSwnOmMlE3vYkQil-image.png)

In the example above, I will enter the value for Launcher (Kiosk): "C:\\Program Files\\Notepad++\\Notepad++.exe", if my package is intended for the Kiosk and to be installed in the default location "C:\\Program Files\\Notepad++\\".

An auto-generated script allows you to silently run the installer file added earlier.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/gqJW3Osxx6LhGyE1-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/gqJW3Osxx6LhGyE1-image.png)

You can associate an inventory with the package using the "**Associate Inventory"** button, which will make it available in **both Kiosk and**  **Convergence**.

Fill out the relevant section as follows (auto-completion will appear if other machines in your IT infrastructure have reported this software in their inventory):

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/i2GSDErvf5tG5SSv-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/i2GSDErvf5tG5SSv-image.png)

To perform a negative convergence with this package, or to make the package uninstall available via the Kiosk, you must perform the following actions:

- You can add uninstallation sections as follows if you want to be able to uninstall the application in the solution from the Kiosk.
- Add an uninstallation section in the left-hand menu.
- Then add a command and set the uninstall command.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/GSubdQOuntDGhGVr-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/GSubdQOuntDGhGVr-image.png)

Many actions are possible within a package’s workflow.

Click **"Validate"**.

The package is ready

Kiosk:

To add my application to the kiosk profiles and create a profile, click on this section of the documentation: [Chapter 3: Kiosk](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/chapter/chapitre-3-kiosk "Chapitre 3 : Kiosk")

Convergence:

To deploy my package via Convergence, here is the Convergence deployment section: [Convergence](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/page/la-convergence-applicative-convergence-positive)

# Mastering via PXE

To master an image, follow the steps below:

- Boot the machine via PXE and register it:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/scaled-1680-/Zpiol0b0UExFk2M7-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/Zpiol0b0UExFk2M7-image.png)

Type the machine name at the prompt:

In our example, I used the machine gla-win-2. Press Enter, then answer the question with Y if the name is correct or N if it is incorrect and you need to make changes.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/scaled-1680-/4bjgUvvzTxyspkbe-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/4bjgUvvzTxyspkbe-image.png)

When the machine reboots, if you followed the steps in [Imaging Profiles](https://docs.medulla-tech.io/books/medulla-guide-dutilisation-pas-a-pas/page/les-profils-dimaging "Les profils d'imaging"), simply select the master associated with the profile; or if you are using a standard post-install, you will see the master’s name along with the associated post-install.

Below, after the machine has been registered, you’ll see the menu with an additional line:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/scaled-1680-/N0pnIhgK7CfcIdH7-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/N0pnIhgK7CfcIdH7-image.png)

Click on your master and wait a few minutes; your machine will reboot and come back up in the Medulla console.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/scaled-1680-/hmYSyOaphWqpjmSK-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/hmYSyOaphWqpjmSK-image.png)

# Getting Started with Remote Access

##### ![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/IsCipzZJi1LezMH2-image.png)**Remote Access** Direct access to machines to perform troubleshooting or maintenance tasks: 

This allows you to take control of the remote machine in three possible ways:

<span style="text-decoration:underline;">Windows: </span>

- <span style="text-decoration:underline;">CMD</span>
- <span style="text-decoration:underline;">VNC</span>
- <span style="text-decoration:underline;">RDP</span>

When you click the button, a pop-up appears allowing you to choose which protocol you want to use:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/RHvuLqHJ1iFyFWIE-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/RHvuLqHJ1iFyFWIE-image.png)

For VNC, by default, an authorization request is sent to the user, and the user must grant you permission.

If you need to temporarily disable the authorization request for a maintenance operation while the user is away from their workstation, you can do so for the duration of the session:

Click the quick action button, uncheck the " <span style="text-decoration:underline;">*Ask user approval*</span> " box, then click the take control button.

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/oJJkiNCs8InpPmaU-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/oJJkiNCs8InpPmaU-image.png)

Remote access via CMD:

[![CMD.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/scaled-1680-/263VASg1QgccIWlQ-cmd.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/263VASg1QgccIWlQ-cmd.png)

Remote access via VNC:

[![VNC.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/scaled-1680-/lTWb7hv6mnYDQ7ck-vnc.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/lTWb7hv6mnYDQ7ck-vnc.png)

Remote access via RDP:

[![RDP.png](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/scaled-1680-/BNHtf8W5fyhi3c29-rdp.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/BNHtf8W5fyhi3c29-rdp.png)

# XMPP Console

The Medulla solution is a client/server solution based on the XMPP protocol.

This protocol allows Medulla to provide users with an XMPP console, enabling them to execute non-interactive commands directly on workstations.

This console allows for initial diagnostics or retrieving information about the workstations from the server.

How to do it:

Click on the console icon: [![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/z6OSmUc5vtuUIWq1-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2025-07/jdC7uM2ET09icPjg-image.png)

The following screen appears:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/2hLgJAOJKdegZykc-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/2hLgJAOJKdegZykc-image.png)

Type your command and get the result instantly:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/7waft1ylkBUnWe8A-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/7waft1ylkBUnWe8A-image.png)

# Agent inventory

To view a machine's inventory, go to the Computer view.

Select the computer whose inventory you wish to view, then in the Actions menu to the right of the row, click the button: ![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/RaqSBKzLsIkFjHfS-image.png)

You will then see a tabbed panel displaying the complete inventory of a machine:

[![image.png](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/scaled-1680-/vTZorxv0l9NaVxhN-image.png)](https://docs.medulla-tech.io/uploads/images/gallery/2026-03/vTZorxv0l9NaVxhN-image.png)

# Imaging menus

<p class="callout info">**Applies to:** Medulla – Imaging  
**Version:**5.4.3 or later  
**Environment:** On-Premise / Private SaaS with imaging relay.  
**Category:** Usage</p>

This document focuses on the management and generation of imaging menus.

##### What is an imaging menu?

An imaging menu is a collection of services and masters associated with a machine, which can be used during a machine’s (network) boot sequence.  
During a PXE boot, the machine requests its menu from its server. Several scenarios are possible:

- The machine has no associated menu: the server assigns it a default menu
- The machine is part of a group of machines: the server sends it the menu associated with that group.
- The machine is not part of a group and has an associated menu: the server sends it that menu.

The rest of the imaging process depends on the contents of this menu.

There are different levels of menus:

- The imaging server menus 
    - The register menu
    - The default menu
- The machine menu
- The Groups menu

##### The imaging server menus:

- The register menu:

This menu is fixed. It consists of the following services:  
\- **continue**: This service allows you to start the machine normally.  
\- **register:** this service allows you to register a machine in the imaging system.

- The default menu

Each imaging server receives a default menu. This menu consists of the following services:  
\- `continue`: This service allows you to boot the machine normally.  
\- `backup`: creates a copy of the machine's disk in the imaging system.

- Modifications

This menu can be modified via the MMC interface.

Changes to the default menu do not affect the menus of machines or groups. For machines to benefit from changes to the default menu, it is necessary to perform a "reset" of the entity's menus.

- Add / Remove a Service

Several services that can be added to the menu are available.

<p class="callout success">The page defining the services available in a menu is as follows:  
MMC &gt; Imaging &gt; Manage Menu Services.</p>

On this page, services are associated with the selected entity. Changing the entity modifies the list of services associated with that entity.

- Add / Remove a Master

This section does not cover how to convert an image into a master.

Masters present on the imaging server can be associated with the default menu.

<p class="callout success">The page for associating masters with the default menu is as follows:  
MMC &gt; Imaging &gt; Manage Masters.</p>

- Change the order of services and masters

<p class="callout success">The various services and masters associated with the default menu can be viewed on the following page:  
MMC &gt; Imaging &gt; Default Startup Menu.</p>

On this page, you can change the order of menu items. You can also modify settings specific to the associated items.

- Minimum services for a menu

<p class="callout warning">Currently, a menu must contain at least one service (or one image). Generally, the `continue` service is required for the menu to function.</p>

The minimum service must have the following options enabled:

\- **Default enabled** so that this service is selected by default  
\- **Visible enabled** so that this service is visible in the startup menu  
\- **Default WOL** enabled to prevent a traceback, even though I don’t know what this option is for.

<p class="callout warning">A fix is being considered to prevent the removal of the last service from a menu.</p>

- The machine menu

<p class="callout success">A machine's menu is accessible from the following page:  
**MMC &gt; Machines &gt; action:Imaging Management.**</p>

This page is organized into three tabs:  
\- **Startup Menu**: This tab allows you to view and edit the menu.  
\- **Menu Services**: This tab allows you to associate services with the machine menu.  
\- **Images and Masters**: This tab allows you to associate masters with the machine menu.

A machine menu should not be empty. If it is, there are several possibilities:  
\- The machine copied an empty default menu (unlikely, since copying in this situation usually generates a traceback).  
\- An administrator has deleted all items from the machine's menu.

- The group menu

Basically, a group menu is similar to a machine menu. However, it is associated with an imaging group, not a specific machine.

<p class="callout success">To access it, go to the following page:  
MMC &gt; Imaging &gt; All Imaging Groups &gt; action:Imaging Management.</p>

A group menu takes precedence over a machine menu. When you view a machine’s menu page, you may **\*\*not see\*\*** the header line indicating that the machine is part of a group.

In this case, the machine displays its own custom menu, not the group’s menu. This can cause confusion for the administrator.