Instalar o agente do EPM Windows via CMD

Prev Next

Instale o client do EPM no Microsoft Windows a partir da linha de comando, utilizando o comando msiexec.

Siga estes passos:

Abra o Prompt de Comando, PowerShell ou Bash no Windows. Vá até a pasta onde o instalador do EPM (arquivo .msi) está armazenado. Execute o seguinte comando:

msiexec /i "EPM.v.<version>.msi" /passive TOKEN=<token> URL=<IP or domain name> ADDLOCAL=Core,Vault,Automation /l log.txt

Lembre-se de substituir os valores indicados pelos sinais de maior que e menor que (<>):

  1. Troque <version> pela versão do arquivo instalador do EPM e mantenha as aspas. Por exemplo: "EPM.v.4.2.15.2.msi".
  2. Troque <token> pela chave de instalação disponível na Segura® Platform, na página de configuração de parâmetros do EPM.
  3. Troque <IP or domain name> pelo endereço de IP do servidor da Segura® Platform, ou pelo domínio (em casos de DNS configurado).

TOKEN e URL são obrigatórios. Caso algum deles esteja ausente ou inválido, o instalador retorna um erro e não prossegue. Nenhum arquivo é instalado.

Compatibilidade de versão

O instalador verifica a compatibilidade de versão antes de instalar.

  • Se as versões forem compatíveis, a instalação continua normalmente.
  • Se a sua Segura® Platform exigir uma versão do agente mais recente do que a que está sendo instalada, o instalador bloqueia a instalação e não modifica nenhum arquivo. O instalador também registra o evento no Windows Event Viewer.

Se os parâmetros forem inválidos ou estiverem ausentes, ou se a versão for incompatível, o msiexec reverte automaticamente a instalação: nenhum arquivo é modificado na máquina.

Reinstalação

Executar o comando de instalação cria uma pasta chamada IsolatedStorage em C:/ProgramData/, que armazena o token e o IP do servidor da Segura® Platform.

Não é necessário informar novamente o token ou o IP da Segura® Platform durante a reinstalação.

Para garantir uma reinstalação completa, utilize o parâmetro REINSTALLMODE=AS:

msiexec /i "EPM.v.<version>.msi" /passive ADDLOCAL=Core,Vault,Automation /l log.txt REINSTALLMODE=AS

Sobre os parâmetros dos comandos de instalação e reinstalação

Parâmetro Descrição
/i Especifica a função de instalação do msiexec.
<version> Versão do arquivo instalador do agente do EPM.
/passive Estabelece instalação passiva, que não exige interação do usuário.
TOKEN Obrigatório. Chave de instalação para relacionar o client EPM que está sendo instalado com a Segura® Platform.
URL Obrigatório. IP ou domínio (caso haja DNS configurado) do servidor da Segura® Platform.
ADDLOCAL Parâmetro para definição de quais módulos do client EPM serão instalados. O Core é obrigatório, enquanto Vault e Automation são opcionais.
/l log.txt (opcional) Gera o arquivo log.txt com os registros da instalação, para resolução de problemas.