Instalar Jitterbit App Builder no Microsoft Windows (x64)
Introdução
Para instalar App Builder no Microsoft Windows, siga estas etapas:
-
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].
-
Pegue e desempacote o software.
-
(Opcional) Habilitar Crystal Reports.
-
(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:
-
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
, ondeX.Y
é o número da versão (por exemplo,4.0
) eN
é o número da compilação (por exemplo,45678
). -
Copie este arquivo para uma pasta no hospedar onde o IIS é executado.
-
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.
-
Clique com o botão direito do mouse em
vinyl-X.Y.N-win.zip
arquivo e selecione Extrair tudo. -
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
). -
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:
Adicionar um pool de aplicativos
Para adicionar um pool de aplicativos usando o Gerenciador do IIS, siga estas etapas:
-
No painel Conexões, clique com o botão direito do mouse em Pools de aplicativos e selecione Adicionar pool de aplicativos.
-
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.
-
-
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:
-
No painel Conexões, expanda a pasta Sites, clique com o botão direito do mouse em Site Padrão e selecione Adicionar Site.
-
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.
-
-
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:
-
No painel Conexões, na pasta Sites, selecione a entrada Vinyl.
-
Clique duas vezes no ícone Autenticação na seção IIS.
-
Selecione Autenticação Anônima e clique na ação Editar.
-
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:
-
No painel Conexões, na pasta Sites, clique com o botão direito do mouse em Vinyl e selecione Editar permissões.
-
Selecione a aba Segurança e clique no botão Editar.
-
Na caixa de diálogo Permissões para Vinyl, clique no botão Adicionar.
-
Na caixa de diálogo Selecionar usuário ou grupos, no campo Digite os nomes dos objetos a serem selecionados, insira
IIS AppPool\Vinyl
e clique no botão Verificar nomes. -
Clique no botão OK.
-
Na caixa de diálogo Permissões para o Vinyl, em Nomes de grupos ou usuários, selecione o novo usuário do Vinyl.
-
Em Permissões para Vinyl, na linha Controle total, marque a caixa de seleção Permitir.
-
Clique no botão OK para fechar a caixa de diálogo.
-
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:
-
Copie uma das amostras no
Sample_Connection_Files
pasta e cole-a com o nomeConnection.xml
noVinyl
diretório raiz. Qual você copia depende do seu tipo de banco de dados. -
Edite o
C:\inetpub\wwwroot\Vinyl\Connection.xml
arquivar e definir valores para os parâmetrosDatabaseName
,UserName
, ePassword
. (OUserName
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:
-
Vá para
http://localhost/Vinyl/
. -
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
-
-
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.
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.