B Referencia de la interfaz de línea de comandos

En este apéndice, se describen los comandos de la interfaz de línea de comandos disponibles para un usuario administrador. Dado que la CLI está basada en firmware, es posible que no todos los comandos estén disponibles para la biblioteca.

Los comandos de la CLI a los que puede acceder el administrador incluyen:

audit

Este comando realiza una auditoría física de toda la biblioteca o de una parte de ella.

audit

Muestra la ayuda para el comando audit, al igual que "help audit".

audit *

Inicia una auditoría física de la biblioteca completa. Este comando se ejecuta inmediatamente y no muestra resultados.

Ejemplo:

SL8500> audit *
   requestId
   requestId 9
   Done
   Failure Count 0
   Success Count 1
COMPLETED
audit <device address> <address>

Realiza una auditoría física de una única dirección y muestra los resultados.

  • <device address>: especifica el robot que se utilizará en formato de biblioteca, guía, columna, lado y fila.

  • <address>: especifica la ubicación de la ranura para auditar en formato de biblioteca, guía, columna, lado y fila.

Ejemplo:

SL8500> audit 1,4,0,1,0 1,4,-45,1,1
   requestId
   requestId 9
   Attributes Media Label #EMPTY..
   Object     Location    1,4,-45,1,1
   Done
   Failure Count 0
   Success Count 1
COMPLETED
audit <device address> <start address> <end address>

Realiza una auditoría física de un rango de direcciones y muestra los resultados.

  • <device address>: especifica el robot que se utilizará en formato de biblioteca, guía, columna, lado y fila.

  • <start address> <end address>: especifica la ubicación de inicio y fin de la ranura para auditar en formato de biblioteca, guía, columna, lado y fila. Únicamente la fila es variable entre las direcciones de inicio y fin.

Ejemplo:

SL8500> audit 1,4,0,1,0 1,4,-45,1,1 1,4,-45,1,2
   requestId
   requestId 10
   Attributes Media Label #EMPTY..
   Object     Location    1,4,-45,1,1
 
   Attributes Media Label EN34410R
   Object     Location    1,4,-45,1,2
   ...
   Done
   Failure Count 0
   Success Count 5
COMPLETED
audit multiRowScan {enable | disable | print} <device address>

Activa o desactiva la capacidad de auditoría de análisis de múltiples filas para acelerar el tiempo de auditoría.

  • print: imprime el estado de auditoría de análisis de múltiples filas.

  • <device address>: especifica el robot que se utilizará en formato de biblioteca, guía, columna, lado y fila.

Ejemplo:

SL8500> audit multiRowScan print 1,1,0,1,0
   requestId
   requestId 8401
   Attributes Multi Row Scan enabled
   Object     Robot          1,1,0,1,0
   Done
   Failure Count 0
   Success Count 1
COMPLETED

capCommand

Este comando se utiliza para gestionar CAP.

capCommand

Muestra la ayuda para el comando capCommand, al igual que "help capCommand".

capCommand <enable|disable> <device_address>

Activa o desactiva un CAP en una guía (CAP para carga masiva solamente). Es posible que un CAP no se pueda desactivar en ciertas situaciones, por ejemplo, si está reservado por un host.

  • <device address>: especifica el CAP que se liberará en formato de biblioteca, guía, columna, lado y fila.

capCommand forceUnreserve <device address>

Fuerza la liberación de un CAP. Si hay cartuchos en el CAP, la reserva cambia a "default". Si no hay cartuchos en el CAP, la reserva cambia a "none".

  • <device address>: especifica el CAP que se liberará en formato de biblioteca, guía, columna, lado y fila.

capCommand {lock | unlock} <device address>

Bloquea o desbloquea un CAP especificado por la dirección del dispositivo.

  • <device address>: especifica el CAP que se bloqueará/desbloqueará en formato de biblioteca, guía, columna, lado y fila.

limpieza

Esta familia de comandos muestra y controla las funciones de limpieza y diagnóstico relacionadas con los cartuchos dentro de la biblioteca. Únicamente los clientes que cuenten con la función de validación de medios deben usar estos comandos.

