
# --------------------------- ADD -------------------------------------------

<Add>
Incluir 

Uso:  clique no dilogo concludo \"Incluir;\"; clique em \"Incluir.\"

Voc pode incluir manualmente um servidor, fornecendo as seguintes informaes
para o CandleDBConfig:

1) Nome do Servidor - o nome do servidor de banco de dados que voc deseja monitorar. 

2) Diretrio Home - o nome completo do diretrio no qual o servidor
   foi instalado. 

3) Verso do $Product -  a verso ou nvel de release do executvel do banco de dados. 

4) Nome do Arquivo de Inicializao - o nome completo do arquivo de inicializao do banco de dados. 
   Este campo  opcional e  fornecido apenas para fins informativos. O OMA
   para $Product no requer um nome de arquivo de inicializao. 

5) ID de Login - o ID de login do banco de dados utilizado para conectar-se ao $Product.

6) Senha - a senha a ser utilizada com \"ID de Login.\"

Quando estas informaes tiverem sido fornecidas, a lista de servidores de banco de dados mostrados no CandleDBConfig ser atualizada para incluir o novo servidor. 

</Add>

# --------------------------- CHANGES ---------------------------------------
#
# Removido pois era atual apenas para o 98R2.

# --------------------------- DISPLAY ---------------------------------------
#
# DISPLAY foi combinado com MODIFY.


# --------------------------- EXCLUDE ---------------------------------------

<Exclude/Include>
Excluir/Incluir 

Uso:  Selecione um ou mais servidores de banco de dados entre os exibidos no
CandleDBConfig; clique em \"Excluir.\"

\"Excluir\"  de fato uma comutao. Utilize-o para excluir servidores que voc
no deseja monitorar. Se um servidor estiver excludo, \"Excluir\" reativar
e o incluir com os servidores que esto sendo monitorados.

Se sua \"Procura\" tambm localizar servidores que no esto em execuo, o CandleDBConfig considerar
qualquer arquivo $init_name vlido que aponte para um banco de dados real para representar um servidor.
No entanto, um arquivo $init_name pode ser experimental ou obsoleto. \"Excluir\" permite
excluir estes servidores de considerao adicional. 

Lembre-se, NO  necessrio excluir um servidor apenas porque ele
no est em execuo. Voc pode configurar um agente para monitorar um servidor que no est em execuo e at mesmo iniciar esse agente. O agente ser registrado no CMS e, periodicamente,
tentar conectar-se ao banco de dados. Se o banco de dados estiver iniciado, o agente
comear a fazer um relatrio sobre ele. Portanto, voc pode definir um agente para monitorar um banco de dados
do $Product por meio perodo e esse agente relatar a atividade do banco de dados conforme ela ocorre. 

O campo \"Status\" dos servidores de banco de dados mostrados no CandleDBConfig 
atualizado para mostrar servidores excludos. 

</Exclude/Include>

# --------------------------- INTRO   ---------------------------------------
#
# No utilizado. 

# --------------------------- LIST ------------------------------------------

<List Config Files>
Listar Arquivos de Configurao 

Uso:  selecione um ou mais servidores de banco de dados entre os exibidos no
CandleDBConfig; clique em \"Listar;\" visualize o arquivo de configurao; se exibido, utilize os botes
\"Anterior\" e \"Prximo\" para visualizar diferentes arquivos de configurao; clique em \"Cancelar.\"

\"Listar\"  utilizado para visualizar o contedo dos arquivos de configurao do servidor
de banco de dados criados por CandleDBConfig. Neste momento, os arquivos podem ser apenas visualizados; eles
no podem ser editados a partir do CandleDBConfig.

</List Config Files>

# --------------------------- LOCATE ----------------------------------------

<Search II (Disk Searches)>
Procura II (Procuras de Disco)

Uso:  clique em \"Procura II;\" selecione um tipo de procura; clique em \"Ir.\"

\"Procura II\" fornece vrias tcnicas de procura que podem ser utilizadas se \"Procurar\"
no tiver localizado todos os bancos de dados que voc deseja monitorar. Suas opes de \"Procura II\"
so:

