Descoberta do banco de dados Oracle

Os padrões executam a descoberta de instalações do Oracle. Esses padrões substituem várias probes para novas instâncias. Se você quiser continuar a usar os probes, poderá desativar o probe Descoberta horizontal, que inicia o padrão e, em seguida, ativar os probes necessários.

Nota:

Oracle em UNIX e Oracle em Windows não são compatíveis com a descoberta de nó único do RAC.

A Descoberta não descobre os próprios bancos de dados Oracle, que são chamados de catálogos de bancode dados.

Nota:

Para obter informações sobre a migração de probe para padrão, consulte o artigo de conhecimento KB0694477

Credenciais

Configurar estas credenciais:


Tipo de credencial	Informações adicionais
Credenciais de aplicativo	As credenciais do aplicativo são obrigatórias para dois casos de uso: Executar consultas SQL na instância remota do banco de dados Oracle Criando conexões com links de banco de dados Software Asset Management ativado Você deve adicionar o usuário do banco de dados configurado durante a instalação do banco de dados Oracle. Especifique a `instância do Oracle [cmdb_ci_db_ora_instance]` como o tipo de IC. O usuário também deve ter acesso ao arquivo de parâmetros tnsnames.ora. Certifique-se de que tnsnames.ora esteja configurado corretamente e exista no caminho do Oracle no host do Windows de destino. Além disso, verifique se as credenciais de descoberta utilizadas podem ler o arquivo tnsnames.ora. O usuário precisa de permissões para a ferramenta de linha de comando SQL*Plus e permissões para executar consultas SELECT nas seguintes tabelas: VERSÃO_DO_COMPONENTE_DO_PRODUTO V$VERSION V$DATABASE V$PARAMETER
Credenciais do Windows	Você também pode usar credenciais do Windows e SSH, além das credenciais do aplicativo. Para credenciais do Windows, o usuário deve ter permissões de leitura para o arquivo `tnsnames.ora`. As credenciais SSH devem conceder permissão de leitura ao arquivo `oratab` e permissão de leitura ao arquivo de parâmetros do sistema. Para obter uma lista de comandos privilegiados necessários para Descoberta e Mapeamento de serviços, consulte Comandos do Mapeamento de serviços que requerem um usuário privilegiado para acessar uma lista dos comandos que exigem direitos elevados para descobrir e mapear hosts baseados em Unix na sua organização.
Credenciais SSH

Requisitos adicionais

A Descoberta identifica uma instância em execução de um banco de dados Oracle no UNIX a partir do processo que começa com ora_pmon_. Certifique-se de que este processo esteja sendo executado no intervalo de IPs que você designou para a Descoberta de gravação. A Descoberta identifica uma instância em execução de um banco de dados Oracle no Windows a partir do processo oracle.exe. Certifique-se de que este processo esteja sendo executado no intervalo de IPs que você designou.

Para o clusterware da Oracle, você também precisa de permissões para ler o arquivo /etc/hosts/, que associa nomes de host a endereços IP.

Os seguintes comandos são executados para o clusterware da Oracle:


Comando	Descrição
`ps -ef \| grep 'crsd.bin' \| grep -v grep`	Verifica se o processo do Oracle CRS está em execução.
`ps -ef \|grep LISTENER \| grep -v $$ \| cabeçalho -1 \| awk '{print $8}'`	Obtém a página inicial do Oracle.
`/u01/app/12.1.0.2/grid/bin/olsnodes -c \| egrep -v 'erro\|código de retorno'`	Obtém o nome do cluster do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crsctl query crs softwareversion\| egrep -v 'erro\|código de retorno'`	Obtém o ID do cluster do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crsctl query crs softwareversion\| egrep -v 'erro\|código de retorno'`	Obtém a versão do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/olsnodes \| egrep -v 'erro\|código de retorno'`	Obtém nós do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crsctl servidor de status \| egrep -v 'erro\|código de retorno'`	Obtém o status do nó do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crsctl stat res -f \| tr '\n' '#'`	Obtém recursos do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crsctl stat res -p \| grep -v check_r \| erro de grep -v \| erro de grep -v \| falha`	Obtém recursos VIP do Oracle CRS.
/u01/app/12.1.0.2/grid/bin/srvctl verificação de configuração \| tr '\n' ' '	Obtém as configurações do Oracle RAC SCAN VIP.
/u01/app/12.1.0.2/grid/bin/srvctl config vip -node ol7-121-rac1\| egrep 'Nome' \| awk '{print $3}'	Obtém o nome dos VIPs do Oracle CRS.
/u01/app/12.1.0.2/grid/bin/srvctl config vip -node ol7-121-rac1\| grep ' Endereço IPv4:' \| awk '{print $4}'	Obter ip_address do Oracle CRS VIPs.

Permissão Sudo para executar: sudo /u01/app/12.1.0.2/grid/bin/ocrcheck | egrep -v 'erro|código de retorno'

Classificadores, padrões e probes

A Descoberta usa estes classificadores, probes e padrões para a descoberta do banco de dados Oracle:


