[AIX HP-UX Linux Solaris Windows]

ovf-env.xml file

Use the silent activation ovf-env.xml file to specify configuration parameters

The OVF specification recommends that an ISO image contain an ovf-env.xml file. The complete specification is located at the OVF 1.0 Specification website. This file is used during silent activation to configure your virtual machine. See the following example:

<?xml version="1.0" encoding="UTF-8"?>
<Environment xmlns="http://schemas.dmtf.org/ovf/environment/1"
 xmlns:ovf="http://schemas.dmtf.org/ovf/envelope/1"
 xmlns:ovfenv="http://schemas.dmtf.org/ovf/environment/1"
 xmlns:rasd="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_ResourceAllocationSettingData"
 xmlns:vssd="http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_VirtualSystemSettingData"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ovf:id="1/DMGR_1">

<PropertySection>
		<Property ovfenv:key="License.accept" ovfenv:value="yes"/>
		<Property ovfenv:key="ConfigLocale.language" ovfenv:value="en"/>
		<Property ovfenv:key="ConfigLocale.country" ovfenv:value="en"/>
		<Property ovfenv:key="ConfigLocale.encoding" ovfenv:value="UTF-8"/>
		<Property ovfenv:key="ConfigNET.bootproto" ovfenv:value="static"/>
		<Property ovfenv:key="ConfigNET.hostname" ovfenv:value="myvm"/>
		<Property ovfenv:key="ConfigNET.domain" ovfenv:value="sample.my.company "/>
		<Property ovfenv:key="ConfigNET.ipaddr" ovfenv:value="10.0.0.5"/>
		<Property ovfenv:key="ConfigNET.netmask" ovfenv:value="255.255.255.0"/>
		<Property ovfenv:key="ConfigNET.gateway" ovfenv:value=”10.0.0.1"/>
		<Property ovfenv:key="ConfigNET.pri_dns" ovfenv:value="10.0.0.100"/>
		<Property ovfenv:key="ConfigNET.sec_dns" ovfenv:value="10.0.0.101"/>
		<Property ovfenv:key="ConfigPWD_ROOT.username" ovfenv:value="root"/>
		<Property ovfenv:key="ConfigPWD_ROOT.password" ovfenv:value="mypassword"/>
		<Property ovfenv:key="ConfigPWD_USER.username" ovfenv:value="virtuser"/>
		<Property ovfenv:key="ConfigPWD_USER.password" ovfenv:value="mypassword"/>
		<Property ovfenv:key="ConfigWAS.type" ovfenv:value="dmgr"/>
		<Property ovfenv:key="ConfigWAS.colocateihs" ovfenv:value="false"/>
		<Property ovfenv:key="ConfigWAS.cell_name" ovfenv:value="HypervisorEditionCell"/>
		<Property ovfenv:key="ConfigWAS.node_name" ovfenv:value="HypervisorEditionNode"/>
		<Property ovfenv:key="ConfigWAS.autostart" ovfenv:value="true"/>
		<Property ovfenv:key="ConfigWAS.augment_list" ovfenv:value="none"/>
		<Property ovfenv:key="ConfigVNC.enabled" ovfenv:value="true"/>
		<Property ovfenv:key="ConfigVNC.username" ovfenv:value="virtuser"/>
		<Property ovfenv:key="ConfigVNC.password" ovfenv:value="mypass"/>
		<Property ovfenv:key="ConfigNTP.ntp.0" ovfenv:value="ntp1.mycompany.org"/>
		<Property ovfenv:key="ConfigNTP.ntp.1" ovfenv:value="ntp2.mycompany.org"/>
		<Property ovfenv:key="ConfigNTP.ntp.2" ovfenv:value="ntp2.mycompany.org"/>
		<Property ovfenv:key="ConfigNTP.ntp.3" ovfenv:value="ntp3.mycompany.org"/>
