Gerenciamento da Infraestrutura de Grade

Esta seção se concentra no gerenciamento do Oracle Grid Infrastructure, que suporta clustering e alta disponibilidade. As principais tarefas incluem configurar um home do Grid Infrastructure (dbaascli gridHome create), fazer upgrade do Grid Infrastructure (dbaascli grid upgrade) e gerenciar certificados TCPS (Transport Layer Security) configurando (dbaascli grid configureTCPS), removendo (dbaascli grid removeTCPSCert) ou rotacionando-os (dbaascli grid rotateTCPSCert). Esses comandos garantem uma configuração, manutenção e segurança eficientes do Grid Infrastructure.

dbaascli gridHome create
dbaascli grid configureTCPS
dbaascli grid removeTCPSCert
dbaascli grid rotateTCPSCert
dbaascli grid upgrade
patch de grade dbaascli

dbaascli gridHome create

Para configurar o home do Grid Infrastructure, use o comando dbaascli gridHome create.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe:

dbaascli gridHome create --version value [--resume [--sessionID value]] [--waitForCompletion value]

Parâmetros:

Parâmetro	Descrição
`--version`	especifica a versão do Grid home
`--resume`	retoma a execução anterior
`--sessionID`	especifica para retomar um ID da sessão específico
`--waitForCompletion`	especifica `false` para executar a operação no segundo plano. Valores válidos: `true` ou `false`

Perguntas Frequentes:

P: Qual é a finalidade do comando de criação dbaascli gridHome?

R: O comando dbaascli gridHome create é usado para configurar um home do Grid Infrastructure para o Oracle Grid Infrastructure em um ambiente do Oracle Base Database Cloud@Customer.

P: Qual é o pré-requisito para executar o comando de criação dbaascli gridHome?

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

P: Como especifico a versão do home do Grid Infrastructure a ser criada?

R: Use a opção --version para especificar a versão do home do Grid. Esta é uma opção obrigatória ao criar o home do Grid.

P: Posso retomar uma sessão de criação dbaascli gridHome anterior?

R: Sim, você pode usar a opção --resume para retomar uma sessão anterior. Opcionalmente, você pode especificar o ID da sessão usando a opção --sessionID para retomar uma sessão específica.

P: O que a opção –resume faz no comando de criação dbaascli gridHome?

R: A opção --resume permite retomar uma operação interrompida ou incompleta anteriormente.

P: Como faço para executar a operação em segundo plano?

R: Você pode definir a opção --waitForCompletion como falsa para executar a operação em segundo plano. Os valores válidos para essa opção são true (padrão) ou false.

P: Qual será o comportamento padrão se –waitForCompletion não for especificado?

A: Se --waitForCompletion não for especificado, a operação será executada em primeiro plano e o comando aguardará a conclusão da operação antes de retornar o controle ao usuário.

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

A: A opção --sessionID é usada para especificar o ID de uma sessão anterior que você deseja retomar, em caso de uma operação incompleta ou interrompida.

P: Posso usar o comando de criação dbaascli gridHome para fazer upgrade de um Grid home existente?

R: Não, esse comando é usado especificamente para configurar um novo home do Grid Infrastructure, não para fazer upgrade de um existente.

P: O que é um comando de exemplo para criar um home do Grid com a versão 19.9.0.0.0?

A: Aqui está um exemplo de comando:

dbaascli gridHome create --version 19.9.0.0.0

P: O que devo fazer se o comando de criação dbaascli gridHome for interrompido?

R: Você pode retomar a operação usando a opção --resume. Se você tiver o ID da sessão, poderá fornecê-lo usando a opção --sessionID para retomar uma sessão específica.

P: Posso especificar a opção –resume sem um ID de sessão?

R: Sim, você pode usar a opção --resume sem especificar um ID de sessão. Nesse caso, o sistema tentará retomar a sessão mais recente.

P: O que acontece se eu especificar –waitForCompletion false?

R: Se você especificar --waitForCompletion false, a operação será executada em segundo plano, permitindo que você continue usando a linha de comando enquanto a operação for concluída.

P: É possível acompanhar o progresso de uma operação em segundo plano?

R: O comando dbaascli não fornece uma maneira direta de rastrear operações em segundo plano. Pode ser necessário verificar os logs do sistema ou o status da sessão manualmente.

P: Posso especificar uma versão inválida do Grid home ao criá-lo?

R: Não, a opção --version deve conter uma versão válida do Grid Infrastructure. Se uma versão inválida for fornecida, o comando retornará um erro.

P: Como posso determinar a versão do Grid home a ser usada para criação?

R: Você pode consultar a documentação da Oracle ou consultar o administrador do banco de dados para determinar a versão correta do Grid home a ser usada para o seu ambiente.

P: O que devo verificar antes de executar o comando de criação dbaascli gridHome?

R: Certifique-se de estar conectado como usuário root e de que a versão que você deseja usar para o Grid Infrastructure seja compatível com seu ambiente.

dbaascli grid configureTCPS

Para configurar o TCPS para o cluster existente, use o comando dbaascli grid configureTCPS.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe:

dbaascli grid configureTCPS
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]

Parâmetros:

Parâmetro	Descrição
`--pkcs12WalletFilePath`	especifica o caminho absoluto do arquivo do certificado, que está no formato `pkcs12` da wallet
`--caCertChain`	lista concatenada de certificados, contendo certificações de CA intermediárias e certificações de CA raiz
`--precheckOnly`	especifica `yes` para executar somente as pré-verificações desta operação. Valores válidos: `yes` ou `no`.
`--serverCert`	especifica o caminho do certificado PEM a ser usado ou rotacionado para configuração TCPS.
`--privateKey`	especifica o caminho do arquivo de chave privada do certificado.
`--certType`	tipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são: `SELF_SIGNED_CERT`, `CA_SIGNED_CERT` ou `PKCS12_CERT`. Padrão: `SELF_SIGNED_CERT`
`--privateKeyPasswordProtected`	especifica se a chave privada é protegida por senha ou não. Valores válidos: `true` ou `false`. Padrão: `true`.