Classificador	Probes de gatilho	Padrão
Instância do Oracle	Probe de Discovery horizontal: inicia padrões Powershell-Oracle - PFile de instância (para Windows)* Powershell-Oracle - Versão da instância (para Windows)* SSHCommand-Oracle - Detalhes da instância (para Linux)*	Padrões de aplicação: Padrão Oracle DB no Windows Padrão Oracle DB no UNIX Este padrão de biblioteca compartilhada usado pelo padrão do Servidor Linux : Cluster do UNIX – ORACLE Clusterware Nota: Este padrão de biblioteca compartilhada será acionado se o processo `crsd.bin` estiver em execução no servidor de banco de dados Oracle.
Oracle Listener	SSHCommand-Oracle - Detalhes do ouvinte	nenhuma

*Probes inativos para novas instâncias.

Para usar padrões, verifique se o padrão correto está especificado no probe de padrão horizontal no classificador. Consulte Adicione o probe do padrão horizontal a um classificador para obter instruções.

Dados coletados

Os dados a seguir são coletados na tabela Instâncias do Oracle [cmdb_ci_db_ora_instance] para UNIX e Windows:

Tabela 1. Dados coletados em máquinas UNIX
Rótulo	Nome do campo	Informações adicionais
SID	sid	Obtido do nome do processo que começa com `ora_pmon_`
Diretório de instalação	install_directory	Obtido do caminho de ORA_HOME
Versão	versão	Obtido nesta ordem: Da saída do `comando ORA_HOME/bin/sqlplus /NOLOG` Da saída do comando de status `ORA_HOME/bin/lsnrctl` Do caminho de ORA_HOME
Arquivo de parâmetro	pfile	Os locais a seguir são explorados para o local do arquivo de parâmetros do sistema. Se este arquivo não existir em um dos locais explorados, a Descoberta não encontrará o arquivo e relatará um erro. `oracle_home`/dbs/spfile`SID`.ora `oracle_home`/dbs/spfile.ora `oracle_home`/dbs/init`SID`.ora
Página Inicial do Oracle	oracle_home	Obtido do arquivo `ORATAB`.
Edição	edição	Obtido do arquivo context.xml.
Nome	name	Combinação de nome do SID Nome do host no formato SID@HOST_NAME.
Porta(s) TCP	tcp_port	Obtido do arquivo tnsnames.ora ou do comando lsnrctl status. Se nenhuma informação válida for recuperada, a porta padrão 1521 será atribuída.

Nota:

Consulte Opções do Oracle para extensões de padrão e informações adicionais coletadas.

Tabela 2. Dados coletados em máquinas Windows
Rótulo	Nome do campo	Informações adicionais
SID	sid	Obtido do parâmetro de processo que é passado para o processo oracle.exe.
Diretório de instalação	install_directory
Versão	versão	Obtido da saída do comando ORA_HOME/bin/sqlplus.exe -V.
Arquivo de parâmetro	pfile	Os locais a seguir são explorados para o local do arquivo de parâmetros do sistema. Se este arquivo não existir em um dos locais explorados, a Descoberta não encontrará o arquivo e relatará um erro. `oracle_home`\database\spfile`SID`.ora `oracle_home`\database\spfile.ora `oracle_home`\database\init`SID`.ora
Página Inicial do Oracle	oracle_home	Analisado a partir do caminho de oracle.exe
Edição	edição

Nota:

Consulte Opções do Oracle para extensões de padrão e informações adicionais coletadas.

Opções do Oracle

A Descoberta também pode encontrar as opções do Oracle que você habilita na instância. Consulte o site da Oracle para obter mais informações sobre as opções https://docs.oracle.com/en/ A Descoberta as salva na tabela Opções da Oracle [samp_oracle_options].


Rótulo	Nome do campo
Instância	instância
Opção	opção
Licenciável	licenciável
Usado atualmente	atualmente_usado
Data de primeiro uso	first_usage
Data de último uso	último_uso
Data de última amostra	última_amostra
Uso detectado	uso_detectado
Intervalo de amostra	amostra_intervalo


Privilégios de tabela necessários	Informações adicionais
As tabelas a seguir são acessadas como parte da extensão de opção do Oracle para UNIX e Windows: DBA_FEATURE_USAGE_STATISTICS CDB_FEATURE_USAGE_STATISTICS V$DATABASE V$VERSION GV$PARAMETER V$CONTAINERS V$INSTÂNCIA	As extensões de padrão a seguir usam as opções de script_packs_usage_statistics.sql do Oracle. Este script sql é para o servidor de banco de dados versão 11.2 e posterior. Você precisa do privilégio Selecionar qualquer dicionário para executar o script. Consulte o documento de suporte ID13172651.1 em https://support.oracle.com/portal/ para obter mais informações sobre scripts de uso. Extensões de opção do Oracle para UNIX Extensões de opção do Oracle para Windows

