Ir para o conteúdo

Instalar App Builder no Microsoft Windows (x64)

Introdução

Para instalar App Builder no Microsoft Windows, atenda aos requisitos do sistema para cada servidor, siga as etapas nestas seções:

  1. Obter e descompactar o software.

  2. Configurar IIS.

  3. (Opcional) Habilitar Crystal Reports.

  4. Criar um arquivo de conexão.

  5. Testar e executar.

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

Obtenha e Descompacte o Software

Para obter o App Builder software, siga estes passos:

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

  2. O App Builder o software é fornecido como um arquivo compactado com o nome AppBuilder-VER.zip, onde VER é o número da versão. Copie ou mova-o para o hospedar onde o IIS é executado.

    Dica

    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.

  3. Na pasta raiz física padrão do IIS (geralmente C:\inetpub\wwwroot\), crie uma subpasta para App Builder. (Por exemplo, C:\inetpub\wwwroot\AppBuilder.)

  4. Descompacte o conteúdo do arquivo baixado .zip arquivo para esta pasta.

Configurar o IIS

Você deve configurar seu servidor IIS executando as seguintes tarefas:

  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 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: App Builder
    • 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:"AppBuilder" /managedPipelineMode:Integrated /autoStart:true /managedRuntimeVersion:"v8.0"

Múltiplas instâncias

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, clique com o botão direito em Sites e selecione Adicionar site.
  2. Na caixa de diálogo Adicionar site, defina valores para os seguintes campos:
    • Nome do site: App Builder
    • Pool de aplicativos: App Builder
    • Caminho físico: Caminho para onde o software foi descompactado (por exemplo, C:\inetpub\wwwroot\AppBuilder).
    • 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:"AppBuilder" /id:1 /bindings:http://*:80 /physicalPath:"C:\inetpub\wwwroot\AppBuilder"
.\appcmd.exe add app /site.name:"AppBuilder" /path:"/" /physicalPath:"C:\inetpub\wwwroot\AppBuilder"

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 o App Builder entrada.
  2. Clique duas vezes no ícone Autenticação.
  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, 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, na pasta Sites, clique com o botão direito do mouse em App Builder e selecione Editar permissões.
  2. Selecione a aba Segurança e clique no botão Editar.
  3. Em Permissões para App Builder caixa de diálogo, 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\AppBuilder, então clique no botão Verificar nomes.
  5. Clique no botão OK.
  6. Em Permissões para AppBuilder caixa de diálogo, em Nomes de grupo ou usuário, selecione o novo App Builder usuário.
  7. Em Permissões para App Builder, 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 App Builder caixa de diálogo Propriedades, 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\AppBuilder\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 App Builder diretório raiz. Qual você copia depende do seu tipo de banco de dados.
  2. Edite o C:\inetpub\wwwroot\AppBuilder\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 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/AppBuilder/.

  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 Providers página.

  • 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 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.

  • Instalar e configurar a inicialização do aplicativo

    As etapas variam dependendo da versão do IIS. Selecione o link abaixo:

  • Teste o comportamento sempre em execução

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

    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 o Application Pool reiniciar 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