cleaning

Muestra la ayuda para el comando cleaning, al igual que "help cleaning".

cleaning list cleaning

Enumera todos los cartuchos de limpieza en las ranuras del sistema.

Ejemplo:

SL8500> cleaning list cleaning
   requestId
   requestId 9001
   Attributes Expired  false
      Label            CLN0080U
      Location         1,1,-52,1,13
      Max Usage Count  100
      Media Type       9840_Cleaning
      Status           ok
      Usage Count      0
Object Cartridge       cleaning
cleaning import <cap device address> [ to { 1 | 2 | 3 | 4 | * } ]

Importa los cartuchos de limpieza y diagnóstico a las ranuras del sistema. Únicamente se permite una operación de importación/exportación a la vez. Debe haber como mínimo 9 ranuras del sistema vacías para que las bibliotecas SL8500 permitan las importaciones.

  • <cap device address>: especifica el CAP que se utilizará para la operación de importación en formato de biblioteca, guía, columna, lado y fila.

  • to { 1 | 2 | 3 | 4 | * }: especifica la guía donde importar el cartucho si es posible (opcional).

Ejemplo:

SL8500> cleaning import 1,2,55,1,0 to 1
   requestId
   requestId 10101
   Message CAP open(ing). Place cartridges to import in CAP, then close CAP.Use CONTINUE cmd to proceed...
   Done
   Failure Count 0
   Success Count 0
COMPLETED
cleaning export <cap device address> cleaning select { 1 | 2 | 3 | 4 | expired }

Exporta los cartuchos de limpieza seleccionados. Únicamente se permite una operación de importación/exportación a la vez.

  • <cap device address>: especifica el CAP que se utilizará para la operación de exportación en formato de biblioteca, guía, columna, lado y fila.

  • select { 1 | 2 | 3 | 4 | expired }: especifica el número de guía desde donde exportar los cartuchos de limpieza.

Ejemplo:

SL8500> cleaning export 1,2,55,2,0 cleaning select expired
   requestId
   requestId 9601
   Address      1.4.-52.1.12
   Success      Cartridge Exported
   Volume Label CLN002CU
   Message CAP open(ing). Remove cartridges, then close CAP.Use CONTINUE cmd to proceed...
   Done
   Failure Count 0
   Success Count 1
COMPLETED
cleaning export <cap device address> <cartridge address>

Exporta un cartucho de limpieza o de diagnóstico específico al cap especificado. Únicamente se permite una operación de importación/exportación a la vez.

  • <cap device address>: especifica el CAP que se utilizará para la operación de exportación en formato de biblioteca, guía, columna, lado y fila.

  • <cartridge address>: especifica la ubicación del cartucho que se exportará en formato de biblioteca, guía, columna, lado y fila. El cartucho especificado debe estar en una ranura del sistema y debe ser un cartucho de limpieza o de diagnóstico.

Ejemplo:

SL8500> cleaning export 1,2,55,2,0 1,4,-52,1,12
   requestId
   requestId 9601
   Address      1.4.-52.1.12
   Success      Cartridge Exported
   Volume Label CLN002CU
   Message CAP open(ing). Remove cartridges, then close CAP.Use CONTINUE cmd to proceed...
   Done
   Failure Count 0
   Success Count 1
COMPLETED
cleaning threshold list

Muestra una lista de tipos de cartuchos de limpieza y sus umbrales de advertencia. Cada tipo de cartucho de limpieza tiene 4 atributos:

  • Index: tipo de cartucho de limpieza utilizado por el comando "cleaning threshold set"

  • Media type: tipo de cartucho de limpieza utilizado

  • Maximum usage count: uso máximo recomendado por fabricante de cintas.

  • Warning threshold value: umbral definido por el usuario que determina cuándo se establece un estado de advertencia para un cartucho de limpieza una vez que el contador de uso alcanza ese umbral.

Ejemplo:

SL8500> cleaning threshold list
   requestId
   requestId 15001
   Attributes
   Object     Index               1
              Media Type          SgtUltrium1_Cleaning
              Recommend Max Usage 100
              Warning Threshold   0
   Attributes
   Object     Index               3
              Media Type          T10000_Cleaning
              Recommend Max Usage 50
              Warning Threshold   0