1) Procurar scripts em \$PATH, procurando $home_name.

   Normalmente, se voc utilizar scripts gravados localmente para iniciar aplicativos de banco de dados,
   cada script dever conter uma instruo que configura $home_name como o diretrio de instalao
   do banco de dados. Esta opo procura todos os scripts no
   \$PATH do UNIX, procurando esta instruo. 

2) Procurar, comeando em um diretrio especfico. Este diretrio geralmente  o \$HOME
   do proprietrio do banco de dados. No entanto, voc pode especificar qualquer diretrio,
   desde que seja utilizado um nome do caminho completo. Esta opo  semelhante a 1) exceto se a procura estiver
   restrita a diretrios sob o diretrio especificado em vez dos especificados
   em \$PATH.

3) Procurar possveis proprietrios de $Product.

   Voc pode solicitar que o CandleDBConfig procure nos arquivos do disco sob os diretrios
   \$HOME de usurios do UNIX que podem ter a instalao do banco de dados. Em seguida, 
   exibida uma lista de todos os usurios do UNIX que possuem os caracteres \"$Prd\" ou
   \"dba\" em seu ID ou descrio e, portanto, podem ser os proprietrios de $Product.
   Depois de selecionar usurios desta lista, o CandleDBConfig procura em suas rvores de
   diretrio, procurando instalaes de $Product. 

   Lembre-se, esta opo suporta usurios que esto definidos no arquivo /etc/passwd ou
   nos bancos de dados de login compartilhados \"yp\" ou \"nis\". Observe tambm que os sistemas de
   arquivos esto especificados na lista. Este campo ajuda a determinar se um usurio ser considerado, pois
   informa onde o disco do usurio est localizado fisicamente. 

   Ateno: as procuras por meio de sistemas de arquivos NFS podem demorar muito tempo se o sistema
   de arquivo for gerenciado por uma mquina na outra extremidade de um link de comunicao lenta.
No entanto, tais sistemas de arquivos geralmente no contm servidores de banco de dados
   que so executados nesta mquina. 


A lista de servidores de banco de dados mostrados no CandleDBConfig  ento atualizada para incluir servidores adicionais localizados utilizando as tcnicas de \"Procura II\". 

</Search II (Disk Searches)>

# --------------------------- LOGIN  ----------------------------------------

<Specify Logins/Passwords>
Especificar Logins/Senhas 

Uso:  selecione um ou mais servidores de banco de dados entre os exibidos no
CandleDBConfig; clique em \"Especificar;\" preencha o dilogo; clique em \"OK.\"

\"Especificar\" permite definir os logins e senhas do banco de dados utilizados pelo agente
para acessar o banco de dados. Voc pode selecionar qualquer ID de login de banco de dados
novo ou existente. O login padro  "candle". Observe que os IDs do banco de dados so definidos pelo administrador de banco de dados e permitem acesso ao banco de dados. Um ID de login do UNIX no  necessariamente um ID de login de banco de dados, mas os dois podem ter o mesmo nome. Os servidores
definidos para o OMA para $Product mas que no possuem informaes de login ou de senha
so mostrados com um (I) para incomplete (no concludo) no CandleDBConfig.

\"Especificar\" APENAS informa os agentes de monitoramento Candle sobre como conectar-se ao banco de dados.
O CandleDBConfig no cria o ID de login de banco de dados, designa a ele uma senha
ou concede as autoridades necessrias.  de sua responsabilidade assegurar que o login e a senha do banco de dados correspondam aos especificados aqui. No entanto, \"Verificar\"
verificar se o login/senha especificados em CandleDBConfig realmente funcionam
para seu banco de dados. 

Se o campo de senha ficar vazio, o CandleDBConfig perguntar se voc realmente
deseja uma senha nula. Uma senha nula significa que o login de banco de dados foi configurado
para funcionar sem uma senha. Para segurana, a senha aparece como \"xxxxxx\" no
arquivo de log, $CANDLEHOME/logs/<nome_do_host>_dd_config.log  

Nota para o Oracle 7.1.4:  O Oracle 7.1.4 permite que o ID de login de administrao interno
\"sys\" leia apenas as visualizaes de desempenho. Este  um erro que o Oracle corrigiu
em releases posteriores, mas no existe nenhuma correo disponvel para 7.1.4. Portanto, ao conectar-se a um banco de dados Oracle 7.1.4,  necessrio especificar um ID de login de banco de dados \"sys\". 

