Troubleshooting dell'installazione

Questa guida ti aiuterà a trovare la soluzione ai problemi più comuni connessi all'installazione di Mago4 e Mago.Net. Prima di proseguire la lettura, verifica che i requisiti di sistema richiesti dall'installazione siano soddisfatti leggendo Mago.Net prerequisites.

Table of Contents [Hide/Show]

SERVER
   File utili per troubleshooting
   Problema installazione Framework
   l'Asp.NET impedisce l'installazione
   Pulizia temporanee
RabbitMQ
   Errori generici
   Servizio Windows non si avvia
CLIENT
   Performance degradata in Windows 11 24H2
   Si è verificato un errore nell'installazione di un client
   Si verifica un errore HTTP 403 aprendo la pagina di setup del client
   Manca il file 'index.htm' richiesto per installare i client
ClickOnceDeployer
   Si è verificato un errore nella fase di generazione dei manifest
   Il file 'index.htm' necessario per installare i client non viene correttamente aperto dal browser
   Non si riesce ad eseguire Mago da una postazione client perché le cartelle del server non possono essere raggiunte
Il server di .Net Core non risponde
   Guide per la correzione

SERVER

File utili per troubleshooting

Microarea\Mago4\Custom\Companies\AllCompanies\Log: questa folder contiene i log legati a crash o blocchi di Mago
Microarea|Mago4\Apps\Logs: contiene i log relativi ad errori legati a clickonce, quindi legati alla parte client di Mago
C:\Users\....\AppData\Local\Temp\: contiene errori relativi a problemi di installazione, lanciando quindi il setup di Mago
L’event viewer di windows, alle voci application, system e Ma server (quest’ultima in particolare è specifica per Mago)
Il visualizzatore di log all’interno della admin console
Standard\Applications\ERPServiceProvider\Backend: log di MSH / ESP
Users\utente\AppData\Roaming\RabbitMQ\log: log rabbit
Microarea\Mago4\Custom\Companies\AZIENDA\Log\Users\UTENTE: Log per connessione al db persa
Custom\Companies\%nome azienda%\Log\AllUsers: log errori aggiornamento DB
Custom\Companies\AllCompanies\Log\AllUsers: log problemi tbLoader

Problema installazione Framework

Potrebbe capita che non si riesca ad installare Mago 4.0.1, 4.1 e 4.1.1 a causa di problemi con il Framework. Nei log ci sarà questo errore:

TIMESTAMP: Applying execute package: NDP, action: Install, path: C:\ProgramData\Package Cache\8C1C499ACF9D72B613140C4118344F7F1E91109D\.NET Framework 4.8, 
arguments: '"C:\ProgramData\Package Cache\8C1C499ACF9D72B613140C4118344F7F1E91109D\.NET Framework 4.8" /install /quiet /norestart'
TIMESTAMP: Error 0x80072004: Process returned error: 0x2004
TIMESTAMP: Error 0x80072004: Failed to execute EXE package.
TIMESTAMP: Error 0x80072004: Failed to configure per-machine EXE package.
TIMESTAMP: Applied execute package: NDP, result: 0x80072004, restart: None
TIMESTAMP: Error 0x80072004: Failed to execute EXE package

In questi casi è possibile installare con un workaround, che consiste sostanzialmente in tre pacchetti (pre-requisiti + mago + msh) invece dell'exe. Contattare il supporto. Dalla release 4.2 in poi il problema non si presenta, perché è stato cambiato il setup.

l'Asp.NET impedisce l'installazione

Nel caso in cui l'Asp.NET risulti come prerequisito non soddisfatto, andare nel pannello di controllo fino ad arrivare all'attivazione o disattivazione delle funzionalità di Windows e verificare che ASP.NET 4.8 risulti installato come nell'immagine:

Pulizia temporanee

Per svuotare le cartelle temporanee, copiare questi comandi in un .bat ed eseguirlo come admin. Assicurarsi che le cartelle in questione abbiano i permessi full/everyone.

iisreset
pause
del /S %temp% /Q
for /d %%i in ("%temp%\*") do @rmdir /s /q "%%i"
pause
del /S c:\Windows\Temp /Q
for /d %%i in ("c:\Windows\Temp\*") do @rmdir /s /q "%%i"
pause
del /S "C:\Windows\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files\*" /Q
for /d %%i in ("C:\Windows\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files\*") do @rmdir /s /q "%%i"
pause
del /S "C:\Windows\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET Files\*" /Q
for /d %%i in ("C:\Windows\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET Files\*") do @rmdir /s /q "%%i"
pause
del /S "C:\Windows\Microsoft.NET\Framework64\v2.0.50727\Temporary ASP.NET Files\*" /Q
for /d %%i in ("C:\Windows\Microsoft.NET\Framework64\v2.0.50727\Temporary ASP.NET Files\*") do @rmdir /s /q "%%i"
pause
del /S "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files\*" /Q
for /d %%i in ("C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files\*") do @rmdir /s /q "%%i"
pause
iisreset

