Instalar o servidor proxy do Edge Encryption (instalador de linha de comando)

  • Versão de lançamento: Yokohama
  • Atualizado 20 de fev. de 2025
  • 3 min. de leitura

    • Instale o proxy do Edge Encryption em um computador Windows ou Linux de 64 bits.

    Antes de Iniciar

    Função necessária: administrador

    O Java versão 11.0.6 ou posterior na série de versões 11.x é necessário para executar o instalador.

    Por Que e Quando Desempenhar Esta Tarefa

    Instale o servidor proxy do Edge Encryption em uma máquina na sua rede usando o comando apropriado da sua máquina de destino. Se estiver instalando o servidor proxy do Edge Encryption em uma máquina Windows, deverá instalar adicionalmente o servidor proxy como um serviço do Windows.

    Quando você atualiza o servidor proxy do Edge Encryption, o sistema faz backup do proxy antigo no diretório backup.dist-upgrade-<timestamp> sob o diretório de instalação atual. O diretório de backup é gerado durante o processo de upgrade e armazena as informações do proxy antigo.

    Quando você executa uma atualização por meio da linha de comando, um dist-upgrade.log pode ser gerado no diretório em que o comando é executado. O dist-upgrade.log contém logs do processo de atualização.

    Em caso de falha na atualização, o sistema cria um diretório fail-backup.dist-upgrade- <timestamp> . Além disso, logs/wrapper.log no diretório de proxy original também pode conter informações de falha.

    Procedimento

    1. Crie o diretório de instalação
    2. Baixe o arquivo do proxy do Edge Encryption para o diretório de instalação.
    3. Abra o terminal e mude para o diretório de instalação.
      Nota:
      Se a instalação ocorrer em uma máquina Windows, você deve iniciar o Prompt de comando do Windows com privilégios de administrador.
    4. Execute este comando para a máquina de destino e altere as variáveis de acordo com sua configuração: java -jar edgeencryption-<version> -all.jar -m instalar –n<proxy_name> --instancehost<host> -p<port> --protocolo https –s<install_path>
      Opção Variável Descrição
      nenhum versão Número da versão do proxy do Edge Encryption que está sendo usado para executar a operação atual.
      -m modo Modo de tempo de execução. As opções são "instalar" para um novo servidor proxy do Edge ou "dist-upgrade" para fazer upgrade de um servidor proxy do Edge existente.
      -n nome_do_proxy Nome do servidor proxy Edge Encryption instalado. Use um proxy_name exclusivo para identificar instâncias de proxy específicas.
      --instancehost Host O nome do host da sua instância da ServiceNow (por exemplo, mycompany.service-now.com).
      -p porta Portar sua instância ServiceNow escuta em. Normalmente, as conexões HTTPS seguras escutam na porta 443 e as conexões HTTP escutam na porta 80.
      --protocol protocolo Protocolo que o proxy do Edge instalado usa ao se conectar ao host de back-end ServiceNow. Normalmente, é HTTPS (preferencial para conexões TLS seguras) ou HTTP (conexões sem TLS), dependendo do protocolo compatível com a instância do host.
      Nota:
      Não copie e cole comandos do navegador. Ocasionalmente, as operações de copiar/colar fazem com que caracteres inesperados sejam colados na máquina de destino e resultem na execução incorreta do comando. É melhor digitar o comando manualmente usando a documentação como referência.

      Para ver a tela de ajuda, execute este comando com a opção –help : java -jar edgeencryption-<version> -all.jar --help

    5. Se a instalação for feita em uma máquina Windows, instale o proxy do Edge Encryption como um serviço do Windows.
      1. Opcional: Mude o nome do serviço abrindo o arquivo conf/wrapper.conf no novo proxy e definindo as propriedades na tabela a seguir.
        Propriedade Descrição
        wrapper.ntservice.name Nome exclusivo do serviço de proxy do Edge Encryption.
        wrapper.ntservice.displayname Edge Encryption: o nome de exibição do serviço de proxy.
        wrapper.ntservice.description (opcional) Descrição do servidor proxy.

        Se esta etapa não for executada, o serviço de proxy do Edge Encryption será instalado com o nome de Edge Encryption.

      2. Salve e feche o arquivo.
      3. Abra o Prompt de comando do Windows e faça cd para ServerName_port /bin.
      4. Execute oedgeencryption.bat install.

    Resultado

    O diretório ProxyName_port será criado no diretório atual. O arquivo edgeencryption.properties será atualizado com os valores de host, porta e protocolo da linha de comando.