B Riferimento per l'interfaccia a riga di comando

In questa appendice vengono descritti i comandi CLI (Command Line Interface, interfaccia a riga di comando) disponibili per un utente Admin. Dal momento che questa interfaccia è basata sul firmware, potrebbe verificarsi che non tutti i comandi siano disponibili per la libreria.

Di seguito sono riportati i comandi CLI accessibili dall'utente Admin.

audit

Questo comando esegue un controllo fisico di tutta la libreria o di parte di essa.

audit

Visualizza la Guida in linea per il comando audit ed è equivalente a "help audit".

audit *

Avvia un controllo fisico dell'intera libreria. Questo comando viene eseguito immediatamente e non visualizza alcun risultato.

Esempio:

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

Esegue un controllo fisico di un solo indirizzo e visualizza i risultati.

  • <device address>: specifica il robot da utilizzare nel formato libreria, binario, colonna, lato, riga.

  • <address>: specifica la posizione dello slot da controllare nel formato libreria, binario, colonna, lato, riga.

Esempio:

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>

Esegue controlli fisici di un intervallo di indirizzi e visualizza i risultati.

  • <device address>: specifica il robot da utilizzare nel formato libreria, binario, colonna, lato, riga.

  • <start address> <end address>: specifica la posizione dello slot iniziale e finale da controllare nel formato libreria, binario, colonna, lato, riga. Tra gli indirizzi iniziale e finale, l'unica variabile è la riga.

Esempio:

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>

Abilita o disabilita la capacità di controllo della scansione di più righe per ridurre i tempi del controllo.

  • print: stampa lo stato del controllo della scansione di più righe.

  • <device address>: specifica il robot da utilizzare nel formato libreria, binario, colonna, lato, riga.

Esempio:

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

Questo comando consente di gestire le CAP.

capCommand

Visualizza la Guida in linea per il comando capCommand ed è equivalente a "help capCommand".

capCommand <enable|disable> <device_address>

Abilita o disabilita una CAP su un binario (solo per CAP in blocco). In alcune situazioni potrebbe non essere possibile disabilitare una CAP, ad esempio in caso di prenotazione da parte di un host.

  • <device address>: specifica la CAP da rilasciare nel formato libreria, binario, colonna, lato, riga.

capCommand forceUnreserve <device address>

Forza il rilascio di una CAP. Se la CAP contiene cartucce, la prenotazione viene modificata in "default". Se la CAP non contiene cartucce, la prenotazione viene modificata in "none".

  • <device address>: specifica la CAP da rilasciare nel formato libreria, binario, colonna, lato, riga.

capCommand {lock | unlock} <device address>

Blocca o sblocca una CAP specificata dall'indirizzo del dispositivo.

  • <device address>: specifica la CAP da bloccare/sbloccare nel formato libreria, binario, colonna, lato, riga.

cleaning

Questa famiglia di comandi visualizza e controlla le funzioni di pulizia e diagnostica correlate alla cartuccia all'interno della libreria. Questi comandi possono essere utilizzati solo dai clienti che dispongono della funzionalità di convalida dei supporti.

cleaning

Visualizza la Guida in linea per il comando cleaning ed è equivalente a "help cleaning".

cleaning list cleaning

Elenca tutte le cartucce di pulizia negli slot di sistema.

Esempio:

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 le cartucce di pulizia e diagnostica negli slot di sistema. È consentita una sola operazione di importazione/esportazione alla volta. Affinché le librerie SL8500 consentano le operazioni di importazione, è necessario che siano disponibili almeno 9 slot di sistema vuoti.

  • <cap device address>: specifica la CAP da utilizzare per l'operazione di importazione nel formato libreria, binario, colonna, lato, riga.

  • to { 1 | 2 | 3 | 4 | * }: specifica il binario in cui importare la cartuccia, se possibile (facoltativo).

Esempio:

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 }

Esporta le cartucce di pulizia selezionate. È consentita una sola operazione di importazione/esportazione alla volta.

  • <cap device address>: specifica la CAP da utilizzare per l'operazione di esportazione nel formato libreria, binario, colonna, lato, riga.

  • select { 1 | 2 | 3 | 4 | expired }: specifica il numero del binario da cui esportare le cartucce di pulizia.

