IBMpublic.dhe.ibm.com/systems/support/system_x_pdf/00y8828... · 2013. 12. 3. · Crear grupo de...

754
IBM System Storage DS Storage Manager Versión 10 Guía de programación de la interfaz de línea de mandatos y de los mandatos de script GA32-0961-06

Transcript of IBMpublic.dhe.ibm.com/systems/support/system_x_pdf/00y8828... · 2013. 12. 3. · Crear grupo de...

  • IBM System Storage DS Storage Manager Versión 10

    Guía de programación de la interfaz delínea de mandatos y de los mandatosde script

    GA32-0961-06

    ���

  • NotaAntes de utilizar esta información y el producto al que da soporte, lea la información de “Avisos” en la página 723.

    Esta edición se aplica a la versión 10 modificación 35 de IBM DS Storage Manager y a todos los releases ymodificaciones posteriores hasta que se diga lo contrario en nuevas ediciones.

    Esta edición sustituye a GA32-0961-05.

    © Copyright IBM Corporation 2008, 2013.

  • Contenido

    Figuras . . . . . . . . . . . . . . . xi

    Tablas . . . . . . . . . . . . . . . xiii

    Acerca de este documento . . . . . . xvLo nuevo en esta guía . . . . . . . . . . . xvSoporte de software y firmware de las seriesDS3000, DS4000 y DS5000 y DCS . . . . . . . xixQuién debe leer este documento . . . . . . . xixAvisos utilizados en este documento . . . . . . xxObtener información, ayuda y servicios . . . . . xx

    Antes de llamar . . . . . . . . . . . . xxUtilización de la documentación . . . . . . xxBúsqueda de software, firmware de controladory archivos readme de Storage Manager . . . . xxiSitios web esenciales para obtener informaciónde soporte de las series DS3000, DS4000, DS5000,DS5020 y DCS . . . . . . . . . . . . xxiSoftware service and support . . . . . . . xxiiSoporte y servicio de hardware . . . . . . xxiiiInformación de contacto de Taiwan . . . . . xxiiiSistemas de protección contra incendios . . . xxiii

    Capítulo 1. Acerca de la interfaz de líneade mandatos. . . . . . . . . . . . . 1Cómo utilizar la interfaz de línea de mandatos . . . 1

    Notas de uso . . . . . . . . . . . . . 2Mandatos de CLI . . . . . . . . . . . . 2Terminales de la línea de mandatos. . . . . . 4Consideraciones sobre el formato . . . . . . 8Informes detallados de errores . . . . . . . 8Exit status . . . . . . . . . . . . . . 14Ejemplos de uso . . . . . . . . . . . . 16

    Capítulo 2. Acerca de los mandatos descript . . . . . . . . . . . . . . . 19Estructura de los mandatos de script . . . . . . 20Sinopsis de los mandatos de script . . . . . . 21Elementos de sintaxis recurrente . . . . . . . 23Directrices de uso . . . . . . . . . . . . 30Adición de comentarios a un archivo de script . . 30

    Capítulo 3. Mandatos de script . . . . 33Convenciones de asignación de nombres . . . . 33Niveles de compatibilidad de firmware . . . . . 34Requisitos de hardware para la compatibilidad delfirmware . . . . . . . . . . . . . . . 35Reglas de formato para los mandatos de script . . 35Mandatos de las series DS3000, DS4000, DS5000 yDCS con niveles de firmware mínimos . . . . . 36Activar Enhanced Global Mirror . . . . . . . 68Activar la función Enhanced Remote Mirroring . . 68Activar puerto de host. . . . . . . . . . . 71Activar iniciador iSCSI . . . . . . . . . . 72

    Activar firmware de subsistema de almacenamiento 72Activación de Enhanced Remote Mirroring . . . . 72Adición de una unidad lógica al grupo de EnhancedGlobal Mirror. . . . . . . . . . . . . . 73Añadir miembros al grupo de consistencia . . . . 73Adición de unidades a la Memoria caché de lecturade rendimiento . . . . . . . . . . . . . 75Configurar automáticamente el subsistema dealmacenamiento . . . . . . . . . . . . . 76Configurar automáticamente los repuestos activosdel subsistema de almacenamiento . . . . . . 80Cancelación de inversión de roles de grupos deEnhanced Global Mirror . . . . . . . . . . 80Modificar tipo de aplicación de la memoria caché delectura de rendimiento. . . . . . . . . . . 81Comprobación de consistencia del grupo deEnhanced Global Mirror . . . . . . . . . . 81Comprobar paridad de unidad lógica. . . . . . 82Comprobar estado de duplicación remota . . . . 83Comprobar la consistencia del repositorio . . . . 83Comprobación de conectividad del subsistema dealmacenamiento . . . . . . . . . . . . . 85Comprobación del estado de Enhanced RemoteMirroring . . . . . . . . . . . . . . . 85Borrar error de Enhanced Global Mirror . . . . . 85Borrar estadísticas de canal de unidad . . . . . 86Borrar reservas de unidad lógica . . . . . . . 86Borrar sectores ilegibles de unidad lógica . . . . 87Borrar configuración de subsistema dealmacenamiento . . . . . . . . . . . . . 87Borrar la captura de datos de diagnóstico desubsistemas de almacenamiento . . . . . . . 88Borrar la captura de datos de diagnóstico delsubsistema de almacenamiento . . . . . . . . 88Borrar registro cronológico de sucesos delsubsistema de almacenamiento . . . . . . . . 89Borrar área pendiente de firmware del subsistemade almacenamiento . . . . . . . . . . . . 89Borrar el modo de recuperación del subsistema dealmacenamiento . . . . . . . . . . . . . 90Configurar la recogida automática del paquete desoporte . . . . . . . . . . . . . . . . 90Convertir una unidad lógica FlashCopy en un grupode Enhanced FlashCopy . . . . . . . . . . 91Crear subsistema . . . . . . . . . . . . 91Creación de grupo de Enhanced Global Mirror . . 95Crear grupo de consistencia . . . . . . . . . 96Crear Enhanced FlashCopy de un grupo deconsistencia . . . . . . . . . . . . . . 99Crear imagen de Enhanced FlashCopy de un grupode consistencia . . . . . . . . . . . . . 100Crear unidad lógica de Enhanced FlashCopy delgrupo de consistencia . . . . . . . . . . 101Crear correlación de la unidad lógica de EnhancedFlashCopy del grupo de consistencia . . . . . 103Crear agrupación de discos . . . . . . . . . 104

    © Copyright IBM Corp. 2008, 2013 iii

  • Crear grupo de Enhanced FlashCopy . . . . . 110Crear imagen de Enhanced FlashCopy . . . . . 117Crear una unidad lógica de Enhanced FlashCopy 118Crear unidad lógica FlashCopy . . . . . . . 119Crear host . . . . . . . . . . . . . . 126Crear grupo de host . . . . . . . . . . . 127Crear puerto de host . . . . . . . . . . . 128Crear iniciador iSCSI . . . . . . . . . . . 129Crear unidad lógica RAID (Selección de unidadautomática) . . . . . . . . . . . . . . 130Crear unidad lógica de RAID (selección en base alespacio libre) . . . . . . . . . . . . . 134Crear unidad lógica RAID (Selección de unidadmanual) . . . . . . . . . . . . . . . 137Crear una unidad lógica en una agrupación dediscos . . . . . . . . . . . . . . . . 142Crear unidad lógica de Enhanced FlashCopy desolo lectura . . . . . . . . . . . . . . 146Crear duplicación remota . . . . . . . . . 147Creación de memoria caché de SSD . . . . . . 149Crear clave de seguridad del subsistema dealmacenamiento . . . . . . . . . . . . 151Creación de Enhanced Remote Mirroring . . . . 152Crear copia de volumen . . . . . . . . . . 153Desactivar duplicación remota. . . . . . . . 155Desactivar Enhanced Global Mirror . . . . . . 155Desactivar Enhanced Remote Mirroring . . . . 156Suprimir subsistema . . . . . . . . . . . 156Suprimir grupo de Enhanced Global Mirror . . . 156Suprimir grupo de consistencia . . . . . . . 157Suprimir una unidad lógica de EnhancedFlashCopy de un grupo de consistencia . . . . 157Suprimir la imagen de Enhanced FlashCopy delgrupo de consistencia . . . . . . . . . . 158Suprimir agrupación de discos . . . . . . . 159Suprimir el grupo de Enhanced FlashCopy . . . 160Suprimir imagen de Enhanced FlashCopy . . . . 161Suprimir una unidad lógica de EnhancedFlashCopy . . . . . . . . . . . . . . 163Suprimir la unidad lógica de FlashCopy . . . . 164Eliminar host . . . . . . . . . . . . . 164Eliminar grupo de host . . . . . . . . . . 165Eliminar puerto de host . . . . . . . . . . 165Eliminar iniciador iSCSI . . . . . . . . . . 166Eliminar unidad lógica . . . . . . . . . . 166Supresión de VolumeGroup . . . . . . . . 167Suprimir una unidad lógica de una agrupación dedisco . . . . . . . . . . . . . . . . 167Supresión de la memoria caché de lectura derendimiento . . . . . . . . . . . . . . 168Diagnosticar controlador . . . . . . . . . 169Diagnosticar cable de host iSCSI de controlador 170Diagnosticar duplicación remota . . . . . . . 172Diagnóstico de Enhanced Remote Mirroring . . . 172Inhabilitar gestión de clave de seguridad externa 172Deshabilitar FlashCopy . . . . . . . . . . 173Inhabilitar función del subsistema dealmacenamiento . . . . . . . . . . . . 174Mostrar configuración automática de la recogidadel paquete de soporte . . . . . . . . . . 175

    Mostrar planificación de la recogida del paquete desoporte . . . . . . . . . . . . . . . 176Descargar firmware de unidad . . . . . . . 176Descargar valores de configuración de alojamiento 178Descargar firmware de tarjeta medioambiental . . 178Descargar firmware de fuente de alimentación . . 179Descargar firmware de unidad del subsistema dealmacenamiento . . . . . . . . . . . . 180Descargar firmware/NVSRAM del subsistema dealmacenamiento . . . . . . . . . . . . 181Descargar NVSRAM del subsistema dealmacenamiento . . . . . . . . . . . . 182Habilitar seguridad de subsistema . . . . . . 182Habilitar la transferencia de datos del controlador 183Habilitar la seguridad de la agrupación de discos 183Habilitar gestión de clave de seguridad externa 184Habilitar seguridad de matriz . . . . . . . . 184Habilitar o inhabilitar la Memoria caché de lecturade rendimiento para un volumen. . . . . . . 185Habilitar memoria caché de lectura de rendimientode volumen de Enhanced FlashCopy . . . . . 186Habilitar clave de característica del subsistema dealmacenamiento . . . . . . . . . . . . 187Establecimiento de un par Enhanced GlobalMirrored . . . . . . . . . . . . . . . 188Exportar clave de seguridad del subsistema dealmacenamiento . . . . . . . . . . . . 189Importar clave de seguridad del subsistema dealmacenamiento . . . . . . . . . . . . 189Aumentar la capacidad de una unidad lógica enuna agrupación de disco . . . . . . . . . 190Inicializar una unidad lógica fina . . . . . . . 191Cargar base de datos de DBM de subsistema dealmacenamiento . . . . . . . . . . . . 193Localización de la memoria caché de lectura derendimiento . . . . . . . . . . . . . . 194Volver a copiar copia de volumen . . . . . . 194Recuperar unidad lógica RAID . . . . . . . 195Volver a crear la unidad lógica de repositorio deEnhanced Remote Mirroring . . . . . . . . 199Volver a crear clave de seguridad externa . . . . 202Volver a crear FlashCopy . . . . . . . . . 203Eliminar correlación de LUN de unidad lógica . . 204Eliminación de unidades de la memoria caché delectura de rendimiento . . . . . . . . . . 205Eliminar par Enhanced Global Mirroring(Duplicación global mejorada) de un grupoEnhanced Global Mirror . . . . . . . . . . 206Eliminar volumen del grupo de Enhanced GlobalMirror . . . . . . . . . . . . . . . . 207Eliminar correlación de LUN de unidad lógica . . 208Eliminar la unidad lógica de miembro del grupode consistencia . . . . . . . . . . . . . 209Eliminar duplicación remota . . . . . . . . 209Eliminar Enhanced Remote Mirroring . . . . . 209Eliminar copia de volumen . . . . . . . . . 210Renombrar una unidad lógica de EnhancedFlashCopy . . . . . . . . . . . . . . 210Renombrar la memoria caché de lectura derendimiento . . . . . . . . . . . . . . 211Reparar paridad de unidad lógica . . . . . . 212

    iv IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Sustituir unidad de disco . . . . . . . . . 212Restablecimiento de las estadísticas del grupoEnhanced Global Mirror . . . . . . . . . . 213Restablecer controlador . . . . . . . . . . 215Restablecimiento de la dirección IP iSCSI . . . . 215Restablecer fecha de instalación de batería desubsistema de almacenamiento . . . . . . . 216Restablecer datos de diagnóstico de subsistema dealmacenamiento . . . . . . . . . . . . 217Restablecer línea base iSCSI de subsistema dealmacenamiento . . . . . . . . . . . . 217Restablecer distribución de unidades lógicas desubsistema de almacenamiento . . . . . . . 218Restablecer línea base RLS de subsistema dealmacenamiento . . . . . . . . . . . . 218Restablecer línea base de SAS PHY de subsistemade almacenamiento . . . . . . . . . . . 218Restablecer línea base SOC de subsistema dealmacenamiento . . . . . . . . . . . . 219Reanudar grupo de Enhanced Global Mirror . . . 219Reanudar la unidad lógica de Enhanced FlashCopydel grupo de consistencia . . . . . . . . . 220Reanudar la operación de retrotracción de imagende Enhanced FlashCopy . . . . . . . . . . 221Reiniciar una unidad lógica de EnhancedFlashCopy . . . . . . . . . . . . . . 222Reanudar las operaciones de retrotracción deFlashCopy . . . . . . . . . . . . . . 224Reanudar duplicación remota . . . . . . . . 224Reanudación de la memoria caché de lectura derendimiento . . . . . . . . . . . . . . 225Reavivar matriz . . . . . . . . . . . . 226Reavivar unidad de disco . . . . . . . . . 226Revivir el grupo de Enhanced FlashCopy . . . . 227Revivir la unidad lógica de Enhanced FlashCopy 227Reavivar matriz . . . . . . . . . . . . 228Guardado de las estadísticas del grupo EnhancedGlobal Mirror . . . . . . . . . . . . . 228Guardar NVSRAM de controlador . . . . . . 231Guardar estado de diagnóstico de aislamiento deanomalía de canal de unidad de disco . . . . . 231Guardar registro cronológico de unidad . . . . 232Guardar registro cronológico de alojamiento . . . 232Guardar configuración de subsistema dealmacenamiento . . . . . . . . . . . . 233Guardar base de datos de DBM de subsistema dealmacenamiento . . . . . . . . . . . . 234Guardar el archivo de información del validadorDBM en el subsistema de almacenamiento . . . 234Guardar datos de diagnóstico de subsistema dealmacenamiento . . . . . . . . . . . . 235Guardar la captura de datos de diagnóstico delsubsistema de almacenamiento . . . . . . . 236Guardar sucesos de subsistema de almacenamiento 236Guardar inventario de firmware de subsistema dealmacenamiento . . . . . . . . . . . . 237Guardar estadísticas de InfiniBand del subsistemade almacenamiento . . . . . . . . . . . 237Guardar estadísticas iSCSI de subsistema dealmacenamiento . . . . . . . . . . . . 238

    Guardar estadísticas de rendimiento de subsistemade almacenamiento . . . . . . . . . . . 239Guardar recuentos RLS de subsistema dealmacenamiento . . . . . . . . . . . . 239Guardar recuentos de SAS PHY de subsistema dealmacenamiento . . . . . . . . . . . . 240Guardar recuentos SOC de subsistema dealmacenamiento . . . . . . . . . . . . 240Guardar captura de estado de subsistema dealmacenamiento . . . . . . . . . . . . 241Guardar datos de soporte de subsistema dealmacenamiento . . . . . . . . . . . . 241Programar la configuración de la recogida delpaquete de soporte . . . . . . . . . . . 242Set subsystem . . . . . . . . . . . . . 244Establecer estado Forzado del subsistema . . . . 246Establecer un grupo de Enhanced Global Mirror 246Establecer atributos del grupo de consistencia . . 250Definir la unidad lógica de Enhanced FlashCopydel grupo de consistencia . . . . . . . . . 251Establecer controlador . . . . . . . . . . 252Establecer indicador de Acción de serviciopermitida de controlador . . . . . . . . . 255Definir la agrupación de discos . . . . . . . 256Definir la agrupación de discos (Modificar laagrupación de discos) . . . . . . . . . . 259Establecer indicador de Acción de serviciopermitida de cajón . . . . . . . . . . . 260Establecer estado de canal de unidad . . . . . 261Establecer repuesto en caliente de unidad de disco 262Establecer indicador de Acción de serviciopermitida de unidad de disco . . . . . . . . 262Establecer estado de unidad . . . . . . . . 263Establecer alarma de alojamiento . . . . . . . 264Establecer identificación de alojamiento . . . . 265Establecer indicador de Acción de serviciopermitida de alojamiento . . . . . . . . . 266Definir atributos de grupo de Enhanced FlashCopy 267Definir la exploración del soporte del grupo deEnhanced FlashCopy . . . . . . . . . . . 268Defina la programación del grupo de EnhancedFlashCopy . . . . . . . . . . . . . . 269Definir la exploración del soporte de la unidadlógica de Enhanced FlashCopy . . . . . . . 273Definir la capacidad de la unidad lógica delrepositorio de la unidad lógica de EnhancedFlashCopy . . . . . . . . . . . . . . 274Definir la capacidad de la unidad lógica derepositorio del grupo de Enhanced FlashCopy . . 275Establecer unidad lógica FlashCopy . . . . . . 275Establecer unidad de disco foránea como nativa 276Establecer host . . . . . . . . . . . . . 277Establecer canal de host . . . . . . . . . . 279Establecer grupo de host . . . . . . . . . 279Establecer puerto de host . . . . . . . . . 280Establecer iniciador iSCSI . . . . . . . . . 280Establecer propiedades de destino iSCSI . . . . 281Definir los atributos de la unidad lógica . . . . 282Definir los atributos de la unidad lógica . . . . 289Definir los atributos de unidad lógica para laagrupación de discos . . . . . . . . . . . 296

    Contenido v

  • Definir la correlación de la unidad lógica . . . . 302Establecer la unidad lógica de EnhancedFlashCopy de sólo lectura a una unidad lógica delectura y escritura . . . . . . . . . . . . 303Establecer duplicación remota . . . . . . . . 304Establecer sesión . . . . . . . . . . . . 306Establecer subsistema de almacenamiento . . . . 307Establecer posiciones de alojamiento de subsistemade almacenamiento . . . . . . . . . . . 310Establecer respuesta ICMP de subsistema dealmacenamiento . . . . . . . . . . . . 311Establecer dirección IPv4 de servidor iSNS desubsistema de almacenamiento . . . . . . . 312Establecer dirección IPv6 de servidor iSNS desubsistema de almacenamiento . . . . . . . 313Establecer puerto de escucha de servidor iSNS desubsistema de almacenamiento . . . . . . . 313Establecer actualización de servidor iSNS desubsistema de almacenamiento . . . . . . . 314Establecer ciclo de aprendizaje de subsistema dealmacenamiento . . . . . . . . . . . . 314Establecer modalidad de redundancia desubsistema de almacenamiento . . . . . . . 315Establecer clave de seguridad de subsistema dealmacenamiento . . . . . . . . . . . . 315Establecer hora de subsistema de almacenamiento 316Establecer Enhanced Remote Mirroring. . . . . 316Establecer los atributos de la unidad lógica fina 318Establecer la sesión de descubrimiento delsubsistema de almacenamiento sin nombrar . . . 319Establecer copia de volumen . . . . . . . . 320Mostrar subsistema . . . . . . . . . . . 321Mostrar dependencias de exportación desubsistema . . . . . . . . . . . . . . 321Mostrar dependencias de importación desubsistema . . . . . . . . . . . . . . 322Mostrar grupo de Enhanced Global Mirror(Duplicación global mejorada) . . . . . . . . 322Mostrar el progreso de la sincronización del grupoEnhanced Global Mirror . . . . . . . . . . 323Mostrar estado de diagnóstico de dispositivo decopia de seguridad de memoria caché . . . . . 324Mostrar estado de diagnóstico de memoria caché 325Mostrar grupo de consistencia . . . . . . . . 325Mostrar la imagen de Enhanced FlashCopy delgrupo de consistencia . . . . . . . . . . 326Mostrar controlador . . . . . . . . . . . 328Mostrar estado de diagnóstico de controlador . . 329Mostrar NVSRAM de controlador . . . . . . 329Mostrar sesiones iSCSI actuales . . . . . . . 330Mostrar la agrupación de discos . . . . . . . 330Mostrar unidad de disco . . . . . . . . . 331Mostrar estadísticas de canal de unidad . . . . 333Mostrar progreso de descarga de unidad . . . . 334Mostrar el grupo de Enhanced FlashCopy . . . . 334Mostrar imagen de Enhanced FlashCopy . . . . 336Mostrar las unidades lógicas de EnhancedFlashCopy . . . . . . . . . . . . . . 337Mostrar candidatos de unidad lógica de EnhancedRemote Mirroring . . . . . . . . . . . . 338

    Mostrar progreso de sincronización de unidadlógica de Enhanced Remote Mirroring . . . . . 339Mostrar estado de diagnóstico de tarjeta de interfazde host . . . . . . . . . . . . . . . 339Mostrar puertos de host . . . . . . . . . . 340Mostrar unidad lógica . . . . . . . . . . 340Mostrar progreso de acción de unidad lógica . . . 342Mostrar memoria caché de lectura de rendimiento 342Mostrar matriz . . . . . . . . . . . . . 343Muestra de exportación de la matriz . . . . . 344Mostrar dependencias de importación de matriz 344Mostrar estadísticas de rendimiento de unidadlógica . . . . . . . . . . . . . . . . 345Mostrar reservas de unidad lógica . . . . . . 345Mostrar subsistema de almacenamiento . . . . 346Mostrar configuración automática de subsistema dealmacenamiento . . . . . . . . . . . . 349Mostrar la captura de datos de diagnóstico desubsistemas de almacenamiento . . . . . . . 353Mostrar base de datos del subsistema dealmacenamiento DBM . . . . . . . . . . 353Mostrar la captura de datos de diagnóstico delsubsistema de almacenamiento . . . . . . . 353Mostrar características del subsistema dealmacenamiento . . . . . . . . . . . . 354Mostrar iniciadores iSCSI no configurados delsubsistema de almacenamiento . . . . . . . 354Mostrar topología de host de subsistema dealmacenamiento . . . . . . . . . . . . 355Mostrar perfil del subsistema de almacenamiento 355Mostrar correlaciones de LUN de subsistema dealmacenamiento . . . . . . . . . . . . 356Mostrar valores predeterminados de negociaciónde subsistema de almacenamiento . . . . . . 356Mostrar sectores ilegibles de subsistema dealmacenamiento . . . . . . . . . . . . 356Mostrar candidatos de volúmenes de EnhancedRemote Mirroring . . . . . . . . . . . . 357Mostrar el progreso de la sincronización delvolumen de Enhanced Remote Mirroring . . . . 358Mostrar serie . . . . . . . . . . . . . 358Mostrar unidad lógica fina . . . . . . . . . 358Mostrar los iniciadores iSCSI no configurados en elsubsistema de almacenamiento . . . . . . . 359Mostrar copia de volumen . . . . . . . . . 360Mostrar candidatos de origen de copia de volumen 360Mostrar candidatos de destino de copia devolumen . . . . . . . . . . . . . . . 361Iniciar defragmentación de subsistema . . . . . 361Iniciar exportación de subsistema. . . . . . . 362Iniciar importación de matriz . . . . . . . . 362Iniciar localización de subsistema. . . . . . . 363Iniciar sincronización de Enhanced Global Mirror 363Iniciar diagnóstico de dispositivo de copia deseguridad de memoria caché . . . . . . . . 364Iniciar diagnóstico de memoria caché . . . . . 366Iniciar la ubicación de la agrupación de discos . . 367Iniciar la operación de retrotracción del grupo deconsistencia de Enhanced FlashCopy . . . . . 368Iniciar diagnóstico de controlador . . . . . . 369Iniciar rastreo de controlador . . . . . . . . 371

    vi IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Iniciar diagnósticos de aislamiento de anomalía decanal de unidad . . . . . . . . . . . . 372Iniciar localización de canal de unidad . . . . . 373Iniciar inicialización de unidad de disco . . . . 374Iniciar localización de unidad . . . . . . . . 375Iniciar reconstrucción de unidad de disco . . . . 375Iniciar localización de alojamiento . . . . . . 376Iniciar la operación de retrotracción de la imagende Enhanced FlashCopy . . . . . . . . . . 376Iniciar sincronización de Enhanced RemoteMirroring. . . . . . . . . . . . . . . 378Iniciar la operación de retrotracción de FlashCopy 378Iniciar diagnóstico de tarjeta de interfaz de host 379Iniciar actualización de DHCP de iSCSI . . . . 381Iniciar defragmentación de matriz . . . . . . 382Iniciar exportación de matriz . . . . . . . . 382Iniciar importación de matriz . . . . . . . . 383Localizar matriz de inicio . . . . . . . . . 384Iniciar inicialización de unidad lógica . . . . . 384Iniciar borrado de unidad de disco segura. . . . 385Iniciar modelado de rendimiento de la Memoriacaché de lectura de rendimiento . . . . . . . 385Iniciar localización de subsistema dealmacenamiento . . . . . . . . . . . . 386Iniciar el diagnóstico de base de datos de laconfiguración del subsistema de almacenamiento . 387Iniciar la captura de los datos de diagnóstico delsubsistema de almacenamiento . . . . . . . 388Iniciar la actualización de servidor iSNS delsubsistema de almacenamiento . . . . . . . 389Detener localización de matriz. . . . . . . . 389Detener diagnóstico de dispositivo de copia deseguridad de memoria caché . . . . . . . . 389Detener diagnóstico de memoria caché . . . . . 390Detener el diagnóstico de base de datos de laconfiguración del subsistema de almacenamiento . 390Detener la operación de retrotracción de EnhancedFlashCopy del grupo de consistencia . . . . . 391Detener la unidad lógica de Enhanced FlashCopydel grupo de consistencia . . . . . . . . . 392Detener diagnóstico de controlador . . . . . . 392Detener ubicación de agrupación de discos . . . 393Detener diagnósticos de aislamiento de anomalíade canal de unidad . . . . . . . . . . . 393Detener localización de canal de unidad . . . . 393Detener localización de unidad . . . . . . . 394Detener localización de alojamiento . . . . . . 394Detener las imágenes de Enhanced FlashCopypendientes de un grupo de Enhanced FlashCopy . 394Detener la imagen de Enhanced FlashCopy . . . 395Detener la operación de retrotracción de unaimagen de Enhanced FlashCopy . . . . . . . 395Detener la unidad lógica de Enhanced FlashCopy 396Detener FlashCopy . . . . . . . . . . . 397Detener la operación de retrotracción de FlashCopy 398Detener diagnóstico de tarjeta de interfaz de host 398Detener sesión iSCSI del subsistema dealmacenamiento . . . . . . . . . . . . 399Detener el modelado de rendimiento de lamemoria caché de lectura de rendimiento . . . . 399Detener copia de volumen . . . . . . . . . 401

    Detener localización de matriz. . . . . . . . 401Detener las imágenes de Enhanced FlashCopypendientes del grupo de consistencia . . . . . 402Detener descarga de firmware de unidad desubsistema de almacenamiento . . . . . . . 402Detener localización de subsistema dealmacenamiento . . . . . . . . . . . . 402Detener copia de volumen . . . . . . . . . 403Suspender grupo de Enhanced Global Mirror . . 403Suspender duplicación remota. . . . . . . . 404Suspender la memoria caché de lectura derendimiento . . . . . . . . . . . . . . 405Suspender grupo de Enhanced Global Mirror . . 405Probar la conectividad de Enhanced Global MirrorGroup . . . . . . . . . . . . . . . . 406Validar clave de seguridad de subsistema dealmacenamiento . . . . . . . . . . . . 407Mandatos de script enumerados por función . . . 408

    Mandatos de subsistema . . . . . . . . 408Mandatos de Enhanced Global Mirroring . . . 409Mandatos de controlador . . . . . . . . 410Mandatos de base de datos . . . . . . . . 411Mandatos de captura de datos de diagnóstico 411Mandatos de agrupaciones de discos . . . . 412Mandatos de unidad de disco . . . . . . . 412Mandatos de alojamiento . . . . . . . . 413Mandatos de Enhanced FlashCopy . . . . . 413Mandatos de Enhanced Remote Mirroring. . . 415Mandatos de gestión de características . . . . 416Mandatos FlashCopy . . . . . . . . . . 416Mandatos de topología de host . . . . . . 416Mandatos iSCSI . . . . . . . . . . . 417Mandatos de unidad lógica (para unidadeslógicas finas y estándar de una agrupación dediscos). . . . . . . . . . . . . . . 417Mandatos de análisis de la unidad lógica derepositorio . . . . . . . . . . . . . 418Mandato de sesión . . . . . . . . . . 418Mandatos de la memoria caché de lectura derendimiento . . . . . . . . . . . . . 418Mandatos de subsistema de almacenamiento 419Mandatos de cadenas. . . . . . . . . . 422Mandatos de la recogida del paquete de soporte 422Mandatos de copia de volumen . . . . . . 422

    Capítulo 4. Configuración de unsubsistema de almacenamiento . . . 423Conceptos de configuración . . . . . . . . 424

    Controladores . . . . . . . . . . . . 425Unidades de disco. . . . . . . . . . . 432Repuestos en caliente. . . . . . . . . . 433Subsistemas . . . . . . . . . . . . . 434Disk Pools . . . . . . . . . . . . . 435Unidades lógicas . . . . . . . . . . . 437Niveles RAID . . . . . . . . . . . . 439Hosts . . . . . . . . . . . . . . . 441Grupos de host . . . . . . . . . . . . 441Puertos de host de adaptador de bus de host 442Números de unidad lógica . . . . . . . . 443

    Configuración de un subsistema dealmacenamiento . . . . . . . . . . . . 443

    Contenido vii

  • Cómo determinar qué hay en el subsistema dealmacenamiento . . . . . . . . . . . 444Borrado de la configuración . . . . . . . 459Utilización del mandato de configuraciónautomática . . . . . . . . . . . . . 459Utilización del mandato Create LogicalDrive 463

    Configurar un subsistema de almacenamiento conlas agrupaciones de discos . . . . . . . . . 467Modificar la configuración . . . . . . . . . 475

    Establecimiento de los relojes de controlador 476Establecimiento de la contraseña de subsistemade almacenamiento . . . . . . . . . . 476Establecimiento del tipo de host de subsistemade almacenamiento . . . . . . . . . . 476Establecimiento de la memoria caché desubsistema de almacenamiento . . . . . . 477Establecimiento de la prioridad de modificación 481Asignación de repuestos en caliente globales 482Cómo guardar una configuración en un archivo 482

    Capítulo 5. Utilización de la funciónprincipal FlashCopy . . . . . . . . 485Cómo funciona FlashCopy . . . . . . . . . 485Creación de una unidad lógica FlashCopy . . . . 487

    Creación de una unidad lógica FlashCopy conunidades de disco asignada por el usuario . . 487Creación de una unidad lógica FlashCopy conunidades de disco asignadas por el software . . 488Creación de una unidad lógica FlashCopyespecificando un número de unidades de disco . 489Parámetros definidos por el usuario . . . . . 489Nombres de unidad lógica FlashCopy ynombres de unidad lógica de repositorioFlashCopy . . . . . . . . . . . . . 491

    Cambio en la configuración de la unidad lógicaFlashCopy . . . . . . . . . . . . . . 492Detener, reiniciar y suprimir una unidad lógicaFlashCopy . . . . . . . . . . . . . . 492

    Capítulo 6. Using the EnhancedFlashCopy Images premium feature. . 495Acerca de la función principal de imágenes deEnhanced FlashCopy . . . . . . . . . . . 496Trabajar con la característica premium de imágenesde Enhanced FlashCopy . . . . . . . . . . 502

    Crear un grupo de imagen de EnhancedFlashCopy . . . . . . . . . . . . . 503Suprimir un grupo de imagen de EnhancedFlashCopy . . . . . . . . . . . . . 504Crear una imagen de Enhanced FlashCopy . . 504Cancelar una imagen de Enhanced FlashCopyen espera . . . . . . . . . . . . . . 504Crear una programación de una imagen deEnhanced FlashCopy . . . . . . . . . . 505Suprimir un grupo de imagen de EnhancedFlashCopy (con opciones) . . . . . . . . 507Crear unidades lógicas del grupo deconsistencia de Enhanced FlashCopy . . . . 508Suprimir una imagen de Enhanced FlashCopyde un grupo de consistencia . . . . . . . 511

    Crear una unidad lógica de la imagen deEnhanced FlashCopy . . . . . . . . . . 512Restaurar una unidad lógica de imagen deEnhanced FlashCopy de un grupo deconsistencia . . . . . . . . . . . . . 513Suprimir una unidad lógica de la imagen deEnhanced FlashCopy . . . . . . . . . . 513Cambiar el tamaño de la unidad lógica derepositorio . . . . . . . . . . . . . 514Iniciar, detener y reanudar una operación deretrotracción de la imagen de EnhancedFlashCopy . . . . . . . . . . . . . 516

    Capítulo 7. Acerca de la característicaprincipal de Enhanced Global Mirror . 521Creación de un par duplicado de Enhanced GlobalMirror . . . . . . . . . . . . . . . . 526Cambio de los valores de Enhanced GlobalMirroring. . . . . . . . . . . . . . . 532Suspensión y reanudación del grupo EnhancedGlobal Mirror . . . . . . . . . . . . . 533Resincronización manual de unidades lógicas enun grupo de Enhanced Global Mirror . . . . . 534Cambio de roles de Enhanced Global Mirroring 535Cancelación de un cambio de rol de grupo deEnhanced Global Mirror Group pendiente . . . . 536Resolución de conflictos de rol . . . . . . . 536Eliminación de unidades lógicas del grupoEnhanced Global Mirror . . . . . . . . . . 537Supresión de un grupo de Enhanced Global Mirror 538

    Capítulo 8. Acerca de la característicaprincipal de Enhanced RemoteMirroring . . . . . . . . . . . . . 541Cómo funciona Enhanced Remote Mirroring . . . 541

    Unidades lógicas de repositorio de duplicación 542Relaciones de duplicación . . . . . . . . 543Réplica de datos . . . . . . . . . . . 543Interrupciones de enlace o errores de unidadlógica secundaria . . . . . . . . . . . 545Resincronización . . . . . . . . . . . 545

    Creación de un par de duplicación remota . . . 546Consideraciones acerca del rendimiento . . . 546Habilitación de la característica EnhancedRemote Mirroring . . . . . . . . . . . 547Activación de la característica Enhanced RemoteMirroring. . . . . . . . . . . . . . 547Determinación de candidatos para un par deduplicación remota . . . . . . . . . . 550Creación de un par de duplicación remota . . 550

    Cambio de valores de Enhanced Remote Mirroring 551Suspensión y reanudación de una relación deduplicación . . . . . . . . . . . . . . 552Eliminación de una relación de duplicación . . . 553Supresión de una unidad lógica primaria o unaunidad lógica secundaria . . . . . . . . . 553Inhabilitación de la característica Enhanced RemoteMirroring. . . . . . . . . . . . . . . 553Desactivación de la característica Enhanced RemoteMirroring. . . . . . . . . . . . . . . 554

    viii IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Interacción con otras funciones . . . . . . . 554Particionamiento de almacenamiento . . . . 554Unidades lógicas FlashCopy . . . . . . . 554Copia de volumen. . . . . . . . . . . 555Dynamic Logical Drive Expansion (DVE) . . . 555

    Programa de utilidad Enhanced Remote Mirroring 556Descripción del programa de utilidad EnhancedRemote Mirroring . . . . . . . . . . . 556Operación del programa de utilidad EnhancedRemote Mirroring . . . . . . . . . . . 557Ejecución del programa de utilidad EnhancedRemote Mirroring . . . . . . . . . . . 557Programa de utilidad de configuración . . . . 558

    Capítulo 9. Utilización de la funciónprincipal de copia de volumen . . . . 561Cómo funciona la copia de volumen . . . . . 561

    Unidad lógica de origen . . . . . . . . . 561Unidad lógica de destino . . . . . . . . 562Copia de volumen y reservas persistentes . . . 563Rendimiento de subsistema de almacenamiento 563Restricciones . . . . . . . . . . . . 564Mandatos de copia de volumen . . . . . . 564

    Creación de VolumeCopy lógico . . . . . . . 565Habilitación de la característica de VolumeCopylógico . . . . . . . . . . . . . . . 565Determinación de candidatos de VolumeCopylógicos . . . . . . . . . . . . . . 565Creación de VolumeCopy lógica . . . . . . 566

    Visualización de las propiedades de VolumeCopylógico . . . . . . . . . . . . . . . . 567Cambio de configuración de VolumeCopy lógica 568Cómo volver a copiar una unidad lógica . . . . 569Detención de un VolumeCopy lógico . . . . . 570Eliminación de pares de copia . . . . . . . . 570Interacción con otras características . . . . . . 571

    Particionamiento de almacenamiento . . . . 571Unidades lógicas FlashCopy . . . . . . . 571Enhanced Remote Mirroring . . . . . . . 572

    Capítulo 10. Utilización de lacaracterística principal de la memoriacaché de lectura de rendimiento . . . 575Creación de memoria caché de lectura derendimiento, adición y eliminación de volúmenes . 577Modelado de rendimiento de la memoria caché delectura de rendimiento . . . . . . . . . . 577Tareas de gestión de la memoria caché de lecturade rendimiento . . . . . . . . . . . . . 581

    Capítulo 11. Mantenimiento de unsistema de almacenamiento . . . . . 585Mantenimiento rutinario. . . . . . . . . . 585

    Ejecución de una exploración de soporte . . . 585Ejecución de una comprobación de redundancia 586Restablecimiento de un controlador . . . . . 587Habilitación de una transferencia de datos decontrolador . . . . . . . . . . . . . 587Restablecimiento de la edad de la batería . . . 587

    Eliminación de reservas persistentes . . . . . 587Sincronización de los relojes de controlador . . 588Localización de unidades de disco . . . . . 588Reubicación de un subsistema . . . . . . . 588

    Ajuste de rendimiento . . . . . . . . . . 590Supervisión del rendimiento . . . . . . . 590Cambio de niveles de RAID . . . . . . . 591Cambio del tamaño de segmento . . . . . . 592Cambio de parámetros de memoria caché . . . 592Desfragmentación de un subsistema . . . . . 592

    Resolución de problemas y diagnósticos . . . . 593Recopilación de todos los datos de soporte . . 593Recopilación de datos de unidad . . . . . . 595Diagnósticos de un controlador . . . . . . 595Ejecución de diagnósticos de estado de enlacede lectura . . . . . . . . . . . . . 596Recopilación de estadísticas de errores deconmutación en un chip . . . . . . . . . 599

    Operaciones de recuperación . . . . . . . . 600Establecimiento de la modalidad de operacióndel controlador . . . . . . . . . . . . 600Cambio de la propiedad del controlador . . . 601Inicialización de una unidad . . . . . . . 601Reconstrucción de una unidad. . . . . . . 602Inicialización de una unidad lógica . . . . . 602Redistribución de unidades lógicas . . . . . 602Sustitución de CRU . . . . . . . . . . 603

    Capítulo 12. Ejemplos de informacióndevuelta por los mandatos Show . . . 605Mostrar mandato de subsistema dealmacenamiento . . . . . . . . . . . . 605Mostrar NVSRAM de controlador . . . . . . 645Mostrar unidad. . . . . . . . . . . . . 650Mostrar estado de canal de unidad . . . . . . 653Mostrar unidades lógicas . . . . . . . . . 658

    Capítulo 13. Archivos de script deejemplo . . . . . . . . . . . . . . 665Ejemplo 1 de script de configuración . . . . . 665Ejemplo 2 de script de configuración . . . . . 667

    Capítulo 14. Mandatos y parámetrosen desuso . . . . . . . . . . . . . 669Mandatos en desuso . . . . . . . . . . . 669Parámetros en desuso . . . . . . . . . . 669

    Contenido ix

  • Apéndice A. Ejemplos de informacióndevuelta por los mandatos show . . . 671

    Apéndice B. Archivos de script deejemplo . . . . . . . . . . . . . . 703

    Apéndice C. Programa de utilidad deduplicación de Global Copy . . . . . 707

    Apéndice D. Conversión de simplex aduplex . . . . . . . . . . . . . . 713

    Apéndice E. Documentación adicional 719

    Avisos . . . . . . . . . . . . . . 723Marcas registradas. . . . . . . . . . . . 724

    Notas importantes . . . . . . . . . . . . 725Formato de la documentación . . . . . . . . 725

    Índice. . . . . . . . . . . . . . . 727

    x IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Figuras

    1. Relaciones de host y almacenamiento 4242. Puertos de host de DS3200 . . . . . . . 4263. Puertos de host de DS3400 . . . . . . . 4274. Puertos de host de la serie DS3500 . . . . 4275. Puertos de host del subsistema de

    almacenamiento DCS3700 . . . . . . . 4276. Subsistema de almacenamiento DCS3700 con

    puertos de host de la serie de controladoresde módulo de rendimiento con tarjeta deinterfaz de host de canal de fibra instalada. . 428

    7. Subsistema de almacenamiento DCS3860 conpuertos host SAS instalados. . . . . . . 428

    8. Puertos de host de DS4200 y DS4700 4299. Puertos de host de DS4800 . . . . . . . 430

    10. Puertos de host de DS3950 y DS5020 43111. Puertos de host de DS5300 / DS5100 431

    © Copyright IBM Corp. 2008, 2013 xi

  • xii IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Tablas

    1. Convenciones de sintaxis de los nombres de losmandatos . . . . . . . . . . . . . 2

    2. Terminales de la línea de mandatos . . . . . 43. Constantes de rastreo válidas . . . . . . 104. Estado de salida . . . . . . . . . . . 145. Operaciones de configuración y gestión 196. Tipos de objeto e identificadores . . . . . 207. Forma general de los mandatos de script 228. Elementos de sintaxis recurrente . . . . . 239. Puertos de host y tipos de interfaces de host

    en los módulos de controlador . . . . . . 42510. Número máximo de unidades de disco 43211. Número máximo de unidades de disco en un

    unidad de disco basado en la capacidad . . 43512. Especificaciones de unidad lógica por el

    modelo de controlador soportado (paraDS3000, DS4000 y DS5000) . . . . . . . 438

    13. Especificaciones de unidad lógica por elmodelo de controlador soportado (para laserie DCS) . . . . . . . . . . . . 438

    14. Configuraciones de nivel RAID . . . . . 44015. Número máximo de puertos de host de HBA

    por controlador . . . . . . . . . . . 44216. Valores predeterminados para tamaño de

    segmento y búsqueda anticipada de lecturade la memoria caché . . . . . . . . . 462

    17. Recuento de unidades y el número deunidades de disco reservadas parareconstrucción . . . . . . . . . . . 467

    18. Valores para el parámetrocacheFlushModifier . . . . . . . . . 479

    19. Componentes de una unidad lógicaFlashCopy . . . . . . . . . . . . 485

    20. Mandatos de la unidad lógica FlashCopy 48621. Parámetros de la unidad lógica FlashCopy 48922. Estado de la operación de retrotracción de

    FlashCopy . . . . . . . . . . . . 51923. Número máximo de duplicaciones definidas 54224. Mandatos de copia de volumen . . . . . 56425. Información sobre el rendimiento del

    subsistema de almacenamiento. . . . . . 59026. Datos de soporte para el subsistema de

    almacenamiento. . . . . . . . . . . 59327. Datos de línea base RLS para el subsistema

    de almacenamiento . . . . . . . . . 59728. Mandatos en desuso . . . . . . . . . 66929. Parámetros en desuso . . . . . . . . . 669

    © Copyright IBM Corp. 2008, 2013 xiii

  • xiv IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Acerca de este documento

    Este documento es una guía de programación que describe la interfaz de línea demandatos y los mandatos de script del software de IBM System Storage DS StorageManager para configurar, operar y mantener un subsistema de almacenamiento.Este documento describe todos los mandatos de script, explica la finalidad de losmandatos, muestra la sintaxis completa de los mandatos y define los parámetrospara los mandatos. El código de la interfaz de línea de mandatos se instalaautomáticamente como parte de la instalación del cliente de IBM DS StorageManager.

    Para obtener instrucciones sobre la instalación de DS Storage Manager V10.77 oanterior, consulte IBM System Storage DS Storage Manager Versión 10 Installation andHost Support Guide.

    Para obtener instrucciones sobre la instalación de DS Storage Manager V10.83 oposterior, consulte IBM System Storage DS Storage Manager Versión 10.8 Installationand Host Support Guide.

    Este documento no cubre la instalación o integración del hardware. Para obtenermás información sobre estos temas, consulte la Guía de instalación y soporteapropiada para su subsistema de almacenamiento. Consulte Apéndice E,“Documentación adicional”, en la página 719 para obtener una lista de estosdocumentos.

    Consulte los archivos léame de las series DS3000, DS4000, DS5000 y DCS paraobtener la información más reciente relativa a los productos de hardware, softwareo firmware que no se describan en este documento.

    Lo nuevo en esta guíaEsta guía contiene referencias al nuevo subsistema de almacenamiento DCS3860.

    La versión previamente publicada de esta guía contiene información acerca de lasmejoras en IBM DS Storage Manager versión 10.84.xx con firmware de controladorversión 7.84.xx.xx:v Característica principal de Enhanced Global Mirroring: para obtener más

    detalles, consulte Capítulo 7, “Acerca de la característica principal de EnhancedGlobal Mirror”, en la página 521.

    v Característica principal de Enhanced Remote Mirroring: para obtener másdetalles, consulte Capítulo 8, “Acerca de la característica principal de EnhancedRemote Mirroring”, en la página 541.

    v Nuevos apéndices añadidos:– Apéndice A, “Ejemplos de información devuelta por los mandatos show”, en

    la página 671– Apéndice B, “Archivos de script de ejemplo”, en la página 703– Apéndice C, “Programa de utilidad de duplicación de Global Copy”, en la

    página 707– Apéndice D, “Conversión de simplex a duplex”, en la página 713

    v Mandatos introducidos en esta versión:

    © Copyright IBM Corp. 2008, 2013 xv

  • – “Mandatos de Enhanced Global Mirroring” en la página 409v Mandatos actualizados en esta versión:

    – Add drives to Performance Read Cache– Change Performance Read Cache application type– Create SSD cache– Delete Performance Read Cache– Enable or disable Performance Read Cache for a volume– Establish Enhanced Global Mirrored Pair– Remove drives from Performance Read Cache– Remove incomplete Enhanced Global Mirrored Pair from an Enhanced

    Global Mirror Group

    – Remove volume from Enhanced Global Mirror Group– Rename Performance Read Cache– Reset Enhanced Global Mirror Group statistics– Reset iSCSI IP address– Resume Enhanced Global Mirror Group– Resume Performance Read Cache– Revive Array– Set Enhanced Global Mirror Group– Show Enhanced Global Mirror Group synchronization progress– Mostrar estado de diagnóstico de memoria caché– Show array export dependenciesy– Iniciar diagnóstico de dispositivo de copia de seguridad de memoria

    caché

    – Iniciar el diagnóstico de base de datos de la configuración delsubsistema de almacenamiento

    – Stop Performance Read Cache performance modeling– Suspend Enhanced Global Mirror Group– Test Enhanced Global Mirror Group connectivity– Test Enhanced Global Mirror Group connectivity

    v Mandatos que se han quedado obsoletos en esta versión:– start rollback (volume– [flashcopyVolumeName | volumes– [flashcopyVolumeName1 ...– flashcopyVolumeNamen])

    Novedades en la versión DS Storage Manager 10.83 con versiónde firmware del controlador 7.83.xx.xx

    Esta guía contiene información sobre las mejoras de la versión de IBM DS StorageManager 10.83.xx con el firmware del controlador versión 7.83.xx.xx:v Enhanced FlashCopy: para obtener más detalles, consulteCapítulo 6, “Using the

    Enhanced FlashCopy Images premium feature”, en la página 495.v Agrupaciones de discos: para obtener más detalles, consulte “Disk Pools” en la

    página 435.v Mandatos introducidos en esta versión:

    – “Mandatos de agrupaciones de discos” en la página 412

    xvi IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • – “Mandatos de Enhanced FlashCopy” en la página 413– “Mandatos de análisis de la unidad lógica de repositorio” en la página 418– “Mandatos de la recogida del paquete de soporte” en la página 422

    v Mandatos actualizados en esta versión:– Activate Enhanced Remote Mirroring Feature– Activate iSCSI Initiator– Auto-configure Storage Subsystem– Check logicalDrive Parity– Check Remote Mirror Status– Clear logicalDrive Reservations– Clear logicalDrive Unreadable Sectors– Clear Storage Subsystem Firmware Pending Area– Create subsystem– Create FlashCopy logicalDrive– Create Host– Create Host Group– Create Host Port– Create iSCSI Initiator– Create RAID logicalDrive (Automatic Drive Select)– Create RAID logicalDrive (Free Extent Based Select)– Create RAID logicalDrive (Manual Drive Select)– Crear duplicación remota– Create Storage Subsystem Security Keyy– Create VolumeCopy– Delete subsystem– Disable Storage Subsystem Feature– Download Enclosure Configuration Settings– Download Enclosure Environmental Card Firmware– Export Storage Subsystem Security Key– Load Storage Subsystem DBM Database– Recopy VolumeCopy– Remove VolumeCopy– Reset Controller– Reset Storage Subsystem Battery Install Date– Reset Storage Subsystem Diagnostic Data– Reset Storage Subsystem SAS PHY Baseline– Revive subsystem– Revive Drive– Save Controller NVSRAM– Save Drive Channel Fault Isolation Diagnostic Status– Save Drive Log– Save Storage Subsystem RLS Counts– Save Storage Subsystem SOC Counts– Save Storage Subsystem Support Data– Set subsystem Forced State

    Acerca de este documento xvii

  • – Set Controller– Set Controller Service Action Allowed Indicator– Set Drive Hot Spare– Set Drive State– Set Enclosure Identification– Set Enclosure Service Action Allowed Indicator– Set Foreign Drive to Native– Set Host– Set Host Group– Set Host Port– Set iSCSI Initiator– Set iSCSI Target Properties– Set Session– Set Storage Subsystem– Set Storage Subsystem Enclosure Positions– Set Storage Subsystem ICMP Response– Set Storage Subsystem iSNS Server Listening Port– Set Storage Subsystem Remote Status Notification– Set Storage Subsystem Security Key– Set VolumeCopy– Show subsystem– Show subsystem Export Dependencies– Show subsystem Import Dependencies– Show Controller– Show Controller NVSRAM– Show Drive– Show Host Ports– Show logicalDrive– Show logicalDrive Action Progress– Show logicalDrive Performance Statistics– Show Storage Subsystem– Show Storage Subsystem Auto Configure– Show Storage Subsystem Host Topology– Show Storage Subsystem LUN Mappings– Show VolumeCopy Source Candidates– Start subsystem Defragment– Start subsystem Export– Start subsystem Import– Start subsystem Locate– Start Drive Initialize– Start Drive Locate– Start Drive Reconstruction– Start Host Interface Card Diagnostic– Start iSCSI DHCP Refresh– Start Secure Drive Erase

    xviii IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • – Stop Drive Channel Fault Isolation Diagnosticsv Mandatos que se han quedado obsoletos en esta versión:

    – Diagnose Controller iSCSI Host Cable– Disable Storage Subsystem Remote Status Notification– Download Power Supply Firmware– Enable Storage Subsystem Feature Key– Enable Storage Subsystem Remote Status Notification– Import Storage Subsystem Security Key– Set Storage Subsystem Remote Status Notification– Show Storage Subsystem Remote Status Notification– Start Configuration Database Diagnostic– Stop Configuration Database Diagnostic

    Soporte de software y firmware de las series DS3000, DS4000 yDS5000 y DCS

    La interfaz de línea de mandatos y los mandatos de script descritos en estedocumento se soportan con los siguientes niveles de software y firmware:v Series DS3000 y DCS: software de DS3000 Storage Manager Versión 10.xx junto

    con el firmware 07.xx.xx.xx y posteriores.v DS4000: software de DS4000 Storage Manager versión 10.xx junto con el

    firmware de controlador DS4000 versión 07.xx.xx.xx y posteriores.

    Nota: Algunos mandatos de script también se soportan en versiones anterioresdel firmware de controlador DS4000. Consulte “Mandatos de las series DS3000,DS4000, DS5000 y DCS con niveles de firmware mínimos” en la página 36 paraconocer el firmware de controlador mínimo necesario para soportar cadamandato de script. Esta tabla también muestra qué mandatos sólo se soportancon los productos de las series DS3000, DS4000, DS5000 y DCS, con dos de tres ocon los tres.

    v DS5000: software de DS5000 Storage Manager versión 10.50 y posteriores juntocon el firmware de controlador DS5000 versión 07.50 y posteriores.

    Quién debe leer este documentoEste documento da por supuesto que el usuario cuenta con conocimientos básicosde hardware de la red de área de almacenamiento (SAN) y con capacidad pararealizar la instalación.

    Este documento está dirigido a operadores del sistema, administradores delsistema y personal de servicio que sean responsables de operar, mantener, resolverproblemas o dar servicio a un subsistema de almacenamiento de las series DS3000,DS4000, DS5000 o DCS. Los usuarios deben estar familiarizados con elfuncionamiento, mantenimiento y reparación de sistemas informáticos. Además,deberían entender la tecnología de almacenamiento en disco, los conceptos delconjunto redundante de subsistemas independientes (RAID), las redes y lastecnologías de canal de fibra (FC) e iSCSI. El lector debe tener conocimientosbásicos sobre la funcionalidad de hardware de SAN (controladores, unidades yhosts) y sobre el cableado de SAN.

    Acerca de este documento xix

  • Avisos utilizados en este documentoEste documento contiene avisos, diseñados para resaltar la siguiente informaciónclave:

    Nota: Estos avisos ofrecen sugerencias, orientaciones o consejos.

    Importante:Estos avisos proporcionan informaciones o consejos que pueden ayudarle aevitar inconvenientes o problemas.

    Atención:Estos avisos indican posibles daños a programas, dispositivos o datos. Elaviso de atención se sitúa justo antes de la instrucción o situación en la quepodría producirse el daño.

    Obtener información, ayuda y serviciosSi necesita ayuda, servicio o asistencia técnica, o bien si solo desea másinformación sobre los productos IBM®, encontrará una gran variedad de fuentesdisponibles en IBM para ayudarle. Esta sección contiene información sobre dóndeir para obtener información adicional acerca de IBM y los productos de IBM, quéhacer si tiene algún problema con su sistema y a quién llamar para solicitarservicio, en caso de que sea necesario.

    Antes de llamarAntes de llamar, realice estos pasos para intentar resolver el problema:v Compruebe todos los cables para asegurarse de que están conectados.v Compruebe los interruptores de alimentación para asegurarse de que el sistema

    está encendido.v Utilice la información de resolución de problemas de la documentación del

    sistema y utilice las herramientas de diagnóstico que acompañan al sistema.v Compruebe la información técnica, las sugerencias, los consejos y los nuevos

    controladores de dispositivos en las páginas web de ayuda de IBM que seenumeran en esta sección.

    v Utilice un foro de discusión de IBM en la página web de IBM para realizarpreguntas.

    Puede resolver numerosos problemas sin ayuda externa siguiendo losprocedimientos de resolución de problemas que proporciona IBM en la ayuda enlínea de Storage Manager o en los documentos que se proporcionan con el sistemay el software. La información que acompaña al sistema también describe laspruebas de diagnóstico que puede realizar. La mayoría de subsistemas, sistemasoperativos y programas vienen con información que contiene procedimientos deresolución de problemas y explicaciones sobre mensajes de error y códigos deerror. Si sospecha que existe un problema de software, consulte la información delsistema operativo o del programa.

    Utilización de la documentaciónLa información sobre su sistema de IBM y el software instalado previamente, siexiste, está disponible en los documentos que acompañan al sistema. Entre ellos seincluyen libros impresos, documentos en línea, archivos readme y archivos deayuda. Consulte la información de resolución de problemas en la documentacióndel sistema para obtener instrucciones sobre la utilización de los programas dediagnóstico. Es posible que la información de resolución de problemas o los

    xx IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • programas de diagnóstico le digan que necesita controladores de dispositivosadicionales o actualizados, u otro software.

    Búsqueda de software, firmware de controlador y archivosreadme de Storage Manager

    El software y el firmware de controlador de Storage Manager están disponibles enel DVD del producto y también pueden descargase desde la Web. Los archivosreadme de Storage Manager también se encuentran en la web.

    Importante: Antes de instalar el software de Storage Manager, consulte el archivoreadme del sistema operativo del host. Los archivos readme actualizados contienenlas versiones más recientes del controlador de dispositivos, los niveles de firmware,las limitaciones y otras informaciones que no se encuentran en este documento.1. Visite la siguiente página web:

    www.ibm.com/servers/storage/support/disk/2. Pulse el enlace de su subsistema de almacenamiento (por ejemplo, DS3400 o

    DS4800).3. Cuando se abra la página de ayuda de su subsistema de almacenamiento, pulse

    el enlace Descarga en el recuadro Soporte & Descargas. Se abrirá la página delsoftware y los controladores de dispositivos.

    4. En la sección Storage Manager de la tabla, localice su sistema operativo y elnivel de la versión y pulse el enlace de la versión, en la columna de la derecha.Se abrirá la página concreta de su subsistema de almacenamiento y versión delsistema operativo.

    5. En la tabla, en Detalles del archivo, pulse el enlace del archivo *.txt y se abriráel README en su navegador web.

    Sitios web esenciales para obtener información de soporte delas series DS3000, DS4000, DS5000, DS5020 y DCS

    La información más actualizada sobre los subsistemas de almacenamiento de lasseries DS3000, DS4000, DS5000 y DCS y Storage Manager, incluyendodocumentación y las descargas más recientes de software, firmware y NVSRAM, sepuede encontrar en los siguientes sitios web.

    Sistemas de almacenamiento de disco IBM System StorageObtenga enlaces a descargas de software y firmware, archivos léame ypáginas de soporte de todos los sistemas de almacenamiento de disco deIBM System Storage, incluyendo las series DS3000, DS4000, DS5000,DS5020 y DCS:

    www.ibm.com/systems/support/storage/disk

    IBM System Storage Interoperation Center (SSIC). Obtenga información de soporte técnico de su configuración específica dehost/subsistema de almacenamiento de las series DS3000, DS4000, DS5000,DS5020 y DCS, incluyendo las versiones de firmware más recientesrecomendadas para su sistema utilizando este programa de utilidadinteractivo basado en web:

    www.ibm.com/systems/support/storage/config/ssic/index.jsp

    Activación de la característica principal de las series DS3000, DS4000, DS5000 yDCS de IBM

    Active una característica principal de las series DS3000, DS4000, DS5000 yDCS utilizando este programa de utilidad basado en web:

    Acerca de este documento xxi

    http://www.ibm.com/systems/support/storage/diskhttp://www.ibm.com/systems/support/storage/diskhttp://www.ibm.com/systems/support/storage/config/ssic/index.jsp

  • https://www-912.ibm.com/PremiumFeatures/jsp/keyPrereq.jsp

    Soporte de interoperabilidad de las series DS3000, DS4000, DS5000 y DCS deIBM System Storage

    Encuentre la información más reciente sobre el soporte de sistemaoperativo y HBA, el soporte de clústeres, el soporte de tejido de red deárea de almacenamiento (SAN) y el soporte de característica de StorageManager:

    www.ibm.com/systems/support/storage/config/ssic/index.jsp

    Soporte de SAN (Storage Area Network - Red de área de almacenamiento)Busque información sobre cómo utilizar conmutadores SAN, incluyendoenlaces a las guías de usuario de SAN y otros documentos:

    www.ibm.com/systems/support/storage/san

    Soporte para servidores IBM System p, AIX 5L y LinuxEncuentre Encuentre la información de soporte más reciente paraservidores System p, AIX, Linux, BladeCenter y i5/OS:

    www.ibm.com/systems/support/supportsite.wss/brandmain?brandind=5000025

    Soporte para servidores IBM System xEncuentre la información de soporte más reciente para servidores System xbasados en Intel y AMD:

    www.ibm.com/systems/support/supportsite.wss/brandmain?brandind=5000008

    eServer System p y AIX Information CenterEncuentre todo lo que necesita conocer sobre la utilización de AIX conservidores System p y POWER:

    publib.boulder.ibm.com/infocenter/pseries/index.jsp?

    Central de arreglosEncuentre los arreglos y las actualizaciones para el software, hardware ysistema operativo de host del sistema:

    www.ibm.com/eserver/support/fixes

    Productos de IBM System StorageEncuentre información sobre todos los productos de IBM System Storage:

    www.storage.ibm.com

    Centro de publicaciones de IBMEncuentre publicaciones de IBM:

    www.ibm.com/shop/publications/order/

    Software service and supportThrough IBM Support Line, for a fee you can get telephone assistance with usage,configuration, and software problems. For information about which products aresupported by Support Line in your country or region, go to the following website:

    www.ibm.com/services/sl/products

    For more information about the IBM Support Line and other IBM services, go tothe following websites:v www.ibm.com/services

    xxii IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

    https://www-912.ibm.com/PremiumFeatures/jsp/keyPrereq.jsphttp://www.ibm.com/systems/support/storage/config/ssic/index.jsphttp://www.ibm.com/systems/support/storage/san/http://www.ibm.com/systems/support/supportsite.wss/brandmain?brandind=5000025http://www.ibm.com/systems/support/supportsite.wss/brandmain?brandind=5000025http://www-304.ibm.com/systems/support/supportsite.wss/brandmain?brandind=5000008http://www-304.ibm.com/systems/support/supportsite.wss/brandmain?brandind=5000008http://publib.boulder.ibm.com/infocenter/pseries/index.jsp?http://www.ibm.com/eserver/support/fixeshttp://www.storage.ibm.com/http://www.ibm.com/shop/publications/order/http://www.ibm.com/services/sl/productshttp://www.ibm.com/services

  • v www.ibm.com/planetwide

    Soporte y servicio de hardwarePuede recibir servicio de hardware a través de IBM Integrated Technology Serviceso a través de su distribuidor de IBM, si su distribuidor está autorizado por IBMpara proporcionar servicio de garantía. Visite esta página web para obtenernúmeros de teléfono de soporte:

    www.ibm.com/planetwide

    En los Estados Unidos y en Canadá, el soporte y servicio de hardware estádisponible las 24 horas del día, los 7 días de la semana. En el Reino Unido, estosservicios están disponibles de lunes a viernes, de 9 a.m. a 6 p.m.

    Información de contacto de Taiwan

    Este tema contiene la información de contacto del servicio para productos de IBMpara Taiwán.Información de contacto del servicio para productos de IBM para Taiwán:IBM Taiwan Corporation3F, No 7, Song Ren Rd., Taipei TaiwanTel: 0800-016-888

    Sistemas de protección contra incendiosEl sistema de protección contra incendios es responsabilidad del cliente. Se debeconsultar con la entidad aseguradora del cliente, con un inspector de incendioslocal o con un inspector de construcción local, o con todos ellos, a la hora deseleccionar un sistema de protección contra incendios que proporcione el nivelcorrecto de cobertura y protección. IBM diseña y fabrica el equipo según losestándares internos y externos que requieren determinados entornos para funcionarde manera fiable. Dado que IBM no comprueba la compatibilidad de ningúnequipo con los sistemas de protección contra incendios, IBM no realiza ningunaafirmación de compatibilidad de ninguna clase ni proporciona recomendacionessobre sistemas de protección contra incendios.

    f2c0

    07

    90

    Acerca de este documento xxiii

    http://www.ibm.com/planetwidehttp://www.ibm.com/planetwide

  • xxiv IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Capítulo 1. Acerca de la interfaz de línea de mandatos

    Atención: IBM le recomienda que utilice la GUI de cliente de Storage Managerpara gestionar sus subsistemas de almacenamiento. – La interfaz de línea demandatos no tiene ningún mecanismo para evitar que se realicen por error cambiosno deseados en el subsistema de almacenamiento. Dado que los mandatos descript pueden dañar una configuración y provocar la pérdida del acceso a los datossi no se utilizan correctamente, IBM le recomienda que utilice la GUI de cliente deStorage Manager para gestionar la configuración de sus subsistemas dealmacenamiento.

    La interfaz de línea de mandatos (CLI) es una herramienta de software quepermite a los instaladores, desarrolladores e ingenieros de los subsistemas dealmacenamiento configurar y gestionar los subsistemas de almacenamientoutilizando los mandatos de script. Utilizando la CLI, puede ejecutar mandatosdesde una solicitud de sistema operativo, como por ejemplo la solicitud demandatos de Windows, una consola de sistema operativo de Linux o una consolade sistema operativo de Solaris. Tiene que instalar el cliente de IBM DS StorageManager para ejecutar los mandatos de script a través de una ventana de script,que se invoca desde la ventana Empresa del cliente de IBM DS Storage Manager, oa través de la interfaz de línea de mandatos utilizando el programa SMcli. Elmotor de mandatos de script se instala automáticamente como parte de lainstalación del cliente de IBM DS Storage Manager.

    Cada mandato realiza una acción específica para gestionar un subsistema dealmacenamiento o devolver información sobre el estado de un subsistema dealmacenamiento. Puede introducir mandatos individuales o puede ejecutararchivos de script cuando necesite realizar operaciones más de una vez. Porejemplo, puede ejecutar archivos de script cuando desee instalar la mismaconfiguración en diversos subsistemas de almacenamiento. La CLI le permitecargar un archivo de script desde un disco y ejecutar el archivo de script. La CLIproporciona una forma de ejecutar los mandatos de gestión del almacenamiento enmás de un subsistema de almacenamiento en red. Puede utilizar la CLI tanto ensitios de instalación como en entornos de desarrollo.

    Cómo utilizar la interfaz de línea de mandatosLos mandatos que se ejecutan en la CLI proporcionan acceso al motor de script,especifican el subsistema de almacenamiento que va a recibir los mandatos descript y definen los parámetros del entorno operativo.

    Un mandato CLI consta de estos elementos:v El término SMcliv El identificador del subsistema de almacenamientov Parámetrosv Mandatos de script

    Un mandato CLI tiene esta forma:

    SMcli storageSubsystem parameters script-commands;

    v SMcli invoca la interfaz de línea de mandatos.

    © Copyright IBM Corp. 2008, 2013 1

  • Nota: Si emite el mandato desde el directorio o carpeta que no contiene elprograma SMcli.exe, es necesario incluir la ruta de acceso apropiada:directoryName/SMcli.

    v storageSubsystem es el nombre o la dirección IP del subsistema dealmacenamiento.

    v parameters son los parámetros CLI que definen el entorno y la finalidad delmandato.

    v script-commands son uno o más mandatos de script o el nombre de un archivode script que contiene mandatos de script. (Los mandatos de script son losmandatos de configuración del subsistema de almacenamiento.)

    Notas de usoSi introduce SMcli y el nombre de un subsistema de almacenamiento pero noespecifica parámetros CLI, mandatos de script o un archivo de script, la interfaz delínea de mandatos se ejecuta en modo interactivo. El modo interactivo le permiteejecutar mandatos individuales sin prefijar los mandatos con SMcli. En el modointeractivo, puede introducir un único mandato, ver los resultados e introducir elsiguiente mandato sin teclear la serie SMcli completa. El modo interactivo es útilpara determinar los errores de configuración y probar rápidamente los cambios deconfiguración.

    Para finalizar una sesión en modo interactivo, escriba el mandato específico delsistema operativo para finalizar un programa (como por ejemplo Control-C en elsistema operativo de UNIX o el sistema operativo de Windows). Al escribir elmandato de finalización (Control-C) en el modo interactivo, se apaga el modointeractivo y se devuelve el funcionamiento del indicador de mandatos a unamodalidad de entrada que requiere que teclee la serie SMcli completa.

    Si introduce una serie SMcli incompleta o inexacta que no tenga la sintaxis, losnombres de parámetros, las opciones o las terminales correctas, el motor de scriptsdevuelve la información de uso.

    Mandatos de CLI

    Las convenciones utilizadas en la sintaxis de las sentencias de mandato paragestionar el subsistema de almacenamiento se listan en la tabla siguiente:

    Tabla 1. Convenciones de sintaxis de los nombres de los mandatos

    Convención Definición

    (a | b | c) Alternativa (“a” o “b” o “c”)

    cursivasUna terminal que necesita una entrada del usuariopara llenar un parámetro (una respuesta a unavariable)

    [ ... ] (corchetes) Ninguna o una aparición (los corchetes también seutilizan como delimitador en algunos parámetros demandatos)

    { ... } (llaves) Cero o varias apariciones

    negrita Una terminal que necesita que se introduzca unparámetro de mandato para iniciar una acción

    A continuación tiene las formas generales de los mandatos CLI, que muestran lasterminales y los parámetros que se utilizan en cada mandato.

    2 IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • SMcli DNS-network-name-or-IP-address [DNS-network-name-or-IP-address][-c “command; {command2};”][-n storage-system-name | -w wwID][-o outputfile] [-p password] [-e] [-S] [-quick]

    SMcli DNS-network-name-or-IP-address[DNS-network-name-or-IP-address][-f scriptfile][-n storage-system-name | -w wwID][-o outputfile] [-p password] [-e] [-S] [-quick]

    SMcli (-n storage-system-name | -w wwID)[-c “command; {command2};”][-o outputfile] [-p password] [-e] [-S] [-quick]

    SMcli (-n storage-system-name -w wwID)[-f scriptfile][-o outputfile] [-p password] [-e] [-S] [-quick]

    SMcli -a email: email-address [host-name-or-IP-address1[host-name-or-IP-address2]][-n storage-system-name | -w wwID | -h host-name | -r (host_sa | direct_sa)][-I information-to-include] [-q frequency] [-S]

    SMcli -x email: email-address [host-name-or-IP-address1[host-name-or-IP-address2]][-n storage-system-name | -w wwID | -h host-name | -r (host_sa | direct_sa)] [-S]

    SMcli (-a | -x) trap: community, host-name-or-IP-address[host-name-or-IP-address1 [host-name-or-IP-address2]][-n storage-system-name | -w wwID | -h host-name | -r (host_sa | direct_sa)] [-S]

    SMcli -d [-w] [-i] [-s] [-v] [-S]

    SMcli -m host-name-or-IP-address -F email-address[-g contactInfoFile] [-S]

    SMcli -A [host-name-or-IP-address [host-name-or-IP-address]] [-S]

    SMcli -X (-n storage-system-name | -w wwID | -h host-name)

    SMcli -?

    Capítulo 1. Acerca de la interfaz de línea de mandatos 3

  • Terminales de la línea de mandatosTabla 2. Terminales de la línea de mandatos

    Terminal Definición

    host-name-or-IP-address Especifica el nombre de host o la dirección IP (xxx.xxx.xxx.xxx)de un subsistema de almacenamiento gestionado en banda ode un subsistema de almacenamiento gestionado fuera debanda.

    v Si está gestionando un subsistema de almacenamientoutilizando un host a través de la gestión de almacenamientoen banda, debe utilizar la terminal -n o la terminal -w sihay más de un subsistema de almacenamiento conectado alhost.

    v Si está gestionando un subsistema de almacenamientoutilizando la gestión de almacenamiento fuera de banda através de la conexión Ethernet en cada controlador, debeespecificar el host-name-or-IP-address de los controladores.

    v Si ha configurado anteriormente un subsistema dealmacenamiento en la Enterprise Management Window,puede especificar el subsistema de almacenamiento por elnombre proporcionado por el usuario utilizando la terminal-n.

    v Si ha configurado anteriormente un subsistema dealmacenamiento en la Enterprise Management Window,puede especificar el subsistema de almacenamiento por suidentificador internacional (WWID) utilizando la terminal-w.

    -AAñade un subsistema de almacenamiento al archivo deconfiguración. Si no acompaña la terminal -A con unhost-name-or-IP-address, el descubrimiento automático explorala subred local en busca de subsistemas de almacenamiento.

    -a Añade un destino de excepción del protocolo simple degestión de red (SNMP) o un destino de alerta de la direcciónde correo electrónico.

    v Al añadir un destino de excepción de SNMP, la comunidadSNMP se define automáticamente como el nombre de lacomunidad para la excepción y el host es la dirección IP onombre de host del servidor de nombres de dominio (DNS)del sistema al que debería enviarse la excepción.

    v Al añadir una dirección de correo electrónico para undestino de alerta, la email-address es la dirección de correoelectrónico a la que desea que se envíe el mensaje de alerta.

    -c Indica que está introduciendo uno o más mandatos de scriptpara que se ejecuten en el subsistema de almacenamientoespecificado. Finalice cada mandato con un punto y coma (;).No puede colocar más de una terminal -c en la misma líneade mandatos. Puede incluir más de un mandato de scriptdespués de la terminal -c.

    -dMuestra el contenido del archivo de configuración del script.El contenido del archivo adopta este formato:

    storage-system-name host-name1 host-name2

    -e Ejecuta los mandatos sin realizar antes una comprobación desintaxis.

    4 IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Tabla 2. Terminales de la línea de mandatos (continuación)

    Terminal Definición

    -F (mayúscula) Especifica la dirección de correo electrónico desde la que seenviarán todas las alertas.

    -f (minúscula)Especifica un nombre de archivo que contiene los mandatosde script que desea ejecutar en el subsistema dealmacenamiento especificado. (Esta terminal es similar a laterminal -c en el hecho de que ambas terminales tienen comoobjetivo ejecutar mandatos de script. La terminal -c ejecutamandatos de script individuales. La terminal -f ejecuta unarchivo de mandatos de script.)

    De forma predeterminada, se ignora cualquier error queaparezca al ejecutar los mandatos de script en un archivo y elarchivo sigue ejecutándose. Para variar este comportamiento,utilice el mandato set session errorAction=stop en elarchivo de script.

    -gEspecifica el archivo ASCII que contiene la información decontacto del remitente del correo electrónico que se incluirá entodas las notificaciones de alerta de correo electrónico. La CLIda por supuesto que el archivo ASCII es de solo texto, sindelimitadores o sin ningún formato esperado. No utilice estaterminal si existe un archivo userdata.txt.

    -h Especifica el nombre de host que está ejecutando el agenteSNMP al que se conecta el subsistema de almacenamiento.Utilice esta terminal con la terminal -a y la terminal -x.

    -I Especifica el tipo de información que se incluye en lasnotificaciones de alerta de correo electrónico. Puedeseleccionar estos valores:

    v eventOnlyv profilev supportBundle

    -iMuestra la dirección IP de los subsistemas de almacenamientoconocidos. Utilice esta terminal con la terminal -d. Elcontenido del archivo adopta este formato: storage-system-nameIP-address1 IPaddress2

    -m Especifica el nombre de host o la dirección IP del servidor decorreo electrónico desde el que se envían las notificaciones dealerta de correo electrónico.

    Capítulo 1. Acerca de la interfaz de línea de mandatos 5

  • Tabla 2. Terminales de la línea de mandatos (continuación)

    Terminal Definición

    -nEspecifica el nombre del subsistema de almacenamiento en elque desea ejecutar los mandatos de script. Este nombre esopcional cuando utiliza un host-name-or-IP-address. Si estáutilizando el método en banda para gestionar el subsistema dealmacenamiento, debe utilizar la terminal -n si hay más de unsubsistema de almacenamiento conectado al host en ladirección especificada. El nombre del subsistema dealmacenamiento es necesario cuando no se utiliza elhost-name-or-IP-address. El nombre del subsistema dealmacenamiento que está configurado para su utilización en laEnterprise Management Window (es decir, el nombre se citaen el archivo de configuración) no debe ser un nombreduplicado de ningún otro subsistema de almacenamientoconfigurado.

    -o Especifica un nombre de archivo para todo texto de salida quees el resultado de ejecutar los mandatos de script al utilizaresta terminal con la terminal -c o la terminal -f. Si noespecifica un archivo de salida, el texto de salida va a la salidaestándar (stdout). Toda salida de los mandatos que no seanmandatos de script se envía a stdout, independientemente desi esa terminal está definida.

    -p Especifica la contraseña para el subsistema de almacenamientoen el que desea ejecutar los mandatos. La contraseña no esnecesaria bajo estas condiciones:

    v No se ha definido una contraseña en el subsistema dealmacenamiento.

    v La contraseña se especifica en un archivo de script que estáejecutando.

    v La contraseña se especifica utilizando la terminal -c y elmandato set session password= password.

    -q Especifica la frecuencia con la que desea incluir informaciónde perfiles adicionales o de paquetes de soporte en lasnotificaciones de alerta del correo electrónico. Siempre segenera una notificación de alerta de correo electrónico quecontiene la información de suceso básica para cada sucesocrítico. Si establece la terminal -I en eventOnly, el único valorválido para la terminal -q es everyEvent. Si establece laterminal -I en el valor profile o en el valor supportBundle,esta información se incluye en los correos electrónicos con lafrecuencia especificada por la terminal -q. Estos valores sonvalores de frecuencia válidos:

    v everyEvent – Se devuelve información con cadanotificación de alerta de correo electrónico.

    v 2 – La información se devuelve solo una vez cada doshoras.

    v 4 – La información se devuelve solo una vez cada cuatrohoras.

    v 8 – La información se devuelve solo una vez cada ochohoras.

    v 12 – La información se devuelve solo una vez cada 12horas.

    v 24 – La información se devuelve solo una vez cada 24horas.

    6 IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • Tabla 2. Terminales de la línea de mandatos (continuación)

    Terminal Definición

    -quickReduce el tiempo necesario para ejecutar una operación delínea única. Un ejemplo de una operación de línea única es elmandato re-create FlashCopy LogicalDrive. Esta terminalreduce el tiempo al no ejecutar procesos de fondo durante laduración del mandato.

    No utilice esta terminal para operaciones que impliquen másde una operación de línea única. El uso reiterado de estemandato puede desbordar al controlador con más mandatosde los que el controlador puede procesar, lo que provocará unfallo operativo. Además, las actualizaciones de estado y deconfiguración que se recogen habitualmente desde losprocesos de fondo no estarán disponibles en la CLI. Estaterminal provoca que las operaciones que dependen de lainformación de fondo fallen.

    -rDefine o cambia las notificaciones de alerta para todos lossubsistemas de almacenamiento gestionados por unadeterminada estación de gestión de almacenamiento. Utilice laterminal -r con la terminal -a o la terminal -x. Para lossubsistemas de almacenamiento gestionados fuera de banda,utilice el valor direct_sa. Para los subsistemas dealmacenamiento gestionados en banda, utilice el valorhost_sa.

    -S (mayúscula) Suprime los mensajes informativos que describen el progresodel mandato que aparecen al ejecutar mandatos de script. (Lasupresión de los mensajes informativos también se denominamodo silencioso.) Esta terminal suprime estos mensajes:

    v Performance syntax checkv Syntax check completev Executing scriptv Script execution completev SMcli completed successfully

    -s (minúscula) Muestra los valores de alerta en el archivo de configuracióncuando se utiliza con la terminal -d.

    -v Muestra el estado global actual de los dispositivos conocidosen un archivo de configuración cuando se utiliza con laterminal -d.

    -wEspecifica el WWID del subsistema de almacenamiento. Estaterminal es una alternativa a la terminal -n. Utilice la terminal-w con la terminal -d para mostrar los WWID de lossubsistemas de almacenamiento conocidos. El contenido delarchivo adopta este formato: storage-system-name world-wide-IDIPaddress1 IP-address2.

    -X (mayúscula) Elimina un subsistema de almacenamiento de unaconfiguración.

    -x (minúscula) Elimina un destino de excepción de SNMP o un destino dealerta de la dirección de correo electrónico. La comunidad es elnombre de la comunidad SNMP para la excepción y el host esla dirección IP o nombre de host del DNS del sistema al quedesea enviar la excepción.

    Capítulo 1. Acerca de la interfaz de línea de mandatos 7

  • Tabla 2. Terminales de la línea de mandatos (continuación)

    Terminal Definición

    -? Muestra la información de uso de los mandatos CLI.

    Consideraciones sobre el formatoLas comillas dobles (“ ”) que se utilizan como parte de un nombre o etiquetarequieren una consideración especial al ejecutar los mandatos CLI y los mandatosde script en un sistema operativo de Microsoft Windows. Esta sección describecómo utilizar las comillas dobles en nombres al ejecutar mandatos CLI y mandatosde script en un sistema operativo de Windows.

    Cuando las comillas dobles (“ ”) forman parte de un nombre o valor, debe insertaruna barra invertida (\) antes de cada carácter de comillas. Por ejemplo:-c set storageSubsystem userLabel=\“Engineering\”;”

    donde “Engineering” es el nombre del subsistema de almacenamiento. Un segundoejemplo es:-n \“My\”_StorageSubsystem

    donde “My”_StorageSubsystem es el nombre del subsistema de almacenamiento.

    No puede utilizar comillas dobles (“ ”) como parte de una serie de caracteres(también llamada literal de serie) dentro de un mandato de script. Por ejemplo, nopuede introducir la serie siguiente para establecer el nombre de un subsistema dealmacenamiento en “Finance Subsystem":-c “set storageSubsystem userLabel=\”\”Finance\”Subsystem\”;”

    En el sistema operativo de Linux y el sistema operativo de Solaris, losdelimitadores de nombres o etiquetas son las comillas simples (‘ ’). Las versionesen UNIX de los ejemplos anteriores son las siguientes:-c 'set storageSubsystem userLabel=“Engineering”;'

    -n “My”_StorageSubsystem

    En un sistema operativo de Windows, si no utiliza comillas dobles (“ ”) alrededorde un nombre, debe insertar un acento circunflejo ( ^ ) antes de cada carácter descript especial. Los caracteres especiales son ^, | , .

    Inserte un acento circunflejo antes de cada carácter de script especial cuando loutilice con las terminales -n, -o, -f y -p. Por ejemplo, para especificar el subsistemade almacenamiento CLI>CLIENT, introduzca esta serie:-n CLI^>CLIENT

    Inserte un acento circunflejo (^) antes de cada carácter de script especial cuando loutilice dentro de un literal de serie en un mandato de script. Por ejemplo, paracambiar el nombre de un subsistema de almacenamiento por el deFINANCE_|_PAYROLL, introduzca la siguiente serie:-c set storageSubsystem userLabel=\“FINANCE_^|_PAYROLL\”;”

    Informes detallados de erroresLos datos de error que se recogen sobre un error encontrado por la CLI se grabanen un archivo. El informe detallado de errores de la CLI funciona del siguientemodo:

    8 IBM System Storage DS Storage Manager Versión 10: Guía de programación de la interfaz de línea de mandatos y de losmandatos de script

  • v Si la CLI debe terminar de forma anómala de ejecutar mandatos CLI y mandatosde script, los datos del error se recogen y se guardan antes de que finalice laCLI.

    v La CLI guarda los datos del error grabando los datos en un nombre de archivoestándar.

    v La CLI guarda automáticamente los datos en un archivo. No se necesitanopciones especiales de la línea de mandatos para guardar los datos de errores.

    v No necesita realizar ninguna acción para guardar los datos del error en unarchivo.

    v La CLI no tiene ninguna provisión para evitar que se sobrescriba una versiónexistente del archivo que contiene los datos de errores.

    En el procesamiento de los errores, aparecen errores de dos tipos:v Errores de terminal o errores de sintaxis que haya podido introducirv Excepciones que ocurren como resultado de un error operativo

    Cuando la CLI encuentra cualquiera de los dos tipos de error, graba la informaciónque describe el error directamente en la línea de mandatos y define un código deretorno. En función del código de retorno, es posible que la CLI también grabeinformación adicional sobre qué terminal provocó el error. La CLI también escribeinformación sobre qué esperaba encontrar en la sintaxis del mandato para ayudarlea identificar cualquier posible error que haya podido introducir.

    Cuando se produce una excepción mientras se está ejecutando un mandato, la CLIcaptura el error. Al final del procesamiento del mandato (después de que se hayaescrito la información de procesamiento del mandato en la línea de mandatos), laCLI guarda automáticamente la información del error en un archivo.

    El nombre del archivo en el que se guarda la información del error es excprpt.txt.La CLI intenta colocar el archivo excprpt.txt en el directorio especificado por lapropiedad del sistema devmgr.datadir. Si por alguna razón la CLI no puedecolocar el archivo en el directorio especificado por devmgr.datadir, la CLI guardael archivo excprpt.txt en el mismo directorio en que se está ejecutando la CLI. Nopuede cambiar el nombre del archivo o la ubicación. El archivo excprpt.txt sesobrescribe cada vez que se produce una excepción. Si desea guardar lainformación en el archivo excprpt.txt, debe copiar la información en un archivonuevo o un directorio nuevo.

    Nota: En Windows, la clave de registro especifica esto:

    HKLM\SOFTWARE\storage\SMclient\SunJVMOption1

    En una instalación típica sin cambios en el directorio de instalaciónpredeterminado, la ubicación es:v Sistemas operativos de Windows: c:\Program Files\IBM_DS....\client\datav Sistemas operativos basados en UNIX: /var/opt/SM

    Recurso de rastreoEl programa SMcli tiene un recurso de rastreo. El objetivo del recurso de rastreo esrecopilar la información de SMcli durante la ejecución del mandato para ayudar alservicio de soporte técnico de IBM en la resolución de problemas de SMcli. Elrecurso de rastreo se habilita escribiendo -trace en la línea de mandatos seguidode una lista de opciones de rastreo separadas por punto y coma, y opcionalmenteun mandato -tracefile seguido de un nombre de archivo designado para el

    Capítulo 1. Acerca de la interfaz de línea de mandatos 9

  • archivo de rastreo. Para ver la lista de opciones de un release, puede utilizar elmandato SMcli -trace, como se muestra en la sección de ejemplo.

    Las opciones más comunes para la interacción de depuración con el subsistema dealmacenamiento son:v 0 - JALv 1 - Detalle de JALv 79 - Todos los errores y excepciones

    Nota: Cuando se habilita el rastreo, también se habilita 79 - Todos los errores yexcepciones.

    Si el subsistema de almacenamiento se gestiona mediante el agente de host deStorage Manager, serían útiles las siguientes opciones:v 2 - Agente RPC-UTMv 3 - Detalle de agente RPC-UTM

    Ejemplo

    Los ejemplos que figuran a continuación muestran el perfil mediante SMcli con elrastreo habilitado. La información de rastreo se graba en un archivo local de unsubsistema de almacenamiento llamado subsystemName. El subsistema dealmacenamiento se añadió anteriormente a la ventana de Enterprise Managementde su programa cli