UserGuide

CitrixStorageLinkUserGuide
ThisdocumentdescribeshowtouseCitrixStorageLink Version1.0.5MP1
Author:CitrixEngineeringandProgramManagement DateCreated:August2009


Citrix StorageLink User Guide Copyright 2009 Citrix All Rights Reserved. Version: 1.0.5-MP1

Citrix, Inc. 851 West Cypress Creek Road Fort Lauderdale, FL 33309 United States of America
Citrix Inc.

Disclaimers
This document is furnished "AS IS." Citrix,Inc. disclaims all warranties regarding the contents of this document, including, but not limited to, implied warranties of merchantability and fitness for any particular purpose. This document may contain technical or other inaccuracies or typographical errors. Citrix,Inc. reserves the right to revise the information in this document at any time without notice. This document and the software described in this document constitute confidential information of Citrix,Inc. and its licensors, and are furnished under a license from Citrix,Inc. This document and the software may be used and copied only as permitted by such license.

TheCitrixWebsitealsoprovidesthelatestproductupdates. Ifyouhavecommentsaboutthisdocumentation,submityourfeedbackto: #CVSM_support@citrix.com Trademarks

Citrix, Inc., the Citrix logo, Citrix StorageLink, are trademarks of Citrix, Inc. in the United States and other countries. All other products or services mentioned in this document are trademarks or registered trademarks of their respective companies. This product includes software developed by Apache: http://www.apache.org/licenses/LICENSE-2.0.html SSL: http://www.openssl.org/source/license.html Pegasus: http://pegasus.codeplex.com/license ICU: http://source.icu-project.org/repos/icu/icu/trunk/license.html

Tableofcontents
Tableofcontents...................................................................................... 3 IntendedAudience.................................................................................... 5 SelfServiceTechnicalSupport................................................................... 5
StandardProductSupport..............................................................................5

Documentfeedback.................................................................................. 5 IntroductiontoCitrixStorageLink............................................................. 5 ComponentsofStorageLink...................................................................... 6 Featureoverview...................................................................................... 6 SystemRequirements............................................................................... 7

StorageLinkGateway.....................................................................................7 StorageLinkManager.....................................................................................7 Softwareprerequisites...................................................................................7

TheStorageLinkenvironment................................................................... 8
Hypervisorhosts............................................................................................9 Storageinfrastructure..................................................................................10

GettingstartedwithStorageLinkManager.............................................11
TheStorageLinkManagerinterface..............................................................11 Addstorageadaptercredentials..................................................................13 Addahypervisorhost..................................................................................15 CreatingaStorageRepository......................................................................15 AllocateStorage...........................................................................................18 CreateaStorageProfile...............................................................................19 CreateaVirtualMachineTemplate..............................................................20 PreparetheVMtemplate ............................................................................21 . CreateVMsfromtemplate...........................................................................23

Interoperablevirtualmachines...............................................................25 StorageLinkcommandlineinterface.......................................................25
Basiccslsyntax.............................................................................................26 Specialcharactersandsyntax.......................................................................26 Interactivemode..........................................................................................27 XMLoutputmode........................................................................................27 Verboseoutputmode..................................................................................27 CLIcookbook................................................................................................27

PowerShellinterface...............................................................................38

MSCSsupportforStorageLinkandSQLite...............................................39 Troubleshooting......................................................................................39

IntendedAudience
Theguideisintendedforexperiencedvirtualmachineadministrators,storage administrators,andtestersofsoftwareapplications.Thisdocumentassumesthe readerisfamiliarwiththefollowingtopics: Ifyouhavecommentsaboutthisdocumentation,submityourfeedbackto: #CVSM_support@citrix.com

SelfServiceTechnicalSupport
UsethefollowingCitrixlinksforselfhelpresourcesandtechnicalsupport information:

StandardProductSupport
Citrixrecognizesthechallengesthatarisewhenimplementingandmaintaininga newenterprisesoftwaresolutionintoyourorganization.Toensurethata seamlessandsuccessfultransitionisachieved,theCitrixTechnicalSupportTeam iscommittedtoprovideworldclasscustomersupportinaprofessionaland dedicatedmanner.TheCitrixTechnicalSupportDepartmentisopenfrom9amto 6pmEST(excludingCanadianstatutoryholidays).EmailSupportisthepreferred methodofcommunication.Eachemailreceivedbyoursupportteamistracked internallytoclosureanduserscanexpectadirectresponsewithin4business hours.Pleasedirectallsupportrequeststo#CVSM_support@citrix.com.

Documentfeedback
#CVSM_support@citrix.com

IntroductiontoCitrixStorageLink
CitrixStorageLinkispartoftheCitrixEssentialsproductoffering.CitrixEssentialsis enterpriseclassvirtualinfrastructurethatenhancesthescalabilityandagilityof CitrixXenServerandMicrosoftHyperVandVirtualMachineManagerwith simplifiedstoragesetupandoperation,powerfulVMlifecyclemanagement,and dynamicserverprovisioning.CitrixStorageLinkallowsyouto moveapplicationsintoproductionfasterwithautomatedlab development,testanddeploymenttools increasebusinessagilityandspeednewserversintoproductionquickly withbuiltinVMcloningandsnapshotsupport dynamicallyprovisionworkloadstobothvirtualandphysicalserversfrom asinglemasterVHDimage

 CitrixEssentialsenablesITProfessionalstoacceleratevirtualizationprojectsusing XenServerand/orHyperVquickly,withlesseffort,andscaleasbusinessneeds grow.

ComponentsofStorageLink
ThecoreofCitrixStorageLinkistheStorageLinkGateway,whichrunsona Windows2003/2008server(physicalorvirtualmachine)andservesasaplatform formanagingyourstorageandvirtualmachines. Therearethreewaystomanageandusetherichfeaturesetprovidedby StorageLinkGateway: theStorageLinkManager,aMMCbasedgraphicaluserinterface theStorageLinkCLI,acommandlineinterfacethatcanbeusedina WindowsCommandPrompt theStorageLinkPowerShellpluginforWindowsPowerShell,thenew commandlineshellandtaskbasedscriptingtechnologyfromMicrosoft

Allcomponentscanbeinstalledonthesamesystem,oronseparatephysicalor virtualmachinesrunningWindows2003/2008orVista. ThisguideisanoverviewforusingCitrixStorageLinkManager.TheCitrix StorageLinkPowerShellGuidedescribesthePowerShellplugin.

Featureoverview
CitrixStorageLinkhasanumberofkeyfeaturesthathelpsimplifythelifecycle managementofapplicationsandvirtualmachinesinyourvirtualized infrastructure.Thesekeyfeaturesinclude: RapidVMcreation(UI).StorageLinkallowsyoutoformgoldenimages (virtualmachinetemplates)fromstoragevolumes(LUNs)inyourstorage arraysalongwithdataLUNstoenablerapidVMcreationofcomplex serversbyleveragingthecloningandsnapshotcapabilitiesofthe underlyingstoragearrayhardware. Improvedstorageutilization.Thisallowsadministratorstoeasilyadd capacityandimproveutilizationoftheirstoragehardwareinvestmentby leveragingthinprovisioningcapabilitiesinherentinmostmodernstorage arrays. LowerTCO.StorageLinkautomatestheconfigurationandprovisioningof VMstorage.Usingtemplates,theprovisionedstorageismatchedtothe VMstorageresourcesrequirements.StorageLinkreducesmanualerror pronetasksandensurestheVMhasthenecessarystorageitneeds.

StorageLinkprovidestheuserwithagraphicaluserinterface,acommandline interfaceandWindowsPowerShellsupport. StorageLinkgraphicallydisplaysstorageassets,virtualizationhosts,hostHBAs, andfabricinformation.

SystemRequirements
StorageLinkGateway
TheStorageLinkGatewaycanbeinstalledonaphysicalorvirtualmachine.
Note: If you are using the Windows firewall, your firewall will be disabled automatically. If you are using a 3rd part party firewall, you must manually create a firewall rule to open port 21605, or disable your firewall all together. Another alternative is to run both the Citrix StorageLink Manager and the Citrix StorageLink service on the same machine.

Operatingsystem RAM Diskspace

MicrosoftWindows2008(recommended),2003,orVista 1GBormore minimumof100MBforGatewayinstallation

StorageLinkManager
StorageLinkManagercanbeinstalledonaphysicalorvirtualmachine. Operatingsystem RAM Diskspace MicrosoftWindows2008(recommended),2003,orVista 1GBormore minimumof100MB

Softwareprerequisites
Prerequisite MicrosoftManagement Console3.0 Description (requiredforStorageLinkManager) http://www.microsoft.com/downloads/details.aspx ?FamilyID=61fc1c6606f2463c82a2 cf20902ffae0&displaylang=en

 SQLSQLiteorMicrosoft SQLServer TheStorageLinkGatewaydeployswithasimple embeddedSQLitedatabase,butthatcanbe swappedoutforpreinstalledMicrosoftSQLServer ifyousochoose.Thereisascriptcalled csl_db_config.cmdtohelpyouconfigurethe StorageLinkGatewaydatabase.Thesupported databasesareembeddedSQLite,MicrosoftSQL Server2008,andMicrosoftSQLServer2005.For MicrosoftSQLServer,onlyWindowsAuthentication modeissupported. ForsettinguptheStorageLinkGatewaywith MicrosoftSQLServer,thescriptsyntaxis:
