Instalar o servidor de conectividade local

Este artigo contém os seguintes tópicos:

Como administrador de inquilinos, instale os serviços de PoP (Point of Presence - Ponto de Presença) em máquinas locais para ativar o seu produto de SaaS para se comunicar com eles.

Use esse cenário como orientação durante o processo:

Como instalar os Serviços de PoP

Certifique-se de que os requisitos mínimos sejam atendidos.
Atenda os pré-requisitos opcionais do Active Directory
Obtenha as informações de conexão necessárias para o inquilino do produto de SaaS.
Opte entre as instruções de instalação Windows ou Linux.
Execute o programa de instalação.
(Opcional) Atualizar Propriedades de PoP após a instalação.

Requisitos mínimos

Instale o Point of Presence em um servidor da rede que possa se comunicar com destinos de fluxo de trabalho locais, tais como hosts do VMware. Se necessário, você pode executar várias instalações PoP em servidores separados para acessar todos os recursos necessários ou para manipular um grande volume de fluxos de trabalho.

O programa de instalação do PoP possui dois tipos: Windows de 64 bits e Linux de 64 bits. A versão do Windows foi testada no Windows Server 2008 R2 e Windows 7, com 4 GB de memória. A versão do Linux foi testada no Red Hat/CentOS 5.8 e 6.4 e Ubuntu 12.4, com 2 GB de memória. Os componentes necessários do ambiente Java estão incluídos na instalação.

Pré-requisitos para o Active Directory

Como administrador de inquilinos, você deve ativar o ServiceAide Cloud Service Management para se comunicar com o Microsoft Active Directory usando serviços PoP. Para ativar essa comunicação por LDAP, os seguintes pré-requisitos devem ser atendidos:

O Active Directory deve ser configurado para o suporte ao SSL.

Os serviços de certificado do Active Directory devem ser ativados no servidor LDAP.

Um certificado de SSL do Active Directory deve existir no servidor LDAP.

Um arquivo de keystore deve ser criado ao exportar o certificado do servidor do Active Directory para uso em um cliente Java. O arquivo de armazenamento de chaves é utilizado durante a instalação.

Informações necessárias

As seguintes informações são necessárias para instalar os serviços PoP:

Nome do host ou endereço IP do agente de DMZ de plataforma
Nome do inquilino
Nome de usuário
Senha

Alguns destes valores podem ser pré-preenchidos na instalação. Se necessário, verifique seu email de boas-vindas do produto para obter essas informações.

Instalar o Point of Presence para o Windows

Para configurar um recipiente de PoP em suas instalações, instale o software PoP em qualquer sistema com o qual o aplicativo SaaS se comunicará.

Siga estas etapas:

Faça download do programa de instalação do Windows do aplicativo do ServiceAide Cloud Service Management. Para fazer download do instalador, vá para GERENCIAR, ADMINISTRAÇÃO, Ferramentas, Downloads.
Selecione Servidor do POP (Point of Presence – Ponto de Presença) da ServiceAide – Windows.
Descompacte o programa de instalação para exibir o arquivo installer.properties. O arquivo contém o servidor DMZ, o inquilino e detalhes do produto. Também é possível exibir as configurações padrão, como Tenant_Username, Tenant_Name, DMZ_Server_Name e Master_Installer_product_name. É possível atualizar as configurações padrão se o seu público-alvo mudar.
Execute o programa de instalação.
Se já instalou os serviços PoP neste sistema, é exibida a tela Gerenciar instâncias.
- Selecione Modificar uma instância existente para atualizar ou desinstalar o PoP e começar tudo novamente na etapa seguinte.
- Selecione Nova instância para instalar uma instância de PoP adicional no mesmo servidor com uma instância de PoP existente.
  Continuar para a próxima etapa.
