r24 - 31 Aug 2010 - 20:02:39 - ApoorvaKulkarniYou are here: Wiki >  AppLogic29 Web > RefHvm2Pv
ALERT! AppLogic 2.9 Documentation The latest production release is AppLogic 3.0.30

hvm2pv reference

Overview

The hvm2pv utility assists the conversion of an un-managed HVM (fully-virtualized) appliance to a managed PV (Para-virtualized) appliance. This utility can be used in conjunction with iso2class to convert an appliance created using iso2class to a fully-managed para-virtualized appliance. The resulting appliance can be used as a singleton or can be added to the catalog. The process does involve some amount of user input and cannot be automated.

Usage

hvm2pv can be invoked at the end of iso2class or at any other time. The target appliance has to be an un-managed HVM appliance. hvm2pv is invoked from the AppLogic command line shell using util hvm2pv. Help is displayed using help util hvm2pv. The following option=value arguments are required:

Option Description
name Name of the appliance in the form app_name:main.instance_name

Examples

Convert 32-bit RedHat based HVM to PV: 
util hvm2pv name=fedora-hvm:main.iso2class

Convert 64-bit Ubuntu based HVM to PV: 

util hvm2pv name=ubuntu-hvm:main.iso2class

Preparing for hvm2pv Conversion

ALERT! To prepare an HVM appliance for PV conversion:

  • Install the OS to a single ext3 partition without a swap partition.
  • Install or verify the presence of openssh server.
  • Install or verify the presence of iproute2.
  • For 64-bit appliances, install or verify the presence of libc6-i386.
  • Ensure that sshd is configured with PubkeyAuthentication=yes and PermitRootLogin=yes.
  • Ensure that dhclient is present in the appliance.

The following OS specific notes have been garnered from practical experience:

  • Ubuntu varients:
    • The default route may automatically be setup on the internal interface. If this occurs, set the default route to the external interface with:
      • route del default
      • route add default gw IP eth0 where IP is the IP address of the gateway on the external interface
    • During the iso2class install of Ubuntu, after configuring the external interface:
      • apt-get remove network-manager
      • apt-get install openssh-server
  • Debian 5.0.1 apt-get install openssh-server may not succeed in installing from the cd-rom device when the iso image is mounted on the running OS because the iso volume is not recognized as the cd-rom. To work around this:
    • mv /media/cdrom0 /media/was_cdrom0
    • ln -s /media/Debian\ 5.0.1\ i386\ Bin-1/ /media/cdrom0
    • apt-get install openssh-server
    • rm -f /media/cdrom0
    • mv /media/was_cdrom0 /media/cdrom0

Notes

Supported OSes

  • Currently only Redhat based (RHEL, Fedora, CentOS) and Debian based (Debian, Ubuntu) distros are supported.

Debugging Appliance Start issues

If you are trying to start an appliance that is converted from HVM to PV using hvm2pv and the appliance fails to start within the boot timeout timeout, please check for the following:
  • LVM appliances
    • Appliances created with Logical Volume Management groups are not supported by hvm2pv
  • openssh-server
    • Verify that openssh-server is installed during OS install or immediately after, before using hvm2pv
  • NetworkManager
    • Verify NetworkManager was disbaled/removed before using hvm2pv on an Ubuntu appliance
  • libc6-i386
    • For a 64-bit appliance, verify that libc6-i386 package is installed during OS install or immediately after, before using hvm2pv
  • iproute2
    • Verify that iproute2 package is installed during OS install or immediately after, before using hvm2pv
  • dhclient
    • Verify that dhclient is present in appliance.

-- ApoorvaKulkarni - 24 Nov 2008

 
Copyright © CA 2005-2012. All Rights Reserved.
%