

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Installazione di una licenza di produzione
<a name="setting-up-production"></a>



Le seguenti sezioni di questo argomento descrivono come acquistare e utilizzare una licenza di produzione (licenza o abbonamento perpetuo).

**Topics**
+ [Fase 1: Installare il server RLM](#install-rlm)
+ [Fase 2: Ottenere l'ID host per il server RLM](#hostid-rlm)
+ [Fase 3: Acquistare la licenza o l'abbonamento perpetuo](#license-purchase)
+ [Fase 4: Modifica il file di licenza](#setting-up-production-license-file)
+ [Fase 5: configurazione del server RLM](#setting-up-rlm-server)
+ [Fase 6: Configurazione del server Amazon DCV](#setting-up-dcv-server)

## Fase 1: Installare il server RLM
<a name="install-rlm"></a>

Quando acquisti una licenza permanente o un abbonamento, ottieni un file di licenza che definisce i termini della licenza. Il file di licenza deve essere installato su un server RLM (Reprise License Manager). 

Per ulteriori informazioni su RLM, consulta il sito Web [Reprise Software](https://reprisesoftware.com/products/reprise-license-manager-rlm/).

**Topics**
+ [Installare il server RLM su Windows](#install-rlm-windows)
+ [Installare il server RLM su Linux](#install-rlm-linux)

### Installare il server RLM su Windows
<a name="install-rlm-windows"></a>

**Per installare il server RLM in Windows**

1. Scaricare RLM License Administration Bundle dal sito Web [Reprise Software](https://reprisesoftware.com/support/admin/license-administration-bundle/).
**Nota**  
A partire dalla versione 2022.1 di Amazon DCV, è richiesto il server RLM >= 14. Le versioni precedenti richiedono RLM >= 12.  
Si consiglia l'installazione dell'ultima versione stabile della licenza RLM Administration Bundle.

1. Installare RLM License Administration Bundle su `C:\RLM`.

### Installare il server RLM su Linux
<a name="install-rlm-linux"></a>

**Per installare il server RLM su Linux**

1. Scaricare RLM License Administration Bundle dal sito Web [Reprise Software](https://reprisesoftware.com/support/admin/license-administration-bundle/).
**Nota**  
A partire dalla versione 2022.1 di Amazon DCV, è richiesto il server RLM >= 14. Le versioni precedenti richiedono RLM >= 12.  
Si consiglia l'installazione dell'ultima versione stabile della licenza RLM Administration Bundle.

1. Creare un gruppo di utenti e un utente `rlm`. Questo può essere un qualsiasi utente valido o un servizio account. Si consiglia vivamente di non utilizzare l'account root per questo valore.

   ```
   $ groupadd -r rlm
   ```

   ```
   $ useradd -r -g rlm -d "/opt/nice/rlm" -s /sbin/nologin -c "RLM License Server" rlm
   ```

1. Creare le directory `/opt/nice/rlm` e `/opt/nice/rlm/license` richieste per il server RLM.

   ```
   $ mkdir -p /opt/nice/rlm/license
   ```

1. Estrarre il contenuto di RLM License Administration Bundle in `/opt/nice/rlm/` e accertarsi che i file siano di proprietà dell'utente `rlm`:

   ```
   $ tar xvf x64_l1.admin.tar.gz -C /opt/nice/rlm/ --strip-components 1
   ```

   ```
   $ chown -R rlm:rlm /opt/nice/rlm
   ```

## Fase 2: Ottenere l'ID host per il server RLM
<a name="hostid-rlm"></a>

Dopo aver installato il server RLM, è necessario ottenere l'ID host del server RLM. È necessario fornire questo ID host quando si acquista una licenza o un abbonamento perpetui.

### Ottieni l'ID host del server RLM su Windows
<a name="hostid-rlm-windows"></a>

**Per ottenere l'ID host per il server, apri il prompt dei comandi,**  
Passare a `C:\RLM\` ed eseguire questo comando.

```
C:\> rlmutil.exe rlmhostid ether
```

Il comando che restituisce l'ID host per il server RLM è il seguente.

```
Hostid of this machine: 06814example
```

Prendi nota dell'ID host. Servirà per la fase successiva.

### Ottieni l'ID host del server RLM su Linux
<a name="hostid-rlm-linux"></a>

**Per ottenere l'ID host del server, restituzione singola**

1. Accedi a `/opt/nice/rlm/`.

1. Esegui il comando seguente:

   ```
   $ ./rlmutil rlmhostid ether
   ```

   Il comando restituisce l'ID host del server RLM per ogni interfaccia di rete come segue.

1. Registrare l'ID host. Servirà per la fase successiva.

**Example**  
Questa procedura è stata eseguita ed è stato restituito il seguente ID singolo:  

```
Hostid of this machine: 0a1b2c3d4e5f
```
Questo ID viene quindi registrato e verrà utilizzato per acquistare la licenza per DCV.

**Per ottenere l'ID host del server, restituzioni multiple**

1. Accedi a `/opt/nice/rlm/`.

1. Esegui il comando seguente:

   ```
   $ ./rlmutil rlmhostid ether
   ```

    IDs Verranno restituiti più elementi in un elenco di IDs.

1. Eseguire il seguente comando seguente.

   ```
   iface=$(route -n | grep " UG " | tr -s " " | cut -d" " -f8)
   ip link show $iface | grep link/ether | tr -s " " | cut -d" " -f3 | tr -d ":"
   ```

   Il comando deve restituire l'ID host del server RLM per l'interfaccia di rete Gateway. 

1. Registrare l'ID host. Servirà per la fase successiva.

**Example**  
La procedura è stata eseguita e ne IDs sono stati restituiti più di uno in un elenco di ID multipli:  

```
Hostid of this machine: 0a1b2c3d4e5f 1b2c3d4e5f6a 2c3d4e5f6a7b 3d4e5f6a7b8c
```
Il comando di interfaccia viene eseguito e restituisce il seguente ID:  

```
Hostid of this machine: 0a1b2c3d4e5f
```
Questo ID viene quindi registrato e verrà utilizzato per acquistare la licenza per DCV.

## Fase 3: Acquistare la licenza o l'abbonamento perpetuo
<a name="license-purchase"></a>

Per informazioni su come acquistare una licenza perpetua o un abbonamento Amazon DCV, consulta [Come acquistare](https://www.nice-software.com/index.html#buy) sul sito Web di Amazon DCV e trova un distributore o rivenditore Amazon DCV nella tua regione.

Devi fornire l'ID host per il tuo server RLM. L'ID host è incorporato nel file di licenza fornito da Amazon DCV.

## Fase 4: Modifica il file di licenza
<a name="setting-up-production-license-file"></a>

Quando acquisti una licenza o un abbonamento perpetuo Amazon DCV, ricevi un `license.lic` file che definisce la licenza. Il file `license.lic` include le seguenti informazioni:
+ Il nome host del server RLM.
+ L'ID host del server RLM fornito al momento dell'acquisto della licenza.
+ Il numero di porta TCP del server RLM. Il valore predefinito è `5053`.
+ Il numero di porta ISV. Questa è una porta opzionale in cui il server RLM ascolta le richieste di licenza Amazon DCV. Se non specificato, una porta casuale viene scelta da RLM all'avvio.
+ I prodotti Amazon DCV coperti dalla licenza, insieme ai seguenti dettagli per ogni prodotto:
  + La versione principale coperta dalla licenza (ad esempio, `2017` per i prodotti Amazon DCV 2017).
  + La data di scadenza. `Permanent`indica che la licenza non ha una scadenza.
  + Il numero massimo di sessioni simultanee (ad esempio, `10` per 10 sessioni simultanee sul server).
  + Il checksum della licenza.
  + La firma della licenza.

Il seguente blocco di codice mostra il formato del file `license.lic`:

```
HOST {{RLM_server_hostname}} {{RLM_server_host_id}} {{RLM_server_port}}
ISV nice port={{port_number}}
LICENSE {{product_1}} {{major_version}} {{expiration_date}} {{concurrent_sessions}} share=hi _ck={{checksum}} sig="{{signature}}"
LICENSE {{product_2}} {{major_version}} {{expiration_date}} {{concurrent_sessions}} share=hi _ck={{checksum}} sig="{{signature}}"
```

Il seguente blocco di codice mostra un esempio di un file `license.lic` con la porta ISV omessa. Il file di licenza include le licenze per due prodotti Amazon DCV, DCV e dcv-gl.

```
HOST My-RLM-server abcdef123456 5053
ISV nice
LICENSE nice dcv 2017 permanent 10 share=hi _ck=456789098a sig="abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz1234567890ab"
LICENSE nice dcv-gl 2017 permanent 10 share=hi _ck=123454323x sig="1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz12"
```

**Per modificare il file `license.lic`**

1. Apri il file con l'editor di testo preferito.

1. Aggiungere il nome host del server RLM e il numero di porta TCP alla prima riga del file, che inizia con `HOST`.
**avvertimento**  
{{RLM\_server\_host\_id}}È l'ID host che hai fornito al momento dell'acquisto della licenza. Non è possibile modificare il{{RLM\_server\_host\_id}}.

1. (Facoltativo) Aggiungi il numero di porta ISV nella riga del file che inizia con`ISV`, aggiungendo`port={{port_number}}`. Questa porta è necessaria per consentire la comunicazione con il server DCV. 

   Se non vuoi specificare una porta ISV, ometti. `port={{port_number}}` Se non si specifica una porta ISV, RLM utilizza una porta casuale a ogni avvio. 
**avvertimento**  
Se si dispone di una configurazione firewall che impedisce l'uso di una porta selezionata casualmente, è necessario specificare questa porta e configurare il firewall per abilitarla, oltre alla porta RLM specificata nella riga. `HOST` 

1. Salva e chiudi il file.

**avvertimento**  
La modifica di una parte qualsiasi della licenza danneggia la firma del file e invalida la licenza.

## Fase 5: configurazione del server RLM
<a name="setting-up-rlm-server"></a>

Dopo aver modificato il file di licenza, è necessario posizionarlo sul server RLM e quindi avviare il servizio RLM.

**Topics**
+ [Configurazione del server RLM in Windows](#prep-windows)
+ [Configurare il server RLM su Linux](#prep-linux)

### Configurazione del server RLM in Windows
<a name="prep-windows"></a>

**Per configurare il server RLM in Windows**

1. Connect al server RLM.

1. Copiare il file `license.lic` modificato in `C:\RLM\license\`.

1. Copia il `C:\Program Files\NICE\DCV\Server\license\nice.set` file dal tuo server Amazon DCV e inseriscilo nella `C:\RLM\` cartella sul tuo server RLM.

1. Installa il server RLM come un servizio di Windows.

   ```
   C:\> rlm.exe -nows -dlog C:\RLM\rlm.log -c C:\RLM\license -install_service -service_name dcv-rlm
   ```

   Per ulteriori informazioni sulle opzioni di avvio RLM, vedere la pagina del prodotto [Reprise Software License Manager (RLM)](https://reprisesoftware.com/products/reprise-license-manager-rlm/).

1. Avviare il server RLM:

   ```
   C:\> net start dcv-rlm
   ```

1. Verificare che il server RLM sia in esecuzione.

   1. Aprire `C:\RLM\nice.dlog` con qualsiasi editor di testo e confermare la presenza della seguente riga:

      ```
      {{date_time}} (nice) Server started on license1 (hostid: {{host_id}}) for: dcv dcv-gl
      ```
**Nota**  
Il contenuto del file `rlm.log` può variare leggermente a seconda della versione del server RLM.

   1. Eseguire il seguente comando seguente.

      ```
      C:\RLM\rlmutil rlmstat -a -c {{rlm_server_hostname}}@5053
      ```

      Il comando restituisce informazioni sul server RLM.

### Configurare il server RLM su Linux
<a name="prep-linux"></a>

**Per configurare il server RLM su Linux**

1. Copiare il file `license.lic` modificato in `/opt/nice/rlm/license/`.

1. Copia il `/usr/share/dcv/license/nice.set` file dal tuo server Amazon DCV e inseriscilo nel tuo `/opt/nice/rlm` server RLM.

1. Creare un servizio server RLM e assicurarsi che venga avviato automaticamente all'avvio.

   1. Crea un file denominato `dcv-rlm` nella cartella `/opt/nice/rlm/`:

      ```
      $ touch /opt/nice/rlm/dcv-rlm
      ```

   1. Apri il file utilizzando qualsiasi editor di testo e aggiungi il seguente script. Salva e chiudi il file.

      ```
      #! /bin/sh
      # chkconfig: 35 99 01
      # description: The Reprise License Manager daemon.
      # processname: dcv-rlm
      
      ### BEGIN INIT INFO
      # Provides: dcv-rlm
      # Required-Start: $local_fs $remote_fs $syslog
      # Required-Stop: $local_fs $remote_fs $syslog
      # Default-Start: 3 4 5
      # Default-Stop: 0 1 2 6
      # Short-Description: The Reprise License Manager daemon.
      # Description: A service that runs the Reprise License Manager daemon.
      ### END INIT INFO
      
      # user used to run the daemon
      RLM_USER="rlm"
      
      # root of rlm installation
      RLM_ROOT="/opt/nice/rlm"
      
      # license directory (license files should have .lic extension)
      RLM_LICENSE_DIR="/opt/nice/rlm/license"
      
      # log file
      RLM_LOG_FILE="/var/log/rlm.log"
      
      _getpid() {
          pidof -o $$ -o $PPID -o %PPID -x "$1"
      }
      
      start() {
          echo -n "Starting rlm: "
          touch ${RLM_LOG_FILE}
          chown "${RLM_USER}" ${RLM_LOG_FILE}
          su -p -s /bin/sh "${RLM_USER}" -c "${RLM_ROOT}/rlm -c ${RLM_LICENSE_DIR} \
              -nows -dlog +${RLM_LOG_FILE} &"
          if [ $? -ne 0 ]; then
              echo "FAILED"
              return 1
          fi
          echo "OK"
      }
      
      stop() {
          echo -n "Stopping rlm: "
          pid=`_getpid ${RLM_ROOT}/rlm`
          if [ -n "$pid" ]; then
              kill $pid >/dev/null 2>&1
              sleep 3
              if [ -d "/proc/$pid" ] ; then
                  echo "FAILED"
                  return 1
              fi
          fi
          echo "OK"
      }
      
      status() {
          pid=`_getpid ${RLM_ROOT}/rlm`
          if [ -z "$pid" ]; then
              echo "rlm is stopped"
              return 3
          fi
          echo "rlm (pid $pid) is running..."
          return 0
      }
      
      restart() {
          stop
          start
      }
      
      case "$1" in
          start)
              start
              ;;
          stop)
              stop
              ;;
          status)
              status
              ;;
          restart)
              restart
              ;;
          *)
              echo $"Usage: $0 {start|stop|status|restart}"
              exit 1
      esac
      
      exit $?
      
      # ex:ts=4:et:
      ```

   1. Rendi lo script eseguibile, copialo in `/etc/init.d/` e quindi aggiungilo alla utility `chkconfig`:

      ```
      chmod +x /opt/nice/rlm/dcv-rlm 
      ```

      ```
      cp -a /opt/nice/rlm/dcv-rlm /etc/init.d/
      ```

      ```
      chkconfig --add dcv-rlm
      ```

1. Avvia il server RLM:

   ```
   $ service dcv-rlm start
   ```

1. Verifica che il server RLM sia in esecuzione e funzioni correttamente. Apri `var/log/rlm.log` con qualsiasi editor di testo e verifica la presenza della seguente riga:

   ```
   {{date_time}} (nice) Server started on license1 (hostid: {{host_id}}) for: dcv dcv-gl
   ```
**Nota**  
Il contenuto del file `rlm.log` può variare leggermente a seconda della versione del server RLM.

## Fase 6: Configurazione del server Amazon DCV
<a name="setting-up-dcv-server"></a>

Configura il tuo server Amazon DCV per utilizzare il server RLM. Per fare ciò, devi configurare il parametro di `license-file` configurazione sul tuo server Amazon DCV.

 Il `license-file` parametro deve essere impostato con le specifiche del server RLM a cui connettersi, nel formato. `{{RLM_server_port}}@{{RLM_server}}` Il server RLM può essere specificato come nome host o come indirizzo IP. Se non è configurato in modo esplicito, la porta del server RLM è quella predefinita. `5053` 

 Nel caso in cui siano in uso più server RLM, è possibile specificare un elenco di specifiche di più server RLM, separate da `:` su Linux, da su Windows. `;` Quindi il server proverà a connettersi a ciascuno di essi a turno, finché non sarà possibile stabilire una connessione con il server RLM corrispondente. Ciò può essere particolarmente utile, ad esempio, quando si utilizza un server di failover RLM come sostituto nel caso in cui il server RLM primario non sia raggiungibile. In questo caso è possibile specificare la licenza nel formato: `{{RLM_primary_server_port}}@{{RLM_primary_server}}:{{RLM_failover_server_port}}@{{RLM_failover_server}}` 

**Nota**  
Nel caso in cui Amazon DCV Server sia installato su Windows, è necessario separare le voci nelle specifiche con`;`.

**Topics**
+ [Configurazione del server Amazon DCV Windows](#config-win)
+ [Configurazione del server Amazon DCV Linux](#config-linux)

### Configurazione del server Amazon DCV Windows
<a name="config-win"></a>

**Per configurare il parametro di configurazione del file `license-file` su un server Windows**

1. Apri l'editor del Registro di Windows.

1. **Passa alla **chiave HKEY\_USERS\\ S-1-5-18\\ Software\\\\ com\\nicesoftwareGSettings\\ dcv\\ license\\ e seleziona il parametro license-file**.**

   Se non è presente alcun parametro `license-file` nella chiave del registro, occorre crearne uno:

   1. Apri il menu contestuale (clic con il pulsante destro del mouse) relativo alla chiave **license** nel riquadro a sinistra e scegli **Nuovo**, **Valore stringa**.

   1. In **Nome**, immetti `license-file` e premi **Invio**.

1. Apri il parametro **license-file**. Per **Dati valore**, immetti il numero di porta e il nome host del server RLM nel formato `{{RLM_server_port}}@{{RLM_server}}`. Controlla la nota precedente se devi configurare la connessione a più server RLM. 

1. Seleziona **OK** e chiudi l'editor del Registro di sistema di Windows.

### Configurazione del server Amazon DCV Linux
<a name="config-linux"></a>

**Per configurare il parametro di configurazione del file `license-file` su un server Linux**

1. Individua `/etc/dcv/` e utilizza un editor di testo per aprire il file `dcv.conf`.

1. Individua il parametro `license-file` nella sezione `[license]`. Quindi, sostituisci il percorso esistente con la porta e il nome host del server RLM nel formato. `{{RLM_server_port}}@{{RLM_server}}`

   Se non è presente alcun parametro `license-file` nella sezione `[license]`, aggiungilo manualmente utilizzando il seguente formato:

   ```
   license-file = "{{RLM_server_port}}@{{RLM_server}}"
   ```

   Controllate la nota precedente se avete bisogno di configurare la connessione a più server RLM.

1. Salva e chiudi il file.