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 Faça backup do banco de dados e da instalação existente.
3. Desinstale os pacotes de versão anteriores do Adobe Campaign: consulte Desinstalação dos pacotes da versão anterior do Adobe Campaign.
4. Migre a plataforma: consulte Implantação do Adobe Campaign v7.
5. Restart do serviço: consulte Reiniciando serviços.

Parada de serviço

Em primeiro lugar, interromper todos os processos com acesso à base de dados em todas as máquinas em causa.

1. Faça logon como root.

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

   /etc/init.d/apache2 stop
   

3. Efetue login novamente como root.

4. Pare 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. Certifique-se de que os serviços da Adobe Campaign sejam interrompidos em cada servidor.

   ps waux | grep nlserver
   

   A lista dos 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ê pode forçá-los a fechar usando o comando:

   killall -9 nlserver
   

Faça 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 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 salve-a em um local seguro diferente do servidor.

3. Edite a 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 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 salve-a em um local seguro diferente do servidor.

3. Edite a 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 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 salve-a em um local seguro diferente do servidor.

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

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

Desinstalação de pacotes do Adobe Campaign v5

1. Faça logon como root.

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

   • Em Debian:

     dpkg -l | grep nl
     

     A lista dos 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 os pacotes Adobe Campaign v6.02 ou v6.1.

1. Faça logon como root.

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

   • Em Debian:

     dpkg -l | grep nl
     

     A lista dos 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 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 Adobe Campaign v7: esta 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, aplique as seguintes etapas:

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

   É necessário 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á faltando. Isto é 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 corresponde ao usuário neolane. Faça logon como neolane e execute o seguinte comando:

   su - neolane
   vim ~/.bashrc
   

   OBSERVAÇÃO

   Quando você faz logon como neolane, a seguinte mensagem é exibida: nl5/env.sh : Esse arquivo ou diretório não existe. Isto é 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 Adobe Campaign v5. Para o arquivo serverConf.xml, use o arquivo nl5/conf/serverConf.xml.diff.

   OBSERVAÇÃO

   Quando as configurações de relatórios 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 nos servidores 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. Start 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). Neste caso, estamos usando o fuso horário Europa/Paris : "Europa/Paris".

   OBSERVAÇÃO

   Recomendamos que você atualize 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 Adobe Campaign v7: esta 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, aplique as seguintes etapas:

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

   É necessário 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 nos servidores 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. Start 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 "multifuso horário" 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. Recomendamos que você atualize 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 Adobe Campaign v7: esta 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, aplique as seguintes etapas:

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

   É necessário instalar os pacotes com êxito antes de passar para a próxima etapa.

   OBSERVAÇÃO

   O Adobe Campaign v7 está 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. Start 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)

Nessa fase, o Apache precisa ser parado. 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 arquivos nl5 por nl6. Para fazer isso no Debian, execute o seguinte comando:

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

Zonas de segurança

Se você estiver migrando da v6.02 ou versão anterior, é necessário configurar as zonas de segurança antes de iniciar os serviços. Para obter mais informações, consulte Security.

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

Serviços Apache e Adobe Campaign do start em cada um dos seguintes servidores:

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

Antes de passar 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 de 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>

Serviços Apache e Adobe Campaign do start 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

Serviços Apache e Adobe Campaign do start 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 é necessária.

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

su - neolane
rm -rf nl5.back

Restart o servidor.