---
description: Syslog - Instalação
---

# Instalação

Nesta página descreve-se o processo de instalação do Syslog V3.

O Syslog é constituído por quatro produtos que funcionam de forma interdependente, baseados em tecnologia SQL. Dependendo do processo de licenciamento, estão disponíveis os seguintes produtos: o [**BackOffice** ](syslog-backoffice)(para a interligação com a base de dados e configurações da aplicação); a [**app** ](syslog-app)(aplicação a funcionar no terminal); o [**MISCommunicator** ](miscommunicator)(aplicação que permite a comunicação entre os vários componentes e a base de dados) e a aplicação de [**Monitor** ](monitor/monitor)de Dashboard.

Nesta página apresenta-se o processo de instalação e integração com a base de dados do cliente (ERP) do BackOffice do Syslog. Para o processo de instalação da _app_ acede-se à informação [aqui](syslog-app/instalacao), e para o Monitor de Dashboard [aqui](monitor/monitor/instalacao).

{% hint style="success" %}
A aplicação de BackOffice funciona em ambiente Windows ou em ambiente Android (na pasta da aplicação, após a instalação, fica disponível o ficheiro para instalar em Android (versão _tablet_).
{% endhint %}

{% hint style="info" %}
O Setup permite fazer instalações para vários ERPs/Bases de dados no mesmo computador desde que em pastas diferentes.
{% endhint %}

Seguidamente, apresentam-se três cenários para a instalação do Syslog. Conforme a realidade da empresa deverá escolher-se o cenário mais adequado. Assim, se é uma nova instalação deve-se seguir o [cenário 1](#cenario-1), se é uma atualização de uma instalação Syslog V3 já existente segue-se o [cenário 2](#cenario-2), ou se é uma atualização de uma instalação Syslog V2 segue-se o [cenário 3](#cenario-3).

## Cenário 1 - Instalação de raiz

No primeiro cenário descreve-se o processo para uma instalação nova do Syslog. Este processo é simples, pois basta correr o Setup da aplicação e ir preenchendo os parâmetros que vão sendo solicitados ao longo de 4 passos.

### Passo 1

![](https://1264781937-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M2-1-2UlUfW3YiJoapp%2F-M3CajpmZeVA1VamO81Y%2F-M3CbWYi8lszhtD0lzH1%2FEcra%201.png?alt=media\&token=111b4da3-5862-4d0b-9211-b9347b9ef33e)

As opções iniciais para a instalação do Syslog solicitam a seguinte informação:

#### Pasta de instalação

Define-se três hipóteses para a pastas de instalação:

* Pasta sugerida por defeito (Pasta MIS)
* Pasta a criar na pasta "Program Files" do Windows
* Outra localização para a pasta de instalação

{% hint style="info" %}
Na pasta de instalação ficará disponível o Backoffice, ficheiros de apoio e a aplicação para instalar no terminal (ficheiro APK).
{% endhint %}

#### Licença

* _Online_ - Deve-se ativar esta opção para que a licença seja transmitida para o(s) terminal(ais)
* _Utilizador_ - Utilizador de registo da licença
* _Password_ - Password para o utilizador da licença

#### SQL Server

* _Servidor_ - Endereço do servidor SQL
* _Base de dados Syslog_ - Nome da base de dados do ERP no SQL
* _Utilizador_ - Utilizador para acesso à base de dados no SQL
* _Password_ - Password da base de acesso à base de dados

{% hint style="warning" %}
Todos os campos são de preenchimento obrigatório
{% endhint %}

### Passo 2

No passo seguinte é requerida a escolha do ERP da empresa para a ligação do Syslog. Desta forma, apresentam-se as diferentes formas de instalação divididas pelos ERP com os quais o Syslog integra.&#x20;

Neste ecrã, a primeira solicitação pede para ser escolhido o ERP. Após essa escolha o sistema altera as opções abaixo conforme a seleção efetuada.

Deve-se escolher nas tabulações o ERP específico.

{% tabs %}
{% tab title="Eticadata" %}
Para o Eticadata os dados requeridos são:

![](https://1264781937-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M2-1-2UlUfW3YiJoapp%2F-M3p2CDllKS-0A78DyzQ%2F-M3p6WnRF72cQZDoKDOH%2FEcra%202%20Eticadata.png?alt=media\&token=e86e9146-62b7-4e50-9573-ab19ba463f21)

A primeira opção solicita o preenchimento da versão do Eticadata instalada (com as quais o Syslog é compatível). Depois solicita a indicação da pasta de instalação do ERP. Por defeito o sistema indica a pasta padrão, que pode ser alterada caso tenha sido realizada noutro local.

Os campos a seguir solicitam:

* _BD de Sistema_ - Base de dados do Eticata
* _Código da Empresa_ - Nome da ligação ou código da empresa no Eticadata
* _Utilizador_ - Nome do utilizador para acesso à base de dados
* _Password_ - Password do utilizador

A seguir clicar em _seguinte._
{% endtab %}

{% tab title="PHC" %}
Para o PHC os dados requeridos são:

![](https://1264781937-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M2-1-2UlUfW3YiJoapp%2F-M3Cr-mS8ZJTaONLBwnE%2F-M3Cf4-LEtewJEJMpI7d%2FEcra%202%20PHC.png?alt=media\&token=e6f0ce7d-3c0c-4fe2-833f-00a4ad2cc80f)

{% hint style="info" %}
O PHC não utiliza o Driver para integrar. Utiliza o sistema por SP - Storage Procedures através de SQL.
{% endhint %}

A seguir clicar em _seguinte._
{% endtab %}

{% tab title="Primavera" %}
Para o Primavera os dados requeridos são:

![](https://1264781937-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M2-1-2UlUfW3YiJoapp%2F-M3Cr-mS8ZJTaONLBwnE%2F-M3CuAsVAN-XhKI0aDNk%2FEcra%202%20Primavera.png?alt=media\&token=e7094b64-36ad-4b2b-8abd-1a7bdc937aee)

A primeira opção solicita o preenchimento da versão do Primavera instalada (com as quais o Syslog é compatível) e depois a sua variante: Professional ou Empresarial. Depois solicita a indicação da pasta de instalação do ERP. Por defeito o sistema indica a pasta padrão, que pode ser alterada caso tenha sido realizada noutro local.

Os campos a seguir solicitam:

* _Instância_ - Por defeito é DEFAULT
* _Código da Empresa_ - Nome da base de dados no SQL
* _BD de Empresas - Nome da base de dados (PRIEMPRE, por exemplo)._
* _Utilizador_ - Nome do utilizador para acesso à base de dados
* _Password_ - Password do utilizador

A seguir clicar em _seguinte._
{% endtab %}

{% tab title="Sage 50c" %}
Para o SAGE 50c os dados requeridos são:

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2-1-2UlUfW3YiJoapp%2Fuploads%2FKCwQMwXKtl7v4rCiY7I6%2Ffile.jpeg?alt=media)

A primeira opção solicita a escolha da versão do SAGE instalada (com as quais o Syslog é compatível). Depois solicita a indicação da pasta de instalação do ERP. Por defeito o sistema indica a pasta padrão, que pode ser alterada caso tenha sido realizada noutro local.

O campo a seguir solicita:

* _Código da Empresa_ - Nome da base de dados para usar nos motores de integração

A seguir clicar em _seguinte._
{% endtab %}

{% tab title="Sage 100c" %}
![](https://1264781937-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M2-1-2UlUfW3YiJoapp%2F-M3g1hhB4lll2Vrw-z4a%2F-M3g52rq4pwhYbxk0knj%2FSage%20100C.png?alt=media\&token=b0fd7b41-2526-42b5-913e-4b4dddfd0339)



A primeira opção solicita a escolha da versão do SAGE instalada (com as quais o Syslog é compatível). Depois solicita a indicação da pasta de instalação do ERP. Por defeito o sistema indica a pasta padrão, que pode ser alterada caso tenha sido realizada noutro local.

O campo a seguir solicita:

* _Código da Empresa_ - Nome da base de dados para usar nos motores de integração
* _Utilizador_ - Utilizador de acesso
* _Password_ - Indicação da password do utilizador

A seguir clicar em _seguinte._
{% endtab %}

{% tab title="Sendys" %}
Novidades brevemente.
{% endtab %}

{% tab title="Personalizado" %}
Para outros ERP (por exemplo All@work) os dados requeridos são os seguintes:

![](https://1264781937-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M2-1-2UlUfW3YiJoapp%2F-M3CdcBFmpKX_cwuK08-%2F-M3CfGYLRA8VrKA972AY%2FEcra%202.png?alt=media\&token=702a3568-e7d1-4514-9d0d-574ede78277b)
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Todos os campos são de preenchimento obrigatório
{% endhint %}

### Passo 3

O terceiro passo incide na instalação e configuração inicial do [MISCommunicator](miscommunicator). Desta forma:

![](https://1264781937-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M2-1-2UlUfW3YiJoapp%2F-M3Cq9FdEVizdJblOBoC%2F-M3CqGunwMQ4NEPzmZmH%2FEcra%203%20-%20MIS.png?alt=media\&token=0539fa01-1115-4c17-add7-c933c06103c2)



* _Pasta de instalação_ - Indicação do caminho para a pasta de instalação do MISCommunicator
* _IP_ - Indicação do endereço IP da máquina onde funcionará o MISCommunicator
* _Porta_ - Por defeito o Syslog usa a porta 9001. Aconselha-se o uso desta porta de comunicação.
* _Password_ - Indicação da password para a ligação ao MISCommunicator. Campo de preenchimento opcional.

Em baixo o sistema solicita a informação se a comunicação mediada pelo MISCommunicator é encriptada ou não. Esta opção é de livre escolha.

A seguir clicar em _Instalar_.

{% hint style="warning" %}
Todos os campos são de preenchimento obrigatório
{% endhint %}

### Passo 4

Considerando o decorrer do processo de instalação anterior conforme as indicações dadas, o sistema apresenta uma mensagem a informar que o processo está concluído com sucesso e questiona apenas se pretende abrir o BackOffice.

![](https://1264781937-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M2-1-2UlUfW3YiJoapp%2F-M3Cr-mS8ZJTaONLBwnE%2F-M3CtjI2rKjqIRJ-TVLf%2FEcra%204.png?alt=media\&token=5966cb65-1a83-4e58-bcd2-b8c8c655589a)

## Cenário 2 - Atualização da V3 para a V3

No segundo cenário descreve-se o processo para uma atualização de uma instalação Syslog V3 já existente. O procedimento para a atualização incide na execução do Setup e depois bastará clicar em seguinte nos ecrãs onde surjam questões. Neste processo de atualização não são permitidas alterações de parâmetros. Apenas se atualiza o Syslog.&#x20;

Numa atualização do Syslog V3 é realizada uma atualização da base de dados, de _views_, _scripts_, do BackOffice e do Driver. Se for necessário alterar configurações, como por exemplo a porta do MISCommunicator, terá de ser realizada manualmente no Syslog (após a atualização).

Essencialmente, este é um cenário simples de execução.

{% hint style="info" %}
Na execução do Setup, caso o MISCommunicator esteja em funcionamento, a aplicação de instalação pára o MIS no final e inicia-o.
{% endhint %}

{% hint style="success" %}
Para este cenário, apesar de não ser obrigatório, aconselha-se à realização de uma cópia de segurança da informação antes da atualização (da base de dados e da versão a atualizar). Só após a verificação do bom funcionamento da atualização é que se poderá descartar essas cópias de segurança.
{% endhint %}

## Cenário 3 - Atualização da V2 para a V3

No terceiro cenário descreve-se o processo para uma atualização de uma instalação Syslog V2 existente.

Nativamente, o Setup não suporta essa operação diretamente, haverá que cumprir um conjunto de procedimentos prévios à atualização da versão. Contudo, convém lembrar que os dados estão todos na base de dados.&#x20;

Desta forma, os passos necessários para migrar da versão V2 para a V3 são, de forma cumulativa, os seguintes:&#x20;

1. Atualizar a versão V2 para a última versão disponível do Syslog V2. Ou seja, a base de dados deve estar disponível na versão 47.
2. Parar o serviço MISCommunicator e, em seguida, desinstalar o serviço. Posteriormente parar o BackOffice, caso esteja em execução, e mudar o nome da pasta, para ficar com um backup das configurações. Por exemplo se está em “C:\MIS...” renomear para “C:\MIS\_OLD...” .
3. Fazer backup da base de dados (situação opcional, mas aconselhada).
4. Executar o Setup como se fosse uma instalação nova ([Cenário 1](#cenario-1)). Neste caso, o Setup deteta que já existe uma base de dados Syslog e procede à atualização para a V3, instalando todos os componentes do Syslog V3. Se for necessário confirmar algum parâmetro pode-se aceder aos ficheiros INI que ficaram na pasta “C:\MIS\_OLD\…” e verificar como é que estavam na V2.&#x20;
5. Depois de se confirmar que está tudo bem, pode-se apagar a pasta “C:\MIS\_OLD\…”.