RabbitMQ

Errori generici

Potrebbe capitare che si verifichino degli errori relativi a Rabbit (unreachable, sul protocollo AMQP e altro), tentando di accedere al frontend di MSH, o anche dopo aver eseguito l'accesso. Le prime cose da contollare sono:

Controllare che siano presenti i parametri di Rabbit in Mago (preferenze | generali | parametri msh);
Controllare che il servizio Windows "RabbitMQ" sia in esecuzione;
Controllare sempre i permessi sulla cartella standard;
Se si riesce ad accedere al FE di MSH, stoppare l'azienda e posizionarsi sulla scheda Settings. Qui disattivare tutti i connettori non utilizzati, cliccando sulla freccia cerchiata. Quindi riavviare l'azienda. In generale, se un servizio non è stato configurato, vuole dire che non è utilizzato.

Servizio Windows non si avvia

Potrebbe capitare che il servizio RabbitMQ di Windows non resti in esecuzione e si arresti con errore 1012 o 1060, se avviato manualmente. In questi consigliamo quanto segue:

Se ci sono antivirus, disattivarli (anche come servizio), successivamente inserire questi comandi in un .bat da eseguire per il ripristino di Rabbit:

RELEASE PRE-4.0:

SET temp=%HOMEDRIVE%
SET HOMEDRIVE=C:
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.9\sbin\rabbitmq-plugins.bat" enable rabbitmq_management
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.9\sbin\rabbitmq-service.bat" stop
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.9\sbin\rabbitmq-service.bat" remove
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.9\sbin\rabbitmq-service.bat" install
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.9\sbin\rabbitmq-service.bat" start
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.9\sbin\rabbitmqctl.bat" start_app
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.9\sbin\rabbitmqctl.bat" add_user mobile mobile
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.8.9\sbin\rabbitmqctl.bat" set_user_tags mobile administrator
SET HOMEDRIVE=%temp%

RELEASE POST-4.0:

SET temp=%HOMEDRIVE%
SET HOMEDRIVE=C:
if %OS%==32BIT SET ERLANG_HOME=C:\Program Files (x86)\Erlang OTP
if %OS%==64BIT SET ERLANG_HOME=C:\Program Files\Erlang OTP
@echo on
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmq-plugins.bat" enable rabbitmq_management
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmq-service.bat" stop
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmq-service.bat" remove
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmq-service.bat" install
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmq-service.bat" start
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmqctl.bat" start_app
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmqctl.bat" await_startup
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmqctl.bat" add_user mobile mobile
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmqctl.bat" set_permissions -p / mobile .* .* .*
CALL "C:\Program Files\RabbitMQ Server\rabbitmq_server-3.10.5\sbin\rabbitmqctl.bat" set_user_tags mobile administrator
SET HOMEDRIVE=%temp%

Se il problema persiste, consigliamo quanto segue:

1- controllare che ci sia un solo pacchetto di Rabbit installato e disinstallarlo. Qualora ce ne fossero diversi, rimuoverli
2- controllare che ci sia un solo pacchetto di Erlang installato e disinstallarlo. Qualora ce ne fossero diversi, rimuoverli
3- da gestione attività controllare il processo EPMD.EXE, se in esecuzione interromperlo
4- da powershell inserire comando: sc.exe delete RabbitMQ
5- dopo la disinstallazione di erlang e rabbit, per accertarsi di cancellare tutto il residuo rimasto nel sistema operativo:
-Eliminare le directory di installazione di RabbitMQ ed Erlang. (C:\Program Files\RabbitMQ Server, AppData\Roaming\RabbitMQ e C:\Program Files (x86)\erl...)
-cancellare il file C:\Windows\.erlang.cookie (se presente)
-cancellare il file .erlang.cookie. in C:/Users/nomeutente (se presente)
-cancellare il file .erlang.cookie. in C:\WINDOWS\system32\config\systemprofile (se presente)
6- rimuovere le chiavi dal registro windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Ericsson\Erlang\ErlSrv\1.1\RabbitMQ
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Ericsson
7- reinstallare Erlang (contattare il supporto per la versione corretta da installare)
8- reinstallare Rabbit (contattare il supporto per la versione corretta da installare)
9- controllare che il contenuto del file .erlang.cookie in C:\Windows\System32\config\systemprofile corrisponda a quanto presente nello stesso file in C:/Users/nomeutente
10- riavviare la macchina
11- verificare che il servizio di rabbit rimanga stabile in esecuzione

