Administração e configuração

Esta seção aborda tarefas essenciais para gerenciar e configurar ambientes do Oracle AI Database. Inclui comandos como dbaascli admin updateStack para instalar ou atualizar o RPM dbaastools e dbaascli job getStatus para verificar o status de jobs específicos.

dbaascli admin updateStack

Para instalar ou atualizar um RPM dbaastools, use o comando dbaascli admin updateStack.

Pré-requisitos:

Execute o comando como usuário root.

Para usar o utilitário, conecte-se a uma máquina virtual Oracle Base Database Cloud@Customer.

Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.

Sintaxe:

dbaascli admin updateStack
[--resume]
[--prechecksOnly]
[--nodes]

Parâmetros:

Parâmetro Descrição
--resume retoma a execução anterior
--prechecksOnly executa apenas as pré-verificações dessa operação
--nodes especifica uma lista de nós delimitados por vírgulas para instalar o RPM. Se você não informar esse argumento, o RPM será instalado em todos os nós do cluster

Perguntas Frequentes:

P: Para que o comando dbaascli admin updateStack é usado?

R: O comando dbaascli admin updateStack é usado para instalar ou atualizar um RPM dbaastools no Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando updateStack do admin dbaascli?

R: Você deve executar o comando como o usuário raiz e estabelecer conexão com uma máquina virtual do Oracle Base Database Cloud@Customer.

P: O que a opção –resume faz?

R: A opção --resume retomará a execução anterior do comando updateStack se ele tiver sido interrompido ou incompleto.

P: Qual é a finalidade da opção –prechecksOnly?

R: A opção --prechecksOnly executa somente as pré-verificações da operação sem realmente executar a instalação ou a atualização.

P: Como o parâmetro –nodes é usado?

R: O parâmetro --nodes especifica uma lista de nós delimitados por vírgulas na qual o RPM deve ser instalado. Se não for fornecido, o RPM será instalado em todos os nós do cluster.

P: O que devo fazer se encontrar problemas com o comando updateStack do administrador dbaascli?

R: Certifique-se de estar executando o comando como usuário raiz e de estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer. Verifique se há alguma mensagem de erro específica e consulte a documentação do comando ou o suporte da Oracle, se necessário.

P: Como estabeleço conexão com uma máquina virtual do Oracle Base Database Cloud@Customer para usar o comando updateStack do administrador dbaascli?

R: Você precisa usar SSH para se conectar à máquina virtual. Consulte a seção Connecting to a Virtual Machine with SSH na documentação para obter instruções detalhadas.

Exemplos:

Exemplo: Instalando ou atualizando o RPM dbaastools em todos os nós

dbaascli admin updateStack

Instala ou atualiza o RPM dbaastools em todos os nós do ambiente do Oracle Base Database Cloud@Customer.

Exemplo: Executando pré-verificações somente antes de instalar ou atualizar o RPM

dbaascli admin updateStack --prechecksOnly

Executa somente as pré-verificações para a atualização do RPM dbaastools, sem realmente executar a instalação. Ele garante que todos os pré-requisitos sejam atendidos antes de continuar com a atualização.

Exemplo: Retomando uma operação updateStack interrompida anteriormente

dbaascli admin updateStack --resume

Retoma uma operação de atualização de RPM dbaastools anterior que foi interrompida ou não foi concluída com sucesso.

Exemplo: Instalando ou atualizando dbaastools em nós específicos

dbaascli admin updateStack --nodes node1,node2

Instala ou atualiza o RPM dbaastools somente nos nós especificados node1 e node2, sem afetar outros nós no cluster.

Exemplo: Retomando o processo updateStack em nós específicos

dbaascli admin updateStack --resume --nodes node3,node4

Retoma o processo de atualização de dbaastools nos nós específicos node3 e node4 somente se a execução anterior tiver sido interrompida.

dbaascli job getStatus

Para exibir o status de um job especificado, use o comando dbaascli job getStatus.

Pré-requisitos:

Execute o comando como usuário root.

Para usar o utilitário, conecte-se a uma máquina virtual Oracle Base Database Cloud@Customer.