Configuração do TCPS para o Oracle Base Database Cloud@Customer:

O comportamento do TCPS difere com base no tipo de implantação do Oracle Base Database Cloud@Customer:

Para o Oracle Database 19c e versões posteriores, o TCPS é ativado por padrão para bancos de dados recém-provisionados. Os bancos de dados existentes que foram provisionados antes da introdução desse comportamento podem não ter o TCPS ativado.

Para ativar o TCPS para um banco de dados existente, atualize o arquivo sqlnet.ora específico do banco de dados em todos os nós do banco de dados adicionando o parâmetro WALLET_LOCATION da seguinte forma:

WALLET_LOCATION = (SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/grid/tcps_wallets)))

Após atualizar o arquivo sqlnet.ora em todos os nós do banco de dados, reinicie o banco de dados para ativar o TCPS.

A ativação do TCPS poderá afetar a conectividade do Oracle Zero Data Loss Recovery Appliance (ZDLRA) se o banco de dados não estiver configurado para usar o parâmetro WALLET_ROOT. Antes de ativar o TCPS, verifique se os seguintes pré-requisitos foram atendidos:

O banco de dados está executando o Oracle Database Release Update 19.17 ou posterior.
O banco de dados é configurado para usar o parâmetro WALLET_ROOT.
Se o banco de dados estiver configurado para backups ZDLRA, verifique se a configuração do canal do RMAN faz referência a RA_WALLET em WALLET_ROOT/server_seps.

Por exemplo:

Conecte-se ao RMAN.
Execute o seguinte comando:
```
SHOW CHANNEL;
```

Verifique se a saída contém uma entrada RA_WALLET semelhante à seguinte:

CONFIGURE CHANNEL DEVICE TYPE 'SBT_TAPE' FORMAT '%d_%I_%U_%T_%t' PARMS "SBT_LIBRARY=/u02/app/oracle/product/19.0.0.0/dbhome_1/lib/libra.so, ENV=(RA_WALLET='location=file:/var/opt/oracle/dbaas_acfs/dbrs19c/wallet_root/server_seps credential_alias=DBRS')";

Neste exemplo, o local RA_WALLET aponta para WALLET_ROOT/server_seps, que é compatível com TCPS.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli grid configureTCPS?

R: O comando dbaascli grid configureTCPS é usado para configurar o TPS (Transport Layer Security) para o cluster existente em um ambiente do Oracle Base Database Cloud@Customer.

P: Qual é o pré-requisito para executar o comando dbaascli grid configureTCPS?

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

P: O TCPS está ativado por padrão nos sistemas Oracle Base Database Cloud@Customer?

R: Não, o TCPS não é ativado por padrão nos sistemas Oracle Base Database Cloud@Customer. Para ativar o TCPS, atualize o arquivo sqlnet.ora do banco de dados específico e reinicie o banco de dados.

P: Qual é a consequência da ativação do TCPS nos sistemas Oracle Base Database Cloud@Customer?

R: A ativação do TCPS nos sistemas Oracle Base Database Cloud@Customer fará com que as conexões do Zero Data Loss Recovery Appliance (ZDLRA) falhem. Você só pode ativar a configuração ZDLRA ou TCPS, mas não ambas simultaneamente.

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

R: A opção --pkcs12WalletFilePath especifica o caminho absoluto para o arquivo de certificado no formato da wallet PKCS12, que é usado para configuração TCPS.

P: Para que é usada a opção –caCertChain?

A: A opção --caCertChain especifica uma lista concatenada de certificados que contêm certificados de CA intermediários e o certificado de CA raiz.

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

A: A opção --precheckOnly especifica se só serão executadas as pré-verificações da operação de configuração TCPS. Os valores aceitos são yes ou no.

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

R: A opção --serverCert especifica o caminho para o certificado PEM que será usado ou alternado para a configuração TCPS.

P: Como eu especifico a chave privada para configuração TCPS?

R: Use a opção --privateKey para especificar o caminho para o arquivo de chave privada associado ao certificado do servidor.

P: Quais são os valores aceitos para a opção –certType?

A: Os valores aceitos para a opção --certType são:

SELF_SIGNED_CERT
CA_SIGNED_CERT
PKCS12_CERT

O valor-padrão é SELF_SIGNED_CERT.

P: A senha da chave privada está protegida por padrão?

R: Sim, a opção --privateKeyPasswordProtected é definida como true por padrão, indicando que a chave privada é protegida por senha. Você poderá defini-la como false se a chave privada não for protegida por senha.

P: Posso executar uma pré-verificação antes de configurar o TCPS?

R: Sim, você só pode executar as pré-verificações da operação definindo a opção --precheckOnly como sim. Isso ajuda a validar o ambiente antes de fazer alterações.

P: O que acontece se eu fornecer um caminho incorreto para o arquivo da wallet PKCS12?

R: Se o --pkcs12WalletFilePath contiver um caminho incorreto, o comando falhará e a configuração do TCPS não prosseguirá.

P: O que devo fazer se a chave privada estiver protegida por senha?

R: Se a chave privada estiver protegida por senha, certifique-se de que a opção --privateKeyPasswordProtected esteja definida como true (que é o padrão).

P: Posso especificar meu próprio certificado assinado pela CA para configuração TCPS?

R: Sim, você pode especificar seu próprio certificado assinado pela CA usando as opções --serverCert e --privateKey e definindo o --certType como CA_SIGNED_CERT.

P: O que é um comando de exemplo para configurar o TCPS usando um certificado autoassinado?

A: Veja a seguir um exemplo:

dbaascli grid configureTCPS --serverCert /path/to/self_signed_cert.pem --privateKey /path/to/private_key.pem --certType SELF_SIGNED_CERT

P: Posso usar um certificado PKCS12 para configuração TCPS?

R: Sim, você pode usar um certificado PKCS12 especificando a opção --pkcs12WalletFilePath e definindo o --certType como PKCS12_CERT.

P: O que devo verificar antes de executar o comando dbaascli grid configureTCPS?

R: Verifique se você tem os arquivos de certificado válidos, os arquivos de chave privada e se está conectado como usuário raiz. Além disso, certifique-se de entender as implicações se você estiver usando ZDLRA, pois ele não pode ser executado simultaneamente com TCPS.

Exemplo: dbaascli grid configureTCPS

Para configurar a grade usando o certificado autoassinado:

dbaascli grid configureTCPS

Para configurar a grade usando o certificado assinado pela CA:

dbaascli grid configureTCPS --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --private_key_password_protected false

dbaascli grid removeTCPSCert

Para remover certificados TCPS existentes da wallet do Grid Infrastructure, use o comando dbaascli grid removeTCPSCert.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe:

dbaascli grid removeTCPSCert --subject <value>
 {
   --userCert | --trustedCert | --requestedCert
 }
 [--serialNumber <value>] [--executePrereqs] [--resume [--sessionID <value>]] [--bounceListeners]

Parâmetros:

Parâmetro	Descrição
`--subject`	especifica o assunto do certificado
`--userCert`	flag para indicar certificado de usuário
`--trustedCert`	flag para indicar certificado confiável
`--requestedCert`	flag para indicar certificado solicitado
`--serialNumber`	especifica o número de série do certificado
`--executePrereqs`	executa as verificações de pré-requisito e relata os resultados
`--resume`	retoma a execução anterior
`--sessionID`	especifica para retomar um ID da sessão específico
`--bounceListeners`	flag para fazer bounce do listener do Grid Infrastructure e do listener de verificação

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli grid removeTCPSCert?

R: O comando dbaascli grid removeTCPSCert é usado para remover certificados TCPS existentes da wallet do Grid Infrastructure em um ambiente Oracle Base Database Cloud@Customer.

P: Qual é o pré-requisito para executar o comando dbaascli grid removeTCPSCert?

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

P: O que a opção –subject especifica no comando dbaascli grid removeTCPSCert?

R: A opção --subject especifica o assunto do certificado a ser removido da wallet do Grid Infrastructure.

P: Qual é a finalidade do flag –userCert?

R: O sinalizador --userCert indica que o certificado a ser removido é um certificado de usuário.

P: Quando devo usar o flag –trustedCert?

A: Usar o flag --trustedCert ao remover um certificado confiável da wallet do Grid Infrastructure.

P: O que o flag –requestedCert faz?

R: O sinalizador --requestedCert indica que o certificado que está sendo removido é um certificado solicitado.

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

A: A opção --serialNumber especifica o número de série do certificado a ser removido. É útil para identificar exclusivamente um certificado quando há vários certificados com o mesmo assunto.

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

R: A opção --executePrereqs executa verificações de pré-requisitos antes de remover o certificado e reporta os resultados, garantindo que o ambiente esteja devidamente preparado para a operação.

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

R: A opção --resume retomará a operação de remoção se ela tiver sido interrompida anteriormente.

P: Como eu especifico um ID de sessão ao retomar uma operação interrompida?

R: Use a opção --sessionID para especificar o ID da sessão da operação interrompida que você deseja retomar.

P: O que o flag –bounceListeners faz?

R: O flag --bounceListeners é usado para reiniciar o listener do Grid Infrastructure e o listener de varredura após a remoção do certificado TCPS.

Q: Posso remover um certificado TCPS sem saltar os ouvintes?

R: Sim, o flag --bounceListeners é opcional. Se você não especificar, os listeners não serão devolvidos automaticamente.

Q: Como posso eu assegurar-se de que a operação correrá com segurança?

R: Você pode usar a opção --executePrereqs para executar verificações de pré-requisitos antes de executar o comando, garantindo que tudo esteja em ordem antes do processo de remoção.

Q: O que devo fazer se eu precisar remover um certificado de usuário específico por número de série?

R: Use a opção --subject para especificar o assunto do certificado, o flag --userCert para indicar que ele é um certificado de usuário e a opção --serialNumber para especificar o número de série do certificado.

Q: Posso remover vários certificados de uma só vez?

A: Não, o comando é projetado para remover um único certificado de cada vez com base no assunto fornecido e outros parâmetros.

P: O que acontece se o processo de remoção do certificado for interrompido?

R: Você pode retomar a operação usando a opção --resume junto com o --sessionID do processo interrompido.

P: Preciso executar o comando como usuário-raiz?

R: Sim, o comando dbaascli grid removeTCPSCert deve ser executado como o usuário root para ter os privilégios necessários para remover certificados TCPS.

Q: Como posso identificar o certificado que eu quero remover?

R: Você pode identificar o certificado pelo assunto e, opcionalmente, pelo número de série para garantir que você esteja direcionando o certificado correto para remoção.

P: O que é um comando de exemplo para remover um certificado confiável?

A: Veja a seguir um exemplo:

dbaascli grid removeTCPSCert --subject "CN=example_cert" --trustedCert

dbaascli grid rotateTCPSCert

Para alternar certificados TCPS, use o comando dbaascli grid rotateTCPSCert.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe:

dbaascli grid rotateTCPSCert
[--pkcs12WalletFilePath]
[--caCertChain]
[--precheckOnly]
[--serverCert]
[--privateKey]
[--certType]
[--privateKeyPasswordProtected]

Parâmetros:

Parâmetro	Descrição
`--pkcs12WalletFilePath`	especifica o caminho absoluto do arquivo do certificado, que está no formato `pkcs12` da wallet
`--caCertChain`	lista concatenada de certificados, contendo certificações de CA intermediárias e certificações de CA raiz
`--precheckOnly`	especifica `yes` para executar somente as pré-verificações desta operação. Valores válidos: `yes` ou `no`.
`--serverCert`	especifica o caminho do certificado PEM a ser usado ou rotacionado para configuração TCPS.
`--privateKey`	especifica o caminho do arquivo de chave privada do certificado.
`--certType`	tipo do certificado a ser adicionado à wallet do Grid Infrastructure. Os valores aceitos são: `SELF_SIGNED_CERT`, `CA_SIGNED_CERT` ou `PKCS12_CERT`. Padrão: `SELF_SIGNED_CERT`
`--privateKeyPasswordProtected`	especifica se a chave privada é protegida por senha ou não. Valores válidos: `true` ou `false`. Padrão: `true`.

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli grid rotateTCPSCert?

R: O comando dbaascli grid rotateTCPSCert é usado para rotacionar certificados TCPS (Transport Layer Security Protocol) na wallet do Grid Infrastructure nos ambientes Oracle Base Database Cloud@Customer.

P: Qual é o pré-requisito para executar o comando dbaascli grid rotateTCPSCert?

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

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

R: A opção --pkcs12WalletFilePath especifica o caminho absoluto para o arquivo de certificado no formato da wallet PKCS12 para a configuração do TCPS.

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

R: A opção --caCertChain especifica uma lista concatenada de certificados, incluindo certificados de CA intermediária e CA raiz, para a configuração TCPS.

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

R: A opção --precheckOnly permite executar pré-verificações sem fazer alterações reais. Os valores válidos são "yes" para executar apenas as pré-verificações e "no" para prosseguir com a rotação.

P: Como a opção –serverCert é usada?

R: A opção --serverCert especifica o caminho para o certificado do servidor PEM (Privacy Enhanced Mail) que é usado ou alternado para a configuração TCPS.

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

R: A opção --privateKey especifica o caminho para o arquivo de chave privada correspondente ao certificado do servidor usado para a rotação TCPS.

P: Quais são os valores válidos para a opção –certType?

A: A opção --certType aceita os seguintes valores para especificar o tipo de certificado a ser adicionado à wallet do Grid Infrastructure:

SELF_SIGNED_CERT (padrão)
CA_SIGNED_CERT
PKCS12_CERT

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

A: A opção --privateKeyPasswordProtected indica se a chave privada é protegida por senha. Os valores válidos são true (padrão) e false

P: Posso executar o comando dbaascli grid rotateTCPSCert sem rotacionar os certificados?

R: Sim, usando a opção --precheckOnly yes, você só pode executar as pré-verificações sem rotacionar os certificados.

P: Qual é um exemplo de comando para rotacionar um certificado usando uma wallet PKCS12?

A: Aqui está um exemplo de comando:

dbaascli grid rotateTCPSCert --pkcs12WalletFilePath /path/to/wallet.p12 --certType PKCS12_CERT

P: Como faço para girar um certificado de servidor com uma cadeia de certificados assinada pela CA?

A: Use as opções --serverCert e --caCertChain, conforme mostrado aqui:

dbaascli grid rotateTCPSCert --serverCert /path/to/serverCert.pem --caCertChain /path/to/caChain.pem

P: O que acontece se eu não especificar –privateKeyPasswordProtected?

R: Se você não especificar a opção --privateKeyPasswordProtected, o comando assumirá que a chave privada é protegida por senha (padrão: true).

Q: Posso eu girar um certificado autoassinado?

R: Sim, você pode rotacionar um certificado autoassinado usando a opção --certType SELF_SIGNED_CERT padrão ou especificando-o explicitamente.

Q: Como posso girar um certificado sem fornecer uma chave privada?

R: Para determinados tipos de certificado, como PKCS12, talvez você não precise fornecer um arquivo de chave privada separado, pois ele está incluído na wallet. No entanto, se uma chave privada for necessária, ela deverá ser fornecida usando a opção --privateKey.

P: E se eu quiser girar um certificado em segundo plano?

R: O comando dbaascli grid rotateTCPSCert não fornece uma opção explícita para execução em segundo plano. Você pode executar o comando diretamente em uma sessão em segundo plano (por exemplo, usando nohup ou ferramentas semelhantes).

P: Qual é o tipo de certificado padrão se não for especificado?

A: O tipo de certificado padrão é SELF_SIGNED_CERT.

Exemplo: dbaascli grid rotateTCPSCert

Para alternar o certificado usando o certificado autoassinado (opção padrão):

dbaascli grid rotateTCPSCert

Para alternar o certificado usando o certificado assinado pela CA:

dbaascli grid rotateTCPSCert --cert_type CA_SIGNED_CERT --server_cert /tmp/certs/server_cert.pem --ca_cert_chain /tmp/certs/ca.pem --private_key /tmp/certs/encrypted_private.key --privateKeyPasswordProtected true

dbaascli grid upgrade

Para fazer upgrade da Oracle Grid Infrastructure de uma versão principal para outra, use o comando dbaascli grid upgrade.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe:

dbaascli grid upgrade --version
[--resume]
[--executePrereqs]
[--containerURL]
[--softwareOnly]
[--targetHome]
[--revert]

Parâmetros:

Parâmetro	Descrição
`--version`	especifica a versão de destino
`--resume`	retoma a execução anterior
`--executePrereqs`	executa pré-requisitos para upgrade do Grid Infrastructure
`--containerUrl`	especifica o URL personalizado para extrair a imagem do Grid Infrastructure
`--softwareOnly`	instala somente o software do Grid Infrastructure
`--targetHome`	especifica o caminho do home do Grid de destino existente
`--revert`	falha na execução das reversões

