Using the ldmp2v Command

This section includes examples for the three phases.

Example C–1 Collection Phase Examples

The following examples show how you might use the ldmp2v collect command.

• Sharing an NFS-mounted file system. The following example shows the simplest way to perform the collect step where the source and target systems share an NFS-mounted file system.

  As superuser, ensure that all required UFS file systems are mounted.

  volumia# df -k Filesystem kbytes used avail capacity Mounted on /dev/dsk/c1t1d0s0 16516485 463289 15888032 3% / /proc 0 0 0 0% /proc fd 0 0 0 0% /dev/fd mnttab 0 0 0 0% /etc/mnttab /dev/dsk/c1t1d0s3 8258597 4304 8171708 1% /var swap 4487448 16 4487432 1% /var/run swap 4487448 16 4487432 1% /tmp /dev/dsk/c1t0d0s0 1016122 9 955146 1% /u01 vandikhout:/u1/home/dana 6230996752 1051158977 5179837775 17% /home/dana

  The following shows how to run the collection tool when the source and target systems share an NFS-mounted file system:

  volumia# ldmp2v collect -d /home/dana/p2v/volumia Collecting system configuration ... Archiving file systems ... DUMP: Writing 63 Kilobyte records DUMP: Date of this level 0 dump: vr 28 nov 2008 15:04:03 MET DUMP: Date of last level 0 dump: the epoch DUMP: Dumping /dev/rdsk/c1t1d0s0 (volumia:/) to /home/dana/p2v/ufsdump.0. DUMP: Mapping (Pass I) [regular files] DUMP: Mapping (Pass II) [directories] DUMP: Estimated 950240 blocks (463,98MB). DUMP: Dumping (Pass III) [directories] DUMP: Dumping (Pass IV) [regular files] DUMP: 950164 blocks (463,95MB) on 1 volume at 6215 KB/sec DUMP: DUMP IS DONE DUMP: Writing 63 Kilobyte records DUMP: Date of this level 0 dump: vr 28 nov 2008 15:05:27 MET DUMP: Date of last level 0 dump: the epoch DUMP: Dumping /dev/rdsk/c1t0d0s0 (volumia:/u01) to /home/dana/p2v/ufsdump.1. DUMP: Mapping (Pass I) [regular files] DUMP: Mapping (Pass II) [directories] DUMP: Estimated 282 blocks (141KB). DUMP: Dumping (Pass III) [directories] DUMP: Dumping (Pass IV) [regular files] DUMP: 250 blocks (125KB) on 1 volume at 8928 KB/sec DUMP: DUMP IS DONE DUMP: Writing 63 Kilobyte records DUMP: Date of this level 0 dump: vr 28 nov 2008 15:05:27 MET DUMP: Date of last level 0 dump: the epoch DUMP: Dumping /dev/rdsk/c1t1d0s3 (volumia:/var) to /home/dana/p2v/ufsdump.2. DUMP: Mapping (Pass I) [regular files] DUMP: Mapping (Pass II) [directories] DUMP: Estimated 13324 blocks (6,51MB). DUMP: Dumping (Pass III) [directories] DUMP: Dumping (Pass IV) [regular files] DUMP: 13228 blocks (6,46MB) on 1 volume at 1146 KB/sec DUMP: DUMP IS DONE

• Not sharing an NFS-mounted file system. When the source and target systems do not share an NFS-mounted file system, the file system image can be written to local storage and be later copied to the control domain. Since it is not possible to use ufsdump to exclude files, use the flash archiving method that is provided by ldmp2v. The flash tool automatically excludes the archive that it creates.

  volumia# ldmp2v collect -d /home/dana/p2v/volumia -a flash Collecting system configuration ... Archiving file systems ... Determining which filesystems will be included in the archive... Creating the archive... 895080 blocks Archive creation complete.

• Skip file-system backup step. If backups of the system are already available using a third-party backup tool such as NetBackup, you can skip the file system backup step by using the none archiving method. When you use this option, only the system configuration manifest is created.

  volumia# ldmp2v collect -d /home/dana/p2v/volumia -a none Collecting system configuration ... The following file system(s) must be archived manually: / /u01 /var

  Note that if the directory specified by -d is not shared by the source and target systems, copy the contents of that directory to the control domain. The directory contents must be copied to the control domain prior to beginning the preparation phase.

Example C–2 Preparation Phase Examples

The following examples show how you might use the ldmp2v prepare command.

• The following example creates a logical domain called volumia by using the defaults configured in /etc/ldmp2v.conf while keeping the MAC addresses of the physical system:

  # ldmp2v prepare -d /home/dana/p2v/volumia -o keep-mac volumia Creating vdisks ... Creating file systems ... Populating file systems ... Modifying guest domain OS image ... Removing SVM configuration ... Unmounting guest file systems ... Creating domain volumia ... Attaching vdisks to domain volumia ...

• The following command shows information about the volumia logical domain:

  # ldm list -l volumia NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME volumia inactive ------ 2 4G NETWORK NAME SERVICE DEVICE MAC MODE PVID VID vnet0 primary-vsw0 00:03:ba:1d:7a:5a 1 DISK NAME DEVICE TOUT MPGROUP VOLUME SERVER disk0 volumia-vol0@primary-vds0 disk1 volumia-vol1@primary-vds0

• The following shows that you can completely remove a domain and its backend devices by using the -C option:

  # ldmp2v prepare -C volumia Cleaning up domain volumia ... Removing vdisk disk0 ... Removing vdisk disk1 ... Removing domain volumia ... Removing volume volumia-vol0@primary-vds0 ... Removing ZFS volume tank/ldoms/volumia/disk0 ... Removing volume volumia-vol1@primary-vds0 ... Removing ZFS volume tank/ldoms/volumia/disk1 ...

