IBM Marketing Platform Versão 9 Release 1 25 de outubro de Guia de Upgrade

(1)

IBM Marketing Platform

Versão 9 Release 1

25 de outubro de 2013

Guia de Upgrade

(2)

Observação

(3)

Índice

Capítulo 1. Visão Geral do Upgrade . . . 1

Roteiro de Upgrade . . . 1

Como os Instaladores Funcionam . . . 2

Modos de Instalação . . . 3

Arquivos de Resposta de Amostra . . . 3

Documentação e Ajuda do Marketing Platform . . . 4

Capítulo 2. Planejando o Upgrade do

Marketing Platform . . . 7

Pré-requisitos . . . 7

Planilha de Instalação do Marketing Platform . . . 8

Pré-requisitos de Upgrade para Todos os Produtos do IBM EMM. . . 10

Requisito de Confirmação Automática para Oracle ou DB2 . . . 11

Mudança nos Nomes de Grupos e Funções Definidos pelo Usuário . . . 11

Suporte de Fuso Horário para o Planejador . . . . 11

Portlets do Painel do IBM Digital Analytics. . . 12

Fazendo Backup do Arquivo corporatetheme.css e das Imagens de Marca. . . 12

Cenários de Upgrade do Marketing Platform . . . 13

Capítulo 3. Fazendo Upgrade a Partir

da Versão 8.x com Migração

Automática . . . 15

Capítulo 4. Fazendo Upgrade da Versão

8.0.x, 8.1.x ou 8.2.x Anterior à Versão

8.2.0.7 com Migração Manual . . . 17

Capítulo 5. Fazendo Upgrade a Partir

da Versão 8.2.0.7 e Versões 8.2.x com

Migração Manual . . . 27

Capítulo 6. Fazendo Upgrade a Partir

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

Capítulo 7. Fazendo Upgrade a Partir

da Versão 8.6.x com Migração Manual . 43

Capítulo 8. Fazendo Upgrade a Partir

da Versão 9.x com Migração Manual . . 49

Capítulo 9. Implementando o Marketing

Platform . . . 55

Diretrizes para Implementar o Marketing Platform no WebLogic . . . 55

Diretrizes para Implementar o Marketing Platform no WebSphere . . . 56

Verificando a Instalação do Marketing Platform . . 58

Capítulo 10. Configurando o Marketing

Platform após a Implementação . . . . 59

Configurações Padrão de Senha . . . 59

Capítulo 11. Utilitários do IBM

Marketing Platform e Scripts SQL . . . 61

Configurando Utilitários do Marketing Platform em Máquinas Adicionais . . . 63

Utilitários do Marketing Platform . . . 63

alertConfigTool . . . 63 configTool . . . 64 datafilteringScriptTool . . . 68 encryptPasswords . . . 70 partitionTool . . . 71 populateDb . . . 73 restoreAccess . . . 74 scheduler_console_client . . . 75

Capítulo 12. Scripts SQL do Marketing

Platform . . . 79

ManagerSchema_DeleteAll.sql . . . 79

ManagerSchema_PurgeDataFiltering.sql . . . 79

Scripts SQL para Criar Tabelas de Sistema . . . . 80

ManagerSchema_DropAll.sql . . . 81

Capítulo 13. Desinstalando o Marketing

Platform . . . 83

Entrando em Contato com o Suporte

Técnico do IBM . . . 85

Avisos . . . 87

Marcas Registradas . . . 89

Considerações sobre Política de Privacidade e Termos de Uso . . . 89

(4)

(5)

Capítulo 1. Visão Geral do Upgrade

Um upgrade do Marketing Platform será concluído quando você fizer upgrade, configurar e implementar o Marketing Platform. O Guia de Upgrade do Marketing Platform fornece informações detalhadas sobre como fazer upgrade, configurar e implementar o Marketing Platform.

Use a seção Roteiro de Upgrade, para obter um amplo entendimento sobre como usar o Guia de Upgrade do Marketing Platform.

Roteiro de Upgrade

Use o roteiro de upgrade para localizar rapidamente as informações necessárias para a instalação do Marketing Platform.

É possível usar o Tabela 1 para varrer as tarefas que devem ser concluídas para instalar o Marketing Platform:

Tabela 1. Roteiro de Upgrade do Marketing Platform

Tópico Informações

Capítulo 1, “Visão Geral do Upgrade” Este tópico fornece as informações a seguir: v _{“Como os Instaladores Funcionam” na}

página 2

v _{“Modos de Instalação” na página 3} v _{“Documentação e Ajuda do Marketing}

Platform” na página 4 Capítulo 2, “Planejando o Upgrade do

Marketing Platform”, na página 7

Este tópico fornece as informações a seguir: v _{“Pré-requisitos” na página 7}

v _{“Planilha de Instalação do Marketing} Platform” na página 8

v _{“Pré-requisitos de Upgrade para Todos os} Produtos do IBM EMM” na página 10 v _{“Suporte de Fuso Horário para o}

Planejador” na página 11 v _{“Fazendo Backup do Arquivo}

corporatetheme.css e das Imagens de Marca” na página 12

v _{“Cenários de Upgrade do Marketing} Platform” na página 13

Capítulo 3, “Fazendo Upgrade a Partir da Versão 8.x com Migração Automática”, na página 15

Leia mais sobre como fazer upgrade do Marketing Platform da versão 8.x com migração automática.

Capítulo 4, “Fazendo Upgrade da Versão 8.0.x, 8.1.x ou 8.2.x Anterior à Versão 8.2.0.7 com Migração Manual”, na página 17

