Instalar um MID Server no Linux

Versão de lançamento: Zurich

Atualizado 31 de jul. de 2025

10 min. de leitura

Instale MID Servers com o instalador do MID Server e verifique se ele está ativo. O pacote inclui um instalador que configura automaticamente o JRE para ser executado no ambiente. O MID Server pode usar um JRE existente em vez do JRE fornecido. Desinstale o MID Server para redistribuí-lo.

Antes de Iniciar

Verifique se o computador host atende a Requisitos do sistema do MID Server.

Função necessária: administrador, mid_server

Por Que e Quando Desempenhar Esta Tarefa

Para instalar o Linux no MID Server, os sistemas RedHat/CentOS exigem RPM, enquanto os sistemas Debian (Ubuntu) exigem DEB. O local de instalação padrão é /opt/servicenow/mid. Não há suporte para a instalação de DEB em diretórios definidos pelo usuário.

Para melhorar a segurança, este procedimento instala e executa o serviço MID Server como um usuário não raiz. O privilégio de raiz é necessário para implantar e configurar um MID Server em um servidor Linux. Um usuário não raiz pode gerenciar um serviço somente se tiver as permissões necessárias. Para obter mais detalhes, consulte Problemas do PolicyKit com MID Servers do Linux que usam contas de não administrador [KB0815542].

Nota:

ServiceNow não é mais compatível com novas instalações de MID Servers de 32 bits ou upgrades para a versão Rome. A instalação do novo MID Server está bloqueada e pelo instalador MSI e RPM nos seguintes sistemas operacionais:

CentOS 7
Servidor Windows 2008
Servidor Windows 2008 R2
Windows 8
Windows 10

Os MID Servers podem ser instalados manualmente em qualquer sistema operacional com o arquivo ZIP. No entanto, o Windows 10 não é compatível. A atualização automática de MID Servers não compatíveis com Rome cria um registro de problema em Problemas do MID Server (ecc_agent_issue). Para obter mais informações, consulte Mudanças de plataforma compatíveis com MID Server [KB0863694].

Java 17.0.12 é empacotado com MID Server pacote do instalador e é instalado no host para todos os novos MID Servers. O instalador configura automaticamente o Java 17.0.12 para ser executado em seu ambiente. Nenhuma configuração adicional é necessária. Esta versão oferece suporte para Windows MID Servers 64 bits e Linux MID Servers 64 bits. . MID Server Requer uma versão mínima do JRE 17,0.10 e a versão recomendada 17,0.12. Se você estiver usando uma versão anterior à 17,0.10, poderá ver problemas relacionados à criptografia.

Nota:

Os MID Servers do Linux exigem a versão 2.17 da glibC. A biblioteca deve ser atualizada para o JRE 11. Em sistemas Linux de 64 bits, você deve instalar a biblioteca GNU C de 32 bits (glibc). O comando de instalação do CentOS é: yum install glibc.i686

Os testes mostraram que MID Serverfunciona conforme esperado com OracleJava 11 versão 17,0.10. Se for necessário fazer upgrade do JRE para uma versão diferente, entre em contato com o representante de conta apropriado para obter suporte.

Procedimento

Na instância, navegue até MID Server > Downloads E baixe o arquivo RPM do instalador DO MID Server para RedHat/CentOS ou o arquivo DEB para sistemas Debian (Ubuntu).
Nota:
Use o botão Copiar link para copiar o link de download e use o seguinte comando wget para baixar diretamente os instaladores em máquinas Linux.
```
wget <copied link of the installer>
```
Opcional: Verifique manualmente a autenticidade e a integridade do arquivo baixado.
1. Baixe os arquivos ZIP de assinatura para RPM/DEB.
2. Execute os seguintes comandos para RPM ou DEB.
  RPM
  - Extraia a chave pública ServiceNow_Digicert_DGST.peme o arquivo de assinatura do arquivo zip de assinatura baixado.
  - Execute o comando a seguir para verificar a assinatura do arquivo RPM.
```
openssl dgst -sha256 -verify <Extracted .pem file> -signature <Extracted bin file path> <RPM file path> 
```
  DEB
  - Extraia a chave pública, ServiceNow_Digicert_Public.gpg, dos arquivos zip de assinatura baixados.
  - Importe a chave pública e verifique a assinatura do arquivo DEB com os comandos a seguir.
```
gpg --import <public key> 
dpkg-sig --verify <DEB file path>
```
Use os seguintes comandos para instalar o RPM ou o instalador DEB:
RPM
- Instale o pacote RPM para sistemas RedHat com o seguinte comando:
```
sudo rpm -ivh --nodeps package_name.rpm.
```
- Instale o pacote RPM para sistemas RedHat em um local definido pelo usuário com o seguinte comando:
```
sudo rpm -ivh --nodeps package_name.rmp --prefix=/path/to/user/directory.
```
DEB
Instale o pacote DEB para sistemas Debian com o seguinte comando:
```
sudo dpkg -i package_name.deb.
```
Para configurar o serviço do MID Server, execute o comando a seguir na pasta agente como um usuário com privilégio de raiz e forneça as entradas necessárias.
```
./installer.sh
```
O script installer.sh usa as seguintes entradas.