Se essa instalação for original, aceite o contrato de licença e selecione uma pasta de instalação (sem espaços).
Configuração avançada:
Se precisar personalizar a configuração de Karaf, Java, LDAP ou de geração de logs, selecione a caixa Exibir painéis de configuração avançada. Caso contrário, clique em Avançar para iniciar a instalação e ignore as descrições de painel avançado imediatamente em seguida.
- Configuração Karaf
  Use as informações padrão em cada campo, a menos que você deseje alterá-las. Por exemplo, se uma porta especificada estiver em uso, seria necessário alterá-la.
  - Porta de conexão do registro de RMI
    Padrão: 1099
  - Porta de conexão do servidor de RMI
    Padrão: 44444
  - Porta SSH
    Padrão: 8101
  - Porta Jetty
    Padrão: 8181
  - Porta confidencial
    Padrão: 8443
- As configurações de memória do Java baseiam-se no uso típico. Ajuste as configurações com base em seu uso previsto.
  - Tamanho mínimo de heap (MB)
  - Padrão: 512
  - Tamanho máximo de heap (MB)
    Padrão: 1024
  - Tamanho de mínimo de permgen (MB)
    Padrão: 48
  - Tamanho de permgen máximo (MB)
    Padrão: 128
    PermGen é a geração permanente de objetos na Java VM (nomes de classe, sequências de caracteres interiorizadas, objetos que nunca serão coletados pelo lixo).
- Serviço de log
  - Categoria de log
    Você pode adicionar pacotes Java, tais como com.seuproduto.
  - Nível mínimo de log
    Selecione a quantidade de informações de serviço PoP para registrar em log.
    - DEPURAR
      Quantidade máxima de logs, incluindo todos os tipos de mensagens abaixo.
    - INFORMAÇÕES
      Padrão: Registra todas as mensagens informativas, de aviso e de erro.
    - AVISO
      Registra todos os avisos e mensagens de erro.
    - ERRO
      Registra todas as mensagens de erro.
    - FATAL
      Registra somente as mensagens de erro fatal.
  - Persistir log
    Ativar esse sinalizador fará com que as mensagens de log enviadas por meio do ActiveMQ sejam persistidas no ActiveMQ. Isso causará uma entrega garantida de mensagens de log se o ActiveMQ estiver desativado. No entanto, o desempenho diminuirá.
- Serviço de LDAP
  Se for necessário ativar a comunicação com o Active Directory usando serviços PoP no local, insira o nome e o local do arquivo de armazenamento de chaves mencionado nos Pré-requisitos do Active Directory.
Verifique o Resumo de pré-instalação e clique em Instalar.
Os Serviços de Point of Presence da ServiceAide iniciam a instalação e em seguida exibem a tela Propriedades de inquilino de PoP.
Configuração do agente de PoP
Nome do host ou endereço IP
Especifique pelo menos um e até três nomes de host de agente de DMZ ou Endereços de IP para se comunicar com a infraestrutura de SaaS do seu aplicativo. Eles podem ser pré-preenchidos para sua instalação.
Proxy de rede
Insira esses valores se o acesso à internet solicitar configurações de proxy, como muitos sites corporativos requerem.
- Host
- Porta
- Usuário
- Senha
Digite suas propriedades específicas do inquilino PoP nesses campos. Localize essas propriedades no email de boas-vindas do seu aplicativo de SaaS. As propriedades de inquilino podem ser pré-preenchidas para sua instalação, com exceção da Senha.
- Nome do inquilino: preenchido a partir do arquivo installer.properties.
- Nome de usuário: preenchido a partir do arquivo installer.properties.
- Senha: digite a senha.
Iniciar o service ServiceAide Cloud Service Management agora?
Digite Sim ou Não para concluir a instalação e, opcionalmente, iniciar o serviço PoP
Observação: é possível verificar se o serviço POP é iniciado efetuando logon no aplicativo. O status dos conectores do local é exibido como Em execução na guia Conectores. Se o serviço POP não for iniciado, você pode revisar o status da instalação POP no log karaf (local do programa de instalação\data\log)
(Opcional para o Active Directory) Copie o arquivo de armazenamento de chaves mencionado em Pré-requisitos do Active Directory para o computador PoP no local em um diretório chamado C:\ServiceAide\PointOfPresence\keystore, renomeando-o como keystore.jks.

