hpvmstart — Start a virtual machine.



  • NAME
    hpvmstart — Start a virtual machine.
    
    SYNOPSIS
    hpvmstart { -P vm-name -p vm-number } [ -F -s ] [-Q]
    
    DESCRIPTION
    The hpvmstart command causes the specified virtual machine to start. The 
    virtual machine must exist and be in the off state. The hpvmstart command 
    verifies that the starting virtual machine can be allocated all of the required 
    resources defined by its configuration file. If not, the virtual machine is not 
    started.
    
    Any of the following conditions can prevent the virtual machine from starting:
    
    The server has fewer CPUs than the virtual machine requires.
    
    The server has insufficient free memory.
    
    The server has insufficient CPU resources.
    
    The server has insufficient swap resources.
    
    Another virtual machine is using a specified nonshared backing device.
    
    The server is using a specified backing device.
    
    A specified backing device does not exist.
    
    A specified vswitch is not available. The vswitch must be created using the 
    hpvmnet command before the guests using it can be started.
    
    The specified MAC address is in use.
    
    The specified guest is a distributed guest.
    
    Only superusers can execute the hpvmstart command.
    
    Options
    The following options can be specified only once.
    
    The hpvmstart command recognizes the following command-line options and 
    arguments:
    
    -P vm-name
    Specifies the name of the virtual machine to be started.
    
    You must specify either the -P or the -p option.
    
    -p vm-number
    Specifies the number of the virtual machine to be booted. The vm-number is 
    displayed by the hpvmstatus command.
    
    You must specify either the -P or the -p option.
    
    -F
    Forces the virtual machine to skip all the resource checks. No warnings are 
    issued.
    
    
    	
    
    	CAUTION: HP does not recommend using the -F option because it can 
    result in poor virtual machine performance, oversubscription, or data 
    corruption, or it can cause the virtual machine to hang.
    
    	
    
    -s
    Examines the specified guest configuration and reports any errors or warnings 
    that can prevent it from starting. The guest is not started.
    
    -Q
    Quietly performs the command. The default is to prompt for confirmation of the 
    command before executing it.
    
    RETURN VALUES
    The command exits with one of the following values:
    
    0: Successful completion.
    1: One or more error conditions occurred.
    DIAGNOSTICS
    The hpvmstart command displays error messages on stderr for any of the 
    following conditions:
    
    An invalid option is specified.
    
    The vm-name or vm-number does not exist, cannot be accessed, is not a virtual 
    machine, or is corrupt.
    
    The virtual machine is in a state other than off and cannot be started. Use the 
    hpvmstop command to stop the virtual machine.
    
    The virtual machine cannot boot at this time because of detected resource 
    complaints.
    
    The hpvmstart command and the Integrity VM software are at different version 
    levels.
    
    EXAMPLES
    
    Start the virtual machine called myguest:
    
    
    # hpvmstart -P myguest
    
    The following are sample warning messages returned when hpvmstart is executed 
    with various configuration problems on guest myguest:
    
    
    Warning 1: Guest needs more vcpus than server supports. Warning 2: Insufficient 
    free memory for guest. Warning 3: Insufficient swap resource for guest. Warning 
    4: Insufficient cpu resource for guest. Warning 5 on item /dev/rdisk/disk0: 
    Device file '/dev/rdisk/disk0' in use by another guest. Warning 6 on item 
    /dev/vg00/rswap: Device file '/dev/vg00/rswap' in use by server. Warning 7 on 
    item /dev/rdisk/disk3 backing device does not exist. Warning 8 on item 
    /dev/rdisk/disk4: Device file '/dev/rdisk/disk4:' in use by another guest. 
    Warning 9 on item hostnet: MAC address in use for switch hostnet. Warning 10 on 
    item offnet: Vswitch offnet is not active. Warning 11 on item badnet: 'badnet' 
    backing device does not exist. These problems will prevent HPVM guest myguest 
    from booting.
    
    AUTHORS
    The hpvmstart command was developed by HP.
    
    SEE ALSO
    On the VM Host:
    
    hpvm(5), hpvmclone(1M), hpvmcollect(1M), hpvmconsole(1M), hpvmcreate(1M), 
    hpvmdevmgmt(1M), hpvmdevtranslate(1M), hpvmhostrdev(1M), hpvminfo(1M), 
    hpvmmigrate(1M), hpvmmodify(1M), hpvmnet(1M), hpvmpubapi(3), hpvmremove(1M), 
    hpvmresources(5), hpvmsar(1M), hpvmstatus(1M), hpvmstop(1M), 
    hpvmupgrade(1M)p2vassist(1M)
    
    On the Integrity VM guest:
    
    hpvmcollect(1M), hpvminfo(1M), hpvmmgmt(1M), hpvmpubapi(3)
    

Log in to reply
 

© Lightnetics 2024