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.