csl_db_config mssql [Database Server Name] [Database Instance Name] [Database Name]

AlsopleaseremembertoattachtheStorageLink GatewayMicrosoftSQLdatabasefiles (csl_db.mdfandcsl_db_1.ldf)toyour MicrosoftSQLServerdatabaseinstance.The StorageLinkGatewayMicrosoftSQLdatabasefiles areinthe<% StorageLink Gateway Install Directory %\database>directory,whichby defaultisC:\Program Files (x86)\Citrix\StorageLink\database ForsettingupStorageLinkGatewaywithembedded SQLite,thescriptsyntaxis:
csl_db_config.cmd sqlite [StorageLink Gateway Install Directory]

ThedefaultStorageLinkGatewayinstallation directoryis
c:\Program Files (x86)\Citrix\StorageLink

MicrosoftWindows PowerShell

requiredtousetheStorageLinkPowerShellplugin OnWindows2008theWindowsPowerShellfeature needstobeadded.Thiscanbedonefromthe WindowsServerManagerunderFeatures.Previous toWindows2008,WindowsPowerShellneedsto bedownloadedfromMicrosoftandinstalled.

TheStorageLinkenvironment
WhenyoufirstinstallStorageLink,theservicecontainsnoinformationaboutthe hypervisorhostsorthestoragesystems(storagearrays)inyourenvironment.You firstneedoneormoreserverstouseashostsforHyperVand/orXenServer virtualmachines,andoneormoreofthesupportedstoragesystems.

Hypervisorhosts
HyperVhosts
ToactasahostforHyperVvirtualmachines,inadditiontothesystems requirementsforWindowsServer2008,theservermustbea64bitenvironment andsupporthardwareassistedvirtualization(IntelVTorAMDV)technology. Oninstallation,aWindows2008ServerisnotconfiguredtoactasaHyperVhost. YoumustenablethiscapabilityusingtheServerManager.
IMPORTANT: StorageLink supports the RTM version of Microsoft Hyper-V only. Pre-release versions of Hyper-V are not supported. You can check the version by opening Hyper-V Manager on the host console, and selecting About from the Help menu. Windows 2008 R2 Beta is also not supported. A future release of StorageLink will have full support for Windows 2008 R2.

ToenableaWindows2008ServertoactasaHyperVhost 1. SelectHyperVfromthelistofrolesthewizardpresents. 2. Reboottheserver.

IMPORTANT: After the reboot, make sure that you open Hyper-V Manager and accept the EULA that it will present to you on first launch.

Next,makesurethatthereisaphysicalNICforHyperVManagertouseto connecttothevirtualNICsitcreatesforvirtualmachines.Otherwise,avirtual machineVMcreatedbyStorageLinkwillnothaveanetworkadapter. TosetupanexternalNICforHyperVvirtualmachines 1. OpenHyperVManager. 2. SelectVirtualNetworkManagerfromtheActionspane. 3. SelectExternal,thenclicktheAddbutton. 4. FromthelistofavailableNICs,selectthecardforthisnewvirtual network. 5. ClickOK. Finally,ifthestoragesystemyouareworkingwithusestheiSCSIprotocol,make surethatthehostsiSCSIinitiatorisenabled.
Note: Hardware iSCSI initiators are not supported in the current release of StorageLink.

 ToenabletheiSCSIinitiator 1. FromtheStartmenu,selectAdministrativeTools>iSCSIinitiator,and confirmthatyoudowanttoenabletheiSCSIinitiatorservicewhenso prompted.

XenServerhosts
ToactasahostforXenServervirtualmachines,theservermustbea64bit environment.ForrunningWindowsvirtualmachines,itmustalsosupport hardwareassistedvirtualization(IntelVTorAMDV)technology.

Storageinfrastructure
Thefollowingtablesummarizestheavailablestoragesystemadapters. StorageAdapter EMCCLARiiON(SMIS) ConsiderationsforusewithStorageLink SupportsEMCCLARiiONCX3andCX4series storagesystems Note:ForsnapshotsmadeofXenServer5.5 virtualmachines,theXenCenteroperations NewVMfromsnapshot,Createtemplate fromsnapshot,andExportsnapshotas template(andtheircommandline equivalents)operateslowlyasthehardware doesnotsupportcreationofhardwareclones fromsnapshots. HPEnterpriseVirtualArray(EVA) (SMIS) SupportsEVA4100/4000/4400,6000/6100, 8000/8100series TheHPEnterpriseVirtualArraycomeswith CommandViewEVAmanagementsoftware. Whenthemanagementsoftwareisinstalled, thereisanoptionforinstallingtheEVASMIS provider.Thisprovidermustbeinstalled. StorageLinkwastestedforusewithHP StorageWorksCommandViewEVAversion 8.0. Note:ForsnapshotsmadeofXenServer5.5 virtualmachines,theXenCenteroperations NewVMfromsnapshot,Createtemplate fromsnapshot,andExportsnapshotas template(andtheircommandline equivalents)operateslowlyasthehardware doesnotsupportcreationofhardwareclones fromsnapshots.

10

 StorageAdapter HPModularSmartArray(MSA) 2000series ConsiderationsforusewithStorageLink SupportsallHPMSA2000seriesstorage systems ActivePerlmustbeinstalledonthehost wheretheStorageLinkServicewasinstalled. ThisisafreedownloadfromActiveState.com: http://www.activestate.com/downloads/ Note:ForsnapshotsmadeofXenServer5.5 virtualmachines,theXenCenteroperations NewVMfromsnapshot,Createtemplate fromsnapshot,andExportsnapshotas template(andtheircommandline equivalents)operateslowlyasthehardware doesnotsupportcreationofhardwareclones fromsnapshots. HPLeftHandP4000Series (SAN/iQ) SupportsHPLeftHandP4000seriesstorage systems. HPCLiQmustbeinstalledonthehostwhere StorageLinkServiceisinstalled.Additionally, theiSCSIservicemustbestartedonthehost whereCLiQisinstalled.TheStorageLink servicedoesnotutilizethislocallyrunning iSCSIinitiator,butitisrequiredfortheproper functioningofCLIQ.Pleasecontactyourlocal HPrepresentativefordownloadinformation. SupportsNetAppFAS/S/Vseries,IBMN series,andIBMNGatewayseriesstorage systems Noadditionalsoftwareorconfigurationis required.Yourstoragesystemshouldhave ONTAPI1.6ornewerfirmwareinstalled. SupportsallmodelsofBrocadeFibreChannel switches

NetApp/IBMNSeriesStorage Adapter

UniversalSMISFabrics

GettingstartedwithStorageLink Manager
Onceyouhaveyourhypervisorhostsandstoragesystemsconfiguredforuse,you canbegintouseStorageLink. Thefollowingsectionsillustratetheprocess.

TheStorageLinkManagerinterface
TolaunchStorageLinkManager,selectCitrixStorageLinkManagerfromtheStart menu.

11

 WhenStorageLinkManagerlaunches,itpromptsyoutoconnecttothe StorageLinkGateway:

YoucantesttheconnectionbyclickingtheTestConnectionbutton.Ifyouhave connectivitytotheGateway,thedialogboxwillindicatethiswithamessagethat sayspassedtotherightoftheTestConnectionbutton. Inthisexample,theStorageLinkserviceisinstalledonthesameserverasthe StorageLinkManager,solocalhostcanbeusedinsteadofthespecificmachine nameorIPaddress. AfteryouhaveconnectedtotheGateway,theStorageLinkManagerinterface lookslikethefigurebelow.Ithasthreedistinctsections:

Thelefthandnavigationpaneallowsyoutonavigatethroughthevarious workingareasavailabletoyouinStorageLinkbyselectingtheparticular areainthelowerpartofthepanel.Onceselected,theworkingareawill displayinthetreeviewaboveasaparentnode,whichcanbeexpanded toviewanyavailablechildnodes.Selectingaworkingareasetsthestate

12

 oftheothertwopartsoftheinterface.TheworkingareasinStorageLink areHypervisorHosts,VirtualMachines,StorageSystems,Templates,Jobs, andAdministration. Thecentercontentpanehas2tabs: theHometabhasaseriesoflinksarrangedinsequencetohelpyouget startedwhenyoubegintouseStorageLink.Theselinkstriggeradialog boxorwizardappropriatetothetask.TheHometabcontainsthesame contentregardlessofworkingarea. TheGeneraltabdisplaysspecificdetailaboutthecurrentlyselectednode oftheleftnavigationpane. Therighthandactionpaneisalsodividedintoanupperandlowersection. Theuppersectionhasalistoftasksthatcanbeperformedatanytime; containsthesamecontentregardlessofworkingarea. Theactionsdisplayedinthelowerpartofthepanelcorrespondtoactions thatcanbeperformedinthecurrentworkingareaonthecurrently selectedobjectnodeinthenavigationpane.Forexample,inthefigure above,theHypervisorHostsworkingareaisselected;therefore,the actionsinthelowerpartofthepaneareactionsthatapplytothe hypervisorhostsasagroup.Ifaspecifichypervisorhostwasselected,the actionsthatapplytoaspecifichypervisorhostwouldappear.