Esempio:

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>

Esporta una determinata cartuccia di pulizia o diagnostica nella CAP specificata. È consentita una sola operazione di importazione/esportazione alla volta.

  • <cap device address>: specifica la CAP da utilizzare per l'operazione di esportazione nel formato libreria, binario, colonna, lato, riga.

  • <cartridge address>: specifica la posizione della cartuccia da esportare nel formato libreria, binario, colonna, lato, riga. La cartuccia specificata deve trovarsi in uno slot di sistema e deve essere una cartuccia di pulizia o diagnostica.

Esempio:

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

Visualizza un elenco dei tipi di cartuccia di pulizia e delle relative soglie di avvertenza. Ogni tipo di cartuccia di pulizia è dotato dei 4 attributi elencati di seguito.

  • Index: tipo di cartuccia di pulizia utilizzato dal comando "cleaning threshold set".

  • Media type: tipo di cartuccia di pulizia in uso.

  • Maximum usage count: uso massimo consigliato dal produttore del nastro.

  • Warning threshold value: soglia definita dall'utente che determina quando viene impostato uno stato di avvertenza per una cartuccia di pulizia una volta che il relativo numero di utilizzi raggiunge tale soglia.

Esempio:

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>

Imposta un valore di soglia di avvertenza per un determinato tipo di cartuccia di pulizia.

  • <warning threshold value>: può essere qualsiasi numero intero positivo fino a 1000. Un valore pari a 0 indica l'assenza di una soglia di avvertenza.

  • <list index number>: tipo di cartuccia di pulizia specificato dal numero di indice dell'elenco a tabella generato dal comando "cleaning threshold list".

Esempio:

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

Imposta il flag di avvertenza per la pulizia dell'unità su on o off.

  • on: se l'unità richiede pulizia, il relativo stato di integrità verrà impostato su warn.

  • off: se l'unità richiede pulizia, il relativo stato di integrità rimarrà invariato.

config

Questo comando visualizza la configurazione della libreria fisica corrente o consente di impostare i parametri di configurazione della libreria.

config

Visualizza la Guida in linea per il comando config ed è equivalente a "help config".

config complexId set {1 - 127}

Imposta il valore di complexId utilizzato per SDP solo per la libreria in cui viene eseguito il comando. Se un complesso include più librerie, è necessario impostare singolarmente i valori di complexId per ciascuna libreria nel complesso.

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

Imposta il valore di complexId utilizzato per SDP per una libreria remota. Se un complesso include più librerie, è necessario impostare singolarmente i valori di complexId per ciascuna libreria nel complesso.

  • <library address>: specifica la libreria nel formato libreria, binario, colonna, lato, riga. Ad esempio: 2, 0, 0, 0, 0.

config complexId clear

Cancella il valore di complexId per una libreria. Questo comando determina il riavvio dello stack di rete e l'interruzione della risposta dell'indirizzo IP ILC dell'SDP.

config complexId clear <library address>

Cancella il valore di complexId per una libreria remota. Questo comando determina il riavvio dello stack di rete e l'interruzione della risposta dell'indirizzo IP ILC dell'SDP.

  • <library address>: specifica la libreria nel formato libreria, binario, colonna, lato, riga. Ad esempio: 2, 0, 0, 0, 0.

config complexId print

Visualizza il valore corrente di complexId per la libreria in cui viene eseguito il comando.

config ilc print

Visualizza lo stato ilc.

config ilc {enable | disable}

Abilita o disabilita la LAN ILC (Inter-Library Communications). Se è richiesta una disabilitazione, è necessario prima disconnettere la libreria utilizzando il comando "accessState offline <device address>".

config libraryId print

Visualizza l'identificativo corrente per questa libreria.

config libraryId set {1 - 32 }

Imposta un valore per libraryId compreso tra 1 e 32. Per eseguire questo comando, è necessario che la libreria sia disconnessa.

config print

Visualizza la configurazione della libreria fisica corrente.

config serviceInfo print

