Comando lspath
Scopo
Visualizza le informazioni sui percorsi per una unità che supporta MPIO (MultiPath I/O).
Sintassi
lspath [ -dev Nome unità ] [ -pdev Parent ] [ -status Stato ] [ -conn Collegamento ] [ -field Nome campo ] [ -fmt Delimitatore ]
lspath -dev Nome unità -pdev Parent [ -conn Collegamento ] -lsattr [ -attr Attributo... ]
lspath -dev Nome unità -pdev Parent [ -conn Collegamento ] -range -attr Attributo
Descrizione
Il comando lspath visualizza uno dei tre tipi di informazioni sui percorsi per un'unità che supporta MPIO. Visualizza lo stato operativo di uno o più percorsi per una singola
unità o visualizza uno o più attributi per un singolo percorso ad una singola unità che supporta MPIO.
La prima sintassi riportata di seguito visualizza lo stato operativo per uno o più percorsi ad una particolare unità che
supporta MPIO. La seconda sintassi visualizza uno o più attributi per un singolo percorso ad una particolare unità che supporta MPIO.
Infine, la terza sintassi visualizza il possibile intervallo di valori per un attributo per un singolo
percorso ad una particolare unità che supporta MPIO.
Visualizzazione dello stato del percorso con il comando lspath
Quando si visualizza lo stato del percorso, la serie di percorsi da visualizzare viene ottenuta ricercando nel database configurazione unità i percorsi che corrispondono ai seguenti criteri:
- Il nome dell'unità di destinazione corrisponde all'unità specificata con l'indicatore -dev. Se l'indicatore -dev non è presente, l'unità di destinazione non viene utilizzata nei criteri.
- Il nome dell'unità parent corrisponde all'unità specificata con l'indicatore -pdev. Se l'indicatore -pdev non è presente, non si utilizza parent nei criteri.
- Il collegamento corrisponde al collegamento specificato con l'indicatore -conn. Se l'indicatore -conn non è presente, il collegamento non viene utilizzato nei criteri.
- Lo stato del percorso corrisponde allo stato specificato con l'indicatore -status. Se l'indicatore -status non è presente, lo stato del percorso non viene utilizzato nei criteri.
Se non viene specificato alcun indicatore -dev, -pdev, -conn o -status, si visualizzano tutti i percorsi riconosciuti dal sistema.
Per impostazione predefinita, questo comando riporterà le informazioni in formato a colonne.
Quando non si specifica alcun indicatore che qualifichi i percorsi da visualizzare, il formato dell'emissione è:
stato unità parent
Possibili valori che possono venire visualizzati per la colonna stato sono:
- abilitato
- Indica che il percorso è configurato ed operativo. Verrà considerato quando si selezionano percorsi per IE.
- disabilitato
- Indica che il percorso è configurato, ma non attualmente operativo.
E' stato disabilitato manualmente e non verrà considerato quando si selezionano percorsi per IE.
- in errore
- Indica che il percorso è configurato, ma si sono verificati errori IE che lo hanno reso inutilizzabile. Non verrà considerato quando si selezionano i percorsi per IE.
- definito
- Indica che il percorso non è stato configurato nel programma di controllo dell'unità.
- mancante
- Indica che il percorso era stato definito in un precedente avvio, ma non è stato rilevato nel più recente avvio del sistema.
- rilevato
- Indica che il percorso è stato rilevato nel più recente avvio del sistema, ma per qualche ragione non era configurato. Un percorso dovrebbe avere questo stato solo durante l'avvio e quindi tale stato non dovrebbe mai
presentarsi come risultato del comando lspath.
Visualizzazione degli attributi del percorso con il comando lspath
Quando si visualizzano gli attributi per un percorso, il percorso deve essere completo.
E' possibile visualizzare più attributi per un percorso, ma non si possono visualizzare attributi che appartengono a più percorsi in un singolo richiamo
del comando lspath. Perciò, in aggiunta agli indicatori -lsattr, -dev e -pdev, sono necessari gli indicatori -conn
per identificare in modo univoco un singolo percorso. Ad esempio:
- se esiste un solo percorso tra un'unità ed uno specifico parent, l'indicatore -conn non è necessario
- se vi sono più percorsi tra un'unità ed uno specifico parent, è necessario l'indicatore -conn
Inoltre, l'indicatore -status non è consentito.
Per impostazione predefinita, questo comando riporterà le informazioni in formato a colonne.
attributo valore descrizione impostabile_da utente
Indicatori
| -attr Attributo |
Identifica lo specifico attributo da elencare. 'Attributo' è il nome di un attributo specifico del percorso. Quando si fornisce questo indicatore, viene visualizzato solo l'attributo
identificato. E' possibile utilizzare più istanze di questo indicatore per elencare più attributi. Se questo indicatore non viene specificato affatto, saranno elencati tutti gli attributi associati al percorso identificato. |
| -lsattr |
Visualizza i nomi attributo, i valori correnti, le descrizioni e i valori dell'indicatore che l'utente può impostare per un percorso specifico. |
| -dev Nome |
Specifica il nome unità logica dell'unità di destinazione di cui si devono visualizzare le informazioni sul percorso. |
| -field Nomi campo |
Specifica l'elenco dei campi da visualizzare. Sono supportati i seguenti campi:
- stato
- Stato del percorso
- nome
- Nome dell'unità
- parent
- Nome dell'unità parent
- conn
- Collegamento percorso.
|
| -fmt Delimitatore |
Specifica un carattere delimitatore per separare i campi di emissione. |
| -pdev Parent |
Indica il nome unità logica dell'unità parent del/i percorso/i da visualizzare. |
| -range |
Visualizza i valori validi per un nome attributo. L'indicatore -range riporta i valori attributo dell'elenco in una colonna verticale nel modo seguente:
Valore1
Valore2
.
.
ValoreN
L'indicatore -range visualizza i valori attributo dell'intervallo come x...n(+i) dove x è l'inizio dell'intervallo, n è la fine di esso e i rappresenta l'incremento. |
| -status Stato |
L'indicatore -status Stato indica lo stato da utilizzare per qualificare i percorsi da visualizzare. Quando si visualizzano le informazioni sul percorso, i valori consentiti
per questo indicatore sono:
- abilitato
- Consente di visualizzare percorsi che sono abilitati per la selezione di percorsi MPIO.
- disabilitato
- Consente di visualizzare percorsi che sono disabilitati per la selezione di percorsi MPIO.
- in errore
- Consente di visualizzare percorsi che sono in errore a causa di errori IE.
- disponibile
- Consente di visualizzare percorsi il cui stato_percorso è PERCORSO_DISPONIBILE (cioè, i percorsi configurati nel sistema, comprende i percorsi abilitati, disabilitati e in errore).
- definito
- Consente di visualizzare percorsi il cui stato_percorso è PERCORSO_DEFINITO.
- mancante
- Consente di visualizzare percorsi il cui stato_percorso è PERCORSO_MANCANTE.
|
| -conn Collegamento |
Indica le informazioni sul collegamento da utilizzare per qualificare i percorsi da visualizzare. |
Stato di uscita
| Codice di ritorno |
Descrizione |
| 1 |
Valore stato non valido. |
Esempi
- Per visualizzare, senza intestazioni di colonna, la serie di percorsi il cui stato operativo è disabilitato, immettere:
lspath -status disabilitato
Il
sistema visualizzerà un messaggio simile al seguente:
disabilitato hdisk1 scsi1
disabilitato hdisk2 scsi1
disabilitato hdisk23 scsi8
disabilitato hdisk25 scsi8
- Per visualizzare la serie di percorsi il cui stato operativo è in errore, immettere:
lspath -status in errore
Il
sistema visualizzerà un messaggio simile al seguente:
in errore hdisk1 scsi1
in errore hdisk2 scsi1
in errore hdisk23 scsi8
in errore hdisk25 scsi8
- Se l'unità di destinazione è un disco SCSI, per visualizzare tutti gli attributi per il percorso al parent scsi0 nel collegamento 5,0, utilizzare il comando:
lspath -dev hdisk10 -pdev scsi0 -conn "5,0" -lsattr
Il
sistema visualizzerà un messaggio simile al seguente:
peso 1 Ordine di selezione errore percorso true
Informazioni correlate
Il comando lsmap, il comando mkpath, il comando chpath
ed il comando rmpath.