Tareas de secuencia de comandos de RCM

En las siguientes secciones se describen las tareas de secuencia de comandos de RCM para los desarrolladores de aplicaciones y administradores de sistemas.

Secuencia de comandos de RCM de desarrollador de aplicaciones (mapa de tareas)

En el siguiente mapa de tareas se describen las tareas de un desarrollador de aplicaciones que está creando una secuencia de comandos de RCM.

Secuencia de comandos de RCM de administrador del sistema (mapa de tareas)

En el mapa de tareas siguiente se describen las tareas de un administrador del sistema que está creando una secuencia de comandos de RCM para personalizar un sitio.

Nombre de una secuencia de comandos de RCM

A una secuencia de comandos se le debe asignar el nombre proveedor,servicio cuando se aplique lo siguiente:

vendor

Es el símbolo de cotización del proveedor que proporciona la secuencia de comandos, o cualquier nombre distintivo que identifique al proveedor.

servicio

Es el nombre del servicio que representa la secuencia de comandos.

Instalación o eliminación de una secuencia de comandos de RCM

Para instalar o eliminar una secuencia de comandos de RCM debe ser un administrador. Utilice esta tabla para determinar dónde debe instalar la secuencia de comandos de RCM.

Tabla 6-1 Directorios de secuencia de comandos de RCM

Cómo instalar una secuencia de comandos de RCM

1. Conviértase en un administrador.
2. Copie la secuencia de comandos en el directorio adecuado.

   Consulte la Tabla 6-1.

   Por ejemplo:

   # cp ABC,sample.pl /usr/lib/rcm/scripts

3. Cambie el ID de usuario y el ID de grupo de la secuencia de comandos por los valores deseados.

   # chown user:group /usr/lib/rcm/scripts/ABC,sample.pl

4. Envíe SIGHUP al daemon de RCM.

   # pkill -HUP -x -u root rcm_daemon

Cómo eliminar una secuencia de comandos de RCM

1. Conviértase en un administrador.
2. Elimine la secuencia de comandos del directorio de secuencia de comandos de RCM.

   Por ejemplo:

   # rm /usr/lib/rcm/scripts/ABC,sample.pl

3. Envíe SIGHUP al daemon de RCM.

   # pkill -HUP -x -u root rcm_daemon

Cómo probar una secuencia de comandos de RCM

1. Establezca las variables de entorno, como RCM_ENV_FORCE , en el shell de línea de comandos, antes de ejecutar la secuencia de comandos.

   Por ejemplo, en el shell Korn, use lo siguiente:

   $ export RCM_ENV_FORCE=TRUE

2. Pruebe la secuencia de comandos ejecutando los comandos de la secuencia de comandos manualmente desde la línea de comandos.

   Por ejemplo:

   $ script-name scriptinfo
   $ script-name register
   $ script-name preremove resource-name
   $ script-name postremove resource-name

3. Asegúrese de que cada comando de la secuencia de comandos de RCM de su secuencia de comandos imprima la salida adecuada en stdout.
4. Instale la secuencia de comandos en el directorio de secuencia de comandos adecuado.

   Para obtener más información, consulte Cómo instalar una secuencia de comandos de RCM.

5. Pruebe la secuencia de comandos iniciando una operación de eliminación dinámica.

   Por ejemplo, supongamos que la secuencia de comandos registra el dispositivo, /dev/dsk/c1t0d0s0. Pruebe estos comandos.

   $ cfgadm -c unconfigure c1::dsk/c1t0d0
   $ cfgadm -f -c unconfigure c1::dsk/c1t0d0
   $ cfgadm -c configure c1::dsk/c1t0d0

   ---

   Precaución - Asegúrese de estar familiarizado con estos comandos, ya que pueden alterar el estado del sistema y causar fallos del sistema.

   ---

Ejemplo de secuencia de comandos de RCM de copia de seguridad en cinta

En este ejemplo se muestra cómo usar una secuencia de comandos de RCM para hacer copias de seguridad en cinta.

Qué hace la secuencia de comandos de RCM de copia de seguridad en cinta

La secuencia de comandos de RCM de copia de seguridad en cinta efectúa los pasos siguientes:

1. Configura una tabla de distribución de comandos de RCM.

2. Llama a la rutina de distribución que corresponde al comando de RCM especificado y sale con el estado 2 para los comandos RCM no implementados.

3. Configura la sección scriptinfo.

   rcm_script_func_info=Tape backup appl script for DR

4. Registra todas las unidades de cinta en el sistema imprimiendo todos los nombres de dispositivos de unidad de cinta en stdout.

   rcm_resource_name=/dev/rmt/$f

   Si se produce un error, la secuencia de comandos imprime la información de error en stdout .

   rcm_failure_reason=$errmsg

5. Configura la información de recursos para el dispositivo de cinta.

   rcm_resource_usage_info=Backup Tape Unit Number $unit

