L'interfaccia CLI si basa sul firmware. È pertanto possibile che alcuni comandi dell'interfaccia CLI elencati di seguito non siano disponibili se si utilizzano versioni precedenti del firmware della libreria.
Di seguito sono riportati alcuni dei comandi della CLI accessibili dall'utente Admin.
Questo comando esegue un controllo fisico di tutta la libreria o di parte di essa.
Visualizza la Guida in linea per il comando audit ed è equivalente a "help audit".
Avvia un controllo fisico dell'intera libreria. Questo comando viene eseguito immediatamente e non visualizza alcun risultato.
Esempio:
SL3000> audit * requestId requestId 9 Done Failure Count 0 Success Count 1 COMPLETED
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:
SL3000> audit 1,1,0,1,0 1,1,-10,1,1 requestId requestId 9 Attributes Media Label #EMPTY.. Object Location 1,1,-10,1,1 Done Failure Count 0 Success Count 1 COMPLETED
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:
SL3000> audit 1,1,0,1,0 1,1,-10,1,1 1,1,-10,1,5 requestId requestId 10 Attributes Media Label #EMPTY.. Object Location 1,1,-10,1,1 Attributes Media Label EN34410R Object Location 1,1,-10,1,5 ... Done Failure Count 0 Success Count 5 COMPLETED
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:
SL3000> 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
Questo comando consente di gestire le CAP.
Visualizza la Guida in linea per il comando capCommand ed è equivalente a "help capCommand".
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.
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.
Questo comando forza la reimpostazione di una o più stringhe della CAP in base all'argomento fornito per il lato.
Esempio:
SL3000> capCommand resetCap right requestId requestId 17002 Done Failure Count 0 Success Count 1 COMPLETED
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 dagli utenti dotati della funzionalità di convalida dei supporti.
Visualizza la Guida in linea per il comando cleaning ed è equivalente a "help cleaning".
Elenca tutte le cartucce di pulizia o diagnostiche negli slot di sistema.
Esempio:
SL3000> cleaning list cleaning requestId requestId 9001 Attributes Expired false Label CLN0080U Location 1,1,-12,1,13 Max Usage Count 100 Media Type 9840_Cleaning Status ok Usage Count 0 Object Cartridge cleaning
Importa le cartucce di pulizia e diagnostica negli slot di sistema. È consentita una sola operazione di importazione/esportazione alla volta. Affinché le librerie SL3000 consentano le operazioni di importazione, è necessario che siano disponibili almeno 2 slot di sistema vuoti.
<cap device address>: specifica la CAP da utilizzare per l'operazione di importazione nel formato libreria, binario, colonna, lato, riga.
Esempio:
SL3000> cleaning import 1,1,5,2,0 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
Esporta le cartucce di pulizia. È 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.
Esempio:
SL3000> cleaning export 1,1,5,2,0 cleaning requestId requestId 9601 Address 1.1.-12.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
Esporta una specifica 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:
SL3000> cleaning export 1,1,5,2,0 1,4,-12,1,12 requestId requestId 9601 Address 1.4.-12.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
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:
SL3000> 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
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:
SL3000> cleaning threshold set 55 11 requestId requestId 15101 Attributes Object Success true Done COMPLETED
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.
Questo comando visualizza la configurazione della libreria fisica corrente o consente di impostare i parametri di configurazione della libreria.
Visualizza la Guida in linea per il comando config ed è equivalente a "help config".
Visualizza la configurazione della libreria fisica corrente.
Visualizza lo stato ilc.
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>".
Visualizza la configurazione della libreria fisica corrente.
Visualizza le informazioni sul servizio della libreria.
Imposta le informazioni di servizio: contact ’contactName’ phone ’phoneNumber’ streetAddr ’streetAddress’ city ’city’ state ’state’ country ’country’ zip ’zipCode’ description ’description data’.
La lunghezza di stringa massima è di 31 caratteri. Ciascuna stringa deve essere delimitata da ’ ’ (apici) per consentire di utilizzare spazi e altri caratteri.
Esempio:
SL3000> 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
Questo comando imposta la data della libreria con l'ora di Greenwich (GMT, Greenwich Mean Time).
Visualizza la Guida in linea per il comando date ed è equivalente a "help date".
Visualizza la data di sistema corrente.
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.
Questo comando visualizza informazioni sulle unità o esegue le utility dell'unità quali adiEnable, fastLoad, power e rewindUnload.
Visualizza la Guida in linea per il comando drive ed è equivalente a "help drive".
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.
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.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 informazioni su tutte le unità nella libreria.
Causa il lampeggiamento del LED verde sul vassoio dell'unità. Il lampeggiamento continua finché non si esegue il comando search off. Consente di individuare un'unità nella libreria.
<drive address>: specifica l'unità nel formato libreria, binario, colonna, lato, riga.
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.Visualizza la Guida in linea per il comando hwActivation ed è equivalente a "help hwActivation".
Aggiunge un file di licenza. Il file di licenza deve essere denominato SL3000_license_config.dsf. Il percorso completo del file è /usr/local/SL3000_license_config.dsf.
Elimina il file 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.
Elenca i file della funzionalità installata nel database del modulo hwActivation del controller della libreria.
Elenca tutte le funzionalità abilitate nel database del modulo hwActivation del controller della libreria.
Questo comando consente di ottenere e impostare configurazioni Multi-Port Fibre Channel per il controller della libreria. I controlli e le visualizzazioni Fibre Channel restituiti da questo comando non devono essere confusi con le configurazioni Fibre Channel delle unità nastro. Questo comando è disponibile solo nelle librerie SL3000.
Visualizza lo stato delle connessioni Fibre Channel della libreria.
Visualizza il numero di canali Multi-Port Fibre Channel abilitati.
Imposta l'indirizzamento hard o soft e, se è abilitato l'indirizzamento hard, imposta l'ID del loop Fibre Channel sul valore specificato. Se l'indirizzamento hard è disabilitato, l'ID del loop è impostato su 126. Questa configurazione varia a seconda della porta.
Imposta il numero di canali Multi-Port Fibre Channel da abilitare. La limitazione della licenza MultiFibrePort e l'hardware fisico determinano il numero massimo di porte da abilitare.
Questo comando gestisce la funzionalità di convalida dei supporti.
Visualizza la Guida in linea per il comando mediaValidation ed è equivalente a "help mediaValidation".
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.
Cancella la prenotazione della convalida dei supporti per l'unità specificata.
<drive address>: specifica l'unità nel formato libreria, binario, colonna, lato, riga.
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.
Questo comando configura e visualizza la configurazione di rete per la scheda del controller.
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, non vengono inviati sul lato B.
Visualizza il lato della libreria di destinazione (A o B) impostato per i comandi di rete.
Imposta il lato della libreria di destinazione per i comandi di rete.
Cancella la configurazione di rete. Questo comando interrompe la connettività di rete. La riconfigurazione richiede all'accesso alla porta seriale sulla scheda HBC.
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.
Imposta il gateway predefinito della rete esterna.
Cancella il gateway predefinito della rete esterna.
Importa un file di configurazione di rete della libreria (.lnc).
Imposta l'indirizzo IP della porta 2B.
Imposta l'indirizzo IP di una determinata porta.
Rimuove l'indirizzo IP di una porta.
Visualizza le informazioni sull'indirizzo corrente di una porta specifica o di entrambe le porte se dev non è specificato.
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.
Abilita o disabilita il routing dei criteri per il dispositivo 2A o 2B.
Visualizza lo stato di routing dei criteri per i dispositivi 2A e 2B.
Aggiunge o elimina un percorso statico per i criteri per il dispositivo 2A o 2B.
Aggiunge o elimina un percorso statico per i criteri per il dispositivo 2A o 2B tramite gateway.
Visualizza informazioni sul percorso dei criteri per il dispositivo 2A o 2B.
Imposta l'indirizzo IP per il routing del gateway predefinito.
Elimina l'indirizzo IP per il routing del gateway predefinito.
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:
SL3000>network ip route add 129.80.81.59/24 dev 1B COMPLETED
Aggiunge o elimina un percorso statico a un indirizzo IP con gateway della rete di destinazione.
Visualizza informazioni sulla tabella di routing corrente o sulla tabella di routing per una determinata porta.
Imposta il nome host.
Imposta la netmask di rete esterna in formato xxx.xxx.xxx.xxx.
Visualizza la configurazione di rete corrente per le porte Ethernet esterne (2A e 2B).
Questo comando visualizza lo stato corrente o disabilita la funzionalità di partizionamento.
Visualizza la Guida in linea per il comando partition ed è equivalente a "help partition".
Imposta la pulizia automatica in una partizione specificata (0, per una libreria non partizionata).
Visualizza gli attributi dello stato di una singola partizione specificata o di tutte le partizioni.
Imposta la modalità fastLoad per una o più partizioni specificate. Attualmente le sole modalità valide sono true o false. Questo comando è disponibile solo nelle librerie SL3000.
Esempio:
SL3000> partition fastload set '1-true,3-false' requestId requestId 40901 Attributes Success true Object Done Failure Count 0 Success Count 2 COMPLETED
Visualizza i valori della capacità per la libreria o per qualsiasi partizione definita.
Visualizza lo stato corrente delle partizioni specificate. Questo comando è disponibile solo nelle librerie SL3000.
Utilizza un file di testo della partizione predefinita per impostare la configurazione della partizione della libreria. Ciascun nome di file è costituito dalla parola "partition" e da un valore numerico come "2" e un'estensione ".txt". Di seguito sono riportati i file predefiniti.
Esempio:
SL3000> partition predefined file 5 requestId requestId 7601 Done Failure Count 0 Success Count 1 COMPLETED
Imposta la capacità per la partizione specificata. La capacità delle partizioni esistenti non indicate nel comando verrà impostata su zero.
Esempio:
SL3000> partition setCapacity 1,200 2,50 3,600 requestId 7601 Done Failure Count 0 Success Count 1 COMPLETED
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.
Imposta lo stato corrente (offline/online) di una partizione specificata.
Imposta il tipo di interfaccia per l'intera libreria. Disponibile solo nelle librerie SL3000.
Visualizza lo stato di partizionamento corrente.
Questo comando controlla/attiva o disattiva l'elettronica ridondante e recupera gli stati dell'elettronica ridondante del controller della libreria.
Visualizza la Guida in linea per il comando reControl ed è equivalente a "help reControl".
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.
Questo comando configura il protocollo SNMP (Simple Network Management Protocol). Per informazioni dettagliate, consultare il manuale SNMP Reference Guide su OTN.
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.
Stampa le impostazioni correnti del protocollo del daemon ssh.
Imposta la limitazione per il protocollo del daemon ssh per v1 e v2 (impostazione predefinita). Il server ssh viene riavviato.
Imposta la limitazione per il protocollo del daemon ssh solo per v2.
Questo comando imposta l'ora della libreria in formato ore.
Visualizza la Guida in linea per il comando time ed è equivalente a "help time".
Visualizza l'ora di sistema corrente.
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.
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.
Questo comando tiene traccia del percorso di rete per un indirizzo IP specificato.
Esegue un comando traceRoute per l'indirizzo IP specificato.
Questo comando visualizza la versione del cliente e le versioni del software per i dispositivi richiesti.
Visualizza la versione software o il codice per uno o tutti i dispositivi.
<device address>: specifica il dispositivo nel formato libreria, binario, colonna, lato, riga.
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.
Visualizza le informazioni correlate alla posizione in cui viene eseguito il comando.
Esempio:
SL3000> whereAmI Host Name: gulibtst02b Port 2B IP Address: 172.20.151.24 Library Type: SL3000 HBC side: B Active side: B COMPLETED