Solucionando Problemas de Anexos de Volume de Altíssimo Desempenho
Este tópico abrange as etapas de diagnóstico e solução de problemas que você pode executar, bem como os pré-requisitos para verificar volumes configurados para o nível Altíssimo Desempenho no qual o volume não é anexado ou o anexo de volume não está ativado para multipath.
Diagnosticando e Solucionando Problemas de Falhas de Anexo de Volume
O plug-in de Gerenciamento de Volume em Blocos é necessário para volumes configurados para Altíssimo Desempenho, anexados usando o tipo de anexo iSCSI. Se o volume não for anexado à instância, o problema provavelmente terá sido causado por uma configuração incorreta do plug-in Gerenciamento de Volume em Blocos. Consulte as sugestões de diagnóstico e solução de problemas desta seção para ver esses problemas.
Se você não tiver configurado permissões corretamente para o plug-in de Gerenciamento de Volume em Blocos, o volume falhará ao ser anexado à instância.
Detalhes
O volume não será mostrado conforme anexado na Console e você verá uma mensagem de erro NotAuthorizedOrNotFound no log do plug-in Gerenciamento de Volume em Blocos.
O log do plug-in de Gerenciamento de Volume em Blocos está localizado em:
"/var/log/oracle-cloud-agent/plugins/oci-blockautoconfig/oci-blockautoconfig.logVeja a seguir um exemplo de entrada de log de erros para este problema:
2021/08/13 09:14:25.864932 compute_client_command.go:255: Updating volume attachment to the state LOGIN_SUCCEEDED ...
2021/08/13 09:14:26.155473 compute_client_command.go:260: Service error:NotAuthorizedOrNotFound.
volume attachment ocid1.volumeattachment.oc1.iad.<volume-attachment_ID> not found.
http status code: 404. Opc request id: <request_ID>Causa
O plug-in de Gerenciamento de Volume em Blocos não tem permissões suficientes para enviar a notificação de status de log-in iSCSI ao serviço.
Resolução
Para configurar permissões para o plug-in de Gerenciamento de Volume em Blocos:
-
Criar Grupo Dinâmico: Crie um grupo dinâmico com as regras de correspondência na seguinte amostra de código para incluir todas as instâncias nos compartimentos especificados:
ANY {instance.compartment.id = 'ocid1.tenancy.oc1..<tenancy_ID>', instance.compartment.id = 'ocid1.compartment.oc1..<compartment_OCID>' -
Configurar Política para Grupo Dinâmico: Configure uma política que conceda permissões ao grupo dinâmico criado na etapa anterior para permitir que o agente da instância acesso para chamar o serviço Block Volume para recuperar a configuração do anexo:
Allow dynamic-group InstantAgent to use instances in tenancy Allow dynamic-group InstantAgent to use volume-attachments in tenancy
Recursos
A instância de computação deve ter um endereço IP público ou um gateway de serviço para poder estabelecer conexão com serviços Oracle, caso contrário, o volume não será anexado.
Detalhes
O volume não será mostrado conforme anexado na Console e você verá uma mensagem de erro user agent can not be blank no log do plug-in de Gerenciamento de Volume em Blocos.
O log do plug-in de Gerenciamento de Volume em Blocos está localizado em:
"/var/log/oracle-cloud-agent/plugins/oci-blockautoconfig/oci-blockautoconfig.logVeja a seguir um exemplo de entrada de log de erros para este problema:
2021/10/15 22:16:07.881953 compute_client_command.go:255: Updating volume attachment to the state LOGIN_SUCCEEDED ...
2021/10/15 22:16:07.882185 compute_client_command.go:260: user agent can not be blank
2021/10/15 22:16:07.882204 iscsi_commands_helper.go:302: user agent can not be blank
2021/10/15 22:16:07.882212 iscsi_commands_helper.go:310: user agent can not be blankCausa
O plug-in de Gerenciamento de Volume em Blocos não pode enviar a notificação de status de log-in iSCSI para o serviço em decorrência da configuração de rede.
Resolução
Se a instância não tiver um endereço IP público, configure um gateway de serviço na rede virtual na nuvem (VCN). O gateway de serviço permite que a sua instância acesse de forma privada os serviços Oracle sem expor os dados à internet pública. Aqui estão observações especiais para configurar o gateway de serviço para o plug-in de Gerenciamento de Volume em Blocos:
- Ao criar o gateway de serviço, ative o label de serviço chamado Todos os Serviços <region> no Oracle Services Network.
- Ao configurar o roteamento da sub-rede que contém a instância, configure uma regra de roteamento com o Tipo de Destino definido como Gateway de Serviço e o Serviço de Destino definido como Todos os Serviços <region> no Oracle Services Network.
Para ver instruções, consulte Acesso a Serviços Oracle: Gateway de Serviço.
Recursos
O Anexo de Volume não está Ativado para Multipath
Quando você anexa um volume configurado para o nível Altíssimo Desempenho, para obter o desempenho ideal, o anexo de volume deve ser ativado para multipath. O serviço Block Volume tenta ativar o anexo para multipath quando o volume está sendo anexado. Se nem todos os pré-requisitos tiverem sido tratados, o anexo de volume não será ativado para multipath.
Para verificar se um anexo de volume está ativado para multipath, na Console da página Detalhes do Volume:
- Abra o menu de navegação e selecione Armazenamento. Em Armazenamento em Blocos, selecione Volumes em Blocos.
-
Clique no volume em blocos cujo anexo de volume deseja verificar.
- Clique em Instâncias Anexadas na seção Recursos.
-
Verifique o valor exibido na coluna Multipath.
-
Sim: O volume é configurado para o nível Altíssimo Desempenho e o anexo de volume é ativado para multipath. Nenhuma outra ação é necessária.
- Não: O volume não está configurado para o nível Altíssimo Desempenho; o volume não precisa ser ativado para multipath. Nenhuma outra ação é necessária.
- Não com um ícone de advertência: O volume é configurado para o nível Altíssimo Desempenho, mas o anexo de volume não é ativado para multipath. Para obter o desempenho ideal, certifique-se de que o volume esteja anexado a uma forma de instância suportada e que os pré-requisitos necessários estejam configurados.
-
Se o volume estiver configurado para o nível Altíssimo Desempenho, mas não estiver configurado para multipath, conforme necessário, a coluna Multipath conterá a palavra Não com um triângulo de advertência, conforme mostrado para a primeira linha na seguinte captura de tela:
Para obter procedimentos adicionais para verificar se um volume está ativado por vários caminhos, incluindo o uso da CLI ou API, consulte Verificando Se um Anexo de Volume é Ativado por Vários Caminhos.
Se seu volume não estiver configurado para multipath, para diagnosticar e solucionar o problema, verifique as informações abordadas nesta seção e resolva os problemas apresentados.
Você deve anexar um volume configurado para o nível Altíssimo Desempenho a uma instância com base em uma forma suportada, configurada para pelo menos 16 núcleos.
Configurações Suportadas
Todas as formas bare metal atuais suportam anexos iSCSI ativados para multipath. Consulte para obter mais informações sobre Formas Bare Metal para obter as características de desempenho de volumes em blocos anexados a instâncias bare metal.
As formas de VM atuais configuradas para 16 núcleos ou mais suportam anexos ativados para multipath. Consulte Formas de VM para Volumes Anexados iSCSI e Paravirtualizados para obter as características de desempenho dos volumes anexados a VMs.
Resolução
Se o volume não estiver anexado a uma instância com uma configuração de forma suportada, desanexe-o e anexe-o a uma instância com uma configuração de forma suportada.
Você também pode editar a instância existente para que ela tenha a configuração de forma correta, mas certifique-se de desanexar e reanexar o volume após editar a instância.
Se a instância tiver menos de 8 OCPUs, você poderá ver um problema, em que após editar a instância para oferecer suporte a anexos ativados para multipath, o anexo de volume ainda não será ativado para multipath, mesmo depois de desconectar e reconectar o volume. Nesse cenário, você precisa recriar a instância de uma forma suportada e, em seguida, anexar o volume à nova instância. Para obter mais informações, consulte Anexo de volume paravirtualizado não ativado para Multipath depois que a instância é redimensionada.
Recursos
Você deve anexar um volume configurado para o nível Altíssimo Desempenho a uma instância que execute uma imagem que suporte anexos multipath. Isso inclui imagens personalizadas.
Imagens Suportadas para Anexos iSCI
Somente imagens de plataforma que executam imagens personalizadas ou do Oracle Linux com base em uma imagem do Oracle Linux suportam anexos multipath.
Use uma das imagens mais recentes do Oracle Linux na plataforma, com uma versão do UEK (Unbreakable Enterprise Kernel) igual ou superior à versão UEK6U1.
Para imagens personalizadas, a versão do UEK (Unbreakable Enterprise Kernel) também deve ser UEK6U1 ou superior. O UEK versão UEK6U1 está associado à versão principal do kernel 5.4.17-2036, lançada em novembro de 2020. Você também precisa atualizar a propriedade Storage.Iscsi.MultipathDeviceSupported da imagem personalizada para true e iniciar a instância novamente. Para obter mais informações, consulte Configurando Recursos de Imagem para Imagens Personalizadas
Imagens Suportadas para Anexos Paravirtualizados
Para anexos ativados para multipath, a instância anexada deve estar executando uma das seguintes imagens ou uma imagem personalizada baseada em uma destas imagens:
- Oracle Linux
- Ubuntu
- CentOS
- Windows
Não há suporte para anexos ativados para multipath em instâncias do Oracle Autonomous Linux.
Use uma das imagens mais recentes do Oracle Linux na plataforma, com uma versão do UEK (Unbreakable Enterprise Kernel) igual ou superior à versão UEK6U1.
Recursos
Se você tiver atualizado a configuração da forma ou a imagem de uma instância para uma que suporte anexos multipath, será necessário desanexar o volume da instância e depois anexá-lo novamente à instância.
Recursos
Para anexos iSCSI, se você tiver executado todas as etapas descritas neste tópico e ainda estiver enfrentando problemas com o anexo de volume, use as etapas descritas na Etapa 4: Gerar um Arquivo de Diagnóstico para o Oracle Cloud Agent para gerar um arquivo de diagnóstico e entrar em contato com o Suporte Técnico da Oracle. Esta etapa não se aplica a anexos paravirtualizados.
Recursos
Em determinados cenários, um anexo de volume é mostrado como ativado para vários caminhos na Console; no entanto, o anexo não é realmente ativado para vários caminhos e o volume não atinge o desempenho esperado para o nível Ultra High Performance. Esse problema pode ocorrer quando você usa as ferramentas oci-utils e oci-iscsi-config ao mesmo tempo para configurar um volume.
Use um dos métodos a seguir para verificar se você está encontrando esse problema.
multipath para confirmar se um anexo de volume está, na verdade, ativado para multipath em uma instância do Linux. Faça log-in na instância e execute o comando multipath com a tag ll, da seguinte forma:# multipath -ll/var/lib/iscsi/nodes/{IQN} para node.startup, da seguinte forma:#cd /var/lib/iscsi/nodes/{IQN}
#grep -Hrn 'node.startup' node.startup=automatic, é porque o anexo de volume não está ativado para multipath. Todos eles devem mostrar node.startup=manual.Resolução
/etc/fstab. Atualize o arquivo /etc/fstab para que o serviço systemd aguarde até que o serviço multipathd esteja em execução antes de montar o sistema de arquivos. Para fazer isso, adicione x-systemd.requires=multipathd.service para o volume. Por exemplo:UUID={$AFFECTED_VOLUME_UUID} /test ext4 defaults,_netdev,nofail,x-systemd.requires=multipathd.service 0 2 Reinicialize a instância após atualizar o arquivo /etc/fstab.
Para obter mais informações sobre o arquivo /etc/fstab, consulte Opções fstab Tradicionais e Opções fstab para Volumes em Blocos Usando Caminhos de Dispositivos Consistentes.