applydrivesoftware

Use o comando applydrivesoftware para fazer atualizar de unidades.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>- applydrivesoftware -- -file --name-------------------------->

>--+-----------------------+--+- -drive --drive_id-+------------>
   |          .-firmware-. |  '- -all -------------'   
   '- -type --+-fpga-----+-'                           

>--+----------+--+-------------------+--+-------------------+--><
   '- -force -'  '- -allowreinstall -'  '- -allowdowngrade -'   

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>- applydrivesoftware -- -cancel -----------------------------><

Parâmetros

-file name
(Obrigatório) Especifica o nome do arquivo do atualizar de firmware que deve ser copiado no diretório /home/admin/update/ no nó de configuração.
-type fpga | firmware
(Opcional) Especifica o tipo de firmware da unidade a ser atualizado. As atualizações de firmware da unidade podem ser executadas online, simultaneamente com a E/S. No entanto, atualizações fpga requerem que a unidade fique offline, o que significa que as unidades de destino devem se tornar candidate antes de emitir o comando applydrivesoftware. O valor padrão é firmware. Consulte o comando chdrive para obter mais detalhes.
-all
(Opcional) Especifica que o firmware da unidade deve ser aplicado a cada unidade no sistema, contanto que essa unidade esteja online e tenha use member, use spare ou use candidate.
Isso não se aplica a:
  • Unidades que possuem volumes dependentes
  • Unidades que são membros de matrizes não redundantes
Unidades que hospedam quorum qualificam-se, mas há risco. Para evitar esse risco use -drive e certifique-se de que o quorum seja movido entre as chamadas applydrivesoftware. Use o comando chquorum para evitar atualizando uma unidade que está hospedando o quorum.
Se -all for especificado, será necessário o -type como firmware.
Lembre-se: O parâmetro -all difere do parâmetro -drive porque unidades inadequadas não estão incluídas na lista de unidades planejadas para atualizar quando você usa -all.
-drive drive_id
(Opcional) Especifica um ID de unidade ou uma lista de IDs de unidade (separados por dois pontos, [:]) para ser atualizado. O número máximo de IDs é 128. Se você tiver mais de 128, use -all ou várias chamadas applydrivesoftware para concluir a atualizar.
Lembre-se: O parâmetro -drive difere do parâmetro -all, pois se for especificada uma unidade inadequada usando o parâmetro -drive, o comando applydrivesoftware falhará. Além disso, se as três unidades forem especificadas como hospedando o quorum, o comando falhará. Se você usar a opção -drive para especificar uma única unidade e essa unidade tiver use=unused, ela será atualizado.
-force
(Opcional) Efetua bypass da verificação de volume dependente. Por padrão o applydrivesoftware não poderá ser executado se houver volumes dependentes na unidade. Especificar -force efetua bypass dessa verificação, permitindo que a atualização de software da unidade continue. Volumes dependentes de unidade geralmente resultam de matrizes RAID não redundantes ou degradadas.
Nota: Restaure a redundância para o sistema (onde possível) em vez de usar o parâmetro -force.
Importante: Usar o parâmetro -force pode resultar em perda de dados. Use-o somente sob orientação das informações do suporte do seu produto., ou se você desejar aceitar o risco de perda de dados na matriz ou no conjunto ao qual a unidade pertence.
-allowreinstall
(Opcional) Especifica para fazer com que o sistema instale o nível atual (novamente) em unidades que contenham um arquivo no pacote.
Lembre-se: Usar este parâmetro não é recomendado.
-allowdowngrade
(Opcional) Especifica para permitir que o sistema faça downgrade do firmware em uma unidade (que contém um arquivo no pacote).
Lembre-se: Use esse parâmetro somente sob orientação das informações do suporte do seu produto..
-cancel
(Opcional) Especifica que o comando seja parado.

Descrição

Use esse comando para fazer atualizar do firmware de unidades que são gerenciadas pelo sistema.

Há dois tipos de software de unidade que podem ser atualizados usando este comando:
  • firmware
  • fpga
Atualizações de firmware da unidade podem ser executadas online enquanto a unidade está sendo usada. Quando usada em uma unidade do membro da matriz applydrivesoftware verifica volumes que são dependentes na unidade e se recusa a executar se algum for localizado. Volumes dependentes da unidade são geralmente causados por matrizes RAID não redundantes ou degradadas. Quando possível, é necessário restaurar a redundância ao sistema substituindo quaisquer unidades com falha antes de usar o comando applydrivesoftware. Quando isso não for possível, por exemplo, em unidades que sejam membros de uma matriz RAID-0, será possível incluir redundância no volume incluindo uma segunda cópia em outro conjunto ou usar o parâmetro -force para efetuar bypass da verificação de volume dependente.
Lembre-se: Use -force somente se você estiver disposto a aceitar o risco de perda de dados em volumes dependentes (se a unidade falhar durante a atualização do firmware).

As atualizações de firmware da unidade ocorrem de forma assíncrona e são concluídas após o comando applydrivesoftware ser concluído. Para ver o status das atualizações, use o comando lsdriveupgradeprogress.

As atualizações da unidade fpga podem requerer que a unidade fique offline por vários minutos. As unidades devem ser alteradas para o estado candidate antes que applydrivesoftware possa ser usado para atualizar o software fpga. As atualizações fpga ocorrem de maneira assíncrona, continuando no segundo plano após o comando applydrivesoftware ser retornado. É necessário verificar o campo FPGA_level em lsdrive N, em que N é drive_id, para ver se a atualização foi concluída com sucesso ou não.
Lembre-se: Interromper uma atualização fpga removendo a energia da unidade ou gabinete pode tornar a unidade inutilizável. Somente um fpga de uma unidade pode ser atualizado por chamada applydrivesoftware. Certifique-se de que a atualizar esteja concluída antes de desprender a unidade ou de remover a energia do gabinete.

Um Exemplo de Chamada

applydrivesoftware -file DRIVE_XXXXXXXX -type firmware -drive 4

A saída resultante:

Sem feedback

Um Exemplo de Chamada

Um exemplo que falha devido a volumes dependentes da unidade:

applydrivesoftware -file DRIVE_XXXXXXXX -type firmware -drive 6

A saída resultante:

CMMVC6953E The action cannot be completed because vdisks are dependent on the specified mdisk. Force is required.

Um Exemplo de Chamada

applydrivesoftware -file drivemicrocodepackagev5 -type firmware -all

A saída resultante:

Sem feedback

Um Exemplo de Chamada

applydrivesoftware -file drivemicrocodepackagev1 -type firmware -all -allowreinstall

A saída resultante:

Sem feedback

Um Exemplo de Chamada

applydrivesoftware -file drivemicrocodepackagev1 -type firmware -all -allowdowngrade

A saída resultante:

Sem feedback

Um Exemplo de Chamada

applydrivesoftware -file drivemicrocodepackagev1 -type firmware -all -allowdowngrade -allowreinstall

A saída resultante:

Sem feedback

Um Exemplo de Chamada

applydrivesoftware -cancel

A saída resultante:

Sem feedback