Ir para o conteúdo

Instalar o Jitterbit App Builder no Microsoft Windows (x64)

Introdução

Para instalar o App Builder no Microsoft Windows, siga estas etapas:

  1. Atenda aos requisitos de software tanto para o servidor web quanto para o servidor de banco de dados.

  2. Obtenha e descompacte o software.

  3. Configure o IIS.

  4. (Opcional) Ative o Crystal Reports.

  5. Crie um arquivo de conexão.

  6. Teste e execute.

  7. (Opcional) Configuração pós-instalação.

Nota

A palavra Vinyl, usada em partes das instruções a seguir, é o antigo nome do App Builder.

Obter e descompactar o software

Para obter e descompactar o software, siga estas etapas:

  1. Entre em contato com seu Gerente de Sucesso do Cliente (CSM) para obter uma cópia do software App Builder 4.

    O software é fornecido como um arquivo compactado com o nome vinyl-X.Y.N-win.zip, onde X.Y é o número da versão (por exemplo, 4.0) e N é o número da compilação (por exemplo, 45678).

  2. Copie este arquivo para uma pasta no host onde o IIS está em execução.

  3. Dependendo das configurações de segurança do seu sistema, pode ser necessário desbloquear o arquivo. Para fazer isso, clique com o botão direito no arquivo e selecione Propriedades. Na caixa de diálogo Propriedades, selecione a guia Segurança e, em seguida, selecione Desbloquear:

    Desbloquear

  4. Clique com o botão direito no arquivo vinyl-X.Y.N-win.zip e selecione Extrair Tudo.

  5. Defina o destino da extração como uma pasta dentro da pasta raiz física padrão do IIS (por exemplo, C:\inetpub\wwwroot\Vinyl).

  6. Clique no botão Extrair.

    Cuidado

    Não continue até que a extração esteja completa. Isso pode levar muitos minutos.

Configurar o IIS

Para configurar o IIS, siga estas etapas:

  1. Adicionar um pool de aplicativos.

  2. Adicionar um aplicativo.

  3. Configurar autenticação.

  4. Definir permissões.

Adicionar um pool de aplicativos

Para adicionar um pool de aplicativos usando o Gerenciador do IIS, siga estas etapas:

  1. No painel Conexões, clique com o botão direito em Pools de Aplicativos e selecione Adicionar Pool de Aplicativos.

  2. Na caixa de diálogo Adicionar Pool de Aplicativos, defina os valores para os seguintes campos:

    • Nome: Vinyl

    • Versão do .NET CLR: Versão do .NET CLR v4.0.30319.

    • Modo de Pipeline Gerenciado: Integrado.

    • Iniciar pool de aplicativos imediatamente: Selecionado.

  3. Clique no botão OK.

Para adicionar um pool de aplicativos usando a linha de comando, insira estes comandos:

cd 'C:\Program Files\IIS'
.\appcmd.exe add apppool /name:"Vinyl" /managedPipelineMode:Integrated /autoStart:true /managedRuntimeVersion:"v8.0"

Múltiplas instâncias

Se você quiser executar várias instâncias do App Builder no mesmo servidor de aplicativos, elas devem ser isoladas em pools de aplicativos separados com a opção Carregar Perfil do Usuário habilitada.

Adicionar um aplicativo

Para adicionar um aplicativo usando o Gerenciador do IIS, siga estas etapas:

  1. No painel Conexões, expanda a pasta Sites, clique com o botão direito em Site Web Padrão e selecione Adicionar Site.

  2. Na caixa de diálogo Adicionar Site, defina os valores para os seguintes campos:

    • Nome do site: Vinyl

    • Pool de aplicativos: Vinyl

    • Caminho físico: C:\inetpub\wwwroot\Vinyl

    • Iniciar Site imediatamente: Selecionado.

  3. Clique no botão OK.

Para adicionar um aplicativo usando a linha de comando, insira estes comandos:

.\appcmd.exe add site /name:"Vinyl" /id:1 /bindings:http://*:80 /physicalPath:"C:\inetpub\wwwroot\Vinyl"
.\appcmd.exe add app /site.name:"Vinyl" /path:"/" /physicalPath:"C:\inetpub\wwwroot\Vinyl"

Configurar autenticação

Para configurar a autenticação usando o Gerenciador do IIS, siga estas etapas:

  1. No painel Conexões, sob a pasta Sites, selecione a entrada Vinyl.

  2. Clique duas vezes no ícone Autenticação na seção IIS.

  3. Selecione Autenticação Anônima e clique na ação Editar.

  4. Na caixa de diálogo Editar Credenciais de Autenticação Anônima, selecione Identidade do pool de aplicativos, em seguida, clique no botão OK.

Para configurar a autenticação usando a linha de comando, insira este comando:

appcmd.exe set config -section:anonymousAuthentication /username:"" --password