cleaning threshold set <warning threshold value> <list index number>

Define un valor de umbral de advertencia para un tipo de cartucho de limpieza determinado.

  • <warning threshold value>: puede ser cualquier número entero positivo hasta 1000. El valor 0 indica que no hay ningún umbral de advertencia.

  • <list index number>: tipo de cartucho de limpieza especificado por el número de índice desde la tabla del comando "cleaning threshold list".

Ejemplo:

SL8500> cleaning threshold set 55 11
   requestId
   requestId 15101
   Attributes
   Object      Success true
   Done
COMPLETED
cleaning driveWarning set { on | off }

Define el indicador de advertencia de limpieza de la unidad en on u off.

  • on: el estado de la unidad mostrará una advertencia si necesita limpieza

  • off: el estado de la unidad no se ve afectado si la unidad necesita limpieza

config

Este comando mostrará la configuración física actual de la biblioteca o definirá los parámetros de configuración de la biblioteca.

config

Muestra la ayuda para el comando config, al igual que "help config".

config complexId set {1 - 127}

Define complexId utilizado para SDP únicamente para la biblioteca en la que se ejecuta el comando. Si existe más de una biblioteca en un complejo, complexId se debe definir de forma individual para cada biblioteca del complejo.

config complexId set {1 - 127} <library address>

Define complexId utilizado para SDP para una biblioteca remota. Si existe más de una biblioteca en un complejo, complexId se debe definir de forma individual para cada biblioteca del complejo.

  • <library address>: especifica la biblioteca en formato de biblioteca, guía, columna, lado y fila. Por ejemplo: 2, 0, 0, 0, 0.

config complexId clear

Borra el número de complexId para una biblioteca. Este comando reiniciará la pila de red y hará que la dirección IP ILC SDP deje de responder.

config complexId clear <library address>

Borra el número de complexId para una biblioteca remota. Este comando reiniciará la pila de red y hará que la dirección IP ILC SDP deje de responder.

  • <library address>: especifica la biblioteca en formato de biblioteca, guía, columna, lado y fila. Por ejemplo: 2, 0, 0, 0, 0.

config complexId print

Muestra complexId actual para la biblioteca en la cual se ejecuta el comando.

config ilc print

Muestra el estado de ilc.

config ilc {enable | disable}

Activa o desactiva la LAN de comunicaciones entre bibliotecas (ILC). Si se solicita la desactivación, la biblioteca primero debe desconectarse con el comando "accessState offline <device address>".

config libraryId print

Muestra el identificador de la biblioteca actual para esta biblioteca.

config libraryId set {1 - 32}

Define libraryId con un valor de 1 a 32. La biblioteca debe estar desconectada para este comando.

config print

Muestra la configuración física actual de la biblioteca.

config serviceInfo print

Muestra la información de servicio de la biblioteca.

config serviceInfo set

Define la información de servicio: contact 'contactName' phone 'phoneNumber' streetAddr 'streetAddress' city 'city' state 'state' country 'country' zip 'zipCode' description 'description data'.

Actualmente, la longitud máxima de la cadena es 31 caracteres. Cada cadena debe estar delimitada por ' ' (comillas simples) para poder usar espacios y otros caracteres.

Ejemplo:

SL8500> config serviceInfo set city 'Denver' contact 'Andy' country 'USA' description 'Manager' phone '303 222-4444' state 'C0' streetAddr '1 tape drive' zip '80027'

requestId
requestId 1512402
Device serviceInfo
Success true
Done
Failure Count 0
Success Count 1
COMPLETED

date

Este comando define la fecha de la biblioteca en la zona horaria del meridiano de Greenwich (GMT).

date

Muestra la ayuda para el comando date, al igual que "help date".

date print

Muestra la fecha actual del sistema.

date <MM> / <DD> / <YYYY>

Define la fecha del sistema. En un complejo de bibliotecas, la biblioteca con libraryId = 1 es la biblioteca maestra. Cambie la fecha en la biblioteca maestra.

  • <MM>: mes de dos dígitos

  • <DD>: día de dos dígitos

  • <YYYY>: año de cuatro dígitos

