Atualizar da Versão 8.5.x com Migração Manual

Esse procedimento aplica-se apenas a upgrades da versão 8.5.x do Plataforma de Marketing. O upgrade automático dessas versões não é suportado.

Consulte o Cenários de Upgrade do Plataforma de Marketing para obter informações sobre como atualizar a partir de outras versões.

Assegure que você possua o seguinte em um diretório.

O instalador principal do IBM®

O instalador do Plataforma de Marketing

Além disso, assegure que sua instalação do Plataforma de Marketing 8.x esteja totalmente funcional e que você possa executar as ferramentas de linha de comandos. Este procedimento requer o uso de três utilitários Plataforma de Marketing localizados no diretório tools/bin na instalação do Plataforma de Marketing. Informações completas sobre como usar estes utilitários, incluindo comandos de exemplo para tarefas comuns, estão disponíveis conforme a seguir.

O Utilitário populateDb

O Utilitário configTool

O Utilitário alertConfigTool

1.	Efetue login no IBM® EMM, navegue para a página Definições > Configuração e determine se uma propriedade nomeada Procura Periódica do DN Base do LDAP Ativada está presente na categoria Plataforma \| Segurança \| Detalhes do Método de Login \| Sincronização LDAP.

Você usará essas informações em uma etapa posterior.

2.	Faça um backup de seu banco de dados de tabela de sistema do Plataforma de Marketing.

Não ignore esta etapa. Se o upgrade falhar, você não poderá recuperar seu banco de dados e seus dados ficarão corrompidos.

3.	Remova a implementação de sua versão atual.

4.	Execute o instalador principal do IBM® .

O instalador principal do IBM® é iniciado. Siga estas diretrizes no instalador principal do IBM® .

Quando o instalador principal do IBM® solicitar que você insira as informações de conexão com o banco de dados do Plataforma de Marketing, insira as informações que pertencem às suas tabelas de sistema do Plataforma de Marketing atuais.

Quando o instalador principal IBM® solicitar que você escolha um diretório de instalação, escolha o diretório de instalação raiz, não o diretório de instalação do Plataforma de Marketing que está nesse diretório-raiz.

O instalador principal do IBM® pausará e ativará o instalador do Plataforma de Marketing.

5.	Siga estas diretrizes no instalador do Plataforma de Marketing.

Quando o instalador do Plataforma de Marketing solicitar um diretório de instalação, selecione o diretório de sua instalação atual do Plataforma de Marketing, geralmente denominada Plataforma.

Permita que o instalador faça backup de sua instalação anterior.

Selecione Configuração do Banco de Dados Manual.

Cancele a seleção da caixa de opção Executar Configuração da Plataforma.

Siga todas as etapas restantes no instalador do Plataforma de Marketing, inserindo todas as informações solicitadas.

6.	Após todos os instaladores serem concluídos, no diretório db\upgrade85to86 na instalação do Plataforma de Marketing, edite um script SQL, da seguinte maneira.

a.	O script SQL é ManagerSchema_DB_Type_86upg.sql, em que DB_Type é o tipo de banco de dados do banco de dados de tabelas do sistema

b.	Para todos os tipos de banco de dados, remova a instrução a seguir.

ALTER TABLE USCH_RUN ADD PAYLOAD NVARCHAR(4000);

c.	Se o banco de dados for DB2, também remova as instruções a seguir.

ALTER TABLE qrtz_job_details ALTER COLUMN job_data SET DATA TYPE blob(4000);

ALTER TABLE qrtz_triggers ALTER COLUMN job_data SET DATA TYPE blob(4000);

7.	Use a tabela apropriada abaixo para localizar os scripts SQL, fornecidos com a nova instalação do Plataforma de Marketing, com relação ao banco de dados de tabela do sistema do Plataforma de Marketing. Execute os scripts SQL na ordem mostrada.

Use esta Tabela se Estiver Atualizando da Versão 8.5.x
Nome do Script	Localização
ManagerSchema_DB_Type_86upg.sql, em que DB_Type é o tipo de banco de dados de seu banco de dados de tabelas de sistema	db\upgrade85to86
active_portlets.sql	db
ManagerSchema_DB_Type_90upg.sql, em que DB_Type é o tipo de banco de dados do banco de dados de tabelas do sistema.	db\upgrade86to90