6. Configura la información de preremove comprobando si la aplicación de copia de seguridad está utilizando el dispositivo. Si la aplicación de copia de seguridad no está utilizando el dispositivo, la operación de reconfiguración dinámica continúa. Si la aplicación de copia de seguridad está utilizando el dispositivo, la secuencia de comandos comprueba RCM_ENV_FORCE . Si RCM_ENV_FORCE está establecido en FALSE, la secuencia de comandos deniega la operación de reconfiguración dinámica e imprime el siguiente mensaje:

   rcm_failure_reason=tape backup in progress pid=...

   Si RCM_ENV_FORCE está establecido en TRUE, la aplicación de copia de seguridad se detiene y la operación de reconfiguración continúa.

Salidas de casos de reconfiguración de copia de seguridad en cinta

A continuación se muestran las diversas salidas que se obtienen si se utiliza el comando cfgadm para eliminar un dispositivo de cinta sin la secuencia de comandos de RCM.

• Si utiliza el comando cfgadm y la aplicación de copia de seguridad no está utilizando el dispositivo de cinta, la operación se realiza correctamente.

• Si utiliza el comando cfgadm y la aplicación de copia de seguridad está utilizando el dispositivo de cinta, la operación falla.

A continuación se muestran las diversas salidas que se obtienen si se utiliza el comando cfgadm para eliminar un dispositivo de cinta con la secuencia de comandos de RCM.

• Si utiliza el comando cfgadm y la aplicación de copia de seguridad no está utilizando el dispositivo de cinta, la operación se realiza correctamente.

• Si utiliza el comando cfgadm sin la opción - f y la aplicación de copia de seguridad está utilizando el dispositivo de cinta, la operación falla con un mensaje de error similar al siguiente:

  tape backup in progress pid=...

• Si utiliza el comando cfgadm -f y la aplicación de copia de seguridad está utilizando el dispositivo de cinta, la secuencia de comandos detiene la aplicación de copia de seguridad y la operación de cfgadm se lleva a cabo correctamente.

Ejemplo de secuencia de comandos de RCM de copia de seguridad en cinta

#! /usr/bin/perl -w
   #
   # A sample site customization RCM script.
   #
   # When RCM_ENV_FORCE is FALSE this script indicates to RCM that it cannot
   # release the tape drive when the tape drive is being used for backup.
   #
   # When RCM_ENV_FORCE is TRUE this script allows DR removing a tape drive
   # when the tape drive is being used for backup by killing the tape
   # backup application.
   #
    
    use strict;
    
    my ($cmd, %dispatch);
    $cmd = shift(@ARGV);
# dispatch table for RCM commands
    %dispatch = (
            "scriptinfo"    =>      \&do_scriptinfo,
            "register"      =>      \&do_register,
            "resourceinfo"  =>      \&do_resourceinfo,
            "queryremove"   =>      \&do_preremove,
            "preremove"     =>      \&do_preremove
    );
    
    
    if (defined($dispatch{$cmd})) {
            &{$dispatch{$cmd}};
    } else {
            exit (2);
    }
    
    sub do_scriptinfo
    {
            print "rcm_script_version=1\n";
            print "rcm_script_func_info=Tape backup appl script for DR\n";
            exit (0);
    }
    
    sub do_register
{
            my ($dir, $f, $errmsg);
    
            $dir = opendir(RMT, "/dev/rmt");
            if (!$dir) {
                 $errmsg = "Unable to open /dev/rmt directory: $!";
                 print "rcm_failure_reason=$errmsg\n";
                 exit (1);
            }
    
            while ($f = readdir(RMT)) {
                # ignore hidden files and multiple names for the same device
                if (($f !~ /^\./) && ($f =~ /^[0-9]+$/)) {
                        print "rcm_resource_name=/dev/rmt/$f\n";
                    }
                    
            }
    
            closedir(RMT);
            exit (0);
    }
sub do_resourceinfo
    {
      my ($rsrc, $unit);
    
      $rsrc = shift(@ARGV);
      if ($rsrc =~ /^\/dev\/rmt\/([0-9]+)$/) {
           $unit = $1;
           print "rcm_resource_usage_info=Backup Tape Unit Number $unit\n";
           exit (0);
       } else {
           print "rcm_failure_reason=Unknown tape device!\n";
            exit (1);
        }
    }
    
    sub do_preremove
    {
            my ($rsrc);
    
            $rsrc = shift(@ARGV);
    
            # check if backup application is using this resource
            #if (the backup application is not running on $rsrc) {
                    # allow the DR to continue
            #        exit (0);
            #}
            #
            # If RCM_ENV_FORCE is FALSE deny the operation.
            # If RCM_ENV_FORCE is TRUE kill the backup application in order
            # to allow the DR operation to proceed
            #
            if ($ENV{RCM_ENV_FORCE} eq 'TRUE') {
                 if ($cmd eq 'preremove') {
                         # kill the tape backup application
                 }
                 exit (0);
            } else {
               #
               # indicate that the tape drive can not be released
               # since the device is being used for backup by the
               # tape backup application
               #
               print "rcm_failure_reason=tape backup in progress pid=...\n"
;
               exit (3);
            }
    }