# AppUserList v2.2 – Application User List

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/
- Published: 2023-09-27T14:51:25+02:00
- Author: balduz84

Eccovi, dopo qualche settimana, una nuova versione di AppUserList: v2.2.

Per chi è nuovo di AppUserList, questo tool è stato sviluppato per permettere di
monitorare agevolmente le applicazioni presenti nei Desktop Citrix (ma non è dipendente
dalla presenza di Citrix stesso…può funzionare ovunque) e mostrare quali applicazioni
vengono effettivamente utilizzate dagli utenti e quante volte nel tempo. Lo scopo
primario è permettere agli amministratori di sistema di comprendere il reale utilizzo
dei pacchetti software presenti nei desktop, valutando quali risultano effettivamente
necessari ed in utilizzo da parte degli utenti.

AppUserList è realizzato tramite 3 componenti:

 * AULMonitor: database centrale dove AULService scrive e da cui AULReport legge
   i dati per generare i report;
 * AULService: agente in esecuzione nelle macchine da monitorare, che si occupa 
   di intercettare gli eseguibili avviati dagli utenti e spedire le informazioni
   ad AULMonitor;
 * AULReport: tool dedicato alla generazione di report; cuore dell’applicazione.

Le nuove installazioni possono essere eseguite direttamente con le componenti presenti
in questa release; per gli aggiornamenti a partire da versioni precedenti alla v2.0,
sono a disposizione per supportarvi nell’aggiornamento del DB AULMonitor. Alcuni
cambi di release hanno introdotto modifiche al DB. Tali modifiche devono essere 
applicate a mano, non avendo una procedura di aggiornamento automatico delle tabelle
e delle viste presenti in AULMonitor.

In questa release ho ottimizzato in particolar modo la componente AULReport, aggiungendo
la possibilità di eseguire l’attivazione del tool tramite file di licenza. In precedenza
AULReport necessitava di essere attivato singolarmente su ogni macchina su cui veniva
installato, causando un pò di difficoltà nel caso di esecuzione su macchine generate
in modalità Citrix MCS o PVS (dove ovviamente l’hostname delle macchine “figlie”
cambia rispetto alla macchina master).

Ho per cui deciso di aggiungere l’opzione per eseguire l’attivazione tramite file
di licenza; opzione indipendente dal hostname della macchina e che quindi può permettere
l’attivazione in fase di installazione nella master e non richiede riattivazione
sulle “figlie”. Un unico file di licenza può essere riutilizzato anche su diversi
ambienti, ma in coppia anche alla stessa Mail.

Per eseguire la procedura di attivazione con file di licenza, seguire questi passaggi:

 * Installare AULReport partendo dal pacchetto AULReport.msi
 * Avviando AULReport verrà presentata questa schermata:

![](https://i0.wp.com/www.silviobalduzzi.com/wp-content/uploads/2023/09/image.png?
resize=760%2C722&ssl=1)

 * Compilare il campo Mail con il proprio indirizzo email;
 * Selezionare la tab “Hostname independent”;
 * Cliccare su “Generate” per ottenere il codice “LicPreKey”:

![](https://i0.wp.com/www.silviobalduzzi.com/wp-content/uploads/2023/09/image-1.
png?resize=760%2C722&ssl=1)

 * Aprire la pagina di attivazione
 * Inserire nuovamente l’indirizzo Mail usato nell’applicazione anche nel sito ed
   incollare il codice di LicPreKey appena generato;
 * Premere “Genera codice di attivazione”;
 * Nella pagina viene mostrato il codice di attivazione che verrà inviato anche 
   tramite mail, all’indirizzo indicato;
 * Aprire Notepad (o qualsiasi altra applicazione alternativa) e creare un file 
   nominato AULReport.lic, nel quale incollare il codice appena generato (senza 
   l’aggiunta di altri caratteri);
 * Salvare il file nella cartella C:\AULReport\ sulla macchina dove si sta eseguendo
   AULReport (creare la cartella, se non presente);
 * Tornare sull’applicazione AULReport e cliccare sul bottone “License file Activation”
   e selezionare il file di licenza appena creato (c:\AULReport\AULReport.lic).
 * Godetevi il tool attivato tramite file di licenza 🙂

Ora il tool AULReport risulta ottimizzato anche in quelle procedure e query che 
causavano un freeze dell’applicazione durante la loro esecuzione. In particolare
durante il caricamento delle applicazioni nella schermata principale, nella pagina“
AppUser Matrix” e in “User’s TreeView”.

In particolare, la finestra principale di AULReport non carica più automaticamente
le applicazioni, ma attende che si selezioni la finestra temporale e si clicchi 
sul bottone “Query”.

La finestra AppUser Matrix ora genera la matrice in tempo reale, visualizzando di
volta in volta la riga che sta elaborando, rendendo l’attesa meno noiosa 🙂

![](https://i0.wp.com/www.silviobalduzzi.com/wp-content/uploads/2023/09/image-2.
png?resize=760%2C447&ssl=1)

Tutte le procedure di Export in excel ora termineranno con l’apertura del file appena
generato, così che sia immediatamente mostrato il risultato dell’esportazione effettuata(
PS: non ho mai indicato in precedenza, ma la presenza del pacchetto Excel è prerequisito
per poter eseguire le esportazioni). Le esportazioni vengono salvate, di default,
nella cartella c:\AULReport\Reports\.

**Aggiornamento del 29/09/2023:**

Ho rilasciato una nuova versione di AULService, in quanto ho rilevato che in certe
situazioni l’agent si poteva bloccare durante la lettura dell’icona dell’applicazione(
causando lo stallo del processo). Ora ho aggiunto un check che verifica la possibilità
di estrarre l’icona dell’eseguibile e nel caso non debba riuscire, assegna un’icona
generica all’applicazione, da mostrare in AULReport.

**Aggiornamento del 11/10/2023:**

Ho rilasciato una ulteriore versione di AULService, v2.0.9, riscritto in buona parte
con l’aggiunta di un DB SQLite come Cache locale. Tramite l’utilizzo della cache,
che viene mantenuta in Sync con il DB AULMonitor, riduco al minimo le iterazioni
dell’agent AULService con il DB, riducendo il traffico in rete e migliorando il 
consumo di risorse dell’agent stesso.

[Download AppUserList](https://github.com/balduz84/AppUserList/releases)

Di seguito riporto i link ai precedenti post del blog nei quali ho trattato le varie
evoluzioni del prodotto:

 * [AppUserList – Application User List – Silvio Balduzzi’s Blog](https://www.silviobalduzzi.com/2023/05/appuserlist/)

 * [AppUserList v1.0 – Application User List – Silvio Balduzzi’s Blog](https://www.silviobalduzzi.com/2023/06/appuserlist-v1-0-application-user-list/)

 * [AppUserList v2.0 – Application User List – Silvio Balduzzi’s Blog](https://www.silviobalduzzi.com/2023/08/appuserlist-v2-0-application-user-list/)

## Comments

### By: Guru

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1123
- Published: 2024-01-31T04:28:54+01:00

Hello there,
 This is the first time I have found this your blog and this tool.

Is this a paid product or freeware ?

Is there any instructions page ?

Regards
 Guru

### By: Silvio Balduzzi

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1124
- Published: 2024-01-31T09:11:03+01:00

Hi Guru,

All my tools are freeware.

Installation is really simple:
 – A database, called AULMonitor, must be provided
via a SQL Server instance (the express version is sufficient); – You must install
AULAgent on the machines you want to monitor; – AULReport must be run on a machine
where you want to be able to run the reports. If you browse my GitHub you will find
a guide in .pdf format that explains the installation procedure. I recommend you
install the latest releases of the components, present here: [https://github.com/balduz84/AppUserList/releases/tag/2.3](https://github.com/balduz84/AppUserList/releases/tag/2.3)

and you can find AULMonitor here:
 [https://github.com/balduz84/AppUserList/releases/tag/2.2](https://github.com/balduz84/AppUserList/releases/tag/2.2)

If necessary, write to me and I will do everything I can to help you.

Silvio

### By: Timo

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1217
- Published: 2024-03-11T08:54:27+01:00

Hi Silvio,
 great work.

I have searched for the installation manual pdf on your github repo, but couldn’t
find it.
 Can you please upload this file?

Thanks Timo

### By: balduz84

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1218
- Published: 2024-03-12T17:19:12+01:00

Hi Timo,
 I wrote the guide in the past but have not updated it. I’ll update it 
as soon as possible and post it here for you. Silvio

### By: Cheap SR22 insurance

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1249
- Published: 2024-03-22T02:45:25+01:00

The situation studies you referenced incorporated a
 great deal weight to your debates.
I enjoy the comprehensive investigation.

### By: Cheapest SR22 insurance

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1254
- Published: 2024-03-24T06:42:23+01:00

I have actually been following your blog site for an although, and also every time
you post, I find
 out something new. Thank you for consistently providing premium.

### By: Martijn

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1262
- Published: 2024-03-26T10:05:52+01:00

Hello, how do you specify AULService which database it should connect to?

Thanks!

### By: balduz84

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1264
- Published: 2024-03-26T10:33:14+01:00

Hi Marijn,
 There is another file called TaskScheduler.exe in the AULService folder.
It is dedicated to configuring AULService startup when Windows starts and connects
to the DB. Silvio

### By: Martijn

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1267
- Published: 2024-03-26T15:03:47+01:00

Hi, thanks for your reply. But you have to do this manually for every Citrix server?
I will try and create a windows service for it, that might be easier.

### By: balduz84

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1268
- Published: 2024-03-26T15:37:12+01:00

Yes, if your Citrix machines are not provisioned, you need to install AULService(
and it relative task) into all machines manually.

### By: Martijn

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1263
- Published: 2024-03-26T10:32:58+01:00

Unfortunately there are no instructions so I have no clue how to set this up. You
can install AULService but then nothing happens. Doesn’t it need to run as a service?
We really need documentation.

### By: balduz84

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1265
- Published: 2024-03-26T10:35:30+01:00

Sorry, I actually have to update the documentation that I haven’t aligned with the
latest releases of the product. I will dedicate myself to updating the guide in 
the next few days and will publish it here.

### By: Martijn

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1277
- Published: 2024-03-29T13:51:20+01:00

Hi, I have it running. but for some reason, I see the processes in the reporting
tool but I don’t see any usernames.

Any idea what might be wrong? I’m using the MSIs downloaded from Github.

Thanks for your effort!

### By: balduz84

- Link: https://www.silviobalduzzi.com/2023/09/appuserlist-v2-2-application-user-list/#comment-1278
- Published: 2024-03-29T14:07:06+01:00

Hi, I would like to be able to view the logs to be able to tell what the problem
might be. Can you give me some details about your environment? OS versions, SQL 
version, …?