Perguntas Frequentes:

P: Qual é a finalidade do comando dbaascli grid upgrade?

R: O comando dbaascli grid upgrade é usado para fazer upgrade do Oracle Grid Infrastructure de uma versão principal para outra em uma máquina virtual do Oracle Base Database Cloud@Customer.

P: Qual é o pré-requisito para executar o comando dbaascli grid upgrade?

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

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

A: A opção --version especifica a versão de destino do Oracle Grid Infrastructure para a qual você deseja fazer upgrade.

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

R: A opção --resume retoma um processo de upgrade do Grid Infrastructure interrompido anteriormente ou com falha.

P: Como a opção –executePrereqs é usada?

R: A opção --executePrereqs só executa as verificações de pré-requisito para o upgrade do Grid Infrastructure sem executar o upgrade real.

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

R: A opção --containerURL especifica um URL personalizado para extrair a imagem do software do Grid Infrastructure para o upgrade.

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

R: A opção --softwareOnly instala somente o software Grid Infrastructure sem configurar ou fazer upgrade do ambiente Grid.

P: Quando você usaria a opção –targetHome?

R: A opção --targetHome especifica o caminho para o home do Grid de destino existente no qual o upgrade será executado.

P: O que acontece se o upgrade falhar?

R: Se o upgrade falhar, você poderá usar a opção --revert para fazer rollback do upgrade para seu estado anterior.

P: Posso executar um upgrade do Grid Infrastructure em estágios?

R: Sim, usando a opção --softwareOnly, você pode primeiro instalar o software e depois concluir a atualização completa, permitindo atualizações preparadas.

P: Como eu uso o comando dbaascli grid upgrade para fazer upgrade somente do software?

R: Use a seguinte sintaxe para fazer upgrade somente do software:

dbaascli grid upgrade --version <target_version> --softwareOnly

P: Posso verificar se há pré-requisitos de upgrade sem executar o upgrade?

R: Sim, você só pode executar as verificações de pré-requisitos usando:

dbaascli grid upgrade --version <target_version> --executePrereqs

P: Como posso fazer upgrade do Grid Infrastructure usando um URL de contêiner personalizado?

R: Você pode especificar o URL para extrair a imagem do Grid Infrastructure da seguinte forma:

dbaascli grid upgrade --version <target_version> --containerURL <custom_url>

P: Como posso retomar um processo de atualização interrompido anteriormente?

R: Para retomar um upgrade interrompido ou com falha anteriormente, use:

dbaascli grid upgrade --version <target_version> --resume

P: O que a opção –revert faz no comando dbaascli grid upgrade?

R: A opção --revert faz rollback de um upgrade do Grid Infrastructure com falha ou interrompido para seu estado original.

P: Posso executar um upgrade completo sem configurar o Grid Infrastructure imediatamente?

R: Sim, você pode primeiro instalar somente o software usando a opção --softwareOnly e depois configurá-lo posteriormente.

P: O que devo fazer se um upgrade falhar e eu quiser desfazer as alterações?

R: Use a opção --revert para fazer rollback do upgrade com falha:

dbaascli grid upgrade --version <target_version> --revert

Exemplo: dbaascli grid upgrade

dbaascli grid upgrade --version 19.11.0.0.0 --executePrereqs
DBAAS CLI version MAIN
Executing command grid upgrade --version 19.11.0.0.0 --executePrereqs

dbaascli grid patch

Para aplicar patch no Oracle Grid Infrastructure para a versão secundária especificada, use o comando dbaascli grid patch.

Pré-requisitos:

Execute o comando como usuário root.

Sintaxe:

dbaascli grid patch
 {
            --targetVersion <value>
            | --targetHome <value>
        }
        [--executePrereqs] [--nodeList <value>] [--continueWithDbDowntime] [--drainTimeoutInSeconds <value>] [--containerURL <value>] [--imageFile <value>] [--patchInParallel]
        {
            [--resume [--sessionID <value>]]
            | [--rollback [--sessionID <value>]]
        }
        [--waitForCompletion <value>]

Parâmetros:

Parâmetro	Descrição
`--targetVersion`	especifica a versão de destino do Oracle home especificada como cinco segmentos numéricos separados por períodos (por exemplo 19.12.0.0)
`--targetHome`	especifica o caminho totalmente qualificado do home do Grid Infrastructure para a aplicação de patches fora do local
`--containerURL`	especifica o URL personalizado para extrair a imagem do Grid Infrastructure
`--executePrereqs`	opção para executar pré-requisitos
`--nodeList`	especifica uma lista de nós delimitada por vírgulas se a aplicação de patch tiver que ser executada em um subconjunto de nós
`--patchInParallel`	especifica a execução da aplicação de patch a nós remotos em paralelo
`--rollback`	especifica para fazer rollback do Oracle home submetido a patch
`--resume`	retoma a execução anterior
`--sessionID`	especifica para retomar um ID da sessão específico
`--continueWithDbDowntime`	continua a aplicação de patches com indisponibilidade do banco de dados. Essa opção pode ser usada em ambientes nos quais só há uma instância ativa e a operação de aplicação de patch pode continuar mesmo com um tempo de inatividade.
`--drainTimeoutInSeconds`	especifica o tempo (em segundos) para concluir a drenagem do recurso durante a interrupção do banco de dados
`--createImage`	cria uma imagem a partir de uma cópia do home ativo do Grid, com patch para a versão de destino especificada
`--createImageDir`	especifica um caminho totalmente qualificado do diretório em que a imagem será criada
`--imageFile`	especifica um caminho totalmente qualificado da imagem a ser usada
`--patchInParallel`	executa a aplicação de patches dos nós remotos em paralelo
`--waitForCompletion`	especifica `false` para executar a operação em segundo plano. Valores válidos: `true` ou `false`

