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. Atenda aos requisitos de software para o servidor web e o servidor de banco de dados.

  2. Obtenha e descompacte o software.

  3. Restaure as configurações.

  4. Configure o IIS.

  5. (Opcional) Ative o Crystal Reports.

  6. Teste e execute.

Importante

Se você está atualizando do Vinyl 3.3 para o App Builder 4, é necessário 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 Gerenciador 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.

Dica

Para orientações sobre como planejar uma atualização em ambientes de desenvolvimento, QA e produção, incluindo janelas de manutenção e estratégia de reversão, consulte Estratégias de atualização de produção.

Obtenha e descompacte o software

Para obter e descompactar o software, siga estas etapas:

  1. Entre em contato com seu Gerenciador 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 conexão com terceiros

    • vinyl-X.Y.N-thirdpartysap-win.zip, que inclui os mesmos modelos e drivers específicos do 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 nome anterior do App Builder.

  2. Copie este arquivo para uma pasta no host 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 guia Segurança e depois 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 de 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 seja concluída. Isso pode levar muitos minutos.

Restaure as configurações

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

  1. Interrompa 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 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, fazer isso oferece algumas vantagens, como garantir que todos os seus logs estejam em um único local e garantir que o App Builder possa exibir todos os arquivos PDF salvos no mesmo caminho de diretório de antes.

Configurar IIS

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

  1. Abra o Internet Information Services (IIS) Manager.

  2. Expanda a pasta Vinyl.

  3. Clique com o botão direito na pasta data e escolha a opção Edit Permissions.

  4. Selecione a guia Security.

  5. Clique no botão Edit para abrir a caixa de diálogo Permissions for data.

  6. Clique no botão Add... para abrir a caixa de diálogo Select Users or Groups.

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

  8. Marque Allow Full Control no campo Permissions e clique no botão OK para fechar a caixa de diálogo Permissions for data.

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

  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 Start no painel Actions.

(Opcional) Ativar Crystal Reports

O App Builder oferece suporte a 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

Testar e executar

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

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

    Importante

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

    1. Faça 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 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 administrador e clique no botão Sign In.