Visualizza le informazioni sul servizio della libreria.

config serviceInfo set

Imposta le informazioni sul servizio: contact ’nome contatto’ phone ’numero telefonico’ streetAddr ’indirizzo’ city ’città’ state ’stato’ country ’nazione’ zip ’codice postale’ description ’dati descrizione’.

Attualmente la lunghezza di stringa massima è di 31 caratteri. Ciascuna stringa deve essere delimitata da ' ' (apici) per consentire di utilizzare spazi e altri caratteri.

Esempio:

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

Questo comando imposta la data della libreria con l'ora di Greenwich (GMT, Greenwich Mean Time).

date

Visualizza la Guida in linea per il comando date ed è equivalente a "help date".

date print

Visualizza la data di sistema corrente.

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

Imposta la data del sistema. In un complesso di librerie, quella con libraryId = 1 è la principale. Modificare la data nella libreria principale.

  • <MM>: mese composto da due cifre.

  • <DD>: giorno composto da due cifre.

  • <YYYY>: anno composto da quattro cifre.

drive

Questo comando visualizza informazioni sulle unità o esegue le utility dell'unità quali adiEnable, fastLoad, power e rewindUnload.

drive

Visualizza la Guida in linea per il comando drive ed è equivalente a "help drive".

drive adiEnable {on | off | print}

Imposta su on o su off oppure stampa lo stato della ricerca dell'unità con l'interfaccia ADI. Una volta abilitato, eventuali unità aggiunte in seguito verranno coinvolte nella ricerca dell'unità con ADI. Per abilitare l'interfaccia ADI per tutte le unità che la supportano nella libreria, è necessario eseguire il reboot della libreria.

drive fastLoad {on | off | print}

Imposta su on o su off oppure stampa lo stato della funzionalità fastLoad. FastLoad modifica il comportamento delle installazioni dell'unità (comandi di spostamento). Se fastLoad è attiva, il robot non attende il caricamento completo di un PUT su un'unità, ma passa direttamente all'operazione successiva. Cambia anche il comportamento del comando rewindUnload causandone l'esecuzione immediata, senza attendere lo scaricamento dell'unità. Lo stato di fastLoad viene applicato a tutte le unità.

Nota:

Questo comando ha effetto solo sui comandi eseguiti nella stessa sessione dell'interfaccia CLI in cui è stato eseguito questo comando.
drive print { <drive address> | * }

Visualizza informazioni di riepilogo sull'unità: posizione, stato, integrità, tipo, versione di firmware, tipo di interfaccia, se in uso, numero di serie, stato (online/offline, ok, warning o error) e fornitore dell'unità.

  • <drive address>: specifica l'unità nel formato libreria, binario, colonna, lato, riga.

  • *: visualizza le informazioni su tutte le unità nella libreria.

drive search {on | off} <drive address>

Causa il lampeggiamento del LED verde sul vassoio dell'unità. Il lampeggiamento continua finché non viene eseguito il comando search off. Viene utilizzato per individuare un'unità nella libreria.

  • <drive address>: specifica l'unità nel formato libreria, binario, colonna, lato, riga.

hwActivation

Questo comando attiva determinate funzionalità della libreria dopo avere acquistato un'autorizzazione per l'attivazione dell'hardware.

Nota:

Quando si disabilita openVolser, dualRobot, il partizionamento o l'elettronica ridondante, è necessario eseguire il reboot della libreria.
hwActivation

Visualizza la Guida in linea per il comando hwActivation ed è equivalente a "help hwActivation".

hwActivation addLicenseFile

Aggiunge un file di licenza. Il file di licenza deve essere denominato SL8500_license_config.dsf. Il percorso completo del file è /usr/local/SL8500_license_config.dsf.

hwActivation deleteFile <index>

Elimina il file specificato della funzionalità installata.

  • <index>: specifica il numero di file da eliminare, come indicato nel database del modulo hwActivation del controller della libreria. Vedere "hwActivation listFiles".

hwActivation listFiles

Elenca i file delle funzionalità installate nel database del modulo hwActivation del controller della libreria.

hwActivation print