Consulte Estabelecendo Conexão com uma Máquina Virtual com SSH.

Sintaxe:

dbaascli job getStatus --jobID

Parâmetros:

Parâmetro Descrição
--jobID especifica o ID do job

Perguntas Frequentes:

P: Para que o comando dbaascli job getStatus é usado?

A: O comando dbaascli job getStatus é usado para exibir o status

Exemplos:

Exemplo: Verificando o status de um job específico usando o ID do job

dbaascli job getStatus --jobID 12345

Verifica o status da tarefa com o ID 12345. A saída mostrará o estado atual do job (por exemplo, em andamento, concluído ou com falha).

Exemplo: Verificando o status de um job de aplicação de patch usando o ID do job

dbaascli job getStatus --jobID 98765

Recupera o status de um job de aplicação de patch com o ID 98765 para ver se o patch foi aplicado com sucesso ou ainda está em execução.

Exemplo: Verificando o status de um job de backup do banco de dados

dbaascli job getStatus --jobID 45678

Verifica o status de um job de backup do banco de dados com o ID 45678. A saída fornecerá detalhes sobre o andamento ou a conclusão do backup.

Exemplo: Verificando o andamento de um job de longa execução

dbaascli job getStatus --jobID 23456

Verifique o andamento de um job de longa execução (ID 23456) para ver se ele ainda está em execução ou se foi concluído.

Exemplo: Exibindo o status de um job de criação de banco de dados

dbaascli job getStatus --jobID 67890

Verifica o status de um job de criação de banco de dados identificado pelo ID do job 67890.

Escala de CPU:

Saiba como exibir e ajustar recursos de CPU em um cluster de VMs com base nos requisitos de carga de trabalho.

dbaascli system scalecpu

Para aumentar ou diminuir a contagem de núcleos de CPU de uma máquina virtual em um cluster de VMs quando a conectividade de rede entre o Control Plane Server e a região do OCI for interrompida, use o comando dbaascli cpuscale update.

Sintaxe:

dbaascli system scaleCPU
        {
            --coreCount <value> [--message <value>]
            | --status
        }

Parâmetros:

Parâmetro Descrição
--coreCount Atualiza a contagem de núcleos de CPU de cada VM no cluster para o valor especificado.
--message Opcionalmente, especifica uma mensagem de texto para a operação de dimensionamento atual.
--status Exibe detalhes da última atualização de contagem de núcleos de CPU solicitada da VM atual.

Perguntas Frequentes:

P: Para que o comando dbaascli system scaleCPU é usado?

R: O comando dbaascli system scaleCPU é usado para aumentar ou diminuir a contagem de núcleos de CPU de cada VM em um cluster de VMs.

P: O que a opção –coreCount especifica?

R: A opção --coreCount especifica o número de destino de núcleos de CPU para cada VM no cluster de VMs.

P: Posso incluir uma mensagem com uma operação de dimensionamento de CPU?

A: Sim. Use a opção opcional --message para especificar uma mensagem de texto para a operação de dimensionamento atual.

Q: Como faço para verificar o status de uma operação de dimensionamento de CPU?

R: Use a opção --status para exibir detalhes da atualização de contagem de núcleos de CPU mais recente solicitada da VM atual.

P: Posso usar o --coreCount e o --status juntos?

A: Não. Especifique --coreCount com um --message opcional ou --status.

Exemplos:

Exemplo: Expandindo núcleos de CPU

Para aumentar a contagem de núcleos de CPU de cada VM no cluster de VMs para 20:

dbaascli system scaleCPU --coreCount 20

O comando solicita que a contagem de núcleos de CPU de cada VM no cluster de VMs seja atualizada para 20.

Exemplo: Reduzindo núcleos de CPU

Para diminuir a contagem de núcleos de CPU de cada VM no cluster de VMs para 8:

dbaascli system scaleCPU --coreCount 8

O comando solicita que a contagem de núcleos de CPU para cada VM no cluster de VMs seja atualizada para 8.

Exemplo: Dimensionando núcleos de CPU com uma mensagem

Para atualizar a contagem de núcleos de CPU para 20 e incluir uma mensagem:

