Comando dumpctrl

Editar online

Propósito

Gerencia dumps do sistema e dumps ao vivo.

Sintaxe

dumpctrl -k

dumpctrl -R [ l | s ] [-P]

dumpctrl-s [-c | -C comp-path-list ] [-l | -L comp-alias-list ] [-t | -T type_subtype ] [-r] [-u]

dumpctrl -qc [-c comp-path-list] [-l comp-alias-list] [-t type_subtype]] [-r] [-u] [-p | -P]

dumpctrl -ql [-p | -P]

dumpctrl -qs [-p | -P]

dumpctrl [-P] [global_atributo]

dumpctrl [-c comp-path-list] [l comp-alias-list] [-t type_subtype] [-r] [-u] [-n | -p | -P ] | -x] [per-component_atributo]

Descrição

Existem dois tipos de componentes de dump:

componente: Refere-se a um componente especificado com a infraestrutura RAS (uma criada com o serviço kernel ras_register() ).
componente legado: Refere-se a um componente de dump especificado com o dmp_add() ou o serviço de kernel dmp_ctl() .

O comando dumpctrl é usado para obter informações sobre quais componentes são registrados para dumps vivos ou dumps do sistema, além de consultar e alterar características do dump.

Os componentes são especificados com o nome completo do caminho, alias lógico do dispositivo, tipo ou subtipo. Você pode usar vários sinalizadores para especificar vários componentes ou listas de componentes.

Sinalizações

Pelo menos uma bandeira deve ser especificada.

Item	Descrição
-c `lista de caminhos de compilação`	Especifica componentes por nome do caminho. Os curingas são permitidos. Use o comando -c all para especificar todos os componentes.
-k	Atualiza a lista de dumps do kernel. Esta bandeira é executada a cada 5 minutes minutos por padrão. Esse período pode ser alterado editando o comando crontab para o usuário root e alterando a entrada para /usr/sbin/dumpctrl -k. Para mais informações, consulte o comando crontab . Você deve executar o comando dumpctrl -k depois de adicionar ou remover dumps à mão. Se o sistema estiver segurando qualquer dumps no heap que ele anteriormente não poderia gravar no sistema de arquivos, o sistema tenta escrever esses dumps e reaver seu espaço de armazenamento agora.
-l `lista de apelidos`	Especifica componentes por alias. Os curingas são permitidos.
-r	Dumps quaisquer subcomponentes dos componentes especificados.
-q `cmd`	Atributos de consultas para o dump ao vivo ou dump do sistema. A sinalização -qc mostra atributos de dump ao vivo específicos do componente e atributos de dump do sistema. A sinalização -qc pode ser usada com o sinalizador -p ou -P para consultar atributos persistentes por componente. A sinalização -qc mostra os atributos para todos os componentes se nem a sinalização -c, -l, nem -t for especificada. Em outras palavras, -c all é o padrão. A seguir, uma saída de amostra para este comando: `dumpctrl -qc -r -l vmm -l proc -------------------------------------------------------------------------- Component name \| Have \| Live Dump \| System Dump \|Alias \| /level \| /level -------------------------------------------------------------------------- vmm \| no \| on/3 \| on/3 .pft \| no \| on/3 \| on/3 ... proc \| no \| on/4 \| on/3 ...` A sinalização -ql lista as configurações globais de dump ao vivo. A sinalização -ql pode ser usada com a sinalização -p ou -P para consultar configurações de dump ao vivo globais persistentes. A sinalização -qs `type` mostra atributos de dump do sistema global. O -qs pode ser usado com a bandeira -p ou -P para consultar atributos de dump do sistema global.
-r	Inclui componentes abaixo dos componentes especificados na hierarquia de componentes.
-Rx	Restaura configurações de dump para seus padrões. `x` pode ser `l` para configurações de dump ao vivo, ou `s` para configurações de dump do sistema. Ele reconfigura apenas as configurações de dump global. Os componentes individuais não podem ser especificados. A sinalização -P e uma nova imagem de inicialização são necessárias para garantir que todas essas configurações permaneça em vigor através de um reinício.
-t `tipo_subtipo`	Especifica um componente por nomes `type_subtype` .
-s	Lista os nomes de caminhos e títulos de todos os dumps vivos no repositório de dump. Se os componentes forem especificados com a sinalização -c, -lou -t , a lista de dumps mostrados contém dumps apenas com os componentes especificados. Se os componentes forem especificados com a sinalização -C, -Lou -T , a lista de dumps mostrados contém dumps apenas com os componentes falhos especificados.
-C `lista de caminhos de compilação`	Especifica componentes por nome do caminho. Os curingas são permitidos. O nome reservado `all` também é permitido para indicar todos os componentes. A sinalização -C é válida apenas com a sinalização -s .
-L `lista de apelidos`	Especifica componentes por alias. Os curingas são permitidos. A sinalização -L é válida apenas com a sinalização -s .
-T `tipo_subtipo`	Especifica um componente por nomes `type_subtype` . A sinalização -T é válida apenas com a bandeira -s .
-u	Inclui componentes acima dos componentes especificados na hierarquia de componentes.

