Aggiornamento o modifica dei file di licenza di rete

Informazioni sulle licenze Network

Le licenze Network contengono i passcode crittografati per ogni prodotto che la propria organizzazione è autorizzata tramite licenza ad installare ed eseguire.

In generale, non è necessario modificare il file di licenza di rete sul server o sui computer client. Tuttavia, in alcune condizioni è necessario modificare il file di licenza:

Quando si modifica il nome del server di licenza (ad esempio, se la licenza diventa ospitata su un nuovo server). Vedere Aggiornamento di un file di licenza di rete.
Quando si cambia il numero di porta (ad esempio, se l’indirizzo della porta per il server è cambiato). Vedere How do I migrate my MATLAB clients to a new license server when the license server changes? (Come migrare i client MATLAB su un nuovo License Server quando il License Server cambia?)
Quando si aggiorna l’installazione di rete con un nuovo file di licenza. Vedere la risposta MATLAB^® Come si aggiorna il file di licenza utilizzato da License Manager?

All’interno del file di licenza di rete

Il file di licenza di rete è un file di testo ASCII formattato appositamente che contiene i passcode dei prodotti crittografati per ogni prodotto che si è autorizzati tramite licenza ad eseguire. Ogni passcode del prodotto identifica il numero di chiavi disponibili per quel prodotto. Il Network License Manager concede o nega l’accesso ad un prodotto in base alla disponibilità dei codici di licenza associati a ciascun prodotto.