In caso il problema continui, contattare il supporto.

CLIENT

Performance degradata in Windows 11 24H2

Sono stati riscontrati casi di performance degradata con client Mago4 installato su Windows 11 24H2, nell'utilizzo generale e in particolare nell'esecuzione dei report. In questi casi suggeriamo di disabilitare la Risoluzione dei nomi Multicast (protocollo LLMNR) agendo sui criteri di gruppo (GPO) del client:

Aprire l'Editor Criteri di Gruppo Locali - gpedit.msc

Da Configurazione Computer -> Modelli Amministrativi -> Rete -> Client DNS -> selezionare "Disattiva risoluzione dei nomi Multicast" e impostarlo ad "Abilitato"

Si è verificato un errore nell'installazione di un client

verifica di avere i privilegi di amministratore
controlla eventuali errori riportati nel log dell'installazione ClickOnce
se il manifest dell'installazione non è valido, si è verificato un errore in fase di generazione dei manifest: prova a rieseguire ClickOnceDeployer con privilegi di amministratore
Sul client è presente una precedente installazione zoppa del prodotto: prova a rimuoverla da pannello di controllo oppure, se non è presente, ripulendo manualmente la cartella (nascosta!) delle applicazioni ClickOnce: Cartella di profilo utente\\AppData\Local\Apps\2.0. ATTENZIONE: questa operazione rimuove TUTTE le applicazioni ClickOnce presenti sulla macchina, per cui va effettuata come ultima spiaggia; in alternativa, si può cercare di rimuovere le sole sottocartelle relative all'installazione di Mago.Net, entrando nei meandri delle logiche di ClickOnce.

Si verifica un errore HTTP 403 aprendo la pagina di setup del client

Manca il file 'index.htm'

Manca il file 'index.htm' richiesto per installare i client

Questo file viene generato dal tool ClickOnceDeployer (che si occupa della generazione dei manifest di installazione) nella parte finale del processo di installazione. Se il file non è presente (dovrebbe trovarsi nella cartella di installazione), probabilmente si è verificato un errore nella fase di generazione dei manifest.

ClickOnceDeployer

ClickOnceDeployer uses Microsoft' SignTool.exe and Mage.exe to sign installation files; check the documentation of these products for troubleshooting information. The signing process may need to access the VeriSign web site: verify that your installation machine has access to the Internet

ClickOnceDeployer non riesce a firmare digitalmente i manifest di installazione ClickOnceDeployer usa gli strumenti Microsoft SignTool.exe e Mage.exe per firmare i file di installazione; controlla la documentazione di questi strumenti per la risoluzione di problemi. Il processo di firma digitale può richiedere l'accesso al sito di Verisign, verificare che la macchina di installazione abbia accesso a Internet

Si è verificato un errore nella fase di generazione dei manifest

Rilanciare ClickOnceDeployer.exe

Aprire il prompt dei comandi (deve essere eseguito con privilegi di amministratore: verifica di essere amministratore e, in Windows / o Vista, usa 'Run as Administrator')
Imposta la directory corrente a installation_path\Apps\ClickOnceDeployer
Lancia il comando 'ClickOnceDeployer > log.txt'
Leggi il file di log Log.txt e trova eventuali errori

Il file 'index.htm' necessario per installare i client non viene correttamente aperto dal browser

Verifica l'esistenza del file (si trova nel path di installazione)
Verifica che IIS supporti il contenuto statico: occorre includere 'Static Content' nei componenti installati di IIS dal pannello di installazione applicazioni

Non si riesce ad eseguire Mago da una postazione client perché le cartelle del server non possono essere raggiunte

Il setup del server non ha creato correttamente le cartelle condivise dell'installazione: verifica che le cartelle installation_path\Standard and installation_path\Custom siano condivise con permessi 'everyone':'full control'; in caso contrario:

Provare ad impostare manualmente i permessi sulle cartelle
Provare a condividere manualmente le cartelle
Rilanciare il setup, scegliendo l'opzione 'Ripara'

Il server di .Net Core non risponde

Guide per la correzione

A seconda della version e di Mago 4 di cui avete bisogno cliccate in questi due link!: