Migração para o Adobe Campaign v7 no Linux

Procedimento geral

As etapas de migração no Linux são as seguintes:

1. Parar serviços: consulte Parada de serviço.
2. Salve o banco de dados: consulte Fazer backup do banco de dados e da instalação existente.
3. Desinstale os pacotes de versão anteriores do Adobe Campaign: consulte Desinstalar pacotes de versão anteriores do Adobe Campaign.
4. Migre a plataforma: consulte Implantação do Adobe Campaign v7.
5. Reiniciar serviço: consulte Reiniciar serviços.

Parada de serviço

Primeiro, pare todos os processos com acesso ao banco de dados em todas as máquinas em questão.

1. Faça logon como root.

2. Todos os servidores que usam o módulo de redirecionamento (serviço webmdl) precisam ser interrompidos. Para o Apache, execute o seguinte comando:

   /etc/init.d/apache2 stop
   

3. Faça logon novamente como root.

4. Interrompa os serviços de versão anterior da Adobe Campaign em todos os servidores.

   /etc/init.d/nlserver6 stop
   

   Se você estiver migrando da v5.11, execute o seguinte comando:

   /etc/init.d/nlserver5 stop
   

5. Verifique se os serviços da Adobe Campaign estão interrompidos em cada servidor.

   ps waux | grep nlserver
   

   A lista de processos ativos é exibida junto com sua ID (PID).

6. Se um ou mais processos do Adobe Campaign ainda estiverem ativos ou bloqueados após alguns minutos, mate-os.

   killall nlserver
   

7. Se alguns processos ainda estiverem ativos após alguns minutos, você poderá forçá-los a fechar usando o comando :

   killall -9 nlserver
   

Faça o backup do banco de dados e da instalação existente

O procedimento depende da versão anterior do Adobe Campaign.

Migração do Adobe Campaign v5.11

1. Faça um backup do banco de dados do Adobe Campaign.

2. Faça logon como neolane e faça um backup do diretório nl5 usando o seguinte comando:

   su - neolane
   mv nl5 nl5.back
   

   IMPORTANTE

   Como precaução, recomendamos que você compacte a pasta nl5.back e a salve em um local seguro diferente do servidor.

3. Edite o config-<instance name>.xml (na pasta nl5.back) para impedir o mta, wfserver, stat etc. de iniciar automaticamente. Por exemplo, substitua autoStart por _autoStart (ainda como neolane).

   <?xml version='1.0'?>
   <serverconf>
     <shared>
       <dataStore hosts="myServer*" lang="en_US">
         <dataSource name="default">
           <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
         </dataSource>
       </dataStore>
     </shared>
   
     <mta _autoStart="true" statServerAddress="myStatServer"/>
     <stat _autoStart="true"/>
     <wfserver _autoStart="true"/>
     <inMail _autoStart="true"/>
     <sms _autoStart="false"/>
   </serverconf>
   

Migração do Adobe Campaign v6.02

1. Faça um backup do banco de dados do Adobe Campaign.

2. Faça logon como neolane e faça um backup do diretório nl6 usando o seguinte comando:

   su - neolane
   mv nl6 nl6.back
   

   IMPORTANTE

   Como precaução, recomendamos que você compacte a pasta nl6.back e a salve em um local seguro diferente do servidor.

3. Edite o config-<instance name>.xml (na pasta nl6.back) para impedir o mta, wfserver, stat, etc. de iniciar automaticamente. Por exemplo, substitua autoStart por _autoStart (ainda como Adobe Campaign).

   <?xml version='1.0'?>
   <serverconf>
     <shared>
       <dataStore hosts="myServer*" lang="en_US">
         <dataSource name="default">
           <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
         </dataSource>
       </dataStore>
     </shared>
   
     <mta _autoStart="true" statServerAddress="myStatServer"/>
     <stat _autoStart="true"/>
     <wfserver _autoStart="true"/>
     <inMail _autoStart="true"/>
     <sms _autoStart="false"/>
   </serverconf>
   

Migração do Adobe Campaign v6.1

1. Faça um backup do banco de dados do Adobe Campaign.

2. Faça logon como neolane e faça um backup do diretório nl6 usando o seguinte comando:

   su - neolane
   mv nl6 nl6.back
   

   IMPORTANTE

   Como precaução, recomendamos que você compacte a pasta nl6.back e a salve em um local seguro diferente do servidor.

Desinstalação dos pacotes de versão anteriores do Adobe Campaign

O procedimento depende da versão anterior do Adobe Campaign.

Desinstalação de pacotes Adobe Campaign v5

1. Faça logon como root.

2. Identifique os pacotes do Adobe Campaign instalados usando o seguinte comando.

   • Em Debian:

     dpkg -l | grep nl
     

     A lista de pacotes instalados é exibida:

     ii  nlserver5                       5762                     nlserver5-5762
     ii  nlthirdparty5                   5660                     nlthirdparty5-5660
     

   • Em Chapéu Vermelho:

     rpm -qa | grep nl
     

3. Desinstale os pacotes Adobe Campaign v5.

   • Em Debian:

     dpkg --purge nlserver5 nlthirdparty5
     

   • Em Chapéu Vermelho:

     rprm -ev nlserver5 nlthirdparty5
     

Desinstalação de pacotes do Adobe Campaign v6

Esta seção mostra como desinstalar pacotes Adobe Campaign v6.02 ou v6.1.

1. Faça logon como root.

2. Identifique os pacotes do Adobe Campaign instalados usando o seguinte comando.

   • Em Debian:

     dpkg -l | grep nl
     

     A lista de pacotes instalados é exibida:

     ii  nlserver6                       XXXX                     nlserver6-XXXX
     ii  nlthirdparty6                   XXXX                     nlthirdparty6-XXXX
     

   • Em Chapéu Vermelho:

     rpm -qa | grep nl
     

3. Desinstale os pacotes do Adobe Campaign v6.

   • Em Debian:

     dpkg --purge nlserver6 nlthirdparty6
     

   • Em Chapéu Vermelho:

     rprm -ev nlserver6 nlthirdparty6
     

Implantação do Adobe Campaign v7

O procedimento depende da versão anterior do Adobe Campaign.

Migração do Adobe Campaign v5.11

A implantação do Adobe Campaign envolve duas etapas:

• Instalação de pacotes do Adobe Campaign v7: essa operação deve ser executada em cada servidor.
• A atualização posterior: esse comando deve ser iniciado em cada instância.

Para implantar o Adobe Campaign, siga as etapas abaixo:

1. Instale os pacotes mais recentes do Adobe Campaign v7 usando o seguinte comando:

   • Em Debian:

     dpkg -i nlserver6-XXXX-linux-2.6-intel.deb
     

   • Em Chapéu Vermelho:

     rpm -Uvh nlserver6-XXXX-0.x86_64.rpm
     

   IMPORTANTE

   Você deve instalar os pacotes com êxito antes de passar para a próxima etapa.

   OBSERVAÇÃO

   Ao migrar da v5.11, o Adobe Campaign é instalado no diretório /usr/local/neolane/nl6/ por padrão.

   Depois que os pacotes forem instalados, a seguinte mensagem será exibida: A opção 'WdbcTimeZone' está ausente. Isso é normal.

2. Para disponibilizar o programa de instalação do console do cliente, copie-o no diretório de instalação do Adobe Campaign:

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

   OBSERVAÇÃO

   Para obter mais informações sobre como instalar o Adobe Campaign no Linux, consulte esta seção.

3. Modifique o arquivo .bashrd que corresponda ao usuário neolane. Faça logon como neolane e execute o seguinte comando:

   su - neolane
   vim ~/.bashrc
   

   OBSERVAÇÃO

   Ao efetuar logon como neolane, a seguinte mensagem é exibida: nl5/env.sh : Não existe esse arquivo ou diretório. Isso é normal.

   No final do arquivo, substitua nl5/env.sh por nl6/env.sh.