Ogni riga INCREMENT identifica un prodotto, il numero di chiavi disponibili per il prodotto e altre informazioni. (Le righe INCREMENT nel proprio file di licenza potrebbero non includere tutti gli elementi rappresentati nell’esempio.)
Il carattere barra inversa (\) indica che la riga continua sulla riga successiva.
Le righe che iniziano con il simbolo del cancelletto (#) sono commenti. Il programma di installazione di MathWorks^® usa le informazioni contenute in queste righe di commento, come l’ID host del server di licenza o l’indirizzo e-mail, quando elabora il file di licenza durante l’installazione.

# BEGIN---------------BEGIN---------------BEGIN
# MATLAB license passcode file.
# LicenseNo: 123456           HostID: 6C4B905F446E
#
# R2021b
#
INCREMENT MATLAB MLM 46 30-jan-2025 13 FDC7243F4976  \
        VENDOR_STRING=vi=0:at=200:ae=1:lu=300:lo=CN:ei=1234567:lr=1:2p=0:  \
        DUP_GROUP=UH asset_info=123456 ISSUED=21-Nov-2021 BORROW=720  \
        NOTICE=product=MATLAB SN=123456 SIGN="00C8 0547 EFDF 50D7 B9CE  \
        4C9D 3348 561B E9E3 6CCA 7986 C2F6 38C8 794F EE84"
INCREMENT SIMULINK MLM 46 30-jan-2025 1 7DE4D05FF067  \
        VENDOR_STRING=vi=0:at=200:ae=1:lu=300:lo=CN:ei=1234567:lr=1:2p=0:  \
        DUP_GROUP=UH asset_info=123456 ISSUED=21-Nov-2021 BORROW=720  \
        NOTICE=product=SIMULINK SN=123456 SIGN="00BE C534 0A32 1821  \
        AFCE D040 2085 3E00 9005 4983 7EFB 875F E4A7 FEE6 9548"

Elaborazione della licenza

Quando si installa il Network License Manager o il MATLAB, il programma di installazione elabora le licenze di rete da utilizzare rispettivamente sui computer server e client:

Durante l'installazione del Network License Manager sul server

Sul server, il programma di installazione:

Crea una copia del file di licenza di rete denominata license.dat, elabora il file per aggiungere le righe SERVER e DAEMON e inserisce questa copia nella cartella /etc dove il Network License Manager è in fase di installazione.
La riga SERVER identifica il nome del server, l'ID host e il numero di porta. La riga DAEMON identifica il nome del daemon del Network License Manager.
Per licenze Network Named User: quando il programma di installazione crea un file di opzioni in fase di installazione, aggiunge anche la sintassi Options= alla riga DAEMON del proprio file di licenza. Questa sintassi specifica il nome del percorso del file di opzioni.

Ad esempio, si consideri un server denominato thunderball in esecuzione sulla porta 27000 il cui ID host è l'indirizzo MAC 03:42:f8:1b:b2:72. Le righe SERVER e DAEMON nel file di licenza dovrebbero avere questo aspetto:

SERVER thunderball 0342f81bb271 27000
DAEMON MLM "C:\Program Files\MATLAB\R2025b\etc\win64\MLM.exe" options="C:\Program Files\MATLAB\R2025b\etc\mlm.opt"

Durante l'elaborazione della licenza, il programma di installazione rimuove i due punti dall'indirizzo MAC.

Durante l’installazione di MATLAB su un computer client

Prima di poter eseguire il programma di installazione, è innanzitutto necessario copiare il file license.dat configurato durante l’installazione del Network License Manager e inserirlo nel computer client o in un punto accessibile in rete.

Quindi, durante l’installazione, il programma di installazione crea una copia di license.dat e la elabora per rimuovere le righe INCREMENT e la riga DAEMON nel file di licenza, lasciando la riga SERVER. Aggiunge anche l’istruzione USE_SERVER al file. Questa riga punta al file di licenza di rete sul server, che contiene tutti i passcode per i prodotti.

Nomina questo file configurato network.lic e lo inserisce in matlabroot\licenses.

Nota

Non fornire agli utenti il file di licenza scaricato dal License Center. Gli utenti possono eseguire l’installazione esclusivamente con il file di licenza appositamente configurato durante l’installazione del Network License Manager.

Percorso di ricerca della licenza MATLAB

All’avvio MATLAB legge il file di licenza per controllare la licenza del prodotto. MATLAB cerca il file di licenza nelle seguenti posizioni, nell’ordine specificato:

Il file di licenza specificato nella riga di comando di avvio di MATLAB tramite l’opzione -c. L’opzione -c sostituisce l’intero ordine della ricerca e usa solo quanto specificato nella riga di comando. Questo è l’unico percorso che viene cercato da MATLAB.
Variabili di ambiente MLM_LICENSE_FILE e LM_LICENSE_FILE.
La cartella del profilo della persona che avvia il programma.
La cartella \licenses nell’installazione MATLAB per i file denominati license.dat o per qualunque file con estensione .lic.

Quando si effettua il check-out di MATLAB da un server di licenze di rete, tutti i check-out delle toolbox nella stessa sessione proverranno da qual server di licenza. Se un file di licenza sul percorso non è una licenza del server (ossia si tratta di un file di licenza Individual, Designated Computer o Trial), il check-out delle toolbox può comunque essere eseguito da quel file o da quel server di licenza.

Impostazione del percorso di ricerca della licenza MATLAB

Per impostazione predefinita, MATLAB installa il file di licenza sul computer client nella cartella \licenses della cartella di installazione client di MATLAB. Tuttavia, è possibile sostituire questa posizione in uno dei modi che seguono:

Specificare il percorso del file di licenza nella riga di comando durante l’avvio di MATLAB tramite l’opzione -c.
L’opzione -c sostituisce l’intero ordine della ricerca, includendo le variabili di ambiente, e usa solo quanto specificato nella riga di comando. Questo è l’unico percorso che viene cercato da MATLAB.
È possibile specificare un elenco di percorsi per la ricerca. Quando si utilizza l’opzione -c, tenere presente quanto segue:
- Se il percorso del proprio file di licenza contiene uno spazio, includere il nome del percorso tra virgolette.
- Se si sta specificando più di un file di licenza, assicurarsi di includere l’elenco completo dei file di licenza tra virgolette.
Impostare la variabile di ambiente.
MLM_LICENSE_FILE specifica la posizione del file di licenza per i prodotti MathWorks. MATLAB cerca prima questa variabile di ambiente.

Nota

Sebbene sia possibile impostare la variabile di ambiente LM_LICENSE_FILE, l'uso di questa variabile è sconsigliato perché riguarda tutti i prodotti abilitati a Flex. Utilizzare invece <VENDOR>_LICENSE_FILE.

Nota

Se si utilizza la variabile di ambiente MLM_LICENSE_FILE, matlab/licenses/network.lic deve essere cancellato.

Aggiornamento di un file di licenza di rete

Quando si riceve una nuova licenza da MathWorks, pianificare l’aggiornamento del file di licenza sul server di rete quando è meno probabile che gli utenti accedano a una licenza MATLAB.

Preparazione del file di licenza più recente

Scaricare il file di licenza più recente e prepararlo per essere utilizzato con il License Server.

Scaricare il file di licenza più recente dal License Center. Per eseguire questo passaggio, è necessario essere un amministratore di licenze.
1. Nel License Center, fare clic sulla licenza del prodotto che si desidera aggiornare.
2. Nella scheda Install and Activate, nella tabella License Server, individuare la riga relativa al proprio server di licenza. Quindi, nella colonna Get License File, fare clic sulla freccia di download o sull'icona dell'e-mail.
3. Fare clic su Download License File, quindi su Done. Ignorare gli ulteriori passaggi mostrati in questa pagina. Il file di licenza scaricato è denominato license.lic.
(Opzionale) Se si stanno aggiornando più licenze, ripetere il passaggio precedente per scaricare gli altri file di licenza. Quindi, unire i contenuti di questi file in un unico file license.lic. Non includere righe vuote nel file.

Copiare le righe SERVER e DAEMON dal file di licenza esistente sul server nel file di licenza scaricato. Il file di licenza modificato dovrebbe essere simile a quanto segue:

SERVER <hostname> <hostID> <portNumber>
DAEMON MLM <lmroot>/etc/<arch>/MLM
# BEGIN--------------BEGIN--------------BEGIN
<license file 1>
# END-----------------END-----------------END
# BEGIN--------------BEGIN--------------BEGIN
<license file 2>
# END-----------------END-----------------END
.
.
.
# BEGIN--------------BEGIN--------------BEGIN
<license file N>
# END-----------------END-----------------END

Sostituzione di un file di licenza esistente

Arrestare il License Manager seguendo le istruzioni relative alla propria piattaforma. Vedere Avvio e interruzione del Network License Manager.
Sostituire il file di licenza esistente sul server con quello preparato.
Suggerimento: se si sta aggiornando anche il software del License Manager, sostituire in questo momento i file binari del License Manager esistenti con quelli più recenti. Per i dettagli sull'aggiornamento del License Manager, vedere Aggiornamento del software Network License Manager.
Riavviare il License Manager seguendo le istruzioni relative alla propria piattaforma. Vedere Avvio e interruzione del Network License Manager.

È possibile eseguire un’interrogazione dello stato per confermare che il file di licenza sia stato aggiornato. L’articolo di assistenza che segue contiene le istruzioni per eseguire un’interrogazione dello stato: Monitoraggio dell’utilizzo delle licenze o delle chiavi.