Atualizando o DB2 Text Search para a Instalação Raiz ou do Administrador

Para obter as mais recentes funcionalidades atualize sua instância de Pesquisa de Texto Db2® . Você deve atualizar o servidor, a instância e todos os bancos de dados do DB2 quando estiver atualizando a instância de procura de texto.

1. Faça logon no servidor Db2 como root em sistemas operacionais Linux e UNIX ou usuário com autoridade de Administrador Local em sistemas operacionais Windows. Se estiver atualizando uma instância com várias partições, você deve executar a atualização de instância a partir da partição da instância proprietária.
2. Instale uma nova cópia do 11.5 com uma instalação customizada e certifique-se de que o Db2 Text Search esteja selecionado. O DB2 Text Search é um componente opcional disponível apenas quando uma instalação customizada é selecionada.
   Também é possível optar por instalar uma nova cópia do 11.5 em uma versão anterior do Db2 selecionando o modo Work-With-Existing e selecionando Db2 Procura de Texto como o componente a ser atualizado. Não é necessário atualizar as instâncias do DB2 depois que a atualização for feita com esta abordagem.
3. Faça o upgrade do servidor Db2 Text Search para as suas instâncias Db2 emitindo o comando configTool upgradeConfigFolder . Este comando deve ser executado como proprietário da instância, e não root.
   • Para sistemas operacionais Linux e UNIX:

     $DB2DIR/db2tss/bin/configTool upgradeConfigFolder 
     -sourceConfigFolder $DB2DIR/cfg/db2tss/config
     -targetConfigFolder $INSTHOME/sqllib/db2tss/config

     em que INSTHOME é o diretório inicial da instância e DB2DIR é o local da cópia do 11.5 recém-instalado.
   • Para sistemas operacionais Windows:

     <DB2PATH>\db2tss\bin\configTool upgradeConfigFolder 
     -sourceConfigFolder "<DB2PATH>\CFG\DB2TSS\CONFIG"
     -targetConfigFolder "<INSTPROFDIR>\<INSTANCENAME>\DB2TSS\CONFIG"

     em que <DB2PATH> é o local da cópia do 11.5 recém-instalado e < INSTPROFDIR> é o diretório do perfil da instância
     Nota: Para sistemas Windows, se a instância Db2 não foi configurada anteriormente para Db2 Search Text Search, você pode pular esta etapa.

   O comando configTool upgradeConfigFolder substitui, modifica e mescla configuração de pesquisa de texto e arquivos de dados e diretórios.

   O diretório de configuração

   O comando copia os seguintes arquivos no diretório <ECMTS_HOME>\config, se eles já não existirem neste diretório:

   • constructors.xml
   • ecmts_logging.properties
   • ecmts_config_logging.properties

   Os seguintes arquivos são copiados e os arquivos já existentes são sobrescritos:

   • build_info.properties
   • constructors.xsd
   • ecmts_config_logging.properties
   • mimetypes.xml
   • monitoredEventsConfig.xml

   As definições de configuração dos seguintes arquivos são mesclados no arquivo configuration.xml. Os valores são adicionados para novas definições e os valores são mantidos para as definições existentes.

   • config.xml
   • jetty.xml

   Os seguintes arquivos não foram modificados:

   • authentication.xml
   • key.txt
   • Todos os arquivos no subdiretório Coleções

   O diretório de log

   O comando não modifica os conteúdos do diretório de log existente. Entretanto, quando novos arquivos de log são gerados, estes novos arquivos podem substituir os arquivos de log existentes.

   O comando configTool upgradeConfigFolder não faz upgrade de filtros de pesquisa de texto para um servidor de pesquisa de texto integrado.

