Changing the console using the command line with the logical partition powered on

After making all of the necessary hardware changes, use this information to complete the console change using the command line, with the logical partition powered on. This procedure does not require an IPL.

Before you begin, ensure that the current configuration meets the following requirements:

The QAUTOCFG system value is set to On. Use the WRKSYSVAL QAUTOCFG (Work with System Value command) to verify this.
If you want to access the HMC command line by using a local terminal connection, start an xterm shell on the HMC. To do this, open a terminal by right-clicking the background and selecting Terminals > rshterm.
If you want to access the HMC command line by using a remote terminal connection such as PuTTy, first set up secure script processing between SSH clients and the HMC. Then start your remote terminal by specifying the name of the HMC that is managing the logical partition with which you want to work.

The following procedure contains examples within the steps to help you complete a console change. In these examples, the system named sysname with logical partition identification number 1 is changing from the HMC to Operations Console (LAN) using an embedded Ethernet port. These are variables for your actual system name and logical partition ID number. In the following instructions, replace sysname with your system name and replace 1 with your logical partition identification number.

To make a console change using the command line and without powering off the logical partition, complete the following steps:

List the current I/O configuration for the logical partition and locate the device that you want to make the system console device. If you do not know the resource that is being used for the console, continue with step 1.a. If you already know which resource is being used for the console, continue with step 1.c. Otherwise, complete step 1.b to list the currently tagged resource for the console.
1. Type the following on the HMC command line:
```
 lssyscfg -r sys -F name
```
  This command returns a list of managed systems. Select the system for which you want to change the console and use the system name as the sysname value in the next steps.
2. Type the following on the HMC command line:
```
lshwres -m sysname -r io --rsubtype taggedio --filter lpar_ids=1 -F console_slot
```
  This command returns none, hmc, or an 8-character hexadecimal string that represents the dynamic reconfiguration connector (DRC) index of the current console adapter.
3. Complete either of the following steps to determine the resource ID. The step you select depends on whether you have an input/output adapter (IOA) or are using a host Ethernet adapter (also referred to as the Integrated Virtual Ethernet) logical port.
  - To list the IOAs that are owned by the logical partition, type the following on the HMC command line:
```
lshwres -m sysname -r io --rsubtype slot --filter lpar_ids=1 -F drc_index,drc_name,description
```
    The system returns data in the following format:
```
21010003,U1234.001.123456A-P1-T12,PCI RAID Controller ...  

21010004,U1234.001.123456A-P1-C2,PCI 10/100/1000Mbps Ethernet UTP 2-port  

21010005,U1234.001.123456A-P1-C3,PCI 2-Line WAN w/Modem
```
    The location of resource DRC 21030003 is listed as P1-T12 and not P1-Cn (where n is a slot number). The Tn designation represents embedded resources. If you designate an actual adapter, the location is a value similar to P1-C2. This enables you to get the DRC index of the IOA, which becomes the new console device.
  - To list the logical ports that are owned by the logical partition, type the following on the HMC command line:
```
lshwres -m sysname -r hea --rsubtype logical --level port --filter lpar_ids=1 -F drc_index,drc_name
```
    The system returns data in the following format:
```
23e01000,Port 17 

23e01100,Port 18 

23e00000,Port 1 

23e00100,Port 2
```
4. Identify the DRC index of the console IOA or host Ethernet adapter logical port that you want. In the previous output example, the first entry is a host Ethernet adapter logical port with a DRC index of 23e01000. This is the first logical port for physical port T1 (top connector).
Change the console tag of the logical partition to the device that you want to become the next console device.
1. Complete one of the following steps to change the console type:
  - Change your console to the HMC. To set the new console tag to the HMC 5250 console, type the following:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a console_slot=hmc 
```
  - Change your console to Operations Console (LAN).
    To set the new console tag to an IOA with a DRC index of 21010004 (the DRC index can be found in step 1.c), type the following:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a console_slot=21010004 
```
  - Change your console to Operations Console (LAN) using a host Ethernet adapter logical port. To set the new console tag to a host Ethernet adapter logical port with a DRC index of 23e01000 (the DRC index can be found in step 1.c), type the following:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a console_slot=23e01000 
```
2. To verify your changes, repeat step 1.c.
  Notes:
  - To clear the console tag, type the following:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a console_slot=none
```
  - To clear the Operations Console tag, type the following:
```
chhwres -m sysname -r io --rsubtype taggedio --id 1 -o s -a op_console_slot=none
```
  - If entering none in the previous command results in an error message, try entering eight zeros (00000000) instead.
Search for the console device by doing the following sequence of console service functions against the logical partition: 65+21+21. Do this sequence of three console service functions within 45 seconds for each function to start a new search for the console device.
1. To perform function 65 (remote DST off), type the following:
```
chsysstate -m sysname -r lpar --id 1 -o remotedstoff
```
2. To perform function 21 (force DST), type the following:
```
chsysstate -m sysname -r lpar --id 1 -o dston
```
3. Repeat step 3.b.
Try to connect with the newly selected console device, and monitor the system reference codes (SRCs) for the logical partition. It can take up to 3 minutes for the console adapter change to be completed.
Note: To monitor the SRCs for the logical partition, type the following to list the last 10 SRCs:
```
lsrefcode -m sysname -r lpar -n 10 --filter "lpar_ids=1" 
```
SRCs are listed in order from newest to oldest. To list a different number, replace 10 in the command with the number of SRCs that you want returned.
Update the logical partition profile on the HMC to match the dynamic console change:
1. In the navigation area, click Systems Management > Servers.
2. In the navigation area, select the managed system.
3. In the contents area, select the logical partition that you want to change.
4. Use one of the following navigation options depending on the version of HMC:
  - If you are using an HMC Classic or HMC Enhanced interface, click Tasks > Configuration > Manage Profiles.
  - If you are using an HMC Enhanced + Tech Preview (Pre-GA) or HMC Enhanced+ interface, click Actions > Profiles > Manage Profiles.
5. Select the logical partition profile that you want to change.
6. Click Actions > Edit.
7. Click Tagged I/O, and then click Select in the Console area.
8. Select the resource if it is an IOA, or switch from I/O device to Logical Port to use a host Ethernet adapter logical port.
9. Click OK.
10. Click OK > Close.

Last updated: Tue, February 17, 2015