8.	Execute o lote upgrade86to90 ou o shell script, localizado no diretório tools\bin\upgrade86to90 na instalação do Plataforma de Marketing.

9.	Use o utilitário populateDb para preencher as tabelas de sistema com as propriedades de configuração do Plataforma de Marketing padrão, usuários e grupos e funções de segurança e permissões.

Este utilitário está localizado no diretório tools/bin sob sua instalação do Plataforma de Marketing.

Exemplo: populateDb -n Manager

10.	Use o utilitário configTool para importar as propriedades de configuração, conforme descrito na tabela a seguir. Os exemplos de comandos são para um sistema Windows.

O utilitário configTool é localizado no diretório tools/bin na instalação do Plataforma de Marketing. Os exemplos de comandos são para um sistema Windows.

Os exemplos de comandos são para um sistema Windows.

Para obter detalhes completos sobre a função de propriedades de configuração, consulte a ajuda online na página Definições > Configuração ou o Guia do Admiministrador do IBM® Plataforma de Marketing.

Use esta Tabela se Estiver Atualizando de qualquer Versão 8.5.x

Nome do arquivo, local e propósito

Exemplo de comando

Ignore essa importação se a propriedade nomeada Procura Periódica LDAP BaseDN Ativada estiver presente na categoria Plataforma | Segurança | Detalhes do Método de Login | Sincronização LDAP. Esta é a propriedade verificada na etapa 1 desse procedimento.

Se a propriedade não estiver presente, execute a importação a seguir.

Arquivo: Ldap_Auto_Sync_BaseDN_Settings.xml

Local: diretório conf\upgrade86to90 na instalação do Plataforma de Marketing

Propósito: Importar uma propriedade de configuração que ativa a procura de importação LDAP por DN

configTool.bat -i -p "Affinium|suite|security|ldapSynchronization|ldapProperties" -f C:\Unica\Platform\conf\upgrade86to90\Ldap_Auto_Sync_BaseDN_Settings.xml

Arquivo: interaction_history_scheduler.xml

Local: diretório conf/upgrade85to86 na instalação do Plataforma de Marketing

Propósito: Importar as propriedades de configuração do planejador necessárias para Interaction History

configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations" -f C:\Unica\Platform\conf\upgrade85to86\interaction_history_scheduler.xml

Arquivo: attribution_modeler_scheduler.xml

Local: diretório conf/upgrade85to86 na instalação do Plataforma de Marketing

Propósito: Importar as propriedades de configuração do planejador necessárias para Modelador de Atribuição

configTool.bat -i -p "Affinium|suite|scheduler|taskRegistrations" -f C:\Unica\Platform\conf\upgrade85to86\attribution_modeler_scheduler.xml

Arquivos: coremetrics_configuration.xml e coremetrics_navigation.xml

Local: diretório conf na instalação do Plataforma de Marketing

Propósito: Importar as propriedades de configuração necessárias para a conexão única com IBM® Digital Analytics

configTool.bat -i -p "Affinium" -f C:\Unica\Platform\conf\coremetrics_configuration.xml

configTool.bat -i -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f C:\Unica\Platform\conf\coremetrics_navigation.xml

Arquivo: cognos10_modeler_integration.xml

Local: diretório conf/upgrade85to86 na instalação do Plataforma de Marketing

Propósito: Importar as propriedades de configuração necessárias para os relatórios

configTool.bat -i -p "Affinium|Report|integrations" -f C:\Unica\Platform\conf\upgrade85to86\cognos10_integration.xml

Arquivo: Nenhum arquivo - removendo propriedades

Propósito: Remover propriedades de configuração do JMS que não são mais usadas

configTool.bat -d -o -p "Affinium|suite|jmsServer"

configTool.bat -d -o -p "Affinium|suite|jmsPort"

Arquivo: LDAP_Anonymous_bind.xml

Local: diretório conf/upgrade85to86 na instalação do Plataforma de Marketing

Propósito: Apenas se você estiver atualizando da versão 8.2.0 ou posterior, importe uma nova propriedade de configuração LDAP

configTool.bat -d -o -p "Affinium|suite|jmsServer"

configTool.bat -d -o -p "Affinium|suite|jmsPort"