4. Atualize a instância atual Db2 emitindo o comando db2iupgrade .
   • Para sistemas operacionais Linux e UNIX, o comando está localizado no diretório $DB2DIR/instance , em que DB2DIR é o local da cópia do Db2 servidor de banco de dados 11.5 recém-instalado.

     db2iupgrade  -j  "TEXT_SEARCH [[,service-name]|[,port-number]]" DB2INST 

   • Para sistemas operacionais Windows, o arquivo de propriedades está localizado no diretório <DB2PATH>\bin , em que <DB2PATH> é o local da cópia do Db2 11.5 recém-instalado.

     db2iupgrade DB2INST  /j  "TEXT_SEARCH [[,service-name]|[,port-number]]"

   Para informações adicionais, consulte o tópico sobre o comando db2iupgrade.

   Nota: se você instalou uma nova cópia do 11.5 com a opção de upgrade e selecionou a Procura de Texto do Db2 como um recurso a ser atualizado, será possível ignorar esta etapa.
5. Faça backup dos valores para todas as propriedades configuráveis do Db2 Pesquisa de Texto que foram usadas no release anterior, executando o seguinte script:
   • Para sistemas operacionais Linux e UNIX:

     $DB2DIR/db2tss/bin/bkuptscfg.sh  $INSTNAME

     em que DB2DIR representa o local da cópia 11.5 recém-instalada e INSTNAME representa o nome da instância a ser atualizada.
   • Para sistemas operacionais Windows:

     <DB2PATH>\db2tss\bin\bkuptscfg.bat <INSTANCENAME> <DB2PATH>

     em que <DB2PATH> representa o local da cópia 11.5 recém-instalada, < INSTANCENAME> representa o nome da instância a ser atualizada.

   As configurações de backup das propriedades configuráveis são redirecionadas em um arquivo de propriedade:

   • Para os sistemas operacionais Linux e UNIX, o arquivo de propriedade está localizado no diretório $INSTHOME/sqllib/db2tss/config/db2tssrvupg.cfg , onde INSTHOME representa o diretório home da instância.
   • Para os sistemas operacionais Windows, o arquivo de propriedade está localizado no diretório <INSTPROFDIR>\<INSTANCENAME>\db2tss\config\db2tssrvupg.cfg , onde < INSTPROFDIR> representa o diretório do perfil da instância e < INSTANCENAME> representa o nome da instância a ser atualizada. Você pode encontrar o nome do diretório do perfil da instância emitindo o comando db2set DB2INSTPROF .

   Requisito: Você deve preencher um backup para os valores de todas as propriedades configuráveis do Db2 Search Text Search que são usados em releases anteriores. Falha na criação de um backup de resultados em uma falha de upgrade de banco de dados.
6. Configure a variável de ambiente DB2INSTANCE para a instância atualizada atual.
7. Faça o upgrade dos bancos de dados, emitindo o comando DB2 UPGRADE DATABASE .
   Se o comando DB2 UPGRADE DATABASE retornar a mensagem de erro ADM4003E , atualize o catálogo e os índices do Db2 Text Search manualmente usando os procedimentos armazenados SYSTS_UPGRADE_CATALOG e SYSTS_UPGRADE_INDEX.
8. Para cada banco de dados atualizado, verifique se as informações de propriedades do servidor de procura de texto na procura de texto SYSIBMTS.TSSERVERS está correta comparando os valores de propriedade submetidos a backup na etapa 7 Se o valor do token ou número da porta na tabela do catálogo estiver vazio ou incorreto, você deve atualizar as informações do servidor de texto manualmente.
   Para mais detalhes sobre como atualizar, consulte o tópico sobre atualização de informação do servidor do DB2 Text Search.
9. Analise os valores para todas as propriedades configuráveis do Db2 Search Text Search. Compare com os valores que você fez backup para assegurar que eles tenham os valores corretos.
   Emita o seguinte comando para verificar os valores de configuração:

   configTool printAll -configPath <configuration-directory>

10. Se você desativou o Db2 Texto Search for rich text document support, você tem que instalar o Db2 V10.5 Acessórios Suite
    Para informações adicionais, consulte o tópico sobre instalação do DB2 Accessories Suite.
11. Em seguida, ative o suporte do documento rich text.
    Para informações adicionais, consulte o tópico sobre o suporte para rich text e formato proprietário do DB2 Text Search
12. Verifique se o upgrade foi bem-sucedido iniciando o serviço de instância de Pesquisa de Texto Db2 . Se você desativou o suporte do documento rich text, verifique se o suporte do documento está ativo emitindo consultas de procura e compare com os resultados pré-atualizados.