dbaascli system scaleCPU --coreCount 20 --message "Scaling up for increased demand"

O comando solicita a atualização da contagem de núcleos de CPU e associa a mensagem especificada à operação de dimensionamento.

Exemplo: Verificando o status de uma operação de dimensionamento de CPU

Para exibir detalhes da última atualização da contagem de núcleos de CPU:

dbaascli system scaleCPU --status

O comando exibe os detalhes da última atualização de contagem de núcleos de CPU solicitada da VM atual.

Exemplo: Verificando o status após solicitar uma escala de CPU

Depois de solicitar uma atualização da contagem de núcleos de CPU, você pode verificar o status da operação executando:

dbaascli system scaleCPU --status

Isso permite verificar os detalhes da solicitação de dimensionamento de CPU mais recente.

Diagnóstico e Verificações de Integridade:

Esta seção abrange ferramentas para manter a integridade e diagnosticar problemas em ambientes do Oracle AI Database. Comandos como dbaascli diag collect são usados para reunir dados de diagnóstico, enquanto o dbaascli diag healthCheck permite executar verificações de integridade para identificar possíveis problemas. Essas ferramentas ajudam a garantir a estabilidade e o desempenho do sistema, monitorando e abordando proativamente as preocupações.

dbaascli diag collect

Para coletar diagnóstico, use o comando dbaascli diag collect.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe:

dbaascli diag collect [--components <value>] [--startTime <value>] [--endTime <value>] [--nodes <value>] [--dbNames <value>]
        {
            [--objectStoreBucketUri <value>]
            | [--destLocation <value>]
        }
        [--waitForCompletion <value>]

Parâmetros:

Parâmetro Descrição
--components especifica uma lista de componentes para coleta de logs. Valores válidos: db, gi, os, dbaastools, all.
--startTime especifica o horário inicial da coleta de logs. Formato válido de data e hora: YYYY-MM-DDTHH24:MM:SS
--endTime especifica o horário de término da coleta de logs. Formato válido de data e hora: YYYY-MM-DDTHH24:MM:SS
--nodes especifica uma lista de nós delimitados por vírgulas para coletar logs
--dbNames especifica o nome do banco de dados para o qual os logs serão coletados. Você só pode especificar um nome de banco de dados.
--objectStoreBucketURI especifica um URL de solicitação pré-autenticada (PAR) do serviço Object Storage usado para fazer upload dos logs coletados. Os logs são coletados da VM Convidada. Para obter mais informações, consulte Usando Solicitações Pré-autenticadas.
--destLocation especifica o local na VM Convidada para coletar logs. Padrão: /var/opt/oracle/dbaas_acfs
--waitForCompletion Valores: true ou false. Padrão true. Especifique false para ser executado em segundo plano.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli diag collect?

R: O comando dbaascli diag collect é usado para coletar logs de diagnóstico para o Oracle AI Database e componentes associados, como OS, Grid Infrastructure (GI) e ferramentas DBaaS.

P: Como eu especifico para quais componentes coletar diagnósticos?

R: Você pode especificar os componentes usando a opção --components. Os valores válidos são os seguintes:

P: Como posso coletar logs para um intervalo de tempo específico?

A: Use as seguintes opções para especificar um intervalo de tempo:

O horário deve estar no formato: YYYY-MM-DDTHH24:MM:SS.

P: Em qual formato os horários de início e término devem estar?

A: --startTime e --endTime devem estar no formato YYYY-MM-DDTHH24:MM:SS. Por exemplo, 2024-09-01T15:30:00.

P: Como eu especifico de quais nós coletar diagnósticos?

R: Você pode usar a opção --nodes para especificar uma lista de nós delimitados por vírgulas. Por exemplo:

--nodes node1,node2

P: Como faço para coletar logs para um banco de dados específico?

R: Use a opção --dbNames para especificar o nome do banco de dados cujos logs você deseja coletar. Somente um nome de banco de dados pode ser especificado por vez.

P: Como posso armazenar os logs coletados no Object Storage?

R: Use a opção --objectStoreBucketUri para especificar o URL da solicitação pré-autenticada (PAR) para seu bucket do Object Storage no qual os logs serão submetidos a upload.

