Atualização para uma nova build (no local)

Antes de iniciar o processo de atualização, determine e confirme qual versão do Adobe Campaign deve ser atualizada para e consulte as Notas de versão .

IMPORTANTE
  • O Adobe recomenda fazer um backup do banco de dados em cada instância antes da atualização. Para saber mais, consulte esta seção.
  • Para executar uma atualização, verifique se você tem a capacidade e as permissões de acessar instâncias e logs.
  • Leia esta seção e o capítulo atualização de compilação antes de iniciar.

Windows

Em um ambiente Windows, siga as etapas abaixo para atualizar o Adobe Campaign para uma nova build:

Para saber como atualizar o console do cliente, consulte esta seção.

Serviços de desligamento

Para substituir todos os arquivos pela nova versão, você precisa encerrar todas as instâncias do serviço nlserver.

  1. Desligue os seguintes serviços:

    • Serviços Web (IIS):

      iisreset /stop

    • Serviço Adobe Campaign: net stop nlserver6

    IMPORTANTE

    Você também precisa verificar se o servidor de redirecionamento (webmdl) está parado, para que o arquivo nlsrvmod.dll usado pelo IIS possa ser substituído pela nova versão.

  2. Verifique se nenhuma tarefa está ativa executando o comando nlserver pdump. Deve aparecer o seguinte:

    C:<installation path>Adobe Campaign v7bin>nlserver pdump
    HH:MM:SS > Application Server for Adobe Campaign Classic (7.X YY.R build XXX@SHA1) of DD/MM/YYYY
    No tasks
    

    Você pode usar o Gerenciador de Tarefas do Windows para garantir que todos os processos sejam interrompidos.

Atualizar o aplicativo do servidor do Adobe Campaign

Para executar o arquivo de atualização, siga as etapas abaixo:

  1. Execute setup.exe.

    Para baixar esse arquivo, conecte-se ao Portal de distribuição de software usando suas credenciais de usuário. Saiba mais sobre a Distribuição de software em this page.

  2. Selecione o modo de instalação: escolha Update or repair

  3. Clique em Next .

  4. Clique em Finish .

    O programa de instalação copia os novos arquivos.

  5. Quando a operação estiver concluída, clique em Finish .

Sincronizar recursos

Use a seguinte linha de comando:

nlserver config -postupgrade -allinStatus

Isso permitirá que você execute as seguintes operações:

  • Sincronizar recursos
  • Atualizar schemas
  • atualizar o banco de dados
OBSERVAÇÃO

Esta operação deve ser executada apenas uma vez e apenas em um servidor de aplicativos (nlserver web).

Em seguida, verifique se a sincronização gerou erros ou avisos. Para obter mais informações, consulte Resolvendo conflitos de atualização.

Reiniciar serviços

Os serviços a serem reiniciados são:

  • Serviços Web (IIS):

    iisreset /start

  • Serviço Adobe Campaign: net start nlserver6

Linux

Em um ambiente Linux, siga as etapas abaixo para atualizar o Adobe Campaign para uma nova build:

Saiba mais sobre a disponibilidade do console do cliente.

OBSERVAÇÃO

A partir da build 8757, a biblioteca de terceiros não é mais necessária.

Obter pacotes atualizados

Comece recuperando ambos os pacotes atualizados do Adobe Campaign: conecte-se ao Portal de distribuição de software usando suas credenciais de usuário. Saiba mais sobre a Distribuição de software em this page.

O arquivo é nlserver6-v7-XXX.rpm

Executar uma atualização

  • Distribuição baseada em RPM (RedHat, SuSe)

    Para instalá-los, execute como raiz:

    $rpm -Uvh nlserver6-v7-XXXX.rpm
    

    Onde XXX é a versão do arquivo.

    O arquivo rpm tem dependências em pacotes que podem ser encontrados nas distribuições CentOS/Red Hat. Se não quiser usar algumas dessas dependências, talvez seja necessário usar a opção "nodeps" de rpm:

    rpm --nodeps -Uvh nlserver6-v7-XXXX-0.x86_64.rpm
    
  • Distribuição baseada em DEB (Debian)

    Para instalá-los, execute como raiz:

    dpkg -i nlserver6-v7-XXXX-amd64_debX.deb
    
OBSERVAÇÃO

Os procedimentos de instalação completos estão detalhados em nesta seção. Os recursos são sincronizados automaticamente, no entanto, é necessário garantir que nenhum erro ocorreu. Para obter mais informações, consulte Resolver conflitos de atualização.

Reinicialize o servidor Web

Você deve encerrar o Apache para que a nova biblioteca se torne aplicável.

Para fazer isso, execute o seguinte comando:

/etc/init.d/apache stop
IMPORTANTE
  • Seu script pode ser chamado de httpd em vez de apache.
  • Você DEVE executar esse comando até obter a seguinte resposta:

Essa operação é necessária para que o Apache aplique a nova biblioteca.

