

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Etapa 2: licenciar o servidor Amazon DCV
<a name="setting-up-license"></a>

Depois de instalar o software do servidor Amazon DCV, você precisa baixar e instalar a licença para usar o Amazon DCV. Os requisitos de licenciamento do Amazon DCV são diferentes dependendo de onde você estiver instalando e usando o servidor Amazon DCV.

**Importante**  
Os seguintes requisitos de licenciamento aplicam-se apenas à versão 2017.0 e posterior do Amazon DCV.

## Requisitos de licenciamento do Amazon DCV
<a name="dcv-lic-req"></a>

**Topics**
+ [Amazon DCV no Amazon EC2](#setting-up-license-ec2)
+ [Outros casos de uso do Amazon DCV](#setting-up-license-otherusecases)
+ [Requisitos de licenciamento da Microsoft para acessar remotamente o Windows Server](#windows-lic-reqs)

### Amazon DCV no Amazon EC2
<a name="setting-up-license-ec2"></a>

Você não precisa de um servidor de licenças para instalar e usar o servidor Amazon DCV em uma instância do EC2, incluindo instâncias em execução em Zonas AWS Locais AWS Outposts e Zonas Locais. O servidor Amazon DCV detecta automaticamente se ele está em execução em uma instância do Amazon EC2 e periodicamente se conecta a um bucket do S3 para determinar se uma licença válida está disponível. 

Verifique se a sua instância tem as seguintes propriedades:
+ Ela pode alcançar o endpoint do Amazon S3. Se tiver acesso à Internet, ela se conecta usando o endpoint público do Amazon S3. Se a instância não tiver acesso à Internet, configure um endpoint de gateway para a VPC com uma regra de grupo de segurança de saída ou uma política de lista de controle de acesso (ACL), que permite que você alcance o Amazon S3 por HTTPS. Para obter mais informações, consulte [Endpoints da VPC do gateway](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-gateway.html) no *Guia do usuário da Amazon VPC*. Se você tiver problemas para se conectar ao bucket do S3, consulte [Por que não é possível se conectar a um bucket do S3 usando um endpoint da VPC do gateway?](https://aws.amazon.com/premiumsupport/knowledge-center/connect-s3-vpc-endpoint/) no *Centro de conhecimento da AWS *.
+ Ele tem permissão para acessar o objeto do Amazon S3 requerido. Adicione a seguinte política de acesso do Amazon S3 à função do IAM da instância e substitua o *region* espaço reservado pela sua AWS região (por exemplo,). `us-east-1` Para obter mais informações, consulte [Criar Perfil do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html).

------
#### [ JSON ]

****  

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
         {
             "Effect": "Allow",
             "Action": "s3:GetObject",
             "Resource": "arn:aws:s3:::dcv-license.region/*"
         }
      ]
  }
  ```

------
+ Se você estiver usando uma instância do Windows, verifique se a instância pode acessar o *serviço de metadados da instância*. O acesso a esse serviço é necessário para garantir que o servidor Amazon DCV possa ser devidamente licenciado. Para mais informações sobre o serviço de metadados da instância, consulte [Recuperar metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-instance-metadata.html) no *Guia do usuário do Amazon EC2*.

  Se você estiver usando uma AMI personalizada do Windows, deverá instalar o EC2 Launch. Isso garante que sua instância possa acessar o serviço de metadados da instância. Para obter mais informações, consulte [Como configurar uma instância do Windows usando o EC2 Launch](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2launch.html) no Guia do *usuário do Amazon EC2*.

Se você estiver instalando e usando o servidor Amazon DCV em uma instância do Amazon EC2, você poderá ignorar o restante deste capítulo. O restante deste capítulo se aplica somente a todos os outros casos de uso do servidor Amazon DCV.

### Outros casos de uso do Amazon DCV
<a name="setting-up-license-otherusecases"></a>

Para todos os outros casos de uso, é necessária uma licença se quiser instalar e usar o servidor Amazon DCV. As seguintes opções de licenciamento estão disponíveis:
+ **Licença de avaliação automática**: esse tipo de licença é instalado automaticamente quando você instala o servidor Amazon DCV. Esse tipo de licença é válido por um período de 30 dias após a instalação. Depois que a licença expirar, não será mais possível criar e hospedar as sessões do Amazon DCV no servidor. Essas licenças são adequadas para testes e avaliação de curto prazo. Para testar por um período mais longo, solicite uma licença de avaliação estendida.
**nota**  
O servidor Amazon DCV assume como padrão a licença de avaliação automática se nenhuma outra licença tiver sido configurada.
+ **Licença de avaliação estendida**: uma licença de avaliação estendida é uma licença de avaliação que estende o período inicial de avaliação de 30 dias fornecido pela licença de avaliação automática. O período é determinado por AWS em uma case-by-case base. Licenças de avaliação estendidas são inválidas quando atingem a data de expiração, e não é mais possível criar nem hospedar sessões do Amazon DCV no servidor. As licenças de avaliação estendidas devem ser solicitadas a um distribuidor ou revendedor do Amazon DCV listado na página [Como comprar](https://www.nice-software.com/index.html#buy) do site do Amazon DCV. As licenças são fornecidas como um arquivo de licença que deve ser instalado no servidor Amazon DCV. 
**nota**  
Ao usar o Amazon DCV na instância Mac do Amazon EC2, o servidor Amazon DCV, a instância, deve ter acesso ao bucket S3 da licença Amazon DCV. Se a instância não tiver acesso ao bucket S3 da licença, não será possível iniciar uma sessão do Amazon DCV.
+ **Licença de produção**: uma licença de produção é uma licença completa que você compra do Amazon DCV. Licenças de produção são *licenças flutuantes* que são gerenciadas por um servidor de licenças. Com licenças flutuantes, você pode executar vários servidores Amazon DCV em sua rede. Ao mesmo tempo, você também pode limitar o número de sessões do Amazon DCV simultâneas criadas em todos os servidores. É necessário uma licença para cada sessão simultânea do Amazon DCV. Licenças de produção são distribuídas como um arquivo de licença que é necessário instalar em um servidor RLM (Reprise License Manager). Existem dois tipos de licenças de produção: 
  + **Licenças perpétuas** — As licenças perpétuas não têm data de expiração e podem ser usadas por um período indefinido.
  + **Assinaturas** — As assinaturas são válidas por um período limitado, normalmente um ano. A data de expiração da licença é indicada no arquivo de licença. Depois que a licença expirar, não será mais possível criar nem hospedar as sessões do Amazon DCV nos seus servidores Amazon DCV.

Para obter informações sobre como comprar uma licença perpétua ou uma assinatura do Amazon DCV, consulte [Como comprar](https://www.nice-software.com/index.html#buy) no site do Amazon DCV e encontre um distribuidor ou um revendedor do Amazon DCV na sua região. 

#### Requisitos de licenciamento
<a name="licensing-requirements"></a>
+ Os clientes do Amazon DCV não necessitam de uma licença.
+ Os arquivos de licença do servidor Amazon DCV são compatíveis com versões anteriores do servidor Amazon DCV. Por exemplo, você pode usar uma licença do servidor Amazon DCV versão 2021 com o servidor Amazon DCV versão 2019.
+ As versões do servidor Amazon DCV exigem pelo menos a mesma versão da licença do servidor Amazon DCV. Por exemplo, se você usa um servidor Amazon DCV versão 2021, você precisa de uma licença versão 2021 ou posterior. Se você atualizar para uma versão posterior do servidor Amazon DCV, será necessário solicitar arquivos de licença compatíveis. Para obter mais informações, entre em contato com o distribuidor ou o revendedor do Amazon DCV.

**nota**  
Para obter informações sobre a compatibilidade do servidor Amazon DCV, consulte [Considerações sobre compatibilidade](setting-up-upgrading.md#compatibility-considerations).

### Requisitos de licenciamento da Microsoft para acessar remotamente o Windows Server
<a name="windows-lic-reqs"></a>

A Microsoft exige que, além de uma Licença de Acesso para Cliente (CAL) do Windows Server, você tenha uma CAL de Serviços de Área de Trabalho Remota (RDS) do Windows Server para sua versão do Windows Server para cada usuário que acessa remotamente a interface gráfica do usuário (GUI) do servidor. Isso independentemente do protocolo de exibição remota que você usa. Essa licença também é necessária se você usar o Amazon DCV para acessar a GUI de um host remoto do Windows Server.

Se você executa um servidor Amazon DCV em uma instância do Amazon EC2 e usa [uma AMI do Windows Server](https://aws.amazon.com/windows/resources/amis/), a Amazon cuida dos custos de licenciamento da CAL do Windows Server e fornece dois CALs RDS do Windows Server destinados exclusivamente para fins administrativos. Isso é apenas para teste, manutenção e administração.

Para obter mais informações, consulte o [Site de termos de produtos da Microsoft](https://www.microsoft.com/licensing/terms/). Se tiver dúvidas sobre o licenciamento ou os direitos ao software da Microsoft, consulte sua equipe jurídica, a Microsoft ou seu revendedor da Microsoft.

# Instalar uma licença de avaliação estendida
<a name="setting-up-evaluation"></a>

Quando você solicita uma licença de avaliação estendida do Amazon DCV, recebe um arquivo `license.lic` que define a licença. 

**Para instalar a licença de avaliação estendida**  
Coloque o arquivo `license.lic` na seguinte pasta em seu servidor:
+ Servidor do Windows

  ```
  C:\Program Files\NICE\DCV\Server\license\license.lic
  ```
+ Servidor do Linux

  ```
  /usr/share/dcv/license/license.lic
  ```

Ou, para colocar o arquivo `license.lic` em uma pasta diferente no servidor, é necessário atualizar o parâmetro de configuração `license-file` para que ele especifique o caminho completo do arquivo de licença.

**Topics**
+ [Alterar o caminho de licença em um servidor do Windows](#change-param-win)
+ [Alterar o caminho de licença em um servidor do Linux](#change-param-lin)

## Alterar o caminho de licença em um servidor do Windows
<a name="change-param-win"></a>

**Para atualizar o parâmetro de configuração `license-file` em um servidor Windows**

1. Abrir o Editor do Registro do Windows.

1. **Navegue até a **chave HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1 dcv\$1 license\$1 e selecione o parâmetro do arquivo de licença**.**

   Se não houver um parâmetro `license-file` na chave do registro, crie um:

   1. Abra o menu de contexto (clique com o botão direito do mouse) da chave **license** no painel à esquerda e escolha **Novo**, **Valor da string**.

   1. Em **Nome**, insira `license-file` e pressione **Enter**.

1. Abra o parâmetro **license-file**. Para **Dados do valor**, insira o caminho completo para o arquivo `license.lic`.

1. Escolha **OK** e feche o Editor do Registro do Windows.

## Alterar o caminho de licença em um servidor do Linux
<a name="change-param-lin"></a>

**Para atualizar o parâmetro de configuração `license-file` em um servidor Linux**

1. Navegue até `/etc/dcv/` e abra o `dcv.conf` com seu editor de texto escolhido.

1. Localize o parâmetro `license-file` na seção `[license]` e substitua o caminho existente pelo novo caminho completo para o arquivo `license.lic`.

   Se não houver um parâmetro `license-file` na seção `[license]`, adicione-o usando o formato a seguir:

   ```
   license-file = "/custom-path/license.lic"
   ```

1. Salve e feche o arquivo.

# Instalar uma licença de produção
<a name="setting-up-production"></a>



As seções a seguir neste tópico descrevem como comprar e usar uma licença de produção (licença perpétua ou assinatura).

**Topics**
+ [Etapa 1: instalar o servidor RLM](#install-rlm)
+ [Etapa 2: obter o ID do host do servidor RLM](#hostid-rlm)
+ [Etapa 3: adquirir a licença perpétua ou a assinatura](#license-purchase)
+ [Etapa 4: modificar o arquivo de licença](#setting-up-production-license-file)
+ [Etapa 5: Configurar o servidor RLM](#setting-up-rlm-server)
+ [Etapa 6: configurar o servidor Amazon DCV](#setting-up-dcv-server)

## Etapa 1: instalar o servidor RLM
<a name="install-rlm"></a>

Quando você compra uma licença perpétua ou uma assinatura, obtém um arquivo de licença que define os termos da licença. É necessário instalar o arquivo de licença em um servidor RLM (Reprise License Manager). 

Para obter mais informações sobre o RLM, consulte o site da [Reprise Software](https://reprisesoftware.com/products/reprise-license-manager-rlm/).

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

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

**Para instalar o servidor RLM no Windows**

1. Faça download do Pacote de Administração de Licenças RLM no [site da Reprise Software](https://reprisesoftware.com/support/admin/license-administration-bundle/).
**nota**  
A partir da versão 2022.1 do Amazon DCV, o servidor RLM >= 14 é necessário. As versões anteriores exigem RLM >= 12.  
A instalação da versão estável mais recente do pacote de administração da licença do RLM é recomendada.

1. Instale o pacote de administração de licenças do RLM em `C:\RLM`.

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

**Para instalar o servidor RLM no Linux**

1. Faça download do Pacote de Administração de Licenças RLM no [site da Reprise Software](https://reprisesoftware.com/support/admin/license-administration-bundle/).
**nota**  
A partir da versão 2022.1 do Amazon DCV, o servidor RLM >= 14 é necessário. As versões anteriores exigem RLM >= 12.  
A instalação da versão estável mais recente do pacote de administração da licença do RLM é recomendada.

1. Crie um grupo de usuários e um usuário `rlm`. Pode ser qualquer conta de usuário ou de serviço válida. Recomendamos enfaticamente que não utilize a conta raiz para este valor.

   ```
   $ groupadd -r rlm
   ```

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

1. Crie os diretórios `/opt/nice/rlm/license` e `/opt/nice/rlm` necessários para o servidor RLM.

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

1. Extraia o conteúdo do Pacote de Administração de Licenças RLM para `/opt/nice/rlm/` e garanta que os arquivos sejam de propriedade do usuário `rlm`.

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

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

## Etapa 2: obter o ID do host do servidor RLM
<a name="hostid-rlm"></a>

Depois de instalar o servidor RLM, é necessário obter o ID do host do servidor RLM. Você precisará fornecer essa ID do host ao comprar uma licença perpétua ou uma assinatura.

### Obter a ID do host do servidor RLM no Windows
<a name="hostid-rlm-windows"></a>

**Para obter o ID do host do servidor, abra o prompt de comando,**  
Navegue até `C:\RLM\` e execute o seguinte comando.

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

O comando retorna a ID do host do servidor RLM da seguinte maneira.

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

Anote a ID do host. Você precisa dele para a próxima etapa.

### Obter a ID do host do servidor RLM no Linux
<a name="hostid-rlm-linux"></a>

**Para obter a ID do host do servidor, retorno único**

1. Acesse `/opt/nice/rlm/`.

1. Execute o seguinte comando:

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

   O comando retorna a ID do host do servidor RLM para cada interface de rede da seguinte maneira.

1. Registre o ID do host. Você precisa dele para a próxima etapa.

**Example**  
Esse procedimento foi executado, e a seguinte ID única foi retornada:  

```
Hostid of this machine: 0a1b2c3d4e5f
```
Essa ID é então registrada e será usada para comprar a licença do DCV.

**Para obter a ID do host do servidor, vários retornos**

1. Acesse `/opt/nice/rlm/`.

1. Execute este comando: .

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

   Vários IDs serão retornados em uma lista de IDs.

1. Execute o comando a seguir.

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

   O comando deve retornar a ID do host do servidor RLM para a interface de rede do gateway. 

1. Registre o ID do host. Você precisa dele para a próxima etapa.

**Example**  
O procedimento foi executado e vários IDs foram retornados em uma lista de vários IDs:  

```
Hostid of this machine: 0a1b2c3d4e5f 1b2c3d4e5f6a 2c3d4e5f6a7b 3d4e5f6a7b8c
```
O comando da interface é executado e retorna a seguinte ID:  

```
Hostid of this machine: 0a1b2c3d4e5f
```
Essa ID é então registrada e será usada para comprar a licença do DCV.

## Etapa 3: adquirir a licença perpétua ou a assinatura
<a name="license-purchase"></a>

Para obter informações sobre como comprar uma licença perpétua ou uma assinatura do Amazon DCV, consulte [Como comprar](https://www.nice-software.com/index.html#buy) no site do Amazon DCV e encontre um distribuidor ou um revendedor do Amazon DCV na sua região.

É necessário fornecer a ID do host do servidor RLM. O ID do host está incorporado no arquivo de licença que o Amazon DCV fornece.

## Etapa 4: modificar o arquivo de licença
<a name="setting-up-production-license-file"></a>

Quando você compra uma licença perpétua ou uma assinatura do Amazon DCV, recebe um arquivo `license.lic` que define a licença. O arquivo `license.lic` inclui as seguintes informações:
+ O nome do host do servidor RLM.
+ A ID do host do servidor RLM que você forneceu quando comprou a licença.
+ O número da porta TCP do servidor RLM. O padrão é `5053`.
+ O número da porta ISV. Esta é uma porta opcional na qual o servidor RLM escuta solicitações de licença do Amazon DCV. Se não for especificada, uma porta aleatória é selecionada pelo RLM no startup.
+ Os produtos do Amazon DCV cobertos pela licença, juntamente com os seguintes detalhes de cada produto:
  + A versão principal coberta pela licença (por exemplo, `2017` para os produtos do Amazon DCV de 2017).
  + A data de expiração. `Permanent` indica que a licença não expira.
  + O número máximo de sessões simultâneas (por exemplo, `10` para 10 sessões simultâneas no servidor).
  + A soma de verificação da licença.
  + A assinatura da licença.

O bloco de código a seguir mostra o formato do arquivo `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"
```

O bloco de código a seguir mostra um exemplo de um arquivo `license.lic` com a porta ISV omitida. O arquivo de licença inclui licenças para dois produtos do Amazon 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"
```

**Para editar o arquivo `license.lic`**

1. Abra o arquivo com o editor de texto de sua preferência.

1. Adicione o nome de host do servidor RLM e o número da porta TCP à primeira linha do arquivo, que começa com `HOST`.
**Atenção**  
*RLM\$1server\$1host\$1id*É a ID do host que você forneceu quando comprou a licença. Você não pode editar *RLM\$1server\$1host\$1id* o.

1. (Opcional) Adicione o número da porta ISV na linha do arquivo que começa com `ISV` adicionando `port=port_number`. Essa porta é necessária para permitir a comunicação com o servidor DCV. 

   Se você não quiser especificar uma porta ISV, omita `port=port_number`. Se você não especificar uma porta ISV, uma porta aleatória será usada pelo RLM em cada startup. 
**Atenção**  
Se você tiver uma configuração de firewall impedindo o uso de uma porta selecionada aleatoriamente, precisará especificar essa porta e configurar o firewall para ativá-la, além da porta RLM do especificada na linha `HOST`. 

1. Salve e feche o arquivo.

**Atenção**  
Editar qualquer outra parte do arquivo de licença corrompe a assinatura do arquivo e invalida a licença.

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

Depois de modificar o arquivo de licença, é necessário colocá-lo no servidor RLM e iniciar o serviço do RLM.

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

### Configurar o servidor RLM no Windows
<a name="prep-windows"></a>

**Como configurar o servidor RLM no Windows**

1. Conecte-se ao servidor RLM.

1. Copie o arquivo `license.lic` editado em `C:\RLM\license\`.

1. Copie o arquivo `C:\Program Files\NICE\DCV\Server\license\nice.set` do servidor Amazon DCV e coloque-o na pasta `C:\RLM\` no seu servidor RLM.

1. Instale o servidor RLM como um serviço do Windows.

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

   Para obter mais informações sobre as opções de startup do RLM, consulte a página do produto [Reprise Software License Manager (RLM)](https://reprisesoftware.com/products/reprise-license-manager-rlm/).

1. Inicie o servidor RLM.

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

1. Confirme se o servidor RLM está em execução.

   1. Abra o arquivo `C:\RLM\nice.dlog` com o editor de texto escolhido e confirme se a linha a seguir é exibida.

      ```
      date_time (nice) Server started on license1 (hostid: host_id) for: dcv dcv-gl
      ```
**nota**  
O conteúdo do arquivo `rlm.log` pode variar um pouco dependendo da versão do servidor RLM.

   1. Execute o comando a seguir.

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

      O comando retorna informações sobre o servidor RLM.

### Configurar o servidor RLM no Linux
<a name="prep-linux"></a>

**Como configurar o servidor RLM no Linux**

1. Copie o arquivo `license.lic` editado em `/opt/nice/rlm/license/`.

1. Copie o arquivo `/usr/share/dcv/license/nice.set` do servidor Amazon DCV e coloque-o em `/opt/nice/rlm` no seu servidor RLM.

1. Crie um serviço de servidor RLM e verifique se ele é iniciado automaticamente na inicialização.

   1. Crie um arquivo chamado `dcv-rlm` na pasta `/opt/nice/rlm/`:

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

   1. Abra o arquivo usando o editor de texto escolhido e adicione o seguinte script. Salve e feche o arquivo.

      ```
      #! /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. Torne o script executável, copie-o para `/etc/init.d/` e, em seguida, adicione-o ao utilitário `chkconfig`:

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

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

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

1. Inicie o servidor RLM:

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

1. Verifique se o servidor RLM está em execução e funcionando conforme o esperado. Abra o arquivo `var/log/rlm.log` com o editor de texto escolhido e confirme se a linha a seguir é exibida:

   ```
   date_time (nice) Server started on license1 (hostid: host_id) for: dcv dcv-gl
   ```
**nota**  
O conteúdo do arquivo `rlm.log` pode variar um pouco dependendo da versão do servidor RLM.

## Etapa 6: configurar o servidor Amazon DCV
<a name="setting-up-dcv-server"></a>

Configure o servidor Amazon DCV para usar o servidor RLM. Para fazer isso, é necessário configurar o parâmetro de configuração `license-file` no servidor Amazon DCV.

 O parâmetro `license-file` deve ser definido com a especificação do servidor RLM ao qual será conectado, no formato `RLM_server_port@RLM_server`. O servidor RLM pode ser especificado como nome de host ou endereço IP. Se não for configurada explicitamente, a porta do servidor RLM é, por padrão, `5053`. 

 Caso vários servidores RLM estejam em uso, você pode especificar uma lista de várias especificações de servidores RLM, separadas por `:` no Linux e `;` no Windows. Em seguida, o servidor tentará se conectar a cada um por vez, até que uma conexão possa ser estabelecida com o servidor RLM correspondente. Isso pode ser especialmente útil, por exemplo, ao usar um servidor de failover RLM para assumir o controle, caso o servidor RLM primário não esteja acessível. Nesse caso, você pode especificar a licença no formato: `RLM_primary_server_port@RLM_primary_server:RLM_failover_server_port@RLM_failover_server` 

**nota**  
Caso o Amazon DCV Server esteja instalado no Windows, você precisará separar as entradas na especificação com `;`.

**Topics**
+ [Configuração do servidor Amazon DCV do Windows](#config-win)
+ [Configuração do servidor Amazon DCV do Linux](#config-linux)

### Configuração do servidor Amazon DCV do Windows
<a name="config-win"></a>

**Para configurar o parâmetro de configuração `license-file` em um servidor Windows**

1. Abrir o Editor do Registro do Windows.

1. **Navegue até a **chave HKEY\$1USERS\$1 S-1-5-18\$1 Software\$1\$1 com\$1nicesoftwareGSettings\$1 dcv\$1 license\$1 e selecione o parâmetro do arquivo de licença**.**

   Se não houver um parâmetro `license-file` na chave do registro, será necessário criá-lo:

   1. Abra o menu de contexto (clique com o botão direito do mouse) da chave **license** no painel à esquerda e escolha **Novo**, **Valor da string**.

   1. Em **Nome**, insira `license-file` e pressione **Enter**.

1. Abra o parâmetro **license-file**. Em **Dados do valor**, insira o número da porta e o nome do host do servidor RLM no formato `RLM_server_port@RLM_server`. Verifique a nota acima se precisar configurar a conexão com vários servidores RLM. 

1. Escolha **OK** e feche o Editor do Registro do Windows.

### Configuração do servidor Amazon DCV do Linux
<a name="config-linux"></a>

**Para configurar o parâmetro de configuração `license-file` em um servidor Linux**

1. Navegue até `/etc/dcv/` e abra o `dcv.conf` com seu editor de texto escolhido.

1. Localize o parâmetro `license-file` na seção `[license]`. Depois, substitua o caminho existente pela porta e pelo nome de host do servidor RLM no formato `RLM_server_port@RLM_server`.

   Se não houver um parâmetro `license-file` na seção `[license]`, adicione-o usando o formato a seguir:

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

   Verifique a nota acima se precisar configurar a conexão com vários servidores RLM.

1. Salve e feche o arquivo.

# Atualizar a licença de produção
<a name="updating-licenses"></a>

O servidor Amazon DCV verifica as licenças no servidor RLM a cada poucos minutos. Caso a licença seja atualizada no servidor RLM, o servidor Amazon DCV atualiza automaticamente a licença usada para as sessões em execução. O procedimento a seguir detalha como atualizar uma licença DCV no RLM. 

**Para atualizar a licença do DCV no servidor RLM**

1. Atualize o arquivo de licença que foi [instalado](setting-up-production.md#setting-up-rlm-server) anteriormente. No Linux, ele deveria ter sido colocado em `/opt/dcv/rlm/license/license.lic`, no Windows, em `C:\RLM\license\license.lic`.

1. Execute `C:\RLM\rlmutil.exe rlmreread` no Windows ou `/opt/nice/rlm/rlmutil rlmreread` no Linux para forçar o recarregamento do arquivo de licença.

 Depois que a licença for atualizada no servidor RLM, o servidor Amazon DCV deverá verificar o uso das novas licenças em alguns minutos (geralmente cinco minutos ou menos). 

 A partir da versão 2021.0 do Amazon DCV, você pode usar o seguinte comando **como administrador** para forçar a atualização da licença imediatamente: 

```
$ dcv reload-licenses
```