Tabela 3. Dados coletados em clusterware
Tabela	Rótulos e nomes de campo
Cluster do Unix [cmdb_ci_unix_cluster]	Nome [name] Status do cluster [cluster_status] Tipo de cluster [cluster_type] Endereço IP [ip_address] Descrição resumida [short_description] ID do cluster [cluster_id] Versão do cluster [cluster_version]
cmdb_ci_unix_cluster_node	Nome [name] Estado do nó [node_state] Endereço IP [ip_address] Status do nó [node_status]
cmdb_ci_unix_cluster_resource	Nome [name] Tipo de recurso [resource_type] Status do recurso [resource_status] Propriedades [properties]
cmdb_ci_cluster_vip	Nome [name] Endereço IP [ip_address] Nome do cluster [cluster_name] ID do cluster [cluster_id]

Na exibição de dependência, +1 em um servidor de banco de dados Oracle significa que ele faz parte de um cluster.

Estender extensão da instância do Oracle

Nota:

A Descoberta também pode encontrar atributos adicionais para a instância usando a extensão de instância Estender Oracle. Consulte o site da Oracle para obter mais informações sobre as opções https://docs.oracle.com/en/. A Descoberta salva esses atributos na tabela Instâncias do Oracle [cmdb_ci_db_ora_instance].


Rótulo	Nome do campo
Instância	instância
Nome do host	host_name
IS_CDB	cdb_yn
Nome exclusivo do DB	db_unique_name
Nome de BD	database_name
Replicação habilitada	replication_enabled


Privilégios de tabela necessários	Informações adicionais
As tabelas a seguir são acessadas como parte da extensão Estender instância do Oracle para UNIX e Windows: V$DATABASE V$INSTÂNCIA	A extensão Estender instância do Oracle precisa ser instalada. Esta extensão está incluída na aplicação Padrões de descoberta e mapeamento de serviços, versão 1.0.72 ou superior, que pode ser baixada do ServiceNow Store.

Instâncias do Oracle em máquinas virtuais

Quando as instâncias do Oracle são hospedadas em máquinas virtuais, o sistema cria relacionamentos entre ICs.


IC	Relacionamento	IC
Instância do Oracle	Hospedado em	Computador [cmdb_ci_computer] ou servidor [cmdb_ci_server] Nota: Esta é uma máquina virtual. O campo É virtual é verdadeiro.
Computador [cmdb_ci_computer] ou servidor [cmdb_ci_server] Nota: Esta é uma máquina virtual. O campo É virtual é verdadeiro.	Virtualizado por	Computador [cmdb_ci_computer] ou servidor [cmdb_ci_server] Nota: Esta não é uma máquina virtual.

Instâncias do Oracle em máquinas virtuais hospedadas em nuvens AWS ou Azure


Classe base	Relacionamento	Classe dependente
Instância do Oracle	Hospedado em	Computador [cmdb_ci_computer] Nota: Esta é uma máquina virtual. O campo É virtual é verdadeiro.
Computador [cmdb_ci_computer] Nota: Esta é uma máquina virtual. O campo É virtual é verdadeiro.	Virtualizado por	Computador [cmdb_ci_computer] Nota: Esta não é uma máquina virtual.
Computador [cmdb_ci_computer] Nota: Esta é uma máquina virtual. O campo É virtual é verdadeiro.	Virtualizado por	Instâncias de máquina virtual [cmdb_ci_vm_instance] Nota: A contagem de vCPUs é preenchida nesta tabela.
Instâncias de máquina virtual [cmdb_ci_vm_instance]	Hospedado em	Datacenter da AWS [cmdb_ci_aws_datacenter] ou Datacenter do Azure [cmdb_ci_azure_datacenter]

Relacionamentos para clusterware


IC	Relacionamento	IC
Cluster do Unix [cmdb_ci_unix_cluster]	Virtualiza::Virtualizado por	IP virtual do cluster [cmdb_ci_cluster_vip]
Recurso de cluster do Unix [cmdb_ci_unix_cluster_resource]	Defines resources for::Gets resources from	Nó do cluster do Unix [cmdb_ci_unix_cluster_node]
IP virtual do cluster [cmdb_ci_cluster_vip]	Uses::Used by	Nó do cluster do Unix [cmdb_ci_unix_cluster_node]
Nó do cluster do Unix [cmdb_ci_unix_cluster_node]	Cluster of::Cluster	Cluster do Unix [cmdb_ci_unix_cluster]
Nó do cluster do Unix [cmdb_ci_unix_cluster_node]	Hosted on:Hosts	Cluster do Unix [cmdb_ci_unix_cluster]
Recurso de cluster do Unix [cmdb_ci_unix_cluster_resource]	Defines resources for::Gets resources from	Cluster do Unix [cmdb_ci_unix_cluster]
Cluster do Unix [cmdb_ci_unix_cluster]	Hosts::Hosted on	Servidor Linux [cmdb_ci_linux_server]
Nó do cluster do Unix [cmdb_ci_unix_cluster_node]	Hosted on::Hosts	Servidor Linux [cmdb_ci_linux_server]