Em seguida, reinicie o Apache:

/etc/init.d/apache start

Resolver conflitos de atualização

Durante a sincronização de recursos, o comando postupgrade permite detectar se a sincronização gerou erros ou avisos.

Exibir o resultado da sincronização

Há duas maneiras de visualizar o resultado da sincronização:

  • Na interface da linha de comando, os erros são materializados por uma divisa tripla >> e a sincronização é interrompida automaticamente. Os avisos são materializados por uma divisa dupla > e devem ser resolvidos assim que a sincronização for concluída. No final do postupgrade, um resumo é exibido no prompt de comando. Pode ser assim:

    2013-04-09 07:48:39.749Z 00002E7A 1 info log =========Summary of the update==========
    2013-04-09 07:48:39.749Z 00002E7A 1 info log <instance name> instance, 6 warning(s) and 0 error(s) during the update.
    2013-04-09 07:48:39.749Z 00002E7A 1 warning log The document with identifier 'mobileAppDeliveryFeedback' and type 'xtk:report' is in conflict with the new version.
    2013-04-09 07:48:39.749Z 00002E7A 1 warning log The document with identifier 'opensByUserAgent' and type 'xtk:report' is in conflict with the new version.
    2013-04-09 07:48:39.750Z 00002E7A 1 warning log The document with identifier 'deliveryValidation' and type 'nms:webApp' is in conflict with the new version.
    2013-04-09 07:48:39.750Z 00002E7A 1 warning log Document of identifier 'nms:includeView' and type 'xtk:srcSchema' updated in the database and found in the file system. You will have to merge the two versions manually.
    

    Se o aviso se referir a um conflito de recursos, é necessário prestar atenção ao usuário para resolvê-lo.

  • O arquivo de log postupgrade_<server version number>_<time of postupgrade>.log contém o resultado da sincronização. Está disponível por padrão no seguinte diretório: <installation directory>/var/<instance/postupgrade. Erros e avisos são indicados pelos atributos de erro e aviso.

Resolver conflitos

Para resolver conflitos, aplique o seguinte processo:

  1. Na árvore do Adobe Campaign, acesse Administration > Configuration > Package management > Edit conflicts .
  2. Selecione o conflito que deseja resolver na lista.

Há três maneiras de resolver um conflito:

  • Declare as resolved : requer a intervenção do usuário antecipadamente.

  • Accept the new version : recomendado se os recursos fornecidos com o Adobe Campaign não tiverem sido alterados pelo usuário.

  • Keep the current version : significa que a atualização é rejeitada.

    IMPORTANTE

    Se você selecionar esse modo de resolução, poderá não se beneficiar das correções na nova versão.

Se você optou por resolver o conflito manualmente, proceda da seguinte maneira:

  1. Na seção inferior da janela, procure pela string conflict para localizar as entidades com conflitos. A entidade instalada com a nova versão contém o argumento new, a entidade que corresponde à versão anterior contém o argumento cus.

  2. Exclua a versão que não deseja manter. Exclua a string conflict_argumento da entidade que você está mantendo.

  3. Vá para o conflito que você resolveu. Clique no ícone Actions e selecione Declare as resolved .

  4. Salve as alterações: o conflito está agora resolvido.

Práticas recomendadas

Uma falha de atualização pode estar vinculada à configuração do banco de dados. Verifique se as configurações realizadas pelo administrador técnico e pelo administrador do banco de dados são compatíveis.

Por exemplo, um banco de dados unicode não deve autorizar apenas o armazenamento de dados LATIN1, etc.

Avisar os consoles do cliente da atualização disponível

Windows

Na máquina em que o servidor de aplicativos Adobe Campaign está instalado (nlserver web), baixe e copie o arquivo setup-client-6.XXXX.exe em [caminho do aplicativo]/datakit/nl/eng/jsp.

Na próxima vez que os consoles do cliente estiverem conectados, uma janela informará os usuários sobre a disponibilidade de uma atualização e oferecerá a possibilidade de baixá-la e instalá-la.

OBSERVAÇÃO

Verifique se o usuário IIS_XPG tem os direitos de leitura apropriados para esse arquivo de instalação e consulte o guia de instalação para obter mais informações.

Linux

Na máquina em que o servidor de aplicativos Adobe Campaign (nlserver web) está instalado, recupere o pacote setup-client-6.XXXX.exe e copie-o, salvando como /usr/local/neolane/nl6/datakit/nl/eng/jsp:

 cp setup-client-6.XXXX.exe /usr/local/neolane/nl6/datakit/nl/eng/jsp

Na próxima vez que os consoles do cliente estiverem conectados, uma janela informará os usuários sobre a disponibilidade de uma atualização e oferecerá a possibilidade de baixá-la e instalá-la.

OBSERVAÇÃO

Verifique se o usuário do Apache tem os direitos de leitura apropriados para esse arquivo de instalação e consulte o guia de instalação para obter mais informações.

Nesta página