Interface de linha de comandos do PowerVM NovaLink

A interface de linha de comandos do (CLI) PowerVM NovaLink é uma CLI baseada em Python para funções administrativas numa sistema que é gerido através de PowerVM NovaLink.

comando chlickey

Quando o PowerVM NovaLink está na versão 1.0.0.16, pode especificar a chave de licença das partições lógicas de IBM® i com o seguinte comando:
/usr/bin/chlickey -p <nome sistema> -o a --lickey "<chave de licença>"
Onde
  • -p <nome sistema> indica a partição lógica ou servidor.
  • -o indica o tipo de operação a ser executada.
  • a indica que a informação da licença tem que ser adicionada ao repositório da licença.
  • --lickey <chave de licença> especifica a chave de licença a ser adicionada.

Comando Pvmctl

A interface de linha de comandos utiliza o comando pvmctl na maioria das operações. O comando pode ser introduzido na linha de comandos da partição do PowerVM NovaLink.

O comando pvmctl apenas pode ser executado por utilizadores que fazem parte do grupo pvm_admin. Para adicionar um utilizador ao grupo pvm_admin, introduza o seguinte comando:
sudo adduser user_id pvm_admin
O utilizador admin para a partição PowerVM NovaLink é adicionado ao grupo pvm_admin automaticamente quando PowerVM NovaLink é instalado.

Apresentar informações sobre a versão

Para apresentar informações sobre a versão para o software do PowerVM NovaLink, introduza o comando pvmctl --version.

Ajuda para os comandos

O comando pvmctl inclui informações de ajuda que listam as operações que são utilizadas pelo comando. Para ver as informações de ajuda, introduza um dos seguintes comandos.

Para ver uma lista de objectos nos quais pode executar acções, introduza o comando pvmctl help ou pvmctl --help.

Para ver uma lista de operações para um tipo de objectos específico, introduza o comando pvmctl object_type help ou pvmctl object_type --help.

Para ver informações sobre os argumentos para um tipo de operações e objectos específico, introduza o comando pvmctl object_type operation help ou pvmctl object_type operation --help.

Tipos de objectos suportados

Os tipos de objecto seguintes são suportados pela CLI do PowerVM NovaLink. Pode utiliza ou tipos de objecto completos ou os nomes abreviados indicados para cada tipo de objecto.
  • Conjunto de unidades
  • IOSlot (io)
  • LogicalPartition (lpar ou vm)
  • LogicalUnit (lu)
  • LogicalVolume (lv)
  • ManagedSystem (sys)
  • LogicalPartition (lpar ou vm)
  • NetworkBridge (nbr, bridge, sea, sharedethernetadapter)
  • PhysicalVolume (pv)
  • SharedProcessorPoool(sharedprocpool, spp)
  • VirtualIOServer (vios)
  • SharedStoragePool (ssp)
  • SRIOVadapter (sriov)
  • sriovethernetlogicalport (ethlogicalport, ethlp)
  • SharedEthernetAdapter (sea)
  • VirtualEthernetAdapter (vea ou eth)
  • VirtualFibreChannelMapping (vfc ou vfcmapping)
  • VirtualMediaRepository (vmr ou repo)
  • VirtualNICdedicated (vnic)
  • VirtualNetwork (vnet ou net)
  • VirtualOpticalMedia (vom ou media)
  • VirtualSCSIMapping (scsi ou scsimapping)
  • VirtualSwitch (vswitch ou vsw)
  • Volumegroup (vg)
Para o PowerVM NovaLink Versão 2.0, ou posterior, são suportados os seguintes tipos de objectos pela CLI do PowerVM NovaLink.
  • persistentmemorydevice (pmemd)
  • persistentmemoryvolume (pmemv)

Estrutura de comandos

A CLI utiliza a seguinte estrutura de comandos.