drive

Este comando muestra información sobre las unidades o ejecuta las utilidades de la unidad, como adiEnable, fastLoad, power y rewindUnload.

drive

Muestra la ayuda para el comando drive, al igual que "help drive".

drive adiEnable {on | off | print}

Activa o desactiva la detección de unidades con ADI, o imprime su estado. Una vez que se activa, las unidades que se agregan posteriormente intentarán una detección de unidades ADI. Para activar ADI para todas las unidades compatibles con ADI en la biblioteca, se debe reiniciar la biblioteca.

drive fastLoad {on | off | print}

Activa o desactiva la función fastLoad, o imprime su estado. FastLoad cambia el comportamiento de los montajes de unidades (comandos move). Cuando fastLoad está activado, el robot no esperará una carga completa de PUT en una unidad; en cambio, pasará inmediatamente a la siguiente operación. Además cambia el comportamiento del comando rewindUnload para que se ejecute inmediatamente y no espere a que se descargue la unidad. El estado de fastLoad se aplica a todas las unidades.

Nota:

Este comando afecta únicamente a los comandos ejecutados en la misma sesión de la CLI donde se ejecutó el comando.
drive print { <drive address> | * }

Muestra información de resumen de unidades: ubicación, estado, estado de mantenimiento, tipo, versión de firmware, tipo de interfaz, en uso, número de serie, estado (en línea/fuera de línea), estado de mantenimiento (correcto, advertencia o error) y proveedor de la unidad.

  • <drive address>: especifica la unidad en formato de biblioteca, guía, columna, lado y fila.

  • *: muestra información de todas las unidades de la biblioteca.

drive search {on | off} <drive address>

Origina el parpadeo del LED verde en la bandeja de unidades. El parpadeo continúa hasta que se ejecute el comando search off. Se utiliza para localizar una unidad dentro de la biblioteca.

  • <drive address>: especifica la unidad en formato de biblioteca, guía, columna, lado y fila.

hwActivation

Este comando activa determinadas funciones de la biblioteca después de adquirir un permiso de activación de hardware.

Nota:

La biblioteca debe reiniciarse al desactivar openVolser, dualRobot, creación de particiones o Redundant Electronics.
hwActivation

Muestra la ayuda para el comando hwActivation, al igual que "help hwActivation".

hwActivation addLicenseFile

Agrega un archivo de licencia. El archivo de licencia debe denominarse SL8500_license_config.dsf. El nombre de ruta completa es /usr/local/SL8500_license_config.dsf.

hwActivation deleteFile <index>

Suprime el archivo de funciones especificado instalado.

  • <index>: especifica el número de archivo que se debe suprimir según lo especificado en la base de datos del módulo hwActivation del controlador de biblioteca. Consulte "hwActivation listFiles".

hwActivation listFiles

Enumera los archivos de funciones instalados en la base de datos del módulo hwActivation del controlador de biblioteca.

hwActivation print

Enumera todas las funciones activadas en la base de datos del módulo hwActivation del controlador de biblioteca.

mediaValidation

Este comando gestiona la función de validación de medios.

mediaValidation

Muestra la ayuda para el comando mediaValidation, al igual que "help mediaValidation"

mediaValidation print { all | poolOnly } { * | @ }

Muestra las ubicaciones de las unidades de la agrupación de validación de medios.

  • all: enumera todas las ranuras de unidades

  • poolOnly: muestra únicamente las ranuras de unidades en la agrupación de validación de medios

  • *: muestra únicamente información para la biblioteca de destino

  • @: muestra información para todo el complejo

mediaValidation reservation clear <drive address>

Borra la reserva de validación de medios para la unidad especificada.

  • <drive address>: especifica la unidad en formato de biblioteca, guía, columna, lado y fila.

mediaValidation stopValidation <drive address>

Detiene una validación en curso. El cartucho se devuelve a la ranura de almacenamiento de origen.

  • <drive address>: especifica la unidad en formato de biblioteca, guía, columna, lado y fila.

