Storage DS4300

download Storage DS4300

of 754

Transcript of Storage DS4300

  • IBM System Storage DS Storage Manager Versin 10

    Gua de programacin de la interfaz delnea de mandatos y de los mandatosde script

    GA32-0961-06

  • NotaAntes de utilizar esta informacin y el producto al que da soporte, lea la informacin de Avisos en la pgina 723.

    Esta edicin se aplica a la versin 10 modificacin 35 de IBM DS Storage Manager y a todos los releases ymodificaciones posteriores hasta que se diga lo contrario en nuevas ediciones.

    Esta edicin sustituye a GA32-0961-05.

    Copyright IBM Corporation 2008, 2013.

  • ContenidoFiguras . . . . . . . . . . . . . . . xi

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

    Acerca de este documento . . . . . . xvLo nuevo en esta gua . . . . . . . . . . . xvSoporte de software y firmware de las seriesDS3000, DS4000 y DS5000 y DCS . . . . . . . xixQuin debe leer este documento . . . . . . . xixAvisos utilizados en este documento . . . . . . xxObtener informacin, ayuda y servicios . . . . . xx

    Antes de llamar . . . . . . . . . . . . xxUtilizacin de la documentacin . . . . . . xxBsqueda de software, firmware de controladory archivos readme de Storage Manager . . . . xxiSitios web esenciales para obtener informacinde soporte de las series DS3000, DS4000, DS5000,DS5020 y DCS . . . . . . . . . . . . xxiSoftware service and support . . . . . . . xxiiSoporte y servicio de hardware . . . . . . xxiiiInformacin de contacto de Taiwan . . . . . xxiiiSistemas de proteccin contra incendios . . . xxiii

    Captulo 1. Acerca de la interfaz de lneade mandatos. . . . . . . . . . . . . 1Cmo utilizar la interfaz de lnea de mandatos . . . 1

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

    Captulo 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 . . . . . . . . . . . . 30Adicin de comentarios a un archivo de script . . 30

    Captulo 3. Mandatos de script . . . . 33Convenciones de asignacin 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 mnimos . . . . . 36Activar Enhanced Global Mirror . . . . . . . 68Activar la funcin Enhanced Remote Mirroring . . 68Activar puerto de host. . . . . . . . . . . 71Activar iniciador iSCSI . . . . . . . . . . 72

    Activar firmware de subsistema de almacenamiento 72Activacin de Enhanced Remote Mirroring . . . . 72Adicin de una unidad lgica al grupo de EnhancedGlobal Mirror. . . . . . . . . . . . . . 73Aadir miembros al grupo de consistencia . . . . 73Adicin de unidades a la Memoria cach de lecturade rendimiento . . . . . . . . . . . . . 75Configurar automticamente el subsistema dealmacenamiento . . . . . . . . . . . . . 76Configurar automticamente los repuestos activosdel subsistema de almacenamiento . . . . . . 80Cancelacin de inversin de roles de grupos deEnhanced Global Mirror . . . . . . . . . . 80Modificar tipo de aplicacin de la memoria cach delectura de rendimiento. . . . . . . . . . . 81Comprobacin de consistencia del grupo deEnhanced Global Mirror . . . . . . . . . . 81Comprobar paridad de unidad lgica. . . . . . 82Comprobar estado de duplicacin remota . . . . 83Comprobar la consistencia del repositorio . . . . 83Comprobacin de conectividad del subsistema dealmacenamiento . . . . . . . . . . . . . 85Comprobacin del estado de Enhanced RemoteMirroring . . . . . . . . . . . . . . . 85Borrar error de Enhanced Global Mirror . . . . . 85Borrar estadsticas de canal de unidad . . . . . 86Borrar reservas de unidad lgica . . . . . . . 86Borrar sectores ilegibles de unidad lgica . . . . 87Borrar configuracin de subsistema dealmacenamiento . . . . . . . . . . . . . 87Borrar la captura de datos de diagnstico desubsistemas de almacenamiento . . . . . . . 88Borrar la captura de datos de diagnstico delsubsistema de almacenamiento . . . . . . . . 88Borrar registro cronolgico de sucesos delsubsistema de almacenamiento . . . . . . . . 89Borrar rea pendiente de firmware del subsistemade almacenamiento . . . . . . . . . . . . 89Borrar el modo de recuperacin del subsistema dealmacenamiento . . . . . . . . . . . . . 90Configurar la recogida automtica del paquete desoporte . . . . . . . . . . . . . . . . 90Convertir una unidad lgica FlashCopy en un grupode Enhanced FlashCopy . . . . . . . . . . 91Crear subsistema . . . . . . . . . . . . 91Creacin 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 lgica de Enhanced FlashCopy delgrupo de consistencia . . . . . . . . . . 101Crear correlacin de la unidad lgica de EnhancedFlashCopy del grupo de consistencia . . . . . 103Crear agrupacin de discos . . . . . . . . . 104

    Copyright IBM Corp. 2008, 2013 iii

  • Crear grupo de Enhanced FlashCopy . . . . . 110Crear imagen de Enhanced FlashCopy . . . . . 117Crear una unidad lgica de Enhanced FlashCopy 118Crear unidad lgica FlashCopy . . . . . . . 119Crear host . . . . . . . . . . . . . . 126Crear grupo de host . . . . . . . . . . . 127Crear puerto de host . . . . . . . . . . . 128Crear iniciador iSCSI . . . . . . . . . . . 129Crear unidad lgica RAID (Seleccin de unidadautomtica) . . . . . . . . . . . . . . 130Crear unidad lgica de RAID (seleccin en base alespacio libre) . . . . . . . . . . . . . 134Crear unidad lgica RAID (Seleccin de unidadmanual) . . . . . . . . . . . . . . . 137Crear una unidad lgica en una agrupacin dediscos . . . . . . . . . . . . . . . . 142Crear unidad lgica de Enhanced FlashCopy desolo lectura . . . . . . . . . . . . . . 146Crear duplicacin remota . . . . . . . . . 147Creacin de memoria cach de SSD . . . . . . 149Crear clave de seguridad del subsistema dealmacenamiento . . . . . . . . . . . . 151Creacin de Enhanced Remote Mirroring . . . . 152Crear copia de volumen . . . . . . . . . . 153Desactivar duplicacin remota. . . . . . . . 155Desactivar Enhanced Global Mirror . . . . . . 155Desactivar Enhanced Remote Mirroring . . . . 156Suprimir subsistema . . . . . . . . . . . 156Suprimir grupo de Enhanced Global Mirror . . . 156Suprimir grupo de consistencia . . . . . . . 157Suprimir una unidad lgica de EnhancedFlashCopy de un grupo de consistencia . . . . 157Suprimir la imagen de Enhanced FlashCopy delgrupo de consistencia . . . . . . . . . . 158Suprimir agrupacin de discos . . . . . . . 159Suprimir el grupo de Enhanced FlashCopy . . . 160Suprimir imagen de Enhanced FlashCopy . . . . 161Suprimir una unidad lgica de EnhancedFlashCopy . . . . . . . . . . . . . . 163Suprimir la unidad lgica de FlashCopy . . . . 164Eliminar host . . . . . . . . . . . . . 164Eliminar grupo de host . . . . . . . . . . 165Eliminar puerto de host . . . . . . . . . . 165Eliminar iniciador iSCSI . . . . . . . . . . 166Eliminar unidad lgica . . . . . . . . . . 166Supresin de VolumeGroup . . . . . . . . 167Suprimir una unidad lgica de una agrupacin dedisco . . . . . . . . . . . . . . . . 167Supresin de la memoria cach de lectura derendimiento . . . . . . . . . . . . . . 168Diagnosticar controlador . . . . . . . . . 169Diagnosticar cable de host iSCSI de controlador 170Diagnosticar duplicacin remota . . . . . . . 172Diagnstico de Enhanced Remote Mirroring . . . 172Inhabilitar gestin de clave de seguridad externa 172Deshabilitar FlashCopy . . . . . . . . . . 173Inhabilitar funcin del subsistema dealmacenamiento . . . . . . . . . . . . 174Mostrar configuracin automtica de la recogidadel paquete de soporte . . . . . . . . . . 175

    Mostrar planificacin de la recogida del paquete desoporte . . . . . . . . . . . . . . . 176Descargar firmware de unidad . . . . . . . 176Descargar valores de configuracin de alojamiento 178Descargar firmware de tarjeta medioambiental . . 178Descargar firmware de fuente de alimentacin . . 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 agrupacin de discos 183Habilitar gestin 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 caracterstica 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 lgica enuna agrupacin de disco . . . . . . . . . 190Inicializar una unidad lgica fina . . . . . . . 191Cargar base de datos de DBM de subsistema dealmacenamiento . . . . . . . . . . . . 193Localizacin de la memoria cach de lectura derendimiento . . . . . . . . . . . . . . 194Volver a copiar copia de volumen . . . . . . 194Recuperar unidad lgica RAID . . . . . . . 195Volver a crear la unidad lgica de repositorio deEnhanced Remote Mirroring . . . . . . . . 199Volver a crear clave de seguridad externa . . . . 202Volver a crear FlashCopy . . . . . . . . . 203Eliminar correlacin de LUN de unidad lgica . . 204Eliminacin de unidades de la memoria cach delectura de rendimiento . . . . . . . . . . 205Eliminar par Enhanced Global Mirroring(Duplicacin global mejorada) de un grupoEnhanced Global Mirror . . . . . . . . . . 206Eliminar volumen del grupo de Enhanced GlobalMirror . . . . . . . . . . . . . . . . 207Eliminar correlacin de LUN de unidad lgica . . 208Eliminar la unidad lgica de miembro del grupode consistencia . . . . . . . . . . . . . 209Eliminar duplicacin remota . . . . . . . . 209Eliminar Enhanced Remote Mirroring . . . . . 209Eliminar copia de volumen . . . . . . . . . 210Renombrar una unidad lgica de EnhancedFlashCopy . . . . . . . . . . . . . . 210Renombrar la memoria cach de lectura derendimiento . . . . . . . . . . . . . . 211Reparar paridad de unidad lgica . . . . . . 212

    iv IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Sustituir unidad de disco . . . . . . . . . 212Restablecimiento de las estadsticas del grupoEnhanced Global Mirror . . . . . . . . . . 213Restablecer controlador . . . . . . . . . . 215Restablecimiento de la direccin IP iSCSI . . . . 215Restablecer fecha de instalacin de batera desubsistema de almacenamiento . . . . . . . 216Restablecer datos de diagnstico de subsistema dealmacenamiento . . . . . . . . . . . . 217Restablecer lnea base iSCSI de subsistema dealmacenamiento . . . . . . . . . . . . 217Restablecer distribucin de unidades lgicas desubsistema de almacenamiento . . . . . . . 218Restablecer lnea base RLS de subsistema dealmacenamiento . . . . . . . . . . . . 218Restablecer lnea base de SAS PHY de subsistemade almacenamiento . . . . . . . . . . . 218Restablecer lnea base SOC de subsistema dealmacenamiento . . . . . . . . . . . . 219Reanudar grupo de Enhanced Global Mirror . . . 219Reanudar la unidad lgica de Enhanced FlashCopydel grupo de consistencia . . . . . . . . . 220Reanudar la operacin de retrotraccin de imagende Enhanced FlashCopy . . . . . . . . . . 221Reiniciar una unidad lgica de EnhancedFlashCopy . . . . . . . . . . . . . . 222Reanudar las operaciones de retrotraccin deFlashCopy . . . . . . . . . . . . . . 224Reanudar duplicacin remota . . . . . . . . 224Reanudacin de la memoria cach de lectura derendimiento . . . . . . . . . . . . . . 225Reavivar matriz . . . . . . . . . . . . 226Reavivar unidad de disco . . . . . . . . . 226Revivir el grupo de Enhanced FlashCopy . . . . 227Revivir la unidad lgica de Enhanced FlashCopy 227Reavivar matriz . . . . . . . . . . . . 228Guardado de las estadsticas del grupo EnhancedGlobal Mirror . . . . . . . . . . . . . 228Guardar NVSRAM de controlador . . . . . . 231Guardar estado de diagnstico de aislamiento deanomala de canal de unidad de disco . . . . . 231Guardar registro cronolgico de unidad . . . . 232Guardar registro cronolgico de alojamiento . . . 232Guardar configuracin de subsistema dealmacenamiento . . . . . . . . . . . . 233Guardar base de datos de DBM de subsistema dealmacenamiento . . . . . . . . . . . . 234Guardar el archivo de informacin del validadorDBM en el subsistema de almacenamiento . . . 234Guardar datos de diagnstico de subsistema dealmacenamiento . . . . . . . . . . . . 235Guardar la captura de datos de diagnstico delsubsistema de almacenamiento . . . . . . . 236Guardar sucesos de subsistema de almacenamiento 236Guardar inventario de firmware de subsistema dealmacenamiento . . . . . . . . . . . . 237Guardar estadsticas de InfiniBand del subsistemade almacenamiento . . . . . . . . . . . 237Guardar estadsticas iSCSI de subsistema dealmacenamiento . . . . . . . . . . . . 238

    Guardar estadsticas 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 configuracin 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 lgica de Enhanced FlashCopydel grupo de consistencia . . . . . . . . . 251Establecer controlador . . . . . . . . . . 252Establecer indicador de Accin de serviciopermitida de controlador . . . . . . . . . 255Definir la agrupacin de discos . . . . . . . 256Definir la agrupacin de discos (Modificar laagrupacin de discos) . . . . . . . . . . 259Establecer indicador de Accin de serviciopermitida de cajn . . . . . . . . . . . 260Establecer estado de canal de unidad . . . . . 261Establecer repuesto en caliente de unidad de disco 262Establecer indicador de Accin de serviciopermitida de unidad de disco . . . . . . . . 262Establecer estado de unidad . . . . . . . . 263Establecer alarma de alojamiento . . . . . . . 264Establecer identificacin de alojamiento . . . . 265Establecer indicador de Accin de serviciopermitida de alojamiento . . . . . . . . . 266Definir atributos de grupo de Enhanced FlashCopy 267Definir la exploracin del soporte del grupo deEnhanced FlashCopy . . . . . . . . . . . 268Defina la programacin del grupo de EnhancedFlashCopy . . . . . . . . . . . . . . 269Definir la exploracin del soporte de la unidadlgica de Enhanced FlashCopy . . . . . . . 273Definir la capacidad de la unidad lgica delrepositorio de la unidad lgica de EnhancedFlashCopy . . . . . . . . . . . . . . 274Definir la capacidad de la unidad lgica derepositorio del grupo de Enhanced FlashCopy . . 275Establecer unidad lgica FlashCopy . . . . . . 275Establecer unidad de disco fornea 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 lgica . . . . 282Definir los atributos de la unidad lgica . . . . 289Definir los atributos de unidad lgica para laagrupacin de discos . . . . . . . . . . . 296

    Contenido v

  • Definir la correlacin de la unidad lgica . . . . 302Establecer la unidad lgica de EnhancedFlashCopy de slo lectura a una unidad lgica delectura y escritura . . . . . . . . . . . . 303Establecer duplicacin remota . . . . . . . . 304Establecer sesin . . . . . . . . . . . . 306Establecer subsistema de almacenamiento . . . . 307Establecer posiciones de alojamiento de subsistemade almacenamiento . . . . . . . . . . . 310Establecer respuesta ICMP de subsistema dealmacenamiento . . . . . . . . . . . . 311Establecer direccin IPv4 de servidor iSNS desubsistema de almacenamiento . . . . . . . 312Establecer direccin IPv6 de servidor iSNS desubsistema de almacenamiento . . . . . . . 313Establecer puerto de escucha de servidor iSNS desubsistema de almacenamiento . . . . . . . 313Establecer actualizacin 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 lgica fina 318Establecer la sesin de descubrimiento delsubsistema de almacenamiento sin nombrar . . . 319Establecer copia de volumen . . . . . . . . 320Mostrar subsistema . . . . . . . . . . . 321Mostrar dependencias de exportacin desubsistema . . . . . . . . . . . . . . 321Mostrar dependencias de importacin desubsistema . . . . . . . . . . . . . . 322Mostrar grupo de Enhanced Global Mirror(Duplicacin global mejorada) . . . . . . . . 322Mostrar el progreso de la sincronizacin del grupoEnhanced Global Mirror . . . . . . . . . . 323Mostrar estado de diagnstico de dispositivo decopia de seguridad de memoria cach . . . . . 324Mostrar estado de diagnstico de memoria cach 325Mostrar grupo de consistencia . . . . . . . . 325Mostrar la imagen de Enhanced FlashCopy delgrupo de consistencia . . . . . . . . . . 326Mostrar controlador . . . . . . . . . . . 328Mostrar estado de diagnstico de controlador . . 329Mostrar NVSRAM de controlador . . . . . . 329Mostrar sesiones iSCSI actuales . . . . . . . 330Mostrar la agrupacin de discos . . . . . . . 330Mostrar unidad de disco . . . . . . . . . 331Mostrar estadsticas de canal de unidad . . . . 333Mostrar progreso de descarga de unidad . . . . 334Mostrar el grupo de Enhanced FlashCopy . . . . 334Mostrar imagen de Enhanced FlashCopy . . . . 336Mostrar las unidades lgicas de EnhancedFlashCopy . . . . . . . . . . . . . . 337Mostrar candidatos de unidad lgica de EnhancedRemote Mirroring . . . . . . . . . . . . 338

    Mostrar progreso de sincronizacin de unidadlgica de Enhanced Remote Mirroring . . . . . 339Mostrar estado de diagnstico de tarjeta de interfazde host . . . . . . . . . . . . . . . 339Mostrar puertos de host . . . . . . . . . . 340Mostrar unidad lgica . . . . . . . . . . 340Mostrar progreso de accin de unidad lgica . . . 342Mostrar memoria cach de lectura de rendimiento 342Mostrar matriz . . . . . . . . . . . . . 343Muestra de exportacin de la matriz . . . . . 344Mostrar dependencias de importacin de matriz 344Mostrar estadsticas de rendimiento de unidadlgica . . . . . . . . . . . . . . . . 345Mostrar reservas de unidad lgica . . . . . . 345Mostrar subsistema de almacenamiento . . . . 346Mostrar configuracin automtica de subsistema dealmacenamiento . . . . . . . . . . . . 349Mostrar la captura de datos de diagnstico desubsistemas de almacenamiento . . . . . . . 353Mostrar base de datos del subsistema dealmacenamiento DBM . . . . . . . . . . 353Mostrar la captura de datos de diagnstico delsubsistema de almacenamiento . . . . . . . 353Mostrar caractersticas del subsistema dealmacenamiento . . . . . . . . . . . . 354Mostrar iniciadores iSCSI no configurados delsubsistema de almacenamiento . . . . . . . 354Mostrar topologa de host de subsistema dealmacenamiento . . . . . . . . . . . . 355Mostrar perfil del subsistema de almacenamiento 355Mostrar correlaciones de LUN de subsistema dealmacenamiento . . . . . . . . . . . . 356Mostrar valores predeterminados de negociacinde subsistema de almacenamiento . . . . . . 356Mostrar sectores ilegibles de subsistema dealmacenamiento . . . . . . . . . . . . 356Mostrar candidatos de volmenes de EnhancedRemote Mirroring . . . . . . . . . . . . 357Mostrar el progreso de la sincronizacin delvolumen de Enhanced Remote Mirroring . . . . 358Mostrar serie . . . . . . . . . . . . . 358Mostrar unidad lgica 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 defragmentacin de subsistema . . . . . 361Iniciar exportacin de subsistema. . . . . . . 362Iniciar importacin de matriz . . . . . . . . 362Iniciar localizacin de subsistema. . . . . . . 363Iniciar sincronizacin de Enhanced Global Mirror 363Iniciar diagnstico de dispositivo de copia deseguridad de memoria cach . . . . . . . . 364Iniciar diagnstico de memoria cach . . . . . 366Iniciar la ubicacin de la agrupacin de discos . . 367Iniciar la operacin de retrotraccin del grupo deconsistencia de Enhanced FlashCopy . . . . . 368Iniciar diagnstico de controlador . . . . . . 369Iniciar rastreo de controlador . . . . . . . . 371

    vi IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Iniciar diagnsticos de aislamiento de anomala decanal de unidad . . . . . . . . . . . . 372Iniciar localizacin de canal de unidad . . . . . 373Iniciar inicializacin de unidad de disco . . . . 374Iniciar localizacin de unidad . . . . . . . . 375Iniciar reconstruccin de unidad de disco . . . . 375Iniciar localizacin de alojamiento . . . . . . 376Iniciar la operacin de retrotraccin de la imagende Enhanced FlashCopy . . . . . . . . . . 376Iniciar sincronizacin de Enhanced RemoteMirroring. . . . . . . . . . . . . . . 378Iniciar la operacin de retrotraccin de FlashCopy 378Iniciar diagnstico de tarjeta de interfaz de host 379Iniciar actualizacin de DHCP de iSCSI . . . . 381Iniciar defragmentacin de matriz . . . . . . 382Iniciar exportacin de matriz . . . . . . . . 382Iniciar importacin de matriz . . . . . . . . 383Localizar matriz de inicio . . . . . . . . . 384Iniciar inicializacin de unidad lgica . . . . . 384Iniciar borrado de unidad de disco segura. . . . 385Iniciar modelado de rendimiento de la Memoriacach de lectura de rendimiento . . . . . . . 385Iniciar localizacin de subsistema dealmacenamiento . . . . . . . . . . . . 386Iniciar el diagnstico de base de datos de laconfiguracin del subsistema de almacenamiento . 387Iniciar la captura de los datos de diagnstico delsubsistema de almacenamiento . . . . . . . 388Iniciar la actualizacin de servidor iSNS delsubsistema de almacenamiento . . . . . . . 389Detener localizacin de matriz. . . . . . . . 389Detener diagnstico de dispositivo de copia deseguridad de memoria cach . . . . . . . . 389Detener diagnstico de memoria cach . . . . . 390Detener el diagnstico de base de datos de laconfiguracin del subsistema de almacenamiento . 390Detener la operacin de retrotraccin de EnhancedFlashCopy del grupo de consistencia . . . . . 391Detener la unidad lgica de Enhanced FlashCopydel grupo de consistencia . . . . . . . . . 392Detener diagnstico de controlador . . . . . . 392Detener ubicacin de agrupacin de discos . . . 393Detener diagnsticos de aislamiento de anomalade canal de unidad . . . . . . . . . . . 393Detener localizacin de canal de unidad . . . . 393Detener localizacin de unidad . . . . . . . 394Detener localizacin de alojamiento . . . . . . 394Detener las imgenes de Enhanced FlashCopypendientes de un grupo de Enhanced FlashCopy . 394Detener la imagen de Enhanced FlashCopy . . . 395Detener la operacin de retrotraccin de unaimagen de Enhanced FlashCopy . . . . . . . 395Detener la unidad lgica de Enhanced FlashCopy 396Detener FlashCopy . . . . . . . . . . . 397Detener la operacin de retrotraccin de FlashCopy 398Detener diagnstico de tarjeta de interfaz de host 398Detener sesin iSCSI del subsistema dealmacenamiento . . . . . . . . . . . . 399Detener el modelado de rendimiento de lamemoria cach de lectura de rendimiento . . . . 399Detener copia de volumen . . . . . . . . . 401

    Detener localizacin de matriz. . . . . . . . 401Detener las imgenes de Enhanced FlashCopypendientes del grupo de consistencia . . . . . 402Detener descarga de firmware de unidad desubsistema de almacenamiento . . . . . . . 402Detener localizacin de subsistema dealmacenamiento . . . . . . . . . . . . 402Detener copia de volumen . . . . . . . . . 403Suspender grupo de Enhanced Global Mirror . . 403Suspender duplicacin 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 funcin . . . 408

    Mandatos de subsistema . . . . . . . . 408Mandatos de Enhanced Global Mirroring . . . 409Mandatos de controlador . . . . . . . . 410Mandatos de base de datos . . . . . . . . 411Mandatos de captura de datos de diagnstico 411Mandatos de agrupaciones de discos . . . . 412Mandatos de unidad de disco . . . . . . . 412Mandatos de alojamiento . . . . . . . . 413Mandatos de Enhanced FlashCopy . . . . . 413Mandatos de Enhanced Remote Mirroring. . . 415Mandatos de gestin de caractersticas . . . . 416Mandatos FlashCopy . . . . . . . . . . 416Mandatos de topologa de host . . . . . . 416Mandatos iSCSI . . . . . . . . . . . 417Mandatos de unidad lgica (para unidadeslgicas finas y estndar de una agrupacin dediscos). . . . . . . . . . . . . . . 417Mandatos de anlisis de la unidad lgica derepositorio . . . . . . . . . . . . . 418Mandato de sesin . . . . . . . . . . 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

    Captulo 4. Configuracin de unsubsistema de almacenamiento . . . 423Conceptos de configuracin . . . . . . . . 424

    Controladores . . . . . . . . . . . . 425Unidades de disco. . . . . . . . . . . 432Repuestos en caliente. . . . . . . . . . 433Subsistemas . . . . . . . . . . . . . 434Disk Pools . . . . . . . . . . . . . 435Unidades lgicas . . . . . . . . . . . 437Niveles RAID . . . . . . . . . . . . 439Hosts . . . . . . . . . . . . . . . 441Grupos de host . . . . . . . . . . . . 441Puertos de host de adaptador de bus de host 442Nmeros de unidad lgica . . . . . . . . 443

    Configuracin de un subsistema dealmacenamiento . . . . . . . . . . . . 443

    Contenido vii

  • Cmo determinar qu hay en el subsistema dealmacenamiento . . . . . . . . . . . 444Borrado de la configuracin . . . . . . . 459Utilizacin del mandato de configuracinautomtica . . . . . . . . . . . . . 459Utilizacin del mandato Create LogicalDrive 463

    Configurar un subsistema de almacenamiento conlas agrupaciones de discos . . . . . . . . . 467Modificar la configuracin . . . . . . . . . 475

    Establecimiento de los relojes de controlador 476Establecimiento de la contrasea de subsistemade almacenamiento . . . . . . . . . . 476Establecimiento del tipo de host de subsistemade almacenamiento . . . . . . . . . . 476Establecimiento de la memoria cach desubsistema de almacenamiento . . . . . . 477Establecimiento de la prioridad de modificacin 481Asignacin de repuestos en caliente globales 482Cmo guardar una configuracin en un archivo 482

    Captulo 5. Utilizacin de la funcinprincipal FlashCopy . . . . . . . . 485Cmo funciona FlashCopy . . . . . . . . . 485Creacin de una unidad lgica FlashCopy . . . . 487

    Creacin de una unidad lgica FlashCopy conunidades de disco asignada por el usuario . . 487Creacin de una unidad lgica FlashCopy conunidades de disco asignadas por el software . . 488Creacin de una unidad lgica FlashCopyespecificando un nmero de unidades de disco . 489Parmetros definidos por el usuario . . . . . 489Nombres de unidad lgica FlashCopy ynombres de unidad lgica de repositorioFlashCopy . . . . . . . . . . . . . 491

    Cambio en la configuracin de la unidad lgicaFlashCopy . . . . . . . . . . . . . . 492Detener, reiniciar y suprimir una unidad lgicaFlashCopy . . . . . . . . . . . . . . 492

    Captulo 6. Using the EnhancedFlashCopy Images premium feature. . 495Acerca de la funcin principal de imgenes deEnhanced FlashCopy . . . . . . . . . . . 496Trabajar con la caracterstica premium de imgenesde 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 programacin de una imagen deEnhanced FlashCopy . . . . . . . . . . 505Suprimir un grupo de imagen de EnhancedFlashCopy (con opciones) . . . . . . . . 507Crear unidades lgicas del grupo deconsistencia de Enhanced FlashCopy . . . . 508Suprimir una imagen de Enhanced FlashCopyde un grupo de consistencia . . . . . . . 511

    Crear una unidad lgica de la imagen deEnhanced FlashCopy . . . . . . . . . . 512Restaurar una unidad lgica de imagen deEnhanced FlashCopy de un grupo deconsistencia . . . . . . . . . . . . . 513Suprimir una unidad lgica de la imagen deEnhanced FlashCopy . . . . . . . . . . 513Cambiar el tamao de la unidad lgica derepositorio . . . . . . . . . . . . . 514Iniciar, detener y reanudar una operacin deretrotraccin de la imagen de EnhancedFlashCopy . . . . . . . . . . . . . 516

    Captulo 7. Acerca de la caractersticaprincipal de Enhanced Global Mirror . 521Creacin de un par duplicado de Enhanced GlobalMirror . . . . . . . . . . . . . . . . 526Cambio de los valores de Enhanced GlobalMirroring. . . . . . . . . . . . . . . 532Suspensin y reanudacin del grupo EnhancedGlobal Mirror . . . . . . . . . . . . . 533Resincronizacin manual de unidades lgicas enun grupo de Enhanced Global Mirror . . . . . 534Cambio de roles de Enhanced Global Mirroring 535Cancelacin de un cambio de rol de grupo deEnhanced Global Mirror Group pendiente . . . . 536Resolucin de conflictos de rol . . . . . . . 536Eliminacin de unidades lgicas del grupoEnhanced Global Mirror . . . . . . . . . . 537Supresin de un grupo de Enhanced Global Mirror 538

    Captulo 8. Acerca de la caractersticaprincipal de Enhanced RemoteMirroring . . . . . . . . . . . . . 541Cmo funciona Enhanced Remote Mirroring . . . 541

    Unidades lgicas de repositorio de duplicacin 542Relaciones de duplicacin . . . . . . . . 543Rplica de datos . . . . . . . . . . . 543Interrupciones de enlace o errores de unidadlgica secundaria . . . . . . . . . . . 545Resincronizacin . . . . . . . . . . . 545

    Creacin de un par de duplicacin remota . . . 546Consideraciones acerca del rendimiento . . . 546Habilitacin de la caracterstica EnhancedRemote Mirroring . . . . . . . . . . . 547Activacin de la caracterstica Enhanced RemoteMirroring. . . . . . . . . . . . . . 547Determinacin de candidatos para un par deduplicacin remota . . . . . . . . . . 550Creacin de un par de duplicacin remota . . 550

    Cambio de valores de Enhanced Remote Mirroring 551Suspensin y reanudacin de una relacin deduplicacin . . . . . . . . . . . . . . 552Eliminacin de una relacin de duplicacin . . . 553Supresin de una unidad lgica primaria o unaunidad lgica secundaria . . . . . . . . . 553Inhabilitacin de la caracterstica Enhanced RemoteMirroring. . . . . . . . . . . . . . . 553Desactivacin de la caracterstica Enhanced RemoteMirroring. . . . . . . . . . . . . . . 554

    viii IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Interaccin con otras funciones . . . . . . . 554Particionamiento de almacenamiento . . . . 554Unidades lgicas FlashCopy . . . . . . . 554Copia de volumen. . . . . . . . . . . 555Dynamic Logical Drive Expansion (DVE) . . . 555

    Programa de utilidad Enhanced Remote Mirroring 556Descripcin del programa de utilidad EnhancedRemote Mirroring . . . . . . . . . . . 556Operacin del programa de utilidad EnhancedRemote Mirroring . . . . . . . . . . . 557Ejecucin del programa de utilidad EnhancedRemote Mirroring . . . . . . . . . . . 557Programa de utilidad de configuracin . . . . 558

    Captulo 9. Utilizacin de la funcinprincipal de copia de volumen . . . . 561Cmo funciona la copia de volumen . . . . . 561

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

    Creacin de VolumeCopy lgico . . . . . . . 565Habilitacin de la caracterstica de VolumeCopylgico . . . . . . . . . . . . . . . 565Determinacin de candidatos de VolumeCopylgicos . . . . . . . . . . . . . . 565Creacin de VolumeCopy lgica . . . . . . 566

    Visualizacin de las propiedades de VolumeCopylgico . . . . . . . . . . . . . . . . 567Cambio de configuracin de VolumeCopy lgica 568Cmo volver a copiar una unidad lgica . . . . 569Detencin de un VolumeCopy lgico . . . . . 570Eliminacin de pares de copia . . . . . . . . 570Interaccin con otras caractersticas . . . . . . 571

    Particionamiento de almacenamiento . . . . 571Unidades lgicas FlashCopy . . . . . . . 571Enhanced Remote Mirroring . . . . . . . 572

    Captulo 10. Utilizacin de lacaracterstica principal de la memoriacach de lectura de rendimiento . . . 575Creacin de memoria cach de lectura derendimiento, adicin y eliminacin de volmenes . 577Modelado de rendimiento de la memoria cach delectura de rendimiento . . . . . . . . . . 577Tareas de gestin de la memoria cach de lecturade rendimiento . . . . . . . . . . . . . 581

    Captulo 11. Mantenimiento de unsistema de almacenamiento . . . . . 585Mantenimiento rutinario. . . . . . . . . . 585

    Ejecucin de una exploracin de soporte . . . 585Ejecucin de una comprobacin de redundancia 586Restablecimiento de un controlador . . . . . 587Habilitacin de una transferencia de datos decontrolador . . . . . . . . . . . . . 587Restablecimiento de la edad de la batera . . . 587

    Eliminacin de reservas persistentes . . . . . 587Sincronizacin de los relojes de controlador . . 588Localizacin de unidades de disco . . . . . 588Reubicacin de un subsistema . . . . . . . 588

    Ajuste de rendimiento . . . . . . . . . . 590Supervisin del rendimiento . . . . . . . 590Cambio de niveles de RAID . . . . . . . 591Cambio del tamao de segmento . . . . . . 592Cambio de parmetros de memoria cach . . . 592Desfragmentacin de un subsistema . . . . . 592

    Resolucin de problemas y diagnsticos . . . . 593Recopilacin de todos los datos de soporte . . 593Recopilacin de datos de unidad . . . . . . 595Diagnsticos de un controlador . . . . . . 595Ejecucin de diagnsticos de estado de enlacede lectura . . . . . . . . . . . . . 596Recopilacin de estadsticas de errores deconmutacin en un chip . . . . . . . . . 599

    Operaciones de recuperacin . . . . . . . . 600Establecimiento de la modalidad de operacindel controlador . . . . . . . . . . . . 600Cambio de la propiedad del controlador . . . 601Inicializacin de una unidad . . . . . . . 601Reconstruccin de una unidad. . . . . . . 602Inicializacin de una unidad lgica . . . . . 602Redistribucin de unidades lgicas . . . . . 602Sustitucin de CRU . . . . . . . . . . 603

    Captulo 12. Ejemplos de informacindevuelta por los mandatos Show . . . 605Mostrar mandato de subsistema dealmacenamiento . . . . . . . . . . . . 605Mostrar NVSRAM de controlador . . . . . . 645Mostrar unidad. . . . . . . . . . . . . 650Mostrar estado de canal de unidad . . . . . . 653Mostrar unidades lgicas . . . . . . . . . 658

    Captulo 13. Archivos de script deejemplo . . . . . . . . . . . . . . 665Ejemplo 1 de script de configuracin . . . . . 665Ejemplo 2 de script de configuracin . . . . . 667

    Captulo 14. Mandatos y parmetrosen desuso . . . . . . . . . . . . . 669Mandatos en desuso . . . . . . . . . . . 669Parmetros en desuso . . . . . . . . . . 669

    Contenido ix

  • Apndice A. Ejemplos de informacindevuelta por los mandatos show . . . 671

    Apndice B. Archivos de script deejemplo . . . . . . . . . . . . . . 703Apndice C. Programa de utilidad deduplicacin de Global Copy . . . . . 707

    Apndice D. Conversin de simplex aduplex . . . . . . . . . . . . . . 713

    Apndice E. Documentacin adicional 719

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

    Notas importantes . . . . . . . . . . . . 725Formato de la documentacin . . . . . . . . 725

    ndice. . . . . . . . . . . . . . . 727

    x IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Figuras1. 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 mdulo 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 . . . . . . . 43010. 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 Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Tablas1. Convenciones de sintaxis de los nombres de los

    mandatos . . . . . . . . . . . . . 22. Terminales de la lnea de mandatos . . . . . 43. Constantes de rastreo vlidas . . . . . . 104. Estado de salida . . . . . . . . . . . 145. Operaciones de configuracin y gestin 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 mdulos de controlador . . . . . . 42510. Nmero mximo de unidades de disco 43211. Nmero mximo de unidades de disco en un

    unidad de disco basado en la capacidad . . 43512. Especificaciones de unidad lgica por el

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

    13. Especificaciones de unidad lgica por elmodelo de controlador soportado (para laserie DCS) . . . . . . . . . . . . 438

    14. Configuraciones de nivel RAID . . . . . 44015. Nmero mximo de puertos de host de HBA

    por controlador . . . . . . . . . . . 44216. Valores predeterminados para tamao de

    segmento y bsqueda anticipada de lecturade la memoria cach . . . . . . . . . 462

    17. Recuento de unidades y el nmero deunidades de disco reservadas parareconstruccin . . . . . . . . . . . 467

    18. Valores para el parmetrocacheFlushModifier . . . . . . . . . 479

    19. Componentes de una unidad lgicaFlashCopy . . . . . . . . . . . . 485

    20. Mandatos de la unidad lgica FlashCopy 48621. Parmetros de la unidad lgica FlashCopy 48922. Estado de la operacin de retrotraccin de

    FlashCopy . . . . . . . . . . . . 51923. Nmero mximo de duplicaciones definidas 54224. Mandatos de copia de volumen . . . . . 56425. Informacin sobre el rendimiento del

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

    almacenamiento. . . . . . . . . . . 59327. Datos de lnea base RLS para el subsistema

    de almacenamiento . . . . . . . . . 59728. Mandatos en desuso . . . . . . . . . 66929. Parmetros en desuso . . . . . . . . . 669

    Copyright IBM Corp. 2008, 2013 xiii

  • xiv IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Acerca de este documentoEste documento es una gua de programacin que describe la interfaz de lnea 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 parmetrospara los mandatos. El cdigo de la interfaz de lnea de mandatos se instalaautomticamente como parte de la instalacin del cliente de IBM DS StorageManager.

    Para obtener instrucciones sobre la instalacin de DS Storage Manager V10.77 oanterior, consulte IBM System Storage DS Storage Manager Versin 10 Installation andHost Support Guide.

    Para obtener instrucciones sobre la instalacin de DS Storage Manager V10.83 oposterior, consulte IBM System Storage DS Storage Manager Versin 10.8 Installationand Host Support Guide.

    Este documento no cubre la instalacin o integracin del hardware. Para obtenerms informacin sobre estos temas, consulte la Gua de instalacin y soporteapropiada para su subsistema de almacenamiento. Consulte Apndice E,Documentacin adicional, en la pgina 719 para obtener una lista de estosdocumentos.

    Consulte los archivos lame de las series DS3000, DS4000, DS5000 y DCS paraobtener la informacin ms reciente relativa a los productos de hardware, softwareo firmware que no se describan en este documento.

    Lo nuevo en esta guaEsta gua contiene referencias al nuevo subsistema de almacenamiento DCS3860.

    La versin previamente publicada de esta gua contiene informacin acerca de lasmejoras en IBM DS Storage Manager versin 10.84.xx con firmware de controladorversin 7.84.xx.xx:v Caracterstica principal de Enhanced Global Mirroring: para obtener ms

    detalles, consulte Captulo 7, Acerca de la caracterstica principal de EnhancedGlobal Mirror, en la pgina 521.

    v Caracterstica principal de Enhanced Remote Mirroring: para obtener msdetalles, consulte Captulo 8, Acerca de la caracterstica principal de EnhancedRemote Mirroring, en la pgina 541.

    v Nuevos apndices aadidos: Apndice A, Ejemplos de informacin devuelta por los mandatos show, en

    la pgina 671 Apndice B, Archivos de script de ejemplo, en la pgina 703 Apndice C, Programa de utilidad de duplicacin de Global Copy, en la

    pgina 707 Apndice D, Conversin de simplex a duplex, en la pgina 713

    v Mandatos introducidos en esta versin:

    Copyright IBM Corp. 2008, 2013 xv

  • Mandatos de Enhanced Global Mirroring en la pgina 409v Mandatos actualizados en esta versin:

    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 diagnstico de memoria cach Show array export dependenciesy Iniciar diagnstico de dispositivo de copia de seguridad de memoria

    cach

    Iniciar el diagnstico de base de datos de la configuracin 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 versin: start rollback (volume [flashcopyVolumeName | volumes [flashcopyVolumeName1 ... flashcopyVolumeNamen])

    Novedades en la versin DS Storage Manager 10.83 con versinde firmware del controlador 7.83.xx.xx

    Esta gua contiene informacin sobre las mejoras de la versin de IBM DS StorageManager 10.83.xx con el firmware del controlador versin 7.83.xx.xx:v Enhanced FlashCopy: para obtener ms detalles, consulteCaptulo 6, Using the

    Enhanced FlashCopy Images premium feature, en la pgina 495.v Agrupaciones de discos: para obtener ms detalles, consulte Disk Pools en la

    pgina 435.v Mandatos introducidos en esta versin:

    Mandatos de agrupaciones de discos en la pgina 412

    xvi IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Mandatos de Enhanced FlashCopy en la pgina 413 Mandatos de anlisis de la unidad lgica de repositorio en la pgina 418 Mandatos de la recogida del paquete de soporte en la pgina 422

    v Mandatos actualizados en esta versin: 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 duplicacin 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 Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Stop Drive Channel Fault Isolation Diagnosticsv Mandatos que se han quedado obsoletos en esta versin:

    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 lnea 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 Versin 10.xx junto

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

    firmware de controlador DS4000 versin 07.xx.xx.xx y posteriores.

    Nota: Algunos mandatos de script tambin se soportan en versiones anterioresdel firmware de controlador DS4000. Consulte Mandatos de las series DS3000,DS4000, DS5000 y DCS con niveles de firmware mnimos en la pgina 36 paraconocer el firmware de controlador mnimo necesario para soportar cadamandato de script. Esta tabla tambin muestra qu mandatos slo 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 versin 10.50 y posteriores juntocon el firmware de controlador DS5000 versin 07.50 y posteriores.

    Quin debe leer este documentoEste documento da por supuesto que el usuario cuenta con conocimientos bsicosde hardware de la red de rea de almacenamiento (SAN) y con capacidad pararealizar la instalacin.

    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 reparacin de sistemas informticos. Adems,deberan entender la tecnologa de almacenamiento en disco, los conceptos delconjunto redundante de subsistemas independientes (RAID), las redes y lastecnologas de canal de fibra (FC) e iSCSI. El lector debe tener conocimientosbsicos 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, diseados para resaltar la siguiente informacinclave:

    Nota: Estos avisos ofrecen sugerencias, orientaciones o consejos.

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

    Atencin:Estos avisos indican posibles daos a programas, dispositivos o datos. Elaviso de atencin se sita justo antes de la instruccin o situacin en la quepodra producirse el dao.

    Obtener informacin, ayuda y serviciosSi necesita ayuda, servicio o asistencia tcnica, o bien si solo desea msinformacin sobre los productos IBM, encontrar una gran variedad de fuentesdisponibles en IBM para ayudarle. Esta seccin contiene informacin sobre dndeir para obtener informacin adicional acerca de IBM y los productos de IBM, quhacer si tiene algn problema con su sistema y a quin 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 estn conectados.v Compruebe los interruptores de alimentacin para asegurarse de que el sistema

    est encendido.v Utilice la informacin de resolucin de problemas de la documentacin del

    sistema y utilice las herramientas de diagnstico que acompaan al sistema.v Compruebe la informacin tcnica, las sugerencias, los consejos y los nuevos

    controladores de dispositivos en las pginas web de ayuda de IBM que seenumeran en esta seccin.

    v Utilice un foro de discusin de IBM en la pgina web de IBM para realizarpreguntas.

    Puede resolver numerosos problemas sin ayuda externa siguiendo losprocedimientos de resolucin de problemas que proporciona IBM en la ayuda enlnea de Storage Manager o en los documentos que se proporcionan con el sistemay el software. La informacin que acompaa al sistema tambin describe laspruebas de diagnstico que puede realizar. La mayora de subsistemas, sistemasoperativos y programas vienen con informacin que contiene procedimientos deresolucin de problemas y explicaciones sobre mensajes de error y cdigos deerror. Si sospecha que existe un problema de software, consulte la informacin delsistema operativo o del programa.

    Utilizacin de la documentacinLa informacin sobre su sistema de IBM y el software instalado previamente, siexiste, est disponible en los documentos que acompaan al sistema. Entre ellos seincluyen libros impresos, documentos en lnea, archivos readme y archivos deayuda. Consulte la informacin de resolucin de problemas en la documentacindel sistema para obtener instrucciones sobre la utilizacin de los programas dediagnstico. Es posible que la informacin de resolucin de problemas o los

    xx IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

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

    Bsqueda de software, firmware de controlador y archivosreadme de Storage Manager

    El software y el firmware de controlador de Storage Manager estn disponibles enel DVD del producto y tambin pueden descargase desde la Web. Los archivosreadme de Storage Manager tambin 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 ms 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 pgina 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 pgina de ayuda de su subsistema de almacenamiento, pulse

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

    4. En la seccin Storage Manager de la tabla, localice su sistema operativo y elnivel de la versin y pulse el enlace de la versin, en la columna de la derecha.Se abrir la pgina concreta de su subsistema de almacenamiento y versin delsistema operativo.

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

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

    La informacin ms actualizada sobre los subsistemas de almacenamiento de lasseries DS3000, DS4000, DS5000 y DCS y Storage Manager, incluyendodocumentacin y las descargas ms 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 lame ypginas 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 informacin de soporte tcnico de su configuracin especfica dehost/subsistema de almacenamiento de las series DS3000, DS4000, DS5000,DS5020 y DCS, incluyendo las versiones de firmware ms recientesrecomendadas para su sistema utilizando este programa de utilidadinteractivo basado en web:

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

    Activacin de la caracterstica principal de las series DS3000, DS4000, DS5000 yDCS de IBM

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

    Acerca de este documento xxi

  • 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 informacin ms reciente sobre el soporte de sistemaoperativo y HBA, el soporte de clsteres, el soporte de tejido de red derea de almacenamiento (SAN) y el soporte de caracterstica de StorageManager:

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

    Soporte de SAN (Storage Area Network - Red de rea de almacenamiento)Busque informacin sobre cmo utilizar conmutadores SAN, incluyendoenlaces a las guas 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 informacin de soporte ms 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 informacin de soporte ms 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 utilizacin 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 informacin 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 Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • v www.ibm.com/planetwide

    Soporte y servicio de hardwarePuede recibir servicio de hardware a travs de IBM Integrated Technology Serviceso a travs de su distribuidor de IBM, si su distribuidor est autorizado por IBMpara proporcionar servicio de garanta. Visite esta pgina web para obtenernmeros de telfono de soporte:

    www.ibm.com/planetwide

    En los Estados Unidos y en Canad, el soporte y servicio de hardware estdisponible las 24 horas del da, los 7 das de la semana. En el Reino Unido, estosservicios estn disponibles de lunes a viernes, de 9 a.m. a 6 p.m.

    Informacin de contacto de TaiwanEste tema contiene la informacin de contacto del servicio para productos de IBMpara Taiwn.Informacin de contacto del servicio para productos de IBM para Taiwn:IBM Taiwan Corporation3F, No 7, Song Ren Rd., Taipei TaiwanTel: 0800-016-888

    Sistemas de proteccin contra incendiosEl sistema de proteccin contra incendios es responsabilidad del cliente. Se debeconsultar con la entidad aseguradora del cliente, con un inspector de incendioslocal o con un inspector de construccin local, o con todos ellos, a la hora deseleccionar un sistema de proteccin contra incendios que proporcione el nivelcorrecto de cobertura y proteccin. IBM disea y fabrica el equipo segn losestndares internos y externos que requieren determinados entornos para funcionarde manera fiable. Dado que IBM no comprueba la compatibilidad de ningnequipo con los sistemas de proteccin contra incendios, IBM no realiza ningunaafirmacin de compatibilidad de ninguna clase ni proporciona recomendacionessobre sistemas de proteccin contra incendios.

    f2c0

    07

    90

    Acerca de este documento xxiii

  • xxiv IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Captulo 1. Acerca de la interfaz de lnea de mandatosAtencin: IBM le recomienda que utilice la GUI de cliente de Storage Managerpara gestionar sus subsistemas de almacenamiento. La interfaz de lnea demandatos no tiene ningn mecanismo para evitar que se realicen por error cambiosno deseados en el subsistema de almacenamiento. Dado que los mandatos descript pueden daar una configuracin y provocar la prdida del acceso a los datossi no se utilizan correctamente, IBM le recomienda que utilice la GUI de cliente deStorage Manager para gestionar la configuracin de sus subsistemas dealmacenamiento.

    La interfaz de lnea 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 travs de una ventana de script,que se invoca desde la ventana Empresa del cliente de IBM DS Storage Manager, oa travs de la interfaz de lnea de mandatos utilizando el programa SMcli. Elmotor de mandatos de script se instala automticamente como parte de lainstalacin del cliente de IBM DS Storage Manager.

    Cada mandato realiza una accin especfica para gestionar un subsistema dealmacenamiento o devolver informacin sobre el estado de un subsistema dealmacenamiento. Puede introducir mandatos individuales o puede ejecutararchivos de script cuando necesite realizar operaciones ms de una vez. Porejemplo, puede ejecutar archivos de script cuando desee instalar la mismaconfiguracin 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 gestin del almacenamiento enms de un subsistema de almacenamiento en red. Puede utilizar la CLI tanto ensitios de instalacin como en entornos de desarrollo.

    Cmo utilizar la interfaz de lnea 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 parmetros del entorno operativo.

    Un mandato CLI consta de estos elementos:v El trmino SMcliv El identificador del subsistema de almacenamientov Parmetrosv Mandatos de script

    Un mandato CLI tiene esta forma:

    SMcli storageSubsystem parameters script-commands;

    v SMcli invoca la interfaz de lnea 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 direccin IP del subsistema dealmacenamiento.

    v parameters son los parmetros CLI que definen el entorno y la finalidad delmandato.

    v script-commands son uno o ms mandatos de script o el nombre de un archivode script que contiene mandatos de script. (Los mandatos de script son losmandatos de configuracin del subsistema de almacenamiento.)

    Notas de usoSi introduce SMcli y el nombre de un subsistema de almacenamiento pero noespecifica parmetros CLI, mandatos de script o un archivo de script, la interfaz delnea 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 configuracin y probar rpidamente los cambios deconfiguracin.

    Para finalizar una sesin en modo interactivo, escriba el mandato especfico 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 finalizacin (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 parmetros, las opciones o las terminales correctas, el motor de scriptsdevuelve la informacin de uso.

    Mandatos de CLILas 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 mandatosConvencin Definicin

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

    cursivasUna terminal que necesita una entrada del usuariopara llenar un parmetro (una respuesta a unavariable)

    [ ... ] (corchetes) Ninguna o una aparicin (los corchetes tambin seutilizan como delimitador en algunos parmetros demandatos)

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

    negrita Una terminal que necesita que se introduzca unparmetro de mandato para iniciar una accin

    A continuacin tiene las formas generales de los mandatos CLI, que muestran lasterminales y los parmetros que se utilizan en cada mandato.

    2 IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea 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 -?

    Captulo 1. Acerca de la interfaz de lnea de mandatos 3

  • Terminales de la lnea de mandatosTabla 2. Terminales de la lnea de mandatosTerminal Definicin

    host-name-or-IP-address Especifica el nombre de host o la direccin 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 travs de la gestin de almacenamientoen banda, debe utilizar la terminal -n o la terminal -w sihay ms de un subsistema de almacenamiento conectado alhost.

    v Si est gestionando un subsistema de almacenamientoutilizando la gestin de almacenamiento fuera de banda atravs de la conexin 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.

    -AAade un subsistema de almacenamiento al archivo deconfiguracin. Si no acompaa la terminal -A con unhost-name-or-IP-address, el descubrimiento automtico explorala subred local en busca de subsistemas de almacenamiento.

    -a Aade un destino de excepcin del protocolo simple degestin de red (SNMP) o un destino de alerta de la direccinde correo electrnico.

    v Al aadir un destino de excepcin de SNMP, la comunidadSNMP se define automticamente como el nombre de lacomunidad para la excepcin y el host es la direccin IP onombre de host del servidor de nombres de dominio (DNS)del sistema al que debera enviarse la excepcin.

    v Al aadir una direccin de correo electrnico para undestino de alerta, la email-address es la direccin de correoelectrnico a la que desea que se enve el mensaje de alerta.

    -c Indica que est introduciendo uno o ms mandatos de scriptpara que se ejecuten en el subsistema de almacenamientoespecificado. Finalice cada mandato con un punto y coma (;).No puede colocar ms de una terminal -c en la misma lneade mandatos. Puede incluir ms de un mandato de scriptdespus de la terminal -c.

    -dMuestra el contenido del archivo de configuracin del script.El contenido del archivo adopta este formato:

    storage-system-name host-name1 host-name2

    -e Ejecuta los mandatos sin realizar antes una comprobacin desintaxis.

    4 IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Tabla 2. Terminales de la lnea de mandatos (continuacin)Terminal Definicin

    -F (mayscula) Especifica la direccin de correo electrnico desde la que seenviarn todas las alertas.

    -f (minscula)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 ejecutndose. Para variar este comportamiento,utilice el mandato set session errorAction=stop en elarchivo de script.

    -gEspecifica el archivo ASCII que contiene la informacin decontacto del remitente del correo electrnico que se incluir entodas las notificaciones de alerta de correo electrnico. La CLIda por supuesto que el archivo ASCII es de solo texto, sindelimitadores o sin ningn 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 informacin que se incluye en lasnotificaciones de alerta de correo electrnico. Puedeseleccionar estos valores:

    v eventOnlyv profilev supportBundle

    -iMuestra la direccin 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 direccin IP del servidor decorreo electrnico desde el que se envan las notificaciones dealerta de correo electrnico.

    Captulo 1. Acerca de la interfaz de lnea de mandatos 5

  • Tabla 2. Terminales de la lnea de mandatos (continuacin)Terminal Definicin

    -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 estutilizando el mtodo en banda para gestionar el subsistema dealmacenamiento, debe utilizar la terminal -n si hay ms de unsubsistema de almacenamiento conectado al host en ladireccin 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 utilizacin en laEnterprise Management Window (es decir, el nombre se citaen el archivo de configuracin) no debe ser un nombreduplicado de ningn 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 salidaestndar (stdout). Toda salida de los mandatos que no seanmandatos de script se enva a stdout, independientemente desi esa terminal est definida.

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

    v No se ha definido una contrasea en el subsistema dealmacenamiento.

    v La contrasea se especifica en un archivo de script que estejecutando.

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

    -q Especifica la frecuencia con la que desea incluir informacinde perfiles adicionales o de paquetes de soporte en lasnotificaciones de alerta del correo electrnico. Siempre segenera una notificacin de alerta de correo electrnico quecontiene la informacin de suceso bsica para cada sucesocrtico. Si establece la terminal -I en eventOnly, el nico valorvlido para la terminal -q es everyEvent. Si establece laterminal -I en el valor profile o en el valor supportBundle,esta informacin se incluye en los correos electrnicos con lafrecuencia especificada por la terminal -q. Estos valores sonvalores de frecuencia vlidos:

    v everyEvent Se devuelve informacin con cadanotificacin de alerta de correo electrnico.

    v 2 La informacin se devuelve solo una vez cada doshoras.

    v 4 La informacin se devuelve solo una vez cada cuatrohoras.

    v 8 La informacin se devuelve solo una vez cada ochohoras.

    v 12 La informacin se devuelve solo una vez cada 12horas.

    v 24 La informacin se devuelve solo una vez cada 24horas.

    6 IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Tabla 2. Terminales de la lnea de mandatos (continuacin)Terminal Definicin

    -quickReduce el tiempo necesario para ejecutar una operacin delnea nica. Un ejemplo de una operacin de lnea nica es elmandato re-create FlashCopy LogicalDrive. Esta terminalreduce el tiempo al no ejecutar procesos de fondo durante laduracin del mandato.

    No utilice esta terminal para operaciones que impliquen msde una operacin de lnea nica. El uso reiterado de estemandato puede desbordar al controlador con ms mandatosde los que el controlador puede procesar, lo que provocar unfallo operativo. Adems, las actualizaciones de estado y deconfiguracin que se recogen habitualmente desde losprocesos de fondo no estarn disponibles en la CLI. Estaterminal provoca que las operaciones que dependen de lainformacin de fondo fallen.

    -rDefine o cambia las notificaciones de alerta para todos lossubsistemas de almacenamiento gestionados por unadeterminada estacin de gestin 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 (mayscula) Suprime los mensajes informativos que describen el progresodel mandato que aparecen al ejecutar mandatos de script. (Lasupresin de los mensajes informativos tambin se denominamodo silencioso.) Esta terminal suprime estos mensajes:

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

    -s (minscula) Muestra los valores de alerta en el archivo de configuracincuando se utiliza con la terminal -d.

    -v Muestra el estado global actual de los dispositivos conocidosen un archivo de configuracin 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 (mayscula) Elimina un subsistema de almacenamiento de unaconfiguracin.

    -x (minscula) Elimina un destino de excepcin de SNMP o un destino dealerta de la direccin de correo electrnico. La comunidad es elnombre de la comunidad SNMP para la excepcin y el host esla direccin IP o nombre de host del DNS del sistema al quedesea enviar la excepcin.

    Captulo 1. Acerca de la interfaz de lnea de mandatos 7

  • Tabla 2. Terminales de la lnea de mandatos (continuacin)Terminal Definicin

    -? Muestra la informacin de uso de los mandatos CLI.

    Consideraciones sobre el formatoLas comillas dobles ( ) que se utilizan como parte de un nombre o etiquetarequieren una consideracin especial al ejecutar los mandatos CLI y los mandatosde script en un sistema operativo de Microsoft Windows. Esta seccin describecmo 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 carcter 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(tambin 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 carcter descript especial. Los caracteres especiales son ^, | , .

    Inserte un acento circunflejo antes de cada carcter 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 carcter 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 Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • v Si la CLI debe terminar de forma anmala 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 archivoestndar.

    v La CLI guarda automticamente los datos en un archivo. No se necesitanopciones especiales de la lnea de mandatos para guardar los datos de errores.

    v No necesita realizar ninguna accin para guardar los datos del error en unarchivo.

    v La CLI no tiene ninguna provisin para evitar que se sobrescriba una versinexistente 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 informacinque describe el error directamente en la lnea de mandatos y define un cdigo deretorno. En funcin del cdigo de retorno, es posible que la CLI tambin grabeinformacin adicional sobre qu terminal provoc el error. La CLI tambin escribeinformacin sobre qu esperaba encontrar en la sintaxis del mandato para ayudarlea identificar cualquier posible error que haya podido introducir.

    Cuando se produce una excepcin mientras se est ejecutando un mandato, la CLIcaptura el error. Al final del procesamiento del mandato (despus de que se hayaescrito la informacin de procesamiento del mandato en la lnea de mandatos), laCLI guarda automticamente la informacin del error en un archivo.

    El nombre del archivo en el que se guarda la informacin 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 razn 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 ubicacin. El archivo excprpt.txt sesobrescribe cada vez que se produce una excepcin. Si desea guardar lainformacin en el archivo excprpt.txt, debe copiar la informacin en un archivonuevo o un directorio nuevo.

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

    HKLM\SOFTWARE\storage\SMclient\SunJVMOption1

    En una instalacin tpica sin cambios en el directorio de instalacinpredeterminado, la ubicacin 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 informacin de SMcli durante la ejecucin del mandato para ayudar alservicio de soporte tcnico de IBM en la resolucin de problemas de SMcli. Elrecurso de rastreo se habilita escribiendo -trace en la lnea 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

    Captulo 1. Acerca de la interfaz de lnea 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 seccin de ejemplo.

    Las opciones ms comunes para la interaccin de depuracin con el subsistema dealmacenamiento son:v 0 - JALv 1 - Detalle de JALv 79 - Todos los errores y excepciones

    Nota: Cuando se habilita el rastreo, tambin se habilita 79 - Todos los errores yexcepciones.

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

    EjemploLos ejemplos que figuran a continuacin muestran el perfil mediante SMcli con elrastreo habilitado. La informacin de rastreo se graba en un archivo local de unsubsistema de almacenamiento llamado subsystemName. El subsistema dealmacenamiento se aadi anteriormente a la ventana de Enterprise Managementde su programa cliente de Storage Manager.SMcli -n subsystemName -c "show storageSubsystem profile;"-trace 0:1:79 -tracefile trace_file.txt

    SMcli -n subsystemName -c " clear storageSubsystem configuration;"-trace 0:1:2:3:79 -tracefile trace_file.txt

    Opciones de rastreo disponibles con SMcli en Storage Managerversin 10.77

    Una lista de opciones de rastreo que estn disponibles con SMcli en StorageManager versin 10.77. Las opciones de rastreo disponibles tambin se puedenmostrar ejecutando el mandato SMcli con el parmetro -trace se muestran en latabla siguiente:

    C:\Program Files\IBM_DS\client>SMcli -trace es un ejemplo de una constante derastreo que falta o no es vlida.

    Tabla 3. Constantes de rastreo vlidasOpciones de rastreo Constante de rastreo Descripcin

    0 JAL JAL

    1 JAL Detalle de JAL

    2 Agent Agente de RPC-UTM

    3 Agent Detalle de agente RPC-UTM

    4 JRPC JRPC

    5 JRPC-In Datos en bruto de JRPCdentro

    6 JRPC-Out Datos en bruto de JRPCfuera

    10 IBM System Storage DS Storage Manager Versin 10: Gua de programacin de la interfaz de lnea de mandatos y de losmandatos de script

  • Tabla 3. Constantes de rastreo vlidas (continuacin)Opciones de rastreo Constante de rastreo Descripcin

    7 DMV Errors Errores y excepciones deDMV

    8 SAM Main SAM principal

    9 SAM Physical Vista fsica principal de SAM

    10 CreateVol Create Logical drive

    11 EventViewer Visor de sucesos

    12 PerfMon Supervisor de rendimiento

    13 PerfMon Detalles del supervisor derendimiento

    14 RecGuru Gur de recuperacin

    15 ScriptEngine Motor de script

    16 Download Descarga

    17 StoragePools Agrupaciones dealmacenamiento

    18 StoragePools Detalle de agrupaciones dealmacenamiento

    19 NodeProvider DMV interno: General

    20 NP-LM DMV interno: supervisor deenlaces

    21 NP-Device DMV interno: interaccin dedispositivo

    22 DataStore DMV interno: almacn dedatos

    23 SADeviceCoupler SADeviceCoupler

    24 SAStatusMonitor SAStatusMonitor

    25 DMV Node State Sucesos de DMV: estado denodo

    26 DMV Edge State Sucesos de DMV: estado delmite

    27 DMV Domain Change Sucesos de DMV: cambios dedominio

    28 DMV Progress Evt Sucesos de DMV: progreso

    29 DMV Alert Evt Sucesos de DMV: alertas

    30 DMV Menus Visualizacin de DMV: barrade herramientas y mens

    31 DMV Tree Visualizacin de DMV: rbol

    32 DMV Table Visualizacin de DMV: tabla

    33 DMV Health Visualizacin de DMV: saludgeneral

    34 DMV Progress Visualizacin de DMV:etiqueta/barra de progreso

    35 DMV Add Op de DMV: aadirdispositivo

    Captulo 1. Acerca de la interfaz de lnea de mandatos 11

  • Tabla 3. Constantes de rastreo vlidas (continuacin)Opciones de rastreo Constante de rastreo Descripcin

    36 DMV Remove Op de DMV: eliminardispositivo

    37 DMV Comment Op de DMV: editarcomentario

    38 DMV AutoDisc Op de DMV: descubrimientoautomtico

    39 DMV Rescan Op de DMV: volver aexplorar servidor

    40 DMV Manage Op de DMV: gestionardispositivo

    41 DMV Script Op de DMV: lanzamiento descript

    42 DMV Help Op de DMV: ayuda en lnea

    43 DMV Alert Op de DMV: valor de alerta

    44 DMV Focus DMV: intentos de solicitudde foco

    45 Tools Broker Intermediario deherramientas

    46 DMV Persistent Monitor Supervisor persistente deDMV

    47 System Logger Errors Errores y excepciones delregistrador del sistema

    48 OVW Integration Integracin de OpenView

    49 Agent Detalle completo de agenteRPC-UTM

    50 Unreadable Sector Sector ilegible

    51 Parallel Drive FirmwareDownload

    Descarga de firmware deunidad paralela

    52 RVM Ping Test Prueba del ping deduplicacin

    53 TALP Launchpad de asistente detareas

    54 Framework Infraestructura

    55 Framework Engine Motor de infraestructura

    56 Profile Perfil

    57 HCA Detalle de agente de contextode host

    58 Features Caractersticas y paquetes decaractersticas

    59 State Capture Captura de estado

    60 Reset Cntrl Restablecer controlador

    61 Increase Capacity Aumentar capacidad

    62 RLS RLS

    63 FlashCopy Crear FlashCopy