Elenca tutte le funzionalità abilitate nel database del modulo hwActivation del controller della libreria.

mediaValidation

Questo comando gestisce la funzionalità di convalida dei supporti.

mediaValidation

Visualizza la Guida in linea per il comando mediaValidation ed è equivalente a "help mediaValidation".

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

Visualizza le posizioni dell'unità del pool di convalida dei supporti.

  • all: elenca tutti gli slot dell'unità.

  • poolOnly: elenca solo gli slot dell'unità nel pool di convalida dei supporti.

  • *: visualizza solo le informazioni per la libreria di destinazione.

  • @: visualizza informazioni per l'intero complesso.

mediaValidation reservation clear <drive address>

Cancella la prenotazione della convalida dei supporti per l'unità specificata.

  • <drive address>: specifica l'unità nel formato libreria, binario, colonna, lato, riga.

mediaValidation stopValidation <drive address>

Interrompe una convalida attualmente in corso. La cartuccia viene restituita allo slot di storage di origine.

  • <drive address>: specifica l'unità nel formato libreria, binario, colonna, lato, riga.

network

Questo comando viene utilizzato per configurare e visualizzare la configurazione di rete per la scheda controller. Per ulteriori informazioni, vedere il manuale SL8500 Host Connectivity Guide su OTN.

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

Utilizzato per la configurazione dell'elettronica ridondante. Copia tutte le configurazioni dei criteri per la porta, il routing e l'indirizzo IP sull'HBC del lato B. Gli indirizzi IP vengono sostituiti da quelli specificati nel comando per il lato B. Se non viene specificato alcun indirizzo IP della porta, nessun indirizzo verrà impostato sul lato B.

network config print

Visualizza il lato della libreria di destinazione (A o B) impostato per i comandi di rete.

network config side {a | b}

Imposta il lato della libreria target per i comandi di rete.

network config clear

Cancella la configurazione di rete. Questo comando interrompe la connettività di rete. La riconfigurazione richiede all'accesso alla porta seriale sulla scheda HBC.

network export

Esporta il file di configurazione di rete della libreria (.lnc) e genera uno script di configurazione di rete (.scr). Può essere utilizzato solo nei casi in cui non sono state impostate configurazioni di rete precedenti.

network gateway <IP address>

Imposta il gateway predefinito della rete esterna.

network gateway clear

Cancella il gateway predefinito della rete esterna.

network import

Importa un file di configurazione di rete della libreria (.lnc).

network ip <IP address>

Imposta l'indirizzo IP della porta 2B.

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

Imposta l'indirizzo IP di una determinata porta.

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

Rimuove l'indirizzo IP di una porta.

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

Visualizza le informazioni sull'indirizzo corrente di una porta specifica o di entrambe le porte se dev non è specificato.

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

Imposta lo stato operativo di una porta, che controlla se una porta può inviare e ricevere traffico Ethernet.

  • up: connette la porta.

  • down: disconnette la porta.

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

Abilita o disabilita il routing dei criteri per il dispositivo 2A o 2B.

network ip policy status

Visualizza lo stato di routing dei criteri per i dispositivi 2A e 2B.

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

Aggiunge o elimina un percorso statico per i criteri per il dispositivo 2A o 2B.

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

Aggiunge o elimina un percorso statico per i criteri per il dispositivo 2A o 2B tramite gateway.

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

Visualizza informazioni sul percorso dei criteri per il dispositivo 2A o 2B.

network ip route add default via <IP address>

Imposta l'indirizzo IP per il routing del gateway predefinito.

network ip route delete default

Elimina l'indirizzo IP per il routing del gateway predefinito.

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

Aggiunge o elimina un indirizzo di routing IP (Internet Protocol) statico per un host specificato. Questo comando consente anche a un utente di impostare la netmask per una determinata porta.

Esempio:

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>

Aggiunge o elimina un percorso statico a un indirizzo IP con gateway della rete di destinazione.

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

Visualizza informazioni sulla tabella di routing corrente o sulla tabella di routing per una determinata porta.

network name <host name string>

Imposta il nome host.

network netmask <netmask>