Sinalizadores de persistência

Item	Descrição
-p	As mudanças se aplicam somente aos componentes recém-criados, que são componentes de infraestrutura RAS que são criados após o comando dumpctrl executar.
-P	Faz com que as alterações especificadas permanentes. Quaisquer alterações que sejam feitas permanecem em vigor através de um reinício. Se uma nova imagem de inicialização for necessária, uma mensagem é produzida para notificá-lo sobre ele. A sinalização -P se aplica a atributos de componentes, a ativação ou desativação global de dump ao vivo, o nível de dump ao vivo global, a ativação ou desativação de componentes legados, e as especificações do dispositivo de dump do sistema.
-n	As alterações se aplicam aos componentes existentes. A sinalização -n é o padrão se nem -p nem -P for especificado. Para aplicar alterações nos componentes atuais e recém-criados, use as bandeiras -n e -p .
-x	Exclui esta especificação de persistência. A sinalização -x exclui uma especificação de persistência permanente (-P). A especificação deve ser especificada da mesma maneira como foi originalmente especificado com a sinalização -P .

A customização recursiva (especificada pela sinalização -r ) tem precedência sobre toda a outra customização, independentemente da ordem em que eles são especificados em relação a outra customização não recursiva.

Se você não souber a customização que é feita mas deseja restaurar a configuração padrão do sistema, você pode fazer uma das seguintes ações:

No arquivo " /var/adm/ras/raspertune, exclua as linhas relevantes para a personalização e execute o comando " bosboot para reiniciar AIX.
Leia o arquivo /var/adm/ras/raspertune para descobrir as sinalizações e parâmetros apropriados que são especificados. Em seguida, use a sinalização -x para excluir a customização. Execute o comando bosboot e reinicie o AIX.

Para obter mais informações sobre como os vários atributos de dump interagem com persistência, consulte as tabelas de atributos de dump ao vivo e dump do sistema em Atributos.

Atributos

Os atributos do dump podem assumir o formulário attribute=value. Por exemplo,

dumpctrl dir=/usr/dumps freespc=20

Este exemplo configura diretório de dump para /usr/dumps, e o limite de espaço livre para 20%.

Alguns atalhos são fornecidos, como o atributo ldmpon , que é o mesmo que ldmpenable=yes.

Se os componentes forem dados, atributos não reconhecidos são transmitidos para callbacks desses componentes usando RASCD_DMP_PASS_THROUGH.

A tabela a seguir lista atributos de dump ao vivo.

Tabela 1. Atributos de dump ao vivo e padrões
Atributo	Especificação	Valor Padrão
ldmpenable	Especifica se o dump ativo está ativado. Os valores possíveis são sim e não. Você pode usar o atributo ldmpon em vez de `ldmpenable=yes`, e o atributo ldmpoff em vez de `ldmpenable=no`.	sim Para obter mais informações, consulte a seguinte nota 1.
dir	Especifica um nome de diretório do dump ativo.	/var/adm/ras/livedump
freespc	Especifica limite de espaço livre do dump ao vivo usando um valor decimal de 0 99.	25 (significa 25%)
ldmplevel	Especifica o nível de dump ao vivo usando um valor decimal de 0 9. Você pode especificar o atributo ldmpminimal, ldmpnormalou ldmpdetail em vez de `ldmplevel=1, 3, 7`	3 (normal) Para obter mais informações, consulte a seguinte nota 1.
heapsz	Especifica o tamanho de heap de dump ao vivo usando um valor decimal em megabytes.	0 Para obter mais informações, consulte a seguinte nota 2.
duptype	Especifica o tipo de supressão de dump duplicado. A seguir, os valores possíveis: Todos pré lançar Nenhum	Todos
maxfreeze	Especifica o intervalo de congelamento do sistema máximo recomendado usando um número decimal em milissegundos.	100 ms

A tabela a seguir lista atributos de dump do sistema.

Tabela 2. Atributos de dump do sistema e padrões
Atributo	Especificação	Valor Padrão
sdmpenable	Especifica se o dump do sistema está ativado. Os valores possíveis são sim e não. Você também pode especificar o sdmpon ou sdmpoff em vez de `sdmpenable=yes` ou `sdmpenable=no`.	sim Para obter mais informações, consulte a seguinte nota 3.
legacyenable	Especifica se os componentes de legado do dump estão ativados. Os valores possíveis são sim e não. Você também pode especificar o legacyon ou legacyoff em vez de `legacyenable=yes` ou `legacyenable=no`.	sim
sdmplevel	Especifica o nível de dump do sistema usando um valor decimal de 0 a 9. Você pode especificar o atributo sdmpminimal, sdmpnormalou sdmpdetail em vez de `sdmplevel=1, 3, 7`	3 (normal) Para obter mais informações, consulte a seguinte nota 4.
copydir	Especifica um nome de caminho do diretório de cópia.	/var/adm/ras
forcecopy	Especifica se o atributo forcecopy está ativado. Os valores possíveis são sim e não. Se um dump deve ser copiado do espaço de paginação no momento da inicialização, e não houver espaço suficiente no diretório de cópias, você será solicitado a copiar o dump para a mídia removível se o valor forcecopy for sim. Se o valor for não, o dump não será copiado e o sistema inicializará normalmente, embora o dump possa ser perdido.	sim
keyseq	Especifica se as sequências-chave sempre causam um dump. Os valores possíveis são sim e não.	não
primary	Especifica o nome do caminho do dispositivo de dump primário.	/dev/hd6 ou /dev/lg_dumplv
secondary	Especifica o nome do caminho do dispositivo de dump secundário.	/dev/sysdumpnull