network

Este comando se utiliza para configurar y visualizar la configuración de red para la tarjeta de controlador. Para obtener información adicional, consulte la Guía de conectividad de hosts de SL8500 en OTN.

network clone [Port 2B IP address] [Port 2A IP address]

Se utiliza para la configuración de Redundant Electronics. Copia todas las configuraciones de puertos, enrutamiento y políticas IP en HBC del lado B. Las direcciones IP se reemplazan con las direcciones especificadas en el comando para el lado B. Si no se especifica ninguna dirección IP de puerto, no se definen en el lado B.

network config print

Muestra el lado de la biblioteca de destino (A o B) definido para los comandos de red.

network config side {a | b}

Define el lado de la biblioteca de destino para los comandos de red.

network config clear

Borra la configuración de red. Este comando detiene la conectividad de red. La reconfiguración requiere acceso al puerto serie en la tarjeta HBC.

network export

Exporta el archivo de configuración de red de la biblioteca (.lnc) y genera una secuencia de comandos de configuración de red (.scr). Únicamente puede utilizarse en casos en los que no se definieron configuraciones de red anteriores.

network gateway <IP address>

Define la puerta de enlace predeterminada de red externa.

network gateway clear

Borra la puerta de enlace predeterminada de red externa.

network import

Importa un archivo de configuración de red de la biblioteca (.lnc).

network ip <IP address>

Define la dirección IP del puerto 2B.

network ip address add <IP address> dev {2A | 2B}

Define la dirección IP de un puerto determinado.

network ip address del <IP address> dev {2A | 2B}

Elimina la dirección IP de un puerto.

network ip address show [dev {2A | 2B}]

Muestra la información de dirección actual para un puerto determinado o para ambos puertos si no se especifica dev.

network ip link set dev {2A | 2B} {up | down}

Define el estado operativo de un puerto, que controla si un puerto puede enviar y recibir tráfico Ethernet.

  • up: el puerto está en línea

  • down: el puerto está fuera de línea

network ip policy {enable | disable} dev {2A | 2B}

Activa o desactiva el enrutamiento de políticas para el dispositivo 2A o 2B.

network ip policy status

Muestra el estado del enrutamiento de políticas para los dispositivos 2A y 2B.

network ip policy route {add | del} <IP address> dev {2A | 2B}

Agrega o suprime una ruta estática a una política para el dispositivo 2A o 2B.

network ip policy route {add | del} <IP address> via <Gateway IP address> dev {2A | 2B}

Agrega o suprime una ruta estática a una política para el dispositivo 2A o 2B a través de la puerta de enlace.

network ip policy route show [ dev {2A | 2B} ]

Muestra información de rutas de políticas para el dispositivo 2A o 2B.

network ip route add default via <IP address>

Define la dirección IP de enrutamiento de puerta de enlace predeterminada.

network ip route delete default

Suprime la dirección IP de enrutamiento de puerta de enlace predeterminada.

network ip route {add | del} <IP address [/netmask] > dev {1A | 1B | 2A | 2B}

Agrega o suprime una dirección de enrutamiento IP (protocolo de Internet) estática para un host especificado. Este comando también permite que un usuario defina la máscara de red para un puerto determinado.

Ejemplo:

SL8500>network ip route add 129.80.81.59/24 dev 1B
COMPLETED
network ip route {add | del} <IP address [/netmask] > via <Gateway IP address>

Agrega o suprime una ruta estática a una dirección IP de puerta de enlace de red de destino.

network ip route show [dev {2A | 2B}]

Muestra la información de la tabla de enrutamiento actual o la información de la tabla de enrutamiento para un puerto determinado.

network name <host name string>

Define el nombre de host.

network netmask <netmask>

Define la máscara de red externa con el formato xxx.xxx.xxx.xxx.

network print

Muestra la configuración de red actual para los puertos Ethernet externos (2A y 2B).

partition

Este comando muestra el estado actual o desactiva la función de partición.

partition

Muestra la ayuda para el comando partition, al igual que "help partition".

partition autoClean set { * | <Partition Id> }