A lista de servidores de banco de dados mostrados no CandleDBConfig  ento atualizada para
mostrar os novos IDs de login. 

</Specify Logins/Passwords>

# --------------------------- MODIFY  ---------------------------------------

<Modify/Display>
Modificar/Exibir 

Uso:  selecione um ou mais servidores de banco de dados entre os exibidos no
CandleDBConfig; clique em \"Modificar;\" digite ou altere valores no dilogo; clique em
\"Modificar.\"

\"Modificar\" lista todos os seguintes atributos configurados para um servidor e permite
alterar qualquer um deles, exceto o nome do servidor: 

1) Diretrio Home - o nome completo do diretrio no qual o servidor
   foi instalado. 

2) Verso do $Product -  a verso ou nvel de release do executvel do banco de dados. 

3) Nome do Arquivo de Inicializao - o nome completo do arquivo de inicializao do banco de dados. 
   Este campo  opcional e  fornecido apenas para fins informativos. O OMA
   para $Product no requer um nome de arquivo de inicializao. 

   IMPORTANTE:  se um servidor tiver alterado nomes, NO utilize este campo para apontar
   para o novo arquivo $init_name. Em vez disso, exclua este servidor e deixe o CandleDBConfig
   incluir o novo nome como um novo servidor. 

4) ID de Login - O ID de login de banco de dados utilizado para conectar-se ao $Product.

5) Senha - a senha a ser utilizada com o \"ID de Login.\"

A lista de servidores de banco de dados mostrados no CandleDBConfig  ento atualizada para
mostrar as novas informaes de configurao. 

</Modify/Display>

# --------------------------- OPTIONS ------------------------------------------

<Options>
Opes 

Uso:  clique em \"Opes;\" selecione opes; clique em \"OK.\"

\"Opes\"  utilizado para configurar o comportamento de tempo de execuo de operaes do CandleDBConfig.
Se \"verificar arquivos de configurao\" estiver selecionado, cada operao do CandleDBConfig
assegurar que os arquivos de configurao do banco de dados, localizados em $CANDLEHOME/config,
tenham o formato correto. 

Por padro (\"utilizar arquivo de log existente\"), o CandleDBConfig grava uma entrada em seu
arquivo de log existente, $CANDLEHOME/logs/<nome_do_host>_dd_config.log, sempre que ele desempenha uma operao. Se desejar registrar apenas a ltima operao ou no registrar nada,
selecione \"criar novo arquivo de log\" ou \"no gravar no arquivo de log.\"

</Options>

# --------------------------- OWNER  ----------------------------------------
#
# OWNER agora faz parte de Search2.

# --------------------------- SCAN ------------------------------------------

<Search>
Procurar 

Uso:  se desejar, marque \"no em execuo;\" clique em \"Opes;\" selecione opes;
clique em \"OK;\" clique em \"Procurar.\"

Quando chamar o CandleDBConfig ou pressionar \"Procurar,\" o CandleDBConfig desempenhar
uma varredura inicial de seu ambiente para procurar todos os servidores $Product em execuo. Se voc marcar \"no em execuo,\" o CandleDBConfig tambm procurar bancos de dados
que no esto em execuo no momento. Os resultados de uma procura so exibidos no
dilogo do CandleDBConfig.

O CandleDBConfig examina todos os servidores $Product em execuo, localiza onde eles esto
instalados em seu sistema UNIX e adquire outras informaes sobre eles. O tempo necessrio
para concluir uma procura depende da verso do UNIX que est sendo executada. 

Se voc solicitar que o CandleDBConfig procure servidores que no esto em execuo, ele criar uma lista interna de todos os possveis diretrios $home_name e procurar qualquer servidor
definido l. O CandleDBConfig desenvolve esta lista de possveis diretrios $home_name
a partir de: 

1) O diretrio $home_name de qualquer (quaisquer) servidor(es) em execuo. 

2) A configurao atual da varivel de ambiente $home_name, se houver alguma. 