Leia mais sobre como fazer upgrade do Marketing Platform das versões 8.0.x, 8.1.x ou 8.2.x anteriores à versão 8.2.0.7 com migração manual.

Capítulo 5, “Fazendo Upgrade a Partir da Versão 8.2.0.7 e Versões 8.2.x com Migração Manual”, na página 27

Leia mais sobre como fazer upgrade do Marketing Platform das versões 8.0.x, 8.1.x ou 8.2.x anteriores à versão 8.2.0.7 com migração manual.

(6)

Tabela 1. Roteiro de Upgrade do Marketing Platform (continuação)

Tópico Informações

Capítulo 6, “Fazendo Upgrade a Partir da Versão 8.5.x com Migração Manual”, na página 35

Leia mais sobre como fazer upgrade do Marketing Platform da versão 8.5.x com migração manual.

Capítulo 7, “Fazendo Upgrade a Partir da Versão 8.6.x com Migração Manual”, na página 43

Leia mais sobre como fazer upgrade do Marketing Platform a partir da versão 8.6.x com migração manual.

Capítulo 8, “Fazendo Upgrade a Partir da Versão 9.x com Migração Manual”, na página 49

Leia mais sobre como fazer upgrade do Marketing Platform a partir da versão 9.x com migração manual.

Capítulo 9, “Implementando o Marketing Platform”, na página 55

Este tópico fornece as informações a seguir: v _{“Diretrizes para Implementar o Marketing}

Platform no WebLogic” na página 55 v _{“Diretrizes para Implementar o Marketing}

Platform no WebSphere” na página 56 v _{“Verificando a Instalação do Marketing}

Platform” na página 58 Capítulo 10, “Configurando o Marketing

Platform após a Implementação”, na página 59

Este tópico fornece as informações a seguir: v _{“Configurações Padrão de Senha” na}

página 59 Capítulo 11, “Utilitários do IBM Marketing

Platform e Scripts SQL”, na página 61

Este tópico fornece as informações a seguir: v _{“Configurando Utilitários do Marketing}

Platform em Máquinas Adicionais” na página 63 v _{“alertConfigTool” na página 63} v _{“configTool” na página 64} v _{“datafilteringScriptTool” na página 68} v _{“encryptPasswords” na página 70} v _{“partitionTool” na página 71} v _{“populateDb” na página 73} v _{“restoreAccess” na página 74} v _{“scheduler_console_client” na página 75} Capítulo 12, “Scripts SQL do Marketing

Platform”, na página 79

Este tópico fornece as informações a seguir: v _{“ManagerSchema_DeleteAll.sql” na}

página 79

v _{“ManagerSchema_PurgeDataFiltering.sql”} na página 79

v _{“Scripts SQL para Criar Tabelas de} Sistema” na página 80

v _{“ManagerSchema_DropAll.sql” na página} 81.

Capítulo 13, “Desinstalando o Marketing Platform”, na página 83

Este tópico fornece informações sobre como desinstalar o Marketing Platform.

Como os Instaladores Funcionam

Use o instalador do IBM®_{EMM com os instaladore Marketing Platform ao instalar} o Marketing Platform.

(7)

O instalador do conjunto do IBM EMM inicia os instaladores do produto individual durante o processo de instalação.

Use as diretrizes a seguir para instalar o Marketing Platform:

v _{Certifique-se de que o instalador do IBM EMM e o instalador do Marketing} Platform estejam no mesmo diretório no servidor em que você deseja instalar o Marketing Platform. Quando diversas versões do instalador do Marketing Platform estiverem presentes no diretório com o instalador do IBM EMM, o instalador do IBM EMM mostrará a versão mais recente do Marketing Platform na tela Produtos IBM EMM no assistente de instalação.

v _{Se você estiver planejando instalar uma correção imediatamente após instalar o} Marketing Platform, certifique-se de que o instalador de correção esteja no mesmo diretório que o IBM EMM e o instalador do Marketing Platform.

Por padrão, o IBM EMM é instalado em um dos diretórios a seguir: v _/IBM/EMM_{(para UNIX)}

v _C:\IBM\EMM_{(para Windows)}

Por padrão, os produtos IBM EMM são instalados em um subdiretório do diretório

IBMEMM_Home. Por exemplo, Marketing Platform é instalada no diretório IBMEMM_Home/Platform.

No entanto, é possível alterar os diretórios durante a instalação.

Modos de Instalação

O instalador do conjunto IBM EMM pode ser executado em um dos modos a seguir: modo de GUI, modo do console ou modo silencioso (também chamado modo não assistido). Selecione um modo que seja adequado aos seus requisitos ao instalar o Marketing Platform.

Modo de GUI Modo de

Use o modo de GUI para Windows ou o modo X Window System para UNIX para instalar o Marketing Platform usando a interface gráfica com o usuário.

Modo do Console

Use o modo do console para instalar o Marketing Platform usando a janela de linha de comandos.

Nota: Para exibir as telas do Instalador corretamente no modo do console, configure o software de terminal para suportar a codificação de caractere UTF-8. Outra codificação de caractere, tal como ANSI, não renderizará o texto

corretamente, e algumas informações não serão legíveis.

Modo Silencioso

Use modo silencioso ou não assistido para instalar o Marketing Platform diversas vezes. O modo silencioso usa arquivos de resposta para instalação, e não requer entrada do usuário durante o processo de instalação.

Arquivos de Resposta de Amostra

Você deve criar arquivos de resposta para configurar uma instalação silenciosa do Marketing Platform. É possível usar arquivos de resposta de amostra para criar

