O Utilitário ConfigTool
As propriedades e os valores na página Configuração são armazenados nas tabelas de sistema. É possível utilizar o utilitário configTool para importar e exportar definições de configuração para as tabelas de sistema e a partir delas.
Quando Usar o ConfigTool
É possível usar o configTool quando desejar fazer o seguinte:
*
Para importar a partição e modelos de origens de dados fornecidos com o Campaign, que podem então ser modificados e duplicados usando a página Configuração.
*
Registrar (propriedades de configuração de importação para) produtos do IBM® EMM, se o instalador do produto não conseguir incluir as propriedades no banco de dados automaticamente.
*
*
Excluir as categorias que não possuem o link Excluir Categoria. Isso é feito usando a configTool para exportar sua configuração e, em seguida, excluindo manualmente o XML que cria a categoria, e ao usar a configTool para importar o XML editado.
*
Esse utilitário modifica as tabelas usm_configuration e usm_configuration_values no banco de dados de tabelas do sistema Marketing Platform, que contém as propriedades de configuração e seus valores. Para obter melhores resultados, crie cópias de backup dessas tabelas, ou exporte suas configurações existentes ao usar a configTool e faça backup do arquivo resultante para que você tenha uma forma de restaurar sua configuração, caso seja cometido algum erro durante o uso da configTool para importar.
Sintaxe
configTool -d -p "elementPath" [-o]
configTool -i -p "parent ElementPath" -f importFile [-o]
configTool -x -p "elementPath" -f exportFile
configTool -vp -p "elementPath" -f importFile [-d]
configTool -r productName -f registrationFile [-o] configTool -u productName
Comandos
-d -p "elementPath" [o]
Exclua as propriedades de configuração e suas definições, especificando um caminho na hierarquia de propriedade de configuração.
O caminho do elemento deve usar os nomes internos de categorias e propriedades. É possível obtê-los acessando a página de Configuração, selecionando a categoria ou propriedade desejada, e procurando no caminho exibido entre parênteses na área de janela à direita. Delimite um caminho na hierarquia de propriedade de configuração usando o caractere | e colocando o caminho entre aspas duplas.
Observe o seguinte.
*
*
Para excluir categorias que não possuem o link Excluir Categoria na página de Configuração, use a opção -o.
Ao utilizar -d com o comando -vp, a configTool exclui todos os nós filhos no caminho especificado se esses nós não estiverem incluídos no arquivo XML que você especificar.
-i -p "parentElementPath" -f importFile [o]
Importe as propriedades de configuração e suas definições a partir de um arquivo XML especificado.
Para importar, especifique um caminho para o elemento-pai no qual deseja importar suas categorias. O utilitário configTool importa propriedades sob a categoria especificada no caminho.
É possível incluir categorias em qualquer nível abaixo do nível superior, mas não é possível incluir uma categoria no mesmo nível que a categoria superior.
O caminho do elemento-pai deve usar os nomes internos de categorias e propriedades. É possível obtê-los acessando a página Configuração, selecionando a categoria ou a propriedade necessária, e procurando no caminha exibido entre parênteses na área de janela à direita. Delimite um caminho na hierarquia de propriedade de configuração usando o caractere | e colocando o caminho entre aspas duplas.
É possível especificar um local do arquivo de importação relativo ao diretório tools/bin ou é possível especificar um caminho de diretório completo. Se especificar um caminho relativo, ou nenhum caminho, o configTool primeiro consultará o arquivo relativo ao diretório tools/bin.
Por padrão, esse comando não sobrescreve uma categoria existente, mas é possível usar a opção -o para forçar uma sobrescrição.
-x -p "elementPath" -f exportFile
Exporte as propriedades de configuração e suas definições em um arquivo XML com um nome especificado.
É possível exportar todas as propriedades de configuração ou limitar a exportação para uma categoria específica ao especificar um caminho na hierarquia de propriedade de configuração.
O caminho do elemento deve usar os nomes internos de categorias e propriedades, os quais podem ser obtidos acessando a página Configuração, selecionando a categoria ou propriedade desejada, e procurando no caminho exibido entre parênteses na área de janela à direita. Delimite um caminho na hierarquia de propriedade de configuração usando o caractere | e colocando o caminho entre aspas duplas.
É possível especificar um local do arquivo de exportação relativo ao diretório atual ou é possível especificar um caminho de diretório completo. Se a especificação de arquivo não contiver um separador (/ no UNIX, / ou \ no Windows), a configTool grava o arquivo no diretório tools/bin sob sua instalação do Marketing Platform. Se uma extensão xml não for fornecida, o configTool a incluirá.
-vp -p "elementPath" -f importFile [-d]
Este comando é usado, principalmente em upgrades manuais, para importar propriedades de configuração. Se tiver aplicado um fix pack que contenha uma nova propriedade de configuração e, em seguida, fizer upgrade, a importação de um arquivo de configuração como parte de um processo de upgrade manual pode substituir valores que foram definidos quando o fix pack foi aplicado. O comando -vp assegura que a importação não substitua valores de configuração anteriormente definidos.
*
Após usar o utilitário configTool com a opção -vp, você deve reiniciar o servidor de aplicativos da web no qual o Marketing Platform está implementado para que as mudanças sejam aplicadas.
Ao utilizar -d com o comando -vp, a configTool exclui todos os nós filhos no caminho especificado se esses nós não estiverem incluídos no arquivo XML que você especificar.
-r productName -f registrationFile
Registre o aplicativo. O local do arquivo de registro pode ser relativo ao diretório tools/bin ou pode ser um caminho completo. Por padrão, esse comando não sobrescreve uma configuração existente, mas é possível usar a opção -o para forçar uma sobrescrição. O parâmetro productName deve ser um dos nomes que são listados acima.
Observe o seguinte.
*
Ao usar o comando -r, o arquivo de registro deve ter <application> como a primeira tag no XML.
Outros arquivos podem ser fornecidos com seu produto que podem ser usados para inserir propriedades de configuração no banco de dados do Marketing Platform . Para esses arquivos, use o comando -i. Apenas o arquivo que possuir a tag <application> como a primeira tag pode ser usado com o comando -r.
*
O arquivo de registro para o Marketing Platform é denominado Manager_config.xml e a primeira tag é <Suite>. Para registrar esse arquivo em uma nova instalação, use o utilitário populateDb ou execute novamente o instalador do Marketing Platform conforme descrito no IBM® Marketing Platform Guia de Instalação.
*
Após a instalação inicial, para registrar novamente produtos diferentes do Marketing Platform, use a configTool com os comandos -r e -o para sobrescrever as propriedades existentes.
O utilitário configTool usa nomes de produto como parâmetros com os comandos que registram e cancelam o registro de produtos. Com a liberação 8.5.0 do IBM® EMM, muitos nomes de produtos foram alterados. No entanto, os nomes que são reconhecidos pelo configTool não foram alterados. Os nomes de produto válidos para uso com o configTool são listados abaixo, junto com nomes atuais dos produtos.
IBM® SPSS® Modeler Advantage Enterprise Marketing Management Edition
-u productName
Cancele o registro de um aplicativo especificado pelo productName. Você não tem que incluir um caminho na categoria do produto. O nome do produto é suficiente e é necessário. O processo remove todas as propriedades e definições de configuração para o produto.
Opções
-o
Quando é usado com -i ou -r, ele sobrescreve uma categoria existente ou registro de produto (nó).
Quando usado com -d, é possível excluir uma categoria (nó) que não possua o link Excluir Categoria na página de Configuração.
Exemplos
*
Importe definições de configuração de um arquivo denominado Product_config.xml no diretório conf sob a instalação do Marketing Platform.
configTool -i -p "Affinium" -f Product_config.xml
*
Importe um dos modelos de origens de dados do Campaign fornecidos na partição padrão do Campaign, a partition1. O exemplo assume o modelo de origem de dados Oracle, OracleTemplate.xml, foi colocado no diretório tools/bin na instalação do Marketing Platform.
configTool -i -p "Affinium|Campaign|partitions|partition1|dataSources" -f OracleTemplate.xml
*
configTool -x -f D:\backups\myConfig.xml
*
Exporte uma partição existente do Campaign (completa com entradas de origem de dados), salve-a em um arquivo denominado partitionTemplate.xml e armazene-o no diretório padrão tools/bin na instalação do Marketing Platform.
configTool -x -p "Affinium|Campaign|partitions|partition1" -f partitionTemplate.xml
*
Registre manualmente um aplicativo denominado productName usando um arquivo denominado app_config.xml no diretório padrão tools/bin sob a instalação do Marketing Platform e force-o a sobrescrever um registro existente deste aplicativo.
configTool -r product Name -f app_config.xml -o
*
configTool -u productName