Fazendo Upgrade a Partir da Versão 8.2.0.7 e Versões 8.2.x com Migração Manual
O instalador de upgrade do Marketing Platform pode executar toda a migração de dados necessária para um upgrade, automaticamente. No entanto, se a política de sua organização não permitir a migração automática, você deverá concluir o procedimento de migração para fazer upgrade do Marketing Platform manualmente. Para fazer upgrade para o Marketing Platform versão 9.1 manualmente, você deve executar scripts SQL específicos e inserir as propriedades de configuração necessárias.
Assegure-se de que tenha os instaladores a seguir no mesmo diretório:
*
O instalador principal do IBM®
*
O instalador do Marketing Platform
Além disso, assegure-se de que a instalação do Marketing Platform 8.x seja totalmente funcional e de que seja possível executar as ferramentas de linha de comandos. A execução das ferramentas de linha de comandos requer o uso de três utilitários do Marketing Platform que estão no diretório tools/bin na instalação do Marketing Platform. Informações completas sobre como usar esses utilitários, incluindo exemplo de comandos para tarefas comuns estão disponíveis nos tópicos a seguir:
*
O Utilitário populateDb
*
O Utilitário ConfigTool
*
O Utilitário alertConfigTool
Consulte o Cenários de Upgrade do Marketing Platform para obter informações sobre como atualizar a partir de outras versões.
1.
Conclua as etapas a seguir para fazer upgrade manualmente a partir da versão 8.5.0:
2.
Faça um backup de seu banco de dados de tabela de sistema do Marketing Platform.
*
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® EMM.
O instalador principal do IBM® EMM é iniciado. Use as instruções a seguir após o instalador principal do IBM® EMM ser iniciado:
*
Quando o instalador principal do IBM® EMM 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 Marketing Platform que está nesse diretório-raiz.
*
Quando o instalador principal do IBM® EMM solicitar que você insira as informações de conexão com o banco de dados do Marketing Platform, insira as informações que pertencem às suas tabelas de sistema do Marketing Platform atuais.
O instalador principal do IBM® EMM pausa e inicia o instalador do Marketing Platform.
5.
Conclua as etapas a seguir, enquanto o instalador do Marketing Platform estiver em execução:
a.
Quando o instalador do Marketing Platform solicitar um diretório de instalação, selecione o diretório de sua instalação atual do Marketing Platform, geralmente denominada Plataforma.
b.
Permita que o instalador crie uma cópia de backup da instalação anterior do Marketing Platform.
c.
Selecione Configuração do Banco de Dados Manual.
d.
Limpe a caixa de seleção Executar configuração da plataforma.
e.
Siga as etapas restantes no assistente de instalação e insira as informações solicitadas.
6.
Use o utilitário configTool para concluir as etapas a seguir para assegurar que os scripts SQL que você executa na etapa 7 funcionem corretamente:
a.
Exporte todas as propriedades de configuração do nó raiz Affinium. Por exemplo, no Windows™, use o comando a seguir para exportar as propriedades para o arquivo config_property_export.xml, que é gravado no diretório de instalação na instalação do Marketing Platform:
configTool.bat -x -p "Affinium" -f "C:\Unica\Platform\install\ config_property_export.xml"
b.
Exclua todas as propriedades de configuração do nó raiz Affinium. Por exemplo, no Windows™, use o comando a seguir para excluir as propriedades:
configTool.bat -d -o -p "Affinium"
c.
Importe as propriedades de configuração que você exportou. Por exemplo, no Windows™, use o comando a seguir para importar as propriedades do arquivo config_property_export.xml, que está no diretório de instalação na instalação do Marketing Platform:
configTool.bat -i -o -f "C:\Unica\Platform\install\ config_property_export.xml"
7.
No diretório db\upgrade82to85 na instalação do Marketing Platform, edite 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. Use as diretrizes a seguir para editar o script SQL ManagerSchema_DB_Type_86upg.sql:
*
Para todos os tipos de banco de dados, remova a instrução a seguir:
ALTER TABLE USCH_RUN ADD PAYLOAD NVARCHAR(4000);
*
Se o banco de dados for DB2®, remova também 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);
8.
Use a tabela a seguir para localizar os scripts SQL que são fornecidos com a nova instalação do Marketing Platform com relação ao banco de dados de tabelas do sistema do Marketing Platform:
Scripts para Fazer Upgrade da Versão 8.2.0.7 ou de uma Versão Posterior 8.2.x
Nome do Script
Localização
ManagerSchema_DB_Type_85upg.sql
em que DB_Type é o tipo de banco de dados do banco de dados de tabelas do sistema.
db\upgrade8207xto85
insert_new_85_locales.sql
db\upgrade82to85
ManagerSchema_DB_Type_86upg.sql
em que DB_Type é o tipo de banco de dados do banco de dados de tabelas do sistema.
db\upgrade85to86
insert_new_8601_locales.sql
db\upgrade86to8601
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
ManagerSchema_DB_Type_91upg.sql
ou
ManagerSchema_DB_Type_91upg_unicode.sql
em que DB_Type é o tipo de banco de dados do banco de dados de tabelas do sistema.
db\upgrade90to91
9.
Execute um dos comandos a seguir:
*
Para Windows™:
installation_directory\platform\tools\bin\upgrade90to91.bat
*
Para Unix:
installation_directoryplatform/tools/bin/upgrade90to91.sh
10.
Use o utilitário populateDb para preencher as tabelas de sistema com as propriedades de configuração do Marketing Platform padrão, usuários e grupos e funções de segurança e permissões.
O utilitário populateDb encontra-se no diretório tools/bin na instalação do Marketing Platform.
Exemplo: populateDb -n Manager
11.
Use o utilitário configTool para importar as propriedades de configuração conforme descrito na tabela a seguir:
*
O utilitário configTool encontra-se no diretório tools/bin na instalação do Marketing Platform. Para obter detalhes completos sobre a função das propriedades de configuração, consulte a ajuda online para obter a página Configuração, ou o Guia do Administrador do IBM® Marketing Platform
O exemplo de comandos na tabela a seguir destinam-se ao sistema operacional Windows™.
Arquivos para Fazer Upgrade da Versão 8.2.0.7 ou de uma Versão Posterior 8.2.x
Detalhes do arquivo
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 Marketing Platform
*
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: conf/upgrade85to86rectory na instalação do Marketing Platform
*
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 Marketing Platform
*
Propósito: Importar as propriedades de configuração do planejador necessárias para Attribution Modeler
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 Marketing Platform
*
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 Marketing Platform
*
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 Marketing Platform
*
Propósito: Apenas se você estiver atualizando da versão 8.2.0 ou posterior, importe uma nova propriedade de configuração LDAP
configTool -i -p "Affinium|suite|security|loginModes|LDAPPartitionLogin" -f C:\Unica\Platform\conf\upgrade85to86\LDAP_Anonymous_bind.xml
*
Arquivo: quicklinks_category.xml
*
Local: diretório conf\upgrade86to90 na instalação do Marketing Platform
*
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: manager_alerts_registration.xml
*
Local: diretório conf na instalação do Marketing Platform
*
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 Marketing Platform
*
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 Marketing Platform
*
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"
*
Arquivo: scheduler.xml
*
Local: diretório db\upgrade90to91 na instalação do Marketing Platform
*
Propósito: A propriedade booleana para ativar ou desativar o recurso do planejador no Marketing Platform
configtool -i -p "Affinium|suite|scheduler" -f "C:\Unica\Platform\conf\upgrade90to91\scheduler.xml"
*
Arquivo: unknownPolling.xml
*
Local: diretório db\upgrade90to91 na instalação do Marketing Platform
*
Propósito: Importa propriedades para portlets de painel de links rápidos
configtool -i -p "Affinium|suite|scheduler" -f "C:\Unica\Platform\conf\upgrade90to91\unknownPolling.xml"
*
Arquivo: communication_email.xml
*
Local: diretório conf\upgrade86to90 na instalação do Marketing Platform
*
Propósito: Importa propriedades de configuração para ativar notificações por email. Quando ativado, o Marketing Platform tenta enviar emails aos usuários para alertas e notificações do sistema.
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 Marketing Platform
*
Propósito: Importa propriedades de configuração para o recurso de notificação. As propriedades a seguir são incluídas:
*
O número de dias para reter alertas – 90
*
Frequência em minutos em que e-mails são enviados – 30
*
Número máximo de novas tentativas para envio e email 1 –
configTool.bat -i -o -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade86to90\notification.xml"
*
Arquivo: is_clustered.xml
*
Local: diretório conf\upgrade86to90 na instalação do Marketing Platform
*
Propósito: A propriedade booleana para especificar se a instância do Marketing Platform está em cluster . Se você instalar o Marketing Platform em uma implementação em cluster, configure essa propriedade como True. Caso contrário, retenha o valor padrão de False.
configtool -i -p "Affinium|suite" -f "C:\Unica\Platform\conf\upgrade90to91\is_clustered.xml"
*
Arquivo: taskNotification.xml
*
Local: diretório conf\upgrade86to90 na instalação do Marketing Platform
*
Propósito: Importa o campo Nome do Grupo onde é possível inserir os grupos que são notificados com notificações planejadas.
configtool -i -p "Affinium|suite|scheduler|taskRegistrations|Campaign|flowchart" -f "C:\Unica\Platform\conf\upgrade90to91\taskNotification.xml"
configtool -i -p "Affinium|suite|scheduler|taskRegistrations|Campaign|mailing" -f "C:\Unica\Platform\conf\upgrade90to91\taskNotification.xml"
configtool -i -p "Affinium|suite|scheduler|taskRegistrations|Campaign|optimize" -f "C:\Unica\Platform\conf\upgrade90to91\taskNotification.xml"
configtool -i -p "Affinium|suite|scheduler|taskRegistrations|InteractionHistory|ETL" -f "C:\Unica\Platform\conf\upgrade90to91\taskNotification.xml"
configtool -i -p "Affinium|suite|scheduler|taskRegistrations|AttributionModeler|TrainingRun" -f "C:\Unica\Platform\conf\upgrade90to91\taskNotification.xml"
configtool -i -p "Affinium|suite|scheduler|taskRegistrations|AttributionModeler|ScoringRun" -f "C:\Unica\Platform\conf\upgrade90to91\taskNotification.xml"
*
Arquivo: config_data_filter_cache.xml
*
Local: diretório conf\upgrade90to91 na instalação do Marketing Platform
*
Propósito: Permite que você configure o cache de filtro de dados. Se a propriedade de configuração estiver configurada como True, o cache de filtro de dados será ativado para desempenho aprimorado. Se a propriedade de configuração estiver configurada como False, o armazenamento em cache não será ativado, e todas as operações serão concluídas conectando-se ao banco de dados para cada solicitação de filtro de dados. A propriedade de configuração é visível na interface com o usuário.
configTool.bat -vp -p "Affinium|Manager|datafiltering" -f "C:\Unica\Platform\conf\upgrade90to91\Config_data_filter_cache.xml"
*
Se você alterar esse valor, deverá reiniciar o Marketing Platform para que as mudanças entrem em vigor.
*
Arquivo: Refresh_data_filter_cache.xml
*
Local: diretório conf\upgrade90to91 na instalação do Marketing Platform
*
Propósito: Se o armazenamento em cache de filtro de dados estiver ativado, essa propriedade de configuração assegurará que o cache seja atualizado cada vez que houver uma mudança nas definições de filtro de dados.
configTool.bat -vp -p "Affinium|Manager|datafiltering" -f "C:\Unica\Platform\conf\upgrade90to91\Refresh_data_filter_cache.xml"
*
Arquivos: navigation.xml e emm_spss_configuration.xml
*
Local: conf\upgrade90to91
*
Propósito: Importar propriedades de configuração do IBM® SPSS® Modeler Advantage Marketing Edition.
configTool -i -o -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\emm_spss_navigation.xml"
configTool -i -o -p "Affinium" -f "C:\Unica\Platform\conf\emm_spss_configuration.xml"
12.
Execute o utilitário alertConfigTool a partir do diretório tools\bin na instalação do Marketing Platform para registrar alertas e notificações do Marketing Platform.
Exemplo de comando (Windows™):
alertConfigTool.bat -i -f "C:\Platform\conf\Platform_alerts_configuration.xml"
13.
Execute o script upgrade85Dashboard a partir do diretório tools\bin na instalação do Marketing Platform para fazer upgrade do painel.
14.
Acesse Ajuda > Sobre e conclua as etapas a seguir para atualizar a página Sobre:
a.
Use o utilitário configTool para exportar a categoria Affinium | Gerenciador | sobre.
*
A categoria Affinium | Gerenciador | sobre não está visível na página Configuração porque está 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 você acabou de criar (about.xml no exemplo) para alterar o número da versão e o nome de exibição. Localize a propriedade releaseNumber e altere o valor para a versão atual do Marketing Platform.
No exemplo a seguir, altere 8.0.0 para a nova versão:
<property name="releaseNumber" type="string">
<displayNameKey>about.releaseNumber</displayNameKey>
<value>9.1.0.0.0.build_number</value>
</property>
c.
Use o utilitário configTool para importar o arquivo revisado. Você deve usar a opção -o para sobrescrever o nó. Você deve especificar o nó-pai quando importar.
Exemplo (Windows™):
configTool.bat -i -p "Affinium|Manager" -f "about.xml" -o
15.
Implemente e verifique sua instalação, conforme descrito no capítulo Implementando o Marketing Platform.
Após o processo de upgrade ser bem-sucedido e o aplicativo estiver ativo e em execução, exclua as tabelas liferay usando o script drop-liferay-tables.sql. O script drop-liferay-tables.sql está localizado no diretório Platform_installation/db/upgrade86to90/drop-liferay-tables.sql.
Consulte o Guia de Instalação e Configuração do IBM® EMM Reports para obter as etapas adicionais necessárias para upgrades de relatórios.
Copyright IBM Corporation 2014. All Rights Reserved.