pesh command

Use the pesh command to obtain shell access to the system.

Synopsis

pesh system_id

Description

The pesh command provides full shell access to the system for product engineering, support personnel, and users who obtain the password from IBM® Support to gain root access to the management node. You can use the lsconfig command to determine the UVMID or unique ID of the system. The pesh command takes the UVMID or unique ID of the system for which full shell access is needed, then prompts the user for a one day password that was obtained from the support organization. If the password is valid, the user is granted full shell access.

Important: Before you use the lsconfig command to identify the management node UVMID, and the pesh command to access the root directory, you must call IBM Support to obtain the password that is required for the pesh command.

Options

system_id: Indicates the UVMID or unique ID of the system for which the pesh command is obtaining shell access.

Exit status

The following codes are returned by this command.

0: The operation completed.
1: A usage error occurred.
2: The command or bundle was not found.
3: The command was not performed because either authentication failed or you are not authorized to perform the action.

Examples

Obtain full shell access to a system
This example illustrates how to use the lsconfig command and the pesh command to access the system with a UVMID 4f7f:1f22:912c:afaf.
1. Use the following command to list the system information:
```
lsconfig -v
```
  The command will produce the following output:
```
"vpd=*FC ????????
Fri Mar 19 14:10:08 EDT 2010\
*DS FSM\
*TM -[8731AC1]-\
*SE 2022031\
*MN IBM\
*OS Embedded Operating Systems\
*NA 9.3.78.222\
*RM 1.3.0\
*UUID 53859D47-C97D-475F-B953-BE684785CF48\
*UVMID 4f7f:1f22:912c:afaf
```
2. Using the unique ID that follows *UVMID, pass the system_id value to the pesh command.
```
pesh 4f7f:1f22:912c:afaf
```
3. When you are prompted, enter the password that you obtained from support.