(8)

arquivos de resposta. Os arquivos de resposta de amostra são incluídos com os instaladores no archive compactado ResponseFiles.

A tabela a seguir fornece informações sobre os arquivos de resposta de amostra:

Tabela 2. Descrição de Arquivos de Resposta de Amostra

Arquivo de resposta de amostra Descrição

installer.properties O arquivo de resposta de amostra para o instalador principal do IBM EMM. installer_product intials and product

version number.properties

O arquivo de resposta de amostra para o instalador do Marketing Platform. Por exemplo,

installer_umpn.n.n.n.propertiesé o arquivo de resposta do instalador do Marketing Platform, em que n.n.n.n é o número da versão.

installer_report pack initials, product

initials, and version number.properties

O arquivo de resposta de amostra para o instalador do pacote de relatórios.

Por exemplo, installer_urpc.properties é o arquivo de resposta do instalador do pacote de relatórios do Campaign.

Documentação e Ajuda do Marketing Platform

O IBM Marketing Platform fornece documentação e ajuda para usuários, administradores e desenvolvedores.

Tabela 3. Implementar e Executar

Tarefa Documentação

Visualizar uma lista de novos recursos, problemas conhecidos e soluções alternativas

IBM Marketing Platform Notas sobre a Liberação

Saber sobre a estrutura do banco de dados Marketing Platform

Tabelas de Sistema de IBM Marketing Platform

Instalar ou fazer upgrade do Marketing Platform e implementar o aplicativo da web do Marketing Platform

Um dos guias a seguir:

v _{Guia de Instalação do IBM Marketing Platform} v _{Guia de Upgrade do IBM Marketing Platform} Implementar os relatórios do IBM Cognos fornecidos

com o Marketing Platform

Guia de Instalação e Configuração do IBM EMM Reports

Tabela 4. Configurar e Usar o Marketing Platform

Tarefa Documentação

v _{Ajustar a configuração e as configurações de segurança} v _{Preparar o Marketing Platform para usuários}

v _{Executar os utilitários e a manutenção}

(9)

Tabela 5. Obter Ajuda

Tarefa Instruções

Abrir a ajuda online _1. _{Escolha Ajuda > Ajuda para esta página para abrir} um tópico da ajuda contextual.

2. Clique no ícone Mostrar Navegação na janela de ajuda para exibir a ajuda integral.

Obter PDFs Use um dos métodos a seguir:

v _{Escolha Ajuda > Documentação do Produto para} acessar PDFs e ajuda do Marketing Platform.

v _{Escolha Ajuda > Toda a Documentação do Conjunto} IBM EMMpara acessar toda a documentação disponível.

Obter suporte Acesse http://www.ibm.com/support para acessar o IBM Support Portal.

(10)

(11)

Capítulo 2. Planejando o Upgrade do Marketing Platform

É possível fazer upgrade da versão atual do Marketing Platform para torná-lo atualizado com os recursos mais recentes.

Pré-requisitos

Antes de instalar ou fazer upgrade de qualquer produto IBM EMM, você deve assegurar que seu computador esteja em conformidade com todo o hardware e software obrigatórios.

Requisitos do Sistema

Para obter informações sobre os requisitos do sistema, consulte o guia Ambientes de

Software Recomendados e Requisitos Mínimos do Sistema.

Requisitos do Domínio de Rede

Os produtos IBM EMM que são instalados como um conjunto devem ser instalados no mesmo domínio de rede para cumprir com as restrições do

navegador, projetadas para limitar os riscos de segurança que podem ocorrer com o cross-site scripting.

Requisitos da JVM

Os aplicativos IBM EMM dentro de um conjunto devem ser implementados em uma Java™_{virtual machine (JVM) dedicada. Os produtos IBM EMM customizam a} JVM usada pelo servidor de aplicativos da web. Se você encontrar erros

relacionados à JVM, deverá criar um domínio do Oracle WebLogic ou do WebSphere que seja dedicado aos produtos IBM EMM.

Requisitos de Conhecimento

Para instalar os produtos IBM EMM, você deve ter um conhecimento profundo do ambiente no qual os produtos são instalados. Esse conhecimento inclui

conhecimento sobre sistemas operacionais, bancos de dados e servidores de aplicativos da web.

Configurações do Navegador da Internet

Certifique-se de que seu navegador da Internet esteja em conformidade com as configurações a seguir:

v _{O navegador não deve armazenar em cache as páginas da web.} v _{O navegador não deve bloquear janelas pop-up.}

Permissões de Acesso

Verifique se você possui as seguintes permissões da rede para concluir as tarefas de instalação:

(12)

v _{Acesso de leitura e gravação para o diretório e subdiretórios relevantes para a} conta do sistema operacional, usada para executar o servidor de aplicativos da web e os componentes do IBM EMM

v _{Permissão de gravação para todos os arquivos que você deve editar} v _{Permissão de gravação para todos os diretórios onde você deve salvar um}

arquivo, como o diretório de instalação e o diretório de backup, se estiver fazendo upgrade

v _{Permissões apropriadas de leitura/gravação/execução para executar o instalador}

Verifique se possui a senha administrativa para o servidor de aplicativos da web.

Para UNIX, todos os arquivos do instalador para produtos IBM devem ter permissões integrais, por exemplo, rwxr-xr-x.

Variável de Ambiente JAVA_HOME

Se uma variável de ambiente JAVA_HOME for definida no computador no qual um produto IBM EMM está instalado, verifique se a variável aponta para uma versão suportada do JRE. Para obter informações sobre os requisitos do sistema, consulte o guia Ambientes de Software Recomendados e Requisitos Mínimos do Sistema.

