Mandato snap

Finalidad

Recopila información sobre la configuración del sistema.

Sintaxis

snap [-@] [ -a ][-z "product_name=prd_name,..." | "class=myclass,.." | ALL] [-M Tiempo de espera][ -A ] [ -b ] [ -B ] [ -c ] [ -C ] [ -D ] [ -f ] [ -F] [ -g ] [ -G ] [ -i ] [ -k ] [ -l ] [ -L ][ -n ] [ -N ] [ -p ] [ -r ] [ -R ] [ -s ] [ -S ] [ -t ] [ -T Nombre de archivo ][-u user1,....] [ -w ] [ -X ] [ -Y ][ -o OutputDevice ] [ -d Dir ] [ -v Component ] [ ' -O FileSplitSize ] [ -P Files ] [ script1 script2... | All | file:filepath ][-U]

snap -e [ -m Lista de nodos ] [-d Dir ]

snap -z ADD ["product_name=prod_name" "class=myclass" "/tmp/myprod_myscript -a"]

snap -z DELETE ["nombre_producto = nombre_producto" ]

Descripción

Utilice el comando snap -o /dev/rfd0 para copiar la imagen comprimida en un disquete. Utilice el comando snap -o /dev/rmt0 para copiar la imagen a cinta.

El comando snap -g recoge información general del sistema, incluyendo la siguiente:

• Informe de error
• Copia de la base de datos de Object Data Manager (ODM) personalizada
• Archivo de rastreo
• Entorno de usuario
• Cantidad de memoria física y espacio de paginación
• Información de dispositivo y atributo
• Información de usuario de seguridad
• Información de parámetros de configuración y ajuste del sistema

La salida del comando snap -g se escribe en el archivo /tmp/ibmsupt/general/general.snap.

El mandato snap comprueba el espacio disponible en el directorio /tmp/ibmsupt , el directorio predeterminado para la salida del mandato snap . Puede escribir la salida en otro directorio utilizando el distintivo -d . Si no hay espacio suficiente para contener la salida del mandato snap , debe expandir el sistema de archivos.

Cada ejecución del mandato snap añade información a los archivos creados anteriormente. Utilice el distintivo -r para eliminar la información recopilada y guardada anteriormente.

Distintivos

Parámetros

Argumentos

Los nombres de los scripts de terceros que se van a ejecutar se especifican como parámetros en snap. Un parámetro puede ser una sola palabra o una lista de palabras entre comillas. Cuando los parámetros se especifican entre comillas, el primer parámetro de la lista representa el nombre del script y las palabras siguientes representan los argumentos que deben pasarse al script.

Cuando se especifica All como parámetro, se ejecutan todos los scripts del repositorio de scripts. No se pueden pasar parámetros de script en este caso.

Si se utiliza la palabra clave file: y va seguida inmediatamente de una vía de acceso a un archivo, dicho archivo se lee para que los scripts se ejecuten. Cada línea del archivo representa un script y parámetros opcionales para el script.

scripts snap

Un script de terceros debe ser ejecutable en /usr/lib/ras/snapscriptsy debe seguir las directrices que se describen a continuación. Cuando se llama durante el paso 1, un script debe devolver su estimación de tamaño a snap. En el paso 2, recopila los datos y los guarda según lo especificado por snap.

El script debe leer y utilizar las siguientes variables de entorno, SNAPDIR, PASSNO, SCRIPTSIZE y SCRIPTLOG.

Los scripts o mandatos también pueden utilizar la variable SNAPDEBUGDATA para obtener información sobre los datos de depuración recopilados por el script snap. Esta variable tiene un nombre separado por comas de los productos para los que el mandato snap recopila los datos durante la ejecución.

Todos los archivos de salida deben grabarse en $SNAPDIR. Este es el directorio donde el script debe guardar su salida. La variable PASSNO contiene la fase snap durante la cual se llama al script. Durante la primera pasada, el script debe calcular una estimación de tamaño para los datos que escribirá durante la segunda pasada. A continuación, escribirá esa estimación numérica en el archivo al que apunta $SCRIPTSIZE. El valor guardado en el archivo debe ser decimal. snap pasa la vía de acceso a un archivo de registro donde se deben guardar todos los datos de depuración para el script. La salida estándar y el error estándar no deben ser redirigidos por el script, porque ' snap guardará la salida estándar y el error estándar en $SNAPDIR/ 'ScriptName '.out y $SNAPDIR/ 'ScriptName '.err, respectivamente.

#!/usr/bin/ksh


if [ "$PASSNO" = 1 ]
then
         (( size=99999 ))
        .... 
        # this is where code to do the size estimation should go.
        ....
        echo $size > $SCRIPTSIZE

else if [ "$PASSNO" = 2 ]
then
        # debug information should go to $SCRIPTLOG
        echo "Debug Data" >> $SCRIPTLOG

        # .....where the work to collect the data takes place
        # ...

        # The data collected should be written to $SNAPDIR        .
        touch $SNAPDIR/foo_output1
        touch $SNAPDIR/foo_output2
fi
fi

División de la salida de snap

Si se divide, la salida de snap podría ser similar a la siguiente:

% ls -l
total 112048
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xaa
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xab
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xac
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xad
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xae
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xaf
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xag
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xah
-rw-r--r--   1 lmic     adm         6291456 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xai
-rw-r--r--   1 lmic     adm          744518 Nov 26 09:56 snap.hastings.112603095649.pax.Z.xaj

Ejecución de scripts de terceros

Un mandato o script de recopilación de datos de depuración de producto externo es un ejecutable autónomo. El script se registra con la infraestructura snap antes de que se pueda utilizar para recopilar datos de depuración definidos por el usuario. Estos scripts se pueden desregistrar según la discreción del usuario.

A continuación se muestra la clase ODM definida en el sistema.

#define DEFAULTSIZE 256
#define DATA_VALUESIZE 1024

class snap_config {
        char product_name[DEFAULTSIZE]; key
        char class[DEFAULTSIZE];key
        char command_path[DATA_VALUESIZE];
        vchar sc_reserved1[DATA_VALUESIZE];
        vchar sc_reserved2[DATA_VALUESIZE];
}

Registro de script de depuración de terceros con infraestructura de Snap

Anulación del registro de scripts de depuración de terceros de la infraestructura de Snap

Ejemplos

1. Especifique el mandato siguiente para recopilar toda la información de configuración del sistema:

   snap -a

   La salida de este mandato se graba en el directorio /tmp/ibmsupt .
2. Especifique el mandato siguiente para crear una imagen pax de todos los archivos contenidos en el directorio /tmp/ibmsupt :

   snap -c

3. Especifique el mandato siguiente para recopilar información general de configuración del sistema, incluida la salida del mandato lslpp -hac :

   snap -g -o /dev/rfd0

   La salida se graba en los archivos /tmp/ibmsupt/general/lslpp.hac y /tmp/ibmsupt/general/general.snap . Este mandato también escribe la información del sistema en un disquete extraíble.
4. Especifique el mandato siguiente para recopilar información específica de HACMP de los nodos node1 y node2 que pertenecen a un único clúster:

   snap -e -m node1,node2

   La salida se graba en el directorio /tmp/ibmsupt/hacmp .
5. Para ejecutar los scripts foo1, foo2 y foo3. donde foo1 no toma ningún argumento, foo2 toma tres argumentos y foo3 toma un argumento, escriba lo siguiente:

   snap  foo1 "foo2 -x -y 3" "foo3 6"

   La salida se graba en /tmp/ibmsupt/snapscripts/foo1, /tmp/ibmsupt/snapscripts/foo2 y /tmp/ibmsupt/snapscripts/foo3 suponiendo que el directorio de destino es el predeterminado, /tmp/ibmsupt.
6. Para especificar el parámetro All para ejecutar todos los scripts, escriba:

   snap All

   Nota: No se pasan parámetros en este caso.
7. Para especificar la vía de acceso a un archivo que contiene el nombre y la lista de parámetros opcionales de los scripts a ejecutar, escriba:

   snap file:/tmp/scriptnames

   Un archivo de entrada de ejemplo para ejecutar los scripts del ejemplo 5:

   foo1 
   foo2 -x -y 3
   foo6

8. Si desea dividir la salida de snap en 4MB archivos, escriba:

   snap -a -c -O 4

9. Para enviar sólo los datos de HACMP snap -e de los nodos node1 y node2, especifique el mandato siguiente:

   snap -e -m node1,node2
   snap -c

   Envíe el archivo <paxpax.za IBM siguiendo las instrucciones del representante del servicio técnico.

10. Para enviar todos los datos de snap desde los nodos node1 y node2, especifique los mandatos siguientes:

    snap -e -m node1,node2
    snap -a
    snap -c 

    Envíe el archivo <paxpax.za IBM siguiendo las instrucciones del representante del servicio técnico.

11. Para registrar un script de depuración presente en el directorio /usr/lpp/abc/debug_abc del producto abc, en la clase storage especifique el mandato siguiente:

    snap -z ADD "product_name=abc" "class=storage" "command_path=/usr/lpp/abc/debug_abc -a"

12. Para anular el registro de un script de depuración del producto abc, especifique el mandato siguiente:

    snap -z DELETE "product_name=abc"

13. Para recopilar datos de depuración de varios productos, especifique el mandato siguiente:

    snap -z "product_name=abc, product_name=def"

Archivos