Observação: se desejar usar um nome de arquivo diferente ou local, altere o valor na seção Serviço de LDAP, na Configuração avançada detalhada acima.

O serviço de Ponto de Presença agora está instalado no local e pronto para se comunicar com o aplicativo de SaaS.

Instalar o Point of Presence para Linux

Para configurar um recipiente PoP em suas instalações, instale o software PoP em qualquer sistema com o qual o aplicativo SaaS precisa se comunicar.

Siga estas etapas:

Faça download do programa de instalação do Linux do aplicativo do ServiceAide Cloud Service Management. No menu superior, selecione Gerenciar, Administração, Ferramentas, Downloads, servidor Point of Presence da ServiceAide- Linux. O programa de instalação do Linux usa o modo de console (interface de linha de comando).
Descompacte o programa de instalação para exibir o arquivo installer.properties. O arquivo contém o servidor DMG, inquilino e detalhes do produto. Também é possível exibir as configurações padrão como Tenant_Username, Tenant_Name, DMZ_Server_Name e Master_Installer_product_name. É possível atualizar as configurações padrão se o seu público-alvo mudar.
Execute o programa de instalação.
Se já instalou os serviços PoP neste sistema, é exibida a tela Gerenciar instâncias.
- Selecione a instância para desinstalar o PoP e começar tudo novamente na etapa a seguir, ou selecione Atualizar.
  Observação: uma desinstalação pode não conseguir remover tudo.
  Continuar para a próxima etapa.
Se essa instalação for original, leia e aceite o contrato de licença, selecione uma pasta de instalação (sem espaços) e prossiga para a próxima etapa.
Configuração avançada
Se você precisar personalizar a configuração de Karaf, Java ou da geração de logs, digite "2" para exibir a caixa de painéis de configuração avançada. Caso contrário, clique em Enter para iniciar a instalação e ignore as descrições de painel avançado imediatamente em seguida.
- Configuração Karaf
  Use as informações padrão em cada campo, a menos que você saiba que é necessário alterá-las. Por exemplo, se uma porta especificada estiver em uso, seria necessário alterá-la.
  - Porta de conexão do registro de RMI
    Padrão: 1099
  - Porta de conexão do servidor de RMI
    Padrão: 44444
  - Porta SSH
    Padrão: 8101
  - Porta Jetty
    Padrão: 8181
  - Porta confidencial
    Padrão: 8443
- As configurações de memória do Java baseiam-se no uso típico. Você pode ajustar com base no seu uso previsto.
  - Tamanho mínimo de heap (MB)
    Padrão: 512
  - Tamanho máximo de heap (MB)
    Padrão: 1024
  - Tamanho de mínimo de permgen (MB)
    Padrão: 48
  - Tamanho de permgen máximo (MB)
    Padrão: 128
    PermGen é a geração permanente de objetos na Java VM (nomes de classe, sequências de caracteres interiorizadas, objetos que nunca serão coletados pelo lixo).
- Configuração do anexador de log
  - Categoria de log
    É possível adicionar pacotes Java, tais como com.yourproduct.
  - Nível mínimo de log
    Selecione a quantidade de informações de serviço PoP para registrar em log.
    - DEPURAR
      Quantidade máxima de logs, incluindo todos os tipos de mensagens abaixo.
    - INFORMAÇÕES
      Padrão: Registra todas as mensagens informativas, de aviso e de erro.
    - AVISO
      Registra todos os avisos e mensagens de erro.
    - ERRO
      Registra todas as mensagens de erro.
    - FATAL
      Registra somente as mensagens de erro fatal.
  - Persistir log
    Ativar esse sinalizador fará com que as mensagens de log enviadas por meio do ActiveMQ sejam persistidas no ActiveMQ. Ativar esses sinalizador também causará uma entrega garantida de mensagens de log se o ActiveMQ estiver desativado. No entanto, o desempenho diminuirá.