Certifique-se de que a variável de ambiente JAVA_HOME aponta para o JRE 1.6. Se a variável de ambiente JAVA_HOME apontar para um JRE incorreto, você deverá limpar a variável JAVA_HOME antes de executar os instaladores do IBM EMM.

É possível limpar a variável de ambiente JAVA_HOME usando um dos métodos a seguir:

v _{Windows: em uma janela de comando, digite set JAVA_HOME= (deixar vazio) e} pressione Enter.

v _{UNIX: no terminal, digite export JAVA_HOME= (deixar vazio) e pressione Enter.}

export JAVA_HOME= (deixar vazio)

Após a variável de ambiente ser limpa, os instaladores do IBM EMM usarão o JRE que é empacotado com os instaladores. É possível reconfigurar a variável de ambiente após a conclusão da instalação.

Planilha de Instalação do Marketing Platform

Use a planilha de instalação do Marketing Platform para reunir informações sobre o banco de dados do Marketing Platform e sobre outros produtos IBM EMM, necessários para a instalação do Marketing Platform.

Use a tabela a seguir para reunir informações sobre o banco de dados que contém as tabelas de sistema do Marketing Platform:

Tabela 6. Informações sobre o Banco de Dados

Campo Notes

Tipo de banco de dados Nome do banco de dados

Nome de usuário de conta de banco de dados

(13)

Tabela 6. Informações sobre o Banco de Dados (continuação)

Campo Notes

Nome JNDI UnicaPlatformDS

Nome ODBC

Lista de Verificação para o Banco de Dados IBM Marketing

Platform

Os assistentes de instalação para cada produto IBM EMM devem poder se comunicar com o banco de dados de tabelas do sistema do Marketing Platform para registrar o produto. Cada vez que você executar o instalador, deverá inserir as informações de conexão do banco de dados a seguir para o banco de dados de tabelas do sistema do Marketing Platform:

v _{Tipo de banco de dados} v _{URL de conexão JDBC}

v _{Nome de host do banco de dados} v _{Porta do banco de dados}

v _{Nome do banco de dados ou ID do esquema}

v _{Nome de usuário e senha para a conta do banco de dados}

Lista de Verificação para a Implementação do IBM Marketing

Platform no Servidor de Aplicativos da Web

Obtenha as informações a seguir antes de implementar o Marketing Platform: v _{Protocolo: HTTP ou HTTPS se SSL for implementado no servidor de aplicativos}

da web.

v _{Host: O nome da máquina na qual o Marketing Platform será implementado.} v _{Porta: A porta na qual o servidor de aplicativos da web atende.}

v _{Nome de domínio: O domínio da empresa de cada máquina na qual}

produtosIBM são instalados. Por exemplo, mycompany.com. Todos os produtos IBM devem ser instalados no mesmo domínio da empresa e você deve inserir o nome de domínio todo em letras minúsculas.

Se há uma incompatibilidade nas entradas de nome de domínio, você poderá encontrar problemas quando tentar usar recursos do Marketing Platform ou navegar entre produtos. É possível alterar o nome de domínio após os produtos serem implementados efetuando login e alterando valores das propriedades de configuração relevantes nas categorias de navegação do produto na página

Definição > Configuração.

Lista de Verificação para Ativar os Utilitários do Marketing

Platform

Se planeja usar os utilitários do Marketing Platform, obtenha as informações de conexão JDBC a seguir antes de começar a instalar o Marketing Platform.

v _{Caminho para o JRE. O valor padrão é o caminho para a versão 1.7 do JRE que} o instalador coloca no diretório de instalação do IBM .

É possível aceitar este padrão ou especificar um caminho diferente. Se você especificar um caminho diferente, deverá apontar para a versão 1.7 do Sun JRE. v _{Classe do driver JDBC. O instalador fornece isto automaticamente, com base no}

(14)

v _{URL da conexão JDBC. O instalador fornece a sintaxe básica, incluindo o nome} do host, o nome do banco de dados e a porta. É possível customizar a URL incluindo parâmetros adicionais.

v _{Caminho de classe do driver JDBC em seu sistema.}

Informações sobre o Componente da Web

Obtenha as informações a seguir para todos os produtos IBM EMM que possuem um componente da web que você implementa em um servidor de aplicativos da web:

v _{Os nomes dos sistemas nos quais os servidores de aplicativos da web são} instalados. É possível ter um ou vários servidores de aplicativos da web, dependendo do ambiente do IBM EMM que está sendo configurado.

v _{A porta na qual o servidor de aplicativos atende. Se você planejar implementar} SSL, obtenha a porta SSL.

v _{O domínio de rede para o sistema de implementação. Por exemplo,} mycompany.com.

ID do Site IBM

Se você estiver instalando um produto IBM EMM em um dos países listados na tela País para Instalação do instalador do produto, deverá inserir seu ID do Site da IBM no espaço fornecido. O ID do Site da IBM pode ser localizado em um dos documentos a seguir:

v _{Carta de Boas-vindas da IBM}

v _{Carta de Boas-vindas ao Suporte de Tecnologia} v _{Carta de Prova de Titularidade}

v _{Outras comunicações que são enviadas ao comprar o software}

A IBM pode usar os dados fornecidos pelo software instalado para entender melhor como os clientes usam nossos produtos e para melhorar o suporte ao cliente. Os dados reunidos não incluem nenhuma informação que identifica indivíduos. Conclua as ações a seguir, se não desejar ter tais informações a serem coletadas:

1. Após a instalação do Marketing Platform, efetue logon no Marketing Platform como um usuário com privilégios de administração.

2. Acesse Definição > Configuração, e configure a propriedade Desativar Tag de

Páginana categoria Plataforma como Verdadeira.

Pré-requisitos de Upgrade para Todos os Produtos do IBM EMM

Atenda corretamente a todos os requisitos para permissões, sistema operacional e conhecimento, antes de fazer upgrade do Marketing Platform para assegurar uma experiência de upgrade contínuo.

Removendo Arquivos de Resposta Gerados por Instalações

Anteriores

Se estiver fazendo upgrade de uma versão anterior à 8.6.0, você deverá excluir os arquivos de resposta gerados pelas instalações anteriores do Marketing Platform. Os arquivos de resposta antigos não são compatíveis com os instaladores da versão 8.6.0 e mais recentes.

(15)

A falha ao remover arquivos de resposta antigos pode resultar em dados incorretos preenchidos nos campos do instalador quando ele for executado ou na falha do instalador ao instalar alguns arquivos ou ao ignorar ignora etapas de configuração.

O arquivo de resposta do IBM é nomeado installer.properties.

Os arquivos de resposta para cada produto são nomeados installer_productversion.properties.

O instalador cria arquivos de resposta no diretório especificado durante a instalação. O local padrão é o diretório inicial do usuário.

Requisito de Conta do Usuário para UNIX

No UNIX, a conta do usuário que instalou o produto deve concluir o upgrade, caso contrário, o instalador falhará ao detectar uma instalação anterior.

Upgrades da Versão de 32 bits para 64 bits

Se você estiver movendo de uma versão de 32 bits para 64 bits do Marketing Platform, assegure-se de concluir as tarefas a seguir:

v _{Assegure-se de que as bibliotecas do cliente de banco de dados para as origens} de dados do produto tenham 64 bits.

v _{Assegure-se de que todos os caminhos relevantes da biblioteca, por exemplo,} scripts de inicialização ou de ambiente, fazem referência corretamente às versões de 64 bits dos drivers de banco de dados.

Requisito de Confirmação Automática para Oracle ou DB2

Se as tabelas de sistema do Marketing Platform estiverem no Oracle ou DB2, você deverá ativar o modo de confirmação automática para a abertura do ambiente.

Consulte a documentação do Oracle ou DB2 para obter instruções.

Mudança nos Nomes de Grupos e Funções Definidos pelo

Usuário

Você deve fazer upgrade do Marketing Platform, antes de fazer upgrade do Campaign. Para evitar problemas ao fazer upgrade do Marketing Platform, os nomes dos grupos e funções que são criados pelo usuário devem ser diferentes dos nomes dos grupos ou funções definidos pelo Marketing Platform.

Se os nomes forem iguais, você deverá alterar os nomes do grupo ou da função, criados antes do upgrade. Por exemplo, se você tiver criado um grupo ou função chamada Admin, deverá alterar o nome, porque Admin é um nome usado no Campaign.

Suporte de Fuso Horário para o Planejador

No Marketing Platform, é possível usar o Planejador para configurar um processo a ser executado em intervalos definidos. Com o Planejador, é possível planejar execuções de fluxograma do Campaign, execuções de sessões de otimização de Otimização de Contato e de fluxograma pós-otimização, correspondências de eMessage e execuções de modelo de PredictiveInsight e pontuação.

(16)

No Marketing Platform versão 8.5.0, use o Planejador para selecionar um fuso horário em todo o mundo para suas tarefas. Se você planejou tarefas no Marketing Platform antes da versão 8.5.0, as tarefas serão configuradas como o fuso horário padrão. O fuso horário padrão é o fuso horário do servidor no qual o Marketing Platform está instalado.

Para aproveitar o suporte de fuso horário no Planejador, edite as tarefas planejadas e selecione o novo fuso horário, conforme necessário. Consulte o Guia do

Administrador do IBM Marketing Platform para obter informações sobre como usar o

Planejador.

Portlets do Painel do IBM Digital Analytics

Se você tiver os painéis que contêm os portlets IBM Digital Analytics customizados, deverá recriar esses portlets após o upgrade ser concluído.

Fazendo Backup do Arquivo corporatetheme.css e das Imagens de

Marca

Se você remarcou o conjunto de quadros do IBM conforme descrito no Guia do

Administrador do IBM Marketing Platform, deverá fazer backup dos arquivos

modificados, antes de fazer upgrade do Marketing Platform. Você deve restaurar os arquivos após concluir a operação de upgrade, mas antes de implementar a nova versão do Marketing Platform.

Geralmente, o arquivo corporatetheme.css e imagens de marca precisam ser modificados. O arquivo corporatetheme.css e as imagens de marca estão localizados no diretório css\theme no arquivo unica.war.

Conclua as etapas a seguir para fazer backup do arquivo corporatetheme.css e das imagens de marca:

1. Faça uma cópia de backup do arquivo unica.war antes de iniciar o procedimento de upgrade para Marketing Platform.

2. Extraia o arquivo unica.war e separe as cópias do arquivo corporatetheme.css e das imagens de marca.

3. Continue com o upgrade para o Marketing Platform, mas não implemente o Marketing Platform.

4. Extraia o novo arquivo unica.war e sobrescreva as imagens existentes e o arquivo corporatetheme.css pelas versões em que foi feito o backup. 5. Recrie o novo arquivo unica.war, e implemente o Marketing Platform.

Consulte o Guia do Administrador do IBM Marketing Platform para obter mais detalhes sobre a nova marca.