Notas:

Os atributos ldmpenable e ldmplevel podem ser especificados com ou sem componentes. Se especificado sem componentes, os atributos aplicam-se aos atributos globais correspondentes.
O atributo heapsz (tamanho de heap) pode ser configurado como 0, significando que, no tempo de inicialização do dump, o sistema calcula o tamanho de heap do dump ao vivo que é baseado na quantidade de memória real, que é o mínimo de 64 MB e de 1/64 o tamanho da memória real.
Os componentes individuais devem ser especificados quando o atributo sdmpenable é dado. Se nenhum componente for dado, o atributo sdmpenable não pode ser especificado porque o dump do sistema não pode ser desativado.
O atributo sdmplevel pode ser especificado com ou sem componentes. Se especificado sem componentes, aplica-se ao nível padrão do sistema. Os componentes com sdmplevel que são maiores que o valor global sdmplevel não estão incluídos em um dump do sistema.

A tabela a seguir relaciona atributos de dump ao vivo e sua persistência.

Tabela 3. Atributos de dump ao vivo e persistência
Atributo	Descrição	Persistência
ldmpenable	Dump ao vivo ativado	Controlada por sinalizadores de persistência, nova imagem de inicialização é necessária com a sinalização -P .
dir	Diretório de dump ao vivo	Entra em vigor imediatamente e mediante o reinício do sistema.
freespc	Limite de espaço livre do dump ao vivo	Entra em vigor imediatamente e mediante o reinício do sistema.
ldmplevel	Nível de dump ativo	Controlada por sinalizadores de persistência, nova imagem de inicialização é necessária com a sinalização -P .
heapsz	Tamanho de heap de dump vivo	Entra em vigor imediatamente e mediante o reinício do sistema.
duptype	Tipo de supressão de dump duplicado	Entra em vigor imediatamente e mediante o reinício do sistema.
maxfreeze	Intervalo máximo de congelamento do sistema recomendado	Entra em vigor imediatamente e mediante o reinício do sistema.

Nota: A persistência afeta os atributos apenas quando se aplicam a componentes de infraestrutura RAS. A persistência controla também o nível de dump ao vivo global e o status global ativado ou desativado.

A tabela a seguir lista atributos de dump do sistema e sua persistência.

Tabela 4. Atributos de dump do sistema e persistência
Atributo	Descrição	Persistência
sdmpenable	Dump do sistema ativado	Controlada por sinalizadores de persistência, nova imagem de inicialização é necessária com a sinalização -P .
legacyenable	Componentes legados do dump	Entra em vigor imediatamente, e mediante o reinício do sistema com a sinalização -P . Nenhuma nova imagem de inicialização é necessária com a sinalização -P .
sdmplevel	Nível do dump do sistema	Controlada por sinalizadores de persistência, nova imagem de inicialização é necessária com a sinalização -P .
copydir	Copiar diretório	Entra em vigor imediatamente e mediante o reinício do sistema.
forcecopy	Traz o menu de tempo de inicialização se não puder copiar	Entra em vigor imediatamente e mediante o reinício do sistema.
keyseq	Sequencias de chave sempre causam um dump	Entra em vigor imediatamente e mediante o reinício do sistema.
primary	Dispositivo de dump principal	Entra em vigor imediatamente, e mediante o reinício do sistema com a sinalização -P . Nenhuma nova imagem de inicialização é necessária com a sinalização -P .
secondary	Dispositivo de dump secundário	Entra em vigor imediatamente, e mediante o reinício do sistema com a sinalização -P . Nenhuma nova imagem de inicialização é necessária com a sinalização -P .

Nota: Persistir afeta os atributos quando se aplicam a componentes.

Os atributos copydir, forcecopy, keyseq, primary, e secondary se comportam como suas contrapartes de comando sysdumpdev que são especificadas com as bandeiras -d, -D, -k, -K, -pe -s .

Status de saída

Esse comando retorna os valores de saída a seguir:

Item	Descrição
0	Conclusão bem-sucedida.
fora de zero	Ocorreu um erro. Este comando falha sob as seguintes condições: Um ou mais parâmetros são inválidos. Um ou mais atributos são inválidos. Um componente não pode ser especificado. Pelo menos um componente deve ser especificado. A especificação persistente não pode ser encontrada. (Pode ocorrer com a sinalização -x .)

Segurança

Apenas o usuário root pode utilizar este comando.