Using the ldmp2v Command
This section includes examples for the three phases of conversion.
Example 80 Collection Phase ExamplesSharing 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/danaThe following example 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/volumia Collecting system configuration ... Archiving file systems ... Determining which filesystems will be included in the archive... Creating the archive... 895080 blocks Archive creation complete.
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 later copied to the control domain. The Flash Archive utility automatically excludes the archive that it creates.
volumia# ldmp2v collect -d /var/tmp/volumia Collecting system configuration ... Archiving file systems ... Determining which filesystems will be included in the archive... Creating the archive... 895080 blocks Archive creation complete.
Copy the flash archive and the manifest file from the /var/tmp/volumia directory to the target system.
Tip - In some cases, ldmp2v might show cpio command errors. Most commonly, these errors generate messages such as File size of etc/mnttab has increased by 435. You can ignore messages that pertain to log files or to files that reflect the system state. Be sure to review all error messages thoroughly.Skip file-system backup step. If you already create backups of the system 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, you must copy the contents of that directory to the control domain. The directory contents must be copied to the control domain prior to the preparation phase.
The following examples show how you might use the ldmp2v collect 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-vds0The following example shows how to completely remove a domain and its back-end 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 example shows how to 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/volumia -m /:8g volumia 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 volumia ... Attaching vdisks to domain volumia ...
The following examples show how you might use the ldmp2v prepare command.
Using a network installation server. The ldmp2v convert command boots the 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.
On Oracle Solaris 10 systems, you can use the Oracle Solaris JumpStart feature to perform a fully automated 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 auto_reg=disable network_interface=PRIMARY {netmask=255.255.255.192 default_route=none protocol_ipv6=no}For more information about using JumpStart, see Oracle Solaris 10 1/13 Installation Guide: JumpStart Installations .
Note - The example sysidcfg file includes the auto_reg keyword, which was introduced in the Oracle Solaris 10 9/10 release. This keyword is required only if you are running at least the Oracle Solaris 10 9/10 release.# 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 (c) 1983-2010, Oracle and/or its affiliates. All rights reserved. Configuring 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 Oracle Solaris DVD ISO image to the logical domain and boots from it. To upgrade, answer all sysid prompts and select Upgrade.
Caution - A safety check is performed prior to converting the guest domain. This check ensures that none of the original system's IP addresses are active so as to prevent duplicate active IP addresses on the network. You can use the –x skip-ping-test option to skip this safety check. Skipping this check speeds up the conversion process. Use this option only if you are certain that no duplicate IP addresses exist, such as when the original host is not active.
The answers to the sysid questions are used only for the duration of the upgrade process. This data is not applied to the existing OS image on disk. The fastest and simplest way to run the conversion is to select Non-networked. The root password that you specify does not need to match the root password of the source system. The system's original identity is preserved by the upgrade and takes effect after the post-upgrade reboot. The time required to perform the upgrade depends on the Oracle 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
The following examples show how you might use the ldmp2v convert command.