URL da instância

Insira o URL completo da sua instância, por exemplo: https://mycompanyinstace.service-now.com

Nome de usuário do MID Server

Insira o nome de usuário do MID Server que você já criou. O usuário do MID Server deve ter a função mid_server.

Senha do MID Server

Defina a senha para o usuário atual do MID Server.

Nome do MID Server

Configure o nome do MID Server.

Informações do Servidor Proxy (opcional).

mid.proxy.use_proxy

Permite que o MID Server use um proxy da Web para acessar a instância da ServiceNow.

mid.proxy.host

Defina este parâmetro para definir o host do proxy da Web.

mid.proxy.port

Defina este parâmetro para definir a porta do proxy da Web.

mid.proxy.username

Se o proxy da Web exigir um nome de usuário, defina este parâmetro para definir esse nome de usuário.

mid.proxy.password

Se o proxy da web exigir uma senha, defina este parâmetro para definir essa senha.

O MID Server pode ignorar servidores proxy cujo endereço DNS/IP esteja listado no parâmetro de configuração mid.cloud.discovery.proxy.exclusion.list. Consulte Propriedade do MID Server para obter mais informações.

Para executar um MID Server como um serviço daemon, as propriedades a seguir também são necessárias.

app_name

Defina um nome exclusivo para o MID Server atual.

app_long_name

Defina um nome longo exclusivo para o MID Server.

run_as_user

Defina o nome de usuário para executar o serviço como um usuário não raiz.

Resultado

Depois que todas as entradas forem inseridas, o MID Server será executado automaticamente como um serviço daemon e iniciará o serviço.

Instalação silenciosa do MID Server Linux

A instalação silenciosa do MID Server usa parâmetros predefinidos e não requer entrada do usuário depois de iniciada. Você pode usar a instalação silenciosa em várias máquinas ao mesmo tempo para configurar rapidamente uma rede e para garantir que todos os MID Servers tenham as mesmas configurações de instalação.

Para executar uma instalação silenciosa com o instalador do Linux, execute o seguinte comando:

./installer.sh -silent -INSTANCE_URL https://instance_name.service-now.com -MUTUAL_AUTH N -MID_USERNAME username -MID_PASSWORD password -USE_PROXY N -MID_NAME mid -APP_NAME mid -APP_LONG_NAME ServiceNow_MID_Server_Mid -NON_ROOT_USER nonrootuser

Os seguintes campos podem ser passados por meio da linha de comando:

INSTANCE_URL: Insira o URL completo da sua instância, por exemplo: https://mycompanyinstance.service-now.com
MUTUAL_AUTH: Defina este valor como Y para usar a autenticação mútua em vez da autenticação básica. Caso contrário, defina-o como N.

Nota:
Se MUTUAL_AUTH = Y, forneça o caminho para o certificado com CERTIFICATE_PATH.
CERTIFICATE_PATH: Se a autenticação mútua estiver habilitada, forneça o caminho para o certificado.
MID_USERNAME: Insira o nome de usuário do MID Server que você já criou. O usuário do MID Server deve ter a função mid_server.
MID_PASSWORD: Insira a senha do usuário.
USE_PROXY: Defina este valor como Y se o seu MID Server se comunicar por meio de um proxy para se conectar à instância.

Nota:
Se USE_PROXY = N, ignore os outros detalhes de proxy.
PROXY_HOST: Insira o nome do host do servidor proxy ou o endereço IP. Não inclua o protocolo no nome do host. Por exemplo: proxyserver.domain.com está correto, mas https://proxyserver.domain.com está incorreto.
PROXY_PORT: Insira a porta que o servidor proxy usa para se comunicar. Se este valor estiver em branco, o instalador usará o número da porta padrão do servidor proxy.
PROXY_USERNAME: Insira o nome de usuário que tem direitos de administrador para o servidor proxy.
PROXY_PASSWORD: Insira a senha para o nome de usuário.
MID_NAME: Insira o nome do MID Server.
APP_NAME: Forneça o nome do serviço. Deve ser exclusivo para o MID Server atual.
APP_LONG_NAME: Forneça o nome longo do serviço.
NON_ROOT_USER: Forneça o nome de usuário para executar o serviço como um usuário não raiz.

A seguir está um exemplo de comando para um MID Server que usa um proxy e autenticação mútua:

./installer.sh -silent -INSTANCE_URL https://instance_name.service-now.com MUTUAL_AUTH Y –CERTIFICATE_PATH <path-to-certificate> -USE_PROXY Y -PROXY_HOST <ip> -PROXY_PORT <port> -PROXY_USERNAME <username> -PROXY_PASSWORD <password> -MID_NAME proxymid -APP_NAME proxymid -APP_LONG_NAME servicenow_proxy_mid -NON_ROOT_USER nonrootuser

