# Serviço de Failover - Versão 12010 e anteriores

A disponibilidade do aplicativo de service desk é um fator importante para o bom funcionamento do serviço de service desk. Falhas inesperadas de hardware/software podem tornar o aplicativo de service desk indisponível, o que pode causar um grande impacto nos negócios. O ServiceDesk Plus (SDP) fornece o recurso **Fail Over Service (FOS)** para garantir a disponibilidade do aplicativo de service desk mesmo durante uma falha de software/hardware.

**Tópicos abordados:**

- [Como o Fail Over Service funciona?](#como-o-fail-over-service-funciona)
- [Pré-requisitos para usar o recurso FOS](#pré-requisitos-para-usar-o-recurso-fos)
- [Processo de configuração](#processo-de-configuração)
- [Processo de upgrade](#processo-de-upgrade)
- [Processo de restauração](#processo-de-restauração)
- [Pré-requisitos para o complemento DC](#pré-requisitos-para-o-complemento-dc-se-o-plugin-dc-estiver-instalado)
- [Desativando o FOS](#desativando-o-fos)

## Como o Fail Over Service funciona?

- Haverá duas instalações do SDP em duas máquinas diferentes (M1 & M2).
- Uma instalação será a primária e a outra a secundária.
- Ambas as instalações contêm o serviço do Windows **ManageEngine ServiceDesk FOS**, usado para gerenciar e monitorar a disponibilidade do serviço **ManageEngine ServiceDesk Plus**.
- É necessário configurar um endereço IP comum por meio do qual os usuários se conectarão ao aplicativo.
- A URL do aplicativo deve ser vinculada ao endereço IP comum no DNS da rede local.
- O serviço FOS na instalação secundária monitorará a disponibilidade do serviço SDP na instalação primária.
- Quando o serviço SDP na primária ficar indisponível, o FOS iniciará automaticamente o serviço SDP na instalação secundária após adquirir o endereço IP comum.
- Como os usuários se conectam por meio do endereço IP comum, não haverá interrupção do serviço.
- Idealmente, levará cerca de 3 a 4 minutos para iniciar o FOS na máquina 2 após uma falha inesperada.

Depois que o problema no servidor primário for resolvido:

1. Desligue o servidor secundário atual (execute `<SERVICEDESK HOME>\fos\stopFOSService.bat` na máquina 2).
2. Configure o servidor corrigido como primário e execute `<SERVICEDESK HOME>\fos\startFOSService.bat` na máquina 1.
3. Aguarde o servidor primário iniciar completamente e, em seguida, inicie o servidor secundário (`StartFOSService.bat` na máquina 2).

![Pro-workflow](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/wrkflow.png)

Você também pode configurar um servidor secundário para assumir quando o servidor de banco de dados falhar (MSSQL). Para saber mais, [clique aqui](https://www.manageengine.com/br/service-desk/help/adminguide/mssql-aoag.html).

## Pré-requisitos para usar o recurso FOS

### Requisitos do servidor

- Duas máquinas servidor 64 bits com alta conectividade de rede.
- Acesso bidirecional de leitura e gravação à pasta ManageEngine.
- Suporte apenas para instalações exe de 64 bits.
- O utilitário Windows **Robocopy** deve estar presente em ambas as máquinas.
- Um endereço IP comum deve estar disponível na mesma rede.

| Observação |  |
|---|---|
| ![](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/note.jpg) | - Use duas máquinas virtuais ou físicas com endereços NIC diferentes.<br>- **Endereço IP comum:** IP virtual na rede local, não vinculado a máquina específica. Se não responder a ping, pode ser usado como IP comum. |

### Requisitos de configuração do ServiceDesk

- Apenas MSSQL é compatível.
- O banco de dados deve ser externalizado.
- O caminho dos anexos deve ser externalizado (caminho de rede).
- Certificado HTTPS válido para a URL de alias do IP comum.
- Certificados autoassinados ou CA interna não são compatíveis.
- A URL comum deve estar vinculada ao IP comum no DNS.
- Configure FileAttachment e banco de dados na máquina 3.

### Permissões de compartilhamento de pasta

Se a pasta for compartilhada de máquina externa:

- Defina permissão como **Todos** com leitura/gravação.
- Verifique acessibilidade a partir do servidor do aplicativo.
- Para restringir a uma conta específica:
  1. Conceda acesso à conta.
  2. Execute `services.msc`.
  3. Abra propriedades de **ManageEngine ServiceDesk Plus**.
  4. Guia **Log on** → selecione **This account**.
  5. Informe credenciais e salve.
  6. Inicie o serviço.

| Observação |  |
|---|---|
| ![](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/note.jpg) | O FOS deve ser adquirido como **complemento**, mesmo na edição Enterprise. |

## Processo de configuração

Todas as configurações devem ser feitas na instalação primária e replicadas usando `mirrorSetup.bat`.

![FOS Installation](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/install.png)

### Instalação

1. Instale a build na máquina 1.
2. A instalação da máquina 2 será copiada durante o espelhamento.

| Observação |  |
|---|---|
| ![](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/note.jpg) | - Entradas de registro não são copiadas.<br>- Use a máquina 2 apenas como backup. |

### Definir permissão de acesso

1. Compartilhe a pasta ManageEngine da máquina 1 com a máquina 2.
2. Crie e compartilhe pasta ManageEngine na máquina 2.
3. Teste acesso via `\\<machineIP>\ManageEngine`.

### Configurar entradas do FOS

Edite `<SERVICEDESK HOME>\fos\fosInputs.conf`.

![fos inputs](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/fos%20inputs.png)

- **nicMachine1**: endereço NIC da máquina 1.
- **nicMachine2**: endereço NIC da máquina 2.
- **commonIP**: IP virtual.
- **machineURL1**: URL máquina 1.
- **machineURL2**: URL máquina 2.

Para alias comum:

```
commonIPAlias = ServiceDeskPlus.com
```

Para HTTPS, edite `wrapper-fos.conf`:

```
#wrapper.java.additional.4=-Dverifyhost=<ip of master machine>
```

Remova `#` e substitua pelo IP da máquina primária.

### Ferramenta para identificar endereço NIC

1. Use `iflist.exe` em `<SERVICEDESK HOME>\fos\tools`.
2. Escolha NIC com status UP.
3. Execute também na máquina remota.

![nic card address](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/failover-service-1.JPG)

### Alteração da máscara de sub-rede

Edite `<SERVICEDESK HOME>\fos\conf\fos.conf`:

```
clustering.fos.publicIPNetMask=<your ip range value>
```

Externalize o banco usando:
[SERVICEDESK changeDBserver.bat](https://www.manageengine.com/br/service-desk/help/adminguide/introduction/setting_up_database.html)

### Espelhamento

Execute:

```
<SERVICEDESK HOME>\fos\mirrorSetup.bat <machine2-name/ip>
```

### Iniciar aplicativo

Execute em ambas as máquinas:

```
<SERVICEDESK HOME>\fos\startFOSService.bat
```

> O serviço SDP deve ser iniciado apenas via arquivo `.bat`.

### Configurar credenciais para replicação FOS

**(Build 10509+)**

**Para build 11136+:**

1. Renomeie/exclua `fos >> filelog`.
2. Exclua `next.pos` em `fos >> repl-slave`.

Acesse:

```
http(s)://<commonipaddress>:<port>/setup/FosInputs.jsp
```

- Insira IP, usuário (`<domainname\username>`) e senha da máquina 1.
- Clique em **Salvar**.
- Repita para máquina 2.

![FOS Credentials](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/fos(2).png)

> Atualize a senha aqui sempre que alterada.

### Notificações de falha

Técnicos serão notificados por e-mail em caso de falhas críticas.

Configure em:

**admin >> configurações do portal de autoatendimento**

Adicione e-mails separados por vírgula.

![FOS Notification](https://cdn.manageengine.com/sites/meweb/images/br/service-desk/help/fos.png)

> O servidor de e-mail deve estar configurado.

## Processo de upgrade

![FOS Upgrade](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/upgradefos.png)

1. Execute `stopFOSService.bat` na máquina 2.
2. Execute `stopFOSService.bat` na máquina 1.
3. Atualize a build na máquina 1 via PPM ([clique](https://www.manageengine.com/br/service-desk/help/adminguide/introduction/upgrade-service-pack.html)).
4. Execute `mirrorSetup.bat`.
5. Ajuste `wrapper-fos.conf` se usar HTTPS.
6. Execute `startFOSService.bat` na máquina 1.
7. Execute `startFOSService.bat` na máquina 2.

## Processo de restauração

1. Execute `stopFOSService.bat` em ambas.
2. Restaure dados na máquina 1 ([clique](https://www.manageengine.com/br/service-desk/help/adminguide/general-features/restore-process.html)).
3. Execute `mirrorSetup.bat`.
4. Ajuste HTTPS se necessário.
5. Execute `startFOSService.bat` em ambas.

| Observação |  |
|---|---|
| ![](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/note.jpg) | - Execute `mirrorSetup.bat` sempre que houver alteração na máquina 1.<br>- Faça alterações apenas na máquina 1.<br>- Atualize manualmente o conf se caminho de anexos for alterado. |

## Pré-requisitos para o complemento DC (se o plugin DC estiver instalado)

- O DesktopCentral pode ser instalado apenas em servidor Windows.
- Consulte as etapas na documentação do DC: https://www.manageengine.com/products/desktop-central/service-packs.html
- O caminho de instalação deve ser igual em ambas as máquinas.
- Configure compartilhamento de rede para:
  - DesktopCentral → Admin → Tools → Database Backup
  - Admin → Software Repository → HTTP Repository
  - Patch Mgmt → Downloaded Patches → Patch Repository Location

## Desativando o FOS

1. Execute `stopFOSService.bat` em ambas as máquinas.
2. Remova:
   - `<SERVICEDESK HOME>\fos\configSuccess.txt`
   - `<SERVICEDESK HOME>\fos\SDPFosStart.txt`

O FOS será desativado.

| Observação |  |
|---|---|
| ![](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/import-gbb3jktbxt6u//configurations/failover-service/Images/note.jpg) | O serviço SDP deve ser redefinido manualmente para **Automático**. |