NotethatthereisusuallymorethanonewaytoinitiateanactioninStorageLink Manager.YoucanclickanactionintheActionspane;youcanselectanaction fromtheActionsmenu;oryoucanrightclickonanodeintheNavigationpane andchoosefromthecontextmenuofactionsthatappears. Also,notethatsomesystemobjectscanappearinmorethanoneworkingarea. Forexample,intheHypervisorHostsworkingarea,aspecifichypervisorhostisan expandablenodethatincludesvirtualmachinesasoneofitssubnodes.Ifyou selectaspecificvirtualmachinenode,thecenterandrightpanesarethesameas youwouldseehadyouoriginallybeenintheVirtualMachinesworkingareaand selectedaspecificvirtualmachine. ThefollowingsectionsillustratetheprocessofusingStorageLink,upthroughthe creationofavirtualmachine.Thesamesequenceofstepsisofferedinteractively intheHometabofthecenterpane. Tofollowthesesteps,youwillneedaWindowsVistainstallationISOavailableto thehypervisorhost.

Addstorageadaptercredentials
Youaddstoragesystemsbyprovidingmanagementcredentialstotheappropriate StorageAdapter.AStorageAdapterislikeadriverforaspecificvendor/modelof storagesystem.ThereisalsoavendorindependentStorageAdaptercalledthe UniversalSMISStorageAdapterwhichisusedwithSMIScomplianthardwarelike theHPEVA. Toaddastoragesystem 1. ClickStorageInfrastructureinthelowerhalfoftheleftnavigationpaneto displaytheStorageInfrastructureworkarea,thenAddStorageAdapter CredentialsfromthelowerhalfoftheActionspane.Thefollowingdialog boxappears:

13

Note: Usage of non-ASCII strings is not supported in this release of StorageLink Manager Storage volumes and storage repositories names must be only alphanumeric ASCII strings, as they are passed to the hardware, and the hardware vendors do not support non-alphanumeric ASCII strings. Non-ASCII strings in description fields is currently not supported. Support for Unicode strings for the description field is planned for future release.

2. Inthedialogboxthatappears,selecttheStorageadapterfromthepull downlist,provideaName,theCIMOMnamespaceandCIMOMIPaddress (forSIMSScompliantstoragesystems),thePortnumber,theUsername, andPassword;repeatthepasswordintheConfirmpasswordfield;then clickOK.

Note: Some fields become grayed out depending on the storage adapter type selected.

Yourstoragesystemdisplaysinthelefthandpanelafterdiscoveryhas completed.PleaseseetheJobviewfordetailedprogressofthediscovery ofyourstoragesystemsandfabrics. IfyouareusingBrocadeswitchesinyourenvironment,andyouhavesetupall yourphysicalcabling,StorageLinkprovidesautomaticfabriczoning.Automatic fabriczoningisenabledonlyifyougivetheservicecredentialsforaccessinga BrocadeSMISCIMOMconfiguredwithyourfabric.IfyoudontsetupaBrocade SMIMCIMOM,theservicewillskipoverzoningoperations.

14

Addahypervisorhost
InadditiontoaddingastoragesystemtoStorageLinksstorageinfrastructure,you needtoaddyourhypervisorhosts.
Important: Before you can add the a Hyper-V host to the Gateway, you must have the Hyper-V role enabled, and have opened Hyper-V Manager to accept the end user license agreement (EULA).

Toaddahypervisorhost 1. ClickonAddHypervisorHostfromthetophalfoftherighthandaction pane.

2. Fillinyourcredentials.BesuretoaddthelocalAdministratorpassword forthehostratherthantheDomainAdministratorpassword. 3. ClickOK. Onceyouhaveaddedyourhypervisorhost,itwillshowupinthetreecontrolin theleftpane,whenyouareintheHypervisorHostsworkarea. ClickingRefreshintherighthandpanelwillensurethatyouaregettingthelatest contentintheviewsintheStorageLinkManager.

CreatingaStorageRepository
Astoragerepositoryisatemplatewithadefinedsetofcapabilitiesforcreating storagevolumesfromyourstoragesystem.Thestoragerepositoryisalsoa containerthatkeepstrackofallthestoragethatyouhaveallocatedusingthe repository.Also,whennewvirtualmachinesarecreatedusingvirtualmachine templateswhichrefertostoragevolumescontainedintherepository,the snapshotsandclonescreatedthroughtheuseofavirtualmachinetemplateare depositedbackintotherepositorywheretheoriginal/sourcestoragevolumes reside.Theexceptioniswhenthenewvirtualmachineisdeployedintoadifferent XenServerresourcepool,asinsuchcasesthenewlycreatedstoragevolumeswill beplacedintoastoragerepositoryinthatXenServerresourcepool.Ifnostorage

15

 repositoryexistsinthetargetXenServerresourcepoolwhichissuitableforthe newstoragevolumes,onewillbecreatedforyouautomatically.

Youcancreatemultiplestoragerepositoriesreferringtothesamestoragepoolin thesamestoragesystem,butagivenstoragevolumecanonlyresideinone storagerepository. Intheaboveexamplewehavetworepositories,onewhichcontainsourOSboot storagevolumes,andasecondforgeneraluse.Youcanaddandremovestorage volumesto/fromarepository,andyoucanevenprovisionstorageoutsideof StorageLinkandaddthattotherepositoryusingtheAdd/RemoveStorage Volumesdialog. Tocreateastoragerepository 1. SelectCreateStorageRepositoryfromtheupperhalfoftheActionspane. 2. TheCreateStorageRepositorywizardappears.EnteraName,anoptional Description,andselecttheStoragesystemthatwillhostthestoragefor thisrepository.ForHostgroupselection,chooseeitherMicrosoftHyperV orCitrixXenServerandselectfromtheentriesinthepulldownlist.(This listwillshowMicrosoftClusteringServiceshostgroupsifHyperVis selected,orXenServerpoolmastersifXenServerisselected.)

16

Click Next to continue.

3. Inthenextpageofthewizard,definetherepositorysettings(thesetof availablesettingsdependsonthestoragesystemvendor/modelandthe configurationofthestoragepoolyouveselected): identifytheStoragepoolforthestoragerepository selecttheRaidtype settheProvisioningtype(Default,ThickorThin) settheProvisioningoptions(forexample,deduplication) setthestorageProtocolusedtoconnectthehypervisorhosttothe storage(iSCSI,FibreChannel,orAutotohavethesystemchoose)

ClickNexttocontinue.

17

 4. Thestoragerepositorycanbepopulatedwithexistingprecreatedstorage volumesresidentinthestoragearray,ornewreferencestoragevolumes canbecreateddynamically.Inthisexample,wechoosetoallocateanew storagevolumetothestoragerepositoryaftertherepositoryhasbeen created.

ClickFinishtocontinue. Onceyouhaveaddedyourstoragerepository,itwillshowupinthetreecontrolin theleftpane,whenyouareintheStorageRepositoriesworkarea.Youseecan detailsaboutthestoragerepositoryintheGeneraltabofthecenterpane.Ifyou createdaStorageRepositoryforaXenServerresourcepool,itwillalsoshowupin XenCenter,whereyoucanbeginutilizingitforvirtualmachineoperations.

AllocateStorage
Thenextstepistoselectyournewstoragerepositoryandallocatearawstorage volumefromit.Youllusethisvolumeasyourbootdeviceinyourstorageprofile. Toallocatestorageforthedesktopbootimage 1. SelecttheStorageSystemthatyournewrepositorywascreatedfromand clickRefresh. 2. Selectthestoragerepository,andclickCreateStorageVolumefromthe lowerhalfoftheActionspane. 3. TheCreateStorageVolumedialogboxappears.ProvideaStoragevolume nameforthestoragevolume(forthisexamplewelluseVistaImage)anda Size(forthisexamplewelluse30GB).

18

Anew30GBreferencestoragevolumeshowsupunderthestorage repository.

CreateaStorageProfile
Thestorageprofileisonecomponentofavirtualmachinetemplate.Itcontains thelistofstoragevolumestobesnapshotted/clonedwhenthevirtualmachine templateisinstantiated. TocreateaStorageProfile 1. ClickVirtualMachineTemplatesinthelowerhalfoftheleftnavigation panetodisplaytheVirtualMachineTemplatesworkingarea,thenCreate StorageProfilefromthelowerhalfoftheActionspane.Thefollowing dialogboxappears:

2. ProvideaName,andanoptionalDescription.SelecttheStorage repositorycontainingthepoolofstorage,andidentifyastoragevolume containingaBootstoragevolume.Thebootstoragevolumewillbethe 19

 bootdisk(Cdrive)forthevirtualmachine.Itispossibletoaddoptional datastoragevolumesthatwouldbecometheotherdatadrives(D,E,etc.) drivesinthevirtualmachine. 3. ClickOK. ThenewprofileappearsundertheVirtualMachineTemplatesnode.

CreateaVirtualMachineTemplate
TheVirtualMachineTemplateiscomprisedoftwokeycomponents: theStorageProfile,whichcontainsalistofStorageVolumestobecloned orsnapshotwhenthetemplateisinstantiated theHardwareProfile,whichindicateshowmuchmemoryandthenumber ofvirtualCPUstoallocateforeachnewVMthatiscreatedfromthe template

ThefollowingdiagramoutlinestherelationshipbetweentheVMtemplate,the StorageProfile,andtheHardwareProfile.YoucanreuseStorageProfileswith differentVMtemplates,andyoucanreuseHardwareProfileswithdifferentVM templatesaswell. ItisrecommendedthatyoufirstcreateaStorageRepositorysothatyoucan allocatestoragevolumestotheStorageRepository(SR)forusewithStorage Profilecreation.Ifyourstorageadministratorhasalreadyallocatedstorage volumeswithOSbootimagesalreadyinstalledonthem,youcanselectyourSR fromthetreeandusetheEditStorageVolumeSettingsdialogboxtoaddthose precreatedstoragevolumestotheSR.

Thefollowingsequencediagramoutlinesthebasicprocedureforcreatinganew VirtualMachineTemplate. WhenyoucreateanewvirtualmachinetemplateusinganewlyallocatedStorage VolumewithnoOSbootimageonit,therearesomeadditionalstepsyoumust taketoprepareyourVMtemplate. Inthisexample,wewillbeusingthestorageprofilewejustcreatedinthe previousexample.

20

 TocreateaVirtualMachineTemplate 1. ClickVirtualMachineTemplatesinthelowerhalfoftheleftnavigation panetodisplaytheVirtualMachineTemplatesworkingarea,thenCreate VirtualMachineTemplatefromthelowerhalfoftheactionspane.The followingdialogboxappears:

2. EnteraNameand,ifdesired,anoptionalDescription.SelectyourStorage profile,andchooseaHardwareprofilefromthedropdownlistthatbest meetsyourneeds. 3. ClickOK. ThenewtemplateappearsundertheVirtualMachineTemplatesnode.

PreparetheVMtemplate
Inthisexample,usingaHyperVhost,weneedtopreparethetemplatewithan unattendedinstallationoftheoperatingsystem,inthiscaseWindowsVista. TopreparetheVMtemplate 1. IntheHyperVManagerorSCVMMconsole,createavirtualmachine withoutaharddrive(notshownhere).Inthisexample,wehavecreateda virtualmachinecalledVistaImageVM. 2. InStorageLinkManager,clickStorageRepositoriesinthelowerhalfofthe leftnavigationpanetodisplaytheStorageRepositoriesworkingarea. Selectthestorageprofilecreatedearlier,thenselectImportStorage VolumestoVMfromthelowerhalfoftheactionspane 3. ChoosetheVistaImagestoragevolumethatwascreatedintheAllocate Storagesectionaboveandclickthecheckboxnexttothestoragevolume inthelowerpartofthedialogbox.

21

ClickOKtoattachthestoragetotheVM. 4. ReturntotheHyperVorSCVMMconsoleandverifythatthediskwas attachedtotheVistaImageVMvirtualmachinebycheckingitsvirtual machinesettings(rightclickonthevirtualmachineinthelistandselect Settingsfromthecontextmenu). 5. DoubleclickonVistaImageVMtoopenitsconsole.Fromtheconsoles window,chooseDVDdrive>InsertDiskfromtheMediamenuandbrowse tothelocationofyourWindowsVistaISO. 6. Fromthevirtualmachinesconsole,selectStartfromtheActionsmenu. ThevirtualmachinewillbootofftheISOyoujustattachedandbeginthe operatingsysteminstallationprocess. 7. Whentheoperatingsystemcompletelyloadsandsetsthevirtual machinesconfigurationsettingsitwillreboot;atthispoint,poweroffthe virtualmachine.
IMPORTANT: Failure to shut down the machine after the first reboot may cause further deployments based on this image to fail.

8. FromtheHyperVorSCVMMconsole,deletetheVistaImagevirtual machine.Thevirtualmachineisdestroyed,butthestoragevolume containingtheimageyoupreparedfromitstillexistsandisattachedto yourvirtualmachinetemplate. TheimagecontainedontheVistaImagestoragevolumeintheStorageLinkstorage repositorynamedMyStorageRepositoryisnowreadyfordeployment.

22

CreateVMsfromtemplate
InthisexamplewecreateavirtualmachineonaHyperVhostusingthedesktop templatebuiltfromabasedesktophardwareprofileandastorageprofilethat containedanunattendedinstalloftheMicrosoftWindowsVistaoperatingsystem. WithafewsimpleclicksusingtheStorageLinkManagersCreateVirtualMachine wizard,wecancreateanynumberofdesktopVMsbasedonthistemplateand assignthemtoHyperVhosts.Thedesktopvirtualmachineswillgetautomatically configuredandnamedafterthefirstboot. Tocreatevirtualmachinesfromatemplate 1. Fromtheupperhalfoftheactionspane,chooseCreateVirtual Machines(s).

2. FromtheVMtemplatedropdown,choosetheDesktopTemplatecreated earlier.ClickNext.

23

3. EnterabaseNameforthevirtualmachine.Foreachvirtualmachine created,StorageLinkwillappend00,01,02,etc.SelecttheHypervisorhost thatwillrunthenewlycreatedvirtualmachine.FromtheProtocol preferencefield,selectthestorageprotocoltoconnectthestoragetothe virtualmachine.FromtheCopytypefield,selectsnapshot.(Asnapshotis usedwhenyouwantabaseimageandeachmachinegetsaprivatewrite area.Snapshotssavesignificantdiskspace.Theothercopytypeisclone, whichcompletesinstantly,butcreatesacompletecopyofthedata.) ChoosetheNumberofvirtualmachinesyouwishtocreate(forexample, 5). ClickNexttocontinue.
4. Review the information and click Finish

24

 ThenewvirtualmachinesshowupundertheVirtualMachineviewinStorageLink Manager. Virtualmachinesarenotstartedautomatically.SelectthemandclickStartfrom theactionsmenu. Thevirtualmachinestateisnotupdatedautomaticallyafteranaction.Youneed toclickRescantoseethecurrentstate.Forexample,ifyoustartavirtual machine,thevirtualmachinestillappearstobeoffinStorageLinkManageruntil youdoarescan.

Note: After you start your virtual machines on a Hyper-V host, you will need to insert the Hyper-V integration services disk into them to ensure that networking works correctly. Please refer to Microsoft's Hyper-V Manager documentation for instructions on how to do this. After you start your virtual machines on a XenServer host, you will need to install the XenServer Tools. Please refer to the XenServer and XenCenter documentation for instructions on how to do this.

Interoperablevirtualmachines
IfyouwantavirtualmachineimagetorunoneitherHyperVorXenServerhosts, youneedtoinstalltheparavirtualizedtoolsforeitherofthehypervisorsinthe virtualmachineimage.BothHyperVandXenServerparavirtualizedtoolsprepthe imageinsuchawaythatitwillbootoneitherhypervisor. ForaHyperVvirtualmachine,youneedtoinstalltheIntegrationServices. ForXenServervirtualmachine,youneedtoinstalltheXenServerTools.

Oncethisisdone,youcantakeanimagecreatedononehypervisorandcreatea virtualmachinefromthetemplateontheotherhypervisor. Inaddition,youcanalsomigrateavirtualmachinefromaHyperVhosttoa XenServerhostorviceversa. Ifyouplanonrunningtheimagefromeitherhypervisortype,thenitisbestto savetheimageafteryouhaveinstalledbothsetsofparavirtualizedtools.

StorageLinkcommandline interface
Thissectiondescribesvariousoperationsthatcanbeperformedwiththe StorageLinkcommandlineinterface(CLI),csl.exe.ThecslCLIenablesthewriting ofscriptsforautomatingsystemadministrationtasksandallowsintegrationof StorageLinkintoanexistingITinfrastructure. ThecslcommandlineinterfaceisinstalledbydefaultwiththeStorageLink Managerinstallation. Touseit,openaWindowsCommandPromptandchangedirectoriestothe directorywherethefileresides(typicallyC:\Program Files\Citrix\StorageLink\Client orC:\Program Files 25


(x86)\Citrix\StorageLink\Client for64bitinstallations),oraddits installationlocationtoyoursystempath.