Nota:

Para reconfigurar o MID Server, execute o comando installer.sh novamente. Reconfigurar o MID Server exclui a configuração antiga. A linha de comando do Linux após usar o comando de instalação silenciosa.

A linha de comando do Linux após usar o comando de instalação silenciosa.

Executar MID Servers Linux como usuários não raiz

Execute MID Servers como usuário não raiz em uma máquina Linux para melhorar a segurança. Vários MID Servers podem ser instalados como serviços para que eles possam iniciar sozinhos após a reinicialização do sistema.

Antes de Iniciar

Função necessária: root

Este processo só é aplicável se você instalou o MID Server manualmente usando o arquivo ZIP. Se você instalou o MID Server com o procedimento em Instalar um MID Server no Linux, o MID Server já está sendo executado como um usuário não raiz.

As versões compatíveis com este procedimento são Linux Red Hat 6 ou mais recente, Ubuntu 1404 ou mais recente e CentOS 6 ou mais recente.

Procedimento

Interrompa qualquer MID Server em execução no host com o comando bin/mid.sh stop.
Remova quaisquer servidores MID no host com o comando bin/mid.sh remove.
Edite o arquivo mid.shconf_override.
Adicione o nome do MID Server usando as linhas APP_NAME = e APP_LONG_NAME = para executá-lo como um serviço.
Para evitar erros, o APP_NAME de cada MID Server deve ser exclusivo.
Opcional: Para executar vários MID Servers como serviços no mesmo host, adicione um APP_NAME e um APP_LONG_NAME para cada instância.
Adicione o nome do usuário não raiz para operar a conta usando a linha RUN_AS_USER =.
Opcional: Adicione o nome do grupo ao qual será o proprietário de todo o diretório do agente, usando a linha GROUP_NAME =.
Defina a linha PROMPT_BEFORE_OWNERSHIP_CHANGE = como verdadeiro para solicitar a confirmação do usuário antes que quaisquer mudanças nas permissões de arquivo sejam aplicadas.
A mudança de permissão do arquivo é aplicada a toda a pasta do agente e tudo dentro de forma recursiva. As mudanças incluem o bloqueio do acesso de outros usuários à pasta inteira do agente, a mudança do proprietário para $RUN_AS_USER se especificado e a mudança do grupo para $GROUP_NAME se especificado.
Reinstale o MID Server com o comando bin/mid.sh install.

Nota:
Para evitar erros, certifique-se de parar e remover todos os serviços do MID Server existentes antes de iniciar novos. Durante a primeira instalação, um usuário raiz é necessário para chamar bin/mid.sh install. A reinstalação do MID Server aplica as mudanças em mid.shconf_override. Em seguida, o usuário não raiz especificado em mid.shconf_override é capaz de iniciar/parar/reiniciar o serviço sem privilégios elevados.

O que Fazer Depois

Para obter mais informações sobre como gerenciar a lista de permissões e a imposição de permissões de arquivo, consulte Imposição de permissão de arquivo para MID Servers do Windows. Executar um MID Server Linux com uma conta não raiz pode resultar em problemas com o PolicyKit em alguns sistemas. Consulte Problemas do PolicyKit com Linux MID Servers que usam contas não raiz para obter mais informações.

Configurar um MID Server Linux para usar um JRE existente

É possível optar por usar um JRE existente para o MID Server em vez do OpenJDK fornecido com o instalador do MID Server.

Antes de Iniciar

Certifique-se de que sua versão do JRE seja compatível. Consulte Requisitos do sistema do MID Server para obter detalhes.

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Ao optar por usar seu próprio JRE, você se torna responsável por atualizá-lo conforme necessário. Para obter um procedimento detalhado e avisos sobre como mudar o JRE, consulte KB0778272.

Procedimento

Navegue até este arquivo no diretório de instalação do MID Server:
agent/conf/wrapper-override.conf
Para especificar o executável Java existente que deseja usar, adicione esta linha ao arquivo:
wrapper.java.command={your_java_executable}
Para obter mais informações, consulte a documentação de propriedade wrapper do serviço Java.
Salve o arquivo.

Desinstalar um MID Server Linux

O MID Server funciona como um serviço autônomo. É possível remover um serviço de MID Server autônomo para acomodar tarefas como a reimplantação do MID Server em outra máquina host ou a mudança do nome exclusivo de um MID Server ao implantar vários MID Servers.

Antes de Iniciar

Função necessária: administrador

Procedimento

Execute o script uninstall.sh na pasta do agente para remover o serviço e desinstalar o RPM/DEB.

A linha de comando do Linux após a execução do script uninstall.sh.

Resultado

O serviço do MID Server está desinstalado.

O que Fazer Depois

Valide o MID Server para prepará-lo para uso.