Como usar a iSCSI para montar um LUN iSCSI do FSx para ONTAP em uma instância do Linux do EC2?

Resolução

Observação: a resolução a seguir é voltada a instâncias do Amazon EC2 que executam o Amazon Linux 2023 (AL2023), Amazon Linux 2 (AL2), Red Hat Enterprise Linux (RHEL) 8 e CentOS 8.

Pré-requisitos:

• A instância do EC2 permite tráfego de saída na porta TCP 3260.
• O sistema de arquivos NetApp ONTAP permite tráfego de entrada na porta TCP 3260.
• Configure os sistemas e instâncias de arquivos iSCSI necessários.
  Observação: os requisitos para instâncias AL2 são os mesmos para as instâncias AL2023.

Usar iSCSI para montar o sistema de arquivos na instância

Conclua as etapas a seguir:

1. Para instalar os pacotes necessários, execute o seguinte comando:

   sudo yum install -y iscsi-initiator-utils device-mapper-multipath

2. Para configurar o multipath do sistema de arquivos, execute os seguintes comandos:

   sudo mpathconf --enable --with_multipathd y
   sudo systemctl start multipathd
   sudo systemctl enable multipathd

3. Para recuperar os endereços das interfaces de armazenamento em bloco da máquina virtual de armazenamento (SVM), use a interface de linha de comandos (CLI) ONTAP. Execute o seguinte comando no sistema de arquivos FSx ONTAP:

   network interface show -vserver svm_name

   Observação: substitua svm_name pelo nome da SVM.
   Exemplo de saída:

               Logical               Status         Network            Current                    Current Is
   Vserver     Interface             Admin/Oper     Address/Mask       Node                       Port    Home
   ----------- ----------            ----------     ------------------ -------------              ------- ----
   svm_name
               iscsi_1               up/up          iscsi_1_IP/X       FSxId0123456789abcdef8-01  e0e     true
               iscsi_2               up/up          iscsi_2_IP/X       FSxId0123456789abcdef8-02  e0e     true
   2 entries were displayed.

4. Para descobrir destinos de iSCSI, execute o seguinte comando na instância do EC2 para encontrar o iniciador de destino:

   sudo iscsiadm --mode discovery --op update --type sendtargets --portal iscsi_1_IP

   Observação: substitua iscsi_1_IP pelo endereço IP iscsi_1 que você recebeu do comando anterior.
   Exemplo de saída:

   iscsi_1:3260,1029 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3
   iscsi_2:3260,1028 iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3

   No exemplo de saída anterior, o iniciador de destino é iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3.

5. (Opcional) Para estabelecer 8 sessões em cada iniciador em cada nó ONTAP em cada zona de disponibilidade, execute o seguinte comando:

   sudo iscsiadm --mode node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 --op update -n node.session.nr_sessions -v 8

   Observação: substitua iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 pelo iniciador de destino.

6. Para fazer login no destino de iSCSI, execute o seguinte comando:

   sudo iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -l

   Observação: substitua iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 pelo iniciador de destino.

