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á. # Instalar uma licença de produção 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 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 **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 **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 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 **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 **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 o seguinte 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árias IDs foram retornadas em uma lista de várias 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 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 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\_server\_host\_id}}É a ID do host que você forneceu quando comprou a licença. Você não pode editar {{RLM\_server\_host\_id}} 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 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 **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 **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 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 **Para configurar o parâmetro de configuração `do arquivo de licença` em um servidor Windows** 1. Abrir o Editor do Registro do Windows. 1. **Navegue até a **chave HKEY\_USERS\\\\ SoftwareS-1-5-18\\ GSettings\\ com\\nicesoftware\\ dcv\\ license\\** 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 **Para configurar o parâmetro de configuração `do arquivo de licença` 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.