Completing the data migration from Red Hat Enterprise Linux version 3

Complete the steps to upgrade and prepare your Red Hat^® Enterprise Linux^® version 3 for the data migration.

This section provides information about completing a Linux data migration. This information only covers a data migration from Red Hat Enterprise Linux version 3 on an IBM^® iSeries™ or IBM eServer™ i5 model to Red Hat Enterprise Linux version 3 on an IBM System i5™ or eServer i5 model. Complete your data migration from Red Hat Enterprise Linux version 3 by performing the following tasks on your target server:

Create a save file on the i5/OS^® logical partition you are migrating your Linux partition to. Use the same name you used for the save file on the source server and the QGPL library.
Use file transfer protocol (FTP) to transfer your save file to the i5/OS logical partition that will be using the virtual disks.
Note: This step assumes that you want to use file transfer protocol (ftp) to transfer the save file over. You can also use backup and recovery to transfer your save file over. See the Backup and Recovery Guide for more information.
Restore your save file using the RST command. To continue the LINUX530 example, the following command restores the save file:
```
RST
DEV('QSYS.LIB/QGPL.LIB/TEST1.FILE')
OBJ('/QFPNWSSTG/LINUX530' *INCLUDE)
SUBTREE(*ALL)
```
Note: This step also needs to be completed for UDFS files that are saved from secondary auxiliary storage pools (ASP).
Run the wrknwsstg command. After you run this command, the migrated NWSSTG appears.
Create a virtual SCSI server and client 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 there are no client SCSI adapters, create a client SCSI adapter at the bottom of the tab. When creating a client SCSI adapter, ensure 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 it under Remote partition.
  - The Remote partition virtual slot number should match the slot number for the SCSI server on the partition that is sharing its resources.
4. Select the Power controlling tab.
5. Under Power controlling partitions to add, select the partition that is sharing its resources.
From your server partition that is sharing its resources (i5/OS partition):
1. Right-click its partition profile in the HMC and select Properties.
2. Select the Virtual I/O tab.
3. If there are no client SCSI adapters, create a client SCSI adapter at the bottom of the tab. When creating a client SCSI adapter, ensure 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.
  - The Remote partition virtual slot number needs to match 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). by completing the following steps:
  1. At an i5/OS command line on the partition that shares resources, type CRTNWSD and 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:
    - After the installation, if your root file system (/) is not installed on the first partition of the first disk, you must set a root parameter.
    - For the IPLSTMF, use the path as recommended by the distributor's installation document. One example is /QOPT/RED_HAT/images/netboot.img.
    - 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 i5/OS command line, type the command ADDNWSSTGL and press F4.
    2. Enter the following parameter values on the Add Network Server Storage Link (ADDNWSSTGL) display and 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 wish 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 adapter's resource name (for example, CTL07) in the resource name file of your NWSD.
Activate your Linux partition from the HMC if you have not already done so. To activate your partition, right-click your partition in the HMC and select Activate.
Open a terminal window for your 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 your partition before you vary on your NWSD.
Shutdown your Linux partition from the HMC. To shutdown your partition, right-click your partition in the HMC and select Shut Down Partition.
Put CD 1 into the CD-ROM drive of your i5/OS partition that is sharing its resources.
Vary on your NWSD. Complete the following steps to vary on your 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.
If your vary on is successful, Linux will boot into rescue system in your terminal window. Answer the prompts for the appropriate language.
Note: Allow the rescue system to search for your installation.
Ensure your root partition is mounted correctly. From the shell command prompt, enter:
```
chroot/mnt/sysimage
```
1. Change the format for iSeries virtual devices. These changes normally will be 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 your virtual devices based on the 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 the Esc key, and then entering :wq!
Change the iSeries virtual console by editing your /etc/inittab file. To edit your inittab file, complete the following steps:
1. To find your 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 your CD-ROM 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 CD-ROM devices that you might have.
Install your 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 contains the following:
```
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 pSeries^® kernel RPM by entering:
```
rpm -ivh <kernel version number>.ppc64pseries.rpm
```
  Notes:
  1. Ensure you are in the current directory that 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 there are no errors returned from mkinitrd or the kernel installation. If mkinitrd returns an error, check the changes 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 your /etc/securetty file and add a line that states hvc0. To make this change, perform the following steps:
1. To find your file, enter cd /
2. Enter cd /etc
3. Enter vi securetty
4. Enter a new line at the end of the file that states hvc0
5. Save and exit by pressing the Esc key, and then entering :wq!
Enter exit twice to exit the rescue system. The system shuts down.
Vary off your NWSD. Complete the following steps to vary off your 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)

Vary on your NWSD. Complete the following steps to vary on your 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 i5/OS and the HMC, download the DynamicRM and Diagela RPM's. The Linux support Web site contains all the directions necessary for the user to get the applications installed.