Ir para o conteúdo

Atualizar Jitterbit App Builder no Microsoft Windows (x64)

Introdução

Para atualizar 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. Restaure as configurações.

  4. Configure o IIS.

  5. (Opcional) Habilite o Crystal Reports.

  6. Teste e execute.

Importante

Se você estiver atualizando do Vinyl 3.3 para o App Builder 4, deve obter uma licença atualizada. Sem uma licença atualizada, a atualização do Vinyl 3.3 para o App Builder 4 falha. Se você não tiver uma licença atualizada, entre em contato com seu Gerente de Sucesso do Cliente e solicite uma. Se você já tiver uma licença atualizada, siga as etapas acima e a seção Teste e execute fornecerá instruções sobre como ativá-la.

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. Os usuários do Windows têm as seguintes opções:

    • vinyl-X.Y.N-win.zip, para uma implantação padrão

    • vinyl-X.Y.N-thirdparty-win.zip, que inclui uma coleção de modelos para conectar a terceiros

    • vinyl-X.Y.N-thirdpartysap-win.zip, que inclui os mesmos modelos, bem como drivers específicos para SAP

    Para todas as opções, X.Y é o número da versão (por exemplo, 4.0) e N é o número da compilação (por exemplo, 45678).

    Nota

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

  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 do mouse 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 do mouse no arquivo contendo a implantação que você escolheu na Etapa 1 e selecione Extrair Tudo.

  5. Defina o destino da extração para uma pasta temporária, como C:\temp\Vinyl.

  6. Clique no botão Extrair.

    Cuidado

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

Restaurar configurações

Para restaurar suas configurações, siga estas etapas:

  1. Pare o IIS:

    1. Abra o Gerenciador do Internet Information Services (IIS).

    2. Selecione o servidor web.

    3. Clique no botão Parar no canto superior direito do painel Ações.

  2. Faça uma cópia de backup de seus bancos de dados.

  3. Mova a pasta de instalação atual para um local temporário (por exemplo, de C:\inetpub\wwwroot\Vinyl para C:\temp\OLD_Vinyl).

  4. Renomeie a nova pasta de instalação (por exemplo, de C:\temp\Vinyl para C:\inetpub\wwwroot\Vinyl).

  5. Copie os seguintes arquivos da sua pasta de instalação antiga para a nova:

    Copiar de Para
    C:\temp\OLD_Vinyl\Connection.xml C:\inetpub\wwwroot\Vinyl\Connection.xml
    C:\temp\OLD_Vinyl\appsettings.json C:\inetpub\wwwroot\Vinyl\appsettings.json
    C:\temp\OLD_Vinyl\keys\* C:\inetpub\wwwroot\Vinyl\keys\

    Nota

    A Jitterbit recomenda que você também copie suas pastas de logs e dados do diretório antigo para o novo. Embora não seja necessário, fazê-lo oferece algumas vantagens, como garantir que todos os seus logs estejam em um só lugar e garantir que o App Builder possa exibir todos os arquivos PDF salvos no mesmo caminho de diretório que antes.

Configurar IIS

Para configurar o IIS após a atualização do App Builder, siga estas etapas:

  1. Abra o Gerenciador do Internet Information Services (IIS).

  2. Expanda a pasta Vinyl.

  3. Clique com o botão direito na pasta data e escolha a opção Editar Permissões.

  4. Selecione a guia Segurança.

  5. Clique no botão Editar para abrir a caixa de diálogo Permissões para data.

  6. Clique no botão Adicionar... para abrir a caixa de diálogo Selecionar Usuários ou Grupos.

  7. Forneça o nome IIS AppPool\Vinyl no campo inferior.

  8. Marque Permitir Controle Total no campo de Permissões, em seguida, clique no botão OK para fechar a caixa de diálogo Permissões para data.

  9. Clique no botão OK para fechar a caixa de diálogo Propriedades de data.

  10. Repita as etapas 3-9 para os diretórios logs e keys também.

  11. Reinicie o IIS selecionando o servidor e clicando no botão Iniciar no painel de Ações.

(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 os seguintes comandos:

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

Testar e executar

Para executar o App Builder após uma atualização, siga estas etapas:

  1. Se necessário, faça o upload e ative um novo arquivo de licença:

    Importante

    Isso é obrigatório se você estiver atualizando de Vinyl 3.3 para App Builder 4, pois as licenças para Vinyl 3.3 não são transferíveis para o App Builder 4.

    1. Faça login no servidor web onde o App Builder está instalado.

    2. Abra o explorador de arquivos do Windows.

    3. Localize o diretório de instalação do App Builder (por exemplo, C:\inetpub\wwwroot\Vinyl).

    4. Copie o arquivo de licença para o diretório data.

    5. Renomeie o arquivo para vinyl.lic (se tiver outro nome).

  2. Acesse http://localhost/Vinyl/.

  3. Pode levar vários minutos para atualizar o banco de dados. Quando a tela de login aparecer, insira as credenciais do seu administrador e clique no botão Entrar.