Completing the data migration from SUSE Linux Enterprise Server 9

Complete the steps to upgrade and prepare your SUSE Linux^® Enterprise Server 9 for the data migration.

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

Create a save file on the i5/OS^® logical partition that you are migrating your Linux partition to. Use the same name you used for the save file on your 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 wrknwsstg command. After you run this command, the migrated NWSSTG appears.
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 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 under Remote partition.
  - The Remote partition virtual slot number should match the slot number for the SCSI server of 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 it shares its resources with under Remote partition.
  - The Remote partition virtual slot number should match the slot number for the SCSI client of the Linux partition.
Create and configure your network server description (NWSD) to use virtual SCSI by completing 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 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 (*NONE)
PWRCTL (*YES)
```
    Notes:
    1. 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.
    2. For the IPLSTMF, use the path as recommended by the distributor's installation document. One example is /QOPT/SU90.001/install.
  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 one into the CD-ROM drive of your i5/OS 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 your vary on is successful, choose the 'boot installed system' option from your terminal window.
Your boot fails because your /etc/fstab file is not correct. Enter your root password and complete the following steps to correct your fstab file:
1. Remount your root partition by entering the command:
```
mount -t <your FS type> -o remount,rw <your root device> /
```
  Note: An example of an FS type is reiserfs and an example of a root device is /dev/sda3.
2. 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.
5. Save and exit by pressing the Esc key, and then entering :wq!
Type Exit, and your Linux logical partition will restart.
Notes:
1. At this point, the Linux partition will return to the install server where you can start the installed server.
2. Before starting, you might need to install modules for any hardware that is connected to your partition. See the distributor's documentation for more details.
3. When starting, you might see some network error messages. These errors can be ignored.
After your server has finished restarting, add 'ibmvscsic' and remove viodasd if present to the 'INITRD' line in the file /etc/sysconfig/kernel.
Edit the /etc/lilo.conf file by making the following changes:
1. Change the boot line to 'boot=<the path to your PReP boot partition>'
2. Change the root line to 'root=<the path to your root partition>'
3. Add 'activate' under boot
4. Delete any extra boot lines listed near the top of the file.
Note: An example path to your PReP boot partition is /dev/sda1 and an example path to your root partition is "/dev/sda3".
Install your new kernel using the command:
```
rpm -Uvh <kernel rpm>
```
Note: Ensure you are in the current directory that you transferred your save file to.
Shutdown your Linux logical partition.

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 (*root)
PWRCTL (*YES)

Note: Use the directory that your Linux kernel is in for the IPLPARM.

Start your Linux logical partition.
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.