Manual do usuário - eDocs > Manual de instalação > Instalação e atualização via linha de comando

Instalação e atualização via linha de comando

O eDocs permite a instalação e atualização também via linha de comando. Dessa forma é possível realizar o processo sem a iteração com as telas do instalador.

Este recurso não está disponível para Cliente e Printservice Windows.

Importante

O instalador deve ser executado com permissão de administrador;
O Configurador não pode estar em execução durante uma atualização;
É recomendável realizar o backup da base e parar os serviços antes de atualizar;
A instalação por linha de comando não gera log do processo de instalação/atualização. Dessa forma, em caso de problemas recomenda-se repetir o processo utilizando a processo padrão, através da interface gráfica, para obtenção do log de instalação e detalhes do possível problema;
O sistema concatena o nome da instalação nos atalhos. Assim, em sistemas operacionais mais recentes é possível diferenciar os atalhos quando existem várias instalações na mesma máquina;
Em caso de erro de conexão com a base de dados o sistema será instalado/atualizado mas a base não será alterada. Nesse caso é necessário repetir a atualização ou executar o comando de atualização manualmente (através do Configurador com parâmetro gsbd);
O sistema passa a atribuir o usuário no AppPool do IIS ao salvar as configurações do Configurador. Dessa forma, ao atualizar o sistema a aplicação do IIS continua utilizando o usuário e senha atribuídos antes do processo de atualização;
A atualização por linha de comando deve ser utilizada em versões acima da 5.8.10.14, onde ocorre ajustes na base de eventos de eSocial.

Instalação

Para a instalação do eDocs via linha de comando é necessário baixar o arquivo eDocs_Servidor.exe no diretório da Senior e executar o seguinte comando:

eDocs_Servidor.exe /S /nomeInstalacao <nome instalação> /caminho "<caminho da instalação>" /tipoBanco <tipo do banco de dados> 
/servidor <endereço do servidor de banco de dados> /porta <porta do servidor de banco> /usuario <usuário de banco> 
/senha <senha de banco> /banco <nome do serviço ou base>

Observação

A instalação por linha de comando é executada em segundo plano. Assim, se a execução do instalador for iniciada por uma janela de console ou script bat, após o inicio do processo de instalação/atualizado a execução não aguarda o término do processo para prosseguir. Caso seja necessário aguardar todo o processo, para então prosseguir como a execução, deve-se utilizar os comandos start/wait antes dos comandos de execução.

Exemplo:

start /wait eDocs_Servidor.exe /S /nomeInstalacao demonstracao /caminho "c:\senior\demo" /tipoBanco SQLServer2016 /servidor localhost\sqlexpress /porta 1433 /usuario sa /senha sqlserver /banco demonstracao

Parâmetros:

<nome instalação>: informe o nome de identificação da instalação sem caracteres especiais ou acentos. Não deve existir uma instalação com o mesmo nome. Caso exista o instalador irá cancelar a execução;
<caminho da instalação>: diretório onde será instalado o eDocs;
<tipo do banco de dados>: indica qual o banco de dados e a versão utilizada, de acordo com as opções abaixo:
- Oracle 10g R2, 11g, 12c R1/R2 e 18c;
- SQL Server 2008, 2012, 2014*, 2016 e 2017;
Importante: este parâmetro deve ser declarado usando a sintaxe SQLServer2016 ou Oracle12c, de acordo com a versão do respectivo banco de dados.
<endereço do servidor de banco de dados>: endereço do servidor de banco;
<porta do servidor de banco>: porta utilizada para conexão;
<usuário de banco>: usuário para acesso ao banco de dados;
<senha de banco>: senha para acesso ao banco de dados;
<nome do serviço ou base>: nome da base (SQL Server) ou do serviço (Oracle).

Atualização

Para a atualização do eDocs via linha de comando é necessário baixar o arquivo eDocs_Servidor.exe no diretório da Senior e executar o seguinte comando:

eDocs_Servidor.exe /S /nomeInstalacao <nome instalação>

Parâmetro:

<nome instalação>: informe o nome da instalação que será atualizada sem caracteres especiais ou acentos. Caso não seja encontrada um instalação com o nome informado o atualizador irá cancelar a execução.