BasichelpisavailableforCLIcommandsonhostbytyping:
csl.exe help=<operation>

Alistofthemostallcslcommandsisdisplayedifyoutype:
csl.exe help

Basiccslsyntax
ThebasicsyntaxofallcslCLIcommandsis:
csl.exe <operation> <argument=value> <argument=value> ...

Eachspecificcommandcontainsitsownsetofargumentsthatareoftheform argument=value.Somecommandshaverequiredarguments,andmosthavesome setofoptionalarguments.Typicallyacommandwillassumedefaultvaluesfor someoftheoptionalargumentswheninvokedwithoutthem. Mostofthecommandshaveaabbreviationavailabletominimizetyping;i.e.the operationssrcreateandstoragerepositorycreatearethesame. Ifthecslcommandisexecutedremotely,additionalconnectionand authenticationargumentsareused.Usethefollowingsyntaxtoexecutecommand remotely:

csl.exe server=HOSTNAME[:PORT][,USERNAME,PASSWORD] <operation>

TheserverargumentisusedtospecifythehostnameorIPaddress.Theusername andpasswordargumentsareusedtospecifycredentials. Theoptionalportargumentcanbeusedtospecifytheserviceportontheremote StorageLinkGatewayhost(defaultsto21605). Example:OnthelocalStorageLinkGatewayhost:

csl.exe vm-list

Example:OntheremoteXenServerhost:
csl server=<hostname>,<username>,<password> vm-list

Specialcharactersandsyntax
Tospecifyargument/valuepairsonthecsl.execommandline,write
argument=value

withoutquotes,aslongasvaluedoesn'thaveanyspacesinit.Thereshouldbeno whitespaceinbetweentheargumentname,theequalssign(=),andthevalue. Anyargumentnotconformingtothisformatwillbeignored. Forvaluescontainingspaces,write:

argument="value with spaces"

26

Interactivemode
ThecslCLIsupportsrunningasaninteractiveshell.Thesyntaxofenteringthe interactiveshellis:
csl.exe

Afterenteringtheinteractiveshell,youcanexecutecommandsbytypinginthe operationnamewithoutthecsl.exeprefix. Ifthecslinteractiveshellshouldconnectremotely,additionalconnectionand authenticationargumentsareused.Usethefollowingsyntaxtoexecutethe interactiveshellremotely:

csl.exe server=HOSTNAME[:PORT][,USERNAME,PASSWORD]

XMLoutputmode
ThecslCLIsupportsdisplayingtheoutputofcommandsstructuredasXML.To specifyenablingXMLoutput,usethefollowingsyntax:
csl.exe <operation> xml

Verboseoutputmode
ThecslCLIsupportsdisplayingtheoutputofsomecommandsmoreverbosely thanthestandardoutput.Thiswilldisplaythelessfrequentusedpropertiesof objects.Tospecifyenablingtheverboseoutput,usethefollowingsyntax:
csl.exe <operation> verbose.

N.B.Theverboseflagcanbeusedtogetherwiththexmlflag.

CLIcookbook
Addstorageadaptercredentials
Beforeaddinganystoragecredentials,youwillfirstneedalistofstorageadapters supportedonthesystem:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sa-list Storage Adapters: Storage Adapter: display name: EMC CLARiiON Storage Adapter (SMI-S) friendly name: EMC CLARiiON Storage Adapter (SMI-S) cred input options: 49215 desc: Supports EMC Clariion CX3 & CX4 series storage systems storage adapter ID: EMC_CLARIION ipAddress: port #: 0 username: password: library: cslsa_smis_storage_system.dll

etc.fortheremainingadapters. Next,addthestoragecredentialsforthestoragearraytoStorageLinkGateway:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sc-add adapterid=NETAPP ipaddress=10.219.101.232 username=root password=xenroot Storage Management Credentials: display name: xenadu-2

27


friendly name: xenadu-2 uuid: d2cebadd-d4f8-421d-a399-823cfd29cfa9 storage adapter ID: NETAPP ipAddress: 10.219.101.232 port #: 0 username: root password: xenroot context: namespace: Storage Systems: ssid: NETAPP__LUN__0ADB65E9

Next,confirmthatthestoragecredentialswereaddedtoStorageLinkGateway:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sc-list Management Credentials: Storage Management Credentials: display name: xenadu-2 (10.219.101.232) friendly name: xenadu-2 uuid: d2cebadd-d4f8-421d-a399-823cfd29cfa9 storage adapter ID: NETAPP ipAddress: 10.219.101.232 port #: 0 username: root password: ******** context: namespace: Storage Systems: ssid: NETAPP__LUN__0ADB65E9

IfyouareusingBrocadeswitchesinyourenvironment,andyouhavesetupall yourphysicalcabling,StorageLinkprovidesautomaticfabriczoning.Automatic fabriczoningisenabledonlyifyougivetheservicecredentialsforaccessinga BrocadeSMISCIMOMconfiguredwithyourfabric.IfyoudontsetupaBrocade SMIMCIMOM,theservicewillskipoverzoningoperations

Viewstoragesystemdetails
YoucanusetheCLItoviewdetailsofthestoragesystemsthatareconnectedto theStorageLinkGateway ListthestoragesystemsconnectedtoStorageLinkGateway:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe ss-list Storage System: friendly name: xenadu-2 display name: NetApp FAS3050 (xenadu-2) vendor: NetApp model: FAS3050 serial #: 1070453 ssid: NETAPP__LUN__0ADB65E9

Makenoteofthevalueinssidfield.Thiswillbeneededforallfollowon commandsaroundqueryingthestoragesystem.Togetmoreinformationabout thestoragesystem:

C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe ss-get-info ssid=NETAPP__LUN__0ADB65E9 Storage System: friendly name: xenadu-2 display name: NetApp FAS3050 (xenadu-2) vendor: NetApp model: FAS3050 serial #: 1070453 ssid: NETAPP__LUN__0ADB65E9 system capabilities: : PROVISIONING : THIN_PROVISIONING : MAPPING : MULTIPLE_STORAGE_POOLS : LUN_GROUPING : DEDUPLICATION : DIFF_SNAPSHOT : REMOTE_REPLICATION

28


: CLONE : REQUIRES_STORAGE_POOL_CLEANUP protocol support: : FC : ISCSI : NFS : CIFS Snapshot Methods: Snapshot Method: name: LUNClone display name: max snapshots: 128 supported node types: : STORAGE_VOLUME snapshot types: : DIFF_SNAPSHOT : IS_DEFAULT snapshot capabilities: : THIN_PROVISIONED_TARGET : AUTO_PROVISIONED_TARGET Snapshot Method: name: SplitLUNClone display name: max snapshots: 128 supported node types: : STORAGE_VOLUME snapshot types: : CLONE snapshot capabilities: : THIN_PROVISIONED_TARGET : AUTO_PROVISIONED_TARGET

Asyoucansee,thisoutputprovidesdetailsaboutthecapabilitiesofthestorage arraysnapshotcapabilities,systemcapabilities,protocolsupport,etc. Sometimes,youmightwantthelistofhostinitiatorsthatareconnectedtothis storagearray:

C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe ss-init-list ssid=NETAPP__LUN__0ADB65E9 Storage System Initiator Ports: Initiator Port: port id: 21:00:00:e0:8b:88:f8:2c friendly name: 21:00:00:e0:8b:88:f8:2c display name: 21:00:00:e0:8b:88:f8:2c storage system: NETAPP__LUN__0ADB65E9 protocol type: FC host type: 1 Initiator Port: port id: friendly name: display name: storage system: protocol type: host type:

21:00:00:e0:8b:9d:90:13 21:00:00:e0:8b:9d:90:13 21:00:00:e0:8b:9d:90:13 NETAPP__LUN__0ADB65E9 FC 1

Initiator Port: port id: iqn.199105.com.microsoft:jandakot.cluster.acme.com friendly name: iqn.199105.com.microsoft:jandakot.cluster.acme.com display name: iqn.199105.com.microsoft:jandakot.cluster.acme.com storage system: NETAPP__LUN__0ADB65E9 protocol type: ISCSI host type: 1

etc.fortheremaininginitiatorports. Youcanalsolookatthetargetportsonthestoragearray:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe ss-target-list ssid=NETAPP__LUN__0ADB65E Storage System Target Ports: Target Port:

29


port id: friendly name: display name: storage system: protocol type: Target Port: port id: friendly name: display name: storage system: protocol type: Target Port: port id: friendly name: display name: storage system: protocol type: port iqn: 50:0a:09:81:86:57:c8:b0 0c 0c NETAPP__LUN__0ADB65E9 FC

50:0a:09:82:86:57:c8:b0 0d 0d NETAPP__LUN__0ADB65E9 FC

10.219.101.233 10.219.101.233 10.219.101.233 NETAPP__LUN__0ADB65E9 ISCSI iqn.1992-08.com.netapp:sn.101173424