4. Faça logon como root e prepare a instância usando os seguintes comandos:

   /etc/init.d/nlserver6 start   
   Starting nlserver6: [  OK  ]
   

   /etc/init.d/nlserver6 stop
   Stopping nlserver6: [  OK  ]
   

   OBSERVAÇÃO

   Esses comandos permitem criar o sistema de arquivos internos Adobe Campaign v6: Diretório conf (com os arquivos config-default.xml e serverConf.xml), var.

5. Vá para a pasta de backup nl5.back e copie (substitua) os arquivos e as subpastas de configuração de cada instância. Faça logon como neolane e execute o seguinte comando:

   IMPORTANTE

   Para o primeiro comando abaixo, não copie o arquivo config-default.xml.

   su - neolane
   
   cp nl5.back/conf/config-<instance name>.xml nl6/conf/
   cp nl5.back/customer.sh nl6/
   cp -r nl5.back/customers/* nl6/customers/
   cp -r nl5.back/var/* nl6/var/
   

6. Nos arquivos Adobe Campaign v7 serverConf.xml e config-default.xml, aplique as configurações específicas que você tinha para o Adobe Campaign v5. Para o arquivo serverConf.xml, use o arquivo nl5/conf/serverConf.xml.diff.

   OBSERVAÇÃO

   Ao relatar configurações do Adobe Campaign v5 para o Adobe Campaign v7, verifique se os caminhos para os diretórios físicos levam ao Adobe Campaign v7 e não ao Adobe Campaign v5.

7. Como a migração não é uma instalação genérica, é necessário forçar o reinício do serviço trackinglogd. Para fazer isso, abra o arquivo nl6/conf/config-default.xml e verifique se o serviço trackinglogd está ativado (somente no(s) servidor(es) de rastreamento/redirecionamento):

   <trackinglogd autoStart="true"/>
   

   IMPORTANTE

   Se o serviço trackinglogd não for iniciado no servidor de rastreamento, nenhuma informação de rastreamento será encaminhada.

8. Recarregue a configuração do Adobe Campaign v7 usando o seguinte comando:

   nlserver config -reload
   

9. Inicie o processo pós-atualização usando o seguinte comando (ainda como neolane):

   su - neolane
   nlserver config -timezone:<time zone> -postupgrade -instance:<instance name>
   

   IMPORTANTE

   Você deve especificar qual fuso horário usar como referência durante a pós-atualização (usando a opção -timezone). Nesse caso, estamos usando o fuso horário Europa/Paris -timezone: "Europe/Paris".

   OBSERVAÇÃO

   É altamente recomendável atualizar sua base para "vários fusos horários". Para obter mais informações sobre as opções de fuso horário, consulte a seção Fusos horários .

Migração do Adobe Campaign v6.02

A implantação do Adobe Campaign envolve duas etapas:

• Instalação de pacotes do Adobe Campaign v7: essa operação deve ser executada em cada servidor.
• A atualização posterior: esse comando deve ser iniciado em cada instância.

Para implantar o Adobe Campaign, siga as etapas abaixo:

1. Instale os pacotes mais recentes do Adobe Campaign v7 usando o seguinte comando:

   • Em Debian:

     dpkg -i nlserver6-XXXX-amd64_debX.deb
     

   • Em Chapéu Vermelho:

     rpm -Uvh nlserver6-XXXX-x86_64_rhX.rpm
     

   IMPORTANTE

   Você deve instalar os pacotes com êxito antes de passar para a próxima etapa.

   OBSERVAÇÃO

   O Adobe Campaign v7 é instalado no mesmo diretório por padrão que o Adobe Campaign v6.02: /usr/local/neolane/nl6/.

2. Para disponibilizar o programa de instalação do console do cliente, copie-o no diretório de instalação do Adobe Campaign:

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

   OBSERVAÇÃO

   Para obter mais informações sobre como instalar o Adobe Campaign no Linux, consulte esta seção.

3. Como a migração não é uma instalação genérica, é necessário forçar o reinício do serviço trackinglogd. Para fazer isso, abra o arquivo nl6/conf/config-default.xml e verifique se o serviço trackinglogd está ativado (somente no(s) servidor(es) de rastreamento/redirecionamento):

   <trackinglogd autoStart="true"/>
   

   IMPORTANTE

   Se o serviço trackinglogd não for iniciado no servidor de rastreamento, nenhuma informação de rastreamento será encaminhada.

4. Vá para a pasta de backup nl6.back e copie (substitua) os arquivos e as subpastas de configuração de cada instância. Faça logon como neolane e execute o seguinte comando:

   su - neolane
   
   cp nl6.back/conf/config*.xml nl6/conf/
   cp nl6.back/customer.sh nl6/
   cp -r nl6.back/customers/* nl6/customers/
   cp -r nl6.back/var/* nl6/var/
   

5. Recarregue a configuração do Adobe Campaign v7 usando o seguinte comando:

   nlserver config -reload
   

6. Inicie o processo pós-atualização usando o seguinte comando (ainda como neolane):

   su - neolane
   nlserver config -postupgrade -instance:<instance name>
   

   OBSERVAÇÃO

   O modo "vários fusos horários" estava disponível somente na v6.02 para mecanismos de banco de dados PostgreSQL. Agora ele está disponível independentemente da versão do mecanismo de banco de dados que está sendo usada. É altamente recomendável atualizar sua base para "vários fusos horários". Para obter mais informações sobre as opções de fuso horário, consulte a seção Fusos horários .

Migração do Adobe Campaign v6.1

A implantação do Adobe Campaign envolve duas etapas:

• Instalação de pacotes do Adobe Campaign v7: essa operação deve ser executada em cada servidor.
• A atualização posterior: esse comando deve ser iniciado em cada instância.

Para implantar o Adobe Campaign, siga as etapas abaixo:

1. Instale os pacotes mais recentes do Adobe Campaign v7 usando o seguinte comando:

   • Em Debian:

     dpkg -i nlserver6-XXXX-amd64_debX.deb
     

   • Em Chapéu Vermelho:

     rpm -Uvh nlserver6-XXXX-x86_64_rhX.rpm
     

   IMPORTANTE

   Você deve instalar os pacotes com êxito antes de passar para a próxima etapa.

   OBSERVAÇÃO

   O Adobe Campaign v7 é instalado no diretório /usr/local/neolane/nl6/ por padrão.

2. Para disponibilizar o programa de instalação do console do cliente, copie-o no diretório de instalação do Adobe Campaign:

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

   OBSERVAÇÃO

   Para obter mais informações sobre como instalar o Adobe Campaign no Linux, consulte esta seção.

3. Vá para a pasta de backup nl6.back e copie (substitua) os arquivos e as subpastas de configuração de cada instância. Faça logon como neolane e execute o seguinte comando:

   su - neolane
   
   cp nl6.back/conf/config*.xml nl6/conf/
   cp nl6.back/customer.sh nl6/
   cp -r nl6.back/customers/* nl6/customers/
   cp -r nl6.back/var/* nl6/var/
   

4. Recarregue a configuração do Adobe Campaign v7 usando o seguinte comando:

   nlserver config -reload
   

5. Inicie o processo pós-atualização usando o seguinte comando (ainda como neolane):

   su - neolane
   nlserver config -postupgrade -instance:<instance name>
   

Migração do servidor de redirecionamento (Apache)

Nesse estágio, o Apache precisa ser interrompido. Consulte: Parada de serviço.

1. Faça logon como root.

2. Altere as variáveis de ambiente do Apache para torná-las vinculadas ao diretório nl6.

   • Em Debian:

     vi /etc/apache2/envvars
     

   • Em Chapéu Vermelho:

     vi /usr/local/apache2/bin/envvars
     

3. Em seguida, execute os seguintes comandos:

   • Em Debian:

     No arquivo nlsrv.load, substitua nl5 por nl6.

     vi /etc/apache2/mods-available/nlsrv.load
     

     Exclua o link do arquivo nlsrv.conf e crie um novo.

     rm /etc/apache2/mods-available/nlsrv.conf 
     ln -s /usr/local/neolane/nl6/tomcat-6/conf/apache_neolane.conf /etc/apache2/
     mods-available/nlsrv.conf
     

   • Em Chapéu Vermelho:

     Vá para o diretório /usr/local/apache2/conf, edite o arquivo http.conf e substitua nl5 por nl6 nas seguintes linhas.

     Em RHEL 7/Debian 8:

     LoadModule requesthandler24_module /usr/local/neolane/nl6/lib/libnlsrvmod.so
     Include /usr/local/neolane/nl6/tomcat-6/conf/apache_neolane.conf
     

4. Vá para o arquivo alias.conf e substitua todos os nl5 por nl6. Para fazer isso no Debian, execute o seguinte comando:

   vi /etc/apache2/mods-available/alias.conf
   

Zonas de segurança

Se estiver migrando da v6.02 ou anterior, você deve configurar as zonas de segurança antes de iniciar os serviços. Para obter mais informações, consulte Segurança.

Reiniciar serviços

O procedimento depende da versão anterior do Adobe Campaign.

Migração do Adobe Campaign v5.11

Nos arquivos config-<instance name>.xml, reative a inicialização automática do mta, wfserver, stat, etc. serviços.

<?xml version='1.0'?>
<serverconf>
  <shared>
    <dataStore hosts="myServer*" lang="en_US">
      <dataSource name="default">
        <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
      </dataSource>
    </dataStore>
  </shared>

  <mta autoStart="true" statServerAddress="localhost"/>
  <stat autoStart="true"/>
  <wfserver autoStart="true"/>
  <inMail autoStart="true"/>
  <sms autoStart="false"/>
</serverconf>

Inicie os serviços do Apache e da Adobe Campaign em cada um dos seguintes servidores:

1. Servidor de rastreamento e redirecionamento.
2. Servidor Mid-sourcing.
3. Servidor de marketing.

Antes de prosseguir para a próxima etapa, execute um teste completo da nova instalação, verifique se não há regressões e se tudo funciona seguindo todas as recomendações da seção Configurações gerais.

Migração do Adobe Campaign v6.02

Nos arquivos config-<instance name>.xml, reative a inicialização automática do mta, wfserver, stat, etc. serviços.

<?xml version='1.0'?>
<serverconf>
  <shared>
    <dataStore hosts="myServer*" lang="en_US">
      <dataSource name="default">
        <dbcnx encrypted="1" login="myLogin" password="myPassword"  provider="postgresql" server="myServer"/>
      </dataSource>
    </dataStore>
  </shared>

  <mta autoStart="true" statServerAddress="myStatServer"/>
  <stat autoStart="true"/>
  <wfserver autoStart="true"/>
  <inMail autoStart="true"/>
  <sms autoStart="false"/>
</serverconf>

Inicie os serviços do Apache e da Adobe Campaign em cada um dos seguintes servidores:

1. Servidor de rastreamento e redirecionamento.
2. Servidor Mid-sourcing.
3. Servidor de marketing.

Teste completamente a nova instalação, verifique se ela não regride e se tudo está funcionando corretamente seguindo todas as recomendações da seção Configurações gerais.

Migração do Adobe Campaign v6.1

Inicie os serviços do Apache e da Adobe Campaign em cada um dos seguintes servidores:

1. Servidor de rastreamento e redirecionamento.
2. Servidor Mid-sourcing.
3. Servidor de marketing.

Teste completamente a nova instalação, verifique se ela não regride e se tudo está funcionando corretamente seguindo todas as recomendações da seção Configurações gerais.

Exclusão e limpeza do Adobe Campaign v5

Antes de excluir e limpar a instalação do Adobe Campaign v5, você deve aplicar as seguintes recomendações:

• Obtenha as equipes funcionais para executar uma verificação completa da nova instalação.
• Desinstale o Adobe Campaign v5 somente depois de ter certeza de que nenhuma reversão será necessária.

Exclua o diretório nl5.back. Faça logon como neolane e execute o seguinte comando:

su - neolane
rm -rf nl5.back

Reinicie o servidor.