

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Instalar una licencia de producción
<a name="setting-up-production"></a>



En las siguientes secciones de este tema se explica cómo comprar y utilizar una licencia de producción (licencia perpetua o suscripción).

**Topics**
+ [Paso 1: Instalar el servidor RLM](#install-rlm)
+ [Paso 2: Obtener el ID de host del servidor RLM](#hostid-rlm)
+ [Paso 3: Comprar la licencia perpetua o suscripción](#license-purchase)
+ [Paso 4: Modificar el archivo de licencia](#setting-up-production-license-file)
+ [Paso 5: Configurar el servidor RLM](#setting-up-rlm-server)
+ [Paso 6: configuración del servidor Amazon DCV](#setting-up-dcv-server)

## Paso 1: Instalar el servidor RLM
<a name="install-rlm"></a>

Cuando compra una licencia o suscripción perpetua, obtiene un archivo de licencia que define los términos de la licencia. Debe instalar el archivo de licencia en un servidor Reprise License Manager (RLM). 

Para obtener más información acerca de RLM, consulte el sitio web de [Reprise Software](https://reprisesoftware.com/products/reprise-license-manager-rlm/).

**Topics**
+ [Instalar el servidor RLM en Windows](#install-rlm-windows)
+ [Instalar el servidor RLM en Linux](#install-rlm-linux)

### Instalar el servidor RLM en Windows
<a name="install-rlm-windows"></a>

**Para instalar el servidor RLM en Windows**

1. Descargue el paquete de administración de licencias de RLM desde el [sitio web de Reprise Software](https://reprisesoftware.com/support/admin/license-administration-bundle/).
**nota**  
A partir de Amazon DCV versión 2022.1 se requiere un servidor RLM >= 14. Las versiones anteriores requieren un RLM >= 12.  
Se recomienda instalar la última versión estable del paquete de administración de licencias RLM.

1. Instale el paquete de administración de licencias de RLM en `C:\RLM`.

### Instalar el servidor RLM en Linux
<a name="install-rlm-linux"></a>

**Para instalar el servidor RLM en Linux**

1. Descargue el paquete de administración de licencias de RLM desde el [sitio web de Reprise Software](https://reprisesoftware.com/support/admin/license-administration-bundle/).
**nota**  
A partir de Amazon DCV versión 2022.1 se requiere un servidor RLM >= 14. Las versiones anteriores requieren un RLM >= 12.  
Se recomienda instalar la última versión estable del paquete de administración de licencias RLM.

1. Cree un grupo de usuarios y un usuario `rlm`. Puede ser cualquier usuario o cuenta de servicio válidos. Recomendamos encarecidamente no utilizar la cuenta raíz para este valor.

   ```
   $ groupadd -r rlm
   ```

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

1. Cree los directorios `/opt/nice/rlm` y `/opt/nice/rlm/license` necesarios para el servidor RLM.

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

1. Extraiga el contenido del paquete de administración de licencias de RLM en `/opt/nice/rlm/` y asegúrese de que los archivos son propiedad del usuario `rlm`.

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

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

## Paso 2: Obtener el ID de host del servidor RLM
<a name="hostid-rlm"></a>

Después de instalar el servidor RLM, debe obtener el ID de host del servidor RLM. Deberá proporcionar este ID de host cuando compre una licencia o suscripción perpetua.

### Obtener el ID de host del servidor RLM en Windows
<a name="hostid-rlm-windows"></a>

**Para obtener el ID de host del servidor, abra la línea de comandos,**  
Vaya a `C:\RLM\` y, a continuación, ejecute el comando siguiente.

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

El comando devuelve el ID de host del servidor RLM del siguiente modo.

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

Anote el ID del host. Lo necesita para el siguiente paso.

### Obtener el ID de host del servidor RLM en Linux
<a name="hostid-rlm-linux"></a>

**Para obtener el ID de host del servidor, un solo retorno**

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

1. Use el siguiente comando:

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

   El comando devuelve el ID de host del servidor RLM para cada interfaz de red del siguiente modo.

1. Registre el ID del host. Lo necesita para el siguiente paso.

**Example**  
Se ha ejecutado este procedimiento y se ha devuelto el siguiente identificador único:  

```
Hostid of this machine: 0a1b2c3d4e5f
```
A continuación, se registra este identificador y se utilizará para comprar la licencia de DCV.

**Para obtener el ID de host del servidor, varios retornos**

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

1. Use el siguiente comando:

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

   Se IDs devolverán varios en una lista de IDs.

1. Ejecute el comando siguiente.

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

   El comando devuelve el ID de host del servidor RLM para cada interfaz de red de la puerta de enlace del siguiente modo. 

1. Registre el ID del host. Lo necesita para el siguiente paso.

**Example**  
Se ejecutó el procedimiento y IDs se devolvieron varios en una lista de varios identificadores:  

```
Hostid of this machine: 0a1b2c3d4e5f 1b2c3d4e5f6a 2c3d4e5f6a7b 3d4e5f6a7b8c
```
Se ejecuta el comando de interfaz y se devuelve el siguiente identificador:  

```
Hostid of this machine: 0a1b2c3d4e5f
```
A continuación, se registra este identificador y se utilizará para comprar la licencia de DCV.

## Paso 3: Comprar la licencia perpetua o suscripción
<a name="license-purchase"></a>

Para obtener información sobre cómo comprar una licencia perpetua o una suscripción de Amazon DCV, consulte [Cómo comprar](https://www.nice-software.com/index.html#buy) en el sitio web de Amazon DCV y busque un distribuidor o revendedor de Amazon DCV en su región.

Debe proporcionar el ID de host del servidor RLM. El ID de host está incrustado en el archivo de licencia que Amazon DCV proporciona.

## Paso 4: Modificar el archivo de licencia
<a name="setting-up-production-license-file"></a>

Cuando compra una licencia perpetua o suscripción de Amazon DCV, recibirá un archivo `license.lic` que define la licencia. El archivo `license.lic` contiene la información siguiente:
+ El nombre de host del servidor RLM.
+ El ID de host del servidor RLM que proporcionó al comprar la licencia.
+ El número de puerto TCP del servidor RLM. El valor predeterminado es `5053`.
+ El número de puerto ISV. Es un puerto opcional en el que el servidor RLM escucha solicitudes de licencia de Amazon DCV. Si no se especifica, RLM selecciona un puerto aleatorio al inicio.
+ Los productos de Amazon DCV cubiertos por la licencia, junto con los siguientes detalles de cada producto:
  + La versión principal cubierta por la licencia (por ejemplo, `2017` para los productos de Amazon DCV 2017).
  + Fecha de vencimiento. `Permanent` indica que la licencia no caduca.
  + El número máximo de sesiones simultáneas (por ejemplo, `10` para 10 sesiones simultáneas en el servidor).
  + La suma de comprobación de licencia.
  + La firma de la licencia.

El siguiente bloque de código muestra el formato del archivo `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}}"
```

El siguiente bloque de código muestra un ejemplo de un archivo `license.lic` con el puerto ISV omitido. El archivo de licencia incluye licencias para dos productos Amazon DCV, DCV y 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"
```

**Para editar el archivo `license.lic`**

1. Abra el archivo en el editor de texto que prefiera.

1. Agregue el nombre de host, el identificador y el número de puerto TCP del servidor RLM en la primera línea del archivo, que comienza por `HOST`.
**aviso**  
{{RLM\_server\_host\_id}}Es el ID de host que proporcionó al comprar la licencia. No puede editar el{{RLM\_server\_host\_id}}.

1. (Opcional) Agregue el número de puerto ISV en la línea del archivo que comienza por `ISV`, agregando `port={{port_number}}`. Este puerto es necesario para permitir la comunicación con el servidor DCV. 

   Si no desea especificar un puerto ISV, omita `port={{port_number}}`. Si no especifica un puerto ISV, RLM utilizará un puerto aleatorio en cada inicio. 
**aviso**  
Si tiene una configuración de firewall que impide el uso de un puerto seleccionado aleatoriamente, debe especificar este puerto y configurar el firewall para habilitarlo, además del puerto RLM especificado en la línea `HOST`. 

1. Guarde y cierre el archivo.

**aviso**  
Si se modifica cualquier otra parte de la licencia, se dañará la firma del archivo y la licencia quedará invalidada.

## Paso 5: Configurar el servidor RLM
<a name="setting-up-rlm-server"></a>

Después de modificar el archivo de licencia, debe colocarlo en el servidor RLM y, a continuación, iniciar el servicio RLM.

**Topics**
+ [Configurar el servidor RLM en Windows](#prep-windows)
+ [Configurar el servidor RLM en Linux](#prep-linux)

### Configurar el servidor RLM en Windows
<a name="prep-windows"></a>

**Para configurar el servidor RLM en Windows**

1. Conéctese a su servidor RLM.

1. Copie el archivo `license.lic` editado en `C:\RLM\license\`.

1. Copie el archivo `C:\Program Files\NICE\DCV\Server\license\nice.set` desde su servidor Amazon DCV y colóquelo en la carpeta `C:\RLM\` de su servidor RLM.

1. Instale el servidor RLM como servicio de Windows.

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

   Para obtener más información sobre las opciones de inicio de RLM, consulte la página del producto [Reprise Software License Manager (RLM)](https://reprisesoftware.com/products/reprise-license-manager-rlm/).

1. Inicie el servidor RLM.

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

1. Confirme que el servidor RLM se está ejecutando.

   1. Abra `C:\RLM\nice.dlog` con su editor de texto preferido y confirme que aparece la línea siguiente.

      ```
      {{date_time}} (nice) Server started on license1 (hostid: {{host_id}}) for: dcv dcv-gl
      ```
**nota**  
El contenido del archivo `rlm.log` podría variar ligeramente dependiendo de la versión del servidor RLM.

   1. Ejecute el comando siguiente.

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

      El comando debe devolver información sobre el servidor RLM.

### Configurar el servidor RLM en Linux
<a name="prep-linux"></a>

**Para configurar el servidor RLM en Linux**

1. Copie el archivo `license.lic` editado en `/opt/nice/rlm/license/`.

1. Copie el archivo `/usr/share/dcv/license/nice.set` desde su servidor Amazon DCV y colóquelo en `/opt/nice/rlm` en su servidor RLM.

1. Cree un servicio de servidor RLM y asegúrese de que se inicia automáticamente al inicio.

   1. Cree un archivo llamado `dcv-rlm` en la carpeta `/opt/nice/rlm/`:

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

   1. Abra el archivo con su editor de texto preferido y agregue el siguiente script. Guarde y cierre el archivo.

      ```
      #! /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. Haga que el script sea ejecutable, cópielo en `/etc/init.d/` y, a continuación, agréguelo a la utilidad `chkconfig`:

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

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

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

1. Inicie el servidor RLM:

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

1. Confirme que el servidor RLM se ejecuta y funciona de la forma prevista. Abra `var/log/rlm.log` con su editor de texto preferido y confirme que aparece la línea siguiente:

   ```
   {{date_time}} (nice) Server started on license1 (hostid: {{host_id}}) for: dcv dcv-gl
   ```
**nota**  
El contenido del archivo `rlm.log` podría variar ligeramente dependiendo de la versión del servidor RLM.

## Paso 6: configuración del servidor Amazon DCV
<a name="setting-up-dcv-server"></a>

Configure el servidor Amazon DCV para utilizar el servidor RLM. Para ello, debe configurar el parámetro de configuración `license-file` en su servidor Amazon DCV.

 El parámetro `license-file` debe configurarse con la especificación del servidor RLM al que se va a conectar, con el formato `{{RLM_server_port}}@{{RLM_server}}`. El servidor RLM se puede especificar como nombre de host o como dirección IP. Si no se configura de forma explícita, el puerto del servidor RLM es `5053` de forma predeterminada. 

 En caso de que se utilicen varios servidores RLM, puede especificar una lista de las especificaciones de varios servidores RLM, separadas por `:` en Linux y por `;` en Windows. A continuación, el servidor intentará conectarse con cada uno de ellos sucesivamente, hasta que se pueda establecer una conexión con el servidor RLM correspondiente. Esto puede resultar especialmente útil, por ejemplo, cuando se utiliza un servidor de conmutación por error RLM como sustituto en caso de que no se pueda acceder al servidor RLM principal. En este caso, puede especificar la licencia con el formato: `{{RLM_primary_server_port}}@{{RLM_primary_server}}:{{RLM_failover_server_port}}@{{RLM_failover_server}}` 

**nota**  
En caso de que el servidor Amazon DCV esté instalado en Windows, debe separar las entradas de la especificación con `;`.

**Topics**
+ [Configuración del servidor Amazon DCV de Windows](#config-win)
+ [Configuración del servidor Amazon DCV de Linux](#config-linux)

### Configuración del servidor Amazon DCV de Windows
<a name="config-win"></a>

**Para configurar el parámetro de configuración `license-file` en un servidor Windows**

1. Abra el Editor del Registro de Windows.

1. **Navegue hasta la **clave HKEY\_USERS\\ S-1-5-18\\ Software\\\\ com\\nicesoftwareGSettings\\ dcv\\ license\\ y seleccione el parámetro del archivo** de licencia.**

   Si no hay ningún parámetro `license-file` en la clave del registro, debe crearlo:

   1. Abra el menú contextual (clic con el botón derecho) para la clave **license (licencia)** en el panel izquierdo y elija **New (Nuevo)**, **String value (Valor de cadena)**.

   1. En **Name (Nombre)**, escriba `license-file` y pulse **Intro**.

1. Abra el parámetro **license-file**. En **Value data (Datos de valor)**, introduzca el número de puerto y el nombre de host del servidor RLM en el formato `{{RLM_server_port}}@{{RLM_server}}`. Consulte la nota anterior si necesita configurar la conexión a varios servidores RLM. 

1. Haga clic en **Aceptar** y cierre el Editor del Registro de Windows.

### Configuración del servidor Amazon DCV de Linux
<a name="config-linux"></a>

**Para configurar el parámetro de configuración `license-file` en un servidor Linux**

1. Vaya a `/etc/dcv/` y abra `dcv.conf` con su editor de texto preferido.

1. Busque el parámetro `license-file` en la sección `[license]`. A continuación, reemplace la ruta existente por el nombre de host y el puerto del servidor RLM con el formato `{{RLM_server_port}}@{{RLM_server}}`.

   Si no hay un parámetro `license-file` en la sección `[license]`, agréguelo manualmente con el siguiente formato:

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

   Consulte la nota anterior si necesita configurar la conexión a varios servidores RLM.

1. Guarde y cierre el archivo.