JDBCGW PDF

IBM
Tivoli
Netcool/OMNIbus Gateway for JDBC

Verso 4.0
Guia de Referncia
6 de Julho de 2012
S517-0082-03
IBM
Tivoli
Netcool/OMNIbus Gateway for JDBC

Verso 4.0
Guia de Referncia
6 de Julho de 2012
S517-0082-03
Aviso
Antes de utilizar estas informaes e o produto suportado por elas, leia as informaes em Avisos e Marcas, na pgina
47.
Aviso de Edio
Esta edio (S517-0082-03) se aplica verso 4.0 do IBM Tivoli Netcool/OMNIbus Gateway para JDBC e a todas as
liberaes e modificaes subsequentes at que seja indicado de outra forma em novas edies.
Esta edio substitui a SC22-5408-02.
Copyright IBM Corporation 2011, 2012.
ndice
Sobre este Guia . . . . . . . . . . . v
Pgina de Controle de Documento . . . . . . . v
Convenes Usadas Neste Guia. . . . . . . . vi
IBM Tivoli Netcool/OMNIbus Gateway
para JDBC . . . . . . . . . . . . . 1
Resumo . . . . . . . . . . . . . . . . 2
Bancos de Dados Suportados . . . . . . . . . 3
Obtendo o Gateway . . . . . . . . . . . . 3
Viso Geral do Gateway . . . . . . . . . . 4
Modo de Auditoria e Modo de Relatrio . . . . . 6
Dimensionamento do Banco de Dados . . . . . . 7
Instalando o Gateway no Tivoli Netcool/OMNIbus
V7.2.0 e 7.2.1 . . . . . . . . . . . . . . 10
Viso Geral da Instalao . . . . . . . . . 11
Instalando as Bibliotecas dos Modos de Auditoria
e de Relatrio. . . . . . . . . . . . . 11
Instalando o Gateway nos Sistemas Operacionais
UNIX e Linux . . . . . . . . . . . . 12
Windows . . . . . . . . . . . . . . 12
Instalando o Gateway no Tivoli Netcool/OMNIbus
V7.3.0, V7.3.1 ou Posterior . . . . . . . . . 13
Viso Geral da Instalao . . . . . . . . . 13
Instalando as Bibliotecas dos Modos de Auditoria
e de Relatrio . . . . . . . . . . . . 13
UNIX e Linux . . . . . . . . . . . . 14
Windows . . . . . . . . . . . . . . 14
Configurando variveis de ambiente . . . . . . 15
Configurando Detalhes de Comunicao. . . . . 16
Configurando o Esquema do Banco de Dados . . . 16
Migrando de um Gateway Existente . . . . . 17
Configurando a Conexo com o Banco de Dados . . 17
Configurando o Gateway. . . . . . . . . . 20
Arquivo de propriedades . . . . . . . . . 21
Propriedades e Opes da Linha de Comandos 21
Arquivo de Definio de Mapas . . . . . . 35
Arquivo de Comando de Inicializao . . . . 36
Transferncias de Tabelas Arbitrrias . . . . . 36
Arquivo de Definio de Replicao da Tabela. . 37
Funes AfterIDUC e de Filtro . . . . . . . 38
Usando um Campo de Particionamento . . . . 39
Filtrando Dados de Ressincronizao . . . . . 39
Arquivo de Log de Mensagens . . . . . . . 40
Modo FIPS e Criptografia . . . . . . . . 41
Estatsticas do Gateway . . . . . . . . . . 41
Mensagens de erro . . . . . . . . . . . . 42
Mensagens de Erro de JDBC. . . . . . . . 43
Executando o Gateway . . . . . . . . . . 44
Problemas Conhecidos. . . . . . . . . . . 45
Rtulo de Tabela Customizada . . . . . . . 45
Estados de Erro de SQL . . . . . . . . . 45
Esquemas de Nomenclatura do Sybase . . . . 46
Apndice. Avisos e Marcas . . . . . . 47
Avisos . . . . . . . . . . . . . . . . 47
Marcas Registradas . . . . . . . . . . . . 49
Copyright IBM Corp. 2011, 2012 iii
iv IBM Tivoli Netcool/OMNIbus Gateway for JDBC: Guia de Referncia
Sobre este Guia
As sees a seguir contm informaes importantes sobre como usar este guia.
Pgina de Controle de Documento
Use estas informaes para rastrear mudanas entre as verses deste guia.
A documentao do IBM Tivoli Netcool/OMNIbus Gateway para JDBC fornecida
apenas em formato eletrnico. Para obter a verso mais recente, visite o Centro de
Informaes do IBM
Tivoli Netcool:
http://publib.boulder.ibm.com/infocenter/tivihelp/v8r1/index.jsp?topic=/
com.ibm.tivoli.namomnibus.doc/welcome_ptsm.htm
Tabela 1. Histrico de Modificao de Documento
Verso do
Documento
Data de
publicao Comentrios
SC22-5408-00 02 de dezembro
de 2011
Primeira publicao da IBM.
SC22-5408-01 16 de dezembro
de 2011
Informaes sobre requisitos atualizadas em
Resumo na pgina 2.
Informaes sobre biblioteca de scripts atualizadas
em Obtendo o Gateway na pgina 3.
S517-0082-02 02 de maro de
2012
Informaes sobre requisitos atualizadas em
Resumo na pgina 2.
Lista de bancos de dados suportados atualizada em
Bancos de Dados Suportados na pgina 3.
Informaes sobre como obter o gateway atualizadas
em Obtendo o Gateway na pgina 3.
Informaes sobre configurao do banco de dados
atualizadas em Configurando a Conexo com o
Banco de Dados na pgina 17.
Problema de esquema de nomenclatura do Sybase
descrito em Problemas Conhecidos na pgina 45.
Copyright IBM Corp. 2011, 2012 v
Tabela 1. Histrico de Modificao de Documento (continuao)
Verso do
Documento
Data de
publicao Comentrios
S517-0082-03 6 de Julho de
2012
Verso do pacote atualizada em Resumo na pgina
2.
Descries da propriedade Gate.Jdbc.Url para uso
com o DB2 LUW e DB2 z/OS atualizados em
Configurando a Conexo com o Banco de Dados
na pgina 17.
Propriedades e Opes da Linha de Comandos na
pgina 21 atualizado.
Informaes de replicao de tabela do ObjectServer
atualizadas em Arquivo de Definio de Replicao
da Tabela na pgina 37.
Funes AfterIDUC e de Filtro na pgina 38
includo.
Rtulo de Tabela Customizada na pgina 45
includo.
Convenes Usadas Neste Guia
Todos os guias de gateway usam convenes padro para variveis de ambientes e
caminhos do diretrio dependentes do sistema operacional.
Variveis e Caminhos Dependentes do Sistema Operacional
Todos os guias de gateway usam convenes padro para especificar variveis de
ambiente e descrever caminhos do diretrio, dependendo do sistema operacional
em que o gateway suportado.
Para gateways suportados nos sistemas operacionais UNIX e Linux, os guias de
gateway usam convenes UNIX padro como $variable para variveis de ambiente
e barras (/) nos caminhos do diretrio. Por exemplo:
$OMNIHOME/gates
Para gateways suportados somente nos sistemas operacionais Windows, os guias
de gateway usam convenes Windows padro como %variable% para variveis de
ambiente e barras invertidas (\) nos caminhos do diretrio. Por exemplo:
%OMNIHOME%\gates
Para gateways suportados nos sistemas operacionais UNIX, Linux e Windows, os
guias de gateway usam convenes UNIX padro para especificar variveis de
ambiente e descrever caminhos do diretrio. Ao usar a linha de comandos do
Windows com esses gateways, substitua as convenes UNIX usadas no guia com
convenes Windows. Se voc estiver usando o shell bash em um sistema
Windows, ser possvel usar as convenes UNIX.
Nota: Os nomes das variveis de ambiente nem sempre so os mesmos nos
ambiente Windows e UNIX. Por exemplo, %TEMP% em ambientes Windows
equivalente a $TMPDIR em ambientes UNIX e Linux.
vi IBM Tivoli Netcool/OMNIbus Gateway for JDBC: Guia de Referncia
Nomes de Diretrio Especficos do Sistema Operacional
Onde os arquivos do Tivoli Netcool/OMNIbus so identificados como localizados
em um diretrio arch em NCHOME ou OMNIHOME, arch uma varivel que
representa seu diretrio de sistema operacional. Por exemplo:
$OMNIHOME/gates/arch/
A tabela a seguir lista os nomes de diretrio usados para cada sistema operacional
suportado.
Tabela 2. Nomes do Diretrio para a Varivel arch
Sistema Operacional Nome do diretrio representado por arch
Sistemas AIX aix5
Sistemas baseados em HP-UX PA-RISC hpux11
Sistemas baseados na Integridade HP-UX hpux11hpia
Sistemas Red Hat Linux e SUSE linux2x86
Linux para System z linux2s390
Sistemas Solaris solaris2
Sistemas Windows win32
Sobre este Guia vii
viii IBM Tivoli Netcool/OMNIbus Gateway for JDBC: Guia de Referncia
IBM Tivoli Netcool/OMNIbus Gateway para JDBC
O IBM Tivoli Netcool/OMNIbus Gateway para JDBC usa a API Java Database
Connectivity (JDBC) padro para trocar alertas entre ObjectServers
Netcool/OMNIbus e bancos de dados externos. Ele se comunica com os bancos de
dados suportados usando drivers JDBC Java Tipo 4 fornecidos pelos fornecedores
dos bancos de dados.
O Gateway para JDBC pode ser usado como um substituto do Tivoli
Netcool/OMNIbus Gateway para ODBC e do Tivoli Netcool/OMNIbus Gateway
para Oracle.
O Gateway para JDBC possui os seguintes recursos:
v Modos de operao de relatrio e de auditoria.
v Capacidade Store and forward (SAF) usando cache de eventos persistente e
encaminhamento de dados.
v Ressincronizao na inicializao.
v Escalabilidade fornecida por diversas conexes com o banco de dados.
v Transferncias de tabela arbitrrias.
v Migrao de bancos de dados de destino existentes usando ressincronizao
bidirecional.
Este guia contm as seguintes sees:
v Resumo na pgina 2
v Bancos de Dados Suportados na pgina 3
v Obtendo o Gateway na pgina 3
v Viso Geral do Gateway na pgina 4
v Modo de Auditoria e Modo de Relatrio na pgina 6
v Dimensionamento do Banco de Dados na pgina 7
v Instalando o Gateway no Tivoli Netcool/OMNIbus V7.2.0 e 7.2.1 na pgina 10
v Instalando o Gateway no Tivoli Netcool/OMNIbus V7.3.0, V7.3.1 ou Posterior
na pgina 13
v Configurando variveis de ambiente na pgina 15
v Configurando Detalhes de Comunicao na pgina 16
v Configurando o Esquema do Banco de Dados na pgina 16
v Configurando a Conexo com o Banco de Dados na pgina 17
v Configurando o Gateway na pgina 20
v Estatsticas do Gateway na pgina 41
v Mensagens de erro na pgina 42
v Executando o Gateway na pgina 44
v Problemas Conhecidos na pgina 45
Copyright IBM Corp. 2011, 2012 1
Resumo
Cada gateway funciona de um modo diferente para prover uma interface ao
ObjectServer. Este resumo descreve as caractersticas bsicas do gateway.
A tabela a seguir fornece um resumo do gateway.
Tabela 3. Resumo
Destino do gateway DB2 LUW, DB2 z/OS, Informix, Microsoft SQL Server,
MySQL, Oracle, Sybase
Consulte Bancos de Dados Suportados na pgina 3 para
obter detalhes das verses suportadas.
Nome do arquivo executvel
do gateway
nco_g_jdbc
Pacote de instalao do
gateway
omnibus-arch-gateway-nco-g-jdbc-version
Verso do pacote 4,0
Gateway suportado em Para obter detalhes dos sistemas operacionais suportados,
consulte o Aviso de Liberao a seguir no Web site de
Suporte de Software IBM:
https://www-304.ibm.com/support/
docview.wss?uid=swg21599130
Arquivo de propriedades $OMNIHOME/etc/G_JDBC.props
Requisitos IBM Tivoli Netcool/OMNIbus V7.2.0 (ou posterior).
Biblioteca de scripts do modo de auditoria (necessria para
executar o gateway no modo de auditoria):
gateway-nco-g-jdbc-audit-scripts-1_0
Biblioteca de scripts do modo de relatrio (necessria para
executar o gateway no modo de relatrio):
gateway-nco-g-jdbc-reporting-scripts-1_0
A instalao no IBM Tivoli Netcool/OMNIbus V7.2.0 ou
7.2.1 requer as seguintes bibliotecas:
v Gateway Java Support Package: gateway-libngjava-5_0
(ou posterior)
v Gateway NGtkTK Support Package: gateway-libngtktk-
4_0 (ou posterior)
A instalao no IBM Tivoli Netcool/OMNIbus V7.2.0 requer
a biblioteca common-libncrypt-1_0.
Licenciamento A licena eletrnica foi reprovada com o release do IBM
Tivoli Netcool V7.2.0. Todos os produtos IBM Tivoli Netcool
V7.2.0 (e posterior) usam o processo de licena de software
da IBM.
Suporte multicultural No disponvel
Ambiente IP IPv4 e IPv6
Nota: O suporte a IPv6 para a conexo com o banco de
dados depende do driver JDBC. Consulte a documentao
de seu driver JDBC para obter informaes sobre o suporte
a IPv6.
2 IBM Tivoli Netcool/OMNIbus Gateway for JDBC: Guia de Referncia
Tabela 3. Resumo (continuao)
Federal Information
Processing Standards (FIPS)
IBM Tivoli Netcool/OMNIbus V7.2.1, 7.3.0 e 7.3.1 usam o
provedor criptogrfico aprovado por FIPS 140-2: IBM
Crypto para C (ICC), certificado 384 para criptografia. Esse
certificado est listado no website do NIST em
http://csrc.nist.gov/cryptval/140-1/1401val2004.htm. Para
obter detalhes sobre a configurao do Netcool/OMNIbus
para o modo FIPS 140-2, consulte o IBM Tivoli
Netcool/OMNIbus Installation and Deployment Guide
(SC14-7604-00).
Bancos de Dados Suportados
O Gateway para JDBC suportado para uso com os bancos de dados listados aqui.
O gateway suportado para uso com os bancos de dados e drivers JDBC listados
na tabela a seguir.
Tabela 4. Bancos de Dados e Drivers JDBC Suportados
Banco de dados Driver JDBC
DB2 LUW 9.5 e 9.7 DB2 Type 4 Universal Driver
(com.ibm.db2.jcc.DB2Driver)
DB2 z/OS 10 DB2 Type 4 Universal Driver
(com.ibm.db2.jcc.DB2Driver)
Informix 11.5 e 11.7 IBM Informix JDBC Driver
(com.informix.jdbc.IfxDriver)
Microsoft SQL Server 2005 e 2008 Microsoft SQL Server Driver for JDBC
(com.microsoft.sqlserver.jdbc.SQLServerDriver)
Nota: O JRE 1.5 requer o driver Microsoft JDBC 3,
enquanto o JRE 1.6 requer o driver Microsoft JDBC 4.
Os detalhes podem ser encontrados no website da
Microsoft.
Nota: No OMNIbus 7.3.1 que baseado no JRE 1.6,
somente o arquivo sqljdbc4.jar pode ser usado. Para
verses do OMNIbus mais antigas que 7.3.1, o
sqljdbc.jar usado. Ambos os arquivos .jar no
podem estar no $CLASSPATH ou no local
$OMNIHOME/gates/java simultaneamente.
MySQL 5.0 e 5.1 MySQL Connector/J (com.mysql.jdbc.Driver)
Oracle 10g e 11g Oracle JDBC Thin Driver
(oracle.jdbc.driver.OracleDriver)
Sybase 12.5 e 15.5 Sybase jConnect for JDBC
(com.sybase.jdbc4.jdbc.SybDriver)
Obtendo o Gateway
O pacote de instalao do gateway e os componentes relacionados esto
disponveis para download da IBM.
possvel obter o pacote de instalao do gateway e os componentes relacionados
no website do IBM Passport Advantage Online, na seguinte URL:
IBM Tivoli Netcool/OMNIbus Gateway para JDBC 3
http://www-306.ibm.com/software/howtobuy/passportadvantage/
pao_customers.htm
Para instalaes do gateway no IBM Tivoli Netcool/OMNIbus V7.2.1 (e anteriores),
o Gateway Java Support Package (gateway-libngjava) e o Gateway NGtkTK
Support Package (gateway-libngtktk) so fornecidos separadamente do pacote de
instalao do gateway, e podem ser obtidos no website do IBM Passport
Advantage Online.
Para instalaes no IBM Tivoli Netcool/OMNIbus V7.3.0 (e posteriores), o Gateway
Java Support Package e o Gateway NGtkTK Support Package so empacotados
com o pacote de instalao do gateway.
Voc deve obter os drivers JDBC para o banco de dados de destino do fornecedor
do banco de dados.
Viso Geral do Gateway
O Gateway para JDBC usa o Gerenciador JDBC integrado no IBM JVM (fornecido
com o Tivoli Netcool/OMNIbus) para trocar alertas entre ObjectServers
Netcool/OMNIbus e bancos de dados externos. Ele se comunica com os bancos de
dados suportados usando drivers JDBC Java Tipo 4 fornecidos pelos fornecedores
dos bancos de dados.
Operao do Gateway
No modo de ressincronizao unidirecional padro, o gateway processa ciclos
Insert, Delete, Update, Control (IDUC) da seguinte maneira:
1. O componente leitor-gravador recebe dados do ObjectServer.
2. O componente leitor-gravador formata os dados em um mapa, usando nomes
de campos como chaves, e passa os dados mapeados para o componente
Gerenciador do gateway.
3. O componente gerenciador usa o tipo da tabela de origem (status, dirio ou
detalhes) e o estado do ciclo de vida do alerta (o alerta existe ou no no cache
do gateway) para formar a instruo SQL necessria para enviar a atualizao
do alerta para o banco de dados de destino.
4. O componente gerenciador grava a instruo SQL no lote atual.
Se no existir um lote, o componente gerenciador cria um.
5. O componente gerenciador processa todos os dados no ciclo IDUC atual, salva
o lote em disco e coloca o lote na fila no cache do gateway.
O cache salvo como parte desse processo.
6. O componente consumidor l o lote da fila, lendo-o do disco se necessrio.
7. O componente consumidor processa todas as instrues SQL contidas no lote.
8. O componente processador executa partes do lote atomicamente.
Persistncia e Confiabilidade
O gateway gerencia duas partes de dados persistentes: o cache de alertas
conhecidos e lotes pendentes, e os prprios lotes. Os lotes somente so processados
depois que o lote e o cache tiverem sido salvos com xito no disco. Se o gateway
encerrar inesperadamente, deve ser possvel recuperar o estado confirmado sem
duplicar ou perder dados.
Nota: Uma recuperao bem-sucedida tambm depende da operao correta do
JVM subjacente e do sistema operacional do host.
O mecanismo de envio em lote opera efetivamente como um mecanismo store and
forward (SAF). Erros fatais, tais como erros na anlise de SQL ou erros de restrio,
resultam em os dados invlidos serem registrados em log e, em seguida,
descartados.
O gateway tambm suporta atualizaes atmicas e durveis ao cache e a arquivos
em lote. Isso protege contra a distoro de dados e assegura que os dados na rea
de trabalho do gateway sejam sempre vlidos.
Ressincronizao
O gateway pode executar dois tipos de ressincronizao: unidirecional e
bidirecional. A propriedade Gate.Jdbc.ResyncMode fornece quatro modos de
ressincronizao para controlar como o gateway executa ressincronizaes.
Os seguintes modos de ressincronizao esto disponveis:
1. nenhum
O gateway no executa ressincronizao.
2. Unidirecional
O gateway compara o contedo de seu cache com o contedo da tabela
alerts.status do ObjectServer. Alertas novos, excludos e atualizados so
encaminhados para o banco de dados de destino, ressincronizando-o assim com
o ObjectServer.
3. Bidirecional
O gateway armazena inicialmente em seu cache os alertas abertos armazenados
no banco de dados de destino. Em seguida, ele compara o contedo de seu
cache com o contedo da tabela alerts.status do ObjectServer e ressincroniza
o banco de dados de destino de acordo com isso.
Nota: A ressincronizao bidirecional resulta em varreduras integrais da tabela
na tabela de status do banco de dados de destino. Uma grande quantia de
histrico de eventos resultar em uma longa ressincronizao.
4. Automtica
Este o modo padro de ressincronizao. Ele faz com que o gateway opere no
modo de ressincronizao unidirecional por padro. No entanto, se o cache do
gateway estiver vazio na inicializao (o que normalmente ocorre somente na
primeira vez que o gateway executado), ele faz com que o gateway opere no
modo de ressincronizao bidirecional. Nesse modo, somente as tabelas
alerts.status e alerts.journal do ObjectServer so ressincronizadas ao banco
de dados de destino. possvel ressincronizar manualmente outras tabelas do
ObjectServer usando comandos de transferncia.
Deduplicao
O gateway deduplica atualizaes de alertas e dirios. Isso resulta em
ressincronizao eficiente, porque somente alertas que foram alterados so
encaminhados para o banco de dados de destino. Tambm significa que
atualizaes a campos que no esto includos no arquivo de definio de mapa,
ou campos que no so requeridos no banco de dados de destino (tais como
campos de mudana de estado), so ignorados.
Modo de Auditoria e Modo de Relatrio
O gateway pode operar em um de dois modos, modo de auditoria ou modo de
relatrio. No modo de auditoria, o gateway arquiva eventos em um banco de
dados de destino para propsitos de auditoria. No modo de relatrio, o gateway
arquiva eventos em um banco de dados de destino para uso com ferramentas de
relatrio tais como o Tivoli Netcool/Reporter ou o Tivoli Common Reporting.
Modo de Auditoria
Se desejar executar o gateway no modo de auditoria, voc dever configurar o
esquema apropriado do banco de dados. Se estiver usando o Gateway para JDBC
como substituto do Gateway para Oracle ou do Gateway para ODBC, sua
configurao existente do banco de dados de destino pode no requerer nenhuma
mudana. Caso contrrio, voc dever instalar a biblioteca gateway-nco-g-jdbc-
audit-scripts. Essa biblioteca contm os scripts SQL necessrios para criar o
esquema do banco de dados de destino.
O modo de auditoria suportado para os seguintes bancos de dados:
v DB2
v Informix
v Microsoft SQL Server
v MySQL
v Oracle
v Sybase
No modo de auditoria, uma nova linha criada na tabela do banco de dados para
cada novo alerta e atualizao de alerta. O banco de dados de destino pode conter
diversas linhas para cada alerta, dependendo de seu histrico de atualizao. No
modo de auditoria, dados existentes no banco de dados de destino nunca so
atualizados ou excludos.
Inseres, atualizaes e excluses so mapeados da seguinte maneira:
v Novos alertas fazem com que uma nova linha seja inserida no banco de dados
de destino.
v Atualizaes de alertas fazem com que uma nova linha contendo os valores do
alerta atualizado seja inserida no banco de dados de destino. Os valores de
alertas anteriores so preservados em linhas criadas anteriormente.
v Excluses de alertas fazem com que uma nova linha contendo os valores finais
do alerta seja inserida no banco de dados de destino. A maioria dos dados do
alerta no est mais disponvel no momento da excluso, portanto, a linha de
excluso conter principalmente valores NULL. Os valores de alertas anteriores
so preservados em linhas criadas anteriormente.
Modo de Relatrio
Se desejar executar o gateway no modo de relatrio, voc dever configurar o
esquema apropriado do banco de dados. Se estiver usando o Gateway para JDBC
como substituto do Gateway para Oracle ou do Gateway para ODBC, sua
configurao existente do banco de dados de destino pode no requerer nenhuma
mudana. Caso contrrio, voc dever instalar a biblioteca gateway-nco-g-jdbc-
reporting-scripts. Essa biblioteca contm os scripts SQL necessrios para criar o
esquema do banco de dados de destino.
O modo de relatrio suportado para os seguintes bancos de dados:
v DB2
v Informix
v Microsoft SQL Server
v Oracle
v Sybase
No modo de relatrio, o banco de dados de destino contm uma linha para cada
novo alerta e essa linha atualizada sempre que o alerta atualizado. Isso requer
que o banco de dados de destino seja configurado para relatrio, o que envolve
vrios acionadores para gerar os dados do relatrio. No modo de relatrio, o
gateway essencialmente replica a tabela de status da origem do ObjectServer para
o banco de dados de destino.
Inseres, atualizaes e excluses so mapeados da seguinte maneira:
v Novos alertas fazem com que uma linha, exclusiva para o alerta, seja inserida no
banco de dados de destino.
v Atualizaes de alertas fazem com que a linha do alerta existente seja atualizada
com os novos valores do alerta.
v Excluses de alertas fazem com que a linha do alerta existente seja atualizada
com um registro de data e hora da excluso.
Dimensionamento do Banco de Dados
Os fatores principais que afetam o crescimento do banco de dados (e portanto os
requisitos de dimensionamento de seu banco de dados) so: o tamanho de um
evento, a taxa qual os eventos so passados para o banco de dados e a
combinao do modo operacional do gateway (auditoria ou relatrio) e a mistura
de tipos de evento (insero, atualizao ou excluso). Os tpicos a seguir
discutem esses fatores e como avaliar seu sistema para determinar os requisitos de
dimensionamento ideais.
Tamanho do Evento do Netcool/OMNIbus
O tamanho da linha do banco de dados de destino deve corresponder
proximamente ao tamanho do evento do Netcool/OMNIbus. Isso devido aos
esquemas de banco de dados fornecidos espelharem amplamente o esquema do
Netcool/OMNIbus.
O tamanho de uma linha ou evento individual depende dos seguintes fatores:
v Tamanhos de campos individuais
v Se campos customizados foram includos
v Se campos padro foram omitidos
v Se campos esto realmente preenchidos com dados
O tamanho de campo mximo permissvel pode ser determinado descrevendo as
tabelas do ObjectServer executando nco_sql e executando os seguintes comandos:
> describe alerts.status
>go
O tamanho mximo possvel de um evento pode ser determinado por uma soma
dos tamanhos dos campos de uma tabela.
A tabela a seguir mostra os tamanhos de linha mximos permissveis para uma
instalao padro do Netcool/OMNIbus 7.3.1:
Tabela Tamanho mximo de linha
alerts.status 10284 bytes
alerts.journal 4347 bytes
alerts.details 1028 bytes
A tabela a seguir mostra os tamanhos de linha tpicos que voc provavelmente
encontrar na maioria das aplicaes prticas:
Tabela Tamanho tpico operacional de linha
alerts.status 2048 bytes
alerts.journal 512 bytes
alerts.details 0 bytes
Taxa de Eventos
A taxa qual os eventos so passados para o gateway para encaminhamento ao
banco de dados pode ser avaliada empiricamente (observada durante um perodo
de tempo), ou uma avaliao do rendimento esperado ou requerido pode ser feita.
A extenso com que o rendimento est correlacionado entrada de origens de
dados tais como anlises pode ser afetada significativamente pela deduplicao. A
deduplicao converte inseres no ObjectServer (com os mesmos valores de
Identifier) em atualizaes (aumentando incrementalmente o campo Tally),
limitando assim o tamanho do ObjectServer e potencialmente limitando o tamanho
do banco de dados de destino. O efeito da deduplicao pode ser o de reduzir o
volume de dados por um fator de 10. Para calcular a reduo de volume que a
deduplicao tem sobre um determinado fluxo de dados, calcule a proporo de
eventos reais para eventos inseridos em alerts.status dividindo o clculo
sum(Tally) pela contagem count(*).
Condies de filtro aplicadas na configurao do gateway tambm restringiro o
interesse do gateway a um subconjunto de eventos colocados no ObjectServer, e
portanto limitaro o tamanho do banco de dados de destino.
Modo de Operao
Os gateways de banco de dados operam em um de dois modos:
v Auditoria: No modo de auditoria, todos os tipos de eventos do
Netcool/OMNIbus (inseres, atualizaes e excluses) so encaminhados como
inseres, mantendo assim uma trilha de auditoria no banco de dados de
destino, sujeita (ou restringida pela) granularidade do ciclo IDUC.
v Relatrio: No modo de relatrio, atualizaes e excluses do Netcool/OMNIbus
so encaminhadas como atualizaes a linhas inseridas anteriormente.
Um gateway operando no modo de relatrio provavelmente preencher o banco de
dados com menos dados. No entanto, acionadores includos nos esquemas de
banco de dados padro preenchem tabelas adicionais com dados resumidos, a
partir das quais os relatrio so executados. Tipicamente, uma tabela adicional ser
preenchida e mantida no banco de dados para cada relatrio que possa ser
executado. Essas tabelas so relativamente pequenas em comparao com a tabela
de status principal; consulte adiante para obter informaes adicionais.
Nota: Os gateways de banco de dados no excluem linhas de tabelas do banco de
dados de destino. Portanto, os bancos de dados de destino crescero em tamanho
indefinidamente se no ocorrer remoo ou arquivamento do banco de dados
como uma atividade separada. Isso independe do modo de operao do gateway.
Tabelas Monitoradas
A configurao do gateway determina quais tabelas do Netcool/OMNIbus so
monitoradas. A maioria dos usurios configura gateways para monitorar apenas a
tabela alerts.status, mas possvel tambm monitorar as tabelas alerts.journal
e alerts.details. A tabela alerts.details, mesmo se monitorada pelo gateway,
geralmente no preenchida com dados em configuraes padro de anlise. Em
geral, ela preenchida somente em cenrios de depurao ou configurao.
Atualmente, nenhum dos relatrios padro do gateway de banco de dados
depende de dados recebidos da tabela alerts.details.
Embora os gateways de banco de dados sejam usados primariamente para receber
dados das trs tabelas principais (status, dirios e detalhes), outras tabelas podem
ser monitoradas em uma configurao customizada. Isso impactaria os requisitos
de tamanho do banco de dados.
Entradas no Dirio
As entradas no dirio se enquadram em duas categorias principais: aquelas
geradas automaticamente por automaes, por exemplo, quando um evento
reconhecido ou excludo por uma ferramenta de clique com o boto direito
definida no visualizador de eventos, e aquelas criadas por usurios. Os dirios
gerados automaticamente geralmente so curtos, e o proporo do nmero de
entradas no dirio para o nmero de eventos baixa. O tamanho dos dirios
gerados pelo usurio determinado pelo comportamento ou pela poltica do
usurio individual.
Tabelas de Relatrio
Conforme mencionado anteriormente, os esquemas de relatrio contm outras
tabelas alm das anlogas das trs tabelas principais do Netcool/OMNIbus (status,
dirio e detalhes). Essas tabelas se enquadram em duas categorias: tabelas das
quais relatrios so gerados (uma por definio de relatrio; atualmente existem
quatro, geralmente chamadas rep_audit_fieldname, e contendo uma linha por
evento de status) e tabelas de dados na maioria estticos ou que raramente
mudam. O segundo tipo so geralmente pequenas e podem ser ignoradas em
clculos de dimensionamento, ou absorvidas nas margens de erro. As linhas em
tabelas usadas para gerar relatrios tipicamente tm menos que 256 bytes.
Implementao e Ajuste do Destino
A multiplicao da taxa de eventos pelo tamanho do evento fornece uma boa
estimativa bruta do tamanho do banco de dados de destino, mas a implementao
e os ajustes do banco de dados podem facilmente e significativamente aumentar
esses clculos. Um fator a ser considerado o tamanho de bloco e quo vazio ou
cheio voc permite que os blocos de dados estejam quando so atualizados.
Dependendo da implementao do banco de dados e do nvel de ajuste, possvel
esperar aumentar a estimativa bruta por um fator de dois a quatro.
Avaliando o Sistema
Uma maneira de avaliar o sistema seria executar o Gateway de Arquivo Simples e
monitorar o crescimento de seu arquivo de sada. No entanto, observe que a sada
desse gateway ser mais prxima de um gateway de banco de dados executando
no modo de auditoria que no modo de relatrio, porque todos os tipos de eventos
so gravados (anlogo a inseridos) no arquivo de sada. No obstante, uma anlise
do arquivo de sada fornecer uma percepo sobre a combinao de inseres e
atualizaes encontradas em um determinado sistema. Para um gateway de banco
de dados executando no modo de relatrio, atualizaes e excluses podem ser
grandemente descontadas nos clculos.
Nota: Nmeros inteiros com 4 bytes em um ObjectServer se igualaro a quantias
de dados muito maiores na sada do Gateway de Arquivo Simples devido a sua
representao em formato de caractere.
Use a seguinte frmula para calcular um requisito bruto de dimensionamento de
banco de dados anual:
<inseres por dia> * (<bytes por evento> + (<nmero de tabelas de
relatrio> * <bytes por linha de tabela de relatrio>) * <52 semanas> * <7
dias>) / <bytes por GB>
For exemplo, usando os seguintes valores:
v 10.000 inseres por dia, aps deduplicao
v 2048 bytes por evento
v 4 tabelas de relatrio
v 256 bytes por linha de tabela de relatrio
v 52 semanas
v dirios e detalhes no includos
O requisito de armazenamento do banco de dados anual seria:
(10000 * (2048 + (4 * 256)) * 52 * 7) / 1024^3 = 10.4 GB
<inseres por dia> * (<bytes por evento> + (<nmero de tabelas de
relatrio> * <bytes por linha de tabela de relatrio>) * <52 semanas> * <7
dias>) / <bytes por GB>
Instalando o Gateway no Tivoli Netcool/OMNIbus V7.2.0 e 7.2.1
O processo de instalao de gateways no Tivoli Netcool/OMNIbus V7.2.0 e 7.2.1
consiste no download do pacote de instalao adequado e na instalao de cada
uma das correes contidas no pacote.
O pacote de instalao e as correes para o gateway so fornecidos como
arquivos. O aplicativo de gerenciamento de archive que voc usa para extrair os
arquivos deve estar apto a preservar a estrutura de diretrio contida no archive na
extrao.
Viso Geral da Instalao
O Gateway para JDBC e seus pacotes relacionados so instalados conforme
descrito a seguir.
Voc deve instalar o gateway e os componentes associados na seguinte ordem:
1. Instale o pacote do modo de relatrio ou do modo de auditoria, conforme
necessrio.
2. Instale o Gateway Java Support Package (gateway-libngjava) e o Gateway
NGtkTK Support Package (gateway-libngtktk) de acordo com as instrues
fornecidas com seus pacotes de instalao.
3. Instale o gateway.
4. Instale os drivers JDBC para o banco de dados de destino.
Voc deve obter os drivers do fornecedor do banco de dados e instal-los de
acordo com as instrues do fornecedor.
Para obter mais informaes, consulte o manual Configurando a Conexo com
o Banco de Dados na pgina 17.
Instalando as Bibliotecas dos Modos de Auditoria e de
Relatrio
Para executar o gateway no modo de auditoria ou de relatrio, voc deve
configurar o esquema de banco de dados apropriado. Se estiver usando o Gateway
para JDBC como substituto do Gateway para Oracle ou do Gateway para ODBC,
sua configurao existente do banco de dados de destino pode no requerer
nenhuma mudana. Caso contrrio, voc dever instalar a biblioteca
gateway-nco-g-jdbc-audit-scripts ou a biblioteca gateway-nco-g-jdbc-reporting-
scripts, conforme necessrio. Essas bibliotecas contm os scripts necessrios para
criar os esquemas do banco de dados de destino.
Para instalar a biblioteca de scripts de auditoria ou a biblioteca de scripts de
relatrio, use as seguintes etapas:
1. Extraia os arquivos no archive do pacote para um diretrio temporrio, temp.
2. Instale o pacote requerido da seguinte maneira:
v Em sistemas operacionais UNIX e Linux, execute o seguinte comando:
$OMNIHOME/install/nco_patch -install /temp/script_package
v Em sistemas operacionais Windows, copie todos os arquivos no diretrio
temp\patches\script_package\gates para o seguinte diretrio:
%OMNIHOME%\gates
em que script_package o pacote de scripts de auditoria ou o pacote de
scripts de relatrio, conforme necessrio.
Os scripts instalados esto localizados no diretrio $OMNIHOME/gates/audit ou
$OMNIHOME/gates/reporting.
Depois de instalar os scripts, possvel us-los para criar um esquema do banco
de dados para uso com o gateway. Para obter mais informaes, consulte o manual
Configurando o Esquema do Banco de Dados na pgina 16.
Instalando o Gateway nos Sistemas Operacionais UNIX e
Linux
Para instalar o gateway nos sistemas operacionais UNIX e Linux, use as seguintes
etapas:
1. Faa download do pacote de instalao para o gateway no Web site do
Passport Advantage Online:
pao_customers.htm
2. Faa um backup de todos os arquivos de configurao existentes que voc
queira manter.
3. Extraia o contedo do pacote de instalao para um diretrio temporrio.
4. No diretrio temporrio, localize e leia o arquivo README.txt.
O arquivo README.txt dir se voc precisa fazer download de alguma correo
adicional no Web site do Passport Advantage Online.
5. Localize o diretrio patches (no diretrio que contm o arquivo README.txt).
Esse diretrio contm as correes principais do gateway.
6. Consulte o arquivo README.txt para determinar a ordem na qual as correes
devem ser instaladas.
7. Instale cada correo, na ordem correta, executando o seguinte comando:
$OMNIHOME/install/nco_patch -install patch_path
em que patch_path o caminho para o arquivo de correo extrado.
Nota: Em qualquer ponto no processo de instalao, voc poder ver quais
correes foram instaladas executando o seguinte comando:
$OMNIHOME/install/nco_patch -print=id
Instalando o Gateway nos Sistemas Operacionais Windows
Para instalar o gateway nos sistemas operacionais Windows, execute as seguintes
etapas:
pao_customers.htm
queira manter.
4. No diretrio temporrio, localize e leia o arquivo README.txt.
O arquivo README.txt dir se voc precisa fazer download de alguma correo
adicional no Web site do Passport Advantage Online.
5. Localize o diretrio patches (no diretrio que contm o arquivo README.txt).
Esse diretrio contm as correes principais do gateway.
6. Extraia os arquivos de correo para o seguinte diretrio:
%OMNIHOME%
Instalando o Gateway no Tivoli Netcool/OMNIbus V7.3.0, V7.3.1 ou
Posterior
Com a introduo do Tivoli Netcool/OMNIbus V7.3.0 e V7.3.1, todos os gateways
so instalados usando o instalador do Tivoli Netcool/OMNIbus. Voc pode instalar
o gateway usando o assistente de instalao, usando um instalador baseado em
texto (modo de console) ou usando as configuraes predefinidas em um arquivo
de texto (modo silencioso).
O pacote de instalao e as correes para o gateway so fornecidos como
arquivos. O aplicativo de gerenciamento de archive que voc usa para extrair os
arquivos deve estar apto a preservar a estrutura de diretrio contida no archive na
extrao.
Viso Geral da Instalao
O Gateway para JDBC e seus pacotes relacionados so instalados conforme
descrito a seguir.
Voc deve instalar o gateway e os componentes associados na seguinte ordem:
1. Instale o pacote do modo de relatrio ou do modo de auditoria, conforme
necessrio.
2. Instale o gateway.
3. Instale os drivers JDBC para o banco de dados de destino.
Voc deve obter os drivers do fornecedor do banco de dados e instal-los de
acordo com as instrues do fornecedor.
Para obter mais informaes, consulte o manual Configurando a Conexo com
o Banco de Dados na pgina 17.
Instalando as Bibliotecas dos Modos de Auditoria e de
Relatrio
Para executar o gateway no modo de auditoria ou de relatrio, voc deve
configurar o esquema de banco de dados apropriado. Se estiver usando o Gateway
para JDBC como substituto do Gateway para Oracle ou do Gateway para ODBC,
sua configurao existente do banco de dados de destino pode no requerer
nenhuma mudana. Caso contrrio, voc dever instalar a biblioteca
gateway-nco-g-jdbc-audit-scripts ou a biblioteca gateway-nco-g-jdbc-reporting-
scripts, conforme necessrio. Essas bibliotecas contm os scripts necessrios para
criar os esquemas do banco de dados de destino.
Para instalar a biblioteca de scripts de auditoria ou a biblioteca de scripts de
relatrio, use as seguintes etapas:
1. Inicie o assistente de instalao:
v Em sistemas operacionais UNIX e Linux, execute o seguinte comando:
$NCHOME/omnibus/install/nco_install_integration
v Em sistemas operacionais Windows, execute o seguinte comando:
%NCHOME%\omnibus\install\nco_install_integration
2. Escolha instalar o pacote de scripts de auditoria ou o pacote de scripts de
relatrio e siga as instrues na tela para concluir a instalao.
Os scripts instalados esto localizados no diretrio $OMNIHOME/gates/audit ou
$OMNIHOME/gates/reporting.
Depois de instalar os scripts, possvel us-los para criar um esquema do banco
de dados para uso com o gateway. Para obter mais informaes, consulte o manual
Configurando o Esquema do Banco de Dados na pgina 16.
Instalando o Gateway nos Sistemas Operacionais UNIX e
Linux
Para instalar o gateway nos sistemas operacionais UNIX e Linux, use as seguintes
etapas:
pao_customers.htm
queira manter.
4. Para instalar o gateway usando o assistente de instalao, execute as seguintes
etapas:
a. Execute o seguinte comando:
$NCHOME/omnibus/install/nco_install_integration
b. Quando o assistente de instalao for iniciado, especifique o diretrio
extrado que contm o arquivo README.txt como o local dos arquivos de
instalao do gateway.
c. Aceite as condies da licena.
5. Para instalar o gateway usando o modo do console, use as etapas a seguir:
$NCHOME/omnibus/install/nco_install_integration -i console
b. Quando o instalador baseado em texto for iniciado, especifique o diretrio
6. Para instalar o gateway usando o modo silencioso, use as etapas a seguir:
a. Crie um arquivo de texto denominado reponse.txt e inclua as seguintes
entradas:
PROBE_OR_GATE_LOCATION=README_directorypath
LICENSE_ACCEPTED=true
em que README_directorypath o caminho para o diretrio que contm o
arquivo README.txt no pacote extrado.
b. Execute o seguinte comando:
$NCHOME/omnibus/install/nco_install_integration -i silent -f
response_path/response.txt
em que response_path o caminho completo para o arquivo response.txt.
Em cada caso, o gateway instalado no diretrio $NCHOME/omnibus/gates.
Instalando o Gateway nos Sistemas Operacionais Windows
Para instalar um gateway nos sistemas operacionais Windows, use as seguintes
etapas:
pao_customers.htm
queira manter.
3. Extraia o contedo do pacote em um diretrio temporrio.
4. Para instalar o gateway usando o assistente de instalao, execute as seguintes
etapas:
%NCHOME%\omnibus\install\nco_install_integration
b. Quando o assistente de instalao for iniciado, especifique o diretrio
5. Para instalar o gateway usando o modo do console, use as etapas a seguir:
%NCHOME%\omnibus\install\nco_install_integration -i console
b. Quando o instalador baseado em texto for iniciado, especifique o diretrio
6. Para instalar o gateway usando o modo silencioso, use as etapas a seguir:
a. Crie um arquivo de texto denominado reponse.txt e inclua as seguintes
entradas:
PROBE_OR_GATE_LOCATION=README_directorypath
LICENSE_ACCEPTED=true
em que README_directorypath o caminho para o diretrio que contm o
arquivo README.txt no pacote extrado.
b. Execute o seguinte comando:
%NCHOME%\omnibus\install\nco_install_integration -i silent -f
response_path\response.txt
em que response_path o caminho completo para o arquivo response.txt.
Em cada caso, o gateway instalado no diretrio %NCHOME%\omnibus\gates.
Configurando variveis de ambiente
Pode ser necessrio configurar algumas variveis de ambiente para definir o
ambiente de trabalho do gateway.
Antes de executar o gateway em um sistema operacional Windows, assegure que a
varivel de ambiente %PATH% contenha a localizao do arquivo JVM.DLL. A
localizao padro de JVM.DLL :
%NCHOME%/platform/win32/jre_1.x.y/jre/bin/j9vm
em que x e y so determinados pela verso do Netcool/OMNIbus que est sendo
executada.
Configurando Detalhes de Comunicao
Para ativar a comunicao entre o gateway e o ObjectServer, voc deve configurar
detalhes de comunicao para o ObjectServer e o gateway usando o Editor do
Servidor Netcool/OMNIbus (nco_xigen) e criar uma entrada para o ObjectServer
no arquivo de interfaces $NCHOME/etc/omni.dat).
Se o ObjectServer j estiver configurado e o gateway ir ser executado da mesma
instalao, no necessrio configurar detalhes de comunicao para o
ObjectServer.
Em sistemas operacionais UNIX e Linux, use o seguinte comando para iniciar o
Server Editor:
$NCHOME/omnibus/bin/nco_xigen
Em sistemas operacionais Windows, use o seguinte comando para iniciar o Server
Editor:
Iniciar > Programas > NETCOOL Suite > Utilitrios do Sistema > Server Editor
Voc deve tambm incluir uma entrada do servidor gateway no arquivo de
interfaces. possvel fazer isso usando o Server Editor. Como alternativa, em
sistemas operacionais Unix e Linux, possvel editar o arquivo de interfaces e
ger-lo novamente usando o utilitrio nco_igen. O nome padro do servidor
gateway G_JDBC.
Se houver um firewall entre o gateway e o ObjectServer, configure o ObjectServer
para usar uma porta fixa para IDUC e assegure que a porta principal e a porta
IDUC do ObjectServer estejam abertas no firewall. Por padro o ObjectServer usa
uma porta IDUC aleatria.
Para obter informaes adicionais sobre o uso do Editor de Servidor e do arquivo
de interfaces, consulte o IBM Tivoli Netcool/OMNIbus Installation and Deployment
Guide (SC14-7604-00).
Configurando o Esquema do Banco de Dados
A configurao do esquema do banco de dados envolve a execuo dos scripts
SQL do modo de auditoria ou de relatrio apropriados para o banco de dados de
destino. Os scripts fornecidos nas bibliotecas dos modos de auditoria e de relatrio
so projetados para cobrir casos de uso gerais. Provavelmente ser necessrio
modific-los para trabalhar com as configuraes de seu banco de dados ou para
adequar-se a seus requisitos particulares.
As bibliotecas dos modos de auditoria e de relatrio contm scripts SQL que criam
todos os objetos de esquema de banco de dados necessrios para armazenar dados
processados pelo gateway, incluindo o espao de tabela, espao de tabela
temporrio, relator, tabelas (status, journal e details), ndices e restries.
Use os scripts do modo de auditoria ou os scripts do modo de relatrio para criar
os objetos de esquema do banco de dados, conforme necessrio. Consulte Modo
de Auditoria e Modo de Relatrio na pgina 6 para obter detalhes sobre como o
gateway opera em cada modo.
Executando os Scripts
Os scripts instalados esto localizados em subdiretrios dos diretrios
$OMNIHOME/gates/audit e $OMNIHOME/gates/reporting, denominados para o banco
de dados de destino que eles configuram. Por exemplo, os scripts para o IBM DB2
esto localizados nos subdiretrios $OMNIHOME/gates/audit/db2 e
$OMNIHOME/gates/reporting/db2.
Antes de executar os scripts, voc deve consultar a documentao de seu banco de
dados para obter instrues sobre como o banco de dados usa scripts SQL.
Consulte tambm os arquivos leia-me nas bibliotecas de scripts e os comentrios
nos arquivos de script para detalhes de quaisquer limitaes ou restries
especficas de scripts individuais.
Migrando de um Gateway Existente
Se estiver usando o Gateway para JDBC como substituto do Gateway para Oracle
ou do Gateway para ODBC, sua configurao existente do banco de dados de
destino pode no requerer nenhuma mudana. Nesses casos, no h necessidade
de executar os scripts de esquema do banco de dados.
A migrao de um banco de dados de destino existente deve ser feita durante um
perodo quieto para o ObjectServer. Isso assegurar que um nmero mnimo de
eventos se perca para arquivamento enquanto o gateway no estiver ativo.
Antes de migrar de um banco de dados de destino existente, execute um
encerramento correto do gateway antigo para assegurar que os dados existentes
sejam encaminhados para o novo gateway. O novo gateway ir executar uma
ressincronizao de eventos do ObjectServer, portanto, problemas com o
encerramento do gateway antigo no devem resultar em perda de dados. No
entanto, a ressincronizao pode resultar em dados de evento duplicados e
mensagens de erro subsequentes se violaes de restrio no banco de dados de
destino forem acionadas.
Ressincronizao Bidirecional
Na primeira vez que o gateway for executado, ele detectar que no h alertas em
seu cache e executar uma ressincronizao bidirecional. Isso ir detectar quaisquer
eventos no banco de dados de destino que ainda estavam abertos quando o
gateway antigo foi executado pela ltima vez e que foram subsequentemente
fechados e excludos do ObjectServer. Isso permite que excluses de eventos que
foram perdidas quando o gateway estava sendo migrado sejam recuperadas para o
banco de dados de destino. Em execues subsequentes, quando houver alertas em
seu cache, o gateway executar uma ressincronizao unidirecional na inicializao.
Nota: A ressincronizao bidirecional resulta em varreduras integrais da tabela na
tabela de status do banco de dados de destino. A quantia de tempo necessria para
a concluso da ressincronizao proporcional ao tamanho da tabela de banco de
dados. Uma grande quantia de histrico de eventos resultar em uma longa
ressincronizao.
Configurando a Conexo com o Banco de Dados
A configurao da conexo com o banco de dados envolve configurar o driver
JDBC e especificar valores para as propriedades relacionadas conexo.
Drivers JDBC
Voc deve obter o driver JDBC do fornecedor do banco de dados e instal-lo de
acordo com as instrues do fornecedor. Os drivers geralmente so fornecidos
como Java archives (.jar).
Voc deve copiar o arquivo .jar do driver JDBC para o seguinte diretrio:
$OMNIHOME/gates/java
Propriedade de Conexo do Banco de Dados
Para ativar o gateway para se comunicar com o banco de dados de destino, voc
deve especificar valores para as seguintes propriedades:
v Gate.Jdbc.Connections
Esta propriedade especificar o nmero de conexes que o gateway faz com o
banco de dados de destino. Aumentar o nmero de conexes aumenta o nvel de
paralelismo disponvel para o gateway e potencialmente aumenta o
desempenho. Inicie com valores baixos conforme necessrio para localizar o
nvel de desempenho desejado.
v Gate.Jdbc.Driver
Esta propriedade especifica o driver JDBC.
v Gate.Jdbc.Url
Esta propriedade especifica a URL do banco de dados de destino.
v Gate.Jdbc.Username
Esta propriedade especificar o nome de usurio para o banco de dados de
destino.
v Gate.Jdbc.Password
Esta propriedade especifica a senha para o banco de dados de destino.
A tabela a seguir lista exemplos de valores para as propriedades Gate.Jdbc.Driver
e Gate.Jdbc.Url para uso com cada banco de dados. Consulte a documentao de
seu driver para obter informaes adicionais sobre a configurao de conexes com
o banco de dados. Os valores padro podem ser diferentes dependendo de sua
configurao.
Tabela 5. Exemplo de Valores de Propriedades de JDBC
DB2 LUW
Gate.Jdbc.Driver com.ibm.db2.jcc.DB2Driver
Gate.Jdbc.Url jdbc:db2://host_name:port/db_name
Em que host_name o nome da mquina host do
banco de dados, port o nmero da porta e db_name
o nome do banco de dados. Por exemplo:
jdbc:db2://server.example.ibm.com:9999/REPORTER
DB2 z/OS
Gate.Jdbc.Driver com.ibm.db2.jcc.DB2Driver
Tabela 5. Exemplo de Valores de Propriedades de JDBC (continuao)
Gate.Jdbc.Url jdbc:db2://host_name:port/db_name
o nome do banco de dados. Por exemplo:
jdbc:db2://server.example.ibm.com:9999/REPORTER
Informix
Gate.Jdbc.Driver com.informix.jdbc.IfxDriver
Gate.Jdbc.Url jdbc:informix-sqli://host_name:port/
db_name:INFORMIXSERVER=server_name
Em que host_name o nome da mquina host do banco
de dados, port o nmero da porta, db_name o
nome do banco de dados, e server_name o mesmo
que o host_name. Por exemplo:
jdbc:informix-sqli://server.example.ibm.com:1433/
REPORTER:INFORMIXSERVER=server.example.ibm.com
Microsoft SQL Server
Gate.Jdbc.Driver com.microsoft.sqlserver.jdbc.SQLServerDriver
Gate.Jdbc.Url jdbc:sqlserver://
host_name:port;databaseName=db_name
o nome do banco de dados. A port padro 1433. Por
exemplo:
jdbc:sqlserver://
server.example.ibm.com:1433;databaseName=REPORTER
MySQL
Gate.Jdbc.Driver com.mysql.jdbc.Driver
Gate.Jdbc.Url jdbc:mysql://host_name[,failover_host]:port/
db_name[?param1=value1&param2=value2]
banco de dados, host_failover o nome do host de
failover opcional, port o nmero da porta, db_name
o nome do banco de dados e param1 e param2 so
parmetros opcionais. A port padro 3306. Por
exemplo:
jdbc:mysql://server.example.ibm.com:3306/alerts
Oracle
Gate.Jdbc.Driver oracle.jdbc.driver.OracleDriver
Gate.Jdbc.Url jdbc:oracle:thin:@host_name:port:db_name
o nome do banco de dados. A port padro 1521. Por
exemplo:
jdbc:oracle:thin:@server.example.ibm.com:1521:
REPORTER
Tabela 5. Exemplo de Valores de Propriedades de JDBC (continuao)
Sybase
Gate.Jdbc.Driver com.sybase.jdbc4.jdbc.SybDriver
Gate.Jdbc.Url jdbc:sybase:Tds:host_name:port/
db_name[?property=value;]
banco de dados, port o nmero da porta, db_name
o nome do banco de dados e property um parmetro
opcional. Por exemplo:
jdbc:sybase:Tds:server.example.ibm.com:1521/
REPORTER
Configurando o Gateway
Depois de instalar o gateway, voc dever configur-lo para trabalhas com seu
ambiente operacional.
O pacote de instalao do gateway contm os arquivos de configurao necessrios
para executar o gateway. Os arquivos de configurao padro configuram o
gateway para operao no modo de relatrio.
A tabela a seguir lista os arquivos de configurao instalados com o pacote de
Tabela 6. Arquivos de Configurao do Gateway
Arquivo de Configurao Descrio
$OMNIHOME/etc/G_JDBC.props O arquivo de propriedades padro usado pelo
gateway. Esse arquivo configura o gateway para
operao no modo de relatrio.
$OMNIHOME/gates/jdbc/
audit.G_JDBC.props
O arquivo de propriedades usado para configurar
o gateway para operao no modo de auditoria.
audit.jdbc.map
O arquivo de definio de mapa usado para
configurar o gateway para operao no modo de
auditoria.
$OMNIHOME/gates/jdbc/G_JDBC.props Uma cpia do arquivo de propriedades padro
usado pelo gateway. Esse arquivo configura o
gateway para operao no modo de relatrio.
$OMNIHOME/gates/jdbc/jdbc.map O arquivo de definio de mapa padro usado
pelo gateway. Esse arquivo configura o gateway
para operao no modo de relatrio.
jdbc.rdrwtr.tblrep.def
O arquivo de definio de replicao de tabela
padro usado pelo gateway.
jdbc.startup.cmd
O arquivo de comando de inicializao padro
usado pelo gateway.
reporting.G_JDBC.props
O arquivo de propriedades usado para configurar
o gateway para operao no modo de relatrio. Ele
idntico ao arquivo de propriedades padro
G_JDBC.props.
Tabela 6. Arquivos de Configurao do Gateway (continuao)
Arquivo de Configurao Descrio
reporting.jdbc.map
O arquivo de definio de mapa usado para
configurar o gateway para operao no modo de
relatrio. Ele idntico ao arquivo de definio de
mapa padro jdbc.map.
Os tpicos a seguir contm informaes adicionais sobre a configurao do
gateway.
v Arquivo de propriedades
v Propriedades e Opes da Linha de Comandos
v Arquivo de Definio de Mapas na pgina 35
v Arquivo de Comando de Inicializao na pgina 36
v Transferncias de Tabelas Arbitrrias na pgina 36
v Arquivo de Definio de Replicao da Tabela na pgina 37
v Funes AfterIDUC e de Filtro na pgina 38
v Usando um Campo de Particionamento na pgina 39
v Filtrando Dados de Ressincronizao na pgina 39
v Arquivo de Log de Mensagens na pgina 40
v Modo FIPS e Criptografia na pgina 41
Para obter informaes adicionais sobre o uso de arquivos de configurao de
gateway, consulte o IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide
(SC14-7608-00).
Arquivo de propriedades
O arquivo de propriedades um arquivo de texto que contm um conjunto de
propriedades especficas do gateway e genricas do Netcool/OMNIbus e seus
valores correspondentes. possvel editar o arquivo de propriedades para
adequar-se a seu ambiente operacional.
O arquivo de propriedades padro instalado com o gateway, $OMNIHOME/etc/
G_JDBC.props, configura o gateway para operar no modo de relatrio.
Para configurar o gateway para operar no modo de auditoria, use as seguintes
etapas:
1. Copie $OMNIHOME/gates/jdbc/audit.G_JDBC.props para $OMNIHOME/etc/
G_JDBC.props.
2. Copie $OMNIHOME/gates/jdbc/audit.jdbc.map para $OMNIHOME/gates/jdbc/
jdbc.map.
Propriedades e Opes da Linha de Comandos
Voc usa as propriedades para definir o ambiente operacional do gateway.
possvel substituir os valores padro da propriedade editando o arquivo de
propriedades ou usando as opes de linha de comandos da propriedade.
As tabelas a seguir descrevem as propriedades principais requeridas para
configurar o Gateway para JDBC. Para obter informaes sobre propriedades e
opes de linha de comandos adicionais genricas do gateway Netcool/OMNIbus,
consulte o IBM Tivoli Netcool/OMNIbus Probe and Gateway Guide (SC14-7608-00).
As sees a seguir descrevem as propriedades usadas para configurar o gateway:
v Propriedades Comuns do Netcool/OMNIbus
v Propriedades de Gateway JDBC na pgina 23
v Propriedades Genricas do Gateway na pgina 28
v Propriedades Java na pgina 29
v Propriedades de Mapeamento na pgina 30
v Propriedades do Leitor/Gravador de Gateway na pgina 30
v Propriedades de Conexo na pgina 35
Propriedades Comuns do Netcool/OMNIbus
A Tabela 7 lista as propriedades comuns disponveis.
Tabela 7. Propriedades Comuns do Netcool/OMNIbus
Nome da propriedade
Opo da linha de
comandos Descrio
ConfigCryptoAlg string -configcryptoalg string Use esta propriedade para
especificar o algoritmo de
criptografia que o gateway
usa.
O padro AES.
ConfigKeyFile string -configkeyfile string Use esta propriedade para
especificar a chave de
criptografia com os dados
criptografados.
O padro "".
Connections integer -connections integer Use esta propriedade para
especificar o nmero mximo
de conexes do cliente que
podem ser feitas no servidor
gateway.
O padro 30.
MaxLogFileSize integer -maxlogfilesize integer Use essa propriedade para
especificar o tamanho (em
bytes) que o gateway aloca
para o arquivo de log.
Quando o arquivo de log
atinge esse tamanho, o
gateway o renomeia
anexando o sufixo .old e cria
um novo arquivo de log.
O padro 1024.
MessageLevel string -messagelevel string Use esta propriedade para
especificar o nvel de
relatrio das mensagens do
arquivo de log.
O padro warn.
Tabela 7. Propriedades Comuns do Netcool/OMNIbus (continuao)
Nome da propriedade
Opo da linha de
comandos Descrio
MessageLog string -messagelog string Use essa propriedade para
especificar o local do arquivo
de log de mensagens.
O padro
'$OMNIHOME/log/G_JDBC.log'.
Name string -name string Use esta propriedade para
especificar o nome da
instncia de gateway atual.
Se voc quiser executar
vrios gateways em uma
mquina, dever usar um
nome diferente para cada
instncia.
O padro 'G_JDBC'.
Props.CheckNames boolean Nenhuma linha de comandos
equivalente.
Use esta propriedade para
instruir o gateway a encerrar
se qualquer propriedade no
arquivo de propriedades for
configurada para um valor
invlido.
O padro TRUE.
PropsFile string -propsfile string Use esta propriedade para
de propriedades do gateway.
O padro
$OMNIHOME/etc/G_JDBC.props.
UniqueLog boolean -uniquelog boolean Use esta propriedade para
especificar que os nomes dos
arquivos de log so criados
exclusivamente incluindo o
ID do Processo (PID) do
gateway ao nome do
arquivo.
O padro FALSE.
Propriedades de Gateway JDBC
A Tabela 8 lista as propriedades de gateway JDBC disponveis.
Tabela 8. Propriedades de Gateway JDBC
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Jdbc.ActionCodeField
string
-jdbcactioncodefield
string
Use essa propriedade para
especificar o nome da coluna para
informaes de cdigo de ao
quando o gateway estiver no modo
de auditoria.
O padro 'ACTIONCODE'.
Tabela 8. Propriedades de Gateway JDBC (continuao)
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Jdbc.ActionTimeField
string
-jdbcactiontimefield
string
especificar o nome da coluna para
informaes de tempo da ao
quando o gateway estiver no modo
de auditoria.
O padro 'ACTIONTIME'.
Gate.Jdbc.Connections
integer
-jdbcconnections integer Use esta propriedade para
especificar o nmero de conexes
com o banco de dados de destino.
O padro 3.
Gate.Jdbc.DeletedAtField
string
-jdbcdeleteatfield
string
especificar o campo na tabela de
destino que usado para registrar
o tabela de destino de excluso de
um alerta.
Esta propriedade somente
requerida ao executar o gateway no
modo de relatrio.
O padro 'DELETEDAT'.
Gate.Jdbc.Details
TableName string
-jdbcdetailstablename
string
especificar o nome da tabela do
banco de dados de destino para
armazenar dados da tabela
alerts.details do ObjectServer.
O padro 'details'.
Gate.Jdbc.Driver string -jdbcdriver string Use esta propriedade para
especificar o driver JDBC.
O padro "".
Gate.Jdbc.DupIgnore string -jdbcdupignore string Use esta propriedade para
especificar quais campos ignorar ao
deduplicar atualizaes de alertas.
Esta propriedade pode tomar
diversos valores, separados por
espaos.
O padro "ActionCode
ActionTime LastModified
StateChange".
Gate.Jdbc.FatalErrors
string
-jdbcfatalerrors string Use esta propriedade para
especificar quais prefixos de
SQLSTATE so considerados fatais ao
processar um lote de alertas.
espaos.
O padro "0A 42".
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Jdbc.Initialization
String string
-jdbcinitialization
string string
especificar uma sequncia de
inicializao SQL a ser executada
na conexo com o banco de dados
de destino.
O padro "".
Gate.Jdbc.Journal
TableName string
-jdbcjournaltablename
string
especificar o nome do banco de
dados de destino para armazenar
dados da tabela alerts.journal do
ObjectServer.
O padro 'journal'.
Gate.Jdbc.MaxBatchSize
integer
-jdbcmaxbatchsize
integer
especificar o nmero mximo de
linhas a processar em um lote.
O padro 250.
Gate.Jdbc.Mode string -jdbcmode string
-jdbcaudit (Isto
equivalente a
Gate.Jdbc.Mode com um
valor de AUDIT.)
-jdbcreporter (Isso
equivalente a
Gate.Jdbc.Mode com um
valor de REPORTING.)
especificar o modo de operao do
gateway. Essa propriedade aceita os
seguintes valores:
AUDIT: O gateway executa no modo
de auditoria.
REPORTING: O gateway executado
no modo de relatrio.
O padro REPORTING.
Gate.Jdbc.OrderedWrites
integer
-jdbcorderedwrites
integer
Use essa propriedade para inserir
linhas da tabela de status antes das
linhas de dirio e de detalhes.
O padro 1.
Gate.Jdbc.Partitioning
Field string
-jdbcpartitioningfield
string
especificar o campo a ser usado
para particionamento.
O padro "".
Gate.Jdbc.Password string -jdbcpassword string Use esta propriedade para
especificar a senha para o banco de
dados de destino.
O padro "".
Gate.Jdbc.Reconnect
Timeout integer
-jdbcreconnecttimeout
integer
especificar o tempo (em segundos)
que o gateway espera antes de
tentar se reconectar ao banco de
dados de destino depois de perder
a conexo.
O padro 30.
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Jdbc.ResyncFilter
string
-jdbcresyncfilter
string
Use esta d para especificar um
filtro para restringir eventos abertos
no banco de dados de destino
quando o gateway est operando
no modo de ressincronizao
bidirecional.
O padro "".
Gate.Jdbc.ResyncMode
string
-jdbcresyncmode string
-jdbcresyncnone (Isto
equivalente a
com um valor de NONE.)
-jdbcresyncuni (Isto
equivalente a
com um valor de UNI.)
-jdbcresyncbi (Isto
equivalente a
com um valor de BI.)
-jdbcresyncauto (Isto
equivalente a
com um valor de AUTO.)
especificar um modo de
ressincronizao para o gateway.
Essa propriedade aceita os
seguintes valores:
NONE: O gateway no executa
ressincronizao.
UNI: O gateway opera no modo de
ressincronizao unidirecional.
BI: O gateway opera no modo de
ressincronizao bidirecional.
AUTO: O gateway opera no modo de
ressincronizao unidirecional por
padro. Se seu cache de alertas
estiver vazio na inicializao, o que
normalmente somente ocorre na
primeira vez em que ele
executado, o gateway opera no
modo de ressincronizao
bidirecional.
O padro AUTO.
Gate.Jdbc.RetryErrors
string
-jdbcretryerrors string Use esta propriedade para
especificar quais prefixos de
SQLSTATE faro com que o lote atual
de alertas seja tentado novamente.
espaos.
O padro 08 28 40 HYT.
Gate.Jdbc.Server
NameField string
-jdbcservernamefield
string
destino que contm o nome do
servidor.
O padro SERVERNAME.
Gate.Jdbc.Server
SerialField string
-jdbcserverserialname
string
destino que contm a srie do
servidor.
O padro SERVERSERIAL.
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Jdbc.Status
TableName string
-jdbcstatustablename
string
especificar o nome da tabela do
banco de dados de destino para
armazenar dados da tabela
alerts.status do ObjectServer.
O padro 'status'.
Gate.Jdbc.Url string -jdbcurl string Use esta propriedade para
especificar a URL do banco de
dados de destino.
O padro "".
Gate.Jdbc.Username string -jdbcusername string Use esta propriedade para
especificar o nome de usurio para
o banco de dados de destino.
O padro "".
Nota: Para obter mais informaes
sobre como configurar essa
propriedade, consulte a seo de
configurao a seguir:
Configurando a Conexo com o
Banco de Dados na pgina 17.
Gate.Jdbc.UnknownErrors
string
-jdbcunknownerrors
string
especificar como o gateway
manipula erros de SQL
desconhecidos. Essa propriedade
aceita os seguintes valores:
v ABORT: O gateway interrompe a
operao.
v IGNORE: O gateway ignora a
mensagem de erro.
v RECONNECT: O gateway tenta
reconectar-se ao banco de dados
de destino.
v RETRY: O gateway tenta
novamente a operao que
causou a mensagem de erro.
O padro RECONNECT.
Propriedades Genricas do Gateway
A Tabela 9 lista as propriedades genricas disponveis do gateway.
Tabela 9. Propriedades Genricas do Gateway
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.CacheHashTblSize
integer
-cachehtblsize integer Use esta propriedade para
especificar o nmero de
elementos que o gateway
alocar para o cache de
hashtable.
O padro 5023.
Gate.MapFile string -mapfile string Use esta propriedade para
especificar o arquivo de
mapeamento que o gateway
utilizar.
O padro
jdbc.map.
Gate.NGtkDebug boolean -ngtkdebug boolean Use esta propriedade para
ativar a criao de log das
mensagens de depurao da
biblioteca do NGTK.
O padro TRUE.
Gate.PAAware integer -paaware integer Esta propriedade indica se o
gateway reconhece o PA.
O padro 0 (sem
reconhecimento de PA).
Nota: Essa propriedade
mantida pelo servidor PA e
includa no arquivo de
propriedades apenas para
fins informativos.
Gate.PAAwareName string -paname string Esta propriedade indica o
nome do PA que controla o
gateway.
O padro "".
Nota: Esta propriedade
mantida pelo servidor PA e
includa no arquivo de
propriedades apenas para
informaes.
Gate.StartupCmdFile string -startupcmdfile string Use essa propriedade para
de comando de inicializao.
O padro
jdbc.startup.cmd.
Tabela 9. Propriedades Genricas do Gateway (continuao)
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Transfer.
FailoverSyncRate integer
-fsyncrate integer Use essa propriedade para
especificar a taxa (em
segundos) da sincronizao
de failover.
O padro 60.
Gate.UnixAdminGrp string -unixadmingrp string Use esta propriedade para
especificar o grupo de
administrao ao qual o
gateway dever pertencer se
a autenticao padro do
UNIX for usada.
O padro ncoadmin.
Gate.UsePamAuth boolean -usepamauth boolean Use essa propriedade para
especificar se a autenticao
PAM usada.
O padro FALSE.
Nota: Para executar o
gateway no modo FIPS
140-2, voc dever configurar
essa propriedade como TRUE.
Propriedades Java
Tabela 10 lista as propiredades Java disponveis.
Tabela 10. Propriedades Java
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Java.Arguments string -javaarguments string Use esta propriedade para
especificar os argumentos a
serem usados ao iniciar o
Java.
O padro "".
Gate.Java.ClassPath string -javaclasspath string Use esta propriedade para
especificar a varivel de
ambiente usada para
armazenar o local das
bibliotecas Java.
O padro $CLASSPATH.
Gate.Java.Debug boolean -javadebug boolean Use esta propriedade para
mensagens de depurao de
Java.
O padro TRUE.
Tabela 10. Propriedades Java (continuao)
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Java.LibraryPath string -javalibrarypath string Use essa propriedade para
especificar o local das
bibliotecas Java que sero
configuradas na varivel de
ambiente especificada pela
propriedade
Gate.Java.ClassPath.
O padro "".
Propriedades de Mapeamento
A Tabela 11 lista as propriedades de mapeamento disponveis.
Tabela 11. Propriedades de Mapeamento
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.Mapper.Debug boolean -mapperdebug boolean Use esta propriedade para
mensagens de depurao do
mapeador.
O padro TRUE.
Gate.Mapper.Forward
HistoricDetails boolean
-mapperforhistdtls boolean Use essa propriedade para
especificar se o gateway
encaminha todos os detalhes
histricos na atualizao
convertida.
O padro FALSE.
Gate.Mapper.Forward
HistoricJournals boolean
-mapperforhistjrnl boolean Use esta propriedade para
encaminhar todos os dirios
histricos na atualizao
convertida.
O padro FALSE.
Propriedades do Leitor/Gravador de Gateway
A Tabela 12 lista as propriedades do leitor/gravador de gateway disponveis.
Tabela 12. Propriedades do Leitor/Gravador de Gateway
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.G_JDBC.Debug boolean -g_jdbc.debug boolean Use essa propriedade para
ativar mensagens de
depurao do
leitor/gravador de gateway
Java
O padro TRUE.
Tabela 12. Propriedades do Leitor/Gravador de Gateway (continuao)
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.G_JDBC.
FailBackEnabled boolean
-g_jdbc.failbackenabled
boolean
ativar o failback para um
sistema primrio.
O padro FALSE.
Gate.G_JDBC.
FailBackTimeout integer
-g_jdbc.failbacktimeout
integer
especificar o tempo (em
segundos) que o gateway
aguarda antes de tentar
reconectar-se aps um
failback.
O padro 30.
Gate.G_JDBC.
ReconnectTimeout integer
-g_jdbc.reconnecttimeout
integer
especificar o tempo (em
segundos) que o gateway
aguarda antes de tentar
reconectar-se ao sistema
JDBC aps a perda da
conexo.
O padro 30.
Gate.RdrWtr. BufferSize
integer
-rdrwtrbufsize integer Use essa propriedade para
especificar o nmero de
entradas que o gateway
armazena no buffer antes da
limpeza, se o
armazenamento em buffer
estiver ativado. Essa
propriedade pode ser usada
para fazer ajustes finos na
eficincia do gateway.
O padro e 25.
Nota: Nota: O gateway
limpa o buffer quando o fim
de um lote de instrues
SQL foi atingido
independentemente do
tamanho do buffer.
Gate.RdrWtr. CommonNames
string
-rdrwtrcommonnanes string Use essa propriedade para
especificar uma lista de
nomes comuns.
O padro "".
Gate.RdrWtr.Debug boolean -rdrwtrdebug boolean Use esta propriedade para
incluir mensagens de
depurao do leitor de
gateway no log de
depurao.
O padro TRUE.
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.RdrWtr.
DeleteIfNoDedup boolean
-rdrwtrdeleteifnodedup
boolean
exclui eventos duplicados.
O padro FALSE.
Gate.RdrWtr.Description
string
-rdrwtrdescription string Use esta propriedade para
especificar a descrio do
aplicativo para a conexo do
leitor. Esta descrio usada
nos acionadores e permite
que voc determine qual
componente do gateway
tentou executar uma ao.
O padro "Gateway
Reader/Writer".
Gate.RdrWtr.Details
TableName string
-detailstblname string Use esta propriedade para
especificar o nome da tabela
de status que o gateway l.
O padro alerts.details.
Gate.RdrWtr.
FailbackEnabled boolean
-rdrwtrfailbackenabled
boolean
tenta efetuar failback no
ObjectServer principal
seguindo um failover do
ObjectServer.
O padro False.
Nota: O gateway tentar
efetuar failback com a
frequncia especificada pela
propriedade Gate.RdrWtr.
FailbackTimeout.
Gate.RdrWtr.
FailbackTimeout integer
-readerfailbacktimeout
integer
especificar a frequncia (em
segundos) com a qual o
gateway tenta efetuar
failback no sistema principal
seguindo um failover do
sistema.
O padro 30.
Nota: O gateway tentar
efetuar failback no
ObjectServer primrio se a
propriedade
Gate.RdrWtr.Failback
Enabled estiver configurada
como TRUE.
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.RdrWtr.IducFlushRate
integer
-iducflushrate integer Use esta propriedade para
segundos) da granularidade
do leitor.
Se voc configurar essa
propriedade como 0, o leitor
obter suas atualizaes na
mesma taxa granular do
ObjectServer ao qual ela est
conectada.
O padro 0.
Nota: Se voc configurar
essa propriedade para um
valor maior que 0, o leitor
emitir pedidos de descarga
de IDUC automticos para o
ObjectServer com essa
frequncia. Isso permite que
o leitor seja executado em
um granularidade mais
rpida que a do ObjectServer,
permitindo, assim, que o
gateway capture alteraes
de eventos mais detalhados
nos sistemas nos quais o
prprio ObjectServer tem
configuraes de alta
granularidade.
Gate.RdrWtr.
JournalTableName string
-journaltblname string Use esta propriedade para
especificar o nome da tabela
de status que o gateway l.
O padro alerts.journal.
Gate.RdrWtr.LogOSSql boolean -logossql boolean Use esta propriedade para
registrar todos os comandos
SQL enviados ao
ObjectServer no modo de
depurao.
O padro FALSE.
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.RdrWtr.Password string -password string Use esta propriedade para
especificar a senha associada
ao usurio especificado pela
propriedade
Gate.RdrWtr.Username.
O padro "".
Nota: Voc deve criptografar
essa senha usando o
utilitrio nco_g_crypt. Para
obter informaes adicionais,
consulte IBM Tivoli
Netcool/OMNIbus
Administration Guide
(SC14-7605-00).
Gate.RdrWtr.
ReconnectTimeout integer
-reconntimeout integer Use esta propriedade para
especificar o perodo (em
segundos) entre cada
tentativa de sondagem de
reconexo que o gateway
far se a conexo com o
ObjectServer for perdida.
O padro 30.
Gate.RdrWtr.
RefreshCacheOnUpdate boolean
-rdrwtrrefresh
cacheonupdate boolean
atualiza o cache aps cada
atualizao.
O padro FALSE.
Gate.RdrWtr.Server string -rdrwtrserver string Use esta propriedade para
especificar o nome do
ObjectServer do qual o
gateway ler alertas
O padro NCOMS.
Gate.RdrWtr.
TblReplicateDefFile string
-tblrepdeffile string Use esta propriedade para
especificar o caminho para o
arquivo de definio de
replicao de tabela.
O padro
jdbc.rdrwtr.tblrep.def.
Gate.RdrWtr.Username string -username string Use esta propriedade para
especificar o nome de
usurio usado para
autenticar a conexo com o
ObjectServer.
O padro root.
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.RdrWtr. UseBulkInCmd
boolean
-usebulkincmd boolean Use essa propriedade para
permitir que comandos SQL
sejam inseridos em massa no
gateway.
O padro FALSE.
Propriedades de Conexo
A Tabela 13 lista as propriedades de mapeamento disponveis.
Tabela 13. Propriedades de Conexo
Nome da propriedade
Opo da linha de
comandos Descrio
Gate.StartupCmdFilePath
string
-startupcmdfilepath string Use essa propriedade para
especificar o caminho de
arquivo para o arquivo de
inicializao de gateway.
O padro
'$OMNIHOME/gates/jdbc/
jdbc.startup.cmd'.
Gate.Transfer.Failover
SyncRate integer
-transferfailoversyncrate
integer
segundos) na qual a
ressincronizao ocorre em
caso de failover.
O padro 60.
Gate.UnixAdminGrp string -unixadmingrp string Use essa propriedade para
especificar o nome do grupo
de administrao de
autenticao do UNIX
O padro 'NCOADMIN'.
Gate.UsePamAuth boolean -usepamauth boolean Use essa propriedade para
permitir que o gateway use
autenticao PAM. Essa
propriedade aceita dois
valores:
v TRUE: O gateway usa a
autenticao PAM.
v FALSE: O gateway usa a
autenticao do UNIX
O padro FALSE.
Arquivo de Definio de Mapas
O arquivo de definio de mapeamento define como o gateway mapeia dados
recebidos do ObjectServer para tabelas no banco de dados de destino.
O arquivo de definio de mapa padro instalado com o gateway, jdbc.map,
configura o gateway para operar no modo de relatrio. Se voc desejar executar o
gateway no modo de auditoria, copie $OMNIHOME/gates/jdbc/audit.jdbc.map para
$OMNIHOME/gates/jdbc/jdbc.map.
O arquivo de definio de mapa padro contm exemplos de mapeamento.
recomendvel fazer uma cpia de backup do arquivo padro para referncia
futura.
Nota: Os arquivos de definio de mapa fornecidos com o gateway so
configurados com campos do Netcool/OMNIbus V7.2.1. Se voc estiver
executando uma verso mais recente do Netcool/OMNIbus, possvel identificar
quais campos precisam ser removidos do arquivo de definio de mapa
executando o gateway e verificando mensagens sobre campos desconhecidos no
arquivo de log do gateway. Remova os campos que no existem em seu
ObjectServer.
Arquivo de Comando de Inicializao
O arquivo de comando de inicializao contm um conjunto de comandos que o
gateway executa cada vez que inicia. Esses comandos permitem que o gateway
transfira quaisquer dados da tabela subsidiria para um conjunto de tabelas de
destino.
possvel especificar a localizao do arquivo de comando de inicializao usando
a propriedade genrica do Netcool/OMNIbus Gate.StartupCmdFile. O arquivo de
comando de inicializao padro jdbc.startup.cmd est localizado no seguinte
diretrio:
$OMNIHOME/gates/jdbc
O arquivo de comando de inicializao padro contm exemplos de comandos.
recomendvel fazer uma cpia de backup do arquivo padro para referncia
futura.
possvel usar os comandos a seguir dentro do arquivo de comando de
inicializao:
v GET CONFIG - Este comando exibe a configurao atual do gateway listando todas
as propriedades e seus valores.
v SET LOG LEVEL TO - Este comando configura o nvel de log de mensagens. O
padro debug.
v TRANSFER - Este comando transfere dados de uma tabela para outra usando um
mapa de transferncia. Os dados tambm podem ser filtrados.
Esses comandos tambm podem ser inseridos usando a interface interativa de SQL
(nco_sql). Para obter informaes adicionais sobre o uso da interface interativa de
SQL, consulte o IBM Tivoli Netcool/OMNIbus Administration Guide (SC14-7605-00).
Transferncias de Tabelas Arbitrrias
possvel usar comandos TRANSFER no arquivo de comando de inicializao para
transferir tabelas arbitrrias do ObjectServer para o banco de dados de destino. O
arquivo de comando de inicializao padro contm um nmero de exemplos de
instrues de transferncia. Se estiver executando o gateway no modo de relatrio,
voc pode precisar de alguns dos exemplos de comandos de transferncia para
sincronizar dados de usurios ou dados de classes de objetos.
Para usar um dos exemplos de transferncia fornecidos no arquivo de comando de
inicializao padro, remova o comentrio dele.
Por exemplo, para transferir dados da tabela alerts.conversions do ObjectServer
para a tabela de destino REPORTER_CONVERSIONS, remova o comentrio da seguinte
linha:
TRANSFER FROM alerts.conversions TO REPORTER_CONVERSIONS DELETE USING
TRANSFER_MAP ConversionsMap;
Os mapeamentos usados pelos exemplos de comandos de transferncia, como
ConversionsMap, esto localizados no arquivo de definio de mapa padro
jdbc.map.
Esses comandos tambm podem ser inseridos usando a interface interativa de SQL
(nco_sql). Para obter informaes adicionais sobre o uso da interface interativa de
SQL, consulte o IBM Tivoli Netcool/OMNIbus Administration Guide (SC14-7605-00).
Arquivo de Definio de Replicao da Tabela
O gateway replica dados entre tabelas do ObjectServer e o banco de dados de
destino. As tabelas do ObjectServer das quais os dados so encaminhados para o
banco de dados de destino so especificadas no arquivo de definio de replicao
de tabelas.
possvel especificar a localizao do arquivo de definio de replicao de tabelas
usando a propriedade genrica do Netcool/OMNIbus
Gate.RdrWtr.TblReplicateDefFile. O arquivo de definio de replicao de tabelas
padro jdbc.rdrwtr.tblrep.def est localizado no seguinte diretrio:
$OMNIHOME/gates/jdbc
O arquivo de definio de replicao de tabelas padro contm exemplos de
mapeamento. recomendvel fazer uma cpia de backup do arquivo padro para
referncia futura.
O arquivo de definio de replicao de tabelas contm comandos REPLICATE que
usam a seguinte sintaxe:
REPLICATE ALL FROM TABLE source_table
USING MAP map_name;
em que source_table o nome da tabela a ser replicada no banco de dados de
destino e map_name o nome do mapa que define a tabela.
possvel incluir uma ou mais clusulas no comando REPLICATE para processar
melhor os dados durante a replicao. Os comandos disponveis so listados na
tabela a seguir. Use as clusulas opcionais na ordem em que elas so listadas na
tabela. Por exemplo, ao usar as clusulas FILTER WITH e AFTER IDUC DO, a clusula
FILTER WITH deve preceder a clusula AFTER IDUC DO.
Tabela 14. Comandos de replicao opcionais
Comando Descrio
CACHE FILTER condition Filtra as entradas de cache recuperadas durante uma
atualizao de cache, em que condition define a
condio SQL que o gateway inclui na instruo
SELECT.
Tabela 14. Comandos de replicao opcionais (continuao)
Comando Descrio
FILTER WITH filter Filtra as linhas do banco de dados selecionadas para
replicao, em que filter define o filtro que o gateway
usa.
A filtragem positiva por padro, o que significa que
apenas aqueles eventos que corresponderem
definio de filtro sero replicados. possvel usar
um filtro negativo colocando um ponto de exclamao
(!) antes do sinal de igual (=) na clusula de filtro. Por
exemplo, a clusula de filtro a seguir replica todos os
eventos cuja severidade no seja 5:
FILTER WITH Severity !=5
INTO targettable Especifica a tabela no banco de dados de destino na
qual os dados sero replicados, em que targettable o
nome da tabela de destino.
Essa opo no necessria ao replicar as tabelas
principais do ObjectServer, que so alerts.staus,
alerts.details e alerts.journal. Ela deve ser usada
ao replicar outras tabelas do ObjectServer no banco de
dados de destino, mas esse tipo de transferncia de
dados normalmente feito usando o comando
TRANSFER, conforme descrito em Arquivo de
Comando de Inicializao na pgina 36.
AFTER IDUC DO update Atualiza linhas replicadas, em que update especifica
qual campo atualizar com qual valor.
Funes AfterIDUC e de Filtro
As funes AfterIDUC e de filtro implementadas pelo Gateway for Oracle e
Gateway for ODBC usando as propriedades Gate.ReaderAfterIDUC e
Gate.ReaderFilter. O Gateway para JDBC usa o arquivo de definio de
replicao de tabela para executar as mesmas funes.
Use o comando AFTER IDUC DO para atualizar as linhas replicadas. No exemplo a
seguir, a clusula AFTER IDUC DO instrui o gateway a configurar a coluna Archived
como 1 para todas as linhas replicadas:
REPLICATE ALL FROM TABLE alerts.status
USING MAP StatusMap
AFTER IDUC DO Archived=1;
Nota: A funcionalidade AfterIDUC no est disponvel durante a ressincronizao.
Os alertas podem ser transferidos como resultado da ressincronizao, mas as
aes especificadas pela clusula AFTER IDUC DO no so processadas.
Use o comando FILTER WITH para filtrar os dados replicados no banco de dados de
destino. No exemplo a seguir, a clusula FILTER WITH instrui o gateway a replicar
apenas alertas originados dos ObjectServers NCOMS_US e NCOMS_CA:
REPLICATE ALL FROM TABLE alerts.status
USING MAP StatusMap
FILTER WITH ServerName IN (\NCOMS_US\,\NCOMS_CA\);
Nota: Voc deve usar caracteres de barra invertida (\) como escape para caracteres
de aspas simples () na sequncia de consulta.
Uma considerao importante ao filtrar dados replicados que o filtro deve
corresponder a uma caracterstica dos alertas que no so alterados ao longo do
tempo. Essa pode ser a origem do alerta, como no exemplo anterior. Voc tambm
pode usar os elementos de Classe e Gerenciador de alertas como um filtro. Os
elementos de alertas, como de Segurana, tornam invlidos os critrios de filtro
porque podem mudar durante o ciclo de vida de um alerta.
Usando um Campo de Particionamento
possvel usar a propriedade Gate.Jdbc.PartitioningField para qualificar a
identificao de alertas com o propsito de particionar o banco de dados de
destino.
Por padro, os alertas so identificados usando os campos ServerName e
ServerSerial. possvel usar a propriedade Gate.Jdbc.PartitioningField para
especificar um campo adicional que pode ser usado para identificar alertas com o
propsito de particionamento do banco de dados. O campo FirstOccurrence
uma opo tpica para esse propsito.
Filtrando Dados de Ressincronizao
possvel usar a propriedade Gate.Jdbc.ResyncFilter para especificar um filtro
para restringir eventos abertos no banco de dados de destino. Os eventos so
filtrados quando o gateway est operando no modo de ressincronizao
bidirecional.
Quando a propriedade Gate.Jdbc.ResyncFilter usada, o gateway filtra eventos
abertos do banco de dados de destino usando o nome do servidor do ObjectServer
como o critrio de filtro. O filtro especificado torna-se parte de uma clusula SQL
WHERE. Em seguida, a clusula WHERE anexada consulta SELECT que o gateway
usa para recuperar eventos do banco de dados de destino.
O exemplo a seguir ilustra um caso de uso tpico para a propriedade
Gate.Jdbc.ResyncFilter.
Exemplo
Suponha que voc est usando dois ObjectServers do Netcool/OMNIbus, um para
produo e um para testes, cada um deles com seu prprio gateway. O nome do
servidor do ObjectServer de produo PROD e o nome do servidor do
ObjectServer de teste TEST. Ambos os gateways esto arquivando dados no
mesmo banco de dados de destino.
Quando o gateway TEST est executando uma ressincronizao bidirecional entre o
ObjectServer TEST e o banco de dados, voc deseja evitar que o gateway TEST
feche eventos que vieram do ObjectServer PROD. Para fazer isso, possvel
especificar o seguinte valor de filtro para a propriedade Gate.Jdbc.ResyncFilter
do gateway TEST:
ServerName LIKE TEST%
Esse filtro faz com que o gateway TEST ignore eventos abertos no banco de dados
de destino que vieram do ObjectServer PROD. Ele ressincroniza somente os
eventos abertos que vieram do ObjectServer TEST.
Nota: Ao especificar valores para a propriedade Gate.Jdbc.ResyncFilter no
arquivo de propriedades, voc dever usar caracteres de barra invertida (\) como
escape para caracteres de aspas simples ('). Por exemplo:
Gate.Jdbc.ResyncFilter: ServerName LIKE \TEST%\
Arquivo de Log de Mensagens
O gateway cria um arquivo de log de mensagens para armazenar todas as
mensagens que ele gera enquanto executa.
possvel usar a propriedade MessageLog para especificar um nome para o arquivo
de log de mensagens. O arquivo de log padro G_JDBC.log est localizado no
seguinte diretrio:
$OMNIHOME/log
possvel especificar o tamanho mximo do arquivo de log usando a propriedade
MaxLogFileSize. O padro 1024 KB. Quando o arquivo de log atinge o tamanho
mximo especificado, o ObjectServer o arquiva usando a extenso .log_old e inicia
um novo arquivo de log com a extenso .log. Quando o novo arquivo de log
atinge o tamanho mximo, ele arquivado por sua vez e sobrescreve o primeiro
arquivo de log arquivado.
possvel especificar o nvel de log de mensagens usando a propriedade
MessageLevel. O padro warn. O nvel de criao de log padro suficiente para
identificar a maioria dos problemas de configurao. Se precisar de informaes
adicionais sobre como o gateway est executando, configure a propriedade
MessageLevel como debug. Essa opo produz uma sada muito detalhada,
resultando em grandes arquivos de log.
Variveis de Ambiente do arquivo de Log
possvel controlar o tamanho do arquivo de log e a rotao de arquivos de log
usando as seguintes variveis de ambiente:
v NDE_LOGFILE_MAXSIZE configura o tamanho mximo do arquivo de log.
O exemplo a seguir configura o tamanho mximo do arquivo de log como
1024000 bytes (1024 KB):
setenv NDE_LOGFILE_MAXSIZE 1024000
v NDE_LOGFILE_ROTATION_FORMAT impinge rotao diria de arquivos de log,
independentemente do tamanho mximo do arquivo de log especificado por
NDE_LOGFILE_MAXSIZE. Tambm especifica o formato do nome do arquivo de log
arquivado.
possvel usar um dos tipos de parmetro a seguir para configurar essa
varivel: qualquer sequncia literal (por exemplo, rotation), um formato de
registro de data e hora POSIX ou um formato de registro de data e hora Unicode
Locale Data Markup Language (LDML). A sequncia literal ou o registro de data
e hora anexado ao arquivo de log arquivado, por exemplo,
nco_g_odbc.log_rotation.
Os comandos a seguir ativam a rotao diria de arquivos de log:
Parmetro Comando
Sequncia literal setenv NDE_LOGFILE_ROTATION_FORMAT \literal_string\
Parmetro Comando
Registro de data
e hora POSIX
setenv NDE_LOGFILE_ROTATION_FORMAT %Y%m%d-%H%M
Registro de data
e hora LDML
setenv NDE_LOGFILE_ROTATION_FORMAT yyyyMMdd-HHmm
NDE_LOGFILE_ROTATION_TIME especifica o horrio no qual a rotao de arquivos de
log ocorre diariamente. O exemplo a seguir faz com que a rotao de arquivos de
log ocorra s 0h00 diariamente:
setenv NDE_LOGFILE_ROTATION_TIME 0000
Para obter informaes adicionais sobre o uso de variveis de ambiente de arquivo
de log, consulte o IBM Tivoli Netcool/OMNIbus Installation and Deployment Guide
(SC14-7604-00).
Modo FIPS e Criptografia
O gateway compatvel com o Federal Information Processing Standard 1402
(FIPS 140-2). Ele pode ser executado no modo FIPS no Netcool/OMNIbus V7.2.1 e
posterior.
possvel usar algoritmos de criptografia para proteger as entradas feitas no
arquivo de propriedades, incluindo senhas. Use a propriedade genrica
ConfigCryptoAlg do Netcool/OMNIbus para especificar o mtodo de criptografia e
a propriedade genrica ConfigKeyFile do Netcool/OMNIbus para especificar o
arquivo de chaves de criptografia.
Para obter informaes adicionais sobre a execuo do gateway no modo FIPS e as
propriedades e senhas de criptografia, consulte o IBM Tivoli Netcool/OMNIbus
Administration Guide (SC14-7605-00) e o the IBM Tivoli Netcool/OMNIbus Probe and
Gateway Guide (SC14-7608-00).
Estatsticas do Gateway
O gateway registra estatsticas de Leitor e Gravador em seu arquivo de log.
possvel usar essas estatsticas para monitorar o desempenho do gateway.
Para o componente Leitor, o gateway registra o tempo que leva para ler e gravar
em disco um lote de trabalho inteiro, medido em milissegundos. Essa medida
tambm expressa como o nmero de linhas de banco de dados processadas por
segundo.
Para o componente Gravador, o gateway registra o nmero de lotes pendentes (no
processados) e a taxa de linhas em execuo, medidas como linhas do banco de
dados processadas por segundo.
Quando o desempenho do gateway adequado, o nmero de lotes pendentes deve
ser 0 ou 1. Se o nmero de lotes pendentes for maior que 1, isso indica que o
desempenho do gateway no est sendo adequado.
A taxa de linhas em execuo uma mdia ponderada entre o histrico da taxa de
linhas em execuo e a taxa de linhas do ltimo lote processado. A taxa de linhas
em execuo calculada como 0,625 da ltima taxa de linhas em execuo medida
mais 0,375 da taxa de linhas em execuo do ltimo lote ((0,625 * ltima taxa de
linhas em execuo medida) + (0,375 * taxa de linhas do ltimo lote)).
O gateway tambm registra o tempo que leva para gravar o cache persistente,
medido em milissegundos. Esse tempo aproximadamente proporcional ao
nmero de alertas abertos que esto sendo gerenciados pelo gateway.
As estatsticas do gateway so gravadas no arquivo de log padro G_JDBC.log.
Para permitir a fcil recuperao dos dados, todas as linhas de sada de estatsticas
no arquivo de log contm a sequncia STATS.
Nota: As informaes de estatsticas do gateway so registradas no nvel de log
information, que est desligado por padro. Para ativar a criao de log de
estatsticas, voc deve configurar a propriedade MessageLevel como information.
Exemplo de Arquivo de Log
O exemplo a seguir mostra informaes de estatsticas registradas pelo gateway.
11/02/11 23:26:23: Information: I-GJA-000-000: [ngjava]: G_JDBC:
Thread-3: STATS: 9fbb3866-bf81-4fa6-9944-ae99eaafee45
Batch write time 11 ms (1000.0 rows/second)
Thread-3: STATS: Cache write time 7 ms
pool-1-thread-1: STATS: 9fbb3866-bf81-4fa6-9944-ae99eaafee45
Batch execution time: 473
pool-1-thread-1: STATS:
Running row rate 18.907563025210084 rows/second
pool-1-thread-1: STATS: Outstanding batches 0
Mensagens de erro
As mensagens de erro fornecem informaes sobre problemas que ocorreram
durante as operaes do gateway. Voc pode usar as informaes que elas contm
para resolver esses problemas.
A tabela a seguir descreve as mensagens de erro geradas pelo gateway:
Tabela 15. Mensagens de erro
Erro Descrio Ao
Falha na criao do lote
exception
O gateway no conseguiu
criar um novo lote de
trabalho em armazenamento e
encaminhamento.
Verifique o texto da exceo
para obter uma indicao da
causa do erro. Se a causa do
problema no estiver clara na
mensagem de erro, entre em
contato com o Suporte de
Software IBM.
Tabela 15. Mensagens de erro (continuao)
Erro Descrio Ao
O UUID de dados do
arquivo de recuperao
(uuid) no corresponde a
uuid
Um arquivo persistente foi
corrompido.
Os arquivos persistentes so
diferenciados por
identificadores exclusivos
universais (UUID). O UUID
usado para dar nome a um
arquivo persistente e tambm
integrado no contedo desse
arquivo. A mensagem de erro
est indicando que, para um
arquivo persistente especfico,
o UUID integrado no
corresponde ao UUID no
nome do arquivo. O arquivo
foi corrompido.
Localize e salve uma cpia do
arquivo denominado uuid no
diretrio $OMNIHOME/var/
G_JDBC/. Entre em contato
com o IBM Software Support.
Tipo DML desconhecido:
type
Um comando da linguagem
de manipulao de dados
(DML) de um tipo
desconhecido foi solicitado.
Inseres, atualizaes e
excluses so os nicos tipos
suportados pelo gateway.
Entre em contato com o IBM
Software Support.
Falha ao renomear arquivo
para uuid
O gateway no pde gravar
um arquivo persistente
denominado uuid.
Verifique se o gateway tem
permisso de gravao para o
diretrio $OMNIHOME/var/
G_JDBC.
O Estado SQL nulo Ocorreu um erro de
processamento do banco de
dados e o driver JDBC no
configurou um estado de erro
SQL vlido. O gateway no
pode determinar a causa do
erro.
Verifique o log do banco de
dados para qualquer
indicao de erros. Verifique
se ainda possvel atingir o
banco de dados. Se no houve
nenhum indicador de erro
bvio, reinicie o gateway. Se o
problema persistir, entre em
contato com o Suporte de
Software IBM.
As mensagens de erro de JDBC so descritas no seguinte tpico:
v Mensagens de Erro de JDBC
Mensagens de Erro de JDBC
As mensagens de erro de JDBC tipicamente so gradas pelo driver JDBC e o
contedo gerado dessas mensagens depende do driver que est sendo usado.
A tabela a seguir descreve a exceo tpica Java ClassNotFound e os trs tipos
principais de erros de JDBC. Consulte a documentao de seu driver JDBC para
obter informaes especficas sobre as mensagens de erro que ele gera.
Tabela 16. Mensagens de Erro de JDBC
Erro Descrio Ao
java.lang.ClassNotFound
Exception: driver class
No foi possvel localizar a
classe do driver JDBC.
Verifique se o nome da classe
do driver JDBC est correto e
se os arquivos .jar e
quaisquer dependncias do
driver foram instalados no
diretrio
$OMNIHOME/gates/java.
Erros de autenticao de
JDBC
Os erros de autenticao
tipicamente so causados por
nomes de usurio ou senhas
incorretos ou invlidos.
Verifique se est usando
nomes de usurio e senhas
corretos e vlidos para as
propriedades
Gate.Jdbc.Username e
Gate.Jdbc.Password, e em
qualquer outro lugar onde a
autenticao seja requerida.
Erros de conexo de JDBC Os erros de conexo
tipicamente so causados por
parmetros incorretos ou
invlidos na sequncia de
conexo, tais como um nome
de host ou um nome de
banco de dados invlido.
Verifique se est usando
parmetros corretos e vlidos
na sequncia de conexo
para a propriedade
Gate.Jdbc.Url.
Erros de tempo de execuo
de JDBC
Os erros de tempo de
execuo tm vrias causas.
Um tpico erro desse tipo
uma violao de restrio.
Estas geralmente ocorrem
quando o gateway est
executando a
ressincronizao inicial.
Verifique o texto da exceo
para obter a causa do erro.
As violaes de restrio
indicam que o gateway est
tentando inserir dados
duplicados no banco de
dados. Como os dados j
esto no banco de dados,
isso no um problema.
Se a causa do problema no
estiver clara na mensagem
de erro, entre em contato
com o Suporte de Software
IBM.
Executando o Gateway
possvel iniciar o gateway a partir da linha de comandos ou execut-lo como um
servio do Windows.
Para iniciar o gateway em sistemas operacionais UNIX e Linux, execute o seguinte
comando:
$OMNIHOME/bin/nco_g_jdbc
Para iniciar o gateway em sistemas operacionais Windows, execute o seguinte
comando:
%OMNIHOME%\bin\nco_g_jdbc.exe
Para obter informaes sobre como colocar o gateway sob controle de processo,
consulte o IBM Tivoli Netcool/OMNIbus Administration Guide (SC14-7605-00).
Executando o Gateway como um Servio do Windows
Para executar o gateway como um servio do Windows, use as seguintes etapas:
1. Para executar o gateway no mesmo host que o ObjectServer, use o seguinte
comando para registr-lo como um servio:
%OMNIHOME%\bin\nco_g_jdbc.exe -install -depend NCOObjectServer
2. Para executar o gateway em um host diferente para o ObjectServer, use o
seguinte comando para registr-la como um servio:
%OMNIHOME%\bin\nco_g_jdbc.exe -install
3. Inicie o gateway usando o Microsoft Services Management Console.
Problemas Conhecidos
No momento desta liberao, alguns problemas foram relatados, dos quais voc
deve ter conhecimento ao executar a anlise.
Esta seo cobre os seguintes problemas conhecidos:
v Rtulo de Tabela Customizada
v Estados de Erro de SQL
v Esquemas de Nomenclatura do Sybase na pgina 46
Rtulo de Tabela Customizada
O relacionamento de gateway e ObjectServer no capaz de manipular rtulos de
uma tabela customizada ou de uma tabela genrica como tabela de status.
Uma tabela customizada no pode ser tratada como tabela de status porque o
relacionamento de gateway e ObjectServer no pode manipul-la.
Rotular uma tabela de status customizada como tabela genrica tambm no
suportado pelo gateway, j que depende de uma tabela de status sendo marcada
como tabela de status pelas bibliotecas de gateway principais.
Nota: A propriedade Gate.RdrWtr.StatusTableName no deve ser usada para
especificar uma tabela customizada ou uma tabela genrica como tabela de status.
Estados de Erro de SQL
Quando o driver JDBC que est sendo usado no indicar um estado de erro de
SQL vlido para um erro, o gateway far o melhor esforo possvel para
recuperar-se.
Em casos nos quais o gateway no puder se recuperar de um erro desse tipo, os
dados sero descartados e perdidos. O exemplo a seguir mostra um erro que
registrado quando o gateway no pode determinar um estado de erro vlido de
SQL:
11/26/10 14:28:20: Error: E-GJA-000-000: [ngjava]: G_JDBC:
pool-1-thread-2: SQL State is null
Esquemas de Nomenclatura do Sybase
Os nomes de objetos do banco de dados Sybase, tais como tabelas e colunas, fazem
distino entre maisculas e minsculas. Pode ser necessrio revisar o esquema de
seu banco de dados para assegurar que seu esquema de nomenclatura seja
compatvel com a configurao de seu gateway.
Seu esquema de nomenclatura para objetos do banco de dados pode afetar todas
as colunas em seus mapas, bem como propriedades especficas do gateway, tais
como Gate.Jdbc.ServerSerialField e Gate.Jdbc.StatusTableName.
Apndice. Avisos e Marcas
Este apndice contm as seguintes sees:
v Avisos
v Marcas Registradas
Avisos
Estas informaes foram desenvolvidas para produtos e servios oferecidos nos
Estados Unidos.
possvel que a IBM no oferea os produtos, servios ou recursos discutidos
nesta publicao em outros pases. Consulte um representante IBM local para obter
informaes sobre produtos e servios disponveis atualmente em sua rea.
Qualquer referncia a produtos, programas ou servios IBM no significa que
apenas produtos, programas ou servios IBM possam ser utilizados. Qualquer
produto, programa ou servio funcionalmente equivalente, que no infrinja
nenhum direito de propriedade intelectual da IBM poder ser utilizado em
substituio a este produto, programa ou servio. Entretanto, a avaliao e
verificao da operao de qualquer produto, programa ou servio no IBM so de
responsabilidade do Cliente.
A IBM pode ter patentes ou solicitaes de patentes pendentes relativas a assuntos
tratados nesta publicao. O fornecimento desta publicao no lhe garante direito
algum sobre tais patentes. Pedidos de licena devem ser enviados, por escrito,
para:
Gerncia de Relaes Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146
Botafogo
Rio de Janeiro, RJ
CEP 22290-240
Para pedidos de licenas relativos a informaes de DBCS (Conjunto de Caracteres
de Byte Duplo), entre em contato com o Departamento de Propriedade Intelectual
da IBM em seu pas ou envie pedidos de licena, por escrito, para:
IBM World Trade Asia Corporation
Licensing 2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan
O pargrafo a seguir no se aplica a nenhum pas em que tais disposies no
estejam de acordo com a legislao local: A INTERNATIONAL BUSINESS
MACHINES CORPORATION FORNECE ESTA PUBLICAO NO ESTADO EM
QUE SE ENCONTRA, SEM GARANTIA DE NENHUM TIPO, SEJA EXPRESSA
OU IMPLCITA, INCLUINDO, MAS A ELAS NO SE LIMITANDO, AS
GARANTIAS IMPLCITAS DE NO INFRAO, COMERCIALIZAO OU
ADEQUAO A UM DETERMINADO PROPSITO. Alguns pases no permitem
a excluso de garantias expressas ou implcitas em certas transaes; portanto, essa
disposio pode no se aplicar ao Cliente.
Copyright IBM Corp. 2011, 2012 47
Essas informaes podem conter imprecises tcnicas ou erros tipogrficos. So
feitas alteraes peridicas nas informaes aqui contidas; tais alteraes sero
incorporadas em futuras edies desta publicao. A IBM pode, a qualquer
momento, aperfeioar e/ou alterar os produtos e/ou programas descritos nesta
publicao, sem aviso prvio.
Referncias nestas informaes a Web sites no IBM so fornecidas apenas por
convenincia e no representam de forma alguma um endosso a esses Web sites.
Os materiais contidos nesses Web sites no fazem parte dos materiais desse
produto IBM e a utilizao desses Web sites de inteira responsabilidade do
Cliente.
A IBM pode utilizar ou distribuir as informaes fornecidas da forma que julgar
apropriada sem incorrer em qualquer obrigao para com o Cliente.
Licenciados deste programa que desejam obter informaes sobre este assunto com
objetivo de permitir: (i) a troca de informaes entre programas criados
independentemente e outros programas (incluindo este) e (ii) a utilizao mtua
das informaes trocadas, devem entrar em contato com:
Botafogo
Rio de Janeiro, RJ
CEP 22290-240
Tais informaes podem estar disponveis, sujeitas a termos e condies
apropriadas, incluindo em alguns casos o pagamento de uma taxa.
O programa licenciado descrito nestas informaes e todo o material licenciado
disponvel so fornecidos pela IBM sob os termos do Contrato com o Cliente IBM,
do Contrato Internacional de Licena do Programa IBM ou de qualquer outro
contrato equivalente.
Todos os dados de desempenho aqui contidos foram determinados em um
ambiente controlado. Portanto, os resultados obtidos em outros ambientes
operacionais podem variar significativamente. Algumas medidas podem ter sido
tomadas em sistemas em nvel de desenvolvimento e no h garantia de que estas
medidas sero iguais em sistemas geralmente disponveis. Alm disso, algumas
medidas podem ter sido estimadas por extrapolao. Os resultados reais podem
variar. Os usurios deste documento devem verificar os dados aplicveis para seu
ambiente especfico.
As informaes relativas a produtos no IBM foram obtidas junto aos fornecedores
dos respectivos produtos, de seus anncios publicados ou de outras fontes
disponveis publicamente. A IBM no testou estes produtos e no pode confirmar a
preciso de seu desempenho, compatibilidade nem qualquer outra reivindicao
relacionada a produtos no IBM. Dvidas sobre os recursos de produtos no IBM
devem ser encaminhadas diretamente a seus fornecedores.
Todas as declaraes relacionadas aos objetivos e intenes futuras da IBM esto
sujeitas a alteraes ou cancelamento sem aviso prvio e representam apenas metas
e objetivos.
Todos os preos IBM mostrados so preos de varejo sugeridos pela IBM, so
atuais e esto sujeitos a alterao sem aviso prvio. Os preos do revendedor
podem variar.
Estas informaes foram projetadas apenas com o propsito de planejamento. As
informaes aqui contidas esto sujeitas a alteraes antes que os produtos
descritos estejam disponveis.
Estas informaes contm exemplos de dados e relatrios utilizados nas operaes
dirias de negcios. Para ilustr-los da forma mais completa possvel, os exemplos
incluem nomes de indivduos, empresas, marcas e produtos. Todos estes nomes so
fictcios e qualquer semelhana com nomes e endereos utilizados por uma
empresa real mera coincidncia.
LICENA DE COPYRIGHT:
Estas informaes contm programas de aplicativos de amostra na linguagem
fonte, ilustrando as tcnicas de programao em diversas plataformas operacionais.
O Cliente pode copiar, modificar e distribuir estes programas de amostra sem a
necessidade de pagar IBM, com objetivos de desenvolvimento, utilizao,
marketing ou distribuio de programas aplicativos em conformidade com a
interface de programao de aplicativo para a plataforma operacional para a qual
os programas de amostra so criados. Esses exemplos no foram testados
completamente em todas as condies. Portanto, a IBM no pode garantir ou
implicar a confiabilidade, manuteno ou funo destes programas.
Cada cpia ou parte destes programas de amostra ou qualquer trabalho derivado
deve incluir um aviso de copyright com os dizeres:
(nome da empresa) (ano). Partes deste cdigo so derivadas dos Programas de
Amostra da IBM Corp. Copyright IBM Corp. _insira o ano ou os anos_. Todos os
direitos reservados.
Se estas informaes estiverem sendo exibidas em cpia eletrnica, as fotografias e
ilustraes coloridas podem no aparecer.
Marcas Registradas
IBM, o logotipo IBM, ibm.com, AIX, Tivoli, zSeries e Netcool so marcas
registradas da International Business Machines Corporation nos Estados Unidos
e/ou em outros pases.
Adobe, Acrobat, Portable Document Format (PDF), PostScript e todas as marcas
registradas baseadas em Adobe so marcas ou marcas registradas da Adobe
Systems Incorporated nos Estados Unidos e/ou em outros pases.
Intel, Intel Inside (logotipos), MMX e Pentium so marcas registradas da Intel
Corporation nos Estados Unidos e/ou em outros pases.
Microsoft, Windows, Windows NT e o logotipo do Windows so marcas
registradas da Microsoft Corporation nos Estados Unidos e/ou em outros pases.
Java e todas as marcas registradas baseadas em Java so marcas registradas da Sun
Microsystems, Inc. nos Estados Unidos e/ou em outros pases.
Apndice. Avisos e Marcas 49
Linux uma marca registrada de Linus Torvalds nos Estados Unidos e/ou em
outros pases.
UNIX uma marca registrada do The Open Group nos Estados Unidos e em
outros pases.
Impresso no Brasil
S517-0082-03

JDBCGW PDF

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

JDBCGW PDF

Enviado por

Direitos autorais:

Formatos disponíveis

IBM

Netcool/OMNIbus Gateway for JDBC

Netcool/OMNIbus Gateway for JDBC

Você também pode gostar