(17)

Cenários de Upgrade do Marketing Platform

Faça upgrade da instalação do Marketing Platform após entender as diretrizes específicas para a versão atual do Marketing Platform.

Siga as diretrizes na tabela a seguir para fazer upgrade do Marketing Platform.

Tabela 7. Cenários de Upgrade do Marketing Platform

Versão de origem do

Marketing Platform Caminho de Upgrade

7.x Um upgrade direto a partir da versão 7.x não é suportado. Conclua as etapas a seguir para fazer upgrade do Marketing Platform versão 9.1.0:

1. Faça upgrade da versão 7.x para a versão 8.6.0. Para concluir o upgrade para a versão 8.6.0, obtenha o software e siga as instruções no guia de instalação para essa versão.

2. Conclua a operação de upgrade conforme descrito em um dos tópicos a seguir.

v _{Capítulo 3, “Fazendo Upgrade a Partir da Versão 8.x com} Migração Automática”, na página 15

v _{Capítulo 7, “Fazendo Upgrade a Partir da Versão 8.6.x com} Migração Manual”, na página 43

8.0.x ou 8.1.x, integrada a um servidor LDAP

Se você tiver mapeado grupos LDAP na propriedade LDAP references for AM user creationque não estão mapeados na LDAP reference to AM group map property, deverá concluir as etapas a seguir na versão atual do Marketing Platform, antes de continuar com o upgrade:

1. Identifique os grupos na propriedade Referências LDAP para criação do usuário do AM, que não são mapeados na propriedade Referência LDAP ao mapa de grupos do AM. 2. Mapeie os grupos LDAP identificados para um grupo

apropriado do Marketing Platform. Após concluir uma sincronização LDAP, é possível mapear os usuários para mais grupos do Marketing Platform para controlar acesso deles ao aplicativo, conforme necessário. Para obter instruções, consulte o Guia do Administrador do IBM Marketing Platform.

A conclusão das etapas anteriores assegura que todos os usuários necessários sejam criados no Marketing Platform.

Conclua a operação de upgrade conforme descrito em um dos tópicos a seguir:

v _{Capítulo 4, “Fazendo Upgrade da Versão 8.0.x, 8.1.x ou 8.2.x} Anterior à Versão 8.2.0.7 com Migração Manual”, na página 17 v _{8.0.x (não integrado} a um servidor LDAP) v _{8.1.x (não integrado} a um servidor LDAP) v _{8.2.x antes da} versão 8.2.0.7

Faça upgrade da instalação do Marketing Platform, conforme descrito em um dos tópicos a seguir:

v _{Capítulo 4, “Fazendo Upgrade da Versão 8.0.x, 8.1.x ou 8.2.x} Anterior à Versão 8.2.0.7 com Migração Manual”, na página 17

(18)

Tabela 7. Cenários de Upgrade do Marketing Platform (continuação)

Versão de origem do

Marketing Platform Caminho de Upgrade

8.2.0.7 e 8.2.x Faça upgrade da instalação do Marketing Platform, conforme descrito em um dos tópicos a seguir:

v _{Capítulo 5, “Fazendo Upgrade a Partir da Versão 8.2.0.7 e} Versões 8.2.x com Migração Manual”, na página 27 8.5.x Faça upgrade da instalação do Marketing Platform, conforme

descrito em um dos tópicos a seguir:

v _{Capítulo 6, “Fazendo Upgrade a Partir da Versão 8.5.x com} Migração Manual”, na página 35

8.6.x Faça upgrade da instalação do Marketing Platform, conforme descrito em um dos tópicos a seguir:

v _{Capítulo 7, “Fazendo Upgrade a Partir da Versão 8.6.x com} Migração Manual”, na página 43>

9.x Faça upgrade da instalação do Marketing Platform, conforme descrito em um dos tópicos a seguir:

v _{Capítulo 8, “Fazendo Upgrade a Partir da Versão 9.x com} Migração Manual”, na página 49>

O instalador de upgrade do Marketing Platform pode concluir automaticamente a migração de dados que é necessária para um upgrade. No entanto, se a política de sua organização não permitir migração de dados automática, você deverá concluir o procedimento para fazer upgrade manualmente.

(19)

Capítulo 3. Fazendo Upgrade a Partir da Versão 8.x com

Migração Automática

A migração automática permite que o instalador execute o script SQL e insira as propriedades de configuração necessárias para fazer upgrade das tabelas do sistema Marketing Platform. A migração automática é rápida e sem erros. No entanto, se a política de sua empresa não permitir atualizações automatizadas no banco de dados de tabelas do sistema, você deverá usar a migração manual. O upgrade a partir da versão 8.x é um upgrade no local. Em um upgrade no local, instale a versão atualizada do Marketing Platform no diretório em que o Marketing Platform atual está instalado.

Assegure-se de que tenha os instaladores a seguir no mesmo diretório: v _{O instalador principal do IBM EMM}

v _{O instalador do Marketing Platform}

É possível usar as diretrizes a seguir como uma melhor prática:

v _{Coloque os instaladores no mesmo diretório no qual você colocou originalmente} os instaladores para as versões anteriores de seus produtos.

v _{Remova quaisquer versões anteriores dos instaladores do produto IBM EMM a} partir do diretório para evitar que o instalador principal tente instalar as versões anteriores.

Conclua as etapas a seguir para fazer upgrade da instalação do Marketing Platform:

1. Crie uma cópia de backup do banco de dados de tabelas do sistema do Marketing Platform.

