Instalar uma licença de produção - Amazon DCV

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).

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.

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.

    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.

  2. 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.

    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.

  2. 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
  3. Crie os diretórios /opt/nice/rlm/license e /opt/nice/rlm necessários para o servidor RLM.

    $ mkdir -p /opt/nice/rlm/license
  4. 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 a 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/.

  2. 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.

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

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/.

  2. Execute o seguinte comando:

    $ ./rlmutil rlmhostid ether

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

  3. Execute o seguinte comando:

    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.

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

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

Para obter informações sobre como comprar uma licença perpétua ou uma assinatura do Amazon DCV, consulte Como comprar 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.

  2. 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.

  3. (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.

  4. 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.

Configurar o servidor RLM no Windows

Como configurar o servidor RLM no Windows
  1. Conecte-se ao servidor RLM.

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

  3. 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.

  4. 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).

  5. Inicie o servidor RLM.

    C:\> net start dcv-rlm
  6. 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.

    2. Execute o seguinte comando:

      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/.

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

  3. 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
    2. 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:
    3. 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
  4. Inicie o servidor RLM:

    $ service dcv-rlm start
  5. 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 ;.

Configuração do servidor Amazon DCV do Windows

Para configurar o parâmetro de configuração license-file em um servidor Windows
  1. Abrir o Editor do Registro do Windows.

  2. Navegue até a chave HKEY_USERS\ S-1-5-18\ Software\\ com\nicesoftwareGSettings\ 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.

    2. Em Nome, insira license-file e pressione Enter.

  3. 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.

  4. 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 license-file em um servidor Linux
  1. Navegue até /etc/dcv/ e abra o dcv.conf com seu editor de texto escolhido.

  2. 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.

  3. Salve e feche o arquivo.