3) Qualquer instruo em um script automtico (.profile, .login, etc.) no diretrio
   \$HOME do proprietrio do banco de dados que cria a varivel de ambiente. 

4) Se o script raiz de ps-instalao do Oracle, \$ORACLE_HOME/orainst/root.sh,
   tiver sido executado durante a instalao do Oracle, ele criou um arquivo de registro denominado
   /etc/oratab. Oracle e Candle recomendam a execuo deste script para
   que os servidores Oracle possam ser facilmente localizados. Observe que o CandleDBConfig assume
   que o registro ou o arquivo oratab  denominado /etc/oratab.

Se \"Procurar\" localizar um servidor que voc no deseja monitorar, ser possvel exclu-lo
utilizando o boto \"Excluir\". Alm disso, as opes de procura escolhidas com o boto
\"Opes\" ficam em vigor at que sejam alteradas. 

</Search>

# --------------------------- SYSTEM ---------------------------------------

<System/DB Config>
Configurao do Sistema/DB 

A seguir est uma breve viso geral da preparao do sistema e do banco de dados necessria
antes de o OMA (OMEGAMON Monitoring Agent) poder monitorar um banco de dados. Consulte o
documento \"Installing Candle Products on UNIX\" para obter detalhes completos. 

SYSTEM

1) O executvel kddos requer permisses especiais do UNIX. Estas permisses
   devem ter sido configuradas durante a instalao do OMA. Caso contrrio, elas podero
   ser configuradas utilizando o instalador do produto Candle. Consulte o documento \"Installing Candle Products
   on UNIX\" para obter detalhes. 

2) O CMS deve ter o suporte ao aplicativo includo com os dados de incluso de suporte ao aplicativo apropriados. O CMS deve ter tido
   o suporte ao aplicativo includo durante a instalao do OMA. Caso contrrio, o CMS poder ter o suporte ao aplicativo includo utilizando o instalador do produto Candle. Consulte o documento \"Installing Candle Products
   on UNIX\" para obter detalhes. 

DATABASE

INFORMIX

A nica autorizao necessria para o Informix  o direito de conectar-se
ao banco de dados. $CANDLEHOME/misc/koxgrant.sql tem a sintaxe SQL correta para isso. 

O OMA para Informix inclui um programa que precisa ser executado como o
Informix ALARMPROGRAM opcional. Modifique o ONCONFIG para que ALARMPROGRAM seja
$CANDLEHOME/<arch>/koxerr para seu tipo de sistema UNIX. Se voc j tiver um
ALARMPROGRAM customizado, modifique a instruo ONCONFIG ALARMPROGRAM para apontar para
koxerr.sh, e modifique koxerr.sh para fazer referncia a seu programa. O script koxerr.sh
possui instrues completas. 

ORACLE

O OMA para Oracle utiliza um ID de login do Oracle para conectar-se ao banco de dados. Exceto
para o Oracle 7.1.4, o OMA pode utilizar qualquer ID do Oracle, mesmo um ID que seja
utilizado para outros fins. O CandleDBConfig no cria este ID. O ID pode ser definido
sem uma senha, se voc desejar. Neste caso, indique uma senha nula para CandleDBConfig.
Alm disso, os logins e senhas do Oracle NO fazem distino entre maisculas e minsculas. 

A seguinte instruo SQL do Oracle define um ID e senha para o Oracle. Neste exemplo,
\"oralogin\" indica o login do Oracle que ser utilizado e \"password\"
sua senha: 

  CREATE USER oralogin IDENTIFIED BY password;