P: Posso coletar logs em um diretório local em vez de no Object Storage?

R: Sim, você pode usar a opção --destLocation para especificar um diretório na VM convidada em que os logs serão coletados. O local padrão é /var/opt/oracle/dbaas_acfs.

P: O que acontece se eu não especificar um destino para os logs?

R: Se nenhum destino for especificado, os logs coletados serão armazenados no local padrão /var/opt/oracle/dbaas_acfs na VM convidada.

P: O que a opção –waitForCompletion faz?

A: A opção --waitForCompletion especifica se o comando deve ser finalizado antes de retornar o controle ao usuário. O valor padrão é true. Se você especificar false, a operação será executada em segundo plano.

P: Como posso executar a coleta de logs em segundo plano?

A: Defina a opção --waitForCompletion como false para executar o processo de coleta de logs em segundo plano:

dbaascli diag collect --waitForCompletion false

P: Posso retomar uma sessão de coleta de logs anterior com este comando?

R: Não, o comando dbaascli diag collect não suporta a retomada das sessões anteriores. Você precisará iniciar um novo processo de coleta de logs.

P: Como posso garantir que os logs sejam carregados diretamente no Object Storage?

R: Você pode fornecer um --objectStoreBucketUri válido (URL de solicitação pré-autenticada do serviço Object Storage) no qual o upload dos logs será feito após a coleta.

P: Posso coletar logs para vários bancos de dados de uma só vez?

R: Não, você só pode especificar um nome de banco de dados por vez usando a opção --dbNames.

P: O que devo fazer se quiser coletar todos os logs disponíveis para todos os componentes?

R: Use --components tudo para coletar logs de todos os componentes, incluindo o banco de dados, o Grid Infrastructure, o sistema operacional e as ferramentas DBaaS.

P: O que é um exemplo de comando para coletar logs do componente de banco de dados em um intervalo de tempo específico?

A: Aqui está um exemplo de comando:

dbaascli diag collect --components db --startTime 2024-09-01T12:00:00 --endTime 2024-09-01T14:00:00 --dbname orcl

P: Qual é um exemplo de comando para coletar logs e fazer upload deles no Object Storage?

A: Aqui está um exemplo de comando:

dbaascli diag collect --components db --objectStoreBucketUri https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

P: Qual será o comportamento padrão se a opção –components não for especificada?

R: Se você não especificar a opção --components, o comando poderá não saber quais logs coletar e poderá falhar. É recomendável sempre especificar os componentes dos quais você deseja coletar logs.

P: Posso especificar as opções –objectStoreBucketUri e –destLocation no mesmo comando?

R: Não, você deve selecionar um destino: Armazenamento de Objetos via --objectStoreBucketUri ou um diretório local via --destLocation.

P: O que devo fazer se encontrar um erro ao usar o comando dbaascli diag collect?

R: Verifique duas vezes se você forneceu nomes de componentes válidos, formatos de data/hora e opções de destino. Além disso, verifique se você está executando o comando como o usuário root.

dbaascli diag healthCheck

Para executar verificações de integridade de diagnóstico, use o comando dbaascli diag healthCheck.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe:

dbaascli diag healthCheck
[--destLocation]
[--nodes]
[--objectStoreBucketURI]

Parâmetros:

Parâmetro Descrição
--destLocation especifica o local na VM Convidada para coletar logs. Padrão: /var/opt/oracle/dbaas_acfs
--nodes especifica uma lista de nós delimitados por vírgulas para coletar logs
--objectStoreBucketURI especifica um URL de solicitação pré-autenticada (PAR) do serviço Object Storage usado para fazer upload dos logs coletados. Os logs são coletados da VM Convidada. Para obter mais informações, consulte Usando Solicitações Pré-autenticadas.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli diag healthCheck?

R: O comando dbaascli diag healthCheck é usado para executar verificações de integridade de diagnóstico em um Oracle AI Database em execução em um ambiente Oracle Base Database Cloud@Customer.

P: Quais são os pré-requisitos para usar o comando dbaascli diag healthCheck?

R: O comando deve ser executado como usuário do root e você deve estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer.

