Finalizing Red Hat Enterprise Linux version 3 migration

Complete these steps to finalize the Red Hat Enterprise Linux® version 3 migration.

Create a virtual SCSI server and client environment. Create this environment by completing the following steps from your client partition (Linux partition):
1. Right-click its partition profile in the HMC and select Properties.
2. Select the Virtual I/O tab.
3. If no client SCSI adapters are available, create a client SCSI adapter at the bottom of the tab. When creating a client SCSI adapter, ensure that you specify the following:
  - Select Client for the adapter type.
  - Ensure that it points to the correct server partition that is sharing its resources with your client partition under Remote partition.
  - Ensure that the Remote partition virtual slot number matches the slot number for the SCSI server on the partition that is sharing its resources.
4. Select the Power controlling tab.
5. Select Power controlling partitions to add, and then select the partition that is sharing its resources.
From the server partition that is sharing its resources (IBM® i logical partition):
1. Right-click its partition profile in the HMC, and then select Properties.
2. Select the Virtual I/O tab.
3. If no client SCSI adapters are available, create a client SCSI adapter at the bottom of the tab. When creating a client SCSI adapter, ensure that you specify the following:
  - Select Server for the adapter type.
  - Ensure that it points to the correct client partition that is obtaining resources from it under Remote partition.
  - Ensure that the Remote partition virtual slot number matches the slot number for the SCSI client on the Linux partition.
Create and configure your network server description (NWSD) to use virtual SCSI. To create and configure your NWSD, complete the following steps:
1. Create your NWSD and link your migrated network server storage space (NWSSTG). To create and link this, complete the following steps:
  1. At an IBM i command line on the partition that shares resources, type CRTNWSD, and then press F4 for prompts.
  2. Specify the following information:
```
NWSD (Provide a name for the NWSD)
RSRCNAME (*AUTO)
TYPE(*GUEST)
ONLINE (*NO or *YES)
PARTITION ('Provide the name of your AIX or Linux logical partition')
CODEPAGE (437)
TCPPORTCFG (*NONE)
RSTDDEVRSC (for virtual CD and tape devices) (*NONE)
SYNCTIME (*TYPE)
IPLSRC (*STMF)
IPLSTMF (*QOPT)
IPLPARM (rescue)
PWRCTL (*YES)
```
    Notes:
    1. After the installation, if your root file system (/) is not installed on the first partition of the first disk, set a root parameter.
    2. For the IPLSTMF, use the path as recommended by the distributor's installation document. One example is /QOPT/RED_HAT/images/netboot.img.
    3. Enter in the partition name or the partition number, but not both.
  3. Link the network server storage space by completing the following steps:
    1. At an IBM i command line, type the command ADDNWSSTGL, and then press F4.
    2. Enter the following parameter values on the Add Network Server Storage Link (ADDNWSSTGL) display, and then press Enter.
      - In the Network server description field, specify the name of the network server description (NWSD).
      - In the Dynamic storage link field, specify *YES to make the network server storage space dynamically available to the partition (that is, available without rebooting the Linux partition).
      - In the Drive sequence number field, specify the link sequence position you want to use.
2. Locate the type 290B communication adapters, which are the virtual SCSI connections. Enter WRKHDWRSC *CMN and then enter a 7 (display resource detail). Match the adapter to the slot and enter the resource name for the adapter (for example, CTL07) in the resource name file of your NWSD.
Activate the Linux partition from the HMC if you have not already done so. To activate the partition, right-click your partition in the HMC and select Activate.
Open a terminal window for the Linux partition. To open a terminal window, right-click your Linux partition and select Open Terminal Window. Activating and shutting down your Linux partition are essential steps to prepare the partition before you vary on the NWSD.
Shut down your Linux partition from the HMC. To shut down the partition, right-click your partition in the HMC, and then select Shut Down Partition.
Put CD or DVD 1 into the optical drive of your IBM i partition that is sharing its resources.
Vary on your NWSD by completing the following steps:
1. Type WRKCFGSTS *NWS, and then press Enter.
2. Type 1 next to the NWSD that you want to start, and then press Enter.
If the vary on is successful, Linux will boot into the rescue system in your terminal window. Answer the prompts for the appropriate language.
Note: Allow the rescue system to search for the installation.
Ensure that your root partition is mounted correctly. From the shell command prompt, enter the command:
```
chroot/mnt/sysimage
```
1. Change the format for System i® virtual devices. Normally, you make these changes in the /etc/fstab file. Edit the fstab file by changing the names based on the following table.
  Virtual device Previous name New name
  
  Virtual disk /dev/iseries/vdxx /dev/sdxx
  
  Virtual CD /dev/iseries/vcdxx /dev/srxx
  
  Virtual tape /dev/iseries/vtxx /dev/stxx
  
  To edit the fstab file, complete the following steps:
  1. To find your file, enter cd /
  2. Enter cd etc
  3. Enter vi fstab
  4. Change the virtual devices based on the preceding table.
    Note: Because Red Hat uses disk labeling, change the swap partition's device path along with any other custom mount points you might have added to the fstab file. For example, the line /dev/iseries/vda2 swap swap defaults 0 0 becomes /dev/sda2 swap swap defaults 0 0.
  5. Save and exit by pressing ESC, and then entering :wq!