Thefollowingcommandliststhestoragepoolsonthearray(notethatthesplist commandshowsaflatlistofallstoragepoolsasoutput,eventhoughsomepools mayhaveahierarchicalrelationshipwithotherpools):

C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sp-list ssid=NETAPP__LUN__0ADB65E9 | more Storage Pool: display name: aco_sr friendly name: aco_sr storage pool ID (SPID): 6d924df2-1598-11de-acfb-00a098032b86 parent storage pool ID: 616b9560-ab88-11dd-acad-00a098032b86 storage system ID (SSID): NETAPP__LUN__0ADB65E9 total size (MB): 9802 free space (MB): 9802 is default pool: No status: 0 provisioning options: supported raid types: : RAID4 supported node types: : NFS : CIFS : STORAGE_VOLUME supported provisioning types: : FULL Storage Pool: display name: adf_c7d6a6a3_f5ed_4edd_8690_986b14e247fe friendly name: adf_c7d6a6a3_f5ed_4edd_8690_986b14e247fe storage pool ID (SPID): 88da2c92-1674-11de-acfb-00a098032b86 parent storage pool ID: 616b9560-ab88-11dd-acad-00a098032b86 storage system ID (SSID): NETAPP__LUN__0ADB65E9 total size (MB): 9802 free space (MB): 9802 is default pool: No status: 0 provisioning options: supported raid types: : RAID4 supported node types: : NFS : CIFS : STORAGE_VOLUME supported provisioning types: : FULL Storage Pool: display name: aggr0 friendly name: aggr0 storage pool ID (SPID): 838448e0-3027-11dd-a299-00a098032b86 parent storage pool ID: storage system ID (SSID): NETAPP__LUN__0ADB65E9 total size (MB): 58122 free space (MB): 178 is default pool: Yes

30


status: 0 provisioning options: supported raid types: : RAID6 supported node types: : NFS : CIFS : STORAGE_VOLUME supported provisioning types: : FULL : THIN

Youcangetmoreinformationaboutaparticularstoragepoolbyusingthe followingcommand:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sp-get-info ssid=NETAPP__LUN__0ADB65E9 spid=838448e0-3027-11dd-a299-00a098032b86 Storage Pool: display name: aggr0 friendly name: aggr0 storage pool ID (SPID): 838448e0-3027-11dd-a299-00a098032b86 parent storage pool ID: storage system ID (SSID): NETAPP__LUN__0ADB65E9 total size (MB): 58122 free space (MB): 178 is default pool: Yes status: 0 provisioning options: supported raid types: : RAID6 supported node types: : NFS : CIFS : STORAGE_VOLUME supported provisioning types: : FULL : THIN

Similarly,youcangetinformationaboutstoragevolumesonastoragesystemby usingthesvlistandthesvgetinfocommand.

Addhypervisorhost
AddahosttoStorageLinkGatewayasfollows:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe host-add hostname=10.219.245.23 username=baehv\Administrator password=pass1234 Host Info: display name: 10.219.245.23 hostname: 10.219.245.23 uuid: bdee7c59-70ad-4c8f-bc97-8eef646babcf IP address: 10.219.245.23 hypervisor type: 1 OS type: Microsoft Windows Server 2008 Enterprise OS version: Service Pack 1 RAM (in MB): 8186 CPUs: 2 username: baehv\Administrator password: xenroot Host Initiators: Initiator: initiator name: 20-00-00-1B-32-01-5A-07 uuid: 63f082c1-cfa9-4531-9161-91a1de05387a display name: 20-00-00-1B-32-01-5A-07 initiator tag: PORT_1 chap password: chap username: host uuid: bdee7c59-70ad-4c8f-bc97-8eef646babcf host name: 10.219.245.23 is virtual: false initiator type: 4 Ports: port: 21-00-00-1B-32-01-5A-07 Fabric: 10-00-00-05-1E-34-6D-42 Port State: Online Initiator:

31


initiator name: 20-01-00-1B-32-21-5A-07 uuid: 2b8625a0-bfa5-48a0-84f8-cd0f855cc968 display name: 20-01-00-1B-32-21-5A-07 initiator tag: PORT_2 chap password: chap username: host uuid: bdee7c59-70ad-4c8f-bc97-8eef646babcf host name: 10.219.245.23 is virtual: false initiator type: 4 Ports: port: 21-01-00-1B-32-21-5A-07 Fabric: 00-00-00-00-00-00-00-00 Port State: Offline Initiator: initiator name: iqn.199105.com.microsoft:davinci.baehv.acme.com uuid: 52105770-688b-4e7d-afe3-441af8ccf04a display name: iqn.199105.com.microsoft:davinci.baehv.acme.com initiator tag: PORT_3 chap password: chap username: host uuid: bdee7c59-70ad-4c8f-bc97-8eef646babcf host name: 10.219.245.23 is virtual: false initiator type: 2 Ports: port: iqn.199105.com.microsoft:davinci.baehv.acme.com Port State: Online Virtual Machines: Virtual Machine: display name: Manager hostname: Manager IP address: Manager uuid: DC93B15C-D998-4F19-9F91-C84F36FDE042 parent host uuid: bdee7c59-70ad-4c8f-bc97-8eef646babcf OS type: OS version: RAM (in MB): 512 CPUs: 1 VM state: XCMN_VM_STATE_RUNNING

Thecommandreturnswiththehostconnected,andalsoshowsanyvirtual machinesrunningonthehost.

Hypervisorhostgroups
Hostgroupsarecollectionsofhypervisorhosts.ForHyperV,hostgroups representfailoverclustergroupsofhosts.ForXenServer,hostgroupsrepresent poolsofhosts.WhenyouaddahosttoStorageLinkGateway,itwilldetectifitisin aWindowsfailoverclusterorXenServerpoolandaddallofthehoststhatarein thathostgroup. Thecommandhostgrouplistlistsallthehostsgroupsconnectedtothe StorageLinkGateway:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe host-group-list

Thecommandhostgroupgetinfolistsinformationaboutaspecifichostgroup.
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe host-group-get-info groupname=mygroup

Youcanspecifyeitheragroupnameorahostgroupuuid. Thecommandhostgroupremoveremovesahostgroup,alongwithallofthe containedhosts,fromtheStorageLinkGateway.Thisactiondoesnotdestroyany virtualmachinesorstorageassociatedwiththesehosts.

C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe host-group-remove groupname=mygroup

32

 Ifahostispartofahostgroup,thenyoucannotremovethathostbyitself.You mustremovethehostgroupasawhole. Youcanspecifyeitheragroupnameorahostgroupuuid.

Createstoragerepository
Beforecreatingastoragerepository,youwillneedtoidentifyastoragepoolon whichtocreatetheStorageRepository.Youcanusethesplistcommand describedabovetoidentifyanappropriatepool. Createastoragerepositoryasfollows(italicizedargumentsareoptional):
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sr-create name=MyTestSR ssid=NETAPP__LUN__0ADB65E9 spid=616b9560-ab88-11dd-acad00a098032b86 raid-type=RAID4 provisioning-type=THICK Storage Repository: name: MyTestSR uuid: b825edad-2dd1-42ee-8d04-3010ad015d0f display name: MyTestSR storage system: NETAPP__LUN__0ADB65E9 storage pool: 6c849b78-197f-11de-acfc-00a098032b86 raid type: RAID4 desc: protocol type: ALL provisioning type: THICK use deduplication: 0

Allocatestorageonastoragerepository
Youcancreateanewvolumeonthearray,oraddanexistingvolumetotheSR.In thisexample,wewillcreateavolumeonthearray,andthenaddittotheSR.
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sv-create name=MyTestLUN size=20G ssid=NETAPP__LUN__0ADB65E9 spid=616b9560-ab88-11ddacad-00a098032b86 raid-type=RAID4 Storage Volume: display name: /vol/storagelink_fv_00/MyTestLUN friendly name: /vol/storagelink_fv_00/MyTestLUN size: 20480 used: 0 access: RW serial number: C4dbK4ORyUyD storage volume ID (SNID): NETAPP__LUN__0ADB65E9__433464624B344F5279557944 storage system ID (SSID): NETAPP__LUN__0ADB65E9 storage pool ID (SPID): 047f0d18-1981-11de-acfc-00a098032b86 node type: STORAGE_VOLUME is snapshot: No

NowaddittotheSR:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sr-storage-add sruuid=b825edad-2dd1-42ee-8d04-3010ad015d0f svidlist=NETAPP__LUN__0ADB65E9__433464624B344F5279557944 Storage Repository: name: MyTestSR uuid: b825edad-2dd1-42ee-8d04-3010ad015d0f display name: MyTestSR storage system: NETAPP__LUN__0ADB65E9 storage pool: 6c849b78-197f-11de-acfc-00a098032b86 raid type: RAID4 desc: protocol type: ALL provisioning type: THICK use deduplication: 0 Storage Repository Nodes: Storage Repository Node: storage volume ID: NETAPP__LUN__0ADB65E9__433464624B344F5279557944 uuid: b825edad-2dd1-42ee-8d04-3010ad015d0f

