– Client System:
- InstalltheTivoliStorageManagerclient orTivoliStorageManager data protectionapplication client,and theTivoliStorageManagerAPI.Specify theLAN-freeoption.
- Installandsetupthestorageagent.
– TivoliStorageManagerServer:
- Configurethelibraryanddrives ontheSAN.
- Definethestorage agentasaserver.
v Step3: StartingthestorageagentandverifyingtheLAN-freeconfiguration – Startthestorageagent.
– VerifytheLAN-freeconfiguration.
Ifyouwillbe usingastorageagentwithexternal librarysupport,youmusthave an externallibrarymanagercapableofexploitingtheexternal libraryinterfaceas definedintheAdministrator’sGuideintheappendix,″ExternalMedia Management
©CopyrightIBMCorp. 2000,2004 29
|
|
|
|
|
|
|
InterfaceDescription.″See Figure6 onpage10for anexampleofastorage agent usinga typicalexternallibraryconfiguration.
Note: YoucanusetheStorageTekLibraryStationtomanagetheenvironment insteadofACSLS.However, LibraryStationisrequiredwhenyouare usinga z/OSdatamanagerserver.
Completethefollowingstepstoconfigureyour storageagentexternallibraryor sharedACSLSlibrarymanagerenvironment.
Step 1. Verifying the Network Connection
The serversystem andtheclientsystemsmust beattached totheSANalongwith appropriate storagedevices.Theserversystemandtheclientsystemsmustalso be connected bymeansofa LAN.
The TivoliStorageManager forStorageAreaNetworksfeature requiresspecific levelsand modelsofhardwareandsoftware.Ensurethatyoursystem
configurationmeetsthehardwareand softwarerequirementsfortheSANsetup.
For moreinformationgotowww.ibm.com/software/sysmgmt/products/
support/IBMTivoliStorageManager.html.
Step 2. Establishing Communications and Configuring the Client, Storage Agent, and Tivoli Storage Manager Server
Figure9 onpage31showstheresultsofcompleting“Step2.1ClientSystem:
InstallingSoftware”onpage31and“Step 2.2IBM TivoliStorageManager Server:
Defining theStorageAgentand ConfiguringDevices”onpage34.Usethisfigure asa referencepointasyouworkthrough thestepsinthis section.
|
|
|
|
|
Step 2.1 Client System: Installing Software
Theproceduresinthis stepdescribeinstallationand configurationoftheTivoli StorageManagerclient,API,andstorage agent.
Note: GreshamEDToranyothermiddlewarethatenablesanexternallibraryis allowed.Forinstallationinformation,seetheGreshamorothermiddleware productdocumentation.
Install or Upgrade the Client and API Software
1. Check thattheclientsystem meetstheprerequisites forclientsoftware.Seethe user’sguidefortheclient.InstalltheclientsoftwareandAPIif itisnotalready installedonthesystem,orupgradethesoftware tothelatestlevelasnecessary.
ThelatestlevelscanbedownloadedfromtheIBMTivoliStorageManagerWeb siteatwww.ibm.com/software/sysmgmt/products/
Tivoli Storage Manager Client Workstation Client - DATAOWNER
Storage Agent - STORAGNT
Tivoli Storage Manager Server - TSMSRVER dsm.sys file
Figure9.Communicationsinformation.ResultsofSteps2.1and2.2.Thepasswordsare shownas″xxxxxxx″becausetheyareencryptedinthefile.
Chapter4.InstallingandConfiguringExternalLibraryEnvironments 31
|
support/IBMTivoliStorageManager.html. Ifyouareusingthestorageagentto supportmultiple clients,youmustinstallorupgrade theclientandAPI softwareoneachclientthatwillbesupported.
2. Besure youhavetheinformationrecordedontheformsin“Configuration InformationWorksheets”onpage13.Thisinformationisrequiredinthis procedure.
3. Modifytheclientoptionsfile(dsm.sys)Forinformationaboutthedsm.optand dsm.sys files,seetheBackup-ArchiveClientsInstallationandUser’sGuide.
a. Locatetheoptionsfileandopenit.Thefilecouldbe locatedinoneof severalplaces,suchastheinstallationdirectory,orpointed tobyan environmentvariable.
b. SpecifytheTivoliStorageManagerservername.Thisinformationwillcome fromtheclientsystemandserversystem configuration-information
worksheets.Forexample:
servername tsmsrver
Keepthefileopenforthenext step.
c. SpecifythecommunicationsmethodbetweentheTivoliStorageManager clientandserver.Again, thisinformationwillcome fromtheclient system andserversystem configuration-informationworksheets,aswillthe informationforthenextsteps. Forexample:
COMMmethod TCPip
TCPServeraddress tsmsrver.tucson.ibm.com TCPPport 1502
Note: ATCPPORT of1502isusedintheexamples;however,thedefault TCPPORTis1500.
Keepthefileopenforthenextstep.
d. Editthedsm.opt filetospecifytheservernameofthedsm.sys stanzaedited instep3b.Forexample,
servername tsmsrver
e. Addthefollowingoptionstothesamedsm.sysstanza editedinstep3b.
TheseoptionsspecifythattheclientwilluseSAN-attacheddeviceswhen thepathisavailable,during backup,restore,archive,and retrieve processing.
enablelanfree yes LANFREECommmethod TCPIP LANFREETCPPORT 1500
or
LANFREECommmethod SharedMem LANFREESHMPORT 1510
Install and Configure the Storage Agent
Note: TheStorageAgentshouldnotbe installedonthesamemachine astheTivoli StorageManagerserver.
On thesamesystemastheclient,install thestorageagent.Thedefaultinstallation directory is/opt/tivoli/tsm/StorageAgent/bin.
1. Besure youhavetheinformationrecordedontheformsin“Configuration InformationWorksheets”onpage13.Thisinformationisrequiredinthis procedure.
2. Loginastherootuser.
3. LoadthestorageagentCDintotheselecteddrive.
4. Enterthefollowingcommandfora listofpackagesthatyoucaninstall:
/usr/sbin/pkgadd -d /cdrom/cdrom0
InthisexampletheCD-ROMnameis/cdrom/cdrom0;yoursmaybe different.
Youcanmakemultipleselectionsat thisstep.Thepackagesare:
TIVsmSsta
Thestorageagentapplicationisinstalled.
TIVsmSdev
Thedevicedriverpackagefornon-IBMdevices isinstalled.
ThePKGADDcommandloadstheselectedfiles.
Notes:
a. Loadingthestorageagentfilescantakeseveralminutes, anditmaytakea fewminutesfortheinstallationtobeginaftertheserverpackagehasbeen selected.
b. Theinstallationprogramautomaticallyinstallsthestorageagentbasedon thelevelofSunSolarisontheinstallationmachine.
5. Enter″y″whenthesystem issuesthismessage:
This package contains scripts which will be executedwith super-user (root) permission during the process of installing thepackage.
Do you want to continue with the installation ofthis package?
6. Enterthefollowingcommandsfroma rootusercommandprompttoejectthe CD,aftertheinstallationiscomplete:
cd / eject cdrom
7. Usetheinformationthatyoucollectedinstep1 toissuetheDSMSTA SETSTORAGESERVERcommand.For example:
dsmsta setstorageserver myname=storagnt mypassword=fun4me myhladdress=agent.tucson.ibm.com
servername=tsmsrver serverpassword=not4u
hladdress=tsmsrver.tucson.ibm.com lladdress=1502
Note: TheTivoliStorageManager server,inthis exampleTSMSRVER,mustbe runningwhentheDSMSTASETSTORAGESERVERcommandisissued.
See“AddingCommunicationInformationfortheStorageAgent”onpage40 fordetailsaboutthecommandparameters.
Chapter4.InstallingandConfiguringExternalLibraryEnvironments 33
Thecommandgeneratesthefollowinglinesin thedeviceconfigurationfilefor thestorageagent:
SET STANAME storagnt SET STAPASSWORD xxxxxxx
SET STAHLADDRESS agent.tucson.ibm.com
DEFINE SERVER tsmsrver serverpassword=xxxxxxxxxxx HLADDRESS=tsmsrver.tucson.ibm.com LLADDRESS=1502
Thepasswords(shown hereasxxxxxxxx)areencryptedinthefile.Savethefile tothesamedirectoryastheexecutableandcloseit.
Thecommandalsogeneratesthefollowinglinein thedsmsta.optfile:
SERVERNAME tsmsrver
See“TheStorageAgentOptionsFile”onpage42and “TheDevice
ConfigurationFilefortheStorageAgent”onpage45fordetailsaboutthese files.
Step 2.2 IBM Tivoli Storage Manager Server: Defining the Storage Agent and Configuring Devices
The followingprovides theinstructions thatyouneedtoperform ontheTivoli StorageManagerserver.Iffurtherexplanationisrequired, seetheAdministrator’s Guide.
1. Ifyouhavenotset upEnterprisemanagement (server-to-server communication)onthisserver,youcandosonowwiththefollowing commands:
set servername tsmsrver set serverpassword not4u
set serverhladdress tsmsrver.tucson.ibm.com set serverlladdress 1502
set crossdefine on
Thesecommandsestablishtheserver’s name,password,and TCP/IPaddress andport,andallowotherserverstodefineaconnection onthis server.Replace theexamplevalueswithvaluesfromtheserverconfigurationinformation worksheet.
Note: TheServerPasswordSetstatusintheQUERYSTATUSoutputmust be equaltoYES.Yousettheserverpasswordbyissuing theSET
SERVERPASSWORDcommandfromaTivoliStorageManager administrativecommandline.Seetheexampleabove.
2. IfyouareusinganACSLS-managedexternallibrary,installGreshamEDTor othermiddlewarethatenablesanexternallibrary.Forinstallationinformation aboutGreshamEDT,seetheGreshamdocumentation.
|
|
|
Note: TheVALIDATEPROTOCOLparameterintheprevious exampleis optional.Thisparameterdetermineswhethera cyclicredundancycheck shouldbe performedtovalidate dataonallmetadatatransferred
betweenthestorageagentandtheTivoliStorageManagerserver.Seethe Administrator’sReferenceforadditionalinformationabouttheDEFINE SERVERcommand.SeetheAdministrator’sGuideforadditional informationaboutdatavalidation.
Thestorageagentmustalso bedefinedtothelibrarymanager.Itneedstobe abletocontact thelibrarymanagerdirectlywhenmakingmountrequests.If thestorageagentisonlydefinedtotheclient,itwillattempttouseinformation fromtheclienttodefineitselftothelibrarymanager.Ifthestorageagentis unabletodefineitselftothelibrarymanager,thestorageagentmustbedefined manuallyusingtheDEFINESERVERcommandissuedfromthelibrary
manager.Forexample:
define server storagnt serverpassword=fun4me hladdress=agent.tucson.ibm.com lladdress=1500
4. Configurea pathtothelibrarymanager.Ifyouneed informationaboutthe commands,seetheAdministrator’sReference.
IfyouareusingasharedACSLSlibrarymanager,configureapathtothe librarymanager.Thisinvolvesthefollowingsteps:
a. DefinealibrarytypeofACSLS.Forexample:
define library libmgr1 libtype=ACSLS shared=YES primarymanager=tsmsrvr
b. Defineapathfromtheservertothelibrarymanager.For example:
define path tsmsrver libmgr1 srctype=server desttype=library c. Defineadeviceclass withadevicetype ofSERVER.Forexample:
define devclass adeviceclassname library=alibraryname devtype=server servername=tsmsrvr
d. Definethestoragepool.For example:
define stgpool apoolname adeviceclassname pooltype=primary
IfyouareusinganACSLS-managedexternallibrary,configureapath tothe external librarymanager.Thisinvolvesthefollowingsteps:
a. DefinealibrarytypeofEXTERNAL. Forexample:
define library stk-lib libtype=external
Notethatif alibrarynameremainsconstantbutthelibrarytypechanges fromEXTERNALtosharedACSLS,thestorage agentmust bestoppedand restartedinorder torecognizethischange.
b. Defineapathfromtheservertotheexternalmanager.Gresham EDT-DistribuTapeistheexternal librarymanager interfacingwith the ACSLSlibrarysoftware.TheEDTexecutableislocatedinitsdefaultpath /opt/OMIdtelm/bin/elm.Forexample:
define path tsmsrver stk-lib srctype=server desttype=library externalmanager=/opt/OMIdtelm/bin/elm
Inthepreviousexample,thepathprovidedfortheexternalmanager dependsontheoperatingsystemwhere theTivoliStorageManagerserver resides.Forexample:
v ALinuxTivoliStorageManagerserverexternalmanagerpathis /usr/dtelm/bin/elm.
v ASunTivoliStorageManagerserverexternal managerpathis /opt/OMIdtelm/bin/elm.
Chapter4.InstallingandConfiguringExternalLibraryEnvironments 35
|
v AWindowsTivoliStorageManagerserverexternal managerpathis c:\programfiles\GES\EDT\bin\elm.exe.
c. Defineadeviceclass withadevicetype ofECARTRIDGE.Forexample:
define devclass adeviceclassname library=alibraryname devtype=ecartridge format=drive
Note: WhenyouareusingStorageTek9840Btapedevices withthez/OS datamanager server,theFORMATattributeofthedeviceclassmust matchthedevicetypeof thetapedrive(thatis,9840B).
d. Definethestoragepool.For example:
define stgpool apoolname adeviceclassname pooltype=primary
5. IfyouareusingasharedACSLSlibrarymanager,definea pathfromthe storageagenttothelibrarymanager.For example:
define path storagnt libmgr1 srctype=server desttype=library
IfyouareusinganACSLS-managedexternallibrary,defineapathfromthe storageagenttotheexternalmanager.GreshamEDT-DistribuTapeisthe external librarymanagerinterfacingwiththeACSLSlibrarysoftware.TheEDT executableislocatedinitsdefaultpath/opt/OMIdtelm/bin/elmFor example:
define path storagnt stk-lib srctype=server desttype=library externalmanager=/opt/OMIdtelm/bin/elm
For additionalinformationabouttheDEFINELIBRARYandDEFINEPATH commands,seetheAdministrator’sReference.
6. Definea copygroupwithitsdestinationbeingtheLAN-freecapablestorage pool(createdinStep4).Forexample:
define copygroup sandirect sandirectpolicy sandirectdefmft type=backup destination=<storage pool name from Step 3>
Thenactivatethepolicyset.Forexample:
activate policyset sandirect sandirectpolicy
Notes:
a. SeetheAdministrator’sGuidefordetailsaboutchangingpolicyforclients thatcanuseSANdrives.For detailsaboutthecommands,seethe Administrator’sReference.
b. Ifyoudecidenottousethedefaultmanagementclass fortheSANdrives, youwillneedtocreatea newmanagementclass.Clients thatwanttouse theSANdrivesneedtouseanincludestatementtobindtheirfiles tothis newmanagement class.See theBackup-ArchiveClientsInstallationand User’s Guidefordetailsabouttheinclude-excludelist.
c. Notethatwithahierarchical storagemanagement (HSM)clientconfigured forLAN-freedatamovement,themanagementclass(notthecopygroup)is settoa LAN-freecapablestorage pool.
7. Ifthenodehasalreadybeen registeredand configuredforLAN-freebackups,
|
TohelpyoutunetheuseofyourLAN andSANresourcesforLAN-freedata movement,youcancontrolthepath thatdatatransferstakeforclients that haveLAN-freedatamovementcapability.For eachclient,youcanselect whetherdataread andwriteoperationsuse:
v TheLAN pathonly v TheLAN-free pathonly v Eitherpath
Beaware thatifthenodebelongstoa multi-threadedclientandthereare drivesavailable, theMAXNUMMPparameter mayrestrictthenumberof drivesthatare availableforthestorageagenttouseonbehalfoftheclient.The MAXNUMMPparameterisspecifiedontheREGISTERNODEorUPDATE NODEcommand.
Step 3. Starting the Storage Agent and Verifying the LAN-free Configuration
Duringthis stepyouwillstartthestorageagentandverify theLAN-free configuration.
Step 3.1 Start the Storage Agent
Startthestorageagentasfollows:
1. Reboottheclientsystem.
2. Changetothestorageagentdirectoryandissuethefollowingcommand:
dsmsta
Step 3.2 Verify the LAN-free Configuration
Toverify thatyouhaveconfiguredyoursystem correctlyforLAN-free data movement,performthefollowingprocedure:
1. Runabackupoperationfromtheclient.VerifythatthebackupisLAN-free by usingaTivoliStorageManageradministrativecommand-lineclienttologinto theTivoliStorageManagerserverandstorageagenttoverifythattheproper sessionshavebeenestablished.WhenLAN-freedatamovementisoccurring, a QUERYSESSIONonthestorage agentshouldshowbytesreceived(displayed asBytesRecvd)forthenodeincreasingtothetotalamount ofdatabeing backedup.TheQUERYSESSIONontheTivoliStorageManagerservershould showaverysmallamountofbytesreceived(metadata)forthesamenode.If thenode’ssessionexhibitsthisbehavior,and youreceiveamessagestatingthat thebackuphasbeensuccessful,youhaveconfigured yoursystemcorrectly.
ThereareseveralwaystousetheQUERYSESSIONcommand.Youcanissue thecommandonthestorageagentconsoleif theprocess isrunninginthe foreground.Or,youcanuseacommand-line clienttoconnecttothestorage agentontheadministrationportofthestorageagent.Youwouldusethesame administratorIDandpasswordfor thiscommandasyouwouldontheserver.
2. Ensurethefollowingifyoureceivea messagesayingthatthebackuphas failed:
a. TheTivoliStorageManagerserverisrunning.IftheTivoliStorageManager serverisnotrunning, thestorage agentwillnotstart.
b. Theclient,storageagent,and serverarecommunicatingwitheachotheras expected.
c. Themountandmessageisdisplayedonthestorageagentconsole.
Chapter4.InstallingandConfiguringExternalLibraryEnvironments 37
|
Notes:
1. Ifyouretrythebackupoperationafterthefirst failure,theclientattemptsto usetheLAN connectionfordatamovement.Theclientwillcontinuetousethe LANuntil theclient isstoppedandrestarted.
2. Whenusingthez/OSdatamanager server,LAN-freeactivity suchasbackup orarchivingrequiresthatthetarget volumebewritten tobytheVersion5.2 z/OSdatamanager servertomeetvolumeselectioncriteria.
Determining Whether the Data Movement was LAN-free
Use thefollowingguidelinestohelpdeterminewhetherthedataismovingonthe LAN-free path:
v MonitortheQUERYSESSIONoutputagainstthenodethatisrunningthe LAN-freebackup.Reviewthebytessentandbytesreceived.Youcanperform thisactionbyusinga TivoliStorageManageradministrativecommand-line clienttologintotheTivoli StorageManager serverand storageagenttoverify thatthepropersessionshavebeenestablished.WhenLAN-freedatamovement isoccurring, aQUERYSESSIONonthestorage agentshouldshowbytes received(displayed asbytesrecvd)for thenodeincreasingtothetotalamount ofdatabeingbackedup.TheQUERYSESSIONontheTivoliStorageManager servershouldshowa verysmallnumberof bytesofmetadatareceivedforthe samenode.Ifthenode’ssession exhibitsthis behavior,thedatamovementis LAN-free.
Note: Duringa failoverwhere thestorage agentissendingdatadirectlytothe serverbyproxybecauseitcannotstore thedatadirectly,theQUERY SESSIONstatisticsontheserverwillshowa muchhigher bytecount.
v IssueeitherofthefollowingQUERYACTLOGcommandsontheserverto whichtheclientisconnected:
query actlog search=storage_agent_name msgno=8337 query actlog search=storage_agent_name
Ifthequeryfindsentriesintheactivitylogthatrelatetothestorageagent,the clientisusingLAN-freedatatransfer.
Appendix A. Administration and Configuration Reference
Thissectionprovides informationaboutadministering,monitoring,tuning,and connecting thestorage agent.
Starting and Stopping the Storage Agent
Thestorage agentcanbe configuredtostartautomaticallyuponsystemreboot.It canalso bestartedandstoppedmanually.Thefollowingisa descriptionofthese tasks.
Automating the Storage Agent Startup
Thestorage agentisconfiguredtostart automaticallyat thetimeofinstallation.An entryismadetotheinittabtoenableautomaticstartup.Scriptsareprovidedinthe storage agentinstallationdirectory thatenable youtomodifytheinittab.The removefrominit scriptallowsyoutoremovetheentryintheinittabthatenables
Thestorage agentisconfiguredtostart automaticallyat thetimeofinstallation.An entryismadetotheinittabtoenableautomaticstartup.Scriptsareprovidedinthe storage agentinstallationdirectory thatenable youtomodifytheinittab.The removefrominit scriptallowsyoutoremovetheentryintheinittabthatenables