- Propriedades de configuração de LDAP
  Se for necessário ativar a comunicação com o Active Directory usando serviços PoP no local, insira o nome e o local do arquivo de armazenamento de chaves mencionado nos Pré-requisitos do Active Directory.
Verifique o resumo de pré-instalação e pressione Enter.
O programa de instalação exibe Instalando e em seguida exibe a tela Agente 1 de DMZ.
Inserir informações de agente de DMZ nos seguintes campos:
Nome do host ou endereço IP
Especifique pelo menos um e até três nomes de host de agente de DMZ ou Endereços de IP para se comunicar com a infraestrutura de SaaS do seu aplicativo.
Host de proxy
Insira esses valores se o acesso à internet solicitar configurações de proxy, como muitos sites corporativos requerem.
- Host
- Porta
- Usuário
- Senha
Digite suas propriedades específicas do inquilino PoP nesses campos. Localize essas propriedades no email de boas-vindas do seu aplicativo de SaaS.
- Nome do inquilino: preenchido a partir do arquivo installer.properties.
- Nome de usuário: preenchido a partir do arquivo installer.properties.
- Senha: digite a senha.
O serviço PoP instalado tenta estabelecer conexão com a infraestrutura de SaaS, usando os valores inseridos. Se não for bem-sucedido, o programa de instalação retorna à configuração de Agente de DMZ e à do Inquilino para permitir que você altere a configuração. Depois de bem sucedido, continue para a próxima etapa.
Iniciar o service ServiceAide Cloud Service Management agora?
Digite Sim (1) ou Não (2) para concluir a instalação e, opcionalmente, iniciar o serviço PoP.
Observação: é possível verificar se o serviço POP é iniciado efetuando logon no aplicativo. O status dos conectores do local é exibido como Em execução na guia Conectores. Se o serviço POP não for iniciado, você pode exibir o status da instalação POP no log karaf (local do programa de instalação\data\log)
(Opcional para o Active Directory) Copie o arquivo de armazenamento de chaves mencionado em Pré-requisitos do Active Directory para o computador PoP no local em um diretório chamado /opt/ca/pointofpresence/keystore, renomeando-o como keystore.jks.

Observação: se desejar usar um nome de arquivo diferente ou local, altere o valor nas propriedades de configuração do LDAP na Configuração avançada detalhada acima.

O serviço de Ponto de Presença agora está instalado no local e pronto para se comunicar com o aplicativo de SaaS.

Configurar o PoP após a instalação

Como administrador, você precisa ser capaz de atualizar a configuração do PoP. O utilitário de configuração do PoP permite atualizar determinadas configurações de PoP importantes sem reinstalar os serviços de PoP. Há duas versões, a interface de linha de comando (CLI) e a interface de usuário da web (UI). A CLI é um pouco diferente entre o Windows e Linux e a versão da interface do usuário está disponível remotamente, usando um navegador como o Internet Explorer 11 ou o Google Chrome.

Atualizar a configuração do PoP com a Interface de linha de comando

O utilitário PopUtil (PoP Configuration – Configuração PoP) permite atualizar algumas definições principais para o serviço PoP sem reinstalar. O utilitário é instalado na pasta bin sob o diretório de instalação de serviços de PoP. Se aceitar os padrões (que são C:\ServiceAide\PointOfPresence\bin\poputil.bat no Windows e /opt/ca/pointofpresence/bin/poputil.sh no Linux), você poderá usar o PopUtil para alterar as configurações a seguir:

CLI do Windows

Para executar o PopUtil no Windows, abra um prompt de comando.

Observação: se você digitar poputil sem argumentos, o "help" é exibido.

Propriedades do servidor proxy

Insira esses valores se o acesso à internet solicitar configurações de proxy, como muitos sites corporativos requerem. O nome do host e a porta são obrigatórios. O usuário e a senha são opcionais.