33

Createastorageprofile
Tocreatestorageprofile,youneedastoragevolumetoassociateasaboot storagevolume
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe spr-create name=MyStorageProfile boot-svid=NETAPP__LUN__0ADB6 5E9__433464624B344F5279557944 Storage Profile: friendly name: MyStorageProfile uuid: cb412ae9-5979-4a89-823a-ce10aa26d051 display name: MyStorageProfile desc: boot storage volume: NETAPP__LUN__0ADB65E9__433464624B344F5279557944 state: 0 Storage Volumes: Storage Volume: display name: /vol/storagelink_fv_00/MyTestLUN friendly name: /vol/storagelink_fv_00/MyTestLUN size: 20480 used: 0 access: RW serial number: C4dbK4ORyUyD storage volume ID (SNID): NETAPP__LUN__0ADB65E9__433464624B344F5279557944 storage system ID (SSID): NETAPP__LUN__0ADB65E9 storage pool ID (SPID): 047f0d18-1981-11de-acfc-00a098032b86 node type: STORAGE_VOLUME is snapshot: No

Createavirtualmachinetemplate
Tocreateavirtualmachinetemplate,youfirstneedtocreateahardwareprofile thatdescribesthememoryandCPUcharacteristicsofthevirtualmachine.
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe hwp-create name=MyHardwareProfile1 cpu-count=2 mem-size=1024M Hardware Profile: friendly name: MyHardwareProfile1 display name: MyHardwareProfile1 uuid: f6918a9f-84d3-4aa8-b208-a099a64701fd boot order: CPU count: 2 network policy: auto memory size (MB): 1024

Preparethevirtualmachinetemplate
InHyperVmanager,createadisklessVM.DonotstarttheVM. Rescanthevirtualmachines:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe vm-list flags=refresh Virtual Machines: Virtual Machine: display name: Manager hostname: Manager IP address: Manager uuid: DC93B15C-D998-4F19-9F91-C84F36FDE042 parent host uuid: bdee7c59-70ad-4c8f-bc97-8eef646babcf OS type: OS version: RAM (in MB): 512 CPUs: 1 VM state: XCMN_VM_STATE_RUNNING Virtual Machine: display name: hostname: IP address: uuid: parent host uuid: OS type: OS version:

vm1 vm1 vm1 BA664A1B-F322-419B-BE83-F8D00732D8A2 bdee7c59-70ad-4c8f-bc97-8eef646babcf

34


RAM (in MB): 1024 CPUs: 2 VM state: XCMN_VM_STATE_RUNNING Virtual Machine: display name: hostname: IP address: uuid: parent host uuid: OS type: OS version: RAM (in MB): CPUs: VM state:

VMFromCLI VMFromCLI VMFromCLI 0C254D03-4268-40A6-8AAF-CBC0D15DD698 bdee7c59-70ad-4c8f-bc97-8eef646babcf

1024 2 XCMN_VM_STATE_RUNNING

TheoutputoftherescanwillprovidetheUUIDoftheVM. NowattachthestoragevolumetotheVM.Itisrecommendedthatyouspecifythe protocolheresothatStorageLinkusestherightprotocoltoattachthestorageto theVM.

C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe vm-import-storage vm-uuid=F67FC607-4B0D-4DD3-91ED-DF76BD705356 svidlist=NETAPP__LUN__0ADB65E9__433464624B344F5279557944 protocol=ISCSI

GointoSCVMMorHyperVManagerandensurethatthediskisattachedtothe VM.NowattachtheISO/DVDdrivetotheVMandfinishtheOSinstallationinside theVM.InstallIntegrationServices,andshutdowntheVM.DeletetheVMfrom theHyperVManager.Thestoragevolumewillremainonthearray.

Createvirtualmachinesfromtemplate
Usethevmcreatefromtemplatecommand:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe vm-create-fromtemplate vm-name=VMFromCLI hostname=10.219.245.23 template=MyVMTemplate protocol=ISCSI New VM List: Virtual Machine: display name: VMFromCLI hostname: VMFromCLI IP address: VMFromCLI uuid: 0C254D03-4268-40A6-8AAF-CBC0D15DD698 parent host uuid: bdee7c59-70ad-4c8f-bc97-8eef646babcf OS type: OS version: RAM (in MB): 1024 CPUs: 2 VM state: XCMN_VM_STATE_OFFLINE

NowstarttheVM:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe vm-start vmuuid=0C254D03-4268-40A6-8AAF-CBC0D15DD698

GointoSCVMM/HyperVmanagertoensurethattheVMisup.Youcannow connecttotheVMconsole.

Snapshots/Clones
Tocreateacloneofastoragevolume,usethesvclonecreatecommand:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sv-clone-create src-svid=NETAPP__LUN__0ADB6 5E9__433464624B344F5279557944 Snapshot Session: display name: 57D0DFD session ID: 57D0DFD snapshot method: Snapshot Associations: Snapshot Assoc: display name: src volume: NETAPP__LUN__0ADB65E9__433464624B344F5279557944 snapshot volume: NETAPP__LUN__0ADB65E9__433464624B344F5436726D4F

35


group ID: operation: NONE progress: 100 state: 4 snapshot type:

Tocreateacloneofastoragevolume,usethesvsnapcreatecommand:
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sv-snap-create srcsvid=NETAPP__LUN__0ADB6

whichhassimilaroutput.

GetServiceLogFiles
C:\Program Files (x86)\Citrix\StorageLink\Client>srv-log-get > <outputfile>

AssignStoragetoHost
C:\Program Files (x86)\Citrix\StorageLink\Client>csl.exe sv-assign-add svid=NETAPP__LUN__0ADB65E9__433464624B344F5436726D4F hostname=10.219.245.22 iqn=iqn.1991-05.com.microsoft:ataturk.baehv.acme.com Storage Assignments: Storage Assignment: display name: 10.219.245.22.01 name: 10.219.245.22.01 friendly name: 10.219.245.22.01 Initiator Ports: Target Ports: Storage Volumes: Storage Volume Lun Assignment: storage volume ID: NETAPP__LUN__0ADB65E9__433464624B344F5436726D4F LUN IQN: LUN: 0

Nowgotoyourhost,openDiskManager,andchooseRescanDisksandthisdisk shouldshowup.

ListofCLIcommands
ThefollowinglistsallsupportedCLIcommands: Fabricdiscovery
fa-list, fabric-list sw-list, switch-list za-list, zone-alias-list zn-create-auto, zone-create-auto zn-list, zone-list zs-list, zone-set-list

Hardwareprofiles
hwp-create, hardware-profile-create hwp-delete, hardware-profile-delete hwp-get-info, hardware-profile-get-info hwp-list, hardware-profile-list hwp-update, hardware-profile-update

Hostmanagement
host-add host-device-id-rescan host-get-info host-init-remove, host-initiator-remove host-init-rescan, host-initiator-rescan host-list host-remove

Hostgroupmanagement
host-group-get-info

36


host-group-list host-group-remove

LicenseServer
ls-get, license-server-get-info ls-set, license-server-set-info

Misccommands
cm, custom-method h, help

Serviceevents
ev-list, event-list ev-listener-register, event-listener-register

Servicemanagement
srv-log-get, service-log-get srv-set-pwd, service-set-password srv-version, service-version

Storageadaptermanagement
sa-list, storage-adapter-list sa-scsidev-processor-list, storage-adapter-scsi-deviceprocessor-list

Storageallocation
sp-create, storage-pool-create sp-destroy, storage-pool-destroy sv-create, storage-volume-create sv-destroy, storage-volume-destroy sv-resize, storage-volume-resize

Storageassignment
sv-assign-add, storage-volume-assignment-add sv-assign-list, storage-volume-assignment-list sv-assign-remove, storage-volume-assignment-remove

Storagediscovery
sp-get-info, storage-pool-get-info sp-list, storage-pool-list ss-get-info, storage-system-get-info ss-init-list, storage-system-initiator-port-list ss-list, storage-system-list ss-target-list, storage-system-target-port-list sv-get-info, storage-volume-get-info sv-list, storage-volume-list

Storageprofiles
spr-create, storage-profile-create spr-delete, storage-profile-delete spr-get-info, storage-profile-get-info spr-list, storage-profile-list spr-storage-add, storage-profile-storage-add spr-storage-remove, storage-profile-storage-remove spr-update, storage-profile-update

Storagerepository
sr-create, storage-repository-create sr-delete, storage-repository-delete sr-destroy, storage-repository-delete sr-list, storage-repository-list

37


sr-storage-add, storage-repository-storage-add sr-storage-create, storage-repository-storage-create sr-storage-destroy, storage-repository-storage-destroy sr-storage-remove, storage-repository-storage-remove sr-update, storage-repository-update

Storagesnapshots/cloning
sv-clone-create, storage-volume-clone-create sv-snap-create, storage-volume-snapshot-create sv-snap-delete, storage-volume-snapshot-delete