</PropertySection>
</Environment>
The following table contains the properties, their valid values, and a description:
Table 1. Properties, valid values, and description
Property Valid values Description
<Property ovfenv:key="License.accept" ovfenv:value="yes"/> yes | no Accepts the IBM® WebSphere® Application Server Hypervisor Edition license, the Novell SuSE license and the VMware tools license. The VM will not start unless this is set to yes.
<Property ovfenv:key="ConfigLocale.language" ovfenv:value="en"/> en | de | ja | ko | zh | fr | it | es | pt | cs | hu | pl | ru The locale the virtual machine starts in.
<Property ovfenv:key="ConfigLocale.country" ovfenv:value="US"/> US | DE | JP | KR | CN | TW | FR | IT | ES | BR | CZ | HU | PL | RU The country locale the virtual machine starts in.
<Property ovfenv:key="ConfigLocale.encoding" ovfenv:value="UTF-8"/> UTF-8 The machine encoding for the VM
<Property ovfenv:key="ConfigNET.bootproto" ovfenv:value="static"/> static | dhcp The networking boot protocol for the VM
<Property ovfenv:key="ConfigNET.hostname" ovfenv:value="myvm"/> any valid hostname The hostname for the virtual machine
<Property ovfenv:key="ConfigNET.domain" ovfenv:value="sample.my.company "/> any valid domain The networking domain; it matches the hostname
<Property ovfenv:key="ConfigNET.ipaddr" ovfenv:value="10.0.0.5"/> any valid IP address Not needed if using DHCP
<Property ovfenv:key="ConfigNET.netmask" ovfenv:value="255.255.255.0"/> any valid IP address netmask Not needed if using DHCP
<Property ovfenv:key="ConfigNET.gateway" ovfenv:value=”10.0.0.1"/> any valid IP address gateway Not needed if using DHCP
<Property ovfenv:key="ConfigNET.pri_dns" ovfenv:value="10.0.0.100"/> any valid DNS server (primary) Not needed if using DHCP
<Property ovfenv:key="ConfigNET.sec_dns" ovfenv:value="10.0.0.101"/> a valid DNS server (secondary) Not needed if using DHCP
<Property ovfenv:key="ConfigPWD_ROOT.username" ovfenv:value="root"/> root The root user name. Do not change.
<Property ovfenv:key="ConfigPWD_ROOT.password" ovfenv:value="mypassword"/> any valid password The root operating system password
<Property ovfenv:key="ConfigPWD_USER.username" ovfenv:value="virtuser"/> virtuser The non-root user defined for the operating system and WebSphere. Do not change.
<Property ovfenv:key="ConfigPWD_USER.password" ovfenv:value="mypassword"/> any valid password Password for virtuser, used by WebSphere and the operating system.
<Property ovfenv:key="ConfigWAS.type" ovfenv:value="dmgr"/> dmgr | default | custom | adminagent | jmgr The profile type to configure on this VM. The adminagent and jmgr options are not valid for version 6.1.0.x virtual images.
<Property ovfenv:key="ConfigWAS.colocateihs" ovfenv:value="false"/> true | false Whether you want IBM HTTP Server configured on this VM. Only valid on dmgr nodes.
<Property ovfenv:key="ConfigWAS.cell_name" ovfenv:value="HypervisorEditionCell"/> any valid cell name The cell name you configured for this VM. For custom profiles that are federated this value is thrown away.
<Property ovfenv:key="ConfigWAS.node_name" ovfenv:value="HypervisorEditionNode"/> any valid node name The node name you configured for this VM.
<Property ovfenv:key="ConfigWAS.autostart" ovfenv:value="true"/> true | false Specifies if the server is started automatically.
<Property ovfenv:key="ConfigWAS.augment_list" ovfenv:value="none"/> none, sca The feature packs to augment into the profile. Only valid on version 7.x virtual images.
<Property ovfenv:key="ConfigVNC.enabled" ovfenv:value="true"/> true | false Configure the virtual machine for VNC administration
<Property ovfenv:key="ConfigVNC.username" ovfenv:value="virtuser"/> virtuser Do not change
<Property ovfenv:key="ConfigVNC.password" ovfenv:value="mypass"/> any valid password The password for VNC access
<Property ovfenv:key="ConfigNTP.ntp.0" ovfenv:value="ntp1.mycompany.org"/> any valid NTP server A valid NTP server is needed to ensure correct time keeping on the virtual machine.
<Property ovfenv:key="ConfigWAS.dmgr_federate" ovfenv:value="true"/> true | false If dmgr_federate is set to true the following values are required. The values are used to federate the custom or default node into the targeted deployment manager.
<Property ovfenv:key="ConfigWAS.dmgr_host" ovfenv:value="hostname.ibm.com"/>
<Property ovfenv:key="ConfigWAS.dmgr_conntype" ovfenv:value="SOAP"/>
<Property ovfenv:key="ConfigWAS.dmgr_jmxport" ovfenv:value="8879"/>
<Property ovfenv:key="ConfigWAS.dmgr_user" ovfenv:value="virtuser"/>
<Property ovfenv:key="ConfigWAS.dmgr_pass" ovfenv:value="password"/>
<Property ovfenv:key="ConfigWAS.jmgr_federate" ovfenv:value="true"/> true | false If jmgr_federate is set to true the following values are required. The values are used to federate the custom or default node into the targeted job manager.
<Property ovfenv:key="ConfigWAS.jmgr_host" ovfenv:value="hostname.ibm.com"/>
<Property ovfenv:key="ConfigWAS.jmgr_conntype" ovfenv:value="SOAP"/>
<Property ovfenv:key="ConfigWAS.jmgr_user" ovfenv:value="virtuser"/>
<Property ovfenv:key="ConfigWAS.jmgr_pass" ovfenv:value="passord"/>



Related information
OVF 1.0 Specification
Installing IBM WebSphere Application Server Hypervisor Edition silently
Reference topic Reference topic    

Terms of Use | Feedback

Last updatedLast updated: Sep 20, 2011 1:27:29 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v800hyperv&product=was-nd-mp&topic=rins_virt_apfile
File name: rins_virt_apfile.html