Descoberta do banco de dados Oracle

Os padrões executam a descoberta de instalações do Oracle. Esses padrões substituem vários probes por novas instâncias. Se você quiser continuar a usar 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.

O Discovery 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 apenas para dois casos de uso: Criando conexões para 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 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 o tnsnames.ora esteja configurado corretamente e exista no caminho Oracle no host Windows de destino. Além disso, verifique se as credenciais do Discovery utilizadas podem ler o arquivo tnsnames.ora.
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 a Descoberta e o Mapeamento de serviços, consulte Comandos do Mapeamento de serviços que requerem um usuário privilegiado para obter uma lista dos comandos que exigem direitos elevados para descobrir e mapear hosts baseados em Unix na sua organização.
Credenciais SSH

Requisitos adicionais

O Discovery identifica uma instância em execução de um banco de dados Oracle no UNIX do processo que inicia com ora_pmon_. Certifique-se de que este processo esteja sendo executado no intervalo de IPs que você designou para o Discovery. O Discovery 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 Oracle Clusterware, você também precisa de permissões para ler o arquivo /etc/hosts/, que associa nomes de host a endereços IP.

Os comandos a seguir são executados para o Oracle clusterware:


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 'error\|return code'`	Obtém o nome do cluster do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crsctl query crs softwareversion\| egrep -v 'error\|return code'`	Obtém o ID do cluster do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crsctl query crs softwareversion\| egrep -v 'error\|return code'`	Obtém a versão do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/olsnodes \| egrep -v 'error\|return code'`	Obtém nós do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crsctl status server \| egrep -v 'error\|return code'`	Obtém o status do nó do Oracle CRS.
`/u01/app/12.1.0.2/grid/bin/crs_stat -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 \| grep -v erro \| grep -v falhou`	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 VIP do Oracle RAC SCAN.
/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}'	Obtenha VIPs do Oracle CRS ip_address.

Permissão sudo para executar: sudo /u01/app/12.1.0.2/grid/bin/ocrcheck | egrep -v 'error|return code'

Classificadores, padrões e probes

O Discovery usa estes classificadores, probes e padrões para descoberta de banco de dados Oracle:


Classificador	Probes de gatilho	Padrão
Instância do Oracle	Probe de Discovery horizontal: inicia padrões Powershell-Oracle - PFfile 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 sendo executado 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 Oracle Instances [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 ORA_HOME/bin/lsnrctl` status Do caminho de ORA_HOME
Arquivo de parâmetro	pfile	Os locais a seguir são explorados para o local do arquivo de parâmetro do sistema. Se este arquivo não existir em um dos locais explorados, o Discovery 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 obter 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âmetro do sistema. Se este arquivo não existir em um dos locais explorados, o Discovery 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 obter extensões de padrão e informações adicionais coletadas.

Opções do Oracle

O Discovery 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/ O Discovery os 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	current_used
Data de primeiro uso	first_usage
Data de último uso	last_usage
Data de última amostra	last_sample
Uso detectado	detect_usage
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 Oracle para UNIX e Windows: DBA_FEATURE_USAGE_STATISTICS CDB_FEATURE_USAGE_STATISTICS V$DATABASE V$VERSION GV$PARAMETER V$CONTAINERS V$INSTANCE	As extensões padrão a seguir usam o scriptoptions_packs_usage_statistics.sql da Oracle. Este script sql é para o DB Server 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 Oracle para UNIX Extensões de opção Oracle para Windows

Tabela 3. Dados coletados no 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, um +1 em um servidor de banco de dados Oracle significa que ele faz parte de um cluster.

Estender extensão de instância Oracle

Nota:

O Discovery 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/. O Discovery salva esses atributos na tabela Oracle Instances [cmdb_ci_db_ora_instance].


Rótulo	Nome do campo
Instância	instância
Nome do host	host_name
IS_CDB	cdb_sin
Nome exclusivo do DB	db_exclusivo_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 Oracle para UNIX e Windows: V$DATABASE V$INSTANCE	A extensão Estender instância Oracle precisa ser instalada. Esta extensão está incluída na aplicação Discovery and Service Mapping Patterns, versão 1.0.72 ou superior, que pode ser baixada em ServiceNow Store.

Instâncias 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 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 Oracle em máquinas virtuais que são hospedadas em nuvens AWS ou Azure


Classe base	Relacionamento	Classe dependente
Instância 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	AWS Datacenter [cmdb_ci_aws_datacenter] ou Azure Datacenter [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]