P: Como eu especifico um diretório personalizado para coletar os logs?

R: Use a opção --destLocation para especificar o diretório no qual os logs de verificação de integridade serão coletados. O local padrão é /var/opt/oracle/dbaas_acfs.

P: Qual é o local padrão da coleta de logs se eu não especificar –destLocation?

R: O diretório padrão para coleta de logs é /var/opt/oracle/dbaas_acfs.

P: Posso especificar quais nós executar a verificação de integridade?

R: Sim, você pode usar a opção --nodes para especificar uma lista de nós delimitados por vírgulas em que a verificação de integridade deve ser executada.

P: Como faço upload dos logs de verificação de integridade para o Object Storage?

R: Use a opção --objectStoreBucketURI para fornecer um URL de PAR (solicitação pré-autenticada) do serviço Object Storage. Isso fará upload dos logs coletados para o bucket especificado.

P: Posso coletar logs de vários nós?

R: Sim, você pode especificar vários nós usando a opção --nodes em um formato delimitado por vírgulas. Por exemplo: --nodes node1,node2.

P: O que é um comando de exemplo para executar uma verificação de integridade em um nó específico?

A: Aqui está um exemplo de comando para executar a verificação de integridade em um nó específico:

dbaascli diag healthCheck --nodes node1

P: Como posso armazenar os logs no Object Storage em vez de na máquina local?

R: Você pode fornecer um URL de PAR (solicitação pré-autenticada) usando a opção --objectStoreBucketURI para armazenar os logs no Object Storage.

P: Posso especificar –destLocation e –objectStoreBucketURI ao mesmo tempo?

R: Sim, você pode especificar --destLocation para armazenamento local e --objectStoreBucketURI para fazer upload de logs para o serviço Object Storage.

P: O que devo fazer se encontrar um erro ao executar o comando dbaascli diag healthCheck?

R: Certifique-se de que você esteja executando o comando como usuário raiz e tenha fornecido opções válidas para --destLocation, --nodes ou --objectStoreBucketURI. Verifique se os nomes dos nós são válidos se especificados.

P: Posso executar a verificação de integridade em segundo plano?

R: O comando dbaascli diag healthCheck não tem um modo de fundo explícito, mas você pode executá-lo em segundo plano anexando e no final do comando.

P: O que acontece se eu não fornecer a opção –nodes?

R: Se a opção --nodes não for fornecida, a verificação de integridade será executada em todos os nós do cluster por padrão.

P: Posso retomar uma sessão de verificação de integridade anterior usando este comando?

R: Não, o comando dbaascli diag healthCheck não suporta a retomada das sessões anteriores. Você deve iniciar uma nova verificação de integridade toda vez.

P: Qual é um exemplo de comando para executar uma verificação de integridade e fazer upload de logs para o Object Storage?

A: Aqui está um exemplo de comando:

dbaascli diag healthCheck --objectStoreBucketURI https://objectstorage.example.com/n/namespace-string/b/bucket-name/o/PAR-URL

P: Qual é o comportamento padrão se eu não especificar –destLocation ou –objectStoreBucketURI?

R: Se nem --destLocation nem --objectStoreBucketURI forem especificados, os logs de verificação de integridade serão coletados no diretório padrão /var/opt/oracle/dbaas_acfs na máquina local.

P: Posso limitar a verificação de integridade a componentes ou logs específicos?

R: Não, o comando dbaascli diag healthCheck não permite especificar componentes ou logs individuais. Executa uma verificação de integridade de diagnóstico geral para o sistema.

P: O que devo verificar antes de executar o comando dbaascli diag healthCheck?

R: Certifique-se de estar conectado a uma máquina virtual do Oracle Base Database Cloud@Customer e de executar o comando como o usuário root.

Gerenciamento do Sistema:

Esta seção se concentra na supervisão e no gerenciamento de Oracle homes no sistema. Ele inclui comandos como dbaascli system getDBHomes para exibir detalhes sobre todos os homes do Oracle AI Database e dbaascli system getGridHomes para listar os detalhes de todos os homes do Grid Infrastructure. Esses comandos fornecem informações essenciais para a manutenção e a solução de problemas do ambiente geral do sistema.

