comando ctmonfs

Propósito

Monitora um sistema de arquivos para uma condição específica.

Sintaxe

Para adicionar ou monitorar uma nova condição de sistema de arquivos, use a sintaxe a seguir:

ctmonfs -a -n condition_name -f <fsname> -c <condition_type[,attr=value,...]> [-b <action_name> ] 
[-k <action_type[,attr=value,...]> [-i <interval>] [-m 0|1] [-e 0|1]

Para alterar atributos de uma condição do sistema de arquivos, use a seguinte sintaxe:

ctmonfs -u -n condition_name [-f <fsname>] [-c <attr=value,...>] [-b|-B <action_name> ] 
[-k <attr=value,...>] [-i <interval>] [-m 0|1] [-e 0|1]

Para remover uma condição de sistema de arquivos, use a seguinte sintaxe:

ctmonfs -r -F | -n condition_name

Para listar uma condição de sistema de arquivos específica ou para listar todas as condições do sistema de arquivos, use a seguinte sintaxe:

ctmonfs -l [-n condition_name]

Descrição

O comando ctmonfs é usado para monitorar um sistema de arquivos para uma condição específica. Condições definem os critérios contra os quais um sistema de arquivos deve ser monitorado. Ações definem os comandos que devem ser executados quando a condição ocorre. Você não precisa especificar nenhuma ação ou você pode especificar ações que devem ser executadas de acordo com a prioridade de ação. Se a prioridade das ações não for especificada, as ações são executadas na ordem em que você especificou as ações. Se você não especificar nenhuma ação, a condição é registrada em arquivo trace sem executar nenhuma ação. Cada condição ou ação consiste em atributos que definem os dados adicionais da condição ou da ação.

O tipo de condição a seguir é suportado:

fsspace

Monitora espaço livre do sistema de arquivos. O tipo de condição fsspace contém os seguintes atributos:

método

Especifica como o espaço do sistema de arquivos é monitorado. Os valores válidos são os seguintes:

free_percentual: Monitora sistema de arquivos por porcentagem do espaço total restante.
espaço livre: Monitora sistema de arquivos por unidades de espaço restante em MB.

threshold_free_percentual

Especifica um valor de porcentagem limite para uma condição de espaço livre ou restante em um sistema de arquivos. Ou seja, a condição torna-se verdadeira se a porcentagem de espaço livre for igual ou menor que este valor.

Nota: Este atributo é válido apenas quando o atributo method é configurado como free_percent.

limiar_espaço livre

Especifica um valor de limite em MB para uma condição de espaço livre em um sistema de arquivos. Ou seja, a condição torna-se verdadeira se o espaço livre for igual ou menor que este valor.

Nota: Este atributo é válido apenas quando o atributo method é configurado como free_space.

rearm_valor

Pára de avaliar os valores threshold_free_percent ou threshold_free_space quando a condição se torna verdadeira e começa a avaliar o valor de atributo rearm_value . A condição de rearmar torna-se verdadeira se o valor free_percent ou free_space se tornar igual ou maior que este valor.

Nota: O atributo rearm_value é opcional. Além disso, os atributos rearm_value e rearm_waittime são mutuamente exclusivos. Se o atributo rearm_value for especificado, o atributo rearm_waitime não deve ser especificado.

rearmar_tempo de espera

Pára de avaliar os valores threshold_free_percent ou threshold_free_space quando a condição se torna verdadeira e retoma o monitoramento do sistema de arquivos após o tempo que é especificado no atributo rearm_waittime . Ou seja, o monitoramento do sistema de arquivos é suspenso para a duração que é especificado no atributo rearm_waittime .

Nota: O atributo rearm_waittime é opcional. Além disso, os atributos rearm_value e rearm_waittime são mutuamente exclusivos. Se o atributo rearm_waittime for especificado, o atributo rearm_value não deve ser especificado.

O tipo de ação a seguir é suportado:

ação do usuário

Inicia o script do usuário ou um arquivo executável. O tipo de ação useraction contém os seguintes atributos:

caminho: Especifica o nome do arquivo executável.
prioridade: Especifica a prioridade da ação. Os valores válidos são números inteiros positivos. Um número menor indica mais prioridade. Um valor de 0 significa sem prioridade.

As configurações de configuração que são especificadas no comando ctmonfs são armazenadas no arquivo /var/ct/cfg/fsmon.cfg . Por padrão, o sistema de arquivos /var é monitorado para a condição fsspace com um tipo useraction associado. Quando a condição fsspace se torna verdadeira, um script padrão é chamado para limpar arquivos desnecessários no diretório /var/ct .

Sinalizações

-a

Cria uma condição de sistema de arquivos para monitorar o sistema de arquivos.

-u

Modifica uma condição de sistema de arquivos existente.

-r

Remove uma condição de sistema de arquivos. Se a sinalização -F for especificada, todas as condições do sistema de arquivos serão removidas.

-l

Lista todas as condições do sistema de arquivos. Se você especificar a sinalização -n , apenas uma condição de sistema de arquivos específico será listada.

--n nome_da_condição

Especifica um nome exclusivo para uma condição de sistema de arquivos. O nome pode ser usado para listar, modificar ou remover a condição do sistema de arquivos.

--f fsname

Especifica o nome do sistema de arquivos que você deseja monitorar.

--c condition_type

Especifica o tipo de condição que deve ser monitorado. O parâmetro condition_type consiste em um tipo de condição seguido por atributos delimitados por vírgula. Para modificar valores de atributos, use a opção -u e especifique os atributos que devem ser alterados.

--b nome_da_ação

Especifica um nome exclusivo para uma ação. O nome da ação pode ser usado para modificar ou para remover a ação.

--B nome_da_ação

Remove a ação especificada.

--k action_type

Especifica a ação que deve ser realizada quando a condição se torna verdadeira. O parâmetro action_type consiste no tipo de ação seguido por atributos delimitados por vírgula. Para modificar atributos do tipo de ação, use a opção -u e especifique os atributos que devem ser alterados.

Nota: É possível definir apenas uma ação quando uma nova condição de sistema de arquivos é criada. Use a sinalização -u para adicionar mais ações à condição. Se nenhuma ação for configurada para uma condição, o evento será logado em arquivos de rastreio quando a condição se tornar verdadeira.

--i intervalo

Especifica o intervalo, em segundos, no qual a condição é avaliada.

--m [0|1]

Ativa ou desabilita o monitoramento do sistema de arquivos. Os valores válidos são os seguintes:

1: Permite o monitoramento do sistema de arquivos.
0: Desabilita o monitoramento do sistema de arquivos.

--e [0|1]

Ativa ou desativa o registro de erros. Os valores válidos são os seguintes:

1: Uma entrada de log de erro é criada quando a condição se torna verdadeira.
0: O registro de erros é desativado quando a condição se torna verdadeira.

Status de saída

0: O comando foi concluído com êxito.
1: Ocorreu um erro.

Exemplos

Para listar todas as condições de monitoramento para sistema de arquivos, digite o seguinte comando:
```
ctmonfs -l
```
Para monitorar o espaço do sistema de arquivos (fsspace) e para executar o comando /tmp/mycleanup quando a porcentagem de espaço livre for menor que 10%, digite o seguinte comando:
```
ctmonfs -a -n "var mon" -f "/var" -c "fsspace,method=free_percent,threshold_free_percent=10" 
-b "run cleanup" -k "useraction,path=/tmp/mycleanup" -i 1800 -m 1 -e 1
```
Para modificar o intervalo no qual a condição é avaliada, digite o seguinte comando:
```
ctmonfs -u -n "var mon" -i 900
```
Para modificar o valor de atributo path de uma ação existente (run cleanup), digite o seguinte comando:
```
ctmonfs -u -n "var mon" -b "run cleanup" -k "path=/tmp/varcleanup"
```
Para remover uma ação, digite o seguinte comando:
```
ctmonfs -u -n "var mon" -B "run cleanup"
```
Para remover uma condição de sistema de arquivos, digite o seguinte comando:
```
ctmonfs -r -n "var mon"
```
Para configurar ou modificar a prioridade de uma ação existente (run cleanup), digite o seguinte comando:
```
ctmonfs -u -n "var mon" -b "run cleanup" -k "priority=1"
```

Local

/opt/rsct/bin/ctmonfs: Contém o comando ctmonfs .

Arquivos

/var/ct/cfg/fsmon.cfg: Contém as configurações de configuração para monitoramento de um sistema de arquivos.