Comando chpath
Scopo
Modifica lo stato operativo dei percorsi a un'unità che supporta l'MPIO (MultiPath I/O-I/E multipercorso) o modifica un attributo associato a un percorso a un'unità che supporta MPIO.
Sintassi
chpath -dev Nome -op StatoOp [ -pdev Parent ] [ -conn Connessione ]
chpath -dev Nome -pdev Parent [ -conn Connessione ] [ -perm ] -attr Attributo=Valore...
Descrizione
Il comando chpath modifica lo stato operativo dei percorsi all'unità specificata (l'indicatore -dev Nome) o modifica uno o più attributi associati a uno specifico percorso all'unità specificata. La sintassi richiesta è leggermente differente in base alla modifica da effettuare.
La prima sintassi sopra riportata modifica lo stato operativo di uno o più percorsi a un'unità specifica. La serie di percorsi da modificare si ottiene dalla serie di percorsi che corrispondono ai seguenti criteri:
- L'unità di destinazione corrisponde all'unità specificata.
- L'unità parent corrisponde al parent specificato (-pdev Parent), se è specificato un parent.
- La connessione corrisponde alla connessione specificata (-conn Connessione), se è specificata una connessione.
- Lo stato del percorso è PATH_AVAILABLE
Lo stato operativo di un percorso corrisponde all'utilizzo del percorso come parte della selezione percorso MPIO. Il valore enable indica che deve essere utilizzato il percorso, mentre disable indica che il percorso non deve essere utilizzato. Notare che l'impostazione del percorso su disable impatta su operazioni I/E future, non su quelle già in corso. Un percorso, quindi, può essere disabilitato, ma avere comunque operazioni I/E in attesa finché tutte le I/E già in elaborazione non vengono completate. Quindi, se viene specificato -op disable per un percorso e l'I/E è in attesa sul percorso, verrà indicato all'utente.
La disabilitazione di un percorso influisce sulla selezione percorso al livello del programma di controllo unità. Lo stato_percorso del percorso non viene modificato nel database di configurazione dell'unità. Utilizzare il comando lspath per visualizzare lo stato operativo corrente di un percorso.
La seconda sintassi sopra riportata, modifica uno o più attributi specifici del percorso associati a un particolare percorso a una specifica unità. Notare che è possibile modificare più attributi con un solo richiamo del comando chpath, ma tutti gli attributi devono essere associati a un solo percorso. In altre parole, non è possibile modificare gli attributi in più percorsi con un singolo richiamo del comando chpath. Per modificare attributi in più percorsi, è necessario effettuare richiami separati del comando chpath, uno per ciascun percorso da modificare.
Indicatori
| -attr Attributo=Valore |
Identifica l'attributo da modificare e il suo nuovo valore. L'Attributo è il nome di un attributo specifico del percorso.
Il Valore è il valore con cui sostituire il valore corrente dell'attributo.
Il parametro Attributo=Valore può utilizzare una o più coppie attributo-valore per un solo indicatore -attr. Se si utilizza un indicatore -attr con più coppie attributo-valore, l'elenco di coppie deve essere racchiuso tra apici con spazi tra le coppie. Ad esempio, immettendo -attr Attributo=Valore viene elencata una coppia attributo-valore per indicatore, mentre immettendo -attr 'Attributo1=Valore1 Attributo2=Valore2' vengono elencate più coppie attributo-valore. |
| -dev Nome |
Specifica il nome unità logico dell'unità di destinazione per il percorso influenzato dalla modifica. Questo indicatore è obbligatorio sempre. |
| -pdev Parent |
Indica il nome unità logico dell'unità parent da utilizzare per qualificare i percorsi da modificare. Questo indicatore è obbligatorio quando si modificano gli attributi e facoltativo quando si modifica lo stato operativo. |
| -perm |
Modifica le caratteristiche del percorso senza modificare realmente il percorso. La modifica viene applicata al percorso alla successiva deconfigurazione e riconfigurazione del percorso (probabilmente all'avvio successivo). |
| -conn Collegamento |
Indica le informazioni sul collegamento da utilizzare per qualificare i percorsi da modificare. Questo indicatore è facoltativo quando si modifica lo stato operativo.
Quando si modificano gli attributi, è facoltativo se l'unità ha un solo percorso al parent indicato. Se esistono più percorsi dal parent all'unità, questo indicatore è obbligatorio per identificare il percorso specifico da modificare. |
| -op StatoOp |
Indica lo stato operativo in cui vanno modificati i percorsi indicati. Lo stato operativo di un percorso è gestito al livello del programma di controllo unità. Il programma di controllo determina se il percorso verrà considerato quando si esegue la selezione del percorso. I valori possibili per questo indicatore sono:
- enable
- Contrassegna lo stato operativo come abilitato per la selezione percorso MPIO. Un percorso con questo stato viene considerato utilizzabile quando si esegue la selezione del percorso.
Notare che l'abilitazione di un percorso è l'unico modo per ripristinare un percorso da una condizione di errore.
- disable
- Contrassegna lo stato operativo come disabilitato per la selezione percorso MPIO. Un percorso con questo stato non viene considerato utilizzabile quando si esegue la selezione del percorso.
Questo indicatore è obbligatorio quando si modifica lo stato operativo. Se utilizzato insieme all'indicatore -attr Attributo=Valore, viene restituito un errore di utilizzo. |
Stato di uscita
Consultare Stato di uscita comandi del Server I/E virtuale.
Esempi
- Per disabilitare i percorsi tra scsi0 e l'unità disco hdisk1, immettere:
chpath -dev hdisk1 -pdev scsi0 -op disable
Il
sistema visualizza un messaggio simile a uno dei seguenti:
percorsi disabilitati
o
alcuni percorsi disabilitati
Il primo messaggio indica che tutti i percorsi PATH_AVAILABLE da scsi0 a hdisk1 sono stati disabilitati con esito positivo.
Il secondo messaggio indica che solo alcuni dei percorsi PATH_AVAILABLE da scsi0 a hdisk1 sono stati disabilitati con esito positivo.
Informazioni correlate
I comandi cfgdev, chdev, lsdev, lsmap, lspath, mkpath, mkvdev, rmdev e rmpath.