O Dockerd não inicia no IE3400 quando o SD-Card para IOx é formatado em FAT

Introduction

Este documento descreve como corrigir um problema em que o daemon Docker falha ao iniciar no IE3400 quando o cartão SD não está formatado em ext4.

Problema

O IE3400 usa o cartão SD para armazenamento relacionado aos aplicativos IOx. Caso o cartão SD não esteja formatado em ext4, isso causa problemas.

Estes são os sintomas:

Quando você tenta implantar um aplicativo por meio da GUI do IOx, esta mensagem é exibida:

Application Deployment Failed: Invalid Archive file: Unable to extract docker rootfs /flash11/iox/tmpArchiverPznor to /flash11/iox/tmpExtractYXZJbE/rootfs Error:global name 'app_mount_dir' is not defined

No log/console, essas mensagens são vistas quando você ativa o IOx ou quando o IOx é iniciado após uma reinicialização.

ie3400#conf t
Enter configuration commands, one per line.  End with CNTL/Z.
ie3400(config)#iox
Warning: Do not remove SD flash card when IOx is enabled or errors on SD device could occur.
 
*Feb 21 12:45:27.045: %UICFGEXP-6-SERVER_NOTIFIED_START: R0/0: psd: Server iox has been notified to start
*Feb 21 12:45:30.737: %PMAN-3-PROCFAIL: R0/0: root: The process dockerd has failed (rc 1)
*Feb 21 12:45:32.184: %PMAN-3-PROCHOLDDOWN: R0/0: root: The process dockerd has been helddown (rc 1)
*Feb 21 12:46:57.983: %IM-6-IOX_ENABLEMENT: R0/0: ioxman: IOX is ready.

Solução

Esse problema está relacionado ao sistema de arquivos do cartão SD. Se a placa estiver formatada com algo diferente de ext4, por exemplo, FAT/vFAT, o problema parece aparecer.

Para verificar o sistema de arquivos atual no cartão SD, isso pode ser usado:

ie3400#sh sdflash: file
Filesystem: sdflash
Filesystem Path: /flash11
Filesystem Type: vfat
Mounted: Read/Write

Como você pode ver na saída, esse cartão SD foi formatado como FAT/vFAT.

Para corrigir esse problema, primeiro pare/desative o IOx.

ie3400#conf t
Enter configuration commands, one per line.  End with CNTL/Z.
ie3400(config)#no iox
Notify IOx to stop. To safely remove SD card, please wait until IOx is stopped.
*Feb 21 12:48:01.615: %UICFGEXP-6-SERVER_NOTIFIED_STOP: R0/0: psd: Server iox has been notified to stop

 Use o comando show iox para garantir que ele seja totalmente parado.

ie3400#sh iox

IOx Infrastructure Summary:
---------------------------
IOx service (CAF)         : Not Running
IOx service (HA)          : Not Supported
IOx service (IOxman)      : Not Running
IOx service (Sec storage) : Not Supported
Libvirtd   1.3.4          : Running
Dockerd                   : Not Running

Em seguida, formate a placa corretamente para ser usada com IOx, você pode usar este comando.

Lembre-se de que isso apaga todos os dados do cartão SD.

ie3400#format sdflash: ext4
Format operation may take a while. Continue? [confirm]
Format operation will destroy all data in "sdflash:".  Continue? [confirm]
format completed with no errors

Format of sdflash: complete

Depois de concluído, inicie/habilite o IOx novamente.

ie3400#conf t
Enter configuration commands, one per line.  End with CNTL/Z.
ie3400(config)#iox
Warning: Do not remove SD flash card when IOx is enabled or errors on SD device could occur.

*Feb 21 12:49:18.310: %UICFGEXP-6-SERVER_NOTIFIED_START: R0/0: psd: Server iox has been notified to start
*Feb 21 12:49:48.165: %IM-6-IOX_ENABLEMENT: R0/0: ioxman: IOX is ready.

Como você pode ver, as mensagens de erro referentes ao dockerd não são mais vistas e use este comando show iox para verificar o status.

ie3400#sh iox

IOx Infrastructure Summary:
---------------------------
IOx service (CAF) 1.10.0.1 : Running
IOx service (HA)          : Not Supported
IOx service (IOxman)      : Running
IOx service (Sec storage) : Not Supported
Libvirtd   1.3.4          : Running
Dockerd    18.03.0        : Running