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.

Encerrar serviços

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

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

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

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

Avise 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