Storagesystemcredentialsmanagement
job-get-info job-list job-list-clear sc-add, storage-credential-add sc-list, storage-credential-list sc-remove, storage-credential-remove sc-update, storage-credential-update

Tagmanagement
tag-add tag-remove

Virtualmachineoperations
vm-clone vm-create vm-create-from-template vm-delete vm-destroy vm-get-info vm-import-storage vm-list vm-move vm-shutdown vm-snapshot vm-start vm-turnoff

Virtualmachinetemplates
vm-template-create, virtual-machine-template-create vm-template-delete, virtual-machine-template-delete vm-template-list, virtual-machine-template-list vm-template-update, virtual-machine-template-update

PowerShellinterface
FordetailsoninstallingandusingtheStorageLinksnapinforWindows PowerShell,refertotheStorageLinkPowerShellGuide.

38

MSCSsupportforStorageLink andSQLite
TosetupMicrosoftClusterServicetosupportStorageLinkandSQLite 1. InstallWindows2008Serverontwohosts.Makesurethehostsare identicalforthemostpartandhavemultipleNICs. 2. WireuptheNICsonthehoststodifferentnetworks. 3. Joinbothhoststothesamedomainandlogintothehostsasthedomain administrator. 4. Oneachofthetwohosts,launchServerManagerandinstalltheFailover clusteringfeature. 5. StarttheFailoverClusterManagementinterface(Start>Administrative Tools>FailoverClusterManagement)andusethistomanagethecluster henceforth. 6. RuntheClusterValidationtoolfromtheFCM,usingthetwohostsabove. 7. Oncethevalidationtoolindicatesthattheconfigurationisvalid,createa failovercluster. 8. AddtwosharedISCSIdiskstothetwohostsusingtheMSISCSIinitiator, onetostoreStorageLinkGatewaydataandtheothertoactasaquorum disk.InitializeandformatthediskswithNTFSononeofthehosts.Bring themonlineontheother.Assignadrivelettertothedriveoneachhost. AddthediskstotheclusterinFCM. 9. ChangequorumsettingsinFCMtobestreflecttheneedsofthe deployment.Werecommendthatthefailoverclusterquorumisbasedon thetwonodesandthesinglequorumdiskcreatedabove. 10. InstallStorageLinkGatewayoneachhost.Iftheservicehasbeenupandin useonahostforawhile,thengoaheadandinstallitontheremaining hostsinthecluster.ShutdownalltheStorageLinkGatewayinstances. Copythedatabasefilecslg.dbfromtheinstalllocationonthemain instancethathasbeenrunningforawhile(oranyofthecslg.dbinstances ifthereisnospecialdatainthere)tothesharedstorage.Youwillhaveto useFCMtomakethesharedstoragevisibleonthehostthatyouwantto dothiscopyoperationon.Edittheregistryoneachhosttopointittothe shareddatabaseand,ifdesired,tothesharedlocationforthelogs. 11. CreateaGenericServiceclusterserviceinFCM.Donotincludetheregistry intheservicesetup(leaveitblank).Addtheshareddatabasediskasa dependencyfortheservice. 12. ControlthelifecycleoftheStorageLinkGatewayserviceusingFCM.

Troubleshooting
HowdoIcollectlogstosendtoCitrixsupport? Beforecollectinglogs,openacommandpromptandsetthetracelevel:

39


REG ADD HKLM\SOFTWARE\Wow6432Node\Citrix\StorageLink\1.0\Server\Trace /v TraceLevel /t REG_DWORD /d 5 net stop StorageLink net start StorageLink

Then,makeadirectoryandcopythelogsthere:
mkdir c:\forCitrix copy c:\Program Files (x86)\Citrix\StorageLink\Server\cslsa_smis_vendor_options.cfg c:\forCitrix c:\ProgramData

IamunabletoaddmyhypervisorhostinStorageLinkManager/CommandLine. MakesurethatyouareconnectingtoaWindows2008server.Checktomakesure thatyouhaveenabledtheHyperVroleonyourserver.(Youwillneedtoreboot theserverafterenablingtheHyperVrole). Alsochecktoensurethatiftheserverispartofthedomain,youareconnectingto itusingtheappropriatedomaincredentials. Finally,makesurethatyouhaveacceptedtheEULAforHyperVbyopeningupthe HyperVManagerGUIandacceptingtheEULAthere. IdonotseemyiSCSIinitiatorsshowupinStorageLinkManager/CommandLine. ThismightbebecausetheiSCSIinitiatorisnotenabledontheserver.Youwill needtologintoyourserverandexplicitlyenabletheiSCSIinitiator.GotoStart> AdministrativeServices>iSCSIInitiator,andansweryeswhenpromptedto enabletheservice. IamnotabletoaddstoragecredentialsformyCIMOM(seeaCIM/SMISclient exception). Checkallthecablingtoyourmachines,switchesandSAN.Youwillneedtoensure thatthereisatleastoneconnectionfromthehosttotheswitchandonefromthe switchtothestoragearray(s).AlsoensurethattheIPaddressandportnumbers oftheCIMOMiscorrect. HowdoIknowthatmyCIMOMisconfiguredcorrectlyforusewithStorageLink? AfteraddingthestoragecredentialsfortheCIMOM,gointotheStorage Infrastructuretab.UnderFabrics,youshouldseeentriesfortheSwitch/Fabric. AlsogointoJobsandlookatthejobentrieswiththetextDiscoveringFabrics. Theseentriesshouldhaveagreencheckboxonthem IgetanerrorcreatingastoragevolumeonStorageLinkManager/CommandLine. Thisismostlikelyaspaceissueonthestoragearray.Manyarraysaresetupwith periodicsnapshotsforstoragevolumesonthearray,andspacefillsuppretty quickly.Also,thedefaultsettingforvolumecreationisTHICKprovisioning,which meansthespaceforthevolumeisreservedonthearray.Havingmanysuch volumescanquicklyeatintotheavailablespaceonthearray WhenIattachmystoragevolumetomyvirtualmachine,Igetanerrorsaying exceededmaxretries Checkthecablingbetweenthehost,switchandstoragearray.Alsocheckthe networkconnectionsandroutesfromthehosttothearray(ifusingiSCSI). LookatthestoragevolumeonthestoragearrayandensurethattheLUNmaps andzonesaresetupcorrectly.IncaseofiSCSIyouwillneedtoensurethatthe

40

 storagevolumeismappedtothecorrecthostinitiator.IncaseofFC,youwillneed tolookattheFCswitchandensurethatthezoneissetupcorrectly. MakesurethatthesettingforprotocolfortheStorageRepository(FC,iSCSI,Auto) matchestheprotocolsettingforthestoragevolume.Bydefault,Autowillmapto FCifthehosthasaFibreChannelportavailable. IamnotabletousemymousetoinstallHyperVinmyvirtualmachine. ThisisaknownproblemwiththeHyperVvirtualmachineconsole.Thisisonlya problemduringtheinstallprocess(whenyouwillneedtousekeyboardonly). AfterinstallingtheIntegrationServicesdisk,themousewillbegintofunction normally.

41

CitrixWorldwide

Worldwideheadquarters CitrixSystems,Inc. 851WestCypressCreekRoad FortLauderdale,FL33309 USA T+18003931888 T+19542673000 Regionalheadquarters Americas CitrixSiliconValley 4988GreatAmericaParkway SantaClara,CA95054 USA T+14087908000 Europe CitrixSystemsInternationalGmbH Rheinweg9 8200Schaffhausen Switzerland T+41526357700 AsiaPacific CitrixSystemsHongKongLtd. Suite3201,32ndFloor OneInternationalFinanceCentre 1HarbourViewStreet Central HongKong T+85221005000 CitrixOnlinedivision 5385HollisterAvenue SantaBarbara,CA93111 USA T+18056906400 www.citrix.com

AboutCitrix CitrixSystems,Inc.(Nasdaq:CTXS)isthegloballeaderandthemosttrustednamein applicationdeliveryinfrastructure.Morethan200,000organizationsworldwiderelyon Citrixtodeliveranyapplicationtousersanywherewiththebestperformance,highest securityandlowestcost.Citrixcustomersinclude100%oftheFortune100companies and98%oftheFortuneGlobal500,aswellashundredsofthousandsofsmall businessesandprosumers.Citrixhasapproximately6,200channelandalliancepartners inmorethan100countries.Annualrevenuein2006was$1.1billion.

2009CitrixSystems,Inc.Allrightsreserved.Citrix,CitrixPresentationServer,CitrixXenServeraretrademarksofCitrixSystems,Inc.and/oroneormoreofitssubsidiaries, andmayberegisteredintheUnitedStatesPatentandTrademarkOfficeandinothercountries.MicrosoftandWindowsareregisteredtrademarksofMicrosoftCorporationin theUnitedStatesand/orothercountries.UNIXisaregisteredtrademarkofTheOpenGroupintheUnitedStatesandothercountries.Allothertrademarksandregistered trademarksarepropertyoftheirrespectiveowners.