pvmctl [--version] [object] [operation] [arguments...] [help | --help]
Por exemplo, para listar as partições lógicas no sistema gerido, introduza o seguinte comando:
pvmctl LogicalPartition list
Para listar todos os nomes, IDs e estados do Virtual I/O Server e os nomes de dispositivos de adaptador de E/S associados, utilize o argumento --display-fields (ou -d):
pvmctl vios list -d name id state IOAdapter.dev_name
Para listar os nomes, IDs, estados e nomes de dispositivos do adaptador de E/S associados de todos os Servidores de E/S Virtual que não estão a executar, utilize o argumento --where para adicionar a condição ao comando:
pvmctl vios list -d name id state IOAdapter.dev_name --where VirtualIOServer.state!=running
Para listar uma ponte de rede com uma porta ID da VLAN de 10, utilize o argumento --object-id (ou -i):
pvmctl bridge list --object-id pvid=10
Para actualizar a memória pretendida de uma partição lógica com o nome mylpar para 512 MB, utilize o argumento --set-fields:
pvmctl lpar update -i name=mylpar --set-fields PartitionMemoryConfiguration.desired=512 
Para eliminar um adaptador Ethernet virtual, especifique o identificador ascendente do mesmo com o argumento --parent-id (ou -p):
pvmctl vea delete -i pvid=1 --parent-id name=lpar_name

Para criar uma nova partição lógica, veja os argumentos requeridos ao utilizar o comando pvmctl lpar create help.

O seguinte comando cria uma partição lógica AIX/Linux® denominada new_lpar com um processador dedicado e 512 MB de memória:
pvmctl lpar create --name new_lpar --proc 1 --proc-type dedicated
--sharing-mode normal --type AIX/Linux --mem 512

Gerir o volume de memória persistente

Quando o software proprietário está no nível FW940, ou posterior e o PowerVM NovaLink está na Versão 2.0.0.0, ou posterior, pode visualizar e gerir o volume de memória persistente que está atribuído a uma partição lógica. Pode gerir o volume de memória persistente apenas quando a partição lógica está no estado Não activada (Not activated). Não é possível adicionar volumes de memória persistente virtual (PMEM, Persistent Memory) a uma partição lógica na qual a capacidade Reinício remoto simplificado (Simplified Remote Restart) está activada.

Pode executar as seguintes operações na partição lógica:

Para listar os dispositivos de memória persistente que estão associados a uma partição lógica, introduza o seguinte comando:
 pvmctl pmemd list
Para listar os volumes de memória persistente que estão atribuídos a uma partição lógica, introduza o seguinte comando:
pvmctl pmemv list
Para criar um volume de memória persistente, introduza o seguinte comando:
Nota: O tamanho do volume de memória persistente tem que ser um múltiplo do tamanho de bloco do dispositivo, o qual pode ser consultado através da listagem do dispositivo.
 pvmctl pmemv create --name volume_name --size volume_size --lpar_id associated_lpar_id
Para eliminar um volume de memória persistente, introduza o seguinte comando:
pvmctl pmemv delete -i name=volume_name

Comando de terminal virtual

Introduza o comando mkvterm para abrir uma ligação terminal virtual a uma partição lógica AIX ou Linux.

Por exemplo, para abrir uma ligação do terminal virtual a uma partição com o ID de partição 3, introduza o seguinte comando:
mkvterm --id 3

Para sair do terminal virtual, prima Control+].

Comandos de restauro e criação de cópia de segurança da configuração da partição

Introduza os comandos bkprofdata e rstprofdata para criar uma cópia de segurança e restaurar os dados da configuração da partição de um sistema gerido. Estes comandos criam uma cópia de segurança e restauram apenas os dados da configuração da partição no hipervisor.

Por exemplo, para criar uma cópia de segurança da configuração da partição para o ficheiro /tmp/mybackup.bak, introduza o seguinte comando:
bkprofdata -o backup -f /tmp/mybackup.bak
Para restaurar os dados da configuração da partição do ficheiro /tmp/mybackup.bak ao utilizar o restauro da fase 2, introduza o seguinte comando:
rstprofdata -l 2 -f /tmp/mybackup.bak

Comando do Servidor de E/S Virtual

Utilize o comando viosvrcmd para executar comandos numa instância do Servidor de E/S Virtual.

Por exemplo, para executar o comando lsmap -all no Servidor de E/S Virtual com o ID de partição 2, introduza o seguinte comando:
viosvrcmd --id 2 -c "lsmap -all"