• The following shows that you can resize one or more file systems during P2V by specifying the mount point and the new size with the -m option:

  # ldmp2v prepare -d /home/dana/p2v/normaal -m /:8g normaal Resizing file systems ... Creating vdisks ... Creating file systems ... Populating file systems ... Modifying guest domain OS image ... Removing SVM configuration ... Modifying file systems on SVM devices ... Unmounting guest file systems ... Creating domain normaal ... Attaching vdisks to domain normaal ...

Example C–3 Conversion Phase Examples

The following examples show how you might use the ldmp2v convert command.

• Using a network installation server. The ldmp2v convert command boots the Logical Domain over the network by using the specified virtual network interface. You must run the setup_install_server and add_install_client scripts on the installation server.

  You can use the Custom JumpStart feature to perform a completely hands-off conversion. This feature requires that you create and configure the appropriate sysidcfg and profile files for the client on the JumpStart server. The profile should consist of the following lines:

  install_type upgrade root_device c0d0s0

  The sysidcfg file is only used for the upgrade operation, so a configuration such as the following should be sufficient:

  name_service=NONE root_password=uQkoXlMLCsZhI system_locale=C timeserver=localhost timezone=Europe/Amsterdam terminal=vt100 security_policy=NONE nfs4_domain=dynamic network_interface=PRIMARY {netmask=255.255.255.192 default_route=none protocol_ipv6=no}

  For more information about using Custom JumpStart, see Solaris 10 10/09 Installation Guide: Custom JumpStart and Advanced Installations.

  # ldmp2v convert -j -n vnet0 -d /p2v/volumia volumia LDom volumia started Waiting for Solaris to come up ... Using Custom JumpStart Trying 0.0.0.0... Connected to 0. Escape character is '^]'. Connecting to console "volumia" in group "volumia" .... Press ~? for control options .. SunOS Release 5.10 Version Generic_137137-09 64-bit Copyright 1983-2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. onfiguring devices. Using RPC Bootparams for network configuration information. Attempting to configure interface vnet0... Configured interface vnet0 Reading ZFS config: done. Setting up Java. Please wait... Serial console, reverting to text install Beginning system identification... Searching for configuration file(s)... Using sysid configuration file 129.159.206.54:/opt/SUNWjet/Clients/volumia/sysidcfg Search complete. Discovering additional network configuration... Completing system identification... Starting remote procedure call (RPC) services: done. System identification complete. Starting Solaris installation program... Searching for JumpStart directory... Using rules.ok from 129.159.206.54:/opt/SUNWjet. Checking rules.ok file... Using begin script: Clients/volumia/begin Using profile: Clients/volumia/profile Using finish script: Clients/volumia/finish Executing JumpStart preinstall phase... Executing begin script "Clients/volumia/begin"... Begin script Clients/volumia/begin execution completed. Searching for SolStart directory... Checking rules.ok file... Using begin script: install_begin Using finish script: patch_finish Executing SolStart preinstall phase... Executing begin script "install_begin"... Begin script install_begin execution completed. WARNING: Backup media not specified. A backup media (backup_media) keyword must be specified if an upgrade with disk space reallocation is required Processing profile Loading local environment and services Generating upgrade actions Checking file system space: 100% completed Space check complete. Building upgrade script Preparing system for Solaris upgrade Upgrading Solaris: 10% completed [...]

• Using an ISO image. The ldmp2v convert command attaches the Solaris DVD ISO image to the logical domain and boots from it. To upgrade, answer all sysid prompts and select Upgrade.

  ---

  Note –

  The answers to the sysid questions are only used during the upgrade process, so you can select the simplest options (non-networked, no naming service, and so on). The system's original identity is preserved by the upgrade and takes effect on the reboot after the upgrade is complete. The time required to perform the upgrade depends on the Solaris cluster that is installed on the original system.

  ---

  # ldmp2v convert -i /tank/iso/s10s_u5.iso -d /home/dana/p2v/volumia volumia Testing original system status ... LDom volumia started Waiting for Solaris to come up ... Select 'Upgrade' (F2) when prompted for the installation type. Disconnect from the console after the Upgrade has finished. Trying 0.0.0.0... Connected to 0. Escape character is '^]'. Connecting to console "volumia" in group "volumia" .... Press ~? for control options .. Configuring devices. Using RPC Bootparams for network configuration information. Attempting to configure interface vnet0... Extracting windowing system. Please wait... Beginning system identification... Searching for configuration file(s)... Search complete. Discovering additional network configuration... Configured interface vnet0 Setting up Java. Please wait... Select a Language 0. English 1. French 2. German 3. Italian 4. Japanese 5. Korean 6. Simplified Chinese 7. Spanish 8. Swedish 9. Traditional Chinese Please make a choice (0 - 9), or press h or ? for help: [...] - Solaris Interactive Installation -------------------------------------------- This system is upgradable, so there are two ways to install the Solaris software. The Upgrade option updates the Solaris software to the new release, saving as many modifications to the previous version of Solaris software as possible. Back up the system before using the Upgrade option. The Initial option overwrites the system disks with the new version of Solaris software. This option allows you to preserve any existing file systems. Back up any modifications made to the previous version of Solaris software before starting the Initial option. After you select an option and complete the tasks that follow, a summary of your actions will be displayed. ------------------------------------------------------------------------------- F2_Upgrade F3_Go Back F4_Initial F5_Exit F6_Help