Definir permissões

Para definir permissões usando o Gerenciador do IIS, siga estas etapas:

  1. No painel Conexões, sob a pasta Sites, clique com o botão direito em Vinyl e selecione Editar Permissões.

  2. Selecione a guia Segurança, em seguida, clique no botão Editar.

  3. Na caixa de diálogo Permissões para Vinyl, clique no botão Adicionar.

  4. Na caixa de diálogo Selecionar Usuário ou Grupos, no campo Digite os nomes de objeto a serem selecionados, insira IIS AppPool\Vinyl, em seguida, clique no botão Verificar Nomes.

  5. Clique no botão OK.

  6. Na caixa de diálogo Permissões para Vinyl, sob Nomes de grupo ou usuário, selecione o novo usuário Vinyl.

  7. Sob Permissões para Vinyl, para a linha Controle total, selecione a caixa de seleção Permitir.

  8. Clique no botão OK para fechar a caixa de diálogo.

  9. Na caixa de diálogo Propriedades do Vinyl, clique no botão OK.

(Opcional) Habilitar Crystal Reports

O App Builder suporta Crystal Reports em sistemas Windows. O Crystal Reports é hospedado fora do processo em um servidor COM. Para registrar o servidor COM do Crystal Reports, abra um Windows PowerShell como administrador e execute estes comandos:

Set-ExecutionPolicy RemoteSigned
cd C:\inetpub\wwwroot\Vinyl\Scripts
.\RegisterCrystalReports.ps1

Criar um arquivo de conexão

Para criar um arquivo de conexão, siga estas etapas:

  1. Copie um dos exemplos na pasta Sample_Connection_Files e cole-o com o nome Connection.xml no diretório raiz do Vinyl. Qual você copia depende do tipo do seu banco de dados.

  2. Edite o arquivo C:\inetpub\wwwroot\Vinyl\Connection.xml e defina os valores para os parâmetros DatabaseName, UserName e Password. (O usuário UserName deve ter um papel de administração do sistema.)

Dica

Você também pode usar variáveis de ambiente ou um arquivo JSON para especificar a conexão com o banco de dados.

Testar e executar

Para executar o App Builder pela primeira vez, siga estas etapas:

  1. Acesse http://localhost/Vinyl/.

  2. Pode levar vários minutos para configurar o banco de dados pela primeira vez. Quando a tela de login aparecer, insira as seguintes credenciais padrão:

    • Nome de usuário: admin

    • Senha: P@55w0rd

  3. Clique no botão Entrar e siga as instruções para alterar a senha e fazer o upload de um arquivo de licença.

(Opcional) Configuração pós-instalação

  • Configure provedores de segurança:

    O modelo de segurança do App Builder suporta múltiplos provedores de segurança configuráveis. Se sua organização está buscando configurar provedores de segurança, consulte a página Provedores.

  • Garanta que eventos agendados sejam executados após o pool de aplicativos ser reciclado:

    Você deve garantir que o pool de aplicativos esteja sempre em execução e que qualquer evento que possa fazer o pool de aplicativos parar reinicie o aplicativo imediatamente.

    Quando o App Builder não está em execução, eventos agendados não são executados.

    Isso é importante, pois o IIS encerrará o pool de aplicativos quando estiver ocioso (geralmente durante horários fora de pico), fazendo com que rotinas agendadas noturnas sejam ignoradas.

    Para que o App Builder inicie automaticamente após um reciclo do pool de aplicativos ou uma reinicialização do servidor, você pode configurar o componente ApplicationInitialization do IIS.

    Nota

    O ApplicationInitialization do IIS não é compatível com sites que usam Autenticação Integrada do Windows. Usar Autenticação Integrada do Windows requer que a Autenticação Anônima esteja desativada no IIS. O componente ApplicationInitialization do IIS requer acesso anônimo.

    Existe uma solução alternativa para este cenário que envolve o Agendador do Windows para enviar um ping ao App Builder a cada 5 minutos, garantindo que ele reinicie após o pool de aplicativos ser reciclado.

  • Instale e configure a inicialização do aplicativo:

    Os passos variam dependendo da versão do IIS. Escolha um link abaixo:

  • Teste o comportamento de sempre em execução:

    O seguinte guia explica como testar o comportamento de sempre em execução:

    Por padrão, o IIS está configurado para reiniciar a cada 29 horas (para que o Pool de Aplicativos reinicie em horários diferentes a cada dia). Você deve configurar um horário específico do dia para o reinício do Pool de Aplicativos e garantir que esse horário não interfira com trabalhos em segundo plano agendados.

    Alwaysrunning

    Especifique uma data e hora para reciclar o pool de aplicativos no Gerenciador do IIS. Aqui você deve definir 11:42:00 para um horário que não conflite com trabalhos em segundo plano agendados.