Uso: poputil -t PROXY -h <nome do host> -p <porta> -u <usuário> -w <senha>

Exemplo: poputil -t PROXY -h gateway.zscaler.net -p 80

Arquivo de Keystore de LDAP

Adicione ou edite um local de arquivo de keystore para ativar o LDAP sobre SSL, se necessário.

Uso: poputil -t LDAP -f <nome do arquivo de keystore>

Exemplo: poputil -t LDAP -f C:\ServiceAide\PointOfPresence\keystore\keystore.jks

Endereço do agente de DMZ

Adicione ou edite os nomes de host ou endereço IP do agente de DMZ para se comunicar com a infraestrutura SaaS do seu aplicativo. Se estiver usando mais de um, separe a lista com vírgulas (e sem espaços).

Observação: se adicionar ou editar agentes já existentes, você deve incluir todos eles. As novas configurações substituem completamente as configurações antigas.

Uso: poputil -t DMZ -a <host/IP dos agentes de DMZ>

Exemplo: poputil -t DMZ -a 54.88.17.18,192.168.1.101

CLI do Linux

Para executar o PopUtil no Linux, use ./poputil.sh.

Observação: se você inserir ./poputil.sh sem argumentos, o "help" é exibido.

Propriedades do servidor proxy

Insira esses valores se o acesso à internet solicitar configurações de proxy, como muitos sites corporativos requerem. O nome do host e a porta são obrigatórios. O usuário e a senha são opcionais.

Uso: ./poputil.sh -t PROXY -h <nome do host> -p <porta> -u <usuário> -w <senha>

Exemplo: ./poputil.sh -t PROXY -h gateway.zscaler.net -p 80

Arquivo de Keystore de LDAP

Adicione ou edite um local de arquivo de keystore para ativar o LDAP sobre SSL, se necessário.

Uso: ./poputil.sh -t LDAP -f <nome do arquivo de keystore>

Exemplo: ./poputil.sh -t LDAP -f C:\ServiceAide\PointOfPresence\keystore\keystore.jks

Endereço do agente de DMZ

Adicione ou edite os nomes de host ou endereço IP do agente de DMZ para se comunicar com a infraestrutura SaaS do seu aplicativo. Se estiver usando mais de um, separe a lista com vírgulas (e sem espaços). Observação: se adicionar ou editar agentes já existentes, você deve incluir todos eles. As novas configurações substituem completamente as configurações antigas.

Uso: ./poputil.sh -t DMZ -a < host/IP dos agentes de DMZ>

Exemplo: ./poputil.sh -t DMZ -a 54.88.17.18,192.168.1.101

Atualizar a configuração de PoP com a interface de usuário do PoP

A interface de usuário do utilitário de configuração do PoP (PoP UI) executa as mesmas tarefas que o utilitário de linha de comando acima. Ela permite atualizar algumas definições principais para o serviço de PoP sem reinstalá-lo. A interface de usuário do PoP tem a vantagem de ser acessada por um navegador, tornando desnecessário efetuar logon no sistema PoP ou estar familiarizado com seu sistema operacional. Os hosts Windows e Linux são acessados da mesma forma:

http://<host name or IP address of PoP>:8181/PopUI (assuming you installed to the default Jetty port of 8181)

É possível atualizar as configurações a seguir usando a interface de usuário do PoP:

Configurações de proxy

Insira esses valores se o acesso à internet solicitar configurações de proxy, como muitos sites corporativos requerem.

Host
Porta
Usuário
Senha

Configurações de Keystore do LDAP

Adicione ou edite um local de arquivo de keystore para ativar o LDAP sobre SSL, se necessário. Clique em Carregar arquivo de keystore.

Configurações do agente de DMZ

Adicione ou edite os nomes de host ou endereço IP do agente de DMZ para se comunicar com a infraestrutura SaaS do seu aplicativo.