Ir para o conteúdo

Atualizar o Jitterbit App Builder no Microsoft Windows (x64)

Introdução

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

  1. Atender aos requisitos de software para ambos os servidores web e servidor de banco de dados.

  2. Pegue e desempacote o software.

  3. Restaurar configurações.

  4. Configurar o IIS.

  5. (Opcional) Habilitar Crystal Reports.

  6. Testar e executar.

Importante

Se você estiver atualizando do Vinyl 3.3 para App Builder 4, você precisa 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á possui uma licença atualizada, siga os passos acima e Testar e executar fornecerá instruções sobre como ativá-lo.

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 (GSC) para obter uma cópia do software App Builder 4.

    O software é fornecido como um arquivo compactado. 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 conexão com terceiros

    • vinyl-X.Y.N-thirdpartysap-win.zip, que inclui os mesmos modelos, bem como drivers específicos da 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 hospedar onde o IIS é executado.

  3. Dependendo das configurações de segurança do seu sistema, pode ser necessário desbloquear o arquivo. Para 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, em seguida, Desbloquear:

    Desbloquear

  4. Clique com o botão direito do mouse no arquivo que contém a implantação que você escolheu na Etapa 1 e selecione Extrair Tudo.

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

  6. Clique no botão Extrair.

    Cuidado

    Não continue até que a extração esteja concluída. Isso pode levar vários minutos.

Restaurar configurações

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

  1. Pare o IIS:

    1. Abra o Gerenciador dos Serviços de Informações da Internet (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 dos 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 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

    O Jitterbit recomenda que você também copie seus logs e pastas de dados do diretório antigo para o novo. Embora não seja necessário, isso 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 de antes.

Configurar o IIS

Para configurar o IIS após atualizar o App Builder, siga estas etapas:

  1. Abra o Gerenciador dos Serviços de Informações da Internet (IIS).

  2. Expanda a pasta Vinyl.

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

  4. Selecione a aba Segurança.

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

  6. Clique no botão Adicionar... para iniciar a caixa de diálogo Selecionar usuários ou grupos.

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

  8. Marque a opção Permitir Controle Total no campo Permissões e clique no botão OK para fechar a caixa de diálogo Permissões para dados.

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

  10. Repita as etapas 3 a 9 para os diretórios logs e keys.

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

(opcional) Habilitar Crystal Reports

O App Builder oferece suporte ao 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 o Windows PowerShell como administrador e execute estes comandos:

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

Teste e execute

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

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

    Importante

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

    1. Efetue login no servidor web no qual o App Builder está instalado.

    2. Abra o Windows Explorer.

    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 data diretório.

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

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

  3. A atualização do banco de dados pode levar vários minutos. Quando a tela de login aparecer, insira suas credenciais de administrador e clique no botão Entrar.