Imposta la netmask di rete esterna in formato xxx.xxx.xxx.xxx.

network print

Visualizza la configurazione di rete corrente per le porte Ethernet esterne (2A e 2B).

partition

Questo comando visualizza lo stato corrente o disabilita la funzionalità di partizionamento.

partition

Visualizza la Guida in linea per il comando partition ed è equivalente a "help partition".

partition autoClean set { * | <Partition Id> }

Imposta la pulizia automatica in una partizione specificata (0, per una libreria non partizionata).

partition attribute status { * | <Partition Id> }

Visualizza gli attributi dello stato di una singola partizione specificata o di tutte le partizioni.

partition disable

Disabilita il partizionamento nella libreria.

partition getCapacity

Visualizza i valori della capacità per la libreria o per qualsiasi partizione definita.

partition status

Visualizza lo stato di partizionamento corrente.

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

Imposta la capacità per la partizione specificata. La capacità delle partizioni esistenti non indicate nel comando verrà impostata su zero.

Esempio:

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

Imposta la partizione su hli0. È necessario prima rimuovere eventuali unità presenti nel pool di convalida dei supporti. Nel caso di un complesso, tutte le librerie vengono impostate su hli0.

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

Imposta lo stato corrente (offline/online) di una partizione specificata.

reControl

Questo comando controlla/attiva o disattiva l'elettronica ridondante e recupera gli stati dell'elettronica ridondante del controller della libreria.

reControl

Visualizza la Guida in linea per il comando reControl ed è equivalente a "help reControl".

reControl status [ <library address> | * ]

Recupera lo stato dell'elettronica ridondante.

  • <library address>: specifica la libreria nel formato libreria, binario, colonna, lato, riga. Ad esempio: 2, 0, 0, 0, 0.

  • *: recupera lo stato di tutte le librerie in un complesso.

snmp

Questo comando configura il protocollo SNMP (Simple Network Management Protocol). Per ulteriori informazioni, vedere il manuale SNMP Reference Guide su OTN.

ssh

Questo comando controlla la configurazione per il daemon/server ssh che risiede sull'HBC. Si tratta della utility di protocollo utilizzata da SLC e da diverse altre applicazioni per la connessione al controller della libreria.

ssh print

Stampa le impostazioni correnti del protocollo del daemon ssh.

ssh set version1and2

Imposta la limitazione per il protocollo del daemon ssh per v1 e v2 (impostazione predefinita). Il server ssh viene riavviato.

ssh set version2

Imposta la limitazione per il protocollo del daemon ssh solo per v2.

time

Questo comando imposta l'ora della libreria in formato ore.

time

Visualizza la Guida in linea per il comando time ed è equivalente a "help time".

time print

Visualizza l'ora di sistema corrente.

time <HH> : <MM>

Imposta l'ora di sistema. La risoluzione è entro un minuto. In un complesso di librerie, quella con libraryId = 1 è la principale. Modificare l'ora nella libreria principale.

  • <HH>: ora composta da due cifre.

  • <MM>: minuto composto da due cifre.

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

Imposta l'ora di sistema. La risoluzione è entro un secondo. In un complesso di librerie, quella con libraryId = 1 è la principale. Modificare l'ora nella libreria principale.

  • <HH>: ora composta da due cifre.

  • <MM>: minuto composto da due cifre.

  • <SS>: secondi composti da due cifre.

traceRoute

Questo comando tiene traccia del percorso di rete per un indirizzo IP specificato.

traceRoute <IP Address>

Esegue un comando traceRoute per l'indirizzo IP specificato.

version

Questo comando visualizza la versione del cliente e le versioni del software per i dispositivi richiesti.

version print [ <device address> | *]

Visualizza la versione software del codice per uno o tutti i dispositivi.

  • <device address>: specifica il dispositivo nel formato libreria, binario, colonna, lato, riga.

whereAmi

Questo comando visualizza informazioni sul sistema e sulla scheda logica in relazione alla libreria e alla scheda correlate al comando di elettronica ridondante in esecuzione.

whereAmi

Visualizza le informazioni correlate alla posizione in cui viene eseguito il comando.

Esempio:

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