7. Para encontrar o dispositivo multipath, execute o seguinte comando:

   sudo multipath -ll

   Exemplo de saída:

   3600a09806c5742314e5d52766e79614f dm-xyz NETAPP ,LUN C-Mode
   size=10G features='4 queue_if_no_path pg_init_retries 50 retain_attached_hw_handle' hwhandler='0' wp=rw
   |-+- policy='service-time 0' prio=50 status=active |
   |- 0:0:0:1 sda 8:0 active ready running |
   |- 1:0:0:1 sdc 8:32 active ready running |
   |- 3:0:0:1 sdg 8:96 active ready running | `
   - 4:0:0:1 sdh 8:112 active ready running `
   -+- policy='service-time 0' prio=10 status=enabled
   |- 2:0:0:1 sdb 8:16 active ready running
   |- 7:0:0:1 sdf 8:80 active ready running
   |- 6:0:0:1 sde 8:64 active ready running
   `- 5:0:0:1 sdd 8:48 active ready running

   No exemplo de saída anterior, o link simbólico é 3600a09806c5742314e5d52766e79614f. Você encontra o link simbólico no caminho /dev/mapper/wwid, em que wwid é o identificador exclusivo do LUN em todos os dispositivos.

8. Para criar um sistema de arquivos, execute o seguinte comando:

   sudo mkfs.xfs /dev/mapper/wwid

   Observação: substitua wwid pelo identificador exclusivo do LUN.

9. Para criar um ponto de montagem e montá-lo, execute os seguintes comandos:

   sudo mkdir /mnt/fsx-iscsi
   sudo mount /dev/mapper/wwid /mnt/fsx-iscsi

10. (Opcional) Para configurar a montagem automática durante a inicialização, execute os seguintes comandos para ativar o serviço de iSCSI:

sudo systemctl enable iscsid
sudo systemctl enable iscsi

Em seguida, adicione a seguinte linha ao arquivo /etc/fstab:

/dev/mapper/wwid /mnt/fsx-iscsi xfs _netdev,x-systemd.automount,x-systemd.requires=network-online.target 0 0

Observação: substitua wwid pelo identificador exclusivo do LUN e /mnt/fsx-iscsi pelo caminho do arquivo. Crie um arquivo de serviço systemd para login de iSCSI com o caminho do arquivo /etc/systemd/system/.
Arquivo de exemplo:

[Unit]
Description=iSCSI connection to FSx
After=network.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -p iscsi_1_IP -l
ExecStop=/sbin/iscsiadm -m node -T iqn.1992-08.com.netapp:sn.1234567890abcdef:vs.3 -p iscsi_1_IP -u

[Install]
WantedBy=multi-user.target

Observação: substitua iscsi_1_IP pelo seu endereço IP iscsi_1 e region pela sua região da AWS. Para ativar e iniciar o serviço, execute os seguintes comandos:

sudo systemctl enable iscsi-fsx.service
sudo systemctl start iscsi-fsx.service
sudo systemctl status iscsi-fsx.service

Solucionar problemas de montagem de ISCSI

Importante: é uma prática recomendada criar uma conta da NetApp. Você deve ter uma conta da NetApp para acessar a base de conhecimento da NetApp.

Solucionar problemas do servidor Linux do EC2

Se tiver problemas ao montar seu sistema de arquivos, execute as seguintes ações de solução de problemas:

• Para verificar a conectividade na porta obrigatória, execute o seguinte comando:

  telnet iscsi_1_IP 3260

  Observação: substitua iscsi_1_IP pelo seu endereço IP iscsi_1.

• Para verificar se a descoberta de iSCSI funciona conforme o esperado, execute o seguinte comando:

  sudo iscsiadm -m discovery --op update -t sendtargets -p iscsi_1_IP

  Observação: substitua iscsi_1_IP pelo seu endereço IP iscsi_1.

• Para verificar o status das sessões de iSCSI ativas e identificar problemas, execute o seguinte comando:

  sudo iscsiadm -m session

• Para verificar se multipath funciona conforme o esperado, execute o seguinte comando:

  sudo multipath -ll

• Para verificar se há erros nos logs, execute um dos seguintes comandos:

  dmesg | grep iSCSI

  -ou-

  journalctl -u iscsid

Para solucionar outros problemas de montagem, consulte Solucionar problemas de LUNs iSCSI não visíveis no host no site da NetApp.

Solucionar problemas do servidor FSx para ONTAP

Para verificar se o serviço de iSCSI está em execução, execute os seguintes comandos:

vserver iscsi show
iscsi session show

Para verificar se há problemas na configuração do LUN, execute o seguinte comando:

lun show -vserver vserver_name

Observação: substitua vserver_name pelo nome do seu servidor.

Para verificar se você configurou corretamente o acesso ao armazenamento, execute o seguinte comando para visualizar o mapeamento entre LUNs e grupos de iniciadores:

lun mapping show

Para verificar a configuração de igroup e confirmar se ela inclui seu iniciador, execute o seguinte comando:

igroup show -instance