Os requisitos de segurana se diferem para estes releases do Oracle: 

  7.1.4  O OMA para Oracle deve conectar-se como \"sys.\"  Esta  uma limitao do Oracle. 

  7.1.6  Voc pode utilizar qualquer login do Oracle, mas ele deve ter autoridade para
         ler qualquer tabela. Se o ID for \"candle,\" voc conceder esta autoridade conectando-se ao Oracle com um login do Oracle que tenha privilgios de DBA e emitindo
         a seguinte instruo SQL: 

           GRANT SELECT ANY TABLE TO oralogin;

         Este requisito  uma limitao do Oracle. 

  7.2 e posterior. Voc pode utilizar qualquer login do Oracle, mas ele requer que sejam concedidos a ele apenas privilgios
      especficos. O Candle fornece um script SQL que desempenha
      estas concesses. Este script est localizado em $CANDLEHOME/misc/korgrant.sql.
      A seguir esto instrues breves para execuo deste script. Consulte o documento
      \"Installing Candle Products on UNIX\" para obter detalhes adicionais. 

      a) Configure as variveis de ambiente do Oracle, ORACLE_SID e ORACLE_HOME,
         para esta instalao. Se voc tiver concludo a configurao dos bancos de dados,
         poder \"originar\" os arquivos no diretrio de configurao para
         configurar estas variveis. 

      b) Inicie o sqlplus.

      c) Emita o seguinte no prompt do SQL:  SQL> @korgrant candle

      Ateno:  sqldba e svrmgr(l) no permitem parmetros com scripts sql. 
      Se voc executar korgrant.sql com um destes programas, poder modific-lo para
      substituir todas as ocorrncias de &1 pelo ID de logon que deseja utilizar. 

O OMA para Oracle requer que as visualizaes e sinnimos de desempenho do Oracle sejam
instalados. Eles so criados pelo instalador do Oracle se ele for executado at a concluso.
As visualizaes e sinnimos de desempenho tambm podem ser criados pelo script SQL
apropriado em ORACLE_HOME/rdbms/admin. Consulte a documentao do Oracle para obter detalhes.
Observe que este requisito no ser necessrio se voc utilizar o ID de login \"sys\" do Oracle, que deve ser utilizado para o Oracle 7.1.4.

Apenas no Oracle 7.2, o Oracle ignora concesses  tabela V\$LATCH. Para corrigir isso,
aplique a correo do Oracle para corrigir o \"erro bsico #254661.\" Esta correo permite visualizar dados no \"Relatrio de Totais de Cache.\" Se voc no instalar esta correo,
dever instalar o Oracle com o login \"sys\". 

O OMA para Oracle no requer acesso s tabelas SYS.DBA_VIEWS e
SYS.DBA_SYNONYMS, mas o procedimento \"Verificar\" do CandleDBConfig requer. Se o
CandleDBConfig no puder ler estas tabelas, ele no poder verificar totalmente a instalao.
No entanto, o OMA ainda funcionar. 

SYBASE

O OMA para Sybase utiliza um ID de login do Sybase para conectar-se ao banco de dados. Ele pode utilizar qualquer ID do Sybase, mesmo um ID que seja utilizado para outros fins. O CandleDBConfig no cria este ID. O ID pode ser definido
sem uma senha, se voc desejar. Neste caso, indique uma senha nula para CandleDBConfig.
Alm disso, os logins e senhas do Sybase
FAZEM distino entre maisculas e minsculas. 

A seguinte instruo isql do Sybase define um ID e senha para o Sybase. Neste
exemplo, \"syblogin\" indica o login do Sybase que ser utilizado e \"password\"
sua senha: 

  sp_addlogin syblogin,password
  go

O Candle tambm fornece um script SQL, $CANDLEHOME/misc/koygrant.sql, para conceder as
autoridades necessrias. 

O OMEGAMON Monitoring Agent para Sybase utiliza a biblioteca \"Open Client\" do Sybase
para conectar-se ao Sybase. Se \"Open Client\" no estiver instalado no sistema Sybase,
o agente no poder conectar-se ao Sybase e voc receber uma mensagem no arquivo
col.out que informa que o CT-INIT falhou. Voc pode determinar se o \"Open Client\"
est instalado verificando no diretrio home do Sybase a presena de lib/libct.a.

Se o \"Open Client\" no estiver instalado, ser necessrio obter um dos seguintes: 

1) o produto \"Open Client\" do Sybase.  de nosso conhecimento que cada licena do servidor
   Sybase autoriza o cliente a uma nica licena gratuita do \"Open Client\".
Entre em contato com o Sybase para obter informaes adicionais. 

2) uma verso de runtime do CTlib para Sybase. Ela est disponvel, livre de encargos,
   no suporte de Nvel 2 do Candle. O Candle tem permisso do Sybase para distribuir
   a parte de tempo de execuo do CTlib.