Arquivo: quicklinks_category.xml

Local: diretório conf\upgrade86to90 na instalação do Plataforma de Marketing

Propósito: Importar propriedades para portlets de painel de links rápidos

configTool.bat -i -o -p "Affinium|suite" -f C:\Unica\Platform\conf\upgrade86to90\quicklinks_category.xml

Arquivo: communication_email.xml

Local: diretório conf\upgrade86to90 na instalação do Plataforma de Marketing

Propósito: Importar propriedades de configuração para ativar notificações por email

configTool.bat -i -o -p "Affinium|Manager" -f C:\Unica\Platform\conf\upgrade86to90\communication_email.xml

Arquivo: notification.xml

Local: diretório conf\upgrade86to90 na instalação do Plataforma de Marketing

Propósito: Importar propriedades de configuração para o recurso de notificação

configTool.bat -i -o -p "Affinium|suite" -f C:\Unica\Platform\conf\upgrade86to90\notification.xml

Arquivo: manager_alerts_registration.xml

Local: diretório conf na instalação do Plataforma de Marketing

Propósito: Importar propriedades de configuração que criam os itens de menu de alertas

configTool.bat -i -o -p "Affinium|suite|uiNavigation|alerts -f C:\Unica\Platform\conf\manager_alerts_registration.xml

Arquivo: disablePageTagging.xml

Local: diretório conf\upgrade82to85 na instalação do Plataforma de Marketing

Propósito: Importar uma propriedade de configuração que determina se o IBM® pode reunir estatísticas de configuração básica que controlam tendências de uso geral do produto.

configTool.bat -i -o -p "Affinium|suite" -f C:\Unica\Platform\conf\upgrade82to85\disablePageTagging.xml

Arquivos: coremetrics_configuration.xml e coremetrics_navigation.xml

Local: diretório conf na instalação do Plataforma de Marketing

Propósito: Importar as propriedades de configuração necessárias para a conexão única com IBM® Digital Analytics

configTool.bat -i -o -p "Affinium" -f C:\Unica\Platform\conf\coremetrics_configuration.xml

configTool.bat -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f C:\Unica\Platform\conf\coremetrics_navigation.xml

11.	Use o utilitário alertConfigTool para registrar os alertas e as notificações do Plataforma de Marketing, da seguinte maneira.

O utilitário alertConfigTool é localizado no diretório tools\bin na instalação do Plataforma de Marketing.

Execute esse utilitário a partir do tools\bin directory. Você faz referência ao arquivo Platform_alerts_configuration.xml, localizado no diretório conf na instalação do Plataforma de Marketing.

Exemplo de comando (Windows): alertConfigTool.bat -i -f C:\Platform\conf\Platform_alerts_configuration.xml

12.	Para atualizar o painel, execute o script upgrade85Dashboard, localizado no diretório tools\bin na instalação do Plataforma de Marketing.

13.	Atualize a página Ajuda > Sobre da seguinte forma.

a.	Use o utilitário configTool para exportar a categoria Affinium \| Manager \| sobre (esta categoria não está visível na página Configuração, pois ela é marcada como oculta).

Exemplo (Windows™): configTool.bat -x -p "Affinium|Manager|about" –f C:\Unica\Platform\conf\about.xml

b.	Edite o arquivo XML exportado que acabou de criar (about.xml no exemplo) para alterar o número da versão e o nome de exibição da seguinte forma.

Localize a propriedade releaseNumber e altere o valor para a versão atual do Plataforma de Marketing. No exemplo a seguir, altere 8.0.0 para a nova versão.

<displayNameKey>about.releaseNumber</displayNameKey>

</property>

c.	Use o utilitário configTool para importar o arquivo revisado. Você deve usar a opção –o para sobrescrever o nó. Lembre-se que você deve especificar o nó-pai quando importar.

Exemplo (Windows™): configTool.bat –i –p “Affinium|Manager” –f “about.xml” -o

14.	Implemente e verifique sua instalação conforme descrito no capítulo Implementando o IBM Plataforma de Marketing.

Após atualizar os aplicativos IBM® EMM, consulte o Guia de Instalação e Configuração do IBM® EMM Reports para obter etapas adicionais necessárias para upgrades de relatórios.