Define la limpieza automática en una partición especificada (0 para una biblioteca no particionada).

partition attribute status { * | <Partition Id> }

Muestra los atributos de estado de una única partición especificada o de todas las particiones.

partition disable

Desactiva la creación de particiones en la biblioteca.

partition getCapacity

Muestra los valores de capacidad para la biblioteca o las particiones definidas.

partition status

Muestra el estado de partición actual.

partition setCapacity { <Partition Id> , <Capacity> }

Define la capacidad para la partición designada. Las particiones existentes no mostradas en el comando tendrán una capacidad de cero.

Ejemplo:

SL8500> partition setCapacity 1,200 2,50 3,600
   requestId 7601
   Done
   Failure Count 0
   Success Count 1
COMPLETED
partition setNonPartitionedHLI

Define la partición en hli0. Si hay unidades en la agrupación de validación de medios, deberán ser eliminadas con anticipación. Si se encuentran en el complejo, define todas las bibliotecas en hli0.

partition set state {online | offline} <Partition Id>

Define el estado actual (sin conexión/en línea) de una partición especificada.

reControl

Este comando controla/conmuta Redundant Electronics y recupera los estados de Redundant Electronics del controlador de biblioteca.

reControl

Muestra la ayuda para el comando reControl, al igual que "help reControl".

reControl status [ <library address> | * ]

Recupera el estado de Redundant Electronics.

  • <library address>: especifica la biblioteca en formato de biblioteca, guía, columna, lado y fila. Por ejemplo: 2, 0, 0, 0, 0.

  • *: recupera el estado de todas las bibliotecas en un complejo

snmp

Este comando configura el Protocolo Simple de Gestión de Red (SNMP). Para obtener más información, consulte la Guía de referencia de SNMP en OTN.

ssh

Este comando controla la configuración para el daemon/servidor ssh que reside en HBC. Esta es la utilidad de protocolo que SLC y otras aplicaciones utilizan para conectarse al controlador de biblioteca.

ssh print

Imprime la configuración del protocolo del daemon ssh.

ssh set version1and2

Define la restricción del protocolo del daemon ssh en v1 y v2. (este es el valor predeterminado). El servidor ssh se reinicia.

ssh set version2

Define la restricción del protocolo del daemon en v2 únicamente.

time

Este comando define la hora de la biblioteca en formato de 24 horas.

time

Muestra la ayuda para el comando time, al igual que "help time".

time print

Muestra la hora actual del sistema.

time <HH> : <MM>

Define la hora del sistema. La resolución se realiza en el lapso de un minuto. En un complejo de bibliotecas, la biblioteca con libraryId = 1 es la biblioteca maestra. Cambie la hora en la biblioteca maestra.

  • <HH>: hora de dos dígitos

  • <MM>: minuto de dos dígitos

time <HH> : <MM> : <SS>

Define la hora del sistema. La resolución se realiza en el lapso de un segundo. En un complejo de bibliotecas, la biblioteca con libraryId = 1 es la biblioteca maestra. Cambie la hora en la biblioteca maestra.

  • <HH>: hora de dos dígitos

  • <MM>: minuto de dos dígitos

  • <SS>: segundo de dos dígitos

traceRoute

Este comando rastrea la ruta de red hasta una dirección IP especificada.

traceRoute <IP Address>

Ejecuta traceRoute hasta la dirección IP especificada.

version

Este comando muestra la versión del cliente y las versiones de software para los dispositivos solicitados.

version print [ <device address> | *]

Muestra la versión de software del código para un dispositivo o para todos los dispositivos.

  • <device address>: especifica el dispositivo en formato de biblioteca, guía, columna, lado y fila.

whereAmi

Este comando muestra la información del sistema y la tarjeta lógica relativa a la biblioteca y a la tarjeta, en relación con el comando Redundant Electronics que se ejecuta.

whereAmi

Muestra la información relativa a la ubicación donde se ejecuta el comando.

Ejemplo:

SL8500> whereAmI
   Host Name: gulibtst02b
   Port 2B IP Address: 172.20.151.24
   Library Type: SL8500
   HBC side: B
   Active side: B
COMPLETED