</System/DB Config>

# --------------------------- VERIFY ---------------------------------------

<Verify OMA Installation>
Verificar Instalao do OMA 

Uso:  clique em \"Verificar;" verifique os resultados mostrados no dilogo; clique em \"Cancelar.\"

\"Verificar\" assegura que o OMA foi instalado corretamente verificando se: 

1) existe uma verso vlida do UNIX. 

2) as permisses do UNIX esto corretas em diretrios chave sob $CANDLEHOME.

3) as permisses especiais do UNIX esto configuradas para kddos.

4) os arquivos de configurao do produto existem para este host.

Para cada servidor configurado, \"Verificar\" verifica se: 

5) o arquivo de configurao  vlido e se a configurao est concluda. 

6) o diretrio home do banco de dados e o arquivo de inicializao do banco de dados existem
   e se voc tem permisso de leitura no arquivo. 

7) o produto Sybase Open Client est instalado para o servidor. 

8) o servidor de banco de dados est em execuo. Caso contrrio, a verificao do OMA para
   este banco de dados no pode continuar. 

9) voc pode efetuar login com xito no banco de dados. 

10) voc pode acessar as tabelas de desempenho V\$ do Oracle. Se no puder, isto pode
    indicar que: 

    a) as tabelas nunca foram criadas (Consulte o captulo 5 do guia de planejamento,
       seo: \"V\$ Dynamic Performance Tables.\").

    b) o script korgrant.sql no foi executado. 

    Sem autoridade de DBA,  impossvel saber alguma informao. 

    Observe que \"Verificar\" testa todas as visualizaes e sinnimos de desempenho do Oracle. O OMA para
    Oracle falhou em alguns sites porque as visualizaes e sinnimos de desempenho
    foram criados apenas parcialmente na instalao do Oracle. Alm disso, este teste requer
    que o usurio do Oracle tenha autoridade SELECT para SYS.DBA_VIEWS e
    SYS.DBA_SYNONYMS. Estas concesses NO fazem parte do script korgrant.sql, porque a maioria das instalaes do Oracle concedem SELECT para tabelas do catlogo PUBLIC.

11) voc pode acessar a visualizao de desempenho do Oracle 7.2 SYS.V_\$LATCH. Se no puder,
    consulte o documento \"Installing Candle Products on UNIX\". 

12) o script koygrant.sql do Sybase foi executado. Este script concede sa_role
    ao login do Sybase. 

13) para Informix, seu site fez as modificaes necessrias na instruo
    ALARMPROGRAM do arquivo ONCONFIG. Consulte o documento \"Installing Candle Products on UNIX\".


14) o host do CMS responde a um ping.

15) o agente pode conectar-se a um CMS. Se no puder, isto pode indicar que: 

    a) o Host do CMS, o nmero da porta do CMS ou o nome do CMS est incorreto. 

    b) o CMS no est em execuo. 

    Sem acesso direto  mquina do CMS e o conhecimento de exatamente onde o
    CMS est instalado nessa mquina, o CandleDBConfig no pode informar nada. 

16) o CMS teve a incluso de suporte ao aplicativo e foi reciclado desde a incluso do suporte ao aplicativo. Se o CMS tiver sido
    apenas reciclado, os resultados anteriores podero ser inconclusivos. Por isso, \"Verificar\"
    permite que o agente seja executado at cinco minutos antes de concluir que o CMS
    est inativo ou no recebeu a incluso de suporte ao aplicativo. No entanto, se o agente determinar que o CMS est inativo,
    o agente IVP ser reciclado imediatamente, porque o comportamento padro  esperar dez
    minutos antes de tentar a reconexo.

\"Verificar\" no verifica se: 

1) os arquivos cat, atr, sql (dados de incluso de suporte ao aplicativo) e his no CMS esto em um nvel consistente
   com este agente instalado. 

2) problemas de tempo causam tempos limite de comunicao. 

3) para Informix, seu site no revogou a autoridade SELECT para as tabelas do sistema
   de PUBLIC. O script koxgrant.sql no contm concesses especficas para
   elas -  assumido que seu site tenha deixado estas concesses como foram fornecidas originalmente pelo Informix.


</Verify OMA Installation>