Perguntas Frequentes:

P: O que o comando dbaascli grid patch faz?

R: O comando dbaascli grid patch é usado para aplicar patch ao Oracle Grid Infrastructure em uma versão secundária especificada.

P: Preciso de permissões especiais para executar o comando dbaascli grid patch?

R: Sim, você precisa executar o comando dbaascli grid patch como o usuário root.

P: Posso especificar uma versão de destino ao aplicar patch ao Oracle Grid Infrastructure?

R: Sim, você pode especificar a versão de destino usando a opção --targetVersion.

P: Como eu especifico a versão de destino para o patch?

A: Use a opção --targetVersion seguida pelo número da versão no formato 19.12.0.0.0.

P: O que a opção –containerURL faz no comando dbaascli grid patch?

R: A opção --containerURL permite especificar um URL personalizado para extrair a imagem do Grid Infrastructure.

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

R: A opção --executePrereqs é usada para executar verificações de pré-requisitos antes de aplicar o patch.

P: Como posso aplicar patch a um subconjunto de nós usando o comando dbaascli grid patch?

R: Use a opção --nodeList seguida de uma lista delimitada por vírgulas de nomes de nós para aplicar patch somente a um subconjunto de nós.

P: O que acontece se eu usar a opção –rollback?

R: A opção --rollback fará rollback do Oracle home com patch para seu estado anterior.

P: Posso retomar uma sessão de aplicação de patches anterior?

R: Sim, você pode usar a opção --resume para retomar a última sessão de aplicação de patch. Se você tiver um ID de sessão específico, poderá especificá-lo com a opção --sessionID.

P: Para que é usada a opção –continueWithDbDowntime?

R: A opção --continueWithDbDowntime permite que você continue aplicando patches mesmo que haja tempo de inatividade do banco de dados, geralmente usado em ambientes onde há apenas uma instância ativa.

P: Como eu crio uma imagem de um Grid home com patch?

A: Use a opção --createImage para criar uma imagem. Você pode especificar o diretório onde a imagem deve ser criada usando a opção --createImageDir.

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

R: A opção --imageFile permite que você especifique o caminho totalmente qualificado do arquivo de imagem a ser usado para aplicação de patch.

P: Como posso executar o comando dbaascli grid patch no segundo plano?

R: Você pode usar a opção --waitForCompletion definida como false para executar a operação em segundo plano.

P: Posso usar um URL personalizado para extrair a imagem do patch?

R: Sim, você pode usar a opção --containerURL para especificar um URL personalizado para extrair a imagem do Grid Infrastructure.

P: Como eu especifico quais nós aplicar patch se não quiser aplicar patch em todos eles?

R: Você pode especificar os nós aos quais deseja aplicar patch usando a opção --nodeList com uma lista separada por vírgulas de nomes de nós.

P: O que devo fazer se eu precisar reverter um patch?

R: Use a opção --rollback no comando dbaascli grid patch para fazer rollback do patch.

P: Como lidar com uma operação de aplicação de patches se meu ambiente tiver apenas uma instância ativa e eu precisar continuar com o tempo de inatividade?

R: Use a opção --continueWithDbDowntime para continuar a aplicação de patches mesmo com tempo de inatividade do banco de dados.

P: Posso criar uma imagem do Grid home com patch?

R: Sim, você pode usar a opção --createImage para criar uma imagem do home do Grid com patch. Se necessário, especifique o diretório em que a imagem deve ser salva usando --createImageDir.

P: O que devo fazer se quiser retomar uma sessão de aplicação de patches após uma interrupção?

R: Use a opção --resume para retomar a sessão de aplicação de patch. Se você souber o ID da sessão, poderá especificá-lo com --sessionID.

P: E se o processo de correção falhar no meio do caminho?

R: Se o processo de aplicação de patch falhar, você poderá usar a opção --resume para reiniciar o processo. Você também pode usar a opção --rollback para reverter para o estado anterior.

P: Como posso garantir que todos os pré-requisitos sejam atendidos antes da aplicação de patches?

R: Use a opção --executePrereqs para executar todas as verificações de pré-requisitos antes de aplicar o patch.

P: Posso fazer patches em segundo plano para evitar prender o terminal?

R: Sim, você pode usar a opção --waitForCompletion false para executar o processo de aplicação de patch em segundo plano.

P: Como posso criar uma imagem inicial do Grid após a aplicação de patches?

R: Use a opção --createImage para criar uma nova imagem do home do Grid com patch. Especifique o diretório usando --createImageDir, se necessário.

P: Como eu uso um arquivo de imagem existente para aplicação de patches?

R: Você pode usar a opção --imageFile para especificar o caminho totalmente qualificado para o arquivo de imagem que deseja usar para aplicação de patch.

P: O que devo fazer se quiser evitar o tempo de inatividade do banco de dados durante a aplicação de patches?

R: Certifique-se de que seu ambiente tenha mais de uma instância ativa em execução. Você pode evitar o uso da opção --continueWithDbDowntime, que se destina a ambientes com apenas uma instância ativa.

P: Como eu sei o progresso de um patch em execução em segundo plano?

R: Se você executar o patch com --waitForCompletion false, poderá verificar o status do job em segundo plano usando comandos do sistema operacional como ps ou verificar os logs localizados no home do Grid.

P: É possível aplicar patch a uma versão principal mais alta usando o patch dbaascli grid?

R: Não, o dbaascli grid patch só permite a aplicação de patches em uma versão secundária da versão principal atual. Para atualizações importantes, você precisará seguir um processo de atualização diferente.

P: Posso ignorar verificações de pré-requisitos específicas durante a aplicação de patches?

R: Não, quando você usar o --executePrereqs, todas as verificações de pré-requisitos serão executadas. No entanto, você pode revisar os resultados das verificações de pré-requisitos e tratar manualmente quaisquer problemas antes de continuar.

Q: O que devo fazer se o processo de patching está preso ou pendurado?

R: Se o processo de aplicação de patch não responder, você poderá interrompê-lo usando comandos do sistema operacional e, em seguida, retomar usando a opção --resume. Se isso não funcionar, tente usar a opção --rollback para reverter o patch.

P: Posso automatizar o processo de aplicação de patches em vários clusters?

R: Sim, usando scripts que incluem o comando dbaascli grid patch com opções apropriadas, você pode automatizar a aplicação de patches em diferentes clusters.

P: Onde posso encontrar logs para o processo de aplicação de patches?

R: Em geral, os logs ficam localizados no diretório de logs do home do Oracle Grid ou no local padrão especificado durante a configuração. Você pode monitorar esses logs para obter detalhes sobre o processo de aplicação de patch.

P: É possível criar um processo de patch silencioso sem interação do usuário?

R: Sim, ao especificar todas as opções necessárias no comando e executá-lo em segundo plano (--waitForCompletion false), você pode criar um processo de aplicação de patches não interativo.

P: Posso verificar se há atualizações de patch disponíveis antes de aplicar um patch?

R: O próprio comando dbaascli grid patch não tem uma opção para listar patches disponíveis. No entanto, você pode usar os métodos padrão da Oracle, como o Suporte Técnico da Oracle, para identificar os patches mais recentes.

P: Posso usar o dbaascli para aplicar patch a vários Oracle Homes?

R: Não, o comando dbaascli grid patch foi projetado para aplicar patch a um home específico do Oracle Grid Infrastructure por vez. Você precisaria executar o comando separadamente para cada home.

P: Existe uma maneira de evitar completamente o tempo de inatividade ao aplicar patches no Grid Infrastructure?

R: Para minimizar o tempo de inatividade, certifique-se de que seu ambiente tenha várias instâncias de banco de dados ativas (configuração RAC) para que a aplicação de patch possa ser feita nó por nó. A opção --continueWithDbDowntime não deve ser usada nesse caso.

P: Como tratar a aplicação de patches para ambientes RAC One Node?

R: Em ambientes RAC One Node, você precisa ter cuidado com a opção --continueWithDbDowntime, pois pode haver apenas uma instância ativa. Revise a documentação da Oracle para obter diretrizes específicas de aplicação de patches para RAC One Node.

P: Posso ver o histórico de sessões de patches anteriores?

R: O utilitário dbaascli não fornece uma maneira direta de exibir o histórico da sessão. No entanto, os logs de sessões de aplicação de patch anteriores podem ser encontrados no diretório de logs do Grid home.

Exemplos:

Exemplo: Aplicação Básica de Patches em Grade

dbaascli grid patch --targetVersion 19.12.0.0.0

Corrige o Oracle Grid Infrastructure para a versão 19.12.0.0.0.

Exemplo: Aplicação de Patch com um URL de Contêiner Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --containerURL https://example.com/custom/url

Aplica patches ao Grid Infrastructure para a versão 19.12.0.0.0, usando um URL de contêiner personalizado para extrair a imagem do Grid Infrastructure.

Exemplo: Aplicação de Patch com Verificações de Pré-requisito

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 após executar as verificações de pré-requisitos.

Exemplo: Aplicação de Patches em um Subconjunto de Nós

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2,node3

Aplica patches ao Grid Infrastructure para a versão 19.12.0.0.0 nos nós especificados (node1, node2 e node3).

Exemplo: Fazendo Rollback do Patch

dbaascli grid patch --rollback

Faz rollback do último patch aplicado no Oracle Grid Infrastructure.

Exemplo: Retomando uma Operação de Patch Anterior

dbaascli grid patch --resume

Retoma a operação de aplicação de patch anterior de onde ela foi interrompida.

Exemplo: Retomando uma Operação de Patch com um ID de Sessão Específico

dbaascli grid patch --resume --sessionID 12345

Retoma a operação de aplicação de patch usando o ID de sessão 12345.

Exemplo: Aplicação de Patch com Tempo de Inatividade do Banco de Dados Permitido

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime

Corrige o Grid Infrastructure para a versão 19.12.0.0.0, permitindo o tempo de inatividade do banco de dados, se necessário.

Exemplo: Criando uma Imagem com Patch

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir

Cria uma imagem do home do Grid com patch (versão 19.12.0.0.0) e a armazena no diretório especificado.

Exemplo: Usando um Arquivo de Imagem Existente

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /path/to/image/file.zip

Aplica patches ao Grid Infrastructure para a versão 19.12.0.0.0 usando um arquivo de imagem existente localizado em /path/to/image/file.zip.

Exemplo: Executando a Operação de Aplicação de Patch no Segundo Plano

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 e executa a operação em segundo plano.

Exemplo: Combinação de Pré-requisitos, URL Personalizado e Subconjunto de Nós

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --containerURL https://example.com/custom/url --nodeList node1,node2

Corrige o Grid Infrastructure para a versão 19.12.0.0.0, executa verificações de pré-requisitos, usa um URL personalizado para a imagem e aplica o patch somente em node1 e node2.

Exemplo: Criando uma Imagem com Patch com um Arquivo de Imagem Existente

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /path/to/dir --imageFile /path/to/existing/image.zip

Cria uma imagem com patch e a armazena no diretório especificado enquanto usa um arquivo de imagem existente para o patch.

Exemplo: Verificando Pré-requisitos sem Aplicação de Patches

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs

Verifica se todos os pré-requisitos foram atendidos para a aplicação de patch na versão 19.12.0.0.0 sem realmente aplicar o patch.

Exemplo: Executando Patch e Ignorando Falhas de Pré-requisito

dbaascli grid patch --targetVersion 19.12.0.0.0 --continueWithDbDowntime --executePrereqs

Executa o patch mesmo se algumas verificações de pré-requisitos falharem. Isso é útil em cenários em que o tempo de inatividade é permitido e determinados pré-requisitos podem ser ignorados.

Exemplo: Verificando Problemas nos Logs de Patch

tail -f /u01/app/grid/logs/grid_patch.log

Monitora o log de patches em tempo real para diagnosticar quaisquer problemas durante o processo de aplicação de patches.

Exemplo: Aplicando o Patch em um Ambiente Paralelo

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node2 --waitForCompletion false

Corrige o Grid Infrastructure em um subconjunto de nós (node1 e node2) e executa o processo em segundo plano.

Exemplo: Usando um Arquivo de Imagem Específico de uma Origem Externa

dbaascli grid patch --targetVersion 19.12.0.0.0 --imageFile /mnt/images/grid_patch_19.12.zip

Aplica patches ao Grid Infrastructure usando um arquivo de imagem pré-download localizado em um dispositivo de armazenamento externo.

Exemplo: Executando Patch com um ID de Sessão Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --resume --sessionID 67890

Retoma uma operação de aplicação de patch que foi interrompida usando o ID de sessão 67890.

Exemplo: Programando Aplicação de Patches para Execução Posterior

echo "dbaascli grid patch --targetVersion 19.12.0.0.0" | at 02:00

Programa o comando de aplicação de patch a ser executado às 2:00 AM usando o comando at no Linux.

Exemplo: Especificando Timeout para Conclusão

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion true --continueWithDbDowntime --timeout 7200

Corrige o Grid Infrastructure enquanto permite tempo de inatividade, mas aguarda até 7200 segundos (2 horas) para conclusão antes do timeout.

Exemplo: Criando uma Imagem Personalizada para Outro Ambiente

dbaascli grid patch --targetVersion 19.12.0.0.0 --createImage --createImageDir /backups/images/grid_patch

Cria uma imagem personalizada do Grid Infrastructure com patch a ser armazenada no diretório /backups/images/grid_patch para uso em outros ambientes.

Exemplo: Recuperação de Patch Após Interrupção

dbaascli grid patch --resume --continueWithDbDowntime

Recupera e retoma o processo de aplicação de patches se ele foi interrompido, com tempo de inatividade do banco de dados permitido.

Exemplo: Combinando a Verificação de Pré-requisitos com a Execução em Segundo Plano

dbaascli grid patch --targetVersion 19.12.0.0.0 --executePrereqs --waitForCompletion false

Verifica os pré-requisitos e executa o patch em segundo plano.

Exemplo: Ignorando a Criação de Imagem para Aplicação de Patches Mais Rápida

dbaascli grid patch --targetVersion 19.12.0.0.0 --patchInParallel --continueWithDbDowntime --waitForCompletion false

Corrige o Grid Infrastructure para a versão 19.12.0.0.0 em paralelo entre nós, com tempo de inatividade do banco de dados permitido e sem criar uma imagem para acelerar o processo.

Exemplo: Monitorando o Andamento do Patch por Meio de Logs

tail -f /u01/app/grid/logs/grid_patch_progress.log

Monitora o arquivo de log para o progresso da aplicação de patches em tempo real, fornecendo insights sobre cada etapa do processo de aplicação de patches.

Exemplo: Aplicação de Patches com Timeout de Drenagem Personalizado

dbaascli grid patch --targetVersion 19.12.0.0.0 --drainTimeoutInSeconds 3600 --continueWithDbDowntime

Corrige o Grid Infrastructure e define um timeout personalizado de 1 hora (3600 segundos) para permitir a drenagem normal de recursos durante o período de indisponibilidade do banco de dados.

Exemplo: Aplicando um Patch a Nós Específicos com Verificações de Pré-requisito

dbaascli grid patch --targetVersion 19.12.0.0.0 --nodeList node1,node4 --executePrereqs

Corrige somente os nós node1 e node4 para a versão 19.12.0.0.0 e executa as verificações de pré-requisito com antecedência.

Exemplo: Aplicação de Patch sem Aguardar Conclusão

dbaascli grid patch --targetVersion 19.12.0.0.0 --waitForCompletion false

Começa a aplicar patch no Grid Infrastructure para a versão 19.12.0.0.0 em segundo plano, permitindo que outras tarefas sejam executadas sem aguardar a conclusão do processo.

Exemplo: Reaplicando um Patch com Falha Após um Problema de Timeout de Drenagem

dbaascli grid patch --resume --drainTimeoutInSeconds 7200

Retoma a sessão de aplicação de patch anterior e estende o tempo limite de drenagem do recurso para 2 horas (7200 segundos) caso haja falha devido a tempo insuficiente na tentativa anterior.

Exemplo: Exibindo Logs de Patch em Tempo Real com um ID de Sessão Específico

tail -f /u01/app/grid/logs/grid_patch_12345.log

Monitora o arquivo de log da sessão de aplicação de patch com o ID de sessão 12345 em tempo real.

Exemplo: Aplicando Patch a um Novo Home de Destino

dbaascli grid patch --targetHome /u01/app/grid_home_19c --executePrereqs

Executa um patch fora do local para um novo home do Oracle Grid localizado em /u01/app/grid_home_19c, com verificações de pré-requisitos.

Exemplo: Interrompendo um Job de Patch em Segundo Plano

ps -ef | grep dbaascli | grep patch | awk '{print $2}' | xargs kill -9

Interrompe um job de patch em segundo plano localizando e interrompendo o PID (ID do processo associado).

Exemplo: Verificando a conclusão do patch sem logs

dbaascli grid status --targetVersion 19.12.0.0.0

Verifica se o patch para a versão 19.12.0.0.0 foi aplicado com sucesso, verificando o status atual da versão do Grid Infrastructure.