Ir para o conteúdo

Instalar Jitterbit App Builder no Microsoft Windows (x64)

Introdução

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

  1. Atender aos [requisitos de software][ab sysreqs] para ambos os [servidores web][ab swreqs web win] e [servidor de banco de dados][ab swreqs db win].

  2. Pegue e desempacote o software.

  3. Configurar IIS.

  4. (Opcional) Habilitar Crystal Reports.

  5. Criar um arquivo de conexão.

  6. Testar e executar.

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

Nota

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

Obtenha e descompacte 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 App Builder 4.0 software.

    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 hospedar onde o IIS é executado.

  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 do mouse no arquivo e selecione Propriedades. Na caixa de diálogo Propriedades, selecione a aba Segurança e selecione Desbloquear.

  4. Clique com o botão direito do mouse em vinyl-X.Y.N-win.zip arquivo e selecione Extrair tudo.

  5. Defina o destino da extração para ser 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. Adicione 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 do mouse em Pools de aplicativos e selecione Adicionar pool de aplicativos.

  2. Na caixa de diálogo Adicionar pool de aplicativos, defina 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"

Instâncias Múltiplas

Se você quiser executar várias App Builder instâncias no mesmo servidor de aplicativo, elas devem ser isoladas em pools de aplicativo separados com a opção Carregar perfil de 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 do mouse em Site Padrão e selecione Adicionar Site.

  2. Na caixa de diálogo Adicionar Site, defina 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, na 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 e clique no botão OK.

Para configurar a autenticação usando a linha de comando, digite 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, na pasta Sites, clique com o botão direito do mouse em Vinyl e selecione Editar permissões.

  2. Selecione a aba Segurança e 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 dos objetos a serem selecionados, insira IIS AppPool\Vinyle clique no botão Verificar nomes.

  5. Clique no botão OK.

  6. Na caixa de diálogo Permissões para o Vinyl, em Nomes de grupos ou usuários, selecione o novo usuário do Vinyl.

  7. Em Permissões para Vinyl, na linha Controle total, marque 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

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 uma das amostras no Sample_Connection_Files pasta e cole-a com o nome Connection.xml no Vinyl diretório raiz. Qual você copia depende do seu tipo de banco de dados.

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

Dica

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

Testar e executar

Para correr App Builder pela primeira vez, siga estes passos:

  1. Vá para 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 Sign In e siga as instruções para alterar a senha e fazer upload de um arquivo de licença.

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

  • Configurar provedores de segurança:

    O App Builder o modelo de segurança suporta múltiplos provedores de segurança configuráveis. Se sua organização estiver procurando configurar provedores de segurança, consulte [Provedores][ab providers] página.

  • Garanta que os 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 com que o pool de aplicativos pare reinicie o aplicativo imediatamente.

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

    Isso é importante, pois o IIS desligará o pool de aplicativos quando estiver ocioso (geralmente fora do horário comercial), fazendo com que as rotinas agendadas noturnas sejam ignoradas.

    Para ter App Builder iniciar automaticamente após a reciclagem de um pool de aplicativos ou a reinicialização de um servidor, você pode configurar o IIS ApplicationInitialization componente.

    Nota

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

    Há uma solução alternativa para esse cenário envolvendo o Windows Scheduler para executar ping App Builder a cada 5 minutos para garantir que ele seja reiniciado após o pool de aplicativos ser reciclado.

    • [Solução alternativa para inicialização automática de HTTPS][ab autostart https workaround].
  • Instalar e configurar a inicialização do aplicativo:

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

    • [Instruções de inicialização automática do IIS 8.5][ab iis 85].

    • [Instruções de inicialização automática do IIS 7.5][ab iis 75].

  • Teste o comportamento sempre em execução:

    O guia a seguir mostra como testar o comportamento sempre em execução:

    • [Testar o comportamento sempre em execução][ab always running]

    Por padrão, o IIS é configurado para reiniciar a cada 29 horas (para que o Application Pool reinicie em horários diferentes todos os dias). Você deve configurar um horário específico do dia para reiniciar o Application Pool e certificar-se de que esse horário não interfira com os trabalhos em segundo plano agendados.

    Alwaysrunning

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