User'S Guide To Deploying Vapps and Virtual Appliances: Vmware Studio 2.1
User'S Guide To Deploying Vapps and Virtual Appliances: Vmware Studio 2.1
User'S Guide To Deploying Vapps and Virtual Appliances: Vmware Studio 2.1
This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs.
EN-000345-00
You can find the most up-to-date technical documentation on the VMware Web site at: http://www.vmware.com/support/ The VMware Web site also provides the latest product updates. If you have comments about this documentation, submit your feedback to: docfeedback@vmware.com
Copyright 20082010 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.
VMware, Inc.
Contents
AboutThisBook
1 OverviewofAppliancesCreatedwithVMwareStudio 7
AboutvAppsandVirtualAppliances 7 ComponentsofVirtualAppliancesCreatedwithVMwareStudio 8
2 DeployingYourVirtualAppliance 9
SystemRequirements 9 SupportedWebBrowsers 9 DistributionFormats 9 DeployingaVirtualApplianceinVMwarevSphere DeployingaVirtualAppliancefromZIP 10 FirstStartoftheVirtualAppliance 11 ConfiguringStaticIPAddresses 11 ConfiguringDHCP 12 SettingtheTimeZone 12 VirtualAppliancesBasedonWindows 12
10
3 ManagingaVirtualAppliance 13
ExploringaVirtualAppliance 13 UsingtheCommandLine 13 ExploringvAppsinthevSphereClient 14 ShuttingDownorRebootingtheVirtualAppliance 14 SettingtheTimeZone 14 NetworkConfiguration 15 SettingaProxyServer 15 ChoosingBetweenDHCPandStaticNetworkAddresses 15 FirewallSecurity 16 Troubleshooting 16 VAMIConfigurationUtilities 16
4 UpdatingaVirtualAppliance 17
TypesofUpdates 17 UpdateTabStatusandSettings 17 CheckingVersionStatus 17 InstallingAvailableUpdates 18 SettingUpdatePolicies 18 SettingUpdateSource 18 UsingtheCommandLineforUpdates 18
5 ManagingVirtualApplianceswithvCenterServer 19
RequirementsforUpdateManager 19 VirtualApplianceBaselines 20 CreatingVirtualApplianceUpgradeBaselines 20 AttachingVirtualApplianceUpgradeBaselines 20 ScanningVirtualAppliances 21
VMware, Inc.
Appendix 25
VMwarePlatformProductsforOVFandOVA 25 CompatibilityforVirtualAppliancesandvApps 25
Index 27
VMware, Inc.
Revision History
Thisbookisrevisedwitheachreleaseoftheproductorwhennecessary.Arevisedversioncancontainminor ormajorchanges.Table 1summarizesthesignificantchangesineachversionofthisbook. Table 1. Revision History
Revision 20100713 20090831 20090629 20081216 20080905 Description MajorrevisionfortheVMwareStudio2.1release. FinalversionfortheVMwareStudio2.0release RetitledUsersGuidetoDeployingvAppsandVirtualAppliancesforStudio2.0Beta. Correctionsmadetofirstversion,butnonewmaterial. FirstversionoftheGuidetoDeployingVirtualAppliancesforVMwareStudio1.0.
Intended Audience
Thismanualisintendedforanyonewhowantstodeploy,manage,andupdatevAppsandvirtualappliances withthehelpofVMwareStudio.ItdiscusseshowtomanageandupdatevAppsandvirtualapplianceson VMwarevSphere.ForinformationaboutcreatingvAppsandvirtualapplianceswithVMwareStudio,seethe companionmanual,DevelopersGuidetoBuildingvAppsandVirtualAppliances.
VMware, Inc.
Document Feedback
VMwarewelcomesyoursuggestionsforimprovingourdocumentation.Sendyourfeedbackto docfeedback@vmware.com.
Support Offerings
TofindouthowVMwaresupportofferingscanhelpmeetyourbusinessneeds,goto http://www.vmware.com/support/services.
VMware, Inc.
Thischapterprovidesanoverviewofvirtualappliances,andincludesthefollowingtopics:
AboutvAppsandVirtualAppliancesonpage 7 ComponentsofVirtualAppliancesCreatedwithVMwareStudioonpage 8
VMware, Inc.
VirtualappliancescreatedwithVMwareStudiocontainthefollowingcomponents:
JeOSJustenoughOperatingSystem.VirtualappliancesbuiltwithVMwareStudiousestheminimal requiredpackages,ensuringthatvirtualapplianceshaveasmallfootprintandarerelativelysecure. VMwareToolsVMwareStudioinstallsVMwareToolsduringthebuildofvirtualappliancestoenhance communicationbetweenVMwarevirtualizationplatformsandthevirtualappliance. VAMITheinguestmanagementcomponentprovidesaWebconsoletomanagethevirtualappliance. VAMIallowsyoutochangenetworksettings,updatethevirtualappliance,andcontrolthestateofthe systembyshutdownandreboot,inadditiontoothermanagementservicesthatanISVadds.Allthe defaultmanagementservicesprovidedbyVAMIareimplementedasCommonInformationModel(CIM) ProvidersusingSmallFootprintCIMBroker(SFCB)asaCIMManager.CIMisastandardfrom DistributedManagementTaskForce(DMTF).FormoreinformationonCIMandotherDMTFstandards, seehttp://www.dmtf.org. ApplicationTheISVorhardwareappliancevendor(HAV)createstheapplication.Theapplication performstheintendedtaskforwhichtheapplianceiscreated.
Youcanmanagevirtualappliancesusingoneormoreofthefollowingmethods:
VMware, Inc.
Thischapterprovidesinformationabouthowtodeployavirtualappliance,andincludesthefollowingtopics:
System Requirements
VirtualappliancescreatedwithVMwareStudioaresupportedonthefollowingVMwareplatformproducts:
InternetExplorer7and8 MozillaFirefox3.x
Distribution Formats
Yourvirtualappliancemightbedistributedinoneormoreofthefollowingformats:
10
VMware, Inc.
3 4 5 6
Enteryesifthevaluesonthereviewscreenarecorrect. Ifthevaluesareincorrect,enternoandrepeattheprocedure.
VMware, Inc.
11
Configuring DHCP
IfyouconfiguredthevirtualappliancewithastaticIPaddress,youcanreconfigureittouseaDHCPserver. To configure DHCP from the welcome screen 1 2 3 Onthevirtualappliancewelcomescreen,selectConfigureNetworkandpressEnter. EnteryesaftertheUseaDHCPserverinsteadofastaticIPaddressprompt. Atthenextprompt,specifywhetherornotyouneedaproxyservertoreachtheInternet.Ifyouanswer yes,entertheIPaddressandportnumberofyourproxyserver.Forinformationabouttheproxyserver, ortosetproxyloginandpassword,seeNetworkConfigurationonpage 15. Areviewofthenetworksettingsappears. 4 Enteryesifthevaluesonthereviewscreenarecorrect. Ifthevaluesareincorrect,enternoandrepeattheprocedure.
(Thesestepsmayvary.)Thetimezoneissetandthewelcomescreenappearsagain.
12
VMware, Inc.
ThischapterdescribessoftwarediscoveryandnetworksettingsforyourvApporvirtualappliance,including thefollowingtopics:
VendorThenameofthecompanythatcreatedyourvirtualappliance. ApplianceNameThenameofyourappliance. ApplianceVersionTheversionnumberofyourappliance. HostnameThefullyqualifiedhostnameofyourappliance.IfastaticIPisconfiguredforthevirtual machine,thenyoucanspecifyahostname.IftheOVFvami.hostnamepropertyispresent,thehostname issetaccording.OtherwiseDNSservicemapstheIPaddressintoahostname(PTRrecord). OSNameThenameoftheoperatingsystemonwhichyourapplianceruns. OSVersionTheversionnumberoftheoperatingsystem. OVFEnvironmentIfdeployedinvSphere,showstheOVFpropertiesdefinedandconfiguredforthis virtualmachineorvApp.
Thefollowingcommandshowstheversioninformationforthevirtualappliance:
vamicli version --appliance
ThefollowingcommandshowstheversionofVMwareStudiousedtobuildthevirtualappliance:
vamicli version --studio
VMware, Inc.
13
Torestartthevirtualappliance,clickReboot. Toshutdownthevirtualappliance,clickShutdown.
14
VMware, Inc.
To set the time zone from the Web console 1 2 3 ClicktheSystemtabthenclicktheTimeZonepagebutton. OntheTimeZoneSettingspage,inthedropdownmenushowingtimezonesoftheworld,selectyours. ClicktheSaveSettingsbuttontomakeachange.
Network Configuration
TheNetworktabcontainssubtabsforthefollowingoperations:
VMware, Inc.
15
Firewall Security
YoumightneedtorequestthatyourITdepartmentchangefirewallsettingsifyouhavereasontoaccessthe WebconsoleofyourvApporvirtualappliancethroughthefirewall. ThefollowingportsusedbyyourvApporvirtualapplianceshouldbeexemptedfromthefirewall:
Troubleshooting
Ifsomethinggoeswrongwithyourvirtualappliance,supportpersonnelmightaskforyourassistancein diagnosingtheproblem.VMwareStudioprovidesthevamisupportscript,whichassembleslogfilesintoa tarballfortroubleshooting.Thescriptisat/opt/vmware/bin/vamisupportonyourvirtualappliance. Whenreportingaproblem,youcanrunthevamisupportscript,whichtellsyouwhereitiswritingoutput. Thenscp(securecopy)thetarballtoacomputerwithemailservice,andsendittosupport.
yes
no
Set Timezone
16
VMware, Inc.
Thischapterprovidesinformationaboutupdatingavirtualappliance,andincludesthefollowingtopics:
Types of Updates
Adeployedvirtualappliancecanbeupdatedwithpackagespublishedbyitsdeveloper.Updatescanbedone overtheexternalWeb,onyourlocalareanetwork,orfromCDROM. Toconservenetworkbandwidth,virtualapplianceupdatesareappliedonlytopackagesthathavechanged. Updatesmayapplytotheoperatingsystem,applicationswithinthevirtualappliance,VMwareTools,orthe VMwareApplianceManagementInfrastructure(VAMI). Ifthevendorhasdigitallysignedavirtualappliance,theSSLsignatureisverifiedbeforeupdatecanproceed.
StatusProvidesinformationaboutthevirtualappliancevendor,name,andversion. SettingsShowsthesettingofpoliciesforperiodicallycheckingandinstallingupdates.
VMware, Inc.
17
IfyouselecteitherAutomaticcheckforupdatesorAutomaticcheckandinstallupdates,youcanconfigure thescheduling.Bydefault,thecheckoccursdailyat03:00localtime,asdeterminedbyyourtimezonesetting. To change the frequency or time of update checking 1 2 3 ClickoneoftheAutomaticcheckbuttons. Specifythefrequency(dailyorweekly),orselectthehouratwhichtocheck. ClickSaveSettings.
ClickSaveSettings.
IfyouleaveUseDefaultRepositoryselected(thedefault),theupdateagentusuallychecksapublicURLon theInternet,sobesuretosettheproxyserverifrequired.
Usethefollowingcommandtodownloadandinstallthelatestupdatesforthevirtualappliance:
vamicli update --install latest
18
VMware, Inc.
Thischaptercontainsthefollowingtopics:
VMware, Inc.
19
LatestUpgradesthevirtualappliancetothelatestversion. DontUpgradeDoesnotupgradethevirtualappliance.
6 7
ClickNext.
10 ReviewtheReadytoCompletepageandclickFinish. ThevirtualapplianceupgradebaselineisdisplayedintheBaselinespaneoftheBaselinesandGroupstab.
Althoughyoucanattachbaselinestoindividualobjects,itismoreefficienttoattachthemtocontainerobjects, suchasfolders,vApps,anddatacenters.Attachingabaselinetoacontainerobjecttransitivelyattachesthe baselinetoallvirtualappliancesinthecontainer. Toattachavirtualapplianceupgradebaseline: 1 2 3 4 5 6 ConnectthevSphereClienttoavCenterServersystemwithwhichUpdateManagerisregistered,and selectHome>Inventory>VMsandTemplates. Selecttheobjectcontainingthevirtualappliances,andclicktheUpdateManagertab. ClickAttachintheupperrightcorner. IntheAttachBaselineorGroupwindow,selectoneormorebaselinestoattachtotheobject. (Optional)ClicktheCreateBaselinelinktocreateabaselinegrouporabaselineandfinishthewizard. ClickAttach.
ThebaselinesandbaselinegroupsthatyouselectedtoattacharedisplayedintheAttachedBaselineGroups andAttachedBaselinespanesoftheUpdateManagertab.
Scheduling a Scan
Youcanschedulescansforallvirtualappliancesinafolder.Toschedulescansforvirtualappliances: 1 2 3 4 5 6 7 8 9 ConnectthevSphereClienttothevCenterServersystemwhereyouimportedthevirtualappliance. ClickScheduledTasksontheHomepage. ClickNewinthetoolbartoopentheScheduleTaskdialogbox. Fromthedropdownmenu,selectScanforUpdatesandclickOK. Choosetoscheduleascanforvirtualmachinesandvirtualappliances,andclickNext. Intheinventorytree,selectthevirtualappliancestobescanned,andclickNext. Choosetoscanforvirtualapplianceupgrades. Enterthetasknameandthetaskdescription,scheduleatimetorunthetask,andclickNext. (Optional)SpecifyoneormoreemailaddressestoreceivetheresultsandclickNext.Youmustconfigure mailsettingsforthevCenterServersystemtoenablethisoption.
10 Reviewthesummaryinformationforthetasktobecompleted,andclickFinish.
VMware, Inc. 21
Ifauserlackspermissionstoviewavirtualappliance,theresultsofthosescansarenotdisplayed. Compliancewithbaselinesisassessedatthetimeofviewing.Toensurethatallinformationiscurrent,a briefpausemightoccurwhileinformationisgatheredaboutavirtualappliancescompliance. Onlyinformationaboutcompliancewithrelevantbaselinesisprovided.Forexample,ifabaselineisnot attachedtothecontainerinquestion,complianceisnotassessed. Compliancestatusisdisplayedbasedonpermissions.Userswithpermissiontoviewacontainer,butnot allofthecontainerscontents,canseetheaggregatecomplianceofallentitiesunderthatcontainer. However,theindividualcountsforcompliant,noncompliant,andunknownentitiesappearonlyasuser permissionsallow.Toviewthecompliancestatus,usersalsomusthavepermissiontoviewthebaseline orsoftwareupdatecompliancestatusforanobjectintheinventory.
Whenyouselectacontainerobject,youviewtheoverallcompliancestatusoftheattachedbaselines,aswell asstatusforalltheindividualcompliances.Ifyouselectanindividualbaselineattachedtothecontainerobject, youseethecompliancestatusofthebaseline. Ifyouselectanindividualvirtualappliance,youseetheoverallcompliancestatusoftheselectedappliance againstallattachedbaselinesandthenumberofupgrades.Ifyoufurtherselectanindividualbaselineattached tothisobject,youseethenumberofupgradesgroupedbythecompliancestatusforthatbaseline. Toviewscanresultsforvirtualappliances: 1 2 3 4 ConnectthevSphereClienttothevCenterServersystemwhereyouimportedthevirtualappliance. ClickInventoryandclickVMsandTemplates. Clicktheobjectforwhichyouwanttoviewthescanresults. ClicktheUpdateManagertab.
Theresultsforscanscompletedonvirtualappliancesinthatcontainerappearontheright.
22
VMware, Inc.
VMware, Inc.
23
Toremediateavirtualappliance: 1 2 3 ConnectthevSphereClienttothevCenterServersystemwhereyouimportedthevirtualappliances. OntheHomepageselectVMsandTemplatesandclicktheUpdateManagertab. RightclickanobjectfromtheinventoryandselectRemediate. Allvirtualappliancesundertheselectedobjectarealsoremediated. 4 5 6 7 8 OntheRemediationSelectionpageoftheRemediatewizard,selectthebaselinestoapply. SelectthevirtualappliancesthatyouwanttoremediateandclickNext. OntheSchedulepage,enteraname,andoptionally,adescriptionforthetask. SelectImmediatelytobegintheremediationprocessrightafteryoucompletethewizard,orenterspecific timesforpoweredon,poweredoff,orsuspendedvirtualappliances. (Optional)SpecifytherollbackoptionsandclickNext. a OntheRollbackOptionspageoftheRemediatewizard,selectSnapshotthevirtualmachinesbefore remediationtoenablerollback. Asnapshotofthevirtualmachineorvirtualapplianceistakenbeforeremediation.Ifthevirtual applianceneedstorollback,youcanreverttothissnapshot. b c d 9 Specifywhenthesnapshotshouldbedeleted,orselectDontdeletesnapshots. Enteranameandoptionallyadescriptionforthesnapshot. (Optional)SelectthecheckboxSnapshotthememoryforthevirtualmachine.
ReviewtheReadytoCompletepage,andclickFinish.
24
VMware, Inc.
Appendix
Thisappendixcontainsthefollowingsections:
VMware, Inc.
25
26
VMware, Inc.
Index
A
appliance vendor, ISV or HAV 8
J
JeOS, just enough operating system 8
B
browser support in VMware Studio 9
N
netmask for static IP address 11, 15 Network tab Address > Alternate DNS Server 15 Address > Gateway 15 Address > Hostname 15 Address > IP Address 15 Address > Netmask 15 Address > Preferred DNS Server 15 DHCP default, not static IP 15 Proxy > Proxy Port 15 Proxy > Proxy Server 15 Proxy > Proxy User 15 Status 15
C
CIM standard and the DMTF 8 command-line interface, vamicli 13, 18 compatible platforms for a vApp 26 compatible platforms for a virtual appliance 25
D
definition of application in a virtual appliance 8 VAMI 8 vApp 7 virtual appliance 7 VMware Studio 7 DHCP configuration of IP address and DNS 12 distribution format OVA 9, 10 OVF 0.9 or 1.0 9, 10 ZIP 9, 10 DNS servers without DHCP 11, 15 dynamic IP address and DHCP 12
O
Open Virtualization Format (OVF) 7 OVA distribution format 9, 10 OVF 0.9 or 1.0 distribution format 9, 10 OVF versions and VMware platform products 25
P
powering on a virtual appliance 11 proxy server for external network access 15
E
ESX/ESXi versions supported by VMware Studio 9
R
Reboot button in System tab 14
F
firewall security exempted ports 16 incoming TCP port 5480 16 incoming TCP ports 5488 and 5489 16 proxy server 15 flow of configuration for VAMI 16
S
security firewall 16 login password 13 self-signed HTTP certificate 11 SSL digital signature 17 Shutdown button in System tab 14 SSL digital signature 17 static IP address and netmask 11 supported VMware platform products 9, 25 supported Web browsers 9 System tab Appliance Name 13 Appliance Version 13 Hostname 13 OS Name 13
27
G
gateway (router) for static IP address 11, 15 Greenwich mean time (GMT) See UTC
H
host name for static IP address 11, 15
I
IP Pool and OVF networking properties 10, 11
VMware, Inc.
OS Version 13 OVF Environment 13 Reboot button 14 Shutdown button 14 Time Zone page 15 Vendor 13
W
Web browsers supported 9 Web console for VMware Studio 8
Z
ZIP distribution format 9, 10
T
technical support resources 6 Time Zone page in System tab 15 time zone, setting or changing 12, 14
U
Update tab Actions > Check Updates 18 Actions > Install Updates 18 Settings > Automatic check and install updates 18 Settings > Automatic check for updates 18 Settings > No automatic updates 18 Status > Appliance Name 17 Status > Appliance Version 17 Status > Available Updates 17 Status > Last Check 17 Status > Last Install 17 Status > Vendor 17 updates from local repository URL 18 updates from mounted CDROM 18 Use Default Repository update default 18 UTC, universal coordinated time 11, 12, 14, 17
V
VAMI, virtual appliance management infrastructure 7, 8, 16 vami.timezone OVF property 12, 14 vamicli command 13, 18 vamisupport script 16 vApp, definition 7 vApps in the vSphere Client, pictured 14 vCenter Server (formerly VirtualCenter) 8, 10, 17, 1924 VI Client, virtual appliance import 10 virtual appliance power-on 11 virtual appliance, definition 7 VMware platform products supported 9 VMware Tools 8 VMware vCenter Update Manager 7, 12, 14, 16, 19 baselines for virtual appliance updates 20 remediating a virtual appliance 23 scanning a virtual appliance 21 scheduling a virtual appliance scan 21 viewing a virtual appliance scan 22 vSphere Client, deploy OVF template 10
28
VMware, Inc.