Change the System i virtual console by editing the /etc/inittab file. To edit the inittab file, complete the following steps:
1. To find the file, enter cd /
2. Enter cd /etc
3. Enter vi inittab
4. Near the bottom of the file, find the following six lines:
```
1:2345:respawn:/sbin/mingetty tty1
2:2345:respawn:/sbin/mingetty tty2
3:2345:respawn:/sbin/mingetty tty3
4:2345:respawn:/sbin/mingetty tty4
5:2345:respawn:/sbin/mingetty tty5
6:2345:respawn:/sbin/mingetty tty6
```
5. Comment out each of these lines by entering # at the beginning of each line.
6. Add the following line before the six lines listed above:
```
co:2345:respawn:/sbin/agetty hvc0 38400 vt100
```
Change the symbolic link to the optical device by completing the following tasks:
1. Enter rm /dev/cdrom
2. Enter ln —s /dev/scd0 /dev/cdrom
  Note: Perform this step for other optical devices that you might have.
Install the new kernel by completing the following steps:
1. Enter vi /etc/modules.conf
2. Change the line alias scsi_hostadapter viodasd to alias scsi_hostadapter ibmvscsic
3. If you are using virtual ethernet, change the line alias eth0 veth to alias eth0 ibmveth
4. Enter ln —s /sbin/ybin /usr/sbin/ybin
5. Create an /etc/yaboot.conf configuration file by entering vi /etc/yaboot.conf. The file should contains:
```
boot=/dev/sda1 (The location of your PReP boot partition)

partition=2 (The partition number for your root partition)
timeout=30
install=/usr/lib/yaboot/yaboot
delay=10
nonvram

image=/boot/vmlinux-2.4.21-18.EL (Kernel file based on your version of Red Hat.)
	Label=2.4.21-18.EL.img (Name for this kernel)
	read-only
	initrd=/boot/initrd-2.4.21-18.EL.img (Path to initrd file based on Red Hat version.)
	append="console=hvc0 root=LABEL=/
```
6. Install the POWER® Linux kernel RPM by entering:
```
rpm -ivh <kernel version number>.ppc64.rpm
```
  Notes:
  1. Ensure that you are in the directory in which you transferred your save file to. Add /root/ before your kernel version number if the installation is not working correctly in your current directory.
  2. Ensure that the mkinitrd command or the kernel installation return no errors. If mkinitrd returns an error, check the changes that you made in the /etc/modules.conf file. You might see errors that can be ignored that are returned by the tar command if you do not have the time and date properly set on your partition.
Edit the /etc/securetty file and perform the following steps:
1. To find the file, enter cd /
2. Enter cd /etc
3. Enter vi securetty
4. On a new line at the end of the file, enter hvc0
5. Save and exit the file by pressing ESC, and then entering :wq!
Enter exit twice to exit the rescue system. The system shuts down.
Complete the following steps to vary off the NWSD:
1. Type WRKCFGSTS *NWS, and then press Enter.
2. Type 2 next to the NWSD that you want to start, and then press Enter.

Virtual device	Previous name	New name
Virtual disk	/dev/iseries/vdxx	/dev/sdxx
Virtual CD	/dev/iseries/vcdxx	/dev/srxx
Virtual tape	/dev/iseries/vtxx	/dev/stxx

Reconfigure the NWSD to start the partition from NWSSTG. See the distributor's documentation for more details.

Specify the following information:

NWSD (Provide a name for the NWSD)
TYPE(*GUEST)
ONLINE (*NO or *YES)
PARTITION ('Provide the name of your AIX or Linux logical partition')
CODEPAGE (437)
TCPPORTCFG (*NONE)
RSTDDEVRSC (for virtual CD and tape devices) (*NONE)
SYNCTIME (*TYPE)
IPLSRC (*NWSSTG)
IPLSTMF (*NONE)
IPLPARM (*NONE)
PWRCTL (*YES)

Complete the following steps to vary on the NWSD:
1. Type WRKCFGSTS *NWS, and then press Enter.
2. Type 1 next to the NWSD that you want to start, and then press Enter.
To enable power control of the Linux partition from IBM i and the HMC, download the DynamicRM and Diagela RPMs. The Linux support Web site contains all the directions necessary for you to get the applications installed.