Importante: Não ignore esta etapa. Se a operação de upgrade falhar, não será possível recuperar o banco de dados e os dados serão corrompidos.

2. Remova a implementação de sua implementação do Marketing Platform. 3. 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:

v _{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.

v _{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 ativa o instalador do Marketing Platform.

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

(20)

c. Siga as etapas restantes no assistente de instalação e insira as informações solicitadas.

5. Implemente a instalação.

Nota: Preste muita atenção nas janelas de resumo da instalação. Se erros forem relatados, verifique os arquivos de log do instalador e entre em contato com o suporte técnico do IBM EMM se necessário.

(21)

Capítulo 4. Fazendo Upgrade da Versão 8.0.x, 8.1.x ou 8.2.x

Anterior à Versão 8.2.0.7 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: v _{O instalador principal do IBM}

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:

v _{“populateDb” na página 73} v _{“configTool” na página 64} v _{“alertConfigTool” na página 63}

Consulte “Cenários de Upgrade do Marketing Platform” na página 13 para obter informações sobre como fazer upgrade a partir de outras versões.

Nota: Ao fazer upgrade do Marketing Platform versão 8.2 para o Marketing Platform versão 9.1, um erro será visto nos logs. É possível ignorar esse erro, porque a coluna obrigatória é marcada e é nula. A instalação foi bem-sucedida.

Conclua as etapas a seguir para fazer upgrade da instalação do Marketing Platform para a versão 9.1:

1. Crie uma cópia de backup do banco de dados de tabelas do sistema do Marketing Platform.

Importante: Não ignore esta etapa. Se a operação de upgrade falhar, não será possível recuperar o banco de dados e os dados serão corrompidos.

2. Remova a implementação de sua implementação do Marketing Platform. 3. 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:

v _{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.

(22)

O instalador principal do IBM EMM pausa e inicia o instalador do Marketing Platform.

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.

5. 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 install 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"

6. Use um dos scripts na 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:

Nota: Execute os scripts SQL na ordem mostrada.

Tabela 8. Scripts para Fazer Upgrade a Partir da Versão 8.0.x

Nome do Script Localização

ManagerSchema_DB_Type_81upg.sql

em que DB_Type é o tipo de banco de dados do banco de dados de tabelas do sistema.

db\upgrade80to81

(23)

Tabela 8. Scripts para Fazer Upgrade a Partir da Versão 8.0.x (continuação)

db\upgrade82to85

insert_new_85_locales.sql db\upgrade85to86 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

db\upgrade86to90

ManagerSchema_DB_Type_91upg.sql ou

ManagerSchema_DB_Type_91upg_unicode.sql

db\upgrade90to91

Use os scripts a partir da tabela a seguir se você estiver fazendo upgrade a partir da versão 8.1.x ou 8.2.0:

Tabela 9. Scripts para Fazer Upgrade a Partir da Versão 8.1.x ou 8.2.0

db\upgrade82to8201

db\upgrade82to85

db\upgrade85to86

(24)

Tabela 9. Scripts para Fazer Upgrade a Partir da Versão 8.1.x ou 8.2.0 (continuação)

db\upgrade90to91

Use os scripts da tabela a seguir se você estiver fazendo upgrade da versão 8.2.0.1 e de versões com correções posteriores anteriores à versão 8.2.0.7:

Tabela 10. Scripts para Fazer Upgrade da Versão 8.2.0.1 e Versões de Correções Posteriores Anteriores à Versão 8.2.0.7

em que DB_Type é o tipo de banco de dados do banco de dados de tabelas do sistema

db\upgrade82to85

em que DB_Type é o tipo de banco de dados do banco de dados de tabelas do sistema

db\upgrade85to86

db\upgrade86to90

db\upgrade90to91

7. Execute um dos comandos a seguir: v _{Para Windows:}

installation_directory\platform\tools\bin\upgrade90to91.bat

v _{Para Unix:}

installation_directoryplatform/tools/bin/upgrade90to91.sh

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

9. Use o utilitário configTool para importar as propriedades de configuração conforme descrito na tabela a seguir:

(25)

Nota: 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.

Tabela 11. Arquivos para Fazer Upgrade da Versão 8.0.x, 8.1.x ou 8.2.x e das Versões Anteriores à 8.2.0.7

Detalhes do arquivo Exemplo de comando Ignore essa importação se a propriedade

nomeada Procura Periódica LDAP BaseDN Ativadaestiver 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.

v _Arquivo:

Ldap_Auto_Sync_BaseDN_Settings.xml v _{Local: diretório conf\upgrade86to90 na}

instalação do Marketing Platform v _{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" v _Arquivo: interaction_history_scheduler.xml v _{Local: diretório conf/upgrade85to86 na}

instalação do Marketing Platform v _{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" v _Arquivo: attribution_modeler_scheduler.xml v _{Local: diretório conf/upgrade85to86 na}

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" v _{Arquivos: coremetrics_configuration.xml} e coremetrics_navigation.xml

v _{Local: diretório conf na instalação do} Marketing Platform

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

v configTool.bat -i -p "Affinium" -f "C:\Unica\Platform\conf\ coremetrics_configuration.xml" v configTool.bat -i -p "Affinium|suite|uiNavigation|mainMenu|Analytics" -f "C:\Unica\Platform\conf\coremetrics_navigation.xml" v _Arquivo: cognos10_modeler_integration.xml v _{Local: diretório conf/upgrade85to86 na}

configuração necessárias para os relatórios

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

(26)

Tabela 11. Arquivos para Fazer Upgrade da Versão 8.0.x, 8.1.x ou 8.2.x e das Versões Anteriores à 8.2.0.7 (continuação)

Detalhes do arquivo Exemplo de comando v _{Arquivo: Nenhum arquivo - removendo}

propriedades

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

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

v _{Arquivo: LDAP_Anonymous_bind.xml} v _{Local: diretório conf/upgrade85to86 na}

instalação do Marketing Platform v _{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

v _{Arquivo: quicklinks_category.xml} v _{Local: diretório conf\upgrade86to90 na}

instalação do Marketing Platform v _{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"

v _{Arquivo: manager_alerts_registration.xml} v _{Local: diretório conf na instalação do}

Marketing Platform

v _{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"

v _{Arquivo: disablePageTagging.xml} v _{Local: diretório conf\upgrade82to85 na}

configuração que determinará se o IBM poderá reunir estatísticas de configuração básica que controla tendências gerais de uso do produto.

"C:\Unica\Platform\conf\upgrade82to85\disablePageTagging.xml"

v _{Arquivos: coremetrics_configuration.xml} e coremetrics_navigation.xml

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

v configTool.bat -i -o -p

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

v _{Arquivo: scheduler.xml}

v _{Local: diretório db\upgrade90to91 na} instalação do Marketing Platform v _{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"

(27)

Detalhes do arquivo Exemplo de comando v _{Arquivo: unknownPolling.xml}

v _{Local: diretório db\upgrade90to91 na} instalação do Marketing Platform v _{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"

v _{Arquivo: communication_email.xml} v _{Local: diretório conf\upgrade86to90 na}

instalação do Marketing Platform v _{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"

v _{Arquivo: notification.xml}

v _{Local: diretório conf\upgrade86to90 na} instalação do Marketing Platform v _{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 –

"C:\Unica\Platform\conf\upgrade86to90\notification.xml"

v _{Arquivo: is_clustered.xml}

v _{Local: diretório conf\upgrade86to90 na} instalação do Marketing Platform v _{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"

(28)

Detalhes do arquivo Exemplo de comando v _{Arquivo: taskNotification.xml}

v _{Local: diretório conf\upgrade86to90 na} instalação do Marketing Platform v _{Propósito: Importa o campo Nome do}

Grupoonde é 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" v _{Arquivo: config_data_filter_cache.xml}

v _{Local: diretório conf\upgrade90to91 na} instalação do Marketing Platform v _{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"

Nota: Se você alterar esse valor, deverá reiniciar o Marketing Platform para que as mudanças entrem em vigor.

v _{Arquivo: Refresh_data_filter_cache.xml} v _{Local: diretório conf\upgrade90to91 na}

instalação do Marketing Platform v _{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\

(29)

Detalhes do arquivo Exemplo de comando v _{Arquivos: navigation.xml e}

emm_spss_configuration.xml v _{Local: conf\upgrade90to91}

v _{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"

10. 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"

11. Execute o script upgrade85Dashboard a partir do diretório tools\bin na instalação do Marketing Platform para fazer upgrade do painel.

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

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

13. Implemente e verifique sua instalação, conforme descrito no capítulo Capítulo 9, “Implementando o Marketing Platform”, na página 55.

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.

(30)

(31)

Capítulo 5. 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: v _{O instalador principal do IBM}

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:

v _{“populateDb” na página 73} v _{“configTool” na página 64} v _{“alertConfigTool” na página 63}

Consulte o “Cenários de Upgrade do Marketing Platform” na página 13 para obter informações sobre como atualizar a partir de outras versões.

Conclua as etapas a seguir para fazer upgrade manualmente a partir da versão 8.5.0:

1. Faça um backup de seu banco de dados de tabela de sistema do Marketing Platform.

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

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

3. 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:

v _{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.

O instalador principal do IBM EMM pausa e inicia o instalador do Marketing Platform.

(32)

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.

5. 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"

6. 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:

v _{Para todos os tipos de banco de dados, remova a instrução a seguir:} ALTER TABLE USCH_RUN ADD PAYLOAD NVARCHAR(4000);

v _{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);

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

Tabela 12. Scripts para Fazer Upgrade da Versão 8.2.0.7 ou de uma Versão Posterior 8.2.x

(33)

Tabela 12. Scripts para Fazer Upgrade da Versão 8.2.0.7 ou de uma Versão Posterior 8.2.x (continuação)

db\upgrade85to86

db\upgrade86to90

db\upgrade90to91

8. Execute um dos comandos a seguir: v _{Para Windows:}

installation_directory\platform\tools\bin\upgrade90to91.bat

v _{Para Unix:}

installation_directoryplatform/tools/bin/upgrade90to91.sh

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

10. Use o utilitário configTool para importar as propriedades de configuração conforme descrito na tabela a seguir:

Nota: 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.

(34)

Tabela 13. 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 Ativadaestiver 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.

v _Arquivo:

Ldap_Auto_Sync_BaseDN_Settings.xml v _{Local: diretório conf\upgrade86to90 na}

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" v _Arquivo: interaction_history_scheduler.xml v _{Local: conf/upgrade85to86rectory na}

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" v _Arquivo: attribution_modeler_scheduler.xml v _{Local: diretório conf/upgrade85to86 na}

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" v _{Arquivos: coremetrics_configuration.xml} e coremetrics_navigation.xml

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" v _Arquivo: cognos10_modeler_integration.xml v _{Local: diretório conf/upgrade85to86 na}

configuração necessárias para os relatórios

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

cognos10_integration.xml"

v _{Arquivo: Nenhum arquivo - removendo} propriedades

v _{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"