dbaascli system getDBHomes

Para exibir informações sobre todos os Oracle homes, use o comando dbaascli system getDBHomes.

Pré-requisitos:

Execute o comando como usuário root ou oracle.

Sintaxe:

dbaascli system getDBHomes

Perguntas Frequentes:

P: Para que o comando dbaascli system getDBHomes é usado?

R: O comando dbaascli system getDBHomes é usado para exibir informações sobre todos os Oracle homes em um sistema.

P: Qual usuário deve executar o comando dbaascli system getDBHomes?

R: O comando deve ser executado como usuário root ou oracle.

P: Há algum parâmetro para o comando dbaascli system getDBHomes?

R: Não, o comando dbaascli system getDBHomes não tem parâmetros.

P: Que tipo de informação o comando dbaascli system getDBHomes fornece?

R: O comando fornece detalhes sobre todos os Oracle homes no sistema, incluindo seus caminhos e outras informações relevantes.

P: Como posso interpretar a saída do comando dbaascli system getDBHomes?

R: A saída listará todos os Oracle homes com informações como a localização de cada Oracle home. Essas informações podem ajudar no gerenciamento e na configuração de ambientes Oracle.

P: O que devo fazer se o comando dbaascli system getDBHomes não retornar nenhuma saída?

R: Certifique-se de que você esteja executando o comando como usuário root ou oracle e verifique se os Oracle homes estão instalados corretamente no sistema. Você também pode verificar as permissões e configurações do sistema.

P: E se eu receber uma mensagem de erro ao executar o comando dbaascli system getDBHomes?

R: Verifique a mensagem de erro para obter detalhes específicos, verifique se você tem as permissões apropriadas e certifique-se de que a ferramenta dbaascli esteja instalada e configurada corretamente.

P: Posso executar o dbaascli system getDBHomes em um sistema não Oracle?

R: Não, o comando dbaascli system getDBHomes é específico para sistemas Oracle e requer a instalação do software Oracle.

Exemplo: dbaascli system getDBHomes

dbaascli system getDBHomes

dbaascli system getGridHomes

Para listar os detalhes de todos os homes do Grid, use o comando dbaascli system getGridHomes.

Pré-requisitos:

Execute o comando como usuário root ou oracle.

Sintaxe:

dbaascli system getGridHomes

Perguntas Frequentes:

P: Para que o comando dbaascli system getGridHomes é usado?

R: O comando dbaascli system getGridHomes é usado para listar os detalhes de todos os homes do Grid em um sistema.

P: Qual usuário deve executar o comando dbaascli system getGridHomes?

R: O comando deve ser executado como usuário root ou oracle.

P: Há algum parâmetro para o comando dbaascli system getGridHomes?

R: Não, o comando dbaascli system getGridHomes não tem parâmetros.

P: Que tipo de informação o comando dbaascli system getGridHomes fornece?

R: O comando fornece detalhes sobre todos os homes do Grid no sistema, incluindo seus locais e outras informações relevantes.

P: Como posso interpretar a saída do comando dbaascli system getGridHomes?

R: A saída listará todos os Grid homes com informações como seus caminhos e configurações. Isso ajuda a gerenciar e configurar o Oracle Grid Infrastructure.

P: O que devo fazer se o comando dbaascli system getGridHomes não retornar nenhuma saída?

R: Certifique-se de estar executando o comando como o usuário root ou oracle e verifique se os homes do Oracle Grid estão instalados corretamente no sistema. Verifique as permissões e configurações do sistema, se necessário.

P: E se eu receber uma mensagem de erro ao executar o comando dbaascli system getGridHomes?

R: Verifique a mensagem de erro para obter detalhes específicos, certifique-se de ter as permissões apropriadas e verifique se a ferramenta dbaascli está instalada e configurada corretamente.

P: Posso executar o dbaascli system getGridHomes em um sistema sem o Oracle Grid Infrastructure?

R: Não, o comando dbaascli system getGridHomes é específico para sistemas com o Oracle Grid Infrastructure instalado. Se nenhum Grid homes estiver presente, o comando pode não retornar nenhum resultado.