You are on page 1of 252

Spectra BlackPearl

Deep Storage Gateway


User Guide

SpectraLogic.com

Copyright
Notices

Trademarks

Part Number
Revision
History

Copyright20142016SpectraLogicCorporation.Allrightsreserved.Thisitemandthe
informationcontainedhereinarethepropertyofSpectraLogicCorporation.
Exceptasexpresslystatedherein,SpectraLogicCorporationmakesitsproductsand
associateddocumentationonanASISBASIS,WITHOUTWARRANTYOFANY
KIND,EITHEREXPRESSEDORIMPLIED,INCLUDINGBUTNOTLIMITEDTO
THEIMPLIEDWARRANTIESOFMERCHANTABILITYORFITNESSFORA
PARTICULARPURPOSE,BOTHOFWHICHAREEXPRESSLYDISCLAIMED.Inno
eventshallSpectraLogicbeliableforanylossofprofits,lossofbusiness,lossofuseor
data,interruptionofbusiness,orforindirect,special,incidentalorconsequential
damagesofanykind,evenifSpectraLogichasbeenadvisedofthepossibilityofsuch
damagesarisingfromanydefectorerror.
Informationfurnishedinthismanualisbelievedtobeaccurateandreliable.However,no
responsibilityisassumedbySpectraLogicforitsuse.Duetocontinuingresearchand
development,SpectraLogicmayrevisethispublicationfromtimetotimewithoutnotice,
andreservestherighttochangeanyproductspecificationatanytimewithoutnotice.
BlackPearl,BlueScale,CC,Spectra,SpectraGuard,SpectraLogic,TeraPack,TFinity,
TranScale,andVerdeareregisteredtrademarksofSpectraLogicCorporation.
ArchiveGrade,ArcticBlue,VerdeDP,andVerdeDPEaretrademarksofSpectraLogic
Corporation.Allrightsreservedworldwide.Allothertrademarksandregistered
trademarksarethepropertyoftheirrespectiveowners.
90990093RevisionH

Revision

Date

Description

October2014

Initialrelease.

January2015

Secondrelease.

February2015

UpdatedfortheBlackPearl1.1release.

May2015

UpdatedfortheBlackPearl1.1.1release.

August2015

UpdatedfornewBlackPearl2.0chassis.

December2015

UpdatedfortheBlackPearl3.0release.

June2016

UpdatedfortheBlackPearl3.2release.

July2016

UpdatedfortheBlackPearl3.2.1release.

Note:

Tomakesureyouhavethemostcurrentversionofthisguidecheckthe
SpectraLogicTechnicalSupportportalat
support.spectralogic.com/documentation/userguides/.
Tomakesureyouhavethereleasenotesforthemostcurrentversionofthe
BlackPearlReleaseNotes,checktheSpectraLogicTechnicalSupportportalat
support.spectralogic.com/documentation/releasenotes/.Youmustsigninto
theportalbeforeviewingReleaseNotes.Thereleasenotescontainupdatesto
theUserGuidesincethelasttimeitwasrevised.

July 2016

User GuideSpectra BlackPearl Gateway

End User
License
Agreement

July 2016

YouhaveacquiredaSpectraLogicBlackPearlDeepStoragegatewaythatincludes
softwareownedorlicensedbySpectraLogicfromoneormoresoftwarelicensors
(SoftwareSuppliers).Suchsoftwareproducts,aswellasassociatedmedia,printed
materialsandonlineorelectronicdocumentation(SOFTWARE)areprotectedby
copyrightlawsandinternationalcopyrighttreaties,aswellasotherintellectual
propertylawsandtreaties.
Ifyoudonotagreetothisenduserlicenseagreement(EULA),donotusetheSpectra
product;instead,promptlycontactSpectraLogicforinstructionsonreturnoftheSpectra
productforarefund.AnyuseoftheSoftware,includingbutnotlimitedtouseonthe
Spectraproduct,willconstituteyouragreementtothisEULA(orratificationofany
previousconsent).
GrantofLicense.TheSoftwareislicensedonanonexclusivebasis,notsold.ThisEULA
grantsyouthefollowingrightstotheSoftware:
YoumayusetheSoftwareonlyontheSpectraproduct.
NotFaultTolerant.TheSoftwareisnotfaulttolerant.SpectraLogichasindependently
determinedhowtousetheSoftwareintheSpectraproduct,andsuppliershaverelied
uponSpectraLogictoconductsufficienttestingtodeterminethattheSoftwareis
suitableforsuchuse.
NoWarrantiesfortheSOFTWARE.TheSoftwareisprovidedASISandwithall
faults.Theentireriskastosatisfactoryquality,performance,accuracy,andeffort
(includinglackofnegligence)iswithyou.Also,thereisnowarrantyagainst
interferencewithyourenjoymentoftheSoftwareoragainstinfringement.Ifyouhave
receivedanywarrantiesregardingtheSOFTWARE,thosewarrantiesdonotoriginate
from,andarenotbindingonSoftwaresuppliers.
NoteonJavaSupport.TheSoftwaremaycontainsupportforprogramswritteninJava.
Javatechnologyisnotfaulttolerantandisnotdesigned,manufactured,orintendedfor
useofresaleasonlinecontrolequipmentinhazardousenvironmentsrequiringfailsafe
performance,suchasintheoperationofnuclearfacilities,aircraftnavigationor
communicationssystems,airtrafficcontrol,directlifesupportmachines,orweapons
systems,inwhichthefailureofJavatechnologycouldleaddirectlytodeath,personal
injury,orseverephysicalorenvironmentaldamage.
NoLiabilityforCertainDamages.Exceptasprohibitedbylaw,Softwaresuppliers
shallhavenoliabilityforanyindirect,special,consequentialorincidentaldamages
arisingfromorinconnectionwiththeuseorperformanceoftheSoftware.This
limitationshallapplyevenifanyremedyfailsofitsessentialpurpose.Innoeventshall
Softwaresuppliers,individually,beliableforanyamountinexcessofU.S.twohundred
fiftydollars(U.S.$250.00).
LimitationsonReverseEngineering,Decompilation,andDisassembly.Youmaynot
reverseengineer,decompile,ordisassembletheSoftware,exceptandonlytotheextent
thatsuchactivityisexpresslypermittedbyapplicablelawnotwithstandingthislimitation.
SoftwareTransferAllowedwithRestrictions.Youmaypermanentlytransferrights
underthisEULAonlyaspartofapermanentsaleortransferoftheSpectraproduct,
andonlyiftherecipientagreestothisEULA.IftheSoftwareisanupgrade,anytransfer
mustalsoincludeallpriorversionsoftheSoftware.
ExportRestrictions.ExportoftheSoftwarefromtheUnitedStatesisregulatedbythe
ExportAdministrationRegulations(EAR,15CFR730744)oftheU.S.Commerce
Department,BureauofExportAdministration.YouagreetocomplywiththeEARin
theexportorreexportoftheSoftware:(i)toanycountrytowhichtheU.S.has
embargoedorrestrictedtheexportofgoodsorservices,whichasMay1999include,but
arenotnecessarilylimitedtoCuba,Iran,Iraq,Libya,NorthKorea,Sudan,Syria,and
theFederalRepublicofYugoslavia(includingSerbia,butnotMontenegro),ortoany
nationaloranysuchcountry,whereverlocated,whointendstotransitortransportthe
Softwarebacktosuchcountry;(ii)toanypersonorentitywhoyouknoworhave
reasontoknowwillutilizetheSoftwareorportionthereofinthedesign,development
orproductionofnuclear,chemical,orbiologicalweapons;or(iii)toanypersonor
entitywhohasbeenprohibitedfromparticipatinginU.S.exporttransactionsbyany
federalagencyoftheU.S.government.YouwarrantandrepresentthatneithertheBXA
noranyotherU.S.federalagencyhassuspended,revokedordeniedyourexport
privileges.

User GuideSpectra BlackPearl Gateway

Contacting Spectra Logic

Contacting Spectra Logic


To Obtain General Information
Spectra Logic Website: www.spectralogic.com
United States Headquarters

European Office

SpectraLogicCorporation
6285LookoutRoad
Boulder,CO80301
USA
Phone: 1.800.833.1132or1.303.449.6400
International: 1.303.449.6400
Fax: 1.303.939.8844

SpectraLogicEuropeLtd.
329DoncastleRoad
Bracknell
Berks,RG128PE
UnitedKingdom
Phone: 44(0)870.112.2150
Fax: 44(0)870.112.2175

Spectra Logic Technical Support


Technical Support Portal: support.spectralogic.com
United States and Canada
Phone:
TollfreeUSandCanada: 1.800.227.4637
International: 1.303.449.0160

Europe, Middle East, Africa


Phone: 44(0)870.112.2185
Deutsch Sprechende Kunden
Phone: 49(0)6028.9796.507
Email: spectralogic@stortrec.de

Mexico, Central and South America, Asia, Australia, and New Zealand
Phone: 1.303.449.0160
Spectra Logic Sales
Website: www.spectralogic.com/shop
United States and Canada
Phone: 1.800.833.1132or1.303.449.6400
Fax: 1.303.939.8844
Email: sales@spectralogic.com

Europe
Phone: 44(0)870.112.2150
Fax: 44(0)870.112.2175
Email: eurosales@spectralogic.com

To Obtain Documentation
Spectra Logic Website: support.spectralogic.com/documentation

July 2016

User GuideSpectra BlackPearl Gateway

Contents
About This Guide

12

INTENDEDAUDIENCE..................................
BLACKPEARLUSERINTERFACESCREENS..................
RELATEDINFORMATION................................
TypographicalConventions .................................
RelatedPublications ........................................

ONLINEFORUM ......................................

Chapter 1 Product Overview


OVERVIEW ...........................................
FEATURES ...........................................
COMPONENTS ........................................
FrontView................................................
RearView .................................................
RearPanel ................................................
FrontViewoftheArcticBlueExpansionNode .................
RearViewoftheArcticBlueExpansionNode..................

BLACKPEARLUSERINTERFACE ..........................
Menus ....................................................
StatusIcons ...............................................
SupportedBrowsers ........................................

Chapter 2 Initial Configuration


BEFOREYOUBEGIN ...................................
CONNECTETHERNETCABLES...........................
POWERONTHEGATEWAY .............................
BlackPearlGatewayandBlackPearlExpansionNodes ..........
BlackPearlGatewaywithArcticBlueExpansionNode...........

CONFIGURETHEBLACKPEARLMANAGEMENTPORT........
LOGINTOTHEBLACKPEARLUSERINTERFACE.............
ENTERACTIVATIONKEYS ..............................
CONFIGURETHEDATACONNECTION.....................
CREATEAUSER ......................................

12
12
12
13
13

14

15
15
16
18
18
20
22
24
25

25
26
29
29

30
30
31
31
31
32

33
34
36
38
40

Contents

VIEWS3CREDENTIALS.................................
NEXTSTEPS ..........................................

42
42

Chapter 3 Understanding Spectra Advanced Bucket


Management Concepts

43

GOALSOFADVANCEDBUCKETMANAGEMENT.............
SPECTRAS3OVERVIEW ................................

44
44

SpectraS3Clients..........................................

45

STORAGEDOMAINS ...................................
DATAPOLICIES .......................................

46
46

DataPersistenceRules ......................................
TapeEjectStrategy.........................................

46
47

TAPEANDDISKPARTITIONS............................

48

TapePartitions.............................................
DiskPartitions .............................................

48
49

EXAMPLECONFIGURATIONS ............................

49

SingleCopyonTape........................................
DualCopyonTape.........................................
SingleCopyonNearlineDisk................................
SingleCopyonNearlineDiskandTape .......................
SingleCopyonNearlineDiskandDualCopyonTape ..........

Chapter 4 Configure Advanced Bucket Management


Settings

50
52
54
56
58

61

CREATEADISKPARTITION.............................
CREATEATAPEPARTITION .............................
CREATEABLACKPEARLTARGET ........................
CREATEASTORAGEDOMAIN...........................
CREATEADATAPOLICY ...............................
CREATEABUCKET ....................................
TRANSFERDATA......................................

62
64
65
67
71
76
78

Chapter 5 Additional Configuration Options

79

CONFIGURESERVICES..................................

80

ConfiguretheSNMPService.................................
ConfiguretheSpectraS3Service .............................

July 2016

User GuideSpectra BlackPearl Gateway

80
82

Contents

CONFIGURENETWORKCONNECTIONSANDSETTINGS.......

85

EdittheSystemName ......................................
ConfigureEthernetPorts ....................................
ConfigureDNSSettings .....................................
ConfigureSMTPSettings....................................
ConfigureDateandTime ...................................

85
86
87
88
90

CONFIGUREUSERS....................................

90

DescriptionofUserTypes ...................................
CreateNewS3Group.......................................
EditaUser................................................
ChangeS3SecretKey .......................................
DeleteaUser..............................................
ChangePasswordandSessionTimeoutSetting ................

91
91
93
95
95
96

CONFIGURECERTIFICATES ..............................
CONFIGUREBUCKETS ..................................

97
98

EditaBucket .............................................. 98
DeleteaBucket ........................................... 100

CONFIGUREDISKPOOLS ..............................
CreateOnlineDiskPool....................................
DeleteOnlineDiskPool ....................................
ImportDiskPool ..........................................

Chapter 6 Working with Tape Libraries


and Media
FORMATTAPES ......................................
INSPECTTAPES......................................
EJECTTAPES ........................................
EditTapeEjectInformation.................................
EjectaSingleTape ........................................
CancelTapeEjection.......................................

IMPORTTAPES.......................................
IMPORTFOREIGNTAPES...............................
MANAGETAPESNOTININVENTORY....................
MarkTapeasEjected......................................
DeleteLostorEjectedTape .................................

PUTATAPELIBRARYPARTITIONINSTANDBYMODE .......
ACTIVATEATAPELIBRARYPARTITION ..................

July 2016

User GuideSpectra BlackPearl Gateway

101
101
101
102

104
105
107
108
108
109
110

111
112
113
113
114

114
115

Contents

Chapter 7 Operating the BlackPearl Gateway


DOWNLOADANOBJECT...............................
CANCELASPECTRAS3JOB............................
MONITORTHEBLACKPEARLGATEWAY ..................
FrontBezelVisualStatusBeacon............................
ConfiguringtheVisualStatusBeaconColor ..................
SystemStatusLEDs .......................................
CheckSystemMessages....................................
ViewtheStatusofHardwareComponents ...................
ViewtheStatusofServices.................................
ViewtheStatusoftheDatabaseandCache...................
ViewBucketContents .....................................
ViewSpectraS3JobsInformation ...........................
ViewTapeMediaInformation..............................
ViewPerformanceMetrics .................................
ViewReports .............................................

DATABASEBACKUP&RESTORE ........................
ManuallyGenerateaDatabaseBackup.......................
CreateaDatabaseBackupSchedule .........................
RestorefromaDatabaseBackup ............................
DeleteBackup............................................
EditBackupDataPolicy....................................
ShowBackupPhysicalPlacement ...........................

MANUALLYSTARTINGTHES3DATAPATHBACKEND......
REBOOTORSHUTDOWNABLACKPEARLGATEWAY .......
UsingtheBlackPearlUserInterface ..........................
PowerCycleReset ........................................

EXITTHEBLACKPEARLUSERINTERFACE .................

Chapter 8 Using the Deep Storage Browser


INTRODUCTION ......................................
REQUIREMENTS ......................................
DOWNLOADTHEDEEPSTORAGEBROWSER ...............
INSTALLANDLAUNCHTHEDEEPSTORAGEBROWSER ......
CONNECTTOABLACKPEARLGATEWAY.................
USINGTHEBROWSER.................................
InterfaceOverview ........................................
CopyaFiletotheGateway .................................
ReadaFilefromtheGateway ...............................

July 2016

User GuideSpectra BlackPearl Gateway

117
118
119
120
121
122
123
124
125
126
127
129
129
131
135
137

138
139
140
143
145
145
146

146
147
147
149

149

150
151
151
151
152
152
154
155
157
157

Contents

Chapter 9 Using AutoSupport

159

ABOUTAUTOSUPPORT ................................
ENTERCONTACTINFORMATION ........................
CONFIGUREMAILRECIPIENTS..........................
AddaNewRecipient ......................................
EditaMailRecipient ......................................
SendaTestEmail .........................................
DeleteaMailRecipient ....................................

LOGSETS ...........................................
ManuallyGenerateLogSets................................
EmailaLogSet ...........................................
DownloadaLogSet.......................................
ConfigureaLogSetSchedule ...............................
DeleteaLogSetorLogSetSchedule .........................

Chapter 10 Maintaining the BlackPearl Gateway


DATAINTEGRITYVERIFICATION........................
ACCESSINGTHETECHNICALSUPPORTPORTAL ............
CreateanAccount.........................................
LogIntothePortal ........................................

CONFIGURINGAUTOMATEDSOFTWAREUPLOAD ..........
UPDATINGSOFTWARE ................................
ChecktheCurrentSoftwareVersion .........................
ChecktheCurrentlyReleasedSoftwareVersion ...............
DownloadandStagetheUpdatedSoftware ..................
InstalltheUpdate.........................................

REPLACINGAFAILEDCOMPONENT .....................
IdentifytheFailedComponent ..............................

Chapter 11 Troubleshooting and Support

160
160
161
161
162
163
164

164
165
166
167
167
168

169
170
171
171
172

173
174
175
175
176
178

179
179

182

RESOLVINGABLACKPEARLMANAGEMENTPORTIPADDRESS
CONFLICT ........................................ 183
UsingtheConsole .........................................
UsingaSeparateComputer.................................

NETWORKSETUPTIPS ................................
Configuration ............................................
ConnectivitytotheNetwork................................
Troubleshooting ..........................................
Tools....................................................

July 2016

User GuideSpectra BlackPearl Gateway

183
183

185
185
186
188
188

Contents

TROUBLESHOOTING ..................................
FAQ...............................................
SPECTRALOGICTECHNICALSUPPORT...................
BeforeContactingSupport .................................
DetermineGatewaySerialNumber ..........................
OpeningaSupportTicket..................................
EnablingRemoteSupport..................................
DisablingRemoteSupport..................................

Appendix A Specifications

206
206
207
211
212

213

DATASTORAGESPECIFICATIONS........................
DriveSpecifications .......................................
GatewaySpecifications ....................................

SYSTEMSPECIFICATION ...............................
SIZEANDWEIGHT .................................
ENVIRONMENTALSPECIFICATIONS ......................
POWERREQUIREMENTS...............................
InputPowerRequirements.................................
PowerCords .............................................

INTERFACESPECIFICATIONS............................
InterfaceConnectors.......................................
NetworkInterfaceCables ..................................
UniversalSerialBus(USB)Support ..........................

Chapter B BlackPearl 1.0 Chassis


Overview & Specifications
COMPONENTS .......................................
FrontView...............................................
RearView ................................................
RearPanel ...............................................

SPECIFICATIONS .....................................
SystemSpecification .......................................
InterfaceSpecifications.....................................

Appendix C Regulatory & Safety Standards


EUDECLARATIONOFCONFORMITY .....................
Certifications.............................................

CEMARKING .......................................
FCCNOTICE ........................................
July 2016

189
197
206

User GuideSpectra BlackPearl Gateway

214
214
215

215
216
217
218
218
219

220
220
220
221

222
223
223
224
225

226
226
227

228
228
229

230
230
10

Contents

SAFETYSTANDARDSANDCOMPLIANCE ..................
WasteofElectronicandElectricalEquipment(WEEE)Directive .
RestrictionofHazardousSubstancesinElectricalandElectronic
Equipment(RoHS).....................................

CONFLICTMINERALSPOLICY ..........................

Appendix D Open Source Code Acknowledgements &


Package List
APACHE............................................
FREEBSD ...........................................
JAVA...............................................
LIKEWISE ...........................................
RUBY ..............................................
RUBYONRAILS......................................
ZFS ...............................................
INCLUDEDPACKAGES ................................

July 2016

User GuideSpectra BlackPearl Gateway

230
230
231

231

232
232
232
233
241
241
242
243
243

11

About This Guide

Thisguidedescribeshowtoconfigure,monitor,andmaintaintheSpectra
BlackPearlDeepStorageGateway,sometimesreferredtoasthegatewayin
theseinstructions.Italsoprovidesproductspecifications.

INTENDED AUDIENCE
Thisguideisintendedfordatacenteradministratorsandoperatorswho
maintainandoperatefilestoragesystems.Theinformationinthisguide
assumesafamiliaritywithcomputingterminologyandwithnetwork
connectivityprotocolssuchasSAS,FibreChannel,andEthernet.Youalso
needtobefamiliarwithinstalling,configuring,andusingdatafilestorage
andarchivalsoftware.

BLACKPEARL USER INTERFACE SCREENS


TheBlackPearluserinterfacechangesasnewfeaturesareaddedorother
modificationsaremadebetweensoftwarerevisions.Therefore,thescreens
youseeintheBlackPearluserinterfacemaydifferfromthoseshowninthis
guide.

RELATED INFORMATION
Thissectioncontainsinformationaboutthisdocumentandother
documentsrelatedtotheSpectraBlackPearlgateway.

12

About This Guide

Related Information

Typographical Conventions
Thisguideusesthefollowingconventionstohighlightimportant
information:
Note: ReadtextmarkedwithNoteforadditionalinformationor
suggestionsaboutthecurrenttopic.

Important

Caution

WARNING

Read text marked by the Important icon for information that help you complete a
procedure or avoid extra steps.
Read text marked by the Caution icon for information you must know to avoid
damaging the gateway, the disk drives, or losing data.

Read text marked by the Warning icon for information you must know to avoid
personal injury.
WARNUNG Lesen Sie markierten Text durch die Warnung-Symbol fr die
Informationen, die Sie kennen mssen, um Personenschden zu vermeiden.

Thisguideusesanarrow(>)todescribeaseriesofmenuselections.For
example:
SelectConfiguration > Network.
means
SelectConfiguration,thenselectNetwork.

Related Publications
ForadditionalinformationabouttheSpectraBlackPearlgatewayandthe
SpectraS3interface,refertothepublicationslistedinthissection.

Spectra BlackPearl Gateway


ThefollowingdocumentsrelatedtotheSpectraBlackPearlgatewayare
availableontheSupportPortalwebsiteatsupport.spectralogic.com,and
fromtheDocumentationscreenontheBlackPearluserinterface.

July 2016

TheSpectraBlackPearlSitePreparationGuideprovidesimportant
informationthatyoushouldknowbeforeinstallingaBlackPearl
gatewayinyourstorageenvironment.

TheSpectraBlackPearlRackMountInstallationGuideprovidesdetailed
instructionsforinstallingtheBlackPearlgatewayinastandardrack.

TheSpectraBlackPearlNetworkSetupTipsdocumentprovideshelpful
instructionsfortroubleshootingcommonconnectivityproblems.

TheSpectraBlackPearlSpectraS3APIReferenceprovidesinformationon
understandingandusingtheSpectraS3API.
User GuideSpectra BlackPearl Gateway

13

About This Guide

Online Forum

ThefollowingdocumentsareavailableafterloggingintoyourSupport
portalaccountat: support.spectralogic.com.

TheSpectraBlackPearlReleaseNotesandDocumentationUpdatesprovide
themostuptodateinformationabouttheBlackPearlgateway,
includinginformationaboutthelatestsoftwarereleasesand
documentationupdates.

TheSpectra12&36DriveChassisBootDriveReplacementGuideprovides
instructionsforreplacingafailedbootdriveinthegateway.

TheSpectra12,36&45DriveChassisDriveReplacementGuideprovides
instructionsforreplacingafaileddatadriveafterthegatewayis
installed.

TheSpectra12,36&45DriveChassisFanReplacementGuideprovides
instructionsforreplacingafailedfaninthegateway.

TheSpectra12,36&45DriveChassisPowerSupplyReplacementGuide
providesinstructionsforreplacingafailedpowersupplyafterthe
gatewayisinstalled.

TheSpectra12DriveChassisHBAReplacementGuideandSpectra36Drive
ChassisHBAReplacementGuideprovideinstructionsforreplacinga
failedHBAinthegateway.

TheSpectra96DriveChassisDriveReplacementGuideprovides
instructionsforreplacingafaileddatadriveintheArcticBlue
expansionnode.

TheSpectra96DriveChassisFanReplacementGuideprovidesinstructions
forreplacingafailedfanintheArcticBlueexpansionnode.

TheSpectra96DriveChassisPowerSupplyReplacementGuideprovides
instructionsforreplacingafailedpowersupplyintheArcticBlue
expansionnode.

TheSpectra96DriveChassisI/OModuleReplacementGuideprovides
instructionsforreplacingafailedI/OmoduleintheArcticBlue
expansionnode.

ONLINE FORUM
NeedhelpwithSpectraLogicsS3softwaredevelopmentkitsorthe
SpectraS3API?PostyourquestionattheSpectraLogicS3SDKdiscussion
forumlocatedat:https://developer.spectralogic.com/forums

July 2016

User GuideSpectra BlackPearl Gateway

14

CHAPTER 1
Product Overview
ThischapterprovidesanoverviewoftheSpectraLogicBlackPearlDeep
StorageGatewayfeaturesandcomponents.
Topic
Overview

page 15

Features

page 16

Components

page 18

FrontView

page 18

RearView

page 20

RearPanel

page 22

FrontViewoftheArcticBlueExpansion
Node

page 24

RearViewoftheArcticBlueExpansion
Node

page 25

BlackPearlUserInterface

page 25

Menus

page 26

StatusIcons

page 29

SupportedBrowsers

page 29

OVERVIEW
TheBlackPearlgatewayallowsdatatomoveseamlesslyintotapestorage
inawaynotpreviouslypossible.Itenablesuserstodeployatierofdeep
storagethatiscosteffective,easytomanage,andscalabletoexabytesof
data.

15

Chapter 1 Product Overview

Features

FEATURES
TheBlackPearlgatewayincludesthefollowingfeatures:
ArcticBlue Expansion Node TheArcticBlueexpansionnode
accommodatesupto96diskdriveswithanactivebezel.Uptoeight
ArcticBlueexpansionnodescanbeconnectedtoaBlackPearl4Ugateway,
whichallowsthegatewaytousetheArcticBlueexpansionnodesasstorage
domaintargets.UptotwoArcticBlueexpansionnodescanbeconnectedto
aBlackPearl2Ugateway.
BlackPearl Expansion Node TheBlackPearl4Uexpansionnode
accommodatesupto44diskdriveswithanactivebezel,and45diskdrives
withapassivebezel.UptoeightBlackPearlexpansionnodescanbe
connectedtoaBlackPearl4Ugateway,whichallowsthegatewaytousethe
BlackPearlexpansionnodesasstoragedomaintargets.Uptotwo
BlackPearlexpansionnodescanbeconnectedtoaBlackPearl2Ugateway.
BlackPearl User Interface TheBlackPearluserinterfaceisusedtoperform
configurationandmanagementtasksontheBlackPearlgateway.Italsolets
youmonitorthehardwareandviewsystemmessages.TheBlackPearluser
interfacealsoprovidesmonitoringandcontrolofsomeaspectsofan
attachedSpectraLogictapelibrary.
Easy Network-Based Administration TheBlackPearlgatewaycanbe
configuredoveranEthernetnetworkusingastandardwebbrowser.
Integration with a Spectra Logic Tape Library FibreChannelandSAS
HBAscanbeinstalledtoprovideconnectivitytoaSpectraLogictape
library.
LTFS Format TheBlackPearlgatewaywithaSpectraLogictapelibrary,
writesdataontapeintheopenLinearTapeFileSystem(LTFS)formatto
ensureyouarealwaysabletoaccessit.
Mirrored Boot Drives Theoperatingsystemishostedontwomirrored
drives.
Rack-Mount Hardware TheBlackPearlchassisaredesignedtomountina
standard4post,19inch(48.3cm)rackusingjust2U(3.5inches,8.9cm)or
4U(7 inches,17.8cm)ofrackspace,dependingonthesizeofthegateway.
RackmountinghardwareisincludedwitheachBlackPearlgateway.
RAID-Protected Data Drives ThebaseBlackPearlgatewayincludestwo
solidstatedriveswhichstorethegatewaydatabase,andtenspinningdisk
driveswhichprovidethegatewayscachingcapacity.Thedrivesare
groupedintovolumeswithdoubleparityprotectionanddataintegrity
verificationtoprotectagainstdatacorruption.
Redundant Hardware ThegatewayfeaturesN+1redundantpower
suppliesanddatadrivesthatarehotswappableforuninterrupted
operation.
July 2016

User GuideSpectra BlackPearl Gateway

16

Chapter 1 Product Overview

Features

Spectra S3 Clients UserscanleveragealibraryofexistingSpectraS3


clientsavailablethroughtheSpectraLogicDeveloperProgram,ordevelop
theirownclient.TheusermovesdatathroughtheclienttotheBlackPearl
gatewayandthenthegatewayhandlesallinteractionwiththetapelibrary.
Spectra S3 Interface TheSpectraS3interfaceisadatatransportand
communicationinterfacethatallowssoftwareclientstodirectandmanage
bulkstoragereadorwriteoperationsofdataobjects.Thefirst
implementationsupportsbulkobjectstorageoperationswithtapefor
accessibilitytothelowestcostmediaoption.
10 Gigabit Ethernet Adualport,10GigabitEthernet(10 GigE)network
interfacecardisinstalledtoprovidehighspeeddataconnectionsbetween
hostsandtheBlackPearlgateway.

July 2016

User GuideSpectra BlackPearl Gateway

17

Chapter 1 Product Overview

Components

COMPONENTS
Thefollowingsectionsshowthelocationsofandbrieflydescribethe
BlackPearlgatewaymajorfrontandrearpanelcomponents.

Front View
Figure 1andFigure 2showthecomponentsonthefrontoftheBlackPearl
gatewayswiththefrontbezelremoved. .
Visual Status Beacon control sled

Power button and


system status LEDs

Latch

Data drive status LEDs

Data drives

Figure 1 The front view of the BlackPearl 4U gateway (front bezel removed).

Visual Status Beacon control sled

Power button and


system status LEDs

Data drive status LEDs

Latch

Data drives

Figure 2 The front view of the BlackPearl 2U gateway (front bezel removed).

July 2016

User GuideSpectra BlackPearl Gateway

18

Chapter 1 Product Overview

Components

Component

Description

Front bezel
(not shown)

Thefrontbezelmountsonthefrontofthechassis,andcontainstheVisual
StatusBeaconlightbar,whichprovidesstatusinformationforthesystem.See
FrontBezelVisualStatusBeacononpage 121formoreinformation.

Visual Status
Beacon control sled

Thedrivesledintheupperleftcornerofthefrontofthechassisprovides
controlfortheVisualStatusBeacon.Adiskdrivecannotbeinstalledinthis
position.

Power button

ThepowerbuttoncontrolsthemainACpowerfortheBlackPearlgateway.

System status LEDs

ThestatusLEDsindicatepowerstatus,diskandnetworkactivity,aswellas
hardwarefaults.SeeSystemStatusLEDsonpage 123formoreinformation.

Data drives

ThebaseBlackPearl4Ugatewayincludesonehighperformancesolidstate
drive,andfivespinningdiskdrivesmountedonindividualdrivesledsinthe
frontofthechassis.Additionaldrivesareinstalledintherearofthechassis.The
BlackPearl2Ugatewayincludestenspinningdiskdrivesandtwohigh
performancesolidstatedrivesinthefrontofthechassis.
ThedrivesledsslideintobaysinBlackPearlenclosureandlockinplace.The
frontofeachdrivesledhasahandleforremovingthesledfromthechassisand
alatchforlockingthedrivesledinplace.

Data drive status


LEDs

TwoLEDsoneachdrivesledindicatethestatusofthedrive.OneLEDisfor
drivestatuswhiletheothershowsdriveactivity.

Empty drive sleds

Emptydrivesledsareinstalledintheunuseddrivebaystoprevent
contaminantsfromenteringtheenclosureandtomaintainproperairflow.

July 2016

User GuideSpectra BlackPearl Gateway

19

Chapter 1 Product Overview

Components

Rear View
Figure 3andFigure 4showthemajorcomponentsontherearofthe
currentchassisoftheBlackPearlgateway.
ForadescriptionofthecomponentsontheBlackPearl1.0chassis,see
Appendix B BlackPearl1.0ChassisOverview&Specificationsonpage
page 222.
Power
supplies

Rear panel

Boot drives

Data drives

Figure 3 The rear view of the BlackPearl 4U gateway.

Rear panel

Power supplies

Boot drives

Figure 4 The rear view of the BlackPearl 2U gateway.

July 2016

User GuideSpectra BlackPearl Gateway

20

Chapter 1 Product Overview

Components

Component

Description

Power supplies

ThestandardBlackPearlgatewayconfigurationincludestwopowersuppliesto
provideN+1redundancyandfailoverprotection.
EachpowersupplyhasitsownACpowerconnector.
EachpowersupplyhasasingleLEDthatlightstoindicatewhenthepoweris
onandfunctioningnormally.

Rear panel

TherearpaneloftheBlackPearlgatewayallowsforEthernet,FibreChannel,
SAS,USB,andotherconnections.SeeRearPanelonpage 22foradetailed
description.

Boot drives

ThebootdrivesprovidestoragefortheoperatingsystemandBlackPearluser
interface.ThebootdrivesintheBlackPearlgatewayarehotswappablewhich
allowsforuninterruptedoperationduringreplacement.

Data drives
(BlackPearl 4U
gateway only)

ThebaseBlackPearl4Ugatewayincludesonehighperformancesolidstate
drive,andfivespinningdiskdrivesmountedonindividualdrivesledsinthe
rearofthechassis.Additionaldrivesareinstalledinthefrontofthechassis.
ThedrivesledsslideintobaysintheBlackPearlenclosureandlockinplace.
Thefrontofeachdrivesledhasahandleforremovingthesledfromthechassis
andalatchforlockingthedrivesledinplace.
Note: TheBlackPearl2Ugatewaydoesnothavedatadrivesintherearofthe
chassis.

Empty drive sleds


(BlackPearl 4U
gateway only)

Emptydrivesledsareinstalledintheunuseddrivebaystoprevent
contaminantsfromenteringtheenclosureandtomaintainproperairflow.

July 2016

User GuideSpectra BlackPearl Gateway

21

Chapter 1 Product Overview

Components

Rear Panel
Figure 5showsthecomponentsontherearpanelofthecurrentchassisfor
theBlackPearl4Uand2Ugateways.
ForadescriptionofthecomponentsontheBlackPearl1.0chassis,see
Appendix B BlackPearl1.0ChassisOverview&Specificationsonpage
page 222.
10GBase-T
Ethernet ports (2)

IPMI management port

Serial
port

USB
ports (4)

BlackPearl
management port

Monitor 10 GigE ports (2)


connector
Optional SAS ports (4)

Expansion
slots

Figure 5 The BlackPearl rear panel components.


Component

Description

IPMI management
port

Notcurrentlysupported.

10GBase-T
Ethernet ports

TheBlackPearlgatewayincludestwo10GBaseTports.Oneofthe10GBaseT
portscanbeusedfornetworkconnectivityona10GBaseTnetwork.Theleft
portofthetwo10GBaseTportsisdedicatedastheBlackPearlmanagement
portandcannotbeusedfordatatransfer.
Notes:
The10GBaseTportsautonegotiatedownto1000BaseT.
SpectraLogicrecommendsusingthe10GigEportsfordatatransferto
ensuremaximumperformance.

Monitor connector

Ifnecessary,youcanconnectamonitortotheSVGAconnectoronthe
BlackPearlgatewayfortroubleshootingpurposes.Onlyconnectamonitorfor
initialconfigurationoftheBlackPearlmanagementport,orasdirectedby
SpectraLogicTechnicalSupport.

10 GigE ports

Thetwo10GigabitEthernet(10 GigE)portscanbeusedfornetwork
connectivityona10GigEnetwork.
Note: SpectraLogicrecommendsusingthe10GigEportsfordatatransferto
ensuremaximumperformance.

July 2016

User GuideSpectra BlackPearl Gateway

22

Chapter 1 Product Overview

Components

Component

Description

SAS ports
(optional)

Dependingonyourconfiguration,theremaybeaSAScardinstalledinan
availableexpansionslot.AfourportSAScardprovidesconnectivitytoSAS
drivesinaSpectraLogictapelibrary,orprovidesconnectivityforuptotwo
BlackPearlexpansionnodes.AtwoportSAScardprovidesconnectivitytoup
totwoArcticBlueexpansionnodes.

Fibre Channel ports


(optional,
not shown)

Dependingonyourconfiguration,theremaybeaFibreChannelcardinstalled
inanavailableexpansionslot.TheFibreChannelcardprovidesconnectivityto
FibreChanneldrivesinaSpectraLogictapelibrary.

Expansion slots

Theexpansionslotsaccommodateoptionalinterfacecardstoprovideadditional
connectivity.Aninstalled10GigabitEthernetnetworkinterfacecardprovides
highspeeddataconnectionbetweenhostsandtheBlackPearlgateway.An
optionalfourportSASorFibreChannelcardprovidesconnectivitybetweenthe
BlackPearlgatewayandtapedrivesinaSpectraLogictapelibrary,orprovides
connectivityforuptotwoBlackPearlexpansionnodes.Anoptionaltwoport
SAScardprovidesconnectivitytouptotwoArcticBlueexpansionnodes.

BlackPearl
management port

TheBlackPearlmanagementportisusedtoconnecttoabrowserbaseduser
interfacetoconfigure,manage,andmonitortheBlackPearlgateway.The
BlackPearlmanagementportcannotbeusedfordatatransfer.

USB ports

Ifnecessary,youcanusetheseportstoconnectaUSBdrive,orUSBkeyboardto
thechassisfortroubleshootingpurposes.OnlyconnectaUSBdriveor
keyboardasdirectedbySpectraLogicTechnicalSupport.

Serial port

Notcurrentlyused.

July 2016

User GuideSpectra BlackPearl Gateway

23

Chapter 1 Product Overview

Components

Front View of the ArcticBlue Expansion Node


Figure 6showsthemajorcomponentsonthefrontoftheArcticBlue
expansionnode.
o

Figure 6 The front view of the ArcticBlue expansion node (Visual Status Beacon removed).
Component

Description

Front bezel
(not shown)

Thefrontbezelmountsonthefrontoftheexpansionnode,andcontainsthe
VisualStatusBeaconlightbar,whichprovidesstatusinformationforthe
expansionnode.SeeFrontBezelVisualStatusBeacononpage 121formore
information.

July 2016

User GuideSpectra BlackPearl Gateway

24

Chapter 1 Product Overview

BlackPearl User Interface

Rear View of the ArcticBlue Expansion Node


Figure 7showsthemajorcomponentsontherearoftheArcticBlue
expansionnode.
o

Fans

SAS connectors

Fans

Power supplies

Figure 7 The rear view of the ArcticBlue expansion node.


Component

Description

Fans

FivehotswappablefansprovidethecoolingfortheArcticBlueexpansionnode.

Power supplies

TheArcticBlueexpansionnodeincludestwopowersuppliestoprovideN+1
redundancyandfailoverprotection.
EachpowersupplyhasitsownACpowerconnector.
EachpowersupplyhasasingleLEDthatlightstoindicatewhenthepoweris
onandfunctioningnormally.

SAS connectors

TherearpaneloftheArcticBlueexpansionnodehastwoSASportsusedto
connectanexpansionnodetoaBlackPearlgateway.

BLACKPEARL USER INTERFACE


TheBlackPearluserinterfaceprovidesbrowserbasedconfiguration,
management,andmonitoringoftheBlackPearlgateway.Thefollowing
sectionsdescribethecommonfeaturesthatappearinallscreensintheuser
interface.

July 2016

User GuideSpectra BlackPearl Gateway

25

Chapter 1 Product Overview

BlackPearl User Interface

Menus
Themenubarappearsalongthetopedgeofeachscreen.Usethemenubar
dropdownmenustonavigatethroughtheinterface.
Menu
bar

Status
bar
Power

Alerts

Figure 8 The Dashboard screen of the BlackPearl user interface.


Thefollowingtableprovidesanoverviewofthescreensavailableunder
eachmenu.
Menu

Available Options

Dashboard

TheDashboardnavigationlinkreturnsyoutotheDashboardscreenfromanyother
screenintheinterface.TheDashboardscreendisplaysthegeneralstatusofthe
gateway,tapecache,andnetworkconnections.Clickinganyofthepanesonthe
Dashboardtakesyoutoadetailsscreenforthatselection.TheDashboardscreenalso
displaysperformancemetricsforthegateway.

July 2016

User GuideSpectra BlackPearl Gateway

26

Chapter 1 Product Overview

BlackPearl User Interface

Menu

Available Options

Configuration

TheConfigurationmenuprovidesaccesstocontrolsforconfiguringallaspectsof
gatewayoperation.
BucketsDisplaysinformationaboutthecurrentlyconfiguredbucketsandlets
youadd,edit,ordeletebuckets.Youcanalsoviewinformationabouttheobjects
containedinabucketandthephysicaltapemediaassociatedwitheachbucket.
Advanced Bucket ManagementDisplaysinformationaboutthecurrently
configuredadvancedbucketmanagementsettings,andletsyouconfigure
partitions,andcreatenewstoragedomainsanddatapolicies.
Database BackupDisplaysinformationaboutanycurrentlygeneratedbackups
onthegateway,aswellasallowsyoutocreatenewbackups,eithermanuallyoron
aschedule.
ServicesDisplaysinformationaboutthecurrentlyconfiguredservicesandlets
youeditexistingservices.
NetworkProvidescontrolsforconfiguringtheEthernetportsontheBlackPearl
gateway,DomainNameServers,dateandtime,aswellasenteringSMTP(Simple
MailTransportProtocol)informationtoallowthegatewaytosendemails.
Mail RecipientsProvidescontrolsforconfiguringmailrecipientaccountsto
receiveemailswhenamessageseveritythresholdisreached,orwhen
AutoSupportLogsets(ASLs)aregeneratedbythegateway.
UsersProvidescontrolsforcreatingnewS3useraccountsthatactasownersfor
buckets,editingtheloginpassword,anddisplayingtheS3credentialsforeach
user.

Status

TheStatusmenuprovidesaccesstothetoolsformonitoringtheBlackPearlgateway
inyourenvironment.
HardwareDisplaysinformationaboutthegateway,itscomponents,andthetape
drivesinstalledintheSpectraLogictapelibrary.Selectingthetabsonthe
Hardwarescreendisplaysdetailedcomponentstatusinformation.
Tape ManagementProvidescontrolsformanagingthetapemediaintheSpectra
LogictapelibraryconnectedtotheBlackPearlgateway.
S3 JobsDisplaysinformationaboutthestatusofallS3jobscurrentlybeing
processedbythesystem.
MessagesDisplayssystemmessagesforthesystem.
PerformanceDisplaysperformancemetricsforthetapecache,individualdrives,
networkconnections,andtheCPUsintheintegratedserver.
ReportsProvidescontrolsforgeneratingreportsabouttheconfigurationand
statusofthegateway.ReportscanbegeneratedinXMLorJSON(JavaScript
ObjectNotation)formats.

July 2016

User GuideSpectra BlackPearl Gateway

27

Chapter 1 Product Overview

BlackPearl User Interface

Menu

Available Options

Support

TheSupportmenuprovidesaccessformaintenanceandtroubleshootingoptionsfor
theBlackPearlgateway.
SoftwareProvidescontrolsforupdatingtheBlackPearlsoftware.
Activation KeysProvidescontrolsforenteringactivationkeys.
LogsDisplaysanycurrentASLsetsonthegatewayandprovidescontrolsfor
generatinganewlogset.
DocumentationDisplaysBlackPearldocumentationthatispresentonthesystem.
Contact InformationDisplayscontactinformationforSpectraLogicTechnical
Support,aswellasthepartandserialnumbersforthegateway.
ToolsDisplaystoolstousefordataintegrityverificationofstoragepools.

Logout

LogsthecurrentuseroutoftheBlackPearluserinterfaceandreturnstothelogin
screen.

TheinformationinthefollowingtablecanbefoundontheStatusbar,
locatedatthebottomofallscreens.
Status Bar

Available Options

Hardware

ProvidesanataglancestatusoftheoverallhealthoftheBlackPearlgateway.
ClickingthislinktakesyoutotheHardwarescreen.

Messages

Displaystheseverity,date,andtimeofthelastinformational,warning,orerror
messagethatwasgenerated.ClickingthislinktakesyoutotheMessagesscreen.
Note: Thislinkdoesnotdisplayiftherearenocurrentsystemmessages.

Power

Providescontrolsforrebootingandshuttingdownthegateway.
Note: Theconnectiontotheuserinterfaceislostafterrunningtherebootcommand.
Waitwhilethegatewayrebootsbeforeattemptingtoreconnecttotheuserinterface.

July 2016

User GuideSpectra BlackPearl Gateway

28

Chapter 1 Product Overview

BlackPearl User Interface

Status Icons
Iconsindicatethestatusofacomponentandthehighestseveritylevelfor
anysystemmessages,asdescribedinthefollowingtable.
Icon

Meaning
ComponentOK Thecomponentisfunctioningcorrectly.
Information Aninformationalmessageaboutasystemcomponentis
available.Checkmessagestodeterminethecomponent.
Warning Asystemcomponentrequiresattention.Checkmessagesto
determinethecomponent.
Error Asystemcomponentexperiencedanerrorcondition.Check
messagestodeterminethecomponentanditserrorcondition.
Unknown Thestatusofasystemcomponentcannotbedetermined.
Checkmessagestodeterminethecomponentanditsstatus.

Supported Browsers
TheBlackPearluserinterfacesupportsthefollowingstandardweb
browsers:
GoogleChromeversion20orlater
MozillaFireFoxversion13orlater
AppleSafariversion5orlater
MicrosoftInternetExplorerversion8orlater
Note: SpectraLogicrecommendsusingGoogleChrometoaccessthe
BlackPearluserinterface.

July 2016

User GuideSpectra BlackPearl Gateway

29

CHAPTER 2
Initial Configuration
ThischapterdescribestheinitialsetupoftheSpectraBlackPearlDeep
StorageGateway,necessaryforoperationinyourenvironment.
Task
BeforeYouBegin

page 30

ConnectEthernetCables

page 31

PowerOntheGateway

page 31

BlackPearlGatewayandBlackPearlExpansion
Nodes

page 31

BlackPearlGatewaywithArcticBlueExpansion
Node

page 32

ConfiguretheBlackPearlManagementPort

page 33

LogIntotheBlackPearlUserInterface

page 34

EnterActivationKeys

page 36

ConfiguretheDataConnection

page 38

CreateaUser

page 40

ViewS3Credentials

page 42

NextSteps

page 42

BEFORE YOU BEGIN


MakesurethegatewayisinstalledinaccordancewiththeSpectra
BlackPearlSitePreparationGuideandtheSpectraBlackPearlRackMount
InstallationGuide.
Additionally,makesureyourSpectraLogictapelibraryisinstalledin
accordancewithitsSitePreparationGuide,availableontheSupportPortal
websiteatsupport.spectralogic.com/documentation.
Note: IfyourBlackPearlgatewaywasinstalledbySpectraLogic
ProfessionalServices,allthestepsinthischapterwere
performedbytheinstaller.PleaseseeNextStepsonpage 42to
beginusingyourBlackPearlgateway.

30

Chapter 2 Initial Configuration

Connect Ethernet Cables

CONNECT ETHERNET CABLES


Beforeproceedingwiththebelowsections,youmustconnectEthernet
cablestothemanagementanddataportsontheBlackPearlgatewayrear
panel.SeeRearPanelonpage 22forthelocationoftheEthernetportson
therearofthegateway.

POWER ON THE GATEWAY


UsetheinstructionsinthissectiontopoweronaBlackPearlgateway,
expansionnode,orArcticBlueexpansionnode.Duringthepoweron
sequence,theBlackPearlgatewayinitializesallofitsinstalledcomponents
andstartstheBlackPearlwebserver.

BlackPearl Gateway and BlackPearl Expansion Nodes


TopoweronaBlackPearlgateway,removethefrontbezelandthengently
pressthepowerbuttononthefrontpanel.ThepowerLEDilluminates
indicatingthatpowerison.SeeSystemStatusLEDsonpage 123formore
information.

Power
button

Power LED

Figure 9 Press the power button.


WaitwhiletheBlackPearlgatewaycompletesitspoweronsequence,
whichtakesapproximately5to10minutes,dependingonthe
configuration.
Note: Donotusethegatewaysfrontpanelpowerbuttontopower
downthegateway.SeeRebootorShutDownaBlackPearl
Gatewayonpage 147.

July 2016

User GuideSpectra BlackPearl Gateway

31

Chapter 2 Initial Configuration

Power On the Gateway

BlackPearl Gateway with ArcticBlue Expansion Node


IfyourconfigurationincludesbothaBlackPearlgatewayandoneormore
ArcticBlueexpansionnodes,powerontheexpansionnode(s)before
poweringonthegateway.TopoweronaArcticBlueexpansionnode,plug
bothpowercablesontheArcticBlueexpansionnodeintopoweroutlets
neartherearofthechassis.TheArcticBlueexpansionnodeimmediately
powerson.Waitapproximatelyfourminuteswhiletheexpansionnode
initializesbeforepoweringonaBlackPearlgateway.
TopoweronaBlackPearlgateway,removethefrontbezel,andthengently
pressthepowerbuttononthefrontpanel.ThepowerLEDilluminates
indicatingthatpowerison.SeeSystemStatusLEDsonpage 105formore
information.

Power
button

Power LED

Figure 10 Press the power button.


Note: Donotusethegatewaysfrontpanelpowerbuttontopower
downthegateway.SeeRebootorShutDownaBlackPearl
Gatewayonpage 147.

July 2016

User GuideSpectra BlackPearl Gateway

32

Chapter 2 Initial Configuration

Configure the BlackPearl Management Port

CONFIGURE THE BLACKPEARL MANAGEMENT PORT


ThedefaultIPaddressfortheBlackPearlmanagementportissetto
10.0.0.2,withanetmaskof255.255.255.0.Ifyournetworkisalreadyusing
thisIPaddress,oryouwanttoconfigureadifferentIPaddressforthe
managementport,usetheBlackPearlconsoletoconfigurethemanagement
portIPaddress.
IfyoudonotwanttochangethedefaultmanagementportIPaddress,skip
toLogIntotheBlackPearlUserInterfaceonpage 34.

Important

You must connect Ethernet cables as described in Connect Ethernet Cables on


page 31 before either proceeding with the steps below or skipping this section and
accepting the default IP address for the management port.

Note: UsingtheBlackPearlconsoleistherecommendedwaytochange
themanagementportIPaddress.Ifyoucannotusetheconsole,
seeResolvingaBlackPearlManagementPortIPAddress
Conflictonpage 183forinformationonalternatemethods.
1. ConnectamonitorandUSBkeyboardtotherearoftheBlackPearl
gateway.SeeRearPanelonpage 22tolocatethemonitorandUSB
connectors.TheConsolescreendisplays.

Figure 11 The Console screen.

July 2016

User GuideSpectra BlackPearl Gateway

33

Chapter 2 Initial Configuration

Log Into the BlackPearl User Interface

2. PressCTRL-N.TheConfigureManagementNetworkInterfacescreen
displays.

Figure 12 The Configure Management Network Interface


screen.
3. SelecteitherDHCPorStaticastheaddressingmethod.
Ifyouselectstaticaddressing,enterthefollowinginformation:

IP AddressEnteravalidIPv4address.

NetmaskEnterthesubnetmask.

Default GatewayEnterthedefaultnetworkgateway.

4. SelectOK.TheconsolescreendisplaysshowingthenewIPaddress.
5. ConnectacablefromyournetworktotheBlackPearlmanagementport
ontheBlackPearlgateway.Youarenowabletoconnecttothe
BlackPearluserinterfacewiththeIPaddressdisplayedinStep 4.
6. DisconnectthemonitorandUSBkeyboardfromtheBlackPearl
gateway.

LOG INTO THE BLACKPEARL USER INTERFACE


1. Openawebbrowseronacomputeronanactivenetworkthathas
accesstothegateway.
2. EntertheIPaddressoftheBlackPearlmanagementportinthebrowser
addressbarusingeitherthedefaultIPaddress,10.0.0.2,ortheIP
addressconfiguredinConfiguretheBlackPearlManagementPorton
page 33.
Note: TheBlackPearluserinterfaceusesasecureconnection.

July 2016

User GuideSpectra BlackPearl Gateway

34

Chapter 2 Initial Configuration

Log Into the BlackPearl User Interface

3. ResolvethesecuritycertificatewarningfortheBlackPearluser
interface.ThewarningdisplaysbecausetheBlackPearlgatewaydoes
nothaveasecuritycertificate.
Notes:

Thiswarningonlyappearsifyoudidnotresolvethesecurity
certificatewarning.

Consultyourbrowserdocumentationforinstructionson
howtoresolvethesecuritycertificatewarning.

Ifyouchoosenottoresolvethewarning,youreceivethe
warningaboutthesecuritycertificateeachtimeyouaccess
theBlackPearluserinterface.

Theabsenceofthecertificatedoesnotaffectfunctionality.

YoucanenterasignedSSLcertificateforthemanagement
portsothatthiswarningdoesnotdisplay.SeeConfigure
Certificatesonpage 97.

4. Entertheprimaryadministratorusernameandpassword.
Thedefaultusernameandpasswordarebothspectra,usingall
lowercaseletters.
Notes:

Onlytheprimaryadministratoraccountcanaccessthe
BlackPearluserinterface.

SpectraLogicrecommendsthatyouchangethedefault
password(seeConfigureUsersonpage 90).

Figure 13 The BlackPearl Login screen.

July 2016

User GuideSpectra BlackPearl Gateway

35

Chapter 2 Initial Configuration

Enter Activation Keys

5. Click> tologin.
Note: Thereisnolimittothenumberofuserswhocanlogintothe
userinterface.SpectraLogicrecommendsonlyonepersonuse
theinterfaceatatimetoavoidconflictingoperations.

Important

The remainder of this guide assumes you are logged in to the BlackPearl user interface.

ENTER ACTIVATION KEYS


ActivationkeysareusedtoenablefeaturesontheBlackPearlgateway.
Activationkeysaretiedtotheserialnumberofthegatewayforwhichthey
areissued,andcannotbeusedonanothergateway.Akeyisvaliduntilits
expirationdate,atwhichtimeanewkeymustberequested.Activation
keysareincludedintheshippingboxwhenyoupurchaseyourgateway.
RenewalsofexpiredactivationkeysareobtainedbycontactingSpectra
LogicTechnicalSupport(seeContactingSpectraLogiconpage 4).

Important

The activation keys must be entered in the order described in these instructions.
Failure to enter the keys in the proper order causes an error.

Usethefollowinginstructionstoenteranactivationkey.
1. SelectSupport > Activation Keys todisplaytheActivationKeysscreen.
Anypreviouslyenteredkeysarelisted.
Note: TheBlackPearlwebinterfacedisplaystheVerdelogoand
interfacedesign.TheinterfacechangestotheBlackPearllogo
andfunctionalityafteryouenterallactivationkeysprovidedin
theshippingbox.

Figure 14 The Activation Keys screen.

July 2016

User GuideSpectra BlackPearl Gateway

36

Chapter 2 Initial Configuration

Enter Activation Keys

2. SelectAction > New.TheEnterActivationKeydialogboxdisplays.

Figure 15 The Enter Activation Key dialog box.


3. Locatethecapacitykey(s)listedontheSoftwareActivationKey
Certificateincludedinyourshippingbox.Therearefourtypesof
capacitykeys.
Key Type

Description

EM_S3_SAS_COUNT

EnablesthespecifiednumberofSASdrives
presentintheBlackPearlgatewayorBlackPearl
expansionnode.

EM_S3_SATA_COUNT

EnablesthespecifiednumberofSATAdrives
presentintheArcticBlueexpansionnodes.

EM_S3_SSD_COUNT

EnablesthespecifiednumberofSSDdrives
presentintheBlackPearl4Ugateway.

EM_S3_TAPE_COUNT

Enablesthespecifiednumberoftapeslotspresent
intheattachedSpectraLogictapelibrary.

4. Enterthekey,exactlyasprovided,intheActivationKeyfieldandclick
Createtosavethekeyonthegateway.TheActivationKeysscreen
displayswiththenewlyenteredkeylisted.
5. Ifnecessary,repeatStep 2throughStep 4toaddadditionalkeys.
6. LocatetheproductkeylistedontheSoftwareActivationKeyCertificate
includedinyourshippingbox.Thereisonlyonetypeofproductkey
fortheBlackPearlgateway.
Key Type

Description

EM_S3

EnablesthegatewaytousetheBlackPearl
interfaceandfunctionality.

Note: Youmustenterthecapacitykey(s)beforeenteringtheproduct
key.
7. Enterthekey,exactlyasprovided,intheActivationKeyfieldandclick
Createtosavethekeyonthegateway.TheBlackPearlwebinterface
changestoreflecttheinstallationoftheproductkey.
8. EnteranyadditionalkeysthatmaybeincludedontheSoftware
ActivationKeyCertificate,suchastheSoftwareUpdatekey.
July 2016

User GuideSpectra BlackPearl Gateway

37

Chapter 2 Initial Configuration

Configure the Data Connection

CONFIGURE THE DATA CONNECTION


ThissectiondescribesusingtheBlackPearluserinterfacetoconfigurethe
dataconnectionfortheBlackPearlgateway.Thegatewayincludestwo
10GBaseTports,andtwo10GigEportsontherearpanel(seeFigure 5on
page 22).
Notes:

Youcanonlycreateonedataconnectiontothegateway.You
canconfigurelinkaggregationforbetterperformance.
YoucanonlyusetheBlackPearlmanagementporttoaccess
theBlackPearluserinterface.Youcannotusethisportfor
datatransfer.
1. Fromthemenubar,selectConfiguration > Network,orselectthe
NetworkpanefromtheDashboardscreen.TheNetworkscreen
displayswithinformationaboutthenetworkconnectionsofthe
gateway.

Figure 16 The Network screen.

July 2016

User GuideSpectra BlackPearl Gateway

38

Chapter 2 Initial Configuration

Configure the Data Connection

2. DoubleclicktheDatarowintheNetworkInterfacespane,orselectthe
DatarowandselectAction > Editfromthemenubar.TheEditData
Portsdialogboxdisplays.
Note: Dependingonyourhardwareconfiguration,theEditDataPorts
dialogboxmaylookdifferentthanwhatisshownbelow

Figure 17 The Edit Data Ports dialog box.


3. Clicktheoptionbuttonforthedatainterfaceyouwanttoconfigure.
Youcanonlyconfigureoneinterface.
TheAggregate All interfacetype optionsallowyoutoconfigurealink
aggregationusingalltheportsofthatinterfacetype.Linkaggregation
usesmultipleEthernetports,configuredwithasingleMACaddress,to
improvedatatransferspeeds.SeeLinkAggregationNotesonpage 186
formoreinformation.
4. SelecteitherDHCPorStaticastheaddressingmethod.
Ifyouselectstaticaddressing,clickthe+ buttonandenterthefollowing
information:

IP AddressEnteravalidIPv4address.

NetmaskEnterthesubnetmask.

Note: Ifdesired,youcanenterAliases,multipleIPandNetmask
addressesassignedtothedataport.Usethe+ buttonatthe
bottomoftheEditDataPortsdialogboxtoincreasethenumber
ofIPandNetmaskaddresses.Amaximumof16additionalIP
andNetmaskaddressescanbeconfigured.
5. EntertheDefault Gateway.
6. ChangetheMTU(MaximumTransmissionUnit)value,ifdesired.Ifyou
settheMTUvaluetosomethingotherthan1500,ensurethatyour
switchconfigurationsupportslargerMTUsettings,aswellasallthe
hostsonthenetwork.
7. ClickSave.
July 2016

User GuideSpectra BlackPearl Gateway

39

Chapter 2 Initial Configuration

Create a User

CREATE A USER
Usetheinstructionsinthissectiontocreateusers,whichactasS3users
wheninteractingwiththeBlackPearlgatewaythroughaSpectraS3SDK
(SoftwareDevelopmentKit)client,orSpectraS3API.Eachuserhasa
uniqueS3AccessIDandSecretKey.
Note: UsersarenotabletologintotheBlackPearluserinterface.Only
theprimaryadministratoraccountcanlogintotheinterface.You
cannotcreateadditionaladministratoraccounts.
1. Fromthemenubar,selectConfiguration > Users. TheUsersscreen
displays.

Figure 18 The Users screen.


2. SelectAction > New fromthemenubar.TheNewUserdialogbox
displays.

Figure 19 The New User dialog box.


July 2016

User GuideSpectra BlackPearl Gateway

40

Chapter 2 Initial Configuration

Create a User

3. EntertheusersFull Name.
4. EnterthedesiredUsernamefortheuser.TheUsernamecannotcontain
capitallettersorspaces.TheUsernameisusedtoidentifytheuserin
theSpectraS3environment.
5. EnteranEmailaddressfortheuser.
Note: Whileavalidemailaddressisrequired,thegatewaydoesnot
usethissettingforanypurposeatthistime.
6. Fromthedropdownlist,selectaRolefortheuser.
Note: YoucanonlyconfigurenewuserswitharoleofUseratthistime.
7. Fromthedropdownlist,selectaDefault Data Policyfortheuser.If
specified,thegatewayusestheselecteddatapolicyforallbuckets
createdbytheuser,unlessadifferentpolicyisspecifiedduringbucket
creation.
8. SelectorclearoptionsfortheGlobal Bucket Access Control List.These
optionsgiveordenypermissionfortheuserbeingcreatedtoperform
theactiondescribedinthetablebelow,forallbucketspresentonthe
gateway,aswellasanybucketscreatedatafuturedate.
Name

Description

List

Theusercanseethebucketandcanlisttheobjectsina
bucket.

Read

TheusercangetobjectsandcreateGETjobs.

Write

TheusercanputobjectsandcreatePUTjobs.

Delete

Theusercandeleteobjects,butcannotdeletethebucket.

Job

Theusercanmodifyorcanceljobscreatedbyotherusers.
Theusercanalsoseethedetailsofjobscreatedbyother
users.
Note: Alluserscanviewalljobs,butbydefault,only
theinitiatorofthejobcanseethefulldetailsofajob.

Owner

Theuserreceivesfullaccesstoallbuckets,includingall
permissionslistedabove.

9. Ifdesired,underGlobal Data Policy Access Control List,selectthecheck


boxtoallowtheuseraccesstoanydatapolicycreatedonthegateway.
10. ClickCreatetocreatethenewuser.ThegatewaygeneratesauniqueS3
AccessIDandSecretKeyfortheuser.
11. Ifdesired,repeatStep 2throughStep 10tocreateadditionalusers.

July 2016

User GuideSpectra BlackPearl Gateway

41

Chapter 2 Initial Configuration

View S3 Credentials

VIEW S3 CREDENTIALS
UsetheinstructionsinthissectiontoviewtheS3credentialsofauser.
1. Fromthemenubar,selectConfiguration > Users. TheUsersscreen
displays(seeFigure 18onpage 40).
2. SelecttheuserforwhichyouwanttoviewtheS3credentialsfromthe
UserpaneoftheUsersscreen,andthenselectAction > Show S3
Credentials.TheS3Credentialsdialogboxdisplays.

Figure 20 The S3 Credentials dialog box.


3. UsetheS3 Access IDandS3 Secret KeytoaccesstheBlackPearlgateway
usingaSpectraS3client,orSpectraS3API.

NEXT STEPS
TheBlackPearlgatewaynowhasthenecessarycomponentsconfiguredto
begindesigningyourstoragearchitecture.Continuewithoneofthe
followingsteps:

July 2016

SeeUnderstandingSpectraAdvancedBucketManagementConcepts
onpage 43forinformationaboutSpectraS3andAdvancedBucket
Managementconceptsyouneedtounderstandbeforeyoubegin
designingthestoragearchitectureoftheBlackPearlgateway.

SeeAdditionalConfigurationOptionsonpage 79forinformationabout
theadditionaloptionsthatcanbeconfiguredontheBlackPearl
gateway.

SeeOperatingtheBlackPearlGatewayonpage 117forinformation
aboutdaytodaymonitoringandoperationofthegateway.

SeeUsingAutoSupportonpage 159tosetupAutoSupporttocollect
andemaillogsets.

SeeMaintainingtheBlackPearlGatewayonpage 169formaintenance
optionsforthegateway.

User GuideSpectra BlackPearl Gateway

42

CHAPTER 3
Understanding Spectra Advanced
Bucket Management Concepts
ThischapterexplainstheconceptsoftheBlackPearlgatewayadvanced
bucketmanagement.Itisimportanttounderstandtheinformationinthis
chapterbeforeyoubegindesigningthestoragearchitectureofthe
BlackPearlgateway.
Task
GoalsofAdvancedBucketManagement

page 44

SpectraS3Overview

page 44

SpectraS3Clients

page 45

StorageDomains

page 46

DataPolicies

page 46

DataPersistenceRules

page 46

TapeandDiskPartitions

page 48

TapePartitions

page 48

DiskPartitions

page 49

ExampleConfigurations

page 49

SingleCopyonTape

page 50

DualCopyonTape

page 52

SingleCopyonNearlineDisk

page 54

SingleCopyonNearlineDiskandTape

page 56

SingleCopyonNearlineDiskandDualCopyon
Tape

page 58

43

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Goals of Advanced Bucket

GOALS OF ADVANCED BUCKET MANAGEMENT


TheBlackPearlgatewayprovidesanS3frontendinterfacetodeepstorage
diskandtape.TheBlackPearlAdvancedBucketManagement(ABM)
featureautomatesmanyaspectsofdeepstorageincludingpolicybased
multiplecopiesondiversemediatypeswithouttheneedforexpensive
middlewaretooperatethelibrariesandstreamdatatotapedrives.The
BlackPearlgatewaydeliversseamlessdatamanagementenablinginfinite
retention,seamlessgrowth,andunlimitedretrievalofdataforaslowas
penniesperGigabyte.

SPECTRA S3 OVERVIEW
TheBlackPearlDeepStorageGatewayallowsdatatomoveseamlesslyinto
deepstorageinawaynotpreviouslypossible.SpectraS3isthefirstnative
RESTbasedinterfacetodeepstoragewhichenableseasyarchivingoflarge
amountsofbulkdata.Itenablesuserstodeploytape,nearlinedisk,and
onlinediskstoragethatiscosteffective,easytomanage,andscalableto
exabytesofdata.
SpectraS3utilizesthestandardAmazonS3operationsplusadditional
operationsspecificallydesignedtooptimizethetransportofdataobjectsto
andfromdeepstorage.Theadditionaloperationsdefinethejobsothatthe
BlackPearlgatewayinteractswiththeobjectsefficientlyanddefinethedata
policytocustomizewhereandforhowlongspecificdataisstored.
ThefirstoftheseadditionaloperationsiscalledSTARTBULKPUT.Itisan
HTTPPUToperationthatprovidestheBlackPearlgatewaywith
informationabouttheobjectsthattheclientwantstosendasasinglejob
forstoringontape.TheCreateBulkPutcommandissentwithapayload
thatismadeupofalistofobjectnamesandcorrespondingobjectsizes.
ThisinformationallowstheBlackPearlgatewaytoplantheinitialstorage
oftheobjectsinitscache,andhowitwillstorethedataontape.The
responsetotheCreateBulkPutcommandisaspecificallyorderedlistof
howtheBlackPearlgatewaywantsthosefiles(objects)sent.
ThesecondcommandiscalledCreateBulkGet.TheCreateBulkGet
commandisactuallyanHTTPPUTcommandbecauseittoocontainsa
payloadfortheBlackPearlgateway.Thispayloadisalistofobjectsthatthe
clientwantstogetfromtheBlackPearlgateway.Itisnotnecessaryforthe
requestpayloadtocontainthesizeofthefilesbecausetheBlackPearl
gatewayalreadyknowsthesizesoftheobjects(files).Theresponsetothe
requestisagainanorderedlistoftheobjectsandinformationaboutthe
objects,includingiftheyarealreadyinthecacheandreadytoberetrieved
fromcachebyaGETcommand.

July 2016

User GuideSpectra BlackPearl Gateway

44

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Spectra S3 Overview

Knowingthefilesthattheclientwantstoretrieve,theBlackPearlgateway
canmakethebestuseofitsresourcesinretrievingtheobjects.For
example,ifthelistofobjectsspansacrossfourdifferenttapesandthereare
fourtapedrivesavailable,thosefourtapescanallbeloadedintodrives
andtheobjectscanbereadbackinparallel,greatlyimprovingthespeedat
whichtheclientcangetalloftheobjects.WithouttheCreateBulkGet
request,theclientwouldbeaskingtheBlackPearlgatewayforthoseobjects
inalessefficientmanner.
Storinglargeamountsofbulkdataontapehashistoricallypresented
challenges.SpectraS3addressesthesechallenges:

Tapedrivesaresequentialblockstoragedevices,withdatalaidoutina
sequentialmanneralongthefulllengthofthetape.Thismakesit
inefficienttoretrievedataoutoforder.SpectraS3plansandqueuesa
largeamountofdatatobeefficientlywrittentotape;itlogicallygroups
dataontapeinawaythatreflectshowtheclientislikelytoreaditback.

Becauseofthemechanicalnatureofthetapemediaanddrives,tape
drivesdemandalargeamountofdatatobeavailable,viaafast
connection.Whendataisnotefficientlystreamedforthetapedrivesto
write(duetoslowdatabufferingoraslowconnectiontothedrive),the
resultispoorwriteperformance.Thispoorperformanceisduetoa
phenomenonreferredtoasshoeshining.Whenadriveissentasmall
amountofdata,itwritesthedataandthenisforcedtostop.Becausethe
tapecannotstopinstantaneously,thedriveovershootsasmallamount
andthetapeisnotinpositionforthenextwriteoperation.To
compensate,thetapedriverewindstogetbacktothecorrectposition
forthenextwrite.Ifthenextwritealsohasasmallamountofdata,then
thedrivewritesthenextportionandagainstops,overshoots,and
rewinds,causingabackandforthshoeshininglikeaction.SpectraS3
cachesdataontheBlackPearlDeepStorageGatewaybeforestartingthe
transfertotape,whichpreventstheshoeshiningbehaviorfrom
occurring.

Classically,differenttapestoragedeviceswrotedatatotapeinunique
ways,lockingyouintoaproprietaryandsinglevendorsolutionto
retrievepreviouslywrittendata.SpectraS3writesdatatotapeusing
theopensourceLinearTapeFileSystem(LTFS).WithLTFS,datais
alwaysaccessiblewithanyLTFSenabledsystem.

FormoreinformationontheSpectraS3interface,seetheSpectraBlackPearl
SpectraS3APIReference.

Spectra S3 Clients
UserscanleveragealibraryofexistingSpectraS3clientsavailablethrough
theSpectraLogicDeveloperProgram,ordeveloptheirownclient.The
usermovesdatathroughtheclienttotheBlackPearlgatewayandthenthe
gatewayhandlesallinteractionwiththedatastoragehardware.

July 2016

User GuideSpectra BlackPearl Gateway

45

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Storage Domains

STORAGE DOMAINS
Astoragedomainisacollectionofdatapartitionsand,whenapplicable,
mediatypecombinations.Storagedomainsdefinethepossibleplaces
wheredatasenttotheBlackPearlDeepStorageGatewaycanbestored.
Datapersistencerulesanddatapoliciesfurtherdefinewhereandforhow
longspecificdataisstored.
Entiredatapartition/mediatypecombinationsaremembersofstorage
domains.Whenadditionalcapacityisrequired,asinglestoragepoolor
tapeisallocatedoutofthememberdatapartitionstofulfillthecapacity
requirement.

DATA POLICIES
Adatapolicydefinesdataintegritypolicies(checksumtypeandendto
endCRCrequirements),defaultjobpriorities,anddatapersistencerules,
whichdefinewheredatashouldbewrittenandforhowlongitshouldbe
kept.Adatapolicymaybeusedbymultiplebuckets,butabucketuses
preciselyonedatapolicy.
Adatapolicyconsistsofoneormorepermanentpersistencerules,zeroor
moretemporarypersistencerules,andzeroormoreretiredpersistence
rules.Apersistencerulecanbepermanent,meaningthatdataiskeptinthe
specifiedstoragedomainatalltimes,ortemporary,meaningthatdatais
keptinthespecifiedstoragedomainundercertaincircumstances,andthen
itcanbedeletedfromthatstoragedomain.Existingpermanentand
temporarypersistencerulesmayberetiredsothattheruleisnotapplied
foranynewincomingdata,butcontinuestoretaindatapreviously
written.

Data Persistence Rules


Eachdatapolicymusthaveoneormorepermanentpersistencerules.Each
persistenceruletargetsaspecifiedstoragedomain.Therearethreetypesof
persistencerules:

PermanentAcopyofthedataisplacedinthespecifiedstorage
domaininitiallyandmaintainedtherepermanently.

TemporaryAcopyofthedataisplacedinthespecifiedstorage
domaininitiallyandmaintainedthereatleastuntilthespecified
retentionperiodexpires.

RetiredTheruleisnotappliedforanynewincomingdata,but
continuestoretaindatapreviouslywritten.

Dataiswrittentoeverystoragedomainforwhichthereisapersistence
rulewiththetypeconfiguredaspermanentortemporary.
July 2016

User GuideSpectra BlackPearl Gateway

46

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Data Policies

Thesamestoragedomaincannotbespecifiedmultipletimesusing
differentpersistencerulesinthesamedatapolicy.Thesamestorage
domaincanbereferredtoacrossdifferentdatapolicies.
Datapersistencerulesmustspecifythelevelofphysicalisolationrequired
forthedataretention.Therearetwotypesofdataretention:

StandardDataisisolatedaccordingtothestandardstorage
domainisolationrequirements.Whenmorestorageisneeded,a
tapeorpoolisassignedtothestoragedomain.Anybucketsusing
thatstoragedomaincanhavedataonthepoolortape,whichcan
makeitdifficulttoejectallofthetapesforasinglebucket.

Bucket IsolatedDatafromdifferentbucketscannotbemixedon
thesamephysicalstoragemedia.

Notes:

TheStandardisolationlevelprovidesthebestcapacity
utilizationandoverallperformance.
Bucket Isolatedallocatesanentiretapeorpooltoabucket
whenneeded.Allocatinganentirepooltoabucketmayuse
upresourcesquicklyandisnotrecommended.

Tape Eject Strategy


Atapeejectstrategymustbeconsideredaspartofadatapolicy.Spectra
recommendskeepingatleastonecopyofallarchiveddatainthelibraryat
alltimes.Librariescanbeeasilyupgradedbypurchasingmoreslot
licenses,or,iftheslotsbecomecompletelyfull,upgradingthelibraryitself
toonewithmoreslotsusingtheexclusiveSpectraTranScaletechnology.
Atapelibraryuseroradministratormaydecidetoejectmediacartridges
fromatapelibraryforanyofthereasonsdescribedbelow:

July 2016

Ejectingacopyforoffsitedisasterrecovery:TheBlackPearlgateway
allowsausertomakemultiplecopiesofdataautomatically.Atypical
usecaseistocreateatapefirstcopythatisintendedtobeleftinthe
libraryforeasyretrievalaswellasanejectcopyintendedtobe
removedfromthelibraryoncefullforarchivalatanalternatesitefor
safety.SeeConfigureAdvancedBucketManagementSettingson
page 61forinformationonsettingupmultiplecopiesandejectinga
copy,andtheTapeLibraryUserGuidefordetailsonthephysicalprocess
ofexportingandimportingtapesintothelibrary.

Ejectingacopyofdatafortransfertoanotherlocation:Insome
workflows,auserejectsatapetotransferthedatatoanotherfacility.
IndividualtapescanbeejectedmanuallyusingtheBlackPearluser
interface(seeEjectTapesonpage 108).

User GuideSpectra BlackPearl Gateway

47

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Tape and Disk Partitions

Ejectingtapestofreeupspaceinthelibrary:Someworkflowsand
budgetsrequireolderorunusedmediatobeejected,makingitnot
readilyavailabletotheBlackPearlgateway,inordertofreeupspacein
thetapelibrary.Aftertapesareexported,newtapesareimportedto
providetheBlackPearlgatewaywithnewmediaforstorageoperations.

TAPE AND DISK PARTITIONS


Tapeanddiskpartitionsareexternaldatastoragetargetscabledtothe
BlackPearlgatewaythroughSASorFibreChannelconnections.Once
created,partitionsareassignedtostoragedomains.

Tape Partitions
TapepartitionsrefertodatapartitionsconfiguredonSpectratapelibraries.
WhenyoucreateapartitiononatapelibraryattachedtoaBlackPearl
gateway,thegatewayautomaticallydetectsthetapelibrarypartitionand
addsittothelistofavailablepartitionsintheBlackPearluserinterface.The
gatewayalsoautomaticallycreatestwocommonlyusedstoragedomains:
tapefirstcopy,andtapesecondcopy.Formoreinformationonstorage
domains,seeStorageDomainsonpage 46.
Notes:

July 2016

CleaningpartitionsarenotaddedtotheBlackPearluser
interface.

TapedrivecleaningistypicallyhandledbytheSpectratape
library.Formoreinformationoncleaningthelibrarytape
drivesusingthetapelibrary,seeyourlibraryUserGuide.

TapedrivecleaningcanbeinitiatedthroughtheSpectraS3
API.SeetheSpectraBlackPearlSpectraS3APIReferencefor
moreinformation.

Tapedrivecleaningcannotbeinitiatedthroughthe
BlackPearluserinterface

User GuideSpectra BlackPearl Gateway

48

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Disk Partitions
DiskpartitionsarecomprisedofstoragepoolsonexternalSASexpansion
nodes.Therearetwotypesofdiskpartitions.Onlinediskpartitionsare
createdonSpectraBlackPearlexpansionnodes,whileNearlinedisk
partitionsarecreatedonSpectraArcticBlueexpansionnodes.

OnlineOnlinestorageusingBlackPearlexpansionnodesisused
asatemporary,highperformancestoragetargetforhighly
transactionaldata.

NearlineNearlinestorageusingArcticBlueexpansionnodesisa
costeffectivestoragetargetfordeepstorage.Nearlinestorageisnot
recommendedforfrequentreadsorwrites.

NearlinestoragepoolsontheArcticBlueexpansionnodeareautomatically
createdbytheBlackPearlgatewaywhenthegatewaydetectsasufficient
numberofdisksforanewstoragepool,andthereisacapacitykey
installedonthegatewaytolicensetheadditionalstoragespace.Online
storagepoolsaremanuallycreatedusingtheBlackPearluserinterfaceafter
youattachaBlackPearlexpansionnode(seeCreateOnlineDiskPoolon
page 101).
Oncestoragepoolsarecreated,youmustmanuallyaddthemtodisk
partitions.Forinformationoncreatingadiskpartition,seeCreateaDisk
Partitiononpage 62.

EXAMPLE CONFIGURATIONS
Belowareexplanationsofthepreconfigureddatapoliciesonthe
BlackPearlgateway,whichincludedatapersistencerulesandstorage
domaintargets.
Note: Forinformationonadditionaldatapolicysettingsthatarenot
availablethroughtheBlackPearluserinterface,seetheSpectra
BlackPearlSpectraS3APIReference.

July 2016

User GuideSpectra BlackPearl Gateway

49

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Single Copy on Tape


Thisdatapolicyisthemostbasicofthepreconfigureddatapoliciesonthe
gateway.Thispolicycreatesasinglecopyofeachobjectsenttothegateway
ontapemedia.Oncedataiswrittenontape,itisremovedfromthe
BlackPearlcacheifthegatewaydetectsthatmorecachespaceisneededfor
incomingdata.
Note: Thisdatapolicyisautomaticallycreatedwhenthegateway
detectsatapepartition.

Figure 21 The Single Copy on Tape workflow.


Thesinglecopyontapedatapolicyisconfiguredwiththefollowing
attributes:
Parameter

Value

Description

Storage Domain

Tape First Copy

Dataiswrittentotheprimarytapestoragedomain.
Note: Thisdomainiscreatedautomaticallywhenthe
gatewaydetectsthefirsttapepartitioncreatedonthe
tapelibrary.

Data Persistence
Rule

Permanent

Dataismovedtotapeandmaintainedontapemedia
untildataisdeletedfromabucket.
Note: Whendataisdeletedfromabucket,itisremoved
fromtapemedia,butindividualtapemediacartridges
arenotreclaimedforuseuntilalldataisdeletedfroma
tapecartridge.

Bucket Isolation
Level

Standard

Datafromdifferentbucketscanbemixedontothesame
pieceofmedia.

July 2016

User GuideSpectra BlackPearl Gateway

50

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Parameter

Value

Description

Default GET Job


Priority

High

WhenthestoragedomainreceivesaGETjob,itis
processedwithhighpriority,whichisbeforelowand
normalpriorityjobs.Jobsofdifferenttypesareputin
orderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaGETjobbyspecifyinga
differentpriorityintheGetJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default PUT Job
Priority

Normal

WhenthestoragedomainreceivesaPUTjob,itis
processedwithnormalpriority,whichisafterhigh
priorityjobsbutbeforelowandnormalpriorityjobs.
Jobsofdifferenttypesareputinorderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaPUTjobbyspecifyinga
differentpriorityinthePutJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default VERIFY Job
Priority

Low

WhenthestoragedomainreceivesaVERIFYjob,itis
processedwithlowpriority,whichisthelowestsetting.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaVERIFYjobbyspecifyinga
differentpriorityintheCreateVerifyJobcommand.See

theSpectraBlackPearlSpectraS3APIReferencefor
moreinformation.
Rebuild Priority

Low

Ifdataislostfromtapemedia,thedataisrebuiltusing
lowpriority,whichisthelowestsetting.

Checksum Type

MD5

DatausingthisstoragedomainisCRCcheckedusingthe
MD5checksumtype.DataisCRCcheckedwhenitis
writtentocachewithaPUTjob,orreadbackfromtape
mediawithaGETjob.

Versioning

None

Inordertouploadanewversionofanobjectalready
PUTtothegateway,thefirstversionmustbedeleted.

End-to-end CRC

No

ThisdatapolicydoesnotuseendtoendCRCchecking.

July 2016

User GuideSpectra BlackPearl Gateway

51

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Dual Copy on Tape


ThisdatapolicypersiststwocopiesofdataforeachGETjobthepolicy
receives.Bothcopiesofdataaremovedtotapemedia.Thisdatapolicy
providesenhanceddatasecurityinthecaseofdisasterrecovery,andis
usefulifyouwanttoejectonecopyoftapemediaforstorageoffsite.
Note: Thisdatapolicyiscreatedautomaticallywhenthegateway
detectsthefirstandsecondtapepartitionscreatedonthetape
library.

Figure 22 The Dual Copy on Tape workflow.


Thedualcopyontapedatapolicyisconfiguredwiththefollowing
attributes:
Parameter

Value

Description

Storage Domain

Tape First Copy,


Tape Second Copy

Dataiswrittentotheprimarytapestoragedomainas
wellasthesecondarytapestoragedomain.Bothcopies
ofdataareidentical.
Note: Thesedomainsarecreatedautomaticallywhen
thegatewaydetectsthefirstandsecondtapepartitions
createdonthetapelibrary.

Data Persistence
Rule

Permanent
(both storage
domains)

Dataismovedtotapeandmaintainedontapemedia
untildataisdeletedfromabucket.
Whendataisdeletedfromabucket,itisremovedfrom
tapemedia,butindividualtapemediacartridgesarenot
reclaimedforuseuntilalldataisdeletedfromatape
cartridge.

July 2016

User GuideSpectra BlackPearl Gateway

52

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Parameter

Value

Description

Bucket Isolation
Level

Standard
(both storage
domains)

Datafromdifferentbucketscanbemixedontothesame
pieceofmedia.
Note: IfyouplantousetheTapeSecondCopystorage
domaintoejecttapes,youmaywanttochangethe
BucketIsolationLevelfortheTapeSecondCopystorage
domaintoBucketIsolated.

Default GET Job


Priority

High

WhenthestoragedomainreceivesaGETjob,itis
processedwithhighpriority,whichisbeforelowand
normalpriorityjobs.Jobsofdifferenttypesareputin
orderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaGETjobbyspecifyinga
differentpriorityintheGetJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default PUT Job
Priority

Normal

WhenthestoragedomainreceivesaPUTjob,itis
processedwithnormalpriority,whichisafterhigh
priorityjobsbutbeforelowandnormalpriorityjobs.
Jobsofdifferenttypesareputinorderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaPUTjobbyspecifyinga
differentpriorityinthePutJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default VERIFY Job
Priority

Low

WhenthestoragedomainreceivesaVERIFYjob,itis
processedwithlowpriority,whichisthelowestsetting.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaVERIFYjobbyspecifyinga
differentpriorityintheCreateVerifyJobcommand.See

theSpectraBlackPearlSpectraS3APIReferencefor
moreinformation.
Rebuild Priority

Low

Ifdataislostfromtapemedia,thedataisrebuiltusing
lowpriority,whichisthelowestsetting.

Checksum Type

MD5

DatausingthisstoragedomainisCRCcheckedusingthe
MD5checksumtype.DataisCRCcheckedwhenitis
writtentocachewithaPUTjob,orreadbackfromtape
mediawithaGETjob.

Versioning

None

Inordertouploadanewversionofanobjectalready
PUTtothegateway,thefirstversionmustbedeleted.

End-to-end CRC

No

ThisdatapolicydoesnotuseendtoendCRCchecking.

July 2016

User GuideSpectra BlackPearl Gateway

53

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Single Copy on Nearline Disk


Thisdatapolicypersistsasinglecopyofeachjobsenttothegatewayonto
nearlinedisk,whichisprovidedbyArcticBlueexpansionnodes.Oncedata
iswrittenonnearlinedisk,itisremovedfromtheBlackPearlcacheifthe
gatewaydetectsthatmorecachespaceisneededforincomingdata.
Note: Thisdatapolicyisautomaticallycreatedwhenthegateway
detectsanearlinediskpartition.

Figure 23 The Single Copy on Nearline Disk workflow.


Thesinglecopyonnearlinediskdatapolicyisconfiguredwiththe
followingattributes:
Parameter

Value

Description

Storage Domain

Pool First Copy

Dataiswrittentotheprimarynearlinediskstorage
domain.
Note: Thisdomainiscreatedautomaticallywhenthe
gatewaydetectsthefirstdiskpartitioncreatedonthe
ArcticBlueexpansionnode.

Data Persistence
Rule

Permanent

Dataismovedtonearlinediskandismaintaineduntil
dataisdeletedfromabucket.

Bucket Isolation
Level

Standard

Datafromdifferentbucketscanbemixedontothesame
diskpool.

July 2016

User GuideSpectra BlackPearl Gateway

54

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Parameter

Value

Description

Default GET Job


Priority

High

WhenthestoragedomainreceivesaGETjob,itis
processedwithhighpriority,whichisbeforelowand
normalpriorityjobs.Jobsofdifferenttypesareputin
orderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaGETjobbyspecifyinga
differentpriorityintheGetJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default PUT Job
Priority

Normal

WhenthestoragedomainreceivesaPUTjob,itis
processedwithnormalpriority,whichisafterhigh
priorityjobsbutbeforelowandnormalpriorityjobs.
Jobsofdifferenttypesareputinorderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaPUTjobbyspecifyinga
differentpriorityinthePutJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default VERIFY Job
Priority

Low

WhenthestoragedomainreceivesaVERIFYjob,itis
processedwithlowpriority,whichisthelowestsetting.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaVERIFYjobbyspecifyinga
differentpriorityintheCreateVerifyJobcommand.See

theSpectraBlackPearlSpectraS3APIReferencefor
moreinformation.
Rebuild Priority

Low

Ifdataislostfromnearlinedisk,thedataisrebuiltusing
lowpriority,whichisthelowestsetting.

Checksum Type

MD5

DatausingthisstoragedomainisCRCcheckedusingthe
MD5checksumtype.DataisCRCcheckedwhenitis
writtentocachewithaPUTjob,orreadbackfromtape
mediawithaGETjob.

Versioning

None

Inordertouploadanewversionofanobjectalready
PUTtothegateway,thefirstversionmustbedeleted.

End-to-end CRC

No

ThisdatapolicydoesnotuseendtoendCRCchecking.

July 2016

User GuideSpectra BlackPearl Gateway

55

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Single Copy on Nearline Disk and Tape


Thisdatapolicypersistsasinglecopyofeachjobsenttothegatewayonto
bothnearlinediskandtapemedia.Oncedataiswrittenonbothdiskand
tape,itisremovedfromtheBlackPearlcacheifthegatewaydetectsthat
morecachespaceisneededforincomingdata.
Note: Thisdatapolicyisautomaticallycreatedwhenthegateway
detectsadiskpartitionandatapepartition.

Figure 24 The Single Copy on Nearline Disk and Tape workflow.


Thesinglecopyonnearlinediskandtapedatapolicyisconfiguredwith
thefollowingattributes:
Parameter

Value

Description

Storage Domain

Pool First Copy,


Tape First Copy

Dataiswrittentotheprimarydiskstoragedomainand
theprimarytapestoragedomain.
Note: Thesedomainsarecreatedautomaticallywhen
thegatewaydetectsthefirsttapepartitioncreatedonthe
tapelibrary,andthefirstdiskpartitioncreatedonan
ArcticBlueexpansionnode.

Data Persistence
Rule

Permanent
(for both storage
domains)

Dataismovedtodiskandtapeandmaintainedonboth
mediumsuntildataisdeletedfromabucket.
Note: Whendataisdeletedfromabucket,itisremoved
fromtapemedia,butindividualtapemediacartridges
arenotreclaimedforuseuntilalldataisdeletedfroma
tapecartridge.Thisrestrictiondoesnotapplytodisk
partitions.

July 2016

User GuideSpectra BlackPearl Gateway

56

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Parameter

Value

Description

Bucket Isolation
Level

Standard
(for both storage
domains)

Datafromdifferentbucketscanbemixedontothesame
tapeorpool.

Default GET Job


Priority

High

WhenthestoragedomainreceivesaGETjob,itis
processedwithhighpriority,whichisbeforelowand
normalpriorityjobs.Jobsofdifferenttypesareputin
orderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaGETjobbyspecifyinga
differentpriorityintheGetJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default PUT Job
Priority

Normal

WhenthestoragedomainreceivesaPUTjob,itis
processedwithnormalpriority,whichisafterhigh
priorityjobsbutbeforelowandnormalpriorityjobs.
Jobsofdifferenttypesareputinorderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaPUTjobbyspecifyinga
differentpriorityinthePutJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default VERIFY Job
Priority

Low

WhenthestoragedomainreceivesaVERIFYjob,itis
processedwithlowpriority,whichisthelowestsetting.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaVERIFYjobbyspecifyinga
differentpriorityintheCreateVerifyJobcommand.See

theSpectraBlackPearlSpectraS3APIReferencefor
moreinformation.
Rebuild Priority

Low

Ifdataislostfromdiskortapemedia,thedataisrebuilt
usinglowpriority,whichisthelowestsetting.

Checksum Type

MD5

DatausingthisstoragedomainisCRCcheckedusingthe
MD5checksumtype.DataisCRCcheckedwhenitis
writtentocachewithaPUTjob,orreadbackfromdisk
ortapemediawithaGETjob.

Versioning

None

Inordertouploadanewversionofanobjectalready
PUTtothegateway,thefirstversionmustbedeleted.

End-to-end CRC

No

ThisdatapolicydoesnotuseendtoendCRCchecking.

July 2016

User GuideSpectra BlackPearl Gateway

57

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Single Copy on Nearline Disk and Dual Copy on Tape


Thisdatapolicypersistsasinglecopyofeachjobsenttothegatewayonto
nearlinediskandtwocopiesofthejobontotapemedia.Oncedatais
writtenonbothdiskandtape,itisremovedfromtheBlackPearlcacheif
thegatewaydetectsthatmorecachespaceisneededforincomingdata.
Note: Thisdatapolicyisautomaticallycreatedwhenthegateway
detectsadiskpartitionandtwotapepartitions.

Figure 25 The Single Copy on Nearline Disk and Dual Copy on


Tape workflow.
Thesinglecopyonnearlinediskanddualcopyontapedatapolicyis
configuredwiththefollowingattributes:
Parameter

Value

Description

Storage Domain

Pool First Copy,


Tape First Copy,
Tape Second Copy

Dataiswrittentotheprimarydiskstoragedomainas
wellastheprimaryandsecondarytapestoragedomains.
Allcopiesofthedataareidentical.
Note: Thesedomainsarecreatedautomaticallywhen
thegatewaydetectsthefirstandsecondtapepartitions
createdonthetapelibrary,andthefirstdiskpartition
createdonanArcticBlueexpansionnode.

July 2016

User GuideSpectra BlackPearl Gateway

58

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Parameter

Value

Description

Data Persistence
Rule

Permanent
(for all storage
domains)

Dataismovedtodiskandtapeandmaintainedonboth
mediumsuntildataisdeletedfromabucket.
Note: Whendataisdeletedfromabucket,itisremoved
fromtapemedia,butindividualtapemediacartridges
arenotreclaimedforuseuntilalldataisdeletedfroma
tapecartridge.Thisrestrictiondoesnotapplytodisk
partitions.

Bucket Isolation
Level

Standard
(for all storage
domains)

Datafromdifferentbucketscanbemixedontothesame
tapeorpool.
Note: IfyouplantousetheTapeSecondCopystorage
domaintoejecttapes,youmaywanttochangethe
BucketIsolationLevelfortheTapeSecondCopystorage
domaintoBucketIsolated.
Note: Forincreasedobjectrecoveryperformance,you
maywishtoconfigurethePoolFirstCopystorage
domainwithaTemporarydataretentionpolicy,with
objectsretainedfor60or90days.

Default GET Job


Priority

High

WhenthestoragedomainreceivesaGETjob,itis
processedwithhighpriority,whichisbeforelowand
normalpriorityjobs.Jobsofdifferenttypesareputin
orderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaGETjobbyspecifyinga
differentpriorityintheGetJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default PUT Job
Priority

Normal

WhenthestoragedomainreceivesaPUTjob,itis
processedwithnormalpriority,whichisafterhigh
priorityjobsbutbeforelowandnormalpriorityjobs.
Jobsofdifferenttypesareputinorderbasedonpriority.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaPUTjobbyspecifyinga
differentpriorityinthePutJobcommand.Seethe

SpectraBlackPearlSpectraS3APIReferenceformore
information.
Default VERIFY Job
Priority

Low

WhenthestoragedomainreceivesaVERIFYjob,itis
processedwithlowpriority,whichisthelowestsetting.
Note: WhenusingaSpectraS3client,thissettingcanbe
overriddenwhensendingaVERIFYjobbyspecifyinga
differentpriorityintheCreateVerifyJobcommand.See

theSpectraBlackPearlSpectraS3APIReferencefor
moreinformation.
Rebuild Priority

July 2016

Low

Ifdataislostfromdiskortapemedia,thedataisrebuilt
usinglowpriority,whichisthelowestsetting.

User GuideSpectra BlackPearl Gateway

59

Chapter 3 Understanding Spectra Advanced Bucket Management Concepts

Example Configurations

Parameter

Value

Description

Checksum Type

MD5

DatausingthisstoragedomainisCRCcheckedusingthe
MD5checksumtype.DataisCRCcheckedwhenitis
writtentocachewithaPUTjob,orreadbackfromdisk
ortapemediawithaGETjob.

Versioning

None

Inordertouploadanewversionofanobjectalready
PUTtothegateway,thefirstversionmustbedeleted.

End-to-end CRC

No

ThisdatapolicydoesnotuseendtoendCRCchecking.

July 2016

User GuideSpectra BlackPearl Gateway

60

CHAPTER 4
Configure Advanced Bucket
Management Settings
ThischapterprovidesinstructionsonhowtoconfiguretheAdvanced
BucketManagementfeatures.
Task
CreateaDiskPartition

page 62

CreateaTapePartition

page 64

CreateaBlackPearlTarget

page 65

CreateaStorageDomain

page 67

CreateaDataPolicy

page 71

CreateaBucket

page 76

TransferData

page 78

61

Chapter 4 Configure Advanced Bucket Management Settings

Create a Disk Partition

CREATE A DISK PARTITION


Diskpartitionsarecollectionsofoneormorestoragepools,whichare
configuredoneitherArcticBlueexpansionnodes,orBlackPearlexpansion
nodes,connectedtotheBlackPearlgateway.Diskpartitionsarespecifiedin
storagedomainsasstoragetargets.Therearetwotypesofdiskpartitions;
nearlinestorage,whichisprovidedbyanArcticBlueexpansionnode,and
onlinestorage,whichisprovidedbyaBlackPearlexpansionnode.
NearlinestoragepoolsonArcticBlueexpansionnodesareautomatically
createdbytheBlackPearlgatewaywhenthesystemdetectsthatnewdisk
storageisconnectedtothegateway.Acapacitykeylicensingthedisk
storagemustbeenteredintothegatewaybeforeautomaticstoragepool
creationbegins.Onlinestoragepoolsmustbecreatedmanuallyusingthe
BlackPearluserinterface.SeeCreateOnlineDiskPoolonpage 101for
moreinformation.
Oncethestoragepoolsarecreated,theycanbeaddedtoadiskpartition.

July 2016

User GuideSpectra BlackPearl Gateway

62

Chapter 4 Configure Advanced Bucket Management Settings

Create a Disk Partition

Usetheinstructionsinthissectiontocreateanewdiskpartition.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen.

Figure 26 The Advanced Bucket Management screen.


2. SelectAction > New Disk Partition.TheNewDiskPartitiondialogbox
displays.

Figure 27 The New Disk Partition dialog box.

July 2016

User GuideSpectra BlackPearl Gateway

63

Chapter 4 Configure Advanced Bucket Management Settings

Create a Tape Partition

3. EnteranameforthediskpartitionintheDisk Partition Namefield.


4. UsethedropdownmenutoselectthePartition type.Youcannotmix
differenttypesofstoragepoolsinadiskpartition.

SelectOnlinetouseastoragepoolonaBlackPearlexpansionnode.

SelectNearlinetouseastoragepoolonanArcticBlueexpansion
node.

5. Addastoragepooltothediskpartition.
a. IntheMemberPoolspane,clickAdd.Anewrowappearsinthe
pane.
b. UsetheNamedropdownmenutoselectastoragepoolfromthelist
ofpreviouslyconfiguredstoragepools.TheCapacity,Type,and
Healthofthestoragepooldisplay.
c. Ifdesired,repeatStep aandStep btoaddadditionalstoragepools
tothediskpartition.
6. ClickCreate.ThenewdiskpartitiondisplaysontheAdvancedBucket
Managementscreen.

CREATE A TAPE PARTITION


UsetheUserGuideforyourSpectratapelibrarytocreateapartitionusing
thelibrarysBlueScaleinterface.OncetheBlackPearlgatewaydetectsa
partitiononatapelibraryconnectedtoit,thetapepartitionis
automaticallylistedontheAdvancedBucketManagementscreen.

July 2016

User GuideSpectra BlackPearl Gateway

64

Chapter 4 Configure Advanced Bucket Management Settings

Create a BlackPearl Target

CREATE A BLACKPEARL TARGET


ConfiguringaBlackPearltargetallowsadatapolicyononeBlackPearl
gatewaytoreplicatedatatoasecondgateway.Ifdataissenttoadata
policythatisnotconfiguredforreplication,thedataisnotreplicatedtothe
targetgateway.
Withreplicationenabled,assoonasdataisPUTtothecacheofthesource
gatewayitbeginsreplicationtothetargetgateway.Storingmultiplecopies
ofthesamedataonadifferentBlackPearlgatewaysprovidesenhanced
datasecurityanddisasterrecoveryifthesourcegatewayfails.Whenyou
deletedatafromthesourcegateway,youcanoptionallyspecifytohavethe
datadeletedfromthetargetgatewayaswell.
UsetheinstructionsinthissectiontoconfigureaBlackPearltarget.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen(see
Figure 26onpage 63).
2. SelectAction > New BlackPearl Target.TheNewBlackPearlTarget
dialogboxdisplays.

Figure 28 The New BlackPearl Target dialog box.


3. EnteranamefortheBlackPearltargetintheNamefield.
4. Enterthehostnameofthetargetgateway,ortheIPaddressofthetarget
gatewaysdataport,astheData Path End Point.
Note: DonotusetheIPaddressofthetargetgatewaysmanagement
port.

July 2016

User GuideSpectra BlackPearl Gateway

65

Chapter 4 Configure Advanced Bucket Management Settings

Create a BlackPearl Target

5. EntertheusernameorS3AccessIDofauserwithadministrator
privilegesonthetargetgatewayintheAdministrator Username or S3
Access IDfield.
Note: Administratorcredentialsareusedtoconfigureandmaintain
thesource/targetrelationship.Theyarenotusedforuserdriven
replicationoperations.
6. IntheAdministrator S3 Secret Keyfield,entertheS3SecretKeyofthe
useryouenteredinStep 5.
7. Usingthedropdownmenu,selectavaluefortheData Path Port.Set
thistothevalueoftheportonwhichthetargetgatewaysS3serveris
running.
Note: Donotchangethissettingunlessyouconfiguredthetarget
gatewayS3serveronaportotherthanthedefault.
8. Optionally,entertheIPaddressoftheData Path Proxy Server.If
configured,thesourcegatewayusesthespecifiedproxytoconnectto
thetargetgateway.
9. Optionally,enterthenameofadatapolicyconfiguredonthetarget
gatewaytouseastheReplicated User Default Data Policy.Ifconfigured,
thegatewayusesthistargetdatapolicyasthedefaultdatapolicyfor
anyusersreplicatedtothetarget.
10. Usingthedropdownmenu,selectavaluefortheDefault Read
Preference.Dataisnormallyreadfromthesourcegatewaywhenever
possible.Thissettingdeterminesfromwhatlocationdataisreadback
fromthetargetgateway,ifneeded.

July 2016

Name

Description

Last Resort

Thesourcegatewayonlyreadsdatafromthetarget
gatewayifthesourcegatewaycannotreadfromanyof
itsowndatapartitions.

Minimum Latency

Thesourcegatewayreadsthedatafromthedata
partitionwiththeleastlatencynomatterwhetheritis
connectedtothesourcegatewayorthetargetgateway.
Forexample,ifthesourcegatewayonlyhasthedataon
tapeandthetargetgatewayhasthedataonpool,the
dataisreadfromthetargetpool.
Note: OnlyuseMINIMUMLATENCYwhenthe
networkbetweenthesourceandtargetisvery
inexpensive.

After Online Pool

Thesourcegatewayonlyreadsdatafromthetarget
gatewayifthesourcegatewaycannotreadfroman
onlinepool.

After Nearline Pool

Thesourcegatewayonlyreadsdatafromthetarget
gatewayifthesourcegatewaycannotreadfroma
nearlinepool.

User GuideSpectra BlackPearl Gateway

66

Chapter 4 Configure Advanced Bucket Management Settings

Create a Storage Domain

Name

Description

After NonEjectable Tape

Thesourcegatewayonlyreadsdatafromthetarget
gatewayifthesourcegatewaycannotreadfromanon
ejectabletape.

Never

Dataisneverreadfromthetargetgateway

11. Usingthedropdownmenu,selectavalueforAccess Control


Replication.IfsettoUsers,thesourcegatewayreplicatesitsusersand
passwordstothetargetgateway.
12. ClickCreate.ThenewBlackPearltargetappearsontheAdvanced
BucketManagementscreen.

CREATE A STORAGE DOMAIN


Astoragedomainisanamedcollectionofmemberdatapartitionsand,
whenapplicable,mediatypecombinations.Storagedomainsdefinethe
possibleplaceswheretheBlackPearlDeepStorageGatewaystoresdata
thatissenttoit.Datapersistencerulesanddatapoliciesfurtherdefine
whereandforhowlongtostorespecificdata.
Entiredatapartition/mediatypecombinationsaremembersofstorage
domains.Whenabucketrequiresadditionalcapacity,asingledisk
partitionortapeisallocatedoutofthememberstofulfillthecapacity
requirement.
Usetheinstructionsinthissectiontocreateanewstoragedomain.
theinstructionsinthissectiontocreateanewstoragedomain.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen(see
Figure 26onpage 63).

July 2016

User GuideSpectra BlackPearl Gateway

67

Chapter 4 Configure Advanced Bucket Management Settings

Create a Storage Domain

2. SelectAction > New Storage Domain.TheNewStorageDomaindialog


boxdisplays.

Figure 29 The New Storage Domain dialog box.


3. EnteranameforthestoragedomainintheStorage Domain Namefield.
4. EnteravalueforMaximum Days Between Auto Verifications.Afterthe
specifiednumberofdayspass,thegatewayperformsadataverification
checkofallunchangedtapemediainthestoragedomaintoensureitis
stillviable.
Note: Diskmediaisnotsubjecttodataverificationchecks.
5. SelectorclearSecure Media Allocation.Ifenabled,SecureMedia
Allocationensuresthatmediaallocatedtothestoragedomainisnever
reusedbytheBlackPearlgatewaytostorenewdata.
Note: SecureMediaAllocationshouldonlybeenabledwhen,for
compliancepurposes,theusermustbecertainwhichmediaever
containedanydataforthestoragedomain(usually,tophysically
destroythemediaoncethedataisnolongerneeded),ortoforce
rotatingthroughmediawhennewbackupsarecreatedandold
backupsaredeleted.

July 2016

User GuideSpectra BlackPearl Gateway

68

Chapter 4 Configure Advanced Bucket Management Settings

Create a Storage Domain

6. SelecttheWrite Optimizationforthestoragedomain.
Thissettingspecifieswhetherjobchunksarewrittenasquicklyas
possibleoracrossasfewpiecesofmediaaspossible.Forexample,
whenPerformancemodeissetforatapepartition,jobchunksare
writtenasquicklyaspossible,usingalltapedriveresources,evenif
thatmeansthatmoretapesareallocatedtothebucketthanare
necessarytowritethedata.
ItisbettertouseCapacitymodeifyouplantoejectthetapesafterthe
jobcompletesorifthebucketiswrittentoveryrarelyandcapacityin
thelibraryisofconcern.Performancemodeisrecommendedfortape
partitionsinallothercases.
StoragedomainsforpoolpartitionsshouldgenerallyhaveaCapacity
writeoptimizationbecausepoolsareveryfastandunderless
contention.Itisrareforapoolstoragedomaintobenefitfrom
Performancemode.
7. SelecttheLTFS File Name optionforthestoragedomain.
Note: Thissettingonlyappliestotapemedia.Ifthestoragedomain
includestapepartition(s),youmustspecifytheLTFS File Name
optionforthestoragedomain.Thisoptionspecifieshowthe
gatewaynamesthefilewhenitwritesthemtotape.
TherearetwooptionsfortheLTFS File Name:

Object NameLTFSfilenamesusetheformat{bucketname}/{object
name},forexamplebucket1/video1.mov.Objectnamesmustcomply
withLTFSfilenamingrules.Ifthetapesareejectedfromthe
BlackPearlgatewayandloadedintoanonBlackPearltapepartition,
thefilenamesmatchtheobjectnames.

Notes:

July 2016

Thecoloncharacter(:)isnotallowedinLTFSfilenamesand
thereforenotallowedinBlackPearlobjectnames.Theslash
character(/)isalsotechnicallynotallowedinLTFSfile
names;however,theBlackPearlsoftwarecanaccommodatea
slashintheobjectnameandtranslatesitasadirectoryinthe
LTFSfilesystem(e.g.directory1/directory2/video1.mov).
SpectraLogicdoesnotrecommendthefollowingcharacters
inLTFSfilenamesorBlackPearlobjectnamesforreasonsof
crossplatformcompatibility:controlcharacterssuchas
carriagereturn(CR)andlinefeed(LF),doublequotation
mark(),asterisk(*),questionmark(?),lessthansign(<),
greaterthansign(>),backslash(\),verticalline(|).

Object IDLTFSfilenamesusetheformat{bucketname}/{objectid},
forexamplebucket1/1fc6f09cdd7241ea80430491ab8a6d82.Object
namesdonotneedtocomplywithLTFSfilenamingrules.The
gatewaysavesobjectnamesasLTFSextendedattributesallowing
anythirdpartyapplicationtoreconstructallthedataincludingthe
objectnames.

User GuideSpectra BlackPearl Gateway

69

Chapter 4 Configure Advanced Bucket Management Settings

Create a Storage Domain

8. Optionally,selecttheMedia Ejection Allowedcheckboxtoenablemedia


ejectionoptionsforthestoragedomain.Clearthecheckboxtodisallow
mediaejectionforthestoragedomain.
Note: Thissettingonlyappliestotapemedia.
Ifyouselecttoallowmediaejection,configurethefollowingoptions:
a. Selectorclearoptionsforautomediaejection.

Auto Eject on Job Completionselectthisoptiontohavethe


gatewayautomaticallyejecttape(s)whenajobcompletes.

Auto Eject on Job Cancelselectthisoptiontohavethegateway


automaticallyejecttape(s)whenausercancelsajob.

Auto Eject on Media Fullselectthisoptiontohavethegateway


automaticallyejecttape(s)whenaatapeisfull.

b. UsingtheAuto Eject Verify Task Prioritydropdownmenu,selecta


taskpriorityfortapestobeverifiedwhentheyareautomatically
ejected.SelectingNonemeansthatthegatewaydoesnotverifytapes
beforeejectingthem.
c. SelectorcleartheScheduled Auto Ejectcheckbox.Ifenabled,this
optionautomaticallyejectstapemediaonasetschedule.Usethe
instructionsbelowtoconfigureeitherhourly,weekly,ordaily
automatictapeejection.

Create an Hourly Schedule


a. SelectHourlyastheintervalforthetapeejectionschedule(see
Figure 29onpage 68).
b. EnteranumberforEvery _ hours on the hour.Thisvaluespecifies
theinterval,inhours,betweenejectingtapes.Forexample,ifthis
valueissetto4,thesystemejectstapeseveryfourhours.

Create a Daily Schedule


a. SelectDailyastheintervalforthetapeejectionschedule(see
Figure 29onpage 68).
b. EnteratimevalueforStart Time,andincludeAMorPMafter
thevalue.Thisfieldisnotcasesensitive.
c. EnteranumberforEvery _ days.Thisvaluespecifiestheinterval,
indays,betweenejectingtapes.

Create a Weekly Schedule


a. SelectWeeklyastheintervalforthetapeejectionschedule(see
Figure 29onpage 68).
b. EnteratimevalueforStart Time,andincludeAMorPMafter
thevalue.Thisfieldisnotcasesensitive.
c. SelectoneormoredaysforEvery week on:.Thisdeterminesthe
day(s)ofeachweekthesystemejectstapes.
July 2016

User GuideSpectra BlackPearl Gateway

70

Chapter 4 Configure Advanced Bucket Management Settings

Create a Data Policy

9. Addastoragemembertothestoragedomain.
a. IntheMemberspane,clickAdd.Anewrowappearsinthepane.
b. UsethePartition Namedropdownmenutoselectatapeordisk
partitionfromthelistofpreviouslycreatedpartitions.
c. UsetheMedia Typedropdownmenutoselectthemediatypefora
tapepartition.
Notes:

Youmustselectthemediatypethatmatchesthemedia
presentinthetapelibrarypartition.
Thisoptiondoesnotdisplayifyouselectadiskpartitionin
Step b.

d. UsetheWrite Preferencedropdownmenutoselectthewrite
preferenceforthismemberofthestoragedomain.Thissetting
determinesthepreferredusageofthepartitionwhenadditional
capacityisneeded.ThegatewayusesapartitionwithHighwrite
preferencebeforeapartitionwithNormalwritepreference,andso
on.UseNever Selecttoindicatethatapartitionisreadonly.
e. Ifdesired,repeatStep athroughStep dtoaddadditionalmembers
tothestoragedomain.
10. ClickCreate.ThenewstoragedomaindisplaysontheAdvanced
BucketManagementscreen.

CREATE A DATA POLICY


Adatapolicydefinesdataintegritypolicies,defaultjobattributes,and
persistenceandreplicationrules,whichdefinewheredataiswrittenand
forhowlongitiskept.Adatapolicymaybeusedbymultiplebuckets,but
abucketusespreciselyonedatapolicy.
Adatapolicyconsistsofoneormorepermanentpersistencerules,zeroor
moretemporarypersistencerules,zeroormoreretiredpersistencerules,
andzeroormorereplicationrules.Apersistenceruleiseitherpermanent,
meaningthatdataiskeptinthespecifiedstoragedomainatalltimes,or
temporary,meaningthatdataiskeptinthespecifiedstoragedomain
undercertaincircumstances,andthenitcanbedeletedfromthatstorage
domain.Existingpermanentandtemporarypersistencerules,and
replicationrules,mayberetiredsothattheruleisnotappliedforanynew
incomingdata,butwillcontinuetoretaindatapreviouslywritten.
Usetheinstructionsinthissectiontocreateanewdatapolicy.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen(see
Figure 26onpage 63).

July 2016

User GuideSpectra BlackPearl Gateway

71

Chapter 4 Configure Advanced Bucket Management Settings

Create a Data Policy

2. SelectAction > New Data Policy.TheNewDataPolicydialogbox


displays.

Figure 30 The New Data Policy dialog box.


3. EnteranameforthedatapolicyintheData Policy Namefield.
4. SelectorcleartheBlobbing Enabled checkbox.Whenenabledthis
settingallowsanobjecttobebrokenintomultipleblobs.Ifdisabled,an
objectmustbeexactlyoneblob.Blobbingmustbeenabledtohandle
objectslargerthan1TB,tousemultipartupload,ortobreakupan
objectintomultipleblobs.
Note: Disablingblobbingguaranteesthananobjectwillneverspan
multipletapesorstoragepools,sinceablobcannotspan
multiplemedia.
5. SelectorcleartheMinimize Spanningcheckbox.Whenenabledthis
settingminimizesthespanningofdataacrossmultipletapesorpools.
Jobslessthan1TBneverspansmedia.
Note: Enablingthisoptioncanadverselyaffectcapacityutilizationand
performance.

July 2016

User GuideSpectra BlackPearl Gateway

72

Chapter 4 Configure Advanced Bucket Management Settings

Create a Data Policy

6. SelectthePerformancecharacteristicsforthedatapolicy.Eachpriority
determinestheresourcesassignedandtheprocessingorder.Jobswith
priorityUrgentcanuseupalloftheresourcesandpreventotherjobs
frommakingprogress.Usethisprioritysparingly.
a. UsethedropdownmenutoselecttheDefault GET Priority.
b. UsethedropdownmenutoselecttheDefault Put Priority.
c. UsethedropdownmenutoselecttheDefault Verify Priority.
d. UsethedropdownmenutoselecttheRebuild Priority.
7. SelecttheData Securityoptionsforthedatapolicy.
a. UsethedropdownmenutoselecttheChecksum type.
Thissettingspecifiesthetypeofchecksumusedtoverifydataintegrity
fordatainanybucketusingthisdatapolicy,andthetypeofchecksum
requiredforendtoendCRC,ifspecified.
Notes:

CRC,MD5,andSHA512performthebestfortheir
correspondingcryptographicstrengthsontheBlackPearl
gateway.
UsingSHA256andSHA512reducessinglestream
performanceandmayreducethroughputcapabilitiesofthe
gateway.

b. IfyouwanttoenableendtoendsecurityforeachGETorPUTjob,
selecttheRequire end-to-end CRCcheckbox.
8. SelectthetypeofVersioningyouwanttouseforthedatapolicy.You
mustselecteitherNoneorKeep Latest.

NoneOnlyoneversionofanobjectmayexistatanytimeandthe
versionnumberoftheobjectisalways1.

Keep LatestOnlyoneversionofthedataisavailableatatime.
Whenanewversionofanobjectiswritten,theoldversionis
retaineduntilthenewversionisfullywrittenincompliancewith
thedatapolicy,andthentheoldversionisdeleted.

Notes:

Caution

July 2016

TheKeep Latestsettingcannotbeusedforadatapolicy
whichusesastoragedomainconfiguredwiththeLTFS File
Name optionsettoObject Name.SeeCreateaStorageDomain
onpage 67formoreinformation.
TheKeep LatestsettingrequiresthatthePUTjobforthe
earlierversionoftheobjectcompletebeforethePUTofthe
latestversionoftheobjectwiththesamenameinorderfor
thePUTjobtosucceed.

If the PUT of the earlier version is not complete before the PUT of the latest version,
the BlackPearl gateway believes the latest version to be the same object as the
earlier version and rejects it, and only the earlier version is retained.

User GuideSpectra BlackPearl Gateway

73

Chapter 4 Configure Advanced Bucket Management Settings

Create a Data Policy

9. Addastoragedomaintothedatapolicyandconfigurethedata
persistencerulesforthatstoragedomain.
a. IntheDataPersistenceRulespane,clickAdd.Anewrowappearsin
thepane.
b. UsetheStorage Domain dropdownmenutoselectastoragedomain
fromthelistofpreviouslycreatedstoragedomains.
c. UsetheTypedropdownmenutoselectwhetherthedata
persistenceruletousefortheforthestoragedomainisTemporaryor
Permanent.
Note: TheTemporarysettingcannotbeusedforastoragedomainthat
targetsatapelibrary.
d. UsetheIsolation Level dropdownmenutoselectthelevelof
physicalisolationrequiredforthestoragedomain.

StandardDataisisolatedaccordingtothestandardStorage
Domainisolationrequirements.

Bucket IsolatedDatafromdifferentbucketscannotbemixed
onthesamephysicalstoragemedia.

Notes:

TheStandardisolationlevelprovidesthebestcapacity
utilizationandoverallperformance.
Bucket Isolatedallocatesanentiretapeorpooltoabucket
whenneeded.Allocatinganentirepooltoabucketmayuse
upresourcesquicklyandisnotrecommended.

e. EntertheMinimum Days to Retainintheentryfieldtospecifythe


minimumnumberofdaysthegatewayshouldretaindatawritten
usingatemporarypersistencerule.
Note: TheMinimum Days to Retainforapersistenceruletargetinga
storagedomainusinganearlinepool(anArcticBlueexpansion
node)mustbe90daysorgreater.
f. Ifdesired,repeatStep aonpage 74throughStep etoaddadditional
storagedomainmembersandpersistencerulestothedatapolicy.
10. Ifyouplantoconfigureadatareplicationtarget,selectorclearthe
Replicate Deletescheckbox.Whenenabled,anytimeareplicatedfileis
deletedfromthesourcegateway,itisalsodeletedfromthetarget
gateway.

July 2016

User GuideSpectra BlackPearl Gateway

74

Chapter 4 Configure Advanced Bucket Management Settings

Create a Data Policy

11. Ifyouplantoconfigureadatareplicationtarget,selectorclearthe
Always accept replicated PUT jobscheckbox.Thisoptioncontrols
whetherallPUTjobscreatedforthisdatapolicyarecreatedevenifone
ormorereplicationtargetsthegatewaymustPUTtoareunavailable,or
ifthereareglobalissuesthatwouldlikelypreventthecompletionofthe
job.
Note: Usingthisparameterisdiscouraged,andusingitforjobson
boththesourceandtargetgatewaysatthesametimeis
extremelydiscouraged.Runningjobsonbothgatewayswhen
theyarenotabletocommunicatewitheachothercancreate
replicationconflictsthatmustbemanuallyresolved.
12. Ifdesired,addadatareplicationtargetanddefinethereplicationrules
forthedatareplicationtarget.
a. IntheDataReplicationRulespane,clickAdd.Anewrowappearsin
thepane.
b. UsetheBlackPearl Target dropdownmenutoselectareplication
targetfromthelistofpreviouslycreatedreplicationtargets.
c. UsetheTypedropdownmenutoselectwhetherthedata
persistenceruletousefortheforthestoragedomainisPermanent
or Retired.
Note: YoucannotcreateareplicationruleasRetired.Youcanonly
modifyarulefrompermanenttoretiredafterthedatapolicyis
created.
d. IntheBlackPearl Data Policyentryfield,enterthenameofthedata
policyonthetargetBlackPearlgatewaythatthetargetgatewayisto
usewhencreatingthebuckettostorethereplicateddata.
Alternatively,youcanleavethefieldblank.
Notes:

July 2016

Thedatapolicynameiscasesensitive.

Ifthebucketalreadyexistsandtheuserinitiatingthe
replicationhaswritepermissionforthebucket,andthedata
isnotyettransferred,thedataistransferredtotheexisting
bucket.

IfthefieldisleftblankandtheBlackPearltargetwas
configuredwiththesettingReplicatedUserDefaultData
Policyenabled,andAccessControlReplicationwassetto
Users,thedefaultdatapolicyonthetargetgatewayis
used.Ifnodefaultissetonthetargetgatewayandthetarget
gatewayisconfiguredwithmorethanonedatapolicy,the
replicationfails.

User GuideSpectra BlackPearl Gateway

75

Chapter 4 Configure Advanced Bucket Management Settings

Create a Bucket

13. AddauserorS3grouptotheAccess Control Listforthedatapolicy.


a. IntheAccessControlListpane,clickAdd.Anewrowappearsinthe
pane.
b. UsetheName dropdownmenutoselectapreviouslycreateduser
orS3group.
c. Ifdesired,repeatStep aandStep btoaddadditionalusersorS3
groupstotheaccesscontrollist.
14. ClickCreate.ThenewdatapolicydisplaysontheAdvancedBucket
Managementscreen.

CREATE A BUCKET
Bucketsaredatatransfertargetsforreadandwriteoperations.The
gatewaystagesdatawrittentoitonthecacheandoptimizeshowitwrites
bucketstostoragedomainsforbestperformance.
ClientswritedatatothegatewayusingabulkPUTcommand,andread
fromthegatewaywithabulkGETcommand.Formoreinformationon
usingthesecommandsseetheSpectraBlackPearlSpectraS3APIReference.
Note: BucketscanalsobecreatedusingaSpectraS3client,orSpectra
S3API.
Usetheinstructionsinthissectiontoconfigureabucket.
1. Fromthemenubar,selectConfiguration > Buckets.TheBucketsscreen
displays.

Figure 31 The Buckets screen.

July 2016

User GuideSpectra BlackPearl Gateway

76

Chapter 4 Configure Advanced Bucket Management Settings

Create a Bucket

2. SelectAction > New fromthemenubar.TheNewBucketdialogbox


displays.

Figure 32 The New Bucket dialog box.


3. EnteranameforthebucketintheBucket Namefield.
Notes:

Thebucketnamecannotusethecolon(:)orforwardslash(/)
characters.
Thebucketnamecannotexceed255characters.

4. Usingthedropdownmenu,selectanOwnerforthebucketfromthelist
ofusersalreadycreatedonthegateway.
5. Usingthedropdownmenu,selectaData Policyforthebucketfromthe
listofpreviouslycreateddatapoliciesonthegateway.Thebucketuses
thisdatapolicywhentransferringdata.
6. Addmemberstotheaccesscontrollistforthebucket.
a. UnderAccess Control Lists,clickAddtoaddanewmembertothe
accesscontrollist.
b. UsethedropdownmenuintheNamecolumntoselectauserorS3
group.
c. SelectorclearoptionsinthePermissionscolumntoallowordeny
thatpermissionfortheuserorgroupselectedinStep a.Seethetable
belowforadescriptionofeachpermissiontype.

July 2016

Name

Description

List

Theusercanseethebucketandcanlisttheobjectsina
bucket.

Read

TheusercangetobjectsandcreateGETjobs.

Write

TheusercanputobjectsandcreatePUTjobs.

Delete

Theusercandeleteobjects,butcannotdeletethebucket.

Job

Theusercanmodifyorcanceljobscreatedbyotherusers.
Theusercanalsoseethedetailsofjobscreatedbyother
users.
Note: Alluserscanviewalljobs,butbydefault,only
theinitiatorofthejobcanseethefulldetailsofajob.

User GuideSpectra BlackPearl Gateway

77

Chapter 4 Configure Advanced Bucket Management Settings

Transfer Data

Name

Description

Owner

Theuserreceivesfullaccesstoallbuckets,includingall
permissionslistedabove.

d. Ifdesired,repeatStep aonpage 77throughStep ctoaddadditional


usersorgroups.
7. ClickCreate.TheBucketsscreendisplayswiththenewlycreated
bucketlisted.

TRANSFER DATA
Aftercompletingtheabovesectionsofthischapter,youarereadytobegin
transferringdatato,andfrom,theBlackPearlgateway.

July 2016

TotransferdatausingtheSpectraDeepStorageBrowser,seeUsingthe
DeepStorageBrowseronpage 150.

TotransferdatausingaSpectraS3client,consulttheSpectraBlackPearl
SpectraS3APIReference,anddocumentationspecifictoeachSpectraS3
client.

User GuideSpectra BlackPearl Gateway

78

CHAPTER 5
Additional Configuration
Options
ThischapterdescribesusingtheBlackPearluserinterfacetoconfigure
additionaloptionsfortheSpectraBlackPearlDeepStorageGateway.
Task
ConfigureServices

page 80

ConfiguretheSNMPService

page 80

ConfiguretheSpectraS3Service

page 82

ConfigureNetworkConnectionsandSettings

page 85

EdittheSystemName

page 85

ConfigureEthernetPorts

page 86

ConfigureDNSSettings

page 87

ConfigureSMTPSettings

page 88

ConfigureDateandTime

page 90

ConfigureUsers

page 90

CreateNewS3Group

page 91

EditaUser

page 93

DeleteaUser

page 95

ChangePasswordandSessionTimeoutSetting

page 96

ConfigureCertificates

page 97

ConfigureBuckets

page 98

EditaBucket

page 98

DeleteaBucket

page 100

ConfigureDiskPools

page 101

CreateOnlineDiskPool

page 101

DeleteOnlineDiskPool

page 101

ImportDiskPool

page 102

79

Chapter 5 Additional Configuration Options

Configure Services

CONFIGURE SERVICES
Usethefollowinginstructionstochangetheoperatingstateand
configurationofaservice.

Configure the SNMP Service


1. Fromthemenubar,selectConfiguration > Servicestodisplaythe
Servicesscreen.

Figure 33 The Services screen.


2. DoubleclicktheSNMPservice,orselecttheSNMPserviceandselect
Action > Show Details.TheSNMPdetailsscreendisplays.
3. OntheSNMPdetailsscreen,selectAction > Edit.TheEditSNMP
Servicedialogboxdisplays.

Figure 34 The Edit SNMP Service dialog box.


4. Ifdesired,changethevalueoftheCommunity String.Anyincoming
SNMPqueriesthatuseadifferentcommunitystringthantheoneset
herefail.Ifnocommunitystringisspecified,thentheBlackPearl
gatewayrespondstoallSNMPqueries.
5. EntertheprimarycontactfortheBlackPearlgatewayintheContact
field.
6. EnterthephysicallocationofthegatewayintheLocationfield.

July 2016

User GuideSpectra BlackPearl Gateway

80

Chapter 5 Additional Configuration Options

Configure Services

7. Ifdesired,addclientsthatareallowedtoaccessthegatewayusingSNMP.

Figure 35 The Edit SNMP Service dialog box.


a. Clickthe+signtoaddaclient.
b. EnterthehostIPaddressintheHostfield.
c. Ifdesired,selecttheNotificationscheckboxtoindicatethatthe
SNMPclientshouldreceiveoutgoingnotifications.
d. EntertheportnumbertobeusedforSNMPcommunicationinthe
Portfield.
e. EnteracommunitystringvalueintheCommunity Stringfield.This
communitystringissetforeachclient.TheclientsmonitorSNMP
notificationsforanythatusethestringspecifiedhere.
f. RepeatStep athroughStep easneededtoaddadditionalclients.
8. ClickSave.

Download the MIB File


IfyouwanttocommunicatewiththegatewayusingSNMP,youmustfirst
downloadtheBlackPearlMIB(ManagementInformationBase)file,and
loadthefileintoacompatiblenetworknodemanagerprogram,suchas
HPOpenView.
1. SelectConfiguration > ServicestodisplaytheServicesscreen(see
Figure 33onpage 80).
2. DoubleclicktheSNMPservicerow,orselecttheSNMPservicerow
andselectAction > Show Details.TheSNMPdetailsscreendisplays.

July 2016

User GuideSpectra BlackPearl Gateway

81

Chapter 5 Additional Configuration Options

Configure Services

3. ClickDownload MIB.Usingyourwebbrowser,savethefiletoyourlocal
host.

Figure 36 Download the MIB file.


4. Loadthefileintothenetworknodemanagerprogram.
5. Youcannowuseyournetworknodemanagerprogramto
communicatewiththeBlackPearlgateway,usingthesettings
configuredinConfiguretheSNMPServiceonpage 80.

Configure the Spectra S3 Service


1. Fromthemenubar,selectConfiguration > Servicestodisplaythe
Servicesscreen(seeFigure 33onpage 80).

Figure 37 The Services screen.


2. DoubleclicktheS3service,orselecttheS3serviceandselectAction >
Show Details.TheS3detailsscreendisplays.

July 2016

User GuideSpectra BlackPearl Gateway

82

Chapter 5 Additional Configuration Options

Configure Services

3. OntheS3servicedetailsscreen,selectAction > Edit.TheEditS3


Servicedialogboxdisplays.

Figure 38 The Edit S3 Service dialog box.


4. Usingthedropdownlist,selectthePortusedfortheHTTPconnection
totheS3service.
Note: TheHTTPSconnectionisalwaysavailableonport443.
5. EnteravalueinminutesintheAuto-Activate Timeoutentryfield.This
valuespecifiestheamountoftimethatmustpassbetweentheS3data
pathbackendshutdowntostartupbeforeitwillnotbeautoactivated.
Forexample,ifthegatewayispoweredoffforlongerthanthespecified
timeoutvalue,youmustmanuallyrestarttheS3datapathbackend
afterpoweringonthegateway.
Notes:

Tomanuallystartthedatapathbackend,seeManually
StartingtheS3DataPathBackendonpage 146.
IftheAuto-Activate Timeout issetto0,thedatapathbackend
willneverautoactivate.

6. Usingthedropdownmenu,selectabehaviorforAuto-Inspect.This
settingconfigureswhethertapeinspectionsareperformedbythe
gatewaybasedonatapeslastknownstate,oreachtimetheBlackPearl
isinitialized.

July 2016

Value

Description

Default

Tapesarescheduledforinspectionifaninspectionis
necessarygiventhetapescurrentstate,aswellasevery
timetheBlackPearlgatewayisinitialized.

Minimal

Tapesarescheduledforinspectionifaninspectionis
necessarygiventhetapescurrentstate.

Never

Tapesarenotautomaticallyscheduledforinspection.

User GuideSpectra BlackPearl Gateway

83

Chapter 5 Additional Configuration Options

Configure Services

7. Enteravalue,inminutes,forUnavailable Tape Partition Max Job Retry.


Thissettingspecifiesthemaximumnumberofminutesthatcanelapse
betweenthefirstfailedattempttoGETorVERIFYjobdata(duetoa
tapepartitionbeingoffline,inanerrorstate,ordeactivated),beforea
subsequentfailurewilltriggeraretrytoprocessthejobdata.Thisonly
appliestoGETorVERIFYjobs.
8. Enteravalue,inminutes,forUnavailable Pool Max Job Retry.This
settingspecifiesthemaximumnumberofminutesthatcanelapse
betweenthefirstfailedattempttoGETorVERIFYjobdata(duetoa
poolpartitionbeingoffline,inanerrorstate,ordeactivated),beforea
subsequentfailurewilltriggeraretrytoprocessthejobdata.Thisonly
appliestoGETorVERIFYjobs.
9. Usingthedropdownmenu,selectabehaviorforUnavailable Media
Policy.Thissettingconfigureshowthegatewaybehaveswherethereis
unavailabletapeordiskpartitionswhencreatingnewjobsorretrying
toprocessjobdata.
Value

Description

Allow

Newjobrequestsforunavailablemediaareallowedand
willretryforthedurationoftheUnavailable Tape
Partition Max Job RetryorUnavailable Pool Max Job
Retry setting.

Discouraged

Unavailablepartitionscanbeused,butonlyifnoother
mediaisavailable.

Disallow

Newjobrequestsforunavailablemediafail.

10. Usingthedropdownmenu,selectabehaviorfortheDefault Conflict


Resolution Mode.Thissettingsetsthedefaultbehaviorforthegateway
whenimportingaforeignobjecttoanexistingbucket.
Value

Description

Cancel

Aborttheimportprocessifafilenameconflictis
discovered.

Accept Most Recent

Keepthefilewiththemostrecentcreationdate.

Accept Existing

KeepthefilecurrentlyintheBlackPearldatabase.

11. ClickSave.

July 2016

User GuideSpectra BlackPearl Gateway

84

Chapter 5 Additional Configuration Options

Configure Network Connections and Settings

CONFIGURE NETWORK CONNECTIONS AND SETTINGS


UsetheNetworkscreentoeditthesystemname,configureEthernetports
andDNSsettings,andtoenterSMTPandNTPinformation.

Figure 39 The Network screen.

Edit the System Name


1. Fromthemenubar,selectConfiguration > Network,orclickthe
NetworkpanefromtheDashboardscreen.TheNetworkscreen
displays.
2. IntheNetworkInterfacespane,doubleclickthesystemname,orselect
thesystemnameandthenselectAction > Edit.TheEditSystemName
dialogboxdisplays.

Figure 40 The Edit System Name dialog box.


3. EnterthedesiredNameforthesystem,andclickSave.

July 2016

User GuideSpectra BlackPearl Gateway

85

Chapter 5 Additional Configuration Options

Configure Network Connections and Settings

Configure Ethernet Ports


ThissectiondescribesusingtheBlackPearluserinterfacetoconfigurethe
IPaddressingfortheEthernetportsintheBlackPearlgateway.The
gatewayincludestwo10GigEportsontherearpanel(seeFigure 5on
page 22).
Notes:

YoucanonlyusetheBlackPearlmanagementporttoaccess
theBlackPearluserinterface.Youcannotusethisportfor
datatransfer.
Youcanonlycreateonedataconnectiontothegateway.You
canconfigurelinkaggregationforbetterperformance.
ThedataconnectionandBlackPearlmanagementportare
initiallyconfiguredinChapter 2 InitialConfigurationon
page 30.Usetheinstructionsinthissectiontoconfigure
networksettingsafterinitialsetupiscomplete.
Thenextstepsdependonifyouareconfiguringthedataconnection,the
managementport,orwanttodelete(clear)anetworkconfiguration.

ConfiguretheDataConnectiononpage 38

ConfiguretheManagementPortonpage 86

ClearanEthernetConfigurationonpage 87

Configure the Management Port


1. Fromthemenubar,selectConfiguration > Network,orclickthe
NetworkpanefromtheDashboardscreen.TheNetworkscreen
displays(seeFigure 39onpage 85).
2. IntheNetworkInterfacespane,doubleclicktheManagementrow,or
selecttheManagementrowandthenselectAction > Edit.TheEdit
Managementdialogboxdisplays.

Figure 41 The Edit Management dialog box.

July 2016

User GuideSpectra BlackPearl Gateway

86

Chapter 5 Additional Configuration Options

Configure Network Connections and Settings

3. SelecteitherDHCPorStaticastheaddressingmethod.

Important

If you select DHCP, you are not able to see the IP address assigned by DHCP before
you are logged out of the BlackPearl user interface. Contact your system
administrator to determine the DHCP address for the management port.

Ifyouselectstaticaddressing,enterthefollowinginformation:

IP AddressEnteravalidIPv4address.

NetmaskEnterthesubnetmask.

Default GatewayEnterthedefaultnetworkgateway.

4. ChangetheMTUvalue,ifdesired.IfyousettheMTUvalueto
somethingotherthan1500,ensurethatyourswitchconfiguration
supportslargerMTUsettings,aswellasallthehostsonthenetwork.
5. ClickSave.
Note: WhenyouchangetheIPaddressoftheBlackPearlmanagement
port,youloseyourconnectiontotheuserinterfacewhenyou
saveyourchanges.Toreestablishtheconnection,enterthenew
IPaddressinyourbrowserandloginagain.

Clear an Ethernet Configuration


Insomecases,itmaybeusefultodeleteanexistingEthernetconfiguration
byclearingit.UsetheinstructioninthissectiontoclearanEthernet
configuration.
1. Fromthemenubar,selectConfiguration > Network,orclickthe
NetworkpanefromtheDashboardscreen.TheNetworkscreendisplays
(seeFigure 39onpage 85).
2. Selecttherowoftheconfigurationyouwanttoclearandselect
Action > Clearfromthemenubar.Aconfirmationwindowdisplays.
3. ClickDeletetocleartheEthernetconfiguration.

Configure DNS Settings


TheDNSsettingsontheBlackPearlgatewayareusedtoallowdomain
namelookuponthegateway.UsethefollowinginstructionstoenterDNS
informationonthegateway.
1. Fromthemenubar,selectConfiguration > Network,orclickthe
NetworkpanefromtheDashboardscreen.TheNetworkscreen
displays(seeFigure 39onpage 85).

July 2016

User GuideSpectra BlackPearl Gateway

87

Chapter 5 Additional Configuration Options

Configure Network Connections and Settings

2. IntheDNSpaneoftheNetworkscreen,doubleclickthesinglerow,or
selecttherowandthenselectAction >Edit.TheEditDNSscreen
displays.

Figure 42 Edit DNS information.


3. SelectDHCPtohavethegatewaydeterminetheaddressofnameservers
andsearchdomainsautomatically.
OR
SelectManualtoenterinformationfornameserversandsearch
domainsmanually.
Note: ThebuttonsforDHCPandManualareonlyusablewhenthe
BlackPearlmanagementportisconfiguredasDHCP.Ifthe
managementinterfaceissettoastaticIPaddress,thebuttonsare
greyedout,andtheinformationmustbeenteredmanually.
4. IftheBlackPearlmanagementportisconfiguredwithastaticIP
address,orifyouselectedManual,enterthefollowinginformation:
a. EntertheIPaddressofoneormorenameserversintheName
Serversfield.
b. EntertheURLofoneormoresearchdomainsintheSearch Domains
field.
5. ClickSave.

Configure SMTP Settings


UsetheEmailsettingstoassociatetheBlackPearlgatewaywithamail
server.ThegatewayusesthisSMTPservertosendemailswheneverASLs
orcertaintypesofmessagesaregenerated.

July 2016

User GuideSpectra BlackPearl Gateway

88

Chapter 5 Additional Configuration Options

Configure Network Connections and Settings

UsethefollowinginstructionstoenterSMTPinformationonthegateway.
1. Fromthemenubar,selectConfiguration > Network,orselectthe
NetworkpanefromtheDashboardscreen.TheNetworkscreen
displays.

Figure 43 The SMTP pane of the Network screen.


2. DoubleclickthenameoftheSMTPserver,orselectthenameofthe
SMTPserverandthenclickAction > Edit.TheEmaildialogbox
displays.

Figure 44 The Email dialog box.


3. EntertheSMTP ServerandSMTP Portinformation.
4. IfyourSMTPserverusesTLS(TransportLayerSecurity)
authentication,selecttheEnable TLS Authenticationcheckboxandenter
therequiredusernameandpasswordinformation.
5. EnteranemailaddressintheFrom Addressfield.Thisistheemail
addressthatdisplaysasthesenderwheneverthegatewaygeneratesan
email.ThisemailaddressshoulduniquelyidentifytheBlackPearl
gatewaytoassistintroubleshootingandberecognizedbytheSMTP
serverasavaliddomainaddress.
6. ClickSave.

July 2016

User GuideSpectra BlackPearl Gateway

89

Chapter 5 Additional Configuration Options

Configure Users

Configure Date and Time


ThedateandtimecanbesetmanuallyorusingNTP(NetworkTime
Protocol).TheNTPsettingsareusedtoaccuratelycontrolthecurrenttime
ontheBlackPearlgateway.Usethefollowinginstructionstoconfigurethe
dateandtimeonthegateway.
1. Fromthemenubar,selectConfiguration > Network,orselectthe
NetworkpanefromtheDashboardscreen.TheNetworkscreen
displays.

Figure 45 The Date and Time pane of the Network screen.


2. DoubleclicktheSystemTimetoedit thedateandtime,orselectthe
SystemTimerowandselectAction > Edit.TheTimeSettingsdialog
boxdisplays.

Figure 46 The Time Settings dialog box.


3. SelectManualorNTP.
a. IfyouselectManual,enterthecurrenttimeintheTimefield.Enter
either12hourtimevaluesandincludeAMorPM,oruse24hour
timevalues.ClicktheemptyDatefield.Acalendarappears.Select
thecurrentdate.
b. IfyouselectNTP,entertheNTPserverinformationforthePrimary
NTP Server.Ifdesired,entertheNTPserverinformationforthe
Secondary NTP Server.

CONFIGURE USERS
UsetheinstructionsinthissectiontocreateanewS3usergroup,edit
existingusers,changepasswords,andconfigurethesessiontimeout
setting.Tocreatenewusers,seeCreateaUseronpage 40.

July 2016

User GuideSpectra BlackPearl Gateway

90

Chapter 5 Additional Configuration Options

Configure Users

Description of User Types


TherearethreedifferenttypesofusersintheBlackPearluserinterface.The
primaryadministrator,themonitoruser,andS3Users.Additionally,users
canbecombinedwithotherusersintoS3groups,inwhichallmembersof
thegroupsharethesamepermissions.Usethetablebelowfora
descriptionoftheusertypes.
User

Description

Primary
Administrator

Theprimaryadministratoraccountiscreatedbydefault.
ThisaccountcanaccesstheBlackPearluserinterfaceand
hasfullcontroloveralluserinterfacefunctions.This
accountcanseejobscreatedbyanyS3user.
Note: Youcannotcreateadditionalprimary
administratoraccounts.

Monitor User

Themonitoruseraccountiscreatedbydefault.This
accountcanaccesstheBlackPearluserinterfacebutcannot
useanyfunctionsoftheuserinterface.Thisaccountcan
seejobscreatedbyanyS3user.Thisaccountisusefulif
youneedtoviewthestatusofS3jobs,oranyotheraspect
oftheuserinterface,butdonothaveaccesstotheprimary
administratoraccount.
Note: Youcannotcreateadditionalmonitoruser
accounts.

S3 Users

S3usersarecreatedforuseasbucketowners.S3users
cannotaccesstheBlackPearlwebinterface.

Create New S3 Group


AnS3groupontheBlackPearlgatewayisagroupofpreviouslycreatedS3
users.MembersofanS3groupcanbeindividualusers,orgroupsofusers.
WhencreatinganS3group,youspecifytheglobalbucketanddatapolicy
accesscontrollists.

July 2016

User GuideSpectra BlackPearl Gateway

91

Chapter 5 Additional Configuration Options

Configure Users

UsetheinstructionsinthissectiontocreateanewS3group.
1. Fromthemenubar,selectConfiguration > Users. TheUsersscreen
displays.

Figure 47 The Users screen.


2. SelectAction > New S3 Group fromthemenubar.TheNewS3Group
dialogboxdisplays.

Figure 48 The New S3 Group dialog box.


3. EnterthedesiredNameforthegroup.

July 2016

User GuideSpectra BlackPearl Gateway

92

Chapter 5 Additional Configuration Options

Configure Users

4. Addmemberstothegroup.
a. UndertheMemberspane,clickAdd.Anewentrydisplaysunderthe
Nameheader.
b. Usingthedropdownlist,selectthepreviouslycreateduserorS3
grouptoaddasamemberofthisgroup.
c. RepeatstepsStep athroughStep btoaddadditionalmembers.
5. SelectorclearoptionsfortheGlobal Bucket Access Control List.These
optionsgiveordenypermissionforthegroupbeingcreatedtoperform
theactiondescribedinthetablebelow,forallbucketspresentonthe
gateway,aswellasanybucketscreatedatafuturedate.
Note: TheaccesscontrollistoptionsselectedforanS3group
complementtheoptionspreviouslyselectedforeachmemberof
thegroup.Forexample,ifauserhasReadpermissionandis
addedtoanS3groupthathasWritepermission,theusernow
hasbothReadandWritepermissions.
Name

Description

List

TheS3groupcanseethebucketandcanlisttheobjectsin
abucket.

Read

TheS3groupcangetobjectsandcreateGETjobs.

Write

TheS3groupcanputobjectsandcreatePUTjobs.

Delete

TheS3groupcandeleteobjects,butcannotdeletethe
bucket.

Job

TheS3groupcanmodifyorcanceljobscreatedbyother
users.TheS3groupcanalsoseethedetailsofjobs
createdbyotherusers.
Note: Alluserscanviewalljobs,butbydefault,only
theinitiatorofthejobcanseethefulldetailsofajob.

Owner

TheS3groupreceivesfullaccesstoallbuckets,including
allpermissionslistedabove.

6. UnderGlobal Data Policy Access Control List,selectthecheckboxto


allowtheuseraccesstoanydatapolicycreatedonthegateway.
7. ClickCreatetocreatethenewS3group.
8. Ifdesired,repeatStep 2onpage 92throughStep 7tocreateadditional
S3groups.

Edit a User
1. Fromthemenubar,selectConfiguration > Users.TheUsersscreen
displaysalistofallconfiguredusers(seeFigure 18onpage 40).

July 2016

User GuideSpectra BlackPearl Gateway

93

Chapter 5 Additional Configuration Options

Configure Users

2. Doubleclickthenameoftheuseryouwanttoedit,orselecttheuser
andthenselectAction > Edit.TheEditUsersdialogboxdisplays.

Figure 49 The Edit User dialog box.


3. Ifdesired,edittheusersFull Name.
4. Ifdesired,edittheUsernamefortheuser.TheUsernamecannotcontain
capitallettersorspaces.
5. Ifdesired,changetheEmailaddressfortheuser.
Note: Thegatewaydoesnotusethissettingforanypurposeatthis
time.
6. Fromthedropdownlist,selectaRolefortheuser.
Note: YoucanonlyconfigureuserswitharoleofUseratthistime.
7. TheS3 Access IDandS3 Secret Keyfieldsaregeneratedautomatically
Onceauseriscreated,anewS3secretkeycanbegenerated.See
ChangeS3SecretKeyonpage 95.
8. Fromthedropdownlist,selectaDefault Data Policyfortheuser.If
specified,thegatewayusestheselecteddatapolicyforallbuckets
createdbytheuser,unlessadifferentpolicyisspecifiedduringbucket
creation.
9. SelectorclearoptionsfortheGlobal Bucket Access Control List.These
optionsgiveordenypermissionfortheuserbeingcreatedtoperform
theactiondescribedinthetablebelow,forallbucketspresentonthe
gateway,aswellasanybucketscreatedatafuturedate.

July 2016

Name

Description

List

Theusercanseethebucketandcanlisttheobjectsina
bucket.

Read

TheusercangetobjectsandcreateGETjobs.

Write

TheusercanputobjectsandcreatePUTjobs.

User GuideSpectra BlackPearl Gateway

94

Chapter 5 Additional Configuration Options

Configure Users

Name

Description

Delete

Theusercandeleteobjects,butcannotdeletethebucket.

Job

Theusercanmodifyorcanceljobscreatedbyotherusers.
Theusercanalsoseethedetailsofjobscreatedbyother
users.
Note: Alluserscanviewalljobs,butbydefault,only
theinitiatorofthejobcanseethefulldetailsofajob.

Owner

Theuserreceivesfullaccesstoallbuckets,includingall
permissionslistedabove.

10. UnderGlobal Data Policy Access Control List,selectthecheckboxto


allowtheuseraccesstoanydatapolicycreatedonthegateway.
11. ClickSave.

Change S3 Secret Key


IfanS3secretkeyiscompromised,oryouotherwisewanttochangeit,use
theinstructionsinthissectiontochangeanS3secretkeyforauser.
1. Fromthemenubar,selectConfiguration > Users.TheUsersscreen
displaysalistofallconfiguredusers(seeFigure 18onpage 40).
2. SelecttheuserforwhichyouwanttochangetheS3secretkey,andthen
selectAction > Change S3 Secret Key.TheChangeS3SecretKey
windowdisplays.

Figure 50 The Change S3 Secret Key dialog box.


3. SelecteitherGenerate Key AutomaticallyorEnter Specific Key.
4. Optionally,ifyouselectedEnter Specific Key,enterthedesiredkeyin
theentrybox.
5. ClickChangetochangetheS3secretkeyfortheuser.

Delete a User
1. Fromthemenubar,selectConfiguration > Users.TheUsersscreen
displaysalistofallconfiguredusers(seeFigure 18onpage 40).

July 2016

User GuideSpectra BlackPearl Gateway

95

Chapter 5 Additional Configuration Options

Configure Users

2. Selecttheuseryouwanttodelete,andthenselectAction > Delete.A


confirmationwindowdisplays.
3. ClickDeletetodeletetheuser.

Change Password and Session Timeout Setting


Usetheinstructionsinthissectiontochangethepasswordorconfigure
sessiontimeoutsettingsforthePrimaryAdministratororMonitorUser.
OnlythePrimaryAdministratorandMonitorUsercanaccessthe
BlackPearluserinterface.ToedittheotherparametersofthePrimary
AdministratororMonitorUser,seeEditaUseronpage 93.
1. Fromthemenubar,selectConfiguration > Users.TheUsersscreen
displaysalistofallconfiguredusers(seeFigure 18onpage 40).
2. DoubleclicktheSpectraaccountinthePrimaryAdministratorspane,
ortheMonitoraccountintheMonitorUserspanel,andthenselect
Action > Edit.TheEditUserdialogboxappears.

Figure 51 The Edit User dialog box.


3. Ifdesired,edittheadministratorsFull Name.
4. Ifdesired,edittheUsernamefortheadministratorormonitoruser.The
Usernamecannotcontaincapitallettersorspaces.
5. Ifyouarechangingthepassword,enterthecurrentpasswordandthen
enterthedesirednewpassword.Confirmthenewpassword.
Note: Ifyouareonlychangingthesessiontimeout,leavethepassword
fieldsblank.Thepasswordisnotchanged.
6. Ifdesired,enterthevalueforthesessiontimeoutinminutes.Thisvalue
cannotexceed999minutes.
July 2016

User GuideSpectra BlackPearl Gateway

96

Chapter 5 Additional Configuration Options

Configure Certificates

7. TheS3 Access IDandS3 Secret Keyfieldsaregeneratedautomatically


andcannotbechangedatthistime.SeeChangeS3SecretKeyon
page 95forinformationonchangingtheS3SecretKey.
8. Whenchangingthepasswordorsettinganewtimeoutvalue,leavethe
Default Data Policy,Global Bucket Access Control List,andGlobal Data
Policy Access Listoptionsasis.
9. ClickSavetosavethenewpasswordandsessiontimeoutsetting.
Note: Thenewpassworddoesnottakeeffectuntilafteryoulogoutof
theBlackPearluserinterface(seeExittheBlackPearlUser
Interfaceonpage 149).

CONFIGURE CERTIFICATES
TheBlackPearlgatewayshipswithnonsignedSSLcertificatesforboththe
dataandmanagementportsonthegateway.Becausethecertificatesare
notsigned,youmustpassasecuritycheckeverytimeyouattemptto
accessthemanagementporttoviewtheBlackPearluserinterface,orwhen
youattempttotransferdatausingthedataport.
Ifdesired,youcaninstallsigned,trustedSSLcertificatesforyourdataand
managementportssothatyounolongerneedtopassthesecuritycheck
whenaccessingtheseports.
UsetheinstructionsinthissectiontoinstallanSSLcertificate.
1. Fromthemenubar,selectConfiguration > Certificates.TheCertificates
screendisplays.

Figure 52 The Certificates screen.


2. SelecteithertheManagementorDatarow,dependingonforwhichport
youwanttoinstallanewSSLcertificate.

July 2016

User GuideSpectra BlackPearl Gateway

97

Chapter 5 Additional Configuration Options

Configure Buckets

3. SelectAction > Import Certificate.TheImportCertificatedialogbox


displays.

Figure 53 The Import Certificate dialog box.


4. FromyoursourceSSLcertificatefile,copythecertificateportionofthe
fileintoyourhostscache,andthenpastethecontentsintothe
Certificateentrybox.
Note: ThecertificatemustbeinPEMformat.
5. FromyoursourceSSLcertificatefile,copytheprivatekeyportionofthe
fileintoyourhostscache,andthenpastethecontentsintothePrivate
Key entrybox.
Note: TheprivatekeymustbeinPEMformat.
6. ClickSave.

CONFIGURE BUCKETS
Usetheinstructionsinthissectiontoeditordeleteabucket.For
instructionsoncreatinganewbucket,seeCreateaBucketonpage 76.

Edit a Bucket
Usetheinstructionsinthissectiontochangetheownerofabucket,change
thedatapolicyusedbythebucket,ortochangetheaccesscontrollistfor
thebucket.
1. Fromthemenubar,selectConfiguration > Buckets.TheBucketsscreen
displays(seeFigure 31onpage 76).

July 2016

User GuideSpectra BlackPearl Gateway

98

Chapter 5 Additional Configuration Options

Configure Buckets

2. SelectthebucketyouwanttoeditandselectAction > Edit.TheEdit


Bucketdialogboxdisplays.

Figure 54 The Edit Bucket dialog box.


3. Thebucketnameisgreyedoutandcannotbechanged.
4. Fromthedropdownlist,changetheOwnerassignedtothebucket.

Important

After changing bucket owners, you may need to reconfigure your client application
to access the bucket.

5. UsetheData Policydropdownmenutochangedatapolicyassignedto
thebucket.Formoreinformationondatapolicies,seeDataPolicieson
page 46.
6. Addmemberstotheaccesscontrollistforthebucket.
a. UnderAccess Control Lists,clickAddtoaddanewmembertothe
accesscontrollist.
b. UsethedropdownmenuintheNamecolumntoselectauserorS3
group.
c. SelectorclearoptionsinthePermissionscolumntoallowordeny
thatpermissionfortheuserorgroupselectedinStep a.Seethetable
belowforadescriptionofeachpermissiontype.

July 2016

Name

Description

List

Theusercanseethebucketandcanlisttheobjectsina
bucket.

Read

TheusercangetobjectsandcreateGETjobs.

Write

TheusercanputobjectsandcreatePUTjobs.

Delete

Theusercandeleteobjects,butcannotdeletethebucket.

Job

Theusercanmodifyorcanceljobscreatedbyotherusers.
Theusercanalsoseethedetailsofjobscreatedbyother
users.
Note: Alluserscanviewalljobs,butbydefault,only
theinitiatorofthejobcanseethefulldetailsofajob.

User GuideSpectra BlackPearl Gateway

99

Chapter 5 Additional Configuration Options

Configure Buckets

Name

Description

Owner

Theuserreceivesfullaccesstoallbuckets,includingall
permissionslistedabove.

d. Ifdesired,repeatStep athroughStep ctoaddadditionalusersor


groups.
e. Ifdesired,removeauserorgroupfromtheaccesscontrollistby
clickingRemove.
7. ClickSave.

Delete a Bucket
Usetheinstructionsinthissectiontodeleteabucket.

Caution

When you delete a bucket, all data contained in the bucket is lost. Any tapes
associated with the bucket are marked as Free, and are available to the gateway for
other storage operations immediately. Any bucket data that was written to tape
media is retained until the tape is loaded into a drive and new data is written.

1. Fromthemenubar,selectConfiguration > Buckets.TheBucketsscreen


displays(seeFigure 31onpage 76).
2. SelectthebucketyouwanttodeleteandselectAction > Delete.A
confirmationdialogboxdisplays.

Figure 55 The bucket delete confirmation


dialog box.
3. TypeDELETEintotheentryfield,andthenclickDelete.

July 2016

User GuideSpectra BlackPearl Gateway

100

Chapter 5 Additional Configuration Options

Configure Disk Pools

CONFIGURE DISK POOLS


Usetheinstructionsinthissectiontocreate,delete,orimportadiskpool.

Create Online Disk Pool


IfyouaddaBlackPearlexpansionnodetotheBlackPearlgateway,or
otherwisemakeonlinedisksavailableforuse,usetheinstructionsinthis
sectiontocreateanewonlinediskpool.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen(see
Figure 26onpage 63).
2. SelectAction > New Online Disk Pool.TheNewOnlineDiskpool
dialogboxdisplays.

Figure 56 The New Online Disk Pool dialog box.


3. Usingthedropdownmenu,selectthetypeofpoolyouwanttocreate.
Onlyvalidpoolconfigurationoptionsdisplay,youcannotcreatepools
outsideofthepreconfiguredsizes.
4. ClickCreate Pool.ThenewonlinediskpoolislistedontheAdvanced
BucketManagementscreen.

Delete Online Disk Pool


Ifyouwanttodeleteanonlinediskpool(forexample,tocreatealarger
poolafteraddingadditionaldiskstothesystem)usetheinstructionsin
thissectiontodeleteanonlinediskpool.
Note: Youmustdeleteallobjectscontainedintheonlinediskpool
beforeyoucandeletethepool.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen(see
Figure 26onpage 63).

July 2016

User GuideSpectra BlackPearl Gateway

101

Chapter 5 Additional Configuration Options

Configure Disk Pools

2. SelecttheonlinepoolyouwanttodeleteintheStoragePoolspane,and
selectAction > Delete Online Disk Pool.TheAreYouSureconfirmation
windowdisplays.

Figure 57 The Are You Sure confirmation window.


3. EnterDeleteintotheentryfieldandclickDelete.Theonlinediskpool
isdeleted.

Import Disk Pool


DatapresentonnearlinestoragepoolsonArcticBlueexpansionnodescan
bemovedfromoneBlackPearlgatewaytoanother,eithertoincreasename
spaceredundancy,oraspartofdisasterprevention.Usetheinstructionsin
thissectiontoimportapool.
1. EnsuretheArcticBlueexpansionnodecontainingthepoolyouwantto
importiscabledtotheBlackPearlgatewaymasternode.
2. EnsurethesettingsfortheSpectraS3serviceDefault Conflict Resolution
Mode aresettoyourpreference.SeeConfiguretheSpectraS3Service
onpage 82formoreinformation.
3. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen(see
Figure 26onpage 63).

July 2016

User GuideSpectra BlackPearl Gateway

102

Chapter 5 Additional Configuration Options

Configure Disk Pools

4. DiskpoolseligibleforimportdisplaywithahealthofForeign.Selectthe
nearlinepoolyouwanttoimportintheStoragePoolspane,andselect
Action > Import Pool.TheImportdialogboxdisplays.

Figure 58 The Import dialog box.


5. Configuretheimportparametersforexistingbucketspresentonthe
storagepool.
a. TheSystem Default Conflict Resolution Modeisconfiguredwhen
editingtheSpectraS3serviceandisnoteditableinthisdialogbox.
SeeConfiguretheSpectraS3Serviceonpage 82formore
information.
b. Usingthedropdownmenu,selectabehaviorforObject Conflict
Resolution Mode.Thissettingconfigureshowthegatewayhandlesa
filenameconflictwhenimportingforeignobjectsonthestorage
pooltoanexistingbucket.
Value

Description

Use system default

ThegatewayusesthebehaviordisplayedintheSystem
Default Conflict Resolution Mode rowoftheImport
dialogbox.

Cancel

Aborttheimportprocessifafilenameconflictis
discovered.

Accept Most Recent

Keepthefilewiththemostrecentcreationdate.

Accept Existing

KeepthefilecurrentlyintheBlackPearldatabase.

6. Configuretheimportparametersfornewbucketspresentonthe
storagepool.
a. Usingthedropdownmenu,selecttheUsertobetheownerofthe
importedbucket(s).
b. Usingthedropdownmenu,selecttheData Policytouseforthe
importedbucket(s).
c. Usingthedropdownmenu,selecttheStorage Domaintouseforthe
importedbucket(s).
7. ClickImport.
July 2016

User GuideSpectra BlackPearl Gateway

103

CHAPTER 6
Working with Tape Libraries
and Media
ThischapterdescribesusingtheBlackPearluserinterfacetoperformtasks
relatingtotapelibrariesandtapemedia.
Task
FormatTapes

page 105

InspectTapes

page 107

EjectTapes

page 108

EditTapeEjectInformation

page 108

EjectaSingleTape

page 109

CancelTapeEjection

page 110

ImportTapes

page 111

ImportForeignTapes

page 112

ManageTapesNotinInventory

page 113

MarkTapeasEjected

page 113

DeleteLostorEjectedTape

page 114

PutaTapeLibraryPartitioninStandbyMode

page 114

ActivateaTapeLibraryPartition

page 115

104

Chapter 6 Working with Tape Libraries and Media

Format Tapes

FORMAT TAPES
Ifyouimportnewtapesintothelibrary,theymustbeformattedbefore
theycanbeusedbythegateway.Usetheinstructionsinthissectionto
formattapes.
Forinformationonincreasinglibrarycapacity,andimportingorexporting
tapemedia,seeyourlibraryUserGuide,availableontheSupportPortal
websiteatsupport.spectralogic.com/documentation.

Caution

Any data currently on the tape media is lost during the format operation.

TapesarenoteligibleforformattingiftheyhaveastateofEJECTED,LOST,
EJECT_PENDING,orOFFLINE.Inaddition,theForceparametermustbe
usedtoformatatapethatcontainsdatawrittenbyaBlackPearlgateway,to
formatatapebeforeitisinspected,toformatatapethathasalreadybeen
formattedbyaBlackPearlgateway,ortoformatatapethatcurrentlyhas
readsorwritesscheduled.Ifatapecontainsdatawrittenbythecurrent
BlackPearlgateway,youmustdeletetheobjectsandbucketsbefore
formattingthetapeeveniftheforceparameterisselected.
1. Fromthemenubar,selectStatus > Tape Management. TheTape
Managementscreendisplays.Anyunformattedtapesdisplayastateof
UnknownontheTapeManagementscreen.

Figure 59 The Tape Management screen.

July 2016

User GuideSpectra BlackPearl Gateway

105

Chapter 6 Working with Tape Libraries and Media

Format Tapes

2. SelectthetapecartridgeyouwanttoformatandselectAction > Format


Tape,ortoformatalltapeswithastateofUnknown,selectAction >
Format All Unmanaged Tapes.Aconfirmationscreendisplays.

Figure 60 The Format Tape confirmation dialog


box.

Figure 61 The Format All Unmanaged Tapes


confirmation dialog box.

3. Ifdesired,selecttheForceoption.
Note: IftheselectedtapecontainsdatafromtheBlackPearlgateway,
youcannotformatthetapeunlessyouselecttheForceoption.

Important

Do not use the Force option to force a format on a cleaning tape. If you do so the
cleaning tape is set to expired and no longer usable for cleaning drives.

4. EnterFORMATintheentryfieldandclickFormat Tape,or Format All


Unmanaged Tapes.Thegatewayinstructsthelibrarytoloadtheselected
tapesintotapedrivesconfiguredinthelibrary,toformatthetape(s)for
LTFS.ThisistheformatusedbytheBlackPearlgateway.Thisprocess
cantakeupto5minutespertape.

July 2016

User GuideSpectra BlackPearl Gateway

106

Chapter 6 Working with Tape Libraries and Media

Inspect Tapes

INSPECT TAPES
Tapesarenormallyinspectedautomaticallybythegateway.Ifyouusethe
tapelibrarysBlueScaleInterfacetomoveatapecartridgeinapartition
associatedwithaBlackPearlgateway,thetapemaytransitiontothe
PendingInspectionstate(seeStateonpage 126)andbecomeunusableby
thegateway.Toreturnthecartridgetoausablestate,manuallyrequestan
inspectionofthecartridge.
Usetheinstructionsinthissectiontoinspectatape.
1. Fromthemenubar,selectStatus > Tape Management. TheTape
Managementscreendisplays.Anytapesrequiringinspectiondisplaya
stateofPendingInspectionontheTapeManagementscreen.

Figure 62 The Tape Management screen.


2. Selectthetapeyouwanttoinspect,andthenselectAction > Inspect.
TheInspectTapedialogboxdisplays.

Figure 63 The Inspect Tape dialog box.


3. ClickInspecttobegininspectingthetape.

July 2016

User GuideSpectra BlackPearl Gateway

107

Chapter 6 Working with Tape Libraries and Media

Eject Tapes

EJECT TAPES
TapemediaandthedatatheycontaincanberemovedfromtheBlackPearl
gatewaybyejectingthem.Oncetapesareejectedfromthegateway,they
canbeimportedintoanotherBlackPearlgateway,orstoredoffsite.
AlwaysstoretapesejectedfromtheSpectratapelibraryinTeraPack
magazines.Whentapesareoutsidethelibrary,SpectraLogicrecommends
storingtheminmagazineswithdustcovers.SeeStoringCartridgesin
yourlibraryUserGuideformoreinformation.

Important

Do not use the tape library front panel or RLC connection to move tape cartridges
while the tape library is under the control of the BlackPearl gateway.

Tapesareejectedoneatatime.Usetheinstructionsbelowtoejectoneor
moretapesfromtheBlackPearlgateway.
Note: SpectraT50eandT120librariesmustbeconfiguredinStandard
ejectmodetoejecttapes.Ifyourlibraryhasonlyonepartition,it
isalreadyinStandardejectmode.Ifthereismorethanone
partition,includingacleaningpartition,youmustdelete
partitionsuntilonlyoneremains,andthenedittheremaining
partitiontouseStandardmode.SeeyourlibraryUserGuidefor
moreinformationonpartitionmanagement.

Important

Do not use the tape library interface to move media to the Entry/Exit pool.

Edit Tape Eject Information


Ifdesired,youcanenterinformationabouttheejectlocationofatape
cartridgeandassignitalabelbeforeyouejectthetapefromthegateway.
Youarealsoaskedtoenterthisinformationwhenyouejectatape.
1. SelectStatus > Tape Management todisplaytheTapeManagement
screen.

Figure 64 The Tape Management screen.

July 2016

User GuideSpectra BlackPearl Gateway

108

Chapter 6 Working with Tape Libraries and Media

Eject Tapes

2. Selectthetapeyouwanttoeject,andthenselectAction > Edit.TheEdit


Tapedialogboxdisplays.

Figure 65 The Edit Tape dialog box.


3. Enterinformationinthe Eject LabelandEject Locationfields.This
informationisstoredontheBlackPearldatabaseandisvisiblewhenre
importingthetapeintoaBlackPearlgateway.
4. ClickSave.

Eject a Single Tape


EjectingatapemovesthattapetothetapelibraryEntry/Exitpool.Any
objectsontheexportedtapeareinaccessibleuntilthetapeisreimported
intoastoragepool.
Usetheinstructionsinthissectiontoejectatape.
1. SelectStatus > Tape Management todisplaytheTapeManagement
screen.

Figure 66 The Tape Management screen.

July 2016

User GuideSpectra BlackPearl Gateway

109

Chapter 6 Working with Tape Libraries and Media

Eject Tapes

2. Selectthetapeyouwanttoeject,andthenselectAction > Eject Tape.


TheEjectTapedialogboxdisplays.

Figure 67 The Eject Tape dialog box.


3. Ifdesired,enterinformationinthe Eject LabelandEject Locationfields.
ThisinformationisstoredontheBlackPearldatabaseandisvisible
whenreimportingthetapeintoaBlackPearlgateway.Youarenot
requiredtoenterthisinformation.
Note: Ifyoupreviouslyenteredinformationforthistapecartridge,
priortoejectingit,asdescribedinEditTapeEjectInformationon
page 108,thatinformationisdisplayedintheentryfields
automatically.
4. ClickEject.ThetapeismarkedasejectedintheBlackPearlgateway
database,andmovedtotheEntry/Exitpoolintheattachedtapelibrary.
ConsultyourlibraryUserGuideforinstructionsonexportingtape
mediafromthelibrary.

Cancel Tape Ejection


Ifyourequestedatapeejectbutithasnotyetstarted,youcancancelthe
ejectsinprogress.AnytapesnotalreadymovedtotheEntry/Exitpoolof
thetapelibraryareleftinthestoragepartitionandareusablebythe
BlackPearlgateway.AnytapesthatweremovedtotheEntry/Exitpool
mustbeexportedfromthelibraryandreimportedasdescribedinImport
Tapesonpage 111.

July 2016

User GuideSpectra BlackPearl Gateway

110

Chapter 6 Working with Tape Libraries and Media

Import Tapes

Usetheinstructionsinthissectiontocancelatapeejection.
1. SelectStatus > Tape Management todisplaytheTapeManagement
screen.

Figure 68 The Tape Management screen.


2. Canceltheejection:

Tocancelalltapeejections,selectAction > Cancel All Tape Ejects.

Tocancelasingletapeejection,selectthetapeforwhichyouwantto
canceltheejection,andthenselectAction > Cancel Tape Eject.

IMPORT TAPES
UsetheinstructionsinthissectiontoimporttapemediaintotheBlackPearl
gatewaydatabase.
1. ImportthetapemediaintotheEntry/Exitpoolofthetapelibrary
associatedwiththeBlackPearlgatewayasdescribedinyourlibrary
UserGuide.
2. SelectStatus > Tape Managementfromthemenubar.TheTape
Managementscreendisplays.

Figure 69 The Tape Management screen.

July 2016

User GuideSpectra BlackPearl Gateway

111

Chapter 6 Working with Tape Libraries and Media

Import Foreign Tapes

3. SelectAction > Online All Tapes.Thetapespresentinthelibrarys


Entry/Exitpoolarephysicallymovedintothelibrarystoragepooland
displayontheTapeManagementscreen.

Ifyouimportednewmedia,thetapecartridgesneedtobe
formattedasdescribedinFormatTapesonpage 105.

IfyouimportedmediapreviouslyexportedfromtheBlackPearl
gateway,itisautomaticallyassignedtothebuckettowhichitwas
previouslyassociated.Theobjectsstoredonthetapemediaare
immediatelyavailableforretrieval.

Note: Ifthebucketassociatedwiththeimportedtapemedianolonger
exists,thetapecartridgesaremarkedforformattingand
reclaimedbythegateway.

IMPORT FOREIGN TAPES


Wheninspectingtapesinthetapelibrary,iftheBlackPearlgateway
determinesthatoneormoretapecartridgeshavebeenpreviouslyusedina
differentgateway,thegatewaymarksthosetapesasforeign.Importing
foreigntapesimportstheselectedtapecartridgesintothenewBlackPearl
gateway.Ifoneormorebucketsbeingimporteddoesnotalreadyexist,the
datapolicy,storagedomain,andusertouseforanynewbucketsmustbe
specified.
Usetheinstructionsinthissectiontoimportforeigntapes.
1. SelectStatus > Tape Managementfromthemenubar.TheTape
Managementscreendisplays.

Figure 70 The Tape Management screen with foreign tapes listed.

July 2016

User GuideSpectra BlackPearl Gateway

112

Chapter 6 Working with Tape Libraries and Media

Manage Tapes Not in Inventory

2. Selecttheforeigntapeyouwanttoimport,andselectAction > Import


Foreign Tape.TheImportdialogboxdisplays.

Figure 71 The Import dialog box.


3. UsingtheData Policy for new bucketsdropdownlist,selectadata
policyfromthelistofpreviouslycreateddatapoliciesforallbucketson
theforeigntape.
4. UsingtheStorage Domain for new bucketsdropdownlist,selecta
storagedomainfromthelistofpreviouslycreatedstoragedomainsfor
allbucketsontheforeigntape.
5. UsingtheUser for new bucketsdropdownlist,selectauserfromthe
listofpreviouslycreatedusersforallbucketsontheforeigntape.
6. ClickSave.TheforeigntapeisimportedintotheBlackPearlgateway.
7. RepeatStep 2onpage 113throughStep 6toimportadditionalforeign
tapes.

MANAGE TAPES NOT IN INVENTORY


AdditionalfunctionsoftheTapeManagementscreenallowyoutomarka
tapemissingfromthetapelibraryinventoryasejected,andtodeletelostor
ejectedtapes.

Mark Tape as Ejected


Ifyouexportatapecartridgefromthetapelibraryinventorybefore
ejectingthetapefromtheBlackPearlgateway,thetapedisplaysasNotin
InventoryontheTapeManagementscreen.Ifyoucannot,ordonotwant
toreimportthetapeintothetapelibrary,usetheinstructionsinthis
sectiontomarkthetapeasEjected.
1. SelectStatus > Tape Managementfromthemenubar.TheTape
Managementscreendisplays(seeFigure 59onpage 105).
2. Ifdesired,editthetapeejectinformationasdescribedinEditTapeEject
Informationonpage 108.
3. SelectthetapewithastatusofNotinInventoryandselect
Action > Mark Tape Not In Inventory As Ejected.Aconfirmation
windowdisplays.
July 2016

User GuideSpectra BlackPearl Gateway

113

Chapter 6 Working with Tape Libraries and Media

Put a Tape Library Partition in Standby Mode

4. Intheconfirmationwindow,clickConfirm.TheTapeManagement
screenupdatesthetapestatustoEjected.

Delete Lost or Ejected Tape


Ifdesired,youcandeletetapecartridgesthatarelostorwereejectedfrom
thelibrarysothattheynolongerdisplayontheTapeManagementscreen.
Thisisusefulifyouejectedtapesanddonotplantoeverusethemagain
withtheBlackPearlgateway.
Note: Ifyoureimportatapethatyoupreviouslymarkedasdeleted,
thetapehasastatusofForeign.SeeImportForeignTapeson
page 112formoreinformation.
Usetheinstructioninthissectiontodeletealostorejectedtapefromthe
BlackPearldatabase.
1. SelectStatus > Tape Managementfromthemenubar.TheTape
Managementscreendisplays(seeFigure 59onpage 105).
2. SelectthetapewithastatusofNotinInventoryandselect
Action > Delete Lost or Ejected Tape.Aconfirmationwindowdisplays.
3. Intheconfirmationwindow,clickDelete.Thegatewaydeletesthetape
fromthedatabaseanditnolongerdisplaysontheTapeManagement
screen.

PUT A TAPE LIBRARY PARTITION IN STANDBY MODE


Ifyouneedtoperformserviceonthetapelibraryassociatedwithyour
BlackPearlgateway,youmustfirstputthetapelibraryintoastandbystate.
Otherwise,theBlackPearlgatewaymayattempttousethetapelibrary
whileitisinservice.Puttingthetapelibraryintostandbyallowsyouto
servicethetapelibrarywithoutdisconnectingtheinterfacecablesbetween
thetapelibraryandtheBlackPearlgateway.
Usetheinstructionsinthissectiontoputatapelibrarypartitioninto
standby.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen(see
Figure 26onpage 63).

July 2016

User GuideSpectra BlackPearl Gateway

114

Chapter 6 Working with Tape Libraries and Media

Activate a Tape Library Partition

2. SelectthetapepartitionintheTapePartitionspane,andselectAction >
Put Tape Partition in Standby.ThePutTapePartitioninStandby
confirmationwindowdisplays.

Figure 72 The Put Tape Partition in Standby confirmation


window.
3. ClickSave.Thetapepartitionentersthestandbystate.
Note: Ifyouhavemultiplepartitionsinthesametapelibrary
configuredforusebytheBlackPearlgateway,youmustrepeat
stepsStep 2andStep 3foreachpartitioninthetapelibrarythat
requiresservice.
Onceyouhavecompletedserviceonthetapelibrary,returnthetape
librarytoserviceusingthestepsinActivateaTapeLibraryPartition.

ACTIVATE A TAPE LIBRARY PARTITION


IfyouaddanewtapelibrarytoyourBlackPearlgateway,oryourexisting
tapelibraryhascompletedservice,youmustactivatethetapepartitionin
theBlackPearluserinterfacebeforethegatewayisabletotransferdatato
thetapelibrary.
Usetheinstructionsinthissectiontoactivateatapelibrary.
Note: Ifyouareactivatinganewtapelibrary,youmustcreatea
partitiononthelibrarysothattheBlackPearlgatewaycan
automaticallydetectthenewtapelibrary.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen(see
Figure 26onpage 63).

July 2016

User GuideSpectra BlackPearl Gateway

115

Chapter 6 Working with Tape Libraries and Media

Activate a Tape Library Partition

2. SelectthetapepartitionintheTapePartitionspane,andselectAction >
Activate Tape Partition.TheActivateTapePartitionconfirmation
windowdisplays.

Figure 73 The Activate Tape Partition confirmation


window.
3. ClickSave.Thetapepartitionisactivatedandisusablebythe
BlackPearlgateway.

July 2016

User GuideSpectra BlackPearl Gateway

116

CHAPTER 7
Operating the BlackPearl Gateway
Thischapterdescribesproceduresfordaytodaymonitoringand
operationoftheSpectraBlackPearlDeepStorageGateway.
Topic
DownloadanObject

page 118

CancelaSpectraS3Job

page 119

MonitortheBlackPearlGateway

page 120

FrontBezelVisualStatusBeacon

page 121

ConfiguringtheVisualStatusBeaconColor

page 122

SystemStatusLEDs

page 123

CheckSystemMessages

page 124

ViewtheStatusofHardwareComponents

page 125

ViewtheStatusofServices

page 126

ViewtheStatusoftheDatabaseandCache

page 127

ViewBucketContents

page 129

ViewSpectraS3JobsInformation

page 129

ViewTapeMediaInformation

page 131

ViewPerformanceMetrics

page 135

ViewReports

page 137

DatabaseBackup&Restore

page 138

ManuallyGenerateaDatabaseBackup

page 139

CreateaDatabaseBackupSchedule

page 140

RestorefromaDatabaseBackup

page 143

DeleteBackup

page 145

EditBackupDataPolicy

page 145

ShowBackupPhysicalPlacement

page 146

ManuallyStartingtheS3DataPathBackend

page 146

RebootorShutDownaBlackPearlGateway

page 147

UsingtheBlackPearlUserInterface

page 147

PowerCycleReset

page 149

ExittheBlackPearlUserInterface

117

page 149

Chapter 7 Operating the BlackPearl Gateway

Download an Object

DOWNLOAD AN OBJECT
ObjectspresentontheBlackPearlgatewaycanbedownloadedusingthe
BlackPearluserinterface,ifdesired.
Notes:

Onlyoneobjectcanbeselectedfordownloadatatime.
Theobjectmustbesmallerthan100GB.Objectslargerthan
100GBmustbedownloadedthroughaSpectraS3client.

Usetheinstructionsinthissectiontodownloadanobjectthroughthe
BlackPearluserinterface.
1. Fromthemenubar,selectConfiguration > Buckets.TheBucketsscreen
displays(seeFigure 26onpage 63).
2. Doubleclickthebucketthatcontainstheobjectyouwanttodownload.
TheBucketDetailsscreendisplaysalistofallobjectsinthebucket.

Figure 74 The Bucket details screen.


3. Selecttheobjectyouwanttodownload,andselectAction > Download.
Theobjectbeginsdownloadingthroughyourwebserver.

July 2016

User GuideSpectra BlackPearl Gateway

118

Chapter 7 Operating the BlackPearl Gateway

Cancel a Spectra S3 Job

CANCEL A SPECTRA S3 JOB


YoucanusetheBlackPearluserinterfacetocancelaninprogressSpectra
S3jobinsteadofusingyourSpectraS3client.
UsetheinstructionsinthissectiontocancelaSpectraS3job.
1. Fromthemenubar,selectStatus > S3 Jobs todisplaytheS3Jobs
screen.

Figure 75 The S3 Jobs screen.


2. SelectthejobtocancelandthenselectAction > Cancel.TheCancelJob
windowdisplays.

Figure 76 The Cancel Job screen.


3. ClickDeletetocancelthejobinprogress.

July 2016

User GuideSpectra BlackPearl Gateway

119

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

MONITOR THE BLACKPEARL GATEWAY


TheVisualStatusBeacononthefrontbezel,andtheBlackPearluser
interface,combinetoprovideanumberoftoolsformonitoringthehealth
andperformanceoftheBlackPearlgatewayanditscomponents.

TheVisualStatusBeaconlightbarinthefrontbezelchangescolorto
indicatethecurrentstatusofthegateway(seeFrontBezelVisualStatus
Beacononpage 121).

SystemmessagesprovideimportantinformationabouttheBlackPearl
gatewayanditsoperation(seeCheckSystemMessagesonpage 124for
moreinformation).

IconsontheHardwarescreenprovideoverallstatusofthehardware
componentsineachgroup(seeViewtheStatusofHardware
Componentsonpage 125formoreinformation).
Clickingthetextnexttoeachicondisplaysdetailedstatusinformation
forthecomponentsinthegroup.

YoucanalsousetheBlackPearluserinterfacetodothefollowing:

July 2016

Viewthestatusofservices(seeViewtheStatusofServiceson
page 126).
Viewthestatusofthedatabaseandcache(seeViewtheStatusofthe
DatabaseandCacheonpage 127).
Viewperformancemetricsforthedrives,CPUs,cache,andnetwork
(seeViewPerformanceMetricsonpage 135).
Viewthecurrentnetworkconfigurationsettings(seeConfigure
NetworkConnectionsandSettingsonpage 85).
ViewthestatusofanySpectraS3jobsrunningonthegateway(see
ViewSpectraS3JobsInformationonpage 129).
Viewthestatusofmediaintheassociatedtapelibrary(seeView
TapeMediaInformationonpage 131).
Rebootorshutdownthegateway(seeRebootorShutDowna
BlackPearlGatewayonpage 147).

User GuideSpectra BlackPearl Gateway

120

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

Front Bezel Visual Status Beacon


TheVisualStatusBeaconlightbarinthefrontbezelprovidesanata
glancestatusofthegatewaytowhichitismounted.Thelightbarchanges
colortoindicatethestatusofthegateway.Seethechartbelowforeach
colordisplayedanditsassociatedcondition.
Color Display

Condition

Purple Scroll

Thegatewayisoperatingnormally.
Note: Thecolordisplayedwhenthegatewayis
operatingnormallycanbechangedontheHardware
screen.SeeConfiguringtheVisualStatusBeaconColor
onpage 122formoreinformation.

Yellow Scroll

ThegatewayisexperiencingaWarningcondition.Login
totheBlackPearluserinterfacetodeterminethecauseof
thewarning.

Red Scroll

ThegatewayisexperiencinganErrorcondition.Loginto
theBlackPearluserinterfacetodeterminethecauseof
theerror.

Rainbow

Thegatewayiscurrentlypoweringonandperforming
selftests.

Flashing Blue

Thebeaconfeaturewasactivatedforthisgateway.This
canhelpyouidentifyaspecificgatewaywhenyouhave
morethanonegatewayinyourenvironment.

Pulsing Red

TheVisualStatusBeaconlostcommunicationwiththe
gateway.Thiscanoccurifthegatewayexperiencesa
softwarehang.

No Light

TheBlackPearlgatewayispoweredoff.

Note: Otherpatternsmaydisplayifthefrontbezelisnotproperly
seatedonthechassis.

July 2016

User GuideSpectra BlackPearl Gateway

121

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

Configuring the Visual Status Beacon Color


TheBlackPearlgatewayisconfiguredtodisplayapurplescrollinglighton
theVisualStatusBeaconwhenthegatewayisoperatingnormally.If
desired,youcanchangethecolordisplayedfornormaloperation.
1. Fromthemenubar,selectStatus > Hardware, orclicktheHardware
paneontheDashboard,orclicktheHardwarelinkonthestatusbar.
TheHardwarescreendisplays.
2. ClickBezel.TheBezelpaneoftheHardwarescreendisplays.
3. ClickthecoloredboxnexttoSelect Bezel Color.Thecolorpicker
windowdisplays.

Figure 77 Use the color picker to set the color of the Visual Status Beacon
when the gateway is operating normally.
4. Usethecolorpickertoselectthecolortodisplaywhenthegatewayis
operatingnormally.Optionally,youcanenteranHTMLcolorcodein
theentryfield.
Note: SpectraLogicrecommendsagainstusingyelloworred,sothat
youcanmoreeasilydetermineifthegatewayisinawarningor
errorstate.
5. ClickChoosetosetthecoloroftheVisualStatusBeacon.

July 2016

User GuideSpectra BlackPearl Gateway

122

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

System Status LEDs


ThesystemstatusLEDsprovideinformationaboutthestatusofthe
gateway,itsfans,networkconnections,andpowersupplies.Seethetable
belowforalistofeachsystemstatusLEDanditsfunction.

Power LED
Hard drive LED
Network 1 LED
Network 2 LED
Fan failure/
Overheat LED
Power failure LED

Figure 78 System status LEDs.


LED

Function

Power

Indicatesiftheunitispoweredonoroff.

Hard Drive

Indicatesbootdriveactivity.Toseetheactivityofadatadrive,seeData
drivestatusLEDsonpage 19.

Network 1

IndicatesnetworkactivityontheBlackPearlmanagementport.

Network 2

Indicatesnetworkactivityondatainterface1.ThisLEDalsoshows
networkactivityifdatainterface1isconfiguredinlinkaggregation
mode.

Fan Failure /
Overheat

IftheLEDisblinkingred,itindicatesafanfailure.Logintothe
BlackPearluserinterfacetodeterminewhichfanfailed.
IftheLEDissolidred,itindicatesanoverheatcondition.Logintothe
BlackPearluserinterfacetoviewthestatusofthesystem.Ifthe
problempersists,contactSpectraLogicTechnicalSupport.See
ContactingSpectraLogiconpage 4.

Power Failure

Indicatesapowersupplyfailure.LogintotheBlackPearluserinterface
todeterminewhichpowersupplyfailed.

July 2016

User GuideSpectra BlackPearl Gateway

123

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

Check System Messages


Checkthesystemmessagesregularly.Thesemessagesprovideimportant
informationabouttheBlackPearlgatewayanditsoperation.Reviewingthe
messagesisthefirststepintroubleshooting.
Ifanysystemmessagesaregeneratedbythegateway,thestatusbar
displayedatthebottomofallBlackPearlscreensshowsthemostrecent
dateamessagewasgenerated.Iftherearenosystemmessages,thistext
doesnotdisplay.

Figure 79 A system message displayed on the BlackPearl user interface


status bar.
1. Fromthemenubar,selectStatus > Messages, orclicktheMessages
linkonthestatusbar, todisplaytheMessagesscreen.

Figure 80 The Messages screen.


PayextraattentiontoanymessagesflaggedwiththeWarningorError
icon(seeStatusIconsonpage 29),andfollowanyrecommendedsteps.
ContactSpectraLogicTechnicalSupportifyouneedassistance(see
ContactingSpectraLogiconpage 4).
Note: Youcannotdeletemessages.Thesystemautomaticallydeletes
theoldestmessagesonafirstin,firstoutbasisasspaceis
required,retainingthemostrecentmessages.Thesystemholds
10,000messages.
2. Ifdesired,usethePage LengthdropdownmenutolimittheMessages
screentothespecifiednumberofmessages.
3. Tomarkasinglemessageasread,selectthemessageandthenselect
Action > Mark as read.Tomarkallmessagesasread,selectAction >
Mark all as read.
Note: MessagescanalsobemarkedasunreadusingtheActionmenu.
July 2016

User GuideSpectra BlackPearl Gateway

124

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

View the Status of Hardware Components


TheBlackPearluserinterfaceletsyoumonitorthestatusofhardware
componentsinthesystem,andtheconnectedlibrarytapedrives,without
havingdirectphysicalaccess.Thisisespeciallyusefulwhenyour
BlackPearlgatewayisoperatinginalightsoutdatacenter.Checkthe
BlackPearluserinterfaceregularlytoensurethatyoualwaysknowthe
statusofthehardwarecomponents.
1. Fromthemenubar,selectStatus > Hardware orclicktheHardware
paneontheDashboard,orclicktheHardwarelinkonthestatusbar.
TheHardwarescreendisplays.

Toolbar

Beacon
button

Figure 81 The Hardware screen.


2. Usethetoolbarmenuonthelefthandsideofthescreentoview
detailedinformationaboutcomponentgroups.Thefollowingtable
describesthetypesofinformationoneachdetailsscreen.Aniconnext
toeachcomponentindicatesthestatus(seeStatusIconsonpage 29for
adescriptionoftheicons).
Clicking...

Shows the...

Bezel

ColoroftheVisualStatusBeaconthatisdisplayedduringnormaloperation.
SeeFrontBezelVisualStatusBeacononpage 121formoreinformationabout
thecolorsdisplayedbytheVisualStatusBeacon.

Data Drives

Fans

Statusofmidplanefans

Power Supplies

Powersupplystatusandwattage

July 2016

Slotnumberofeachdrive
Statusofeachdrive
Drivesize,serialnumber,andfirmwarelevel
Thenameofthecachetowhichthedriveisassigned

User GuideSpectra BlackPearl Gateway

125

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

Clicking...

Shows the...

System

CPUstatusandtemperature
Systemmemorystatusandsize
Status,manufacturer,model,size,andserialnumberforeachbootdrive

Tape Drives

Statusoftapedrivesinthetapelibraryconnectedtothegateway

Turn Beacon On

ClickTurn Beacon OntocausetheVisualStatusBeaconlightonaBlackPearl


gatewaytoflashblue.Thisisusefulwhenyouhavemultiplegatewaysand
needtolocateaspecificone,forexampletoreplaceacomponent.Clickthe
buttonasecondtimetostopthelightfromflashing.

View the Status of Services


TheServicesscreenprovidesstatusinformationaboutservicesthatare
currentlyinstalledontheBlackPearlgateway.
Fromthemenubar,selectConfiguration > ServicestodisplaytheServices
screen.

Figure 82 The Services screen.


TheServicesscreendisplaysthefollowinginformation:

July 2016

This column...

Shows...

Name

Thenameoftheservicerunningonthegateway.

State

ThestatusoftheserviceontheBlackPearlgateway.
StartingTheserviceisstartingup.
OperationalTheserviceisrunning.
StoppedTheserviceisnotrunning.

Enabled

Whetherornottheserviceisenabledatsystemstartup.
YesServiceautomaticallystartswhenthegateway
ispoweredon.
NoServicedoesnotstartwhenthegatewayis
poweredon.

User GuideSpectra BlackPearl Gateway

126

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

View the Status of the Database and Cache


TheSystemPoolspaneoftheAdvancedBucketManagementscreen
providesstatusinformationaboutthedatabaseandcachepoolsconfigured
ontheBlackPearlgateway,aswellasstatusinformationforeachsystem
pool.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen.

Figure 83 The System Pools pane of the Advanced Bucket Management


screen.
TheSystemPoolspanedisplaysthefollowinginformation.

July 2016

This column...

Shows...

Name

Thenameofeachsystempool.Thisnamecannotbe
edited.

Health

Thecurrenthealthofeachsystempool.
OnlineThecacheisoperatingnormally.
DegradedOneormoredrivesinthecacheis
missing,orfailed.

Raw Size

Thetotalamountofstoragespaceassignedtoeach
systempool.

Available

Theamountofunusedstoragespaceineachsystem
pool.

Used

Theamountofusedstoragespaceineachsystempool.

Overhead

Theamountofdiskspaceusedforoverhead,suchas
paritydata.

Fault Tolerance

Thefaulttolerancesettingforeachsystempool.

User GuideSpectra BlackPearl Gateway

127

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

2. Toviewadditionalinformationaboutasystempool,selectthesystem
poolandthenselectAction > Show Details.Thesystempoolname
detailsscreendisplays.

Figure 84 The BlackPearl_Cache details screen.


Thesystempoolnamedetailsscreendisplaysthefollowinginformation:

July 2016

This row...

Shows...

Name

Thenameofthepool.Thisnamecannotbeedited.

Health

Thecurrenthealthofthepool.

High Water Mark

Whentheusedspaceonthepoolreachesthis
percentage,analertisgenerated.Noalertisgenerated
whenthepercentageissettozero.

Data Configuration

Theprotectionlevelforthepool.

Fault Tolerance

Thenumberofdrivesthatcanfailbeforedataislost.

Raw Size

Thetotalamountofstoragespaceassignedtothepool.

Available

Theamountofavailable(unused)storagespaceinthe
pool.

Used

Theamountofusedstoragespaceinthepool.

Overhead

Theamountofdiskspaceusedforoverhead,suchas
paritydata.

Drives

Thesize,RPM,type,andnumberofdrivesassignedto
thepool.

Created

Thetimestampofwhenthepoolwascreated.

User GuideSpectra BlackPearl Gateway

128

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

View Bucket Contents


Usetheinstructionsinthissectiontoviewthecontentsofabucket
configuredontheBlackPearlgateway.
1. Fromthemenubar,selectConfiguration > Buckets.TheBucketsscreen
displays(seeFigure 26onpage 63).
2. Doubleclickthenameofthebucketforwhichyouwanttoviewthe
contents.Thedetailsscreenforthebucketdisplays.

Figure 85 The details screen for a selected bucket.


Thebucketdetailsscreendisplaysthefollowinginformationforeach
objectcontainedinthebucket:
This row...

Shows...

Name

Thenameofanobjectinthespecifiedbucket.

Size

Thesizeoftheobject.

Created

Thetimestampofwhentheobjectwaswrittentothe
bucket.

View Spectra S3 Jobs Information


TheS3JobsscreendisplaysthestatusofallSpectraS3jobsthegatewayis
currentlyprocessing,allcancelledjobs,andallcompletedjobs.

July 2016

User GuideSpectra BlackPearl Gateway

129

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

Fromthemenubar,selectStatus > S3 Jobs todisplaytheS3Jobsscreen.

Figure 86 The S3 Jobs screen.

UsethejobstatusdropdownmenutoselectActive Jobs,Cancelled Jobs,


orCompleted Jobsasdesired.

UsethePage Lengthdropdownmenutocontrolthenumberofentries
displayed.

TheS3Jobsscreendisplaysthefollowinginformation:

July 2016

This column...

Shows...

Bucket

Thenameofthebucketthatisactedonbythejob
request.

Request Type

IfthejobisaPUT(write),GET(read),orVERIFY
(verify)operation.

Priority

Thepriorityforprocessingthejob.Thejobpriority
determinestheresourcesassignedandtheprocessing
order.Values:Critical, Urgent, High, Normal, Low,
Background.

Status

Thecurrentstatusofthejob.
Values:
In ProgressThejobiscurrentlyrunning.
CompetedThejobcompleted.
CanceledThejobwascanceledbytheuseror
automaticallyduetointernaltimeouts.

Size

Theamountofdatatobetransferredbythejob.

Amount
Transferred to
Cache

Theamountofdatathatwastransferredtothecachefor
thisjob.
ForPUTs,thisistheamountofdatasuccessfully
transferredtothegatewayfromtheclient.ForGETs,this
istheamountofdataeitherincacheoriginally,orloaded
intocachefromtape.ForVERIFYjobs,thisistheamount
ofdataloadedintocachefromthepermanentdatastore.

User GuideSpectra BlackPearl Gateway

130

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

This column...

Shows...

Amount Archived/
Received

Theamountofdatathatiscompletelyprocessedforthis
job.
ForPUTs,thisindicatestheamountofdatawrittento
tapemedia.ForGETs,thisindicatestheamountofdata
thatwasreadsuccessfullybytheclient.ForVERIFYjobs,
thisistheamountofdataloadedintocachefromthe
permanentdatastore.

User

TheS3userthatinitiatedthejob.

Created

Thetimestampofwhenthejobwascreated.

View Tape Media Information


TheTapeManagementscreenallowsyoutoviewthestatusofalltapesin
theassociatedSpectraLogictapelibrary,orinaspecifiedbucket.
1. DisplaytheTapeManagementScreen:

Toviewthestatusofalltapesintheassociatedtapelibrary,fromthe
menubar,selectStatus > Tape Management. TheTapeManagement
screendisplays.

Figure 87 The Tape Management screen.

Toviewthestatusofthetapesassociatedwithabucket:
a. Fromthemenubar,selectConfiguration > Buckets.TheBuckets
screendisplays.

July 2016

User GuideSpectra BlackPearl Gateway

131

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

b. Selectthebucketforwhichyouwanttoviewthetapemedia
information,andselectAction > Show Physical Placement.The
PhysicalPlacementscreendisplays.

Figure 88 The Physical Placement screen showing the storage pools and
tapes for a specified bucket.
TheTapeManagementandPhysicalPlacementscreensdisplaysthe
followinginformation:
This column...

Shows...

Barcode

Thebarcodelabelonthetapecartridge.

Type

Themediatype.Values:LTO-5, LTO-6, LTO-7, TS1140, TS1150.

State

Thestatusofthetape:
Duringnormaloperation,thetapestateisManaged.Otherpossiblestatesare:
BadThetapecartridgeisbadandisnotusablebythegateway.
BlackPearlForeignAtapefromanotherBlackPearlgateway.Thisdata
mustbecopiedintoabucketonthisgatewaybeforeitisaccessible.
DataCheckpointFailureThetapeshouldcontaindatathatisrecognizable
totheBlackPearlgateway,butthegatewaycouldnotverifythatthedataon
thetapeisatthecorrectcheckpointortherewasanerrorrollingbacktoa
checkpoint.
DataCheckpointMissingThetapeshouldcontaindatathatis
recognizabletotheBlackPearlgateway,butthecheckpointcontainingthe
datacouldnotbefoundonthetape.
ImportinProgressAforeigntapeisintheprocessofbeingimportedinto
theBlackPearlgateway.
LTFSForeignAnLTFSformattedtapenotassociatedwithaBlackPearl
gateway.Thisdatamustbecopiedintoabucketonthisgatewaybeforeitis
accessible.
ManagedThetapeisreadyforuse.
ManagedBarcodeMissingThebarcodeforthetapeisunknownormissing.
ManagedEjectedThetapewasejectedfromthesystemandisnot
physicallypresent.
ManagedEjectinProgressThetapeiscurrentlybeingmovedtotheEntry/
Exitpool.
ManagedEjectPendingThetapewasmovedtothelibraryEntry/Exitpool
andiswaitingtobephysicallyremovedfromthelibrary.
(continuedonnextpage)

July 2016

User GuideSpectra BlackPearl Gateway

132

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

This column...

Shows...

State
(continued)

ManagedEmptyThetapeisempty.
ManagedFormatinProgressThetapeiscurrentlybeingformatted.
ManagedFormatPendingAformatwasrequestedforthetapebuthasnot
yetstarted.
ManagedFullThetapeisfull.
ManagedNotInInventoryThetapewasremovedfromthetapelibrary
withoutfirstejectingit.
ManagedOverusedThenumberofwritestothetapeisgreaterthanthe
recommendedmaximum.
ManagedSerialNumberMismatchThetapeserialnumberdoesnot
matchtheonestoredinthegateway.
OfflineThetapeisintheEntry/Exportpoolandrequiresuserconfirmation
tomoveittothestoragepartitionandmakeitavailableforuse.
OnlineInProgressThetapeisintheprocessofbeingmovedfromthe
Entry/Exitpooltothestoragepool.Whencomplete,itsstatechangesto
PendingInspection.
OnlinePendingThetapewasOfflineandreceiveduserconfirmationto
beginimportingintothegateway,butthatactionhasnotyetbegun.
PendingInspectionThetapeisawaitinginspection.
UnknownThetapecontainsunknowndataorisotherwiseunavailable.

Available

Theamountofunusedspacethatisavailablefordataonthetapecartridge.

Used

Theamountofspaceonthetapecartridgecontainingdata.

Tape Library
Partition

TheserialnumberofthepartitionontheSpectraLogictapelibrarycontaining
thetapecartridge.

Bucket

Thenameofthebuckettowhichthetapeisassigned.

Most Recent Error

Thelasterror,ifany,thatwasdetectedwhenreadingdatafrom,orwritingdata
to,thetapecartridge.

Write Protected

Thestatusofthewriteprotectswitchonthecartridge.

Last Modified

Thetimestampofthelasttimedatawaswrittentothetapecartridge.

July 2016

User GuideSpectra BlackPearl Gateway

133

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

2. Todisplaydetailedinformationaboutatapecartridge,doubleclickthe
tapecartridgerow.Adetailsscreenfortheselectedtapedisplays.

Figure 89 The details screen for a selected tape.


Thedetailsscreenforaselectedtapecartridgedisplaysthefollowing:

July 2016

This row...

Shows...

Barcode

Thebarcodelabelonthetapecartridge.

Serial Number

Themanufacturerassignedserialnumberforthetape
cartridge.

Type

Themediatype.Values:LTO-5, LTO-6, LTO-7, TS1140,


TS1150.

State

Thestatusofthetape.SeeStateonpage 132foralistof
tapecartridgestates.

Raw Size

Therawsizeofthetape.

Available

Theamountofunusedspacethatisavailableonthetape
cartridge.

Used

Theamountofspaceonthetapecontainingdata.

Tape Library
Partition

Theserialnumberofthepartitiononthetapelibrary
containingthetapecartridge.

Write Protected

Thestatusofthewriteprotectswitchonthecartridge.

Last Accessed

Thetimestampofthelasttimethetapewasloadedintoa
tapedrive.

Last Modified

Thetimestampofthelasttimedatawaswrittento,or
readfrom,thetapecartridge.

Bucket

Thenameofthebuckettowhichthetapeisassigned.

Eject Label

Auserdefinedlabelenteredwhenthetapeisejected.

Eject Location

Auserdefinedlabelenteredwhenthetapeisejected.

User GuideSpectra BlackPearl Gateway

134

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

Ifthereareanytapeerrorsassociatedwiththespecifiedcartridge,they
displayintheTape Errorspaneofthedetailsscreen.
ThefollowingcommandsareavailablefromtheActionmenuonthetape
cartridgedetailsscreen.Usethelinksbelowformoredetailedinformation
abouteachcommand.

EditSeeEditTapeEjectInformationonpage 80.

Eject TapeSeeEjectTapesonpage 80.

Cancel Tape Eject SeeCancelTapeEjectiononpage 82.

Format TapeSeeFormatTapesonpage 77.

View Performance Metrics


ThePerformancescreendisplaysperformancemetricsfortheBlackPearl
cache,individualdatadrives,networktraffic,andCPUs.Performance
graphscanbeconfiguredtodisplayeitherthelast5minutesofactivity,or
thelast25hours.
1. Fromthemenubar,selectStatus > Performance.ThePerformance
screendisplays.

Figure 90 The Performance screen.


2. SelectCache,Drives,CPUs,or Network todisplayperformance
informationabouttheselectedcomponent.
Note: IfyouselectCache,Drives, orNetwork,usetheCache,Disk,or
Interfacedropdownmenutoselectaspecificcache,diskdrive,
ornetworkconnectiontomonitor.
July 2016

User GuideSpectra BlackPearl Gateway

135

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

3. SelectthetimeintervalusingtheResolutiondropdownmenu.Thedata
canbedisplayedin1secondincrements(5minutestotal)or1hour
increments(25hourstotal).
4. SelectorclearoptionsunderSelect elements to plottoindicatewhich
graphlinestodisplay.Thegraphupdatesassoonasyouselectorclear
anoption.
5. Settheperformancegraphstimevaluestoyourlocaltimezoneusing
theTime zonemenu.Allentriesarelistedin+/GMT.
6. Ifdesired,clickDownload as CSVonthelower,leftsideofthepanel,to
downloadacommaseparatedvaluefilecontainingthedataforthe
graphyouarecurrentlyviewing.Thefilecanthenbeimportedinto
MicroSoftExcelorothersoftwareapplicationsthatsupportthisfile
type.
7. Toseetheperformancedataingreaterdetail,selectthedesiredsection
youwanttomagnifyineitherthemainorrangeindicatorgraph.Using
themouse,clickanddragthecursorhorizontallyoverthesectionofthe
detailgraphthatyouwanttomagnify.Thehighlightedsectionofdata
isshownonthemaingraph.
Therangeindicatorgraphcontinuestodisplaytheoriginalrangeof
data,withthesectionthatiscurrentlybeingshownonthemaingraph
highlighted.

Main graph

Range indicator
graph

Highlighted section
currently displayed on main graph

Figure 91 Highlight a section of data to show in greater detail.


8. ClickReset Viewtoresetthemaingraphtothedefaultview.

July 2016

User GuideSpectra BlackPearl Gateway

136

Chapter 7 Operating the BlackPearl Gateway

Monitor the BlackPearl Gateway

View Reports
TheReportsscreenallowsyoutogeneratereportsonallaspectsofthe
BlackPearlgateway,includingcomponentstatus,andconfiguration.
ReportscanbesavedineitherJSONorXMLformat.
1. Fromthemenubar,selectStatus > ReportstodisplaytheReports
screen.

Figure 92 The Reports screen.


2. Selectcheckboxesnexttothereport(s)youwanttogenerate.
Note: UsetheAllorNonebuttonsatthebottomofeachreportgroupto
selectorclearthatgroupofreports.TheAllandNonebuttonsat
thebottomofthescreenselectorclearallreportsshownonthe
screen.
3. SelecttheFormat forthereport(s).Onlyoneformatcanbeselected.
4. ClickSave.Theselectedreportsaresavedtoyourlocalhost.
5. Openthereportusingacompatibleprogram.

July 2016

User GuideSpectra BlackPearl Gateway

137

Chapter 7 Operating the BlackPearl Gateway

Database Backup & Restore

DATABASE BACKUP & RESTORE


TheBlackPearlgatewaydatabasecontainsalistofallobjectsstoredonthe
gatewaycache,tape,anddiskmedia.Backingupthedatabaseallowsyou
torestorethedatabaseintheeventofdatacorruption,orifyouwantto
restorethesystemtothestateitwasinwhenthedatabasebackupwas
generated.

Caution

When restoring from a database backup, all changes since the database backup are
lost. Any tape media with objects created after the database backup are reclaimed
by the gateway.

DatabasebackupsarestoredonabucketontheBlackPearlgateway,and
keptbasedonthesettingsofapreconfigureddatapolicynamedDatabase
Backup.Ifdesired,youcanmodifythesettingsofthepreconfigureddata
policy,orcreateanewdatapolicyfordatabasebackups(seeCreateaData
Policyonpage 71).Ifyoucreateanewdatapolicy,youwillneedtoeditthe
databasebackupconfigurationtousethenewpolicy(seeEditBackupData
Policyonpage 145).
Note: SpectraLogicrecommendsusingthedefaultdatapolicy.
Thebucketusedfordatabasebackupsisautomaticallycreatedwhenthe
firstbackupisgenerated,eithermanually,oronaschedule.Thedatabase
backupbucketislistedontheBucketsscreenoftheBlackPearluser
interfacewiththenameSpectraBlackPearlBackupsystemnameproduct
serialnumber.Thisbucketcannotbeusedfordatastorage.
Note: Ifyouchangethesystemnameafterthedatabasebackupbucket
iscreated,thebucketnamedoesnotchange.
Backupscanbegeneratedmanually,orbyschedule.Whencreatinga
databasebackupschedule,youspecifyhowmanycopiesofthedatabaseto
keepatonetime.Whenthegatewaygeneratesabackupthatexceedsthe
valueconfigured,theoldestdatabasebackupisautomaticallydeleted.
Note: ThedefaultscheduleontheBlackPearlgatewaygeneratesa
backuponceperday,andretainsamaximumoftwobackups.

July 2016

User GuideSpectra BlackPearl Gateway

138

Chapter 7 Operating the BlackPearl Gateway

Database Backup & Restore

Manually Generate a Database Backup


Usetheinstructionsinthissectiontocreateadatabasebackupmanually.
1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays.

Figure 93 The Database Backup screen.


2. SelectAction > Start Immediate Backup.Aconfirmationwindow
displays.

Figure 94 The Start Immediate Backup


confirmation window.
3. ClickBackup.

July 2016

User GuideSpectra BlackPearl Gateway

139

Chapter 7 Operating the BlackPearl Gateway

Database Backup & Restore

Create a Database Backup Schedule


Databasebackupschedulescanbeconfiguredatintervalsbasedonhours,
numberofdays,ordaysoftheweek.Decidewhichintervaltouseforthe
scheduleandfollowtheappropriateinstructions.

CreateanHourlyScheduleonpage 140Createbackupsevery
selectednumberofhours.

CreateaDailyScheduleonpage 141Createbackupsevery
selectednumberofdays.

CreateaWeeklyScheduleonpage 142Createbackupsoncertain
daysoftheweek.

Create an Hourly Schedule


1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays.

Figure 95 The Database Backup screen.


2. SelectAction > Change Schedule.TheModifyDatabaseBackup
Schedulescreendisplays.
3. SelectHourly.TheModifyDatabaseBackupSchedulescreenchangesto
displaytheoptionsforanhourlybackupschedule.

Figure 96 The Modify Database Backup Schedule screen.

July 2016

User GuideSpectra BlackPearl Gateway

140

Chapter 7 Operating the BlackPearl Gateway

Database Backup & Restore

4. EnteranumberfortheMinimum backups to keep on tape.Whenthe


gatewaygeneratesabackupthatexceedsthevalueconfigured,the
gatewayautomaticallydeletestheoldestbackup.
5. EnteranumberforEvery _ hours on the hour.Thisvaluespecifiesthe
interval,inhours,betweengeneratingbackups.Forexample,ifthis
valueissetto4,thesystemcreatesabackupeveryfourhours.
6. ClickSave.

Create a Daily Schedule


1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays.

Figure 97 The Database Backup screen.


2. SelectAction > Change Schedule.TheModifyDatabaseBackup
Schedulescreendisplays.
3. SelectDaily.TheModifyDatabaseBackupSchedulescreenchangesto
displaytheoptionsforadailybackupschedule.

Figure 98 The Modify Database Backup Schedule screen.


4. EnteranumberfortheMinimum backups to keep on tape.Whenthe
gatewaygeneratesabackupthatexceedsthevalueconfigured,the
gatewayautomaticallydeletestheoldestbackup.
5. EnteratimevalueforStart Time,andincludeAMorPMafterthevalue.
thisfieldisnotcasesensitive.

July 2016

User GuideSpectra BlackPearl Gateway

141

Chapter 7 Operating the BlackPearl Gateway

Database Backup & Restore

6. EnteranumberforEvery_days.Thisvaluespecifiestheinterval,in
days,betweengeneratingdatabasebackups.Forexample,ifthisvalue
issetto2,thegatewaygeneratesabackupeverytwodaysatthetime
specifiedinStep 5.
7. ClickSave.

Create a Weekly Schedule


1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays.

Figure 99 The Database Backup screen.


2. SelectAction > Change Schedule.TheModifyDatabaseBackup
Schedulescreendisplays.
3. SelectWeekly.TheModifyDatabaseBackupSchedulescreenchangesto
displaytheoptionsforadailybackupschedule.

Figure 100 The Modify Database Backup Schedule screen.


4. EnteranumberfortheMinimum backups to keep on tape.Whenthe
gatewaygeneratesabackupthatexceedsthevalueconfigured,the
gatewayautomaticallydeletestheoldestbackup.
5. EnteratimevalueforStart Time,andincludeAMorPMafterthevalue.
Thisfieldisnotcasesensitive.
6. SelectoneormoredaysforEvery week on:.Thisdeterminestheday(s)
ofeachweekthegatewaygeneratesdatabasebackups.
7. ClickSave.

July 2016

User GuideSpectra BlackPearl Gateway

142

Chapter 7 Operating the BlackPearl Gateway

Database Backup & Restore

Restore from a Database Backup


Restoringadatabasebackupreturnsthegatewaytothestateitwasin
whenthebackupwascreated.Allobjectswrittentothegatewayafterthe
backupwascreatedareinaccessible.

Caution

Restoring a database backup deletes all data changes made after the backup was
created, and deletes any backups that were saved after the one you are using for
the restore process. This action cannot be undone.

Therearetwowaystorestorefromadatabasebackup;restoringfroma
manualorautomaticdatabasebackup,orrestoringfromanarbitraryfile.
Restoringfromanarbitraryfileisusefulifyouhavecopiedyourdatabase
backupfilestoanotherbucket.

Restore Using a Database Backup


Usethefollowinginstructionstorestoreamanualorautomaticdatabase
backup.
1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays.

Figure 101 The Database Backup screen.

July 2016

User GuideSpectra BlackPearl Gateway

143

Chapter 7 Operating the BlackPearl Gateway

Database Backup & Restore

2. SelectthebackupyouwanttorestoreintheBackupspane,andthen
selectAction > Restore from Backup.Aconfirmationscreendisplays.

Figure 102 The Restore Database? confirmation screen.


3. EnterRESTOREintheentryfield,andthenclickRestore.Thedatabase
isrestoredtothestateitwasinwhenthebackupwasgenerated.

Restore Using an Arbitrary File


Usetheinstructionsinthissectiontorestoreadatabasebackupusingan
arbitraryfile,suchasadatabasebackupthatwascopiedtoadifferent
bucketthantheonenormallyusedfordatabasebackups.
1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays(seeFigure 101onpage 143).
2. SelectAction > Restore from Arbitrary File.Aconfirmationwindow
displays.

Figure 103 The Restore from Arbitrary File confirmation


screen.
July 2016

User GuideSpectra BlackPearl Gateway

144

Chapter 7 Operating the BlackPearl Gateway

Database Backup & Restore

3. EnterthenameofthebucketcontainingthearbitraryfileintheBucket
field.
4. EnterthefilenameofthearbitraryfileintheFilefield.
5. EnterRESTOREintheentryfield,andthenclickRestore.Thedatabase
isrestoredtothestateitwasinwhenthebackupwasgenerated.

Delete Backup
Usethefollowinginstructionstodeleteadatabasebackup.
1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays.

Figure 104 The Database Backup screen.


2. SelectthebackupyouwanttodeleteintheBackupspane,andthen
selectAction > Delete.Aconfirmationscreendisplays.
3. ClickDeletetoconfirmtheoperation.Thebackupisdeleted.

Edit Backup Data Policy


Usethefollowinginstructionstoeditthedatapolicyusedforthedatabase
backupbucket.
1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays.

Figure 105 The Database Backup screen.


July 2016

User GuideSpectra BlackPearl Gateway

145

Chapter 7 Operating the BlackPearl Gateway

Manually Starting the S3 Data Path Backend

2. FromthemenubarselectAction > Edit Data Policy.TheModifyData


Policyscreendisplays.

Figure 106 The Modify Data Policy screen.


3. UsetheData Policy to Usedropdownmenutoselectanewdatapolicy
forthedatabasebackupbucket.

Show Backup Physical Placement


Usethefollowinginstructionstodisplaywhatpiece(s)oftapemediaor
whatstoragepoolisusedbyadatabasebackup.
1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays(seeFigure 93onpage 139).
2. Fromthelistofexistingbackups,selectthebackupforwhichyouwant
toviewphysicalplacementandselectAction > Show Backup Physical
Placement.Thescreenrefreshestoshowyouthestoragepoolortape
mediathebackupcurrentlyoccupies.

Figure 107 The Database Backup Physical Placement screen.

MANUALLY STARTING THE S3 DATA PATH BACKEND


IftheBlackPearlgatewayispoweredoffforlongerthanthetimeoutvalue
specifiedintheS3serviceoptions,thedatapathbackendmustbe
manuallystarted.Usetheinstructionsinthissectiontomanuallystartthe
datapathbackend.
1. Fromthemenubar,selectConfiguration > Servicestodisplaythe
Servicesscreen(seeFigure 33onpage 80).

July 2016

User GuideSpectra BlackPearl Gateway

146

Chapter 7 Operating the BlackPearl Gateway

Reboot or Shut Down a BlackPearl Gateway

2. DoubleclicktheS3service,orselecttheS3serviceandselectAction >
Show Details.TheS3detailsscreendisplays.
3. OntheS3servicedetailsscreen,selectAction > Activate Data Path
Backend.TheActivateDataPathBackendconfirmationwindow
displays.

Figure 108 The Activate Data Path Backend screen.


4. ClickActivate.

REBOOT OR SHUT DOWN A BLACKPEARL GATEWAY


Thissectiondiscussesrebootingorshuttingdownagateway.

Using the BlackPearl User Interface


Usethefollowinginstructionstorebootorshutdownagatewayusingthe
BlackPearluserinterface.

July 2016

User GuideSpectra BlackPearl Gateway

147

Chapter 7 Operating the BlackPearl Gateway

Reboot or Shut Down a BlackPearl Gateway

1. Clickthepowericoninthelowerrighthandcornerofanyscreeninthe
BlackPearluserinterface.ThePowerscreendisplays.

Power

Figure 109 The Power icon.


2. ClickeitherRebootorShutdown.
3. Aconfirmationscreenappears.Confirmtheselectiontoperformthe
rebootorshutdown.

July 2016

User GuideSpectra BlackPearl Gateway

148

Chapter 7 Operating the BlackPearl Gateway

Exit the BlackPearl User Interface

Power-Cycle Reset
Undersomecircumstances,SpectraLogicTechnicalSupportmaydirect
youtoperformapowercycleresetofaBlackPearlgatewaytorecoverfrom
anerror.TopowercycleresetaBlackPearlgateway,removethefrontbezel,
andthenpressandholdthefrontpanelpowerbutton(Figure 9onpage 31)
untilthebuttonsLEDturnsoff.Afterafewmoments,pressthebutton
againtoturnthegatewaybackon.

Caution

Do not use the power button to turn off a BlackPearl gateway unless you are
specifically instructed to do so by Spectra Logic Technical Support.

EXIT THE BLACKPEARL USER INTERFACE


ToexittheBlackPearluserinterface,closethebrowserorclickLogouton
therightsideofthemenubar.Thisendsthesession.
Iftheactivesessionisidleformorethanthesetsessiontimeout,the
currentuserisautomaticallyloggedout.Thissettingcanbeconfiguredon
theAccountsscreen.Thedefaultis60minutes.SeeConfigureUserson
page 90.

July 2016

User GuideSpectra BlackPearl Gateway

149

CHAPTER 8
Using the Deep Storage Browser
ThischapterdescribesusingtheSpectraDeepStorageBrowsertoperform
filestorageoperationswithaSpectraBlackPearlDeepStorageGateway.
Task
Introduction

page 151

Requirements

page 151

DownloadtheDeepStorageBrowser

page 151

InstallandLaunchtheDeepStorageBrowser

page 152

ConnecttoaBlackPearlGateway

page 152

UsingtheBrowser

page 154

InterfaceOverview

page 155

CopyaFiletotheGateway

page 157

ReadaFilefromtheGateway

page 157

150

Chapter 8 Using the Deep Storage Browser

Introduction

INTRODUCTION
TheSpectraDeepStorageBrowserprovidesacommongraphicinterfaceto
allowyoutoeasilymovedataonorofftapemediausingtheBlackPearl
gateway.TheDeepStoragebrowserisavailableforMicrosoftWindows
operatingsystemandAppleMacOSoperatingsystemsoftware,with
sourcefilesavailableforcompilationonLinux,andadditionaloperating
systems.
TheDeepStoragebrowserisnotdesignedfordailybackupsbecausethe
DeepStoragebrowserdoesnotsupportversioning.Onceafileiscopiedto
theBlackPearlgatewayandwrittentotape,youcannotoverwritethatfile
withanewerversion.EvenifyoudeletethefileontheBlackPearlgateway,
thefiletransferoperationfailswiththeerrormessageVersioningisnot
supported.

REQUIREMENTS
TheDeepStoragebrowserhasthefollowingrequirements:

TheBlackPearlgatewaymustberunningBlackPearl1.1software,or
later.

TheDeepStoragebrowseroperatesbymovingdatafromtheselected
sourcelocation,throughthehostcomputerrunningtheDeepStorage
browser,tothedestinationlocation.Thisoccursevenifthereisadirect
connectionbetweenthesourceanddestination.Thiscanresultin
slowerdatatransferperformancedependingonthehostcomputer
CPU,memory,andnetworkconfigurations.

FilesbeingstoredasobjectstoaBlackPearlbasedtapelibrarystorage
solutionmustfollowtheAmazonS3namingrestriction.Seehttp://
docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.htmlfor
moreinformation.

DOWNLOAD THE DEEP STORAGE BROWSER


UsetheinstructionsinthefollowingsectionstodownloadtheDeep
StoragebrowserforMicrosoftWindowsorAppleMacOSoperating
systems.
1. Usingawebbrowser,navigatetohttps://developer.spectralogic.com/
ds3browser.
2. Clickthesoftwaredownloadlinkappropriateforyouroperating
system.TheDeepStoragebrowserinstallfilebeginsdownloading
throughyourwebbrowser.

July 2016

User GuideSpectra BlackPearl Gateway

151

Chapter 8 Using the Deep Storage Browser

Install and Launch the Deep Storage Browser

INSTALL AND LAUNCH THE DEEP STORAGE BROWSER


UsetheinstructioninthissectiontoinstallandlaunchtheDeepStorage
Browser.Theinstructionsdifferdependingonwhichoperatingsystemis
installedonyourhostmachine.

Microsoft Windows
1. Rightclickthe.zipfileyoudownloadedinDownloadtheDeepStorage
Browseronpage 151.Thecontextwindowdisplays.
2. SelectExtract All.TheZIPfileextractstoafolderinthesamedirectory
astheZIPfile.
Note: IftheZIPfileisonthedesktop,theextractedprogramfolder
displaysonthedesktop.
3. Doubleclicktheextractedfolder.Thecontentsdisplayinawindow.
4. DoubleclickDeep Storage Browser.exetolaunchtheprogram.

Apple Mac OS
1. Doubleclickthe.dmgfileyoudownloadedinDownloadtheDeep
StorageBrowseronpage 151.Anicondisplaysontheoperatingsystem
desktop.
2. Doubleclicktheicononthedesktop.Awindowdisplaysshowingthe
DSBiconontheleftsideandtheApplicationsfoldericonontheright
side.
3. DraganddroptheDSBiconontotheApplicationfoldericon.The
programinstalls.
4. OpentheApplicationtab,anddoubleclickSpectra Deep Storage
Browsertolaunchtheprogram.

CONNECT TO A BLACKPEARL GATEWAY


Beforeyoucaninitiatefilestorageoperations,youmustfirstsetupthe
logicalconnectionbetweentheDeepStoragebrowserandtheBlackPearl
gateway.

July 2016

User GuideSpectra BlackPearl Gateway

152

Chapter 8 Using the Deep Storage Browser

Connect to a BlackPearl Gateway

UsetheinstructionsinthissectiontoconnecttoaBlackPearlgateway.
1. LaunchtheDeepStoragebrowserusingthemethodappropriatefor
youroperatingsystem(seeInstallandLaunchtheDeepStorage
Browser).TheNewDeepStorageBrowserSessiondialogboxdisplays.

Figure 110 The New Deep Storage Browser Session dialog


box.
2. EntertheIPaddressofthedataportoftheBlackPearlgatewayinthe
BlackPearlData Interfacefield.TheIPaddressmustbeavalidIPv4
address.SeeConfiguretheDataConnectiononpage 38todetermine
thedataportIPaddress.
Note: IfyouentertheIPaddressoftheBlackPearlmanagementport,
theconnectiontothegatewayfails.
3. UsethedropdownmenunexttoBlackPearl DS3 PorttoselecttheDS3
port.TheDS3portistheportconfiguredforusebytheDS3serviceon
theBlackPearlgateway.Thedefaultvalueis80.SeeConfigurethe
SpectraS3Serviceonpage 82todeterminetheDS3portvalue.
4. Ifdesired,entertheIPaddressofaproxyserverintheProxy Server
field.
5. EntertheS3 Access IDand S3 Secret Keyforausercurrentlyconfigured
ontheBlackPearlgateway.SeeViewS3Credentialsonpage 42formore
information.

July 2016

Notes:

OnlyoneuseratatimecanaccessthegatewayusingaDeep
Storagebrowser.

Onlythebucketsassignedtotheuserareaccessibleusingthe
DeepStoragebrowser.

User GuideSpectra BlackPearl Gateway

153

Chapter 8 Using the Deep Storage Browser

Using the Browser

6. Optionally,selecttheSave Sessioncheckbox.Ifselected,theabove
informationispreenteredthenexttimeyoulaunchtheDeepStorage
browser.
7. ClickSave.TheSpectraLogicDeepStorageBrowsermainwindow
displays.

Figure 111 The Spectra Logic Deep Storage Browser main window.

USING THE BROWSER


TheDeepStoragebrowserfeaturesaneasytouse,draganddropsystem
fortransferringfilestoandfromtheBlackPearlgateway.Usethe
instructionsinthissectiontofamiliarizeyourselfwiththebrowser,andto
performfiletransferoperations.

July 2016

User GuideSpectra BlackPearl Gateway

154

Chapter 8 Using the Deep Storage Browser

Using the Browser

Interface Overview
ThissectionprovidesanoverviewoftheDeepStoragebrowserinterface.

Local host navigation icons

BlackPearl navigation icons

Local host
pane

BlackPearl
pane

Jobs/Log pane

Figure 112 The Spectra Logic Deep Storage Browser main window.

Item

Description

Local host
navigation
icons

Theseiconshelpyounavigatethroughthelocalandnetworkdrivesavailabletothe
localhost.
Parent DirectoryClickthisbuttontonavigatetotheparentdirectory
ofthedirectorycurrentlydisplayedinthelocalhostpane.
ComputerClickthisbuttontonavigatetothecomputerlevel
directoryofthelocalhost.Forexample,intheMicrosoftWindows
operatingsystem,thisisreferredtoasMyComputer.
Home DirectoryClickthisbuttontonavigatetotheuserdirectoryof
thelocalhost.Forexample,intheMicrosoftWindowsoperating
system,thisisreferredtoastheUserdirectory.

July 2016

User GuideSpectra BlackPearl Gateway

155

Chapter 8 Using the Deep Storage Browser

Using the Browser

Item

Description

BlackPearl
navigation
icons

Theseiconshelpyounavigatethroughbuckets,ontheBlackPearlgateway,thatare
assignedtotheuseraccessingthegateway,usingtheDeepStoragebrowser.
Parent DirectoryClickthisbuttontonavigatetotheparentdirectory
ofthedirectorycurrentlydisplayedintheBlackPearlpane.
Root DirectoryClickthisbuttontonavigatetothetoplevelofthe
gatewayanddisplayallbucketsavailabletotheDS3user.
RefreshClickthisbuttontorefreshthecurrentdisplayinthe
BlackPearlpane.

Local host
pane

Thispanedisplaysthefollowinginformationaboutthecontentsofthecurrently
selectedlocationonthelocalhost.
NameThenameofafileordirectory.
SizeThesizeofthefile.
TypeThetypeoffileordirectory.
Date ModifedThedateandtimeofthelasttimethefileorfolderwasmodified.

BlackPearl
pane

Thispanedisplaysthefollowinginformationaboutthecontentsofthecurrently
selectedlocationontheBlackPearlgateway.
NameThenameofanobjectorbucket.
OwnerTheusernameoftheassignedownerofthebucket.Onlybucketsassigned
totheuseraccessingthegatewayusingtheDeepStoragebrowserdisplay.
SizeThesizeofthefile.
KindThetypeoffileonthegateway.Values:Object, Bucket.
CreatedThedateandtimetheobjectorbucketwascreated.

Jobs/Log pane

Thispanedisplayseitherthecurrentjoblist,orthecurrentsessionlog.
JobsThestatusofthecurrentjobbeingprocessedbytheDeepStoragebrowser.
Iftherearenoactivejobsthispaneisblank.
LogThecurrentsessionlogofallcommandssenttotheBlackPearlgateway.This
panealsodisplaysanyerrorsthatoccurred.

July 2016

User GuideSpectra BlackPearl Gateway

156

Chapter 8 Using the Deep Storage Browser

Using the Browser

Copy a File to the Gateway


UsetheinstructionsinthissectiontousetheDeepStoragebrowsertocopy
afiletotapeusingtheBlackPearlgateway.
1. LaunchtheDeepStoragebrowserusingthemethodappropriatefor
youroperatingsystem(seeInstallandLaunchtheDeepStorage
Browseronpage 152).TheNewDeepStorageBrowserSessiondialog
boxdisplays.

IfyoupreviouslyconnectedtotheBlackPearlgatewayandelected
tosavethesessioninformation,thelogininformationispreentered
inthedialogbox.ClickOK.TheSpectraDeepStorageBrowsermain
windowdisplays.

Ifyoudidnotsavethesessioninformationorareconnectingtoa
BlackPearlgatewayforthefirsttime,completethestepsinConnect
toaBlackPearlGatewayonpage 152.

2. IntheDeepStoragebrowsermainwindow,navigatetothesource
destinationinthelocalhostpane.
3. IntheBlackPearlpaneoftheDeepStoragebrowser,navigatetothe
destinationbucketlocation.
4. Inthelocalhostpane,selectthefile(s)youwanttotransfertothe
BlackPearlgateway.
Notes:

Toselectaconsecutivegroupoffilesorfolders,clickthefirst
item,pressandholddowntheShiftkey,andthenclickthe
lastitem.
Toselectnonconsecutivefilesorfolders,pressandhold
downtheCtrlkey,andthenclickeachitemthatyouwantto
select.

5. DragtheselectedfilesfromthelocalhostpanetotheBlackPearlpane.
Thefilesimmediatelybegincopyingtothegateway.

Read a File from the Gateway


UsetheinstructionsinthissectiontousetheDeepStoragebrowsertocopy
afilefromtheBlackPearlgateway.
1. LaunchtheDeepStoragebrowserusingthemethodappropriatefor
youroperatingsystem(seeInstallandLaunchtheDeepStorage
Browseronpage 152).TheNewDeepStorageBrowserSessiondialog
boxdisplays.

July 2016

IfyoupreviouslyconnectedtotheBlackPearlgatewayandelected
tosavethesessioninformation,thelogininformationispreentered
inthedialogbox.ClickOK.TheDeepStorageBrowsermain
windowdisplays.

User GuideSpectra BlackPearl Gateway

157

Chapter 8 Using the Deep Storage Browser

Using the Browser

Ifyoudidnotsavethesessioninformationorareconnectingtoa
BlackPearlgatewayforthefirsttime,completethestepsinConnect
toaBlackPearlGatewayonpage 152.

2. IntheDeepStoragebrowsermainwindow,navigatetothetarget
destinationinthelocalhostpane.
3. IntheBlackPearlpaneoftheDeepStoragebrowser,navigatetothe
sourcebucketlocation.
4. IntheBlackPearlpane,selectthefile(s)youwanttotransfertothelocal
host.
Notes:

Toselectaconsecutivegroupoffilesorfolders,clickthefirst
item,pressandholddowntheShiftkey,andthenclickthe
lastitem.
Toselectnonconsecutivefilesorfolders,pressandhold
downtheCtrlkey,andthenclickeachitemthatyouwantto
select.

5. DragtheselectedfilesfromtheBlackPearlpanetothelocalhostpane.
Thefilesimmediatelybegincopyingtothelocalhost.

July 2016

User GuideSpectra BlackPearl Gateway

158

CHAPTER 9
Using AutoSupport
ThischapterdescribesusingtheBlackPearluserinterfacetoconfigurethe
supportfeaturesoftheSpectraBlackPearlDeepStorageGateway.
Task
AboutAutoSupport

page 160

EnterContactInformation

page 160

ConfigureMailRecipients

page 161

AddaNewRecipient

page 161

EditaMailRecipient

page 162

SendaTestEmail

page 163

DeleteaMailRecipient

page 164

LogSets

page 164

ManuallyGenerateLogSets

page 165

EmailaLogSet

page 166

DownloadaLogSet

page 167

ConfigureaLogSetSchedule

page 167

DeleteaLogSetorLogSetSchedule

page 168

159

Chapter 9 Using AutoSupport

About AutoSupport

ABOUT AUTOSUPPORT
AutoSupportletstheBlackPearlgatewayautomaticallycontactmail
recipientswhencertainkindsofmessagesaregenerated.Itisalsousedto
generateAutoSupportLog(ASL)setsforusebySpectraLogicTechnical
Support.YoucanconfigurethegatewaytoemailASLsetswhencritical
eventsoccur,oronamonthlybasis.Youcanalsochoosetohavemail
recipientsreceiveASLsets.

ENTER CONTACT INFORMATION


ContactinformationhelpsSpectraLogicincontactingtheadministratorof
theBlackPearlgatewayduringtroubleshooting.Enteringthecontact
informationistypicallyaonetimeonlyprocess.
1. Fromthemenubar,selectSupport > Contact Information todisplaythe
ContactInformationscreen.
2. ClickNewintheCustomerContactInformationpane.TheNewContact
Informationdialogboxdisplays.

Figure 113 The New Contact Information dialog


box.
3. EntertherequestedinformationandclickCreate.

July 2016

User GuideSpectra BlackPearl Gateway

160

Chapter 9 Using AutoSupport

Configure Mail Recipients

CONFIGURE MAIL RECIPIENTS


YoucanconfigureAutoSupporttoemailsystemmessagesandlogsets,as
theyaregenerated,toselectedrecipients.Alllogsetsandmessagesare
senttoapreviouslyconfiguredmailrecipient.Youcannotsendlogsetsor
messagesdirectlytoanemailaddress.UsetheMailRecipientscreento
add,edit,ordeletemailrecipientaccounts.

Figure 114 The Mail Recipients screen.

Add a New Recipient


1. Fromthemenubar,selectConfiguration > Mail Recipients.TheMail
Recipientsscreendisplays.
2. SelectAction > New.TheNewMailRecipientdialogboxdisplays.

Figure 115 The New Mail Recipient dialog box.

July 2016

User GuideSpectra BlackPearl Gateway

161

Chapter 9 Using AutoSupport

Configure Mail Recipients

3. Enterthefollowinginformationforthemailrecipient:
Field

Description

Name

Thenameoftherecipient.

Email Address

Theemailaddressoftherecipient.Besuretousethefulladdressusingthe
standardemailformat,includingthe@symbol.
Important: The address cannot contain spaces or other non-alphanumeric
characters (for example, an ampersand, &).

Select AutoSupport
log sets to send to
this mail recipient

SelectScheduled Log Sets,Error Log Sets,bothoptions,orneitheroptionforthe


mailrecipient.ScheduledlogsetsaresentfromtheBlackPearlgatewayonthe
firstofeachmonth.Errorlogsetsaresentanytimeanerroroccursthatcauses
thegatewaytogeneratealogset.

Choose the
message severities
you want to receive

Selectfromthelistedmessagetypeswhichseveritiesofmessagethismail
recipientshouldreceive.TheBlackPearlgatewayautomaticallysendsemail
messagesoftheselectedseveritytotherecipientwhentheyaregenerated.
Note: Forthemailrecipienttoreceiveallmessagesgeneratedbythegateway,
selectallboxes.

4. ClickCreatetosavetheinformation.TheMailRecipientsscreenre
displayswiththenewmailrecipientaddedtothelistofmailrecipients.
5. RepeatStep 1throughStep 4toconfigureadditionalmailrecipients.

Edit a Mail Recipient


Usethefollowingstepstoeditamailrecipientaccount.
1. Fromthemenubar,selectConfiguration > Mail Recipients.TheMail
Recipientsscreendisplayswithanyalreadyconfiguredmailrecipients
listed(seeFigure 114onpage 161).

July 2016

User GuideSpectra BlackPearl Gateway

162

Chapter 9 Using AutoSupport

Configure Mail Recipients

2. Fromthelistofmailrecipients,doubleclickthenameoftherecipient
whoseinformationyouwanttoedit,orselectthenameandthenselect
Action > Edit.TheEditMailRecipientdialogboxdisplays.

Figure 116 Edit the information for the selected mail


recipient.
3. Changetheinformationfortherecipientasrequiredandthenclick
Save.

Send a Test Email


Usethefollowingstepstosendatestemailtoamailrecipient.
1. Fromthemenubar,selectConfiguration > Mail Recipients.TheMail
Recipientsscreendisplayswithanyalreadyconfiguredmailrecipients
listed(seeFigure 114onpage 161).
2. Fromthelistofmailrecipients,selectthenameoftherecipientyou
wanttoreceiveatestemail,andthenselectAction > Send test email.

Figure 117 The Mail Recipients screen.


TheBlackPearlgatewayimmediatelysendsatestemailtotheselected
account.

July 2016

User GuideSpectra BlackPearl Gateway

163

Chapter 9 Using AutoSupport

Log Sets

3. VerifytheuserreceivedtheemailfromtheBlackPearlgateway.Ifthe
emailisnotreceived,verifythatyouenteredtheSMTPserversettings
correctly(seeConfigureSMTPSettingsonpage 88).

Delete a Mail Recipient


Usethefollowingstepstodeleteamailrecipientaccount.
1. Fromthemenubar,selectConfiguration > Mail Recipients todisplay
theMailRecipientsscreenwithanyalreadyconfiguredmailrecipients
listed(seeFigure 114onpage 161).
2. Fromthelistofmailrecipients,selectthenameoftherecipientwhose
accountyouwanttodeleteandthenselectAction > Delete.Adialog
boxdisplaysaskingyoutoconfirmthedeletionofthemailrecipient.
Note: ThedefaultSpectramailrecipientcannotbedeleted.

Figure 118 Delete the selected mail recipient.


3. ClickDeletetoconfirmthedeletion.

LOG SETS
TheBlackPearlgatewayautomaticallygenerateslogsetswhenerrors
occur.Logsetscanalsobegeneratedmanually,orgeneratedonaschedule.
Thegatewaygeneratesthreetypesoflogsets:

July 2016

LogSetscontaininformationabouttheconfigurationandstatusof
theBlackPearlgatewayandareusedforgeneraltroubleshooting.
LogsetscanbemailedtoconfiguredmailrecipientsortoSpectra
LogicTechnicalSupport.

StatisticLogSetscontainperformancedataaboutthegatewayand
areusedbySpectraLogicTechnicalSupportforindepth
troubleshooting.Statisticlogsetsaretoolargetobemaileddirectly
fromthegatewayandmustbedownloaded.

KernelLogSetsaregeneratedwheneveraprocessonthegateway
fails.Thisreportcannotbegeneratedmanually.

User GuideSpectra BlackPearl Gateway

164

Chapter 9 Using AutoSupport

Log Sets

DataPathLogSetsareusedtodetermineifthereisaprobleminthe
dataplannercode.Thislogsetcontainsnocustomerdataandis
usedbySpectraLogicTechnicalSupport.

UsetheLogsscreentogenerate,email,ordownloadlogsets,aswellasto
configurealogsetschedule.

Figure 119 The Logs screen.

Manually Generate Log Sets


AlthoughtheBlackPearlgatewayautogenerateslogsetswhenevererrors
occur,youmaywanttocreatelogsetsmanuallyfortroubleshooting
purposes,orattherequestofSpectraLogicTechnicalSupport.Usethe
followinginstructionstomanuallygeneratealogset.
1. Fromthemenubar,selectSupport > Logs.TheLogsscreendisplays.
2. Createthedesiredlogset:

SelectAction > New Log Settogeneratealogsetforuseingeneral


troubleshooting.ContinuewithEmailaLogSetonpage 166or
DownloadaLogSetonpage 167.
OR

SelectAction > New Statistic Log Settogeneratealogsetusedfor


indepthtroubleshooting.Thislogisnothumanreadable.Tosee
performancestatisticsinahumanreadableform,seeView
PerformanceMetricsonpage 135.ContinuewithDownloadaLog
Setonpage 167.
OR

July 2016

User GuideSpectra BlackPearl Gateway

165

Chapter 9 Using AutoSupport

Log Sets

SelectAction > New Data Path Log togeneratealogsetusedfor


troubleshootingthedatacommunicationpathtothegatewayand
itsassociatedtapelibrary.TheNewDataPathLogdialogbox
displays.

Figure 120 The New Data Path Log dialog box.


a. SelecttheApplicationforwhichyouwanttogeneratealogset.
Application

Description

S3 Server

TheS3ServerlogshowsallSpectraS3APIcommands
senttothegateway.

Data Planner

TheDataPlannerlogshowshowdatasenttothe
gatewayisorganizedandstoredtotape.

b. ClickCreate.
c. ContinuewithEmailaLogSetonpage 166orDownloadaLog
Setonpage 167.

Email a Log Set


Usetheinstructionsinthissectiontoemailalogset.
Note: YoumustconfiguretheSMTPsettingsonthegatewaybefore
youcansendemails.SeeConfigureSMTPSettingsonpage 88to
configuretheSMTPsettings.
1. Fromthemenubar,selectSupport > Logs.TheLogsscreendisplays
(seeFigure 119).

July 2016

User GuideSpectra BlackPearl Gateway

166

Chapter 9 Using AutoSupport

Log Sets

2. Selectthelogsetyouwanttoemail,andthenselectAction > Email.


TheEmailLogSetdialogboxdisplays.
Note: StatisticLogSetsaretoolargetobeemailedfromthegateway,
andmustbedownloaded.SeeDownloadaLogSet,below.

Figure 121 The Email Log Set dialog box.


3. Selectthemailrecipientsyouwanttoreceivethelogset,andclick
Email.

Download a Log Set


Usetheinstructionsinthissectiontodownloadalogset.
1. Fromthemenubar,selectSupport > Logs. TheLogsscreendisplays
(seeFigure 119onpage 165).
2. Selectthelogsetyouwanttodownload,andthenselectAction >
Download.Thelogsetbeginsdownloadingtoyourhostcomputer.

Configure a Log Set Schedule


Usetheinstructionsinthissectiontoconfigurealogsetschedule.
1. Fromthemenubar,selectSupport > Logs. TheLogsscreendisplays
(seeFigure 119onpage 165).
2. SelectAction > New Log Set Schedule.TheNewLogSetSchedule
dialogboxdisplays.

Figure 122 The New Log Set Schedule dialog box.


July 2016

User GuideSpectra BlackPearl Gateway

167

Chapter 9 Using AutoSupport

Log Sets

3. EnteratimevalueforStart Time,andincludeAMorPMafterthevalue.
Thisfieldisnotcasesensitive.
4. SelectoneormoredaysforEvery week on:.Thisdeterminestheday(s)
oftheweekthesystemgenerateslogsets.
5. ClickCreate.TheLogsscreendisplaysshowingthenewlycreatedLog
SetSchedule.

Delete a Log Set or Log Set Schedule


Usetheinstructionsinthissectiontodeletealogset,orlogsetschedule.
1. Fromthemenubar,selectSupport > Logs.TheLogsscreendisplays
(seeFigure 119onpage 165).
2. Selectthelogsetorlogsetscheduleyouwanttodelete,andthenselect
Action > Delete.Aconfirmationwindowdisplaysaskingyouto
confirmtheaction.
3. ClickDeletetoremovethelogsetorlogsetschedule.
4. Optionally,useoneofthefollowingcommandstodeletelogsetsin
bulk:
Command

Description

Action > Delete All Log Sets

Deletesalllogsetspresentonthegateway.

Action > Delete All Statistic Log Sets

Deletesallstatisticlogsetsonthegateway.

Action > Delete All Kernel Logs

Deletesallkernellogsetsonthegateway.

Action > Delete All Data Path Logs

Deletesalldatapathlogsetsonthegateway.

July 2016

User GuideSpectra BlackPearl Gateway

168

CHAPTER 10
Maintaining the BlackPearl Gateway
ThischapterdescribesthemaintenanceproceduresfortheSpectra
BlackPearlDeepStorageGateway.
Task
DataIntegrityVerification

page 170

AccessingtheTechnicalSupportPortal

page 171

CreateanAccount

page 171

LogIntothePortal

page 172

ConfiguringAutomatedSoftwareUpload

page 173

UpdatingSoftware

page 174

ChecktheCurrentSoftwareVersion

page 175

ChecktheCurrentlyReleasedSoftware
Version

page 175

DownloadandStagetheUpdatedSoftware

page 176

InstalltheUpdate

page 178

ReplacingaFailedComponent
IdentifytheFailedComponent

169

page 179
page 179

Chapter 10 Maintaining the BlackPearl Gateway

Data Integrity Verification

DATA INTEGRITY VERIFICATION


TheBlackPearlgatewayallowsyoutoperformadataintegrityverification
onanydiskpoolsconnectedtothegateway,includingtheinternaldisk
poolscontainingtheBlackPearlcacheanddatabase.Performingadata
verificationcheckonadiskpoolisusefulwhenyouwanttoensurethe
dataonthediskpoolisstoredcorrectly
Thedataintegrityverificationcheckisasectorbysectorcheckoftheentire
storagepool,notjustthedatacontainedonthepool.Dataintegritychecks
varybasedonthesizeofpool,andinsomecasescantakeaverylongtime
tocomplete.
Usetheinstructionsinthissectiontoperformadataintegrityverification
checkonadiskpool.
1. Fromthemenubar,selectSupport > Tools > Data Integrity
Verification. TheDataIntegrityVerificationscreendisplays.

Figure 123 The Data Integrity Verification page.


2. Selectthediskpoolforwhichyouwanttorunadataintegrity
verificationcheck,andselectAction > Start.Aconfirmationscreen
displays.
Note: Whileadataintegrityverificationisinprogress,thediskpool
mayexperiencedegradedperformance.However,clientaccess
andrebuildshavepriorityoverthedataintegrityverification
check.
3. ClickStart Data Verification.

Caution

July 2016

If the data integrity verification fails, contact Spectra Logic Technical Support (see
Contacting Spectra Logic on page 4) for assistance in determining the affected files
on the disk pool. The affected files cannot be retrieved from the storage pool, and
may need to be transferred to the BlackPearl gateway again, depending on if you
originally made multiple copies of the data to separate media platforms, such as to
a tape partition. If you do not have copies of the affected files on your host or
another location, they are lost.

User GuideSpectra BlackPearl Gateway

170

Chapter 10 Maintaining the BlackPearl Gateway

Accessing the Technical Support Portal

ACCESSING THE TECHNICAL SUPPORT PORTAL


TheSpectraLogicTechnicalSupportportalprovidesaccesstothe
KnowledgeBase,thecurrentversionofBlackPearlsoftwareforthe
gateway,andadditionalserviceandsupporttools.Youcanalsoopenor
updateasupportincidentanduploadlogfiles.

Create an Account
AccesstoUserGuidesandcompatibilitymatricesdoesnotrequireyouto
createanaccount.Youmustcreateauseraccountandlogintoaccess
ReleaseNotesorrepairdocuments,todownloadthelatestversionof
BlackPearlsoftware,ortoopenasupportticket.
Note: IfyouownmultipleSpectraLogicproducts,theserialnumbers
forallproductsareassociatedwithyouraccount.Ifyoudonot
seetheserialnumbersforallofyourproductswhenyoulogin,
contactTechnicalSupport(seeContactingSpectraLogicon
page 4).
1. AccesstheTechnicalSupportportalloginpageat
support.spectralogic.com.
2. Onthehomepage,clickSign up for one now!

Figure 124 The Spectra Logic Technical Support portal home page.

July 2016

User GuideSpectra BlackPearl Gateway

171

Chapter 10 Maintaining the BlackPearl Gateway

Accessing the Technical Support Portal

3. Enteryourregistrationinformation.Youraccountisautomatically
associatedwiththeserialnumbersofallSpectraLogicproductsowned
byyoursite.

Ifyouhaveaninvitation,followthelinkandentertheinvitation
code.

Figure 125 Follow the link to enter your invitation code or


enter your registration information.

Ifyoudonothaveaninvitation,entertherequestedinformationto
createyouraccount.Whenyouarefinished,clickSign Up.

Whentheaccountisapproved,youreceiveanemailwithalinktosetup
yourinitialpassword.Useyouremailaddressandthepasswordprovided
intheemailtologintoyouraccount.Afteryoulogin,youcanchange
yourpasswordifdesired.

Log Into the Portal


AccesstheTechnicalSupportportalloginpageat
support.spectralogic.com.Useyouremailaddressandpasswordtolog
intotheTechnicalSupportPortal.
July 2016

User GuideSpectra BlackPearl Gateway

172

Chapter 10 Maintaining the BlackPearl Gateway

Configuring Automated Software Upload

CONFIGURING AUTOMATED SOFTWARE UPLOAD


AutomatedSoftwareUploadisafeaturethatallowsthesystemto
periodicallycheckaspecifiedservertodetermineifupdatedsoftwareis
availableforthegateway.Thefeaturecanalsobeusedtoautomatically
downloadtheupdatedsoftwarepackagetothegateway.
Note: Youmusthaveacurrentsoftwareupdatekeyenteredinthe
gatewayyouwanttoconfiguretouseAutomatedSoftware
Upload.SeeDatabaseBackup&Restoreonpage 138formore
information.
UsetheinstructionsinthissectiontoconfigureAutomatedSoftware
Upload.
1. Fromthemenubar,selectSupport > Software. TheSoftwarescreen
displays.
2. SelectAction > Edit Automated Software Upload.TheAutomated
SoftwareUploaddialogboxdisplays.

Figure 126 The Automated Software Upload dialog box.


3. SelecttheEnabledcheckboxtoenablethefeature.
4. UsethedropdownmenutoselecttheCheck for updatesfrequency.
5. Optionally,selecttheEmail Notifications Onlycheckboxtoonlyreceive
anemailwhenanupdatedsoftwarepackageisavailableinsteadof
automaticallydownloadthefile.
6. SelecteitherSpectra LogicorUse ProxyastheUpload Fromlocation.

Important

Spectra Logic recommends using the Spectra Logic package server.

IfyouselectUse Proxy,enterthefollowinginformation:

Proxy IP AddressEnteravalidIPv4address.

Proxy PortEntertheportusedtoaccesstheproxyserver.

7. ClickSave.

July 2016

User GuideSpectra BlackPearl Gateway

173

Chapter 10 Maintaining the BlackPearl Gateway

Updating Software

UPDATING SOFTWARE
SomeproblemswiththeBlackPearlgatewaymaybefixedbyupdatingthe
gatewayssoftware.SpectraLogicprovidescompletesupportforthemost
currentreleaseofsoftwareandonerevisionback.Customersusing
previouslyreleasedsoftwarepackagesareaskedtoupdatetothecurrent
releaseassoonaspossible.
Note: Youmusthaveacurrentsoftwareupdatekeyenteredinthe
gatewayyouwanttoupdate.SeeDatabaseBackup&Restoreon
page 138formoreinformation.
IfAutomatedSoftwareUploadisenabled,thegatewaysendsanemailto
allusersconfiguredtoreceiveWarningorInformationalemails(see
ConfigureMailRecipientsonpage 161)andpostsasystemmessagetothe
Messagesscreen.Ifconfiguredtodoso,thegatewayalsodownloadsthe
updatedsoftware.
ThemethodusedtoupdatethegatewaydependsoniftheAutomated
SoftwareUploadfeatureisenabledornot,andifenabled,whetheritis
configuredtodownloadtheupdatedsoftware.

July 2016

Iftheupdatepackagedownloadedautomatically,skiptoInstallthe
Updateonpage 178.

Ifyouwerenotifiedthatanupdateisrequired,buttheupdatedid
notdownloadautomatically,skiptoDownloadandStagethe
UpdatedSoftwareonpage 176.

Ifyoudonotknowifthegatewayneedsanupdateinstalled,
continuewithChecktheCurrentSoftwareVersiononpage 175.

User GuideSpectra BlackPearl Gateway

174

Chapter 10 Maintaining the BlackPearl Gateway

Updating Software

Check the Current Software Version


Usethefollowingstepstodeterminethecurrentsoftwareversionrunning
onyourBlackPearlgateway.
1. Fromthemenubar,selectSupport > Software. TheSoftwarescreen
displays.
2. ThecurrentsoftwareversionislistednexttoCurrent Versioninthe
SoftwareUpdatepane.

Figure 127 The current BlackPearl software version.

Check the Currently Released Software Version


FollowthesestepstocheckthecurrentlyrecommendedBlackPearl
softwareversion:
1. LogintoyouruseraccountontheTechnicalSupportportalat
support.spectralogic.com.
Note: SeeCreateanAccountonpage 171forinformationabout
creatinganaccountandaccessingtheTechnicalSupportportal.
2. SelectDownloads > Product Software.

July 2016

User GuideSpectra BlackPearl Gateway

175

Chapter 10 Maintaining the BlackPearl Gateway

Updating Software

3. OntheProductSoftwarepage,locatetheBlackPearlgatewayinthe
SpectraProductcolumn.ThecurrentlyreleasedBlackPearlsoftware
versionislistedintheCurrent Versioncolumn.

Figure 128 The Product Software screen.


4. ComparetheCurrentVersionavailablefortheBlackPearlgatewayto
theversioninstalledonthegateway.

Download and Stage the Updated Software


Usetheinstructionsinthissectiontodownloadandstagetheupdated
softwarefortheBlackPearlgateway.
1. LogintoyouraccountontheTechnicalSupportportalat
support.spectralogic.com.

July 2016

User GuideSpectra BlackPearl Gateway

176

Chapter 10 Maintaining the BlackPearl Gateway

Updating Software

2. SelectDownloads > Product Software.TheProductSoftwareScreen


displays.

Figure 129 The Product Software screen.


3. LocatetheBlackPearlgatewayintheSpectraProductcolumn.The
currentlyreleasedBlackPearlsoftwareversionislistedintheCurrent
Versioncolumn.
4. ClickthenameoftheBlackPearlpackage.Thepackagebegins
downloadingthroughyourwebbrowser.Donotunzipthe
downloadedfile.

July 2016

User GuideSpectra BlackPearl Gateway

177

Chapter 10 Maintaining the BlackPearl Gateway

Updating Software

5. FromtheBlackPearlmenubar,selectSupport > Software todisplay


theSoftwarescreen.ClickChoose File. Usingyourwebbrowser,browse
tothelocationoftheupdatefileandselectthefiletoupload.Thefileis
stagedtothesystem.

Figure 130 The Software Update screen with an available software package
listed.

Install the Update


1. DiscontinueallfilestorageoperationsontheBlackPearlgateway.The
gatewayautomaticallyrebootsaspartoftheupdateprocess.
2. Fromthemenubar,selectSupport > Software todisplaytheSoftware
screen.TheSoftwarescreendisplayswiththesoftwareuploadfile
stagedtothesystem.

Figure 131 The Software Update screen with a software package staged to
the system.
3. ClickUpdate.Aprogressbarshowstheprogressoftheupdate.

Figure 132 The Software Update screen showing the progress of an


update.
July 2016

User GuideSpectra BlackPearl Gateway

178

Chapter 10 Maintaining the BlackPearl Gateway

Replacing a Failed Component

4. Whentheupdateiscomplete,theBlackPearlgatewayautomatically
rebootstobeginusingthelatestsoftware.
5. Restartfilestorageoperations.

REPLACING A FAILED COMPONENT


IfacomponentinaBlackPearlgatewayisnotfunctioningproperly,the
systemgeneratesamessageandthehardwareicononthestatusbarofthe
BlackPearluserinterfacechangestoanerroricon(seeStatusIconson
page 29).

Identify the Failed Component


1. Fromthemenubar,selectStatus > Hardware.TheHardwarescreen
displays.Themalfunctioningcomponentisindicatedbyanerroricon.

Figure 133 The Hardware screen showing a failed component.

July 2016

User GuideSpectra BlackPearl Gateway

179

Chapter 10 Maintaining the BlackPearl Gateway

Replacing a Failed Component

2. IfyouhavemultipleBlackPearlgateways,youcanusethebeacon
featuretohelplocatethegatewaywiththefailedcomponent.Onthe
Hardwarescreen,clicktheservername.Thescreenrefreshestoshow
themainHardwarescreen.

Figure 134 The Hardware screen.


3. ClickTurn Beacon On.TheBlackPearlgatewayVisualStatusBeacon
lightbarflashesblue,makingiteasytofind.
4. Afteryoulocatetheunitinyourdatacenter,clickTurn Beacon Offto
stopthelightsfromflashing.
5. Forspecificpartreplacementprocedures,refertooneofthefollowing
guides,whichcanbefoundafterloggingintotheSpectraLogicsupport
portalatsupport.spectralogic.com.

July 2016

TheSpectra12&36DriveChassisBootDriveReplacementGuide
providesinstructionsforreplacingafailedbootdriveinthe
gateway.

TheSpectra12,36&45DriveChassisDriveReplacementGuide
providesinstructionsforreplacingafaileddatadriveafterthe
gatewayisinstalled.

TheSpectra12,36&45DriveChassisFanReplacementGuide
providesinstructionsforreplacingafailedfaninthegateway.

TheSpectra12,36&45DriveChassisPowerSupplyReplacement
Guideprovidesinstructionsforreplacingafailedpowersupplyafter
thegatewayisinstalled.

TheSpectra12DriveChassisHBAReplacementGuideandSpectra36
DriveChassisHBAReplacementGuideprovideinstructionsfor
replacingafailedHBAinthegateway.

User GuideSpectra BlackPearl Gateway

180

Chapter 10 Maintaining the BlackPearl Gateway

July 2016

Replacing a Failed Component

TheSpectra96DriveChassisDriveReplacementGuideprovides
instructionsforreplacingafaileddatadriveintheArcticBlue
expansionnode.

TheSpectra96DriveChassisFanReplacementGuideprovides
instructionsforreplacingafailedfanintheArcticBlueexpansion
node.

TheSpectra96DriveChassisPowerSupplyReplacementGuide
providesinstructionsforreplacingafailedpowersupplyinthe
ArcticBlueexpansionnode.

TheSpectra96DriveChassisI/OModuleReplacementGuideprovides
instructionsforreplacingafailedI/OmoduleintheArcticBlue
expansionnode.

User GuideSpectra BlackPearl Gateway

181

CHAPTER 11
Troubleshooting and Support
Usetheinformationinthisappendixtotroubleshootproblemsonthe
SpectraBlackPearlDeepStorageGatewayastheyarise,beforecontacting
SpectraLogicTechnicalSupport.
Task
ResolvingaBlackPearlManagementPortIP
AddressConflict

page 183

UsingtheConsole

page 183

UsingaSeparateComputer

page 183

NetworkSetupTips

page 185

Configuration

page 185

ConnectivitytotheNetwork

page 186

Troubleshooting

page 188

Tools

page 188

Troubleshooting

page 189

FAQ

page 197

SpectraLogicTechnicalSupport

page 206

BeforeContactingSupport

page 206

DetermineGatewaySerialNumber

page 206

OpeningaSupportTicket

page 207

EnablingRemoteSupport

page 211

DisablingRemoteSupport

page 212

182

Chapter 11 Troubleshooting and Support

Resolving a BlackPearl Management Port IP Address Conflict

RESOLVING A BLACKPEARL MANAGEMENT PORT IP ADDRESS


CONFLICT
ThedefaultaddressoftheBlackPearlmanagementportissetto10.0.0.2
withanetmaskof255.255.255.0.IfyournetworkisalreadyusingthisIP
address,youarenotabletoaccesstheBlackPearluserinterface.
OneresolutiontotheissueistochangetheIPaddressofthemachine
alreadyonyournetworktoadifferentaddress.Thenconnecttothe
BlackPearlgatewayasdescribedinLogIntotheBlackPearlUserInterface
onpage 34.Ifyoucannot,ordonotwanttochangetheIPaddressofthe
existingmachine,followtheinstructionsinthissectiontoconnectyour
BlackPearlgatewaytoyournetwork.

Using the Console


UsingtheBlackPearlconsoleistherecommendedwaytochangethe
BlackPearlmanagementportIPaddress.Forinstructionsonusingthe
consoletoconfigurethemanagementportIPaddress,seeConfigurethe
BlackPearlManagementPortonpage 33.

Using a Separate Computer


Ifyoucannotusetheconsole,useacomputerorlaptopdisconnectedfrom
anyexistingnetworktochangetheBlackPearlmanagementportIP
address.
1. Gatheralaptopordesktopcomputernotcurrentlyonanynetwork.
Disableanywirelessnetworking,ifnecessary.
2. UsingastandardEthernetcable,connecttheEthernetportonthe
computertotheBlackPearlmanagementportontheBlackPearl
gateway.SeeRearPanelonpage 22tolocatethemanagementport.
3. Openawebbrowseronthecomputer.Foralistofcompatible
browsers,seeSupportedBrowsersonpage 29.
4. EntertheIPaddressbelowinthebrowseraddressbar:
https://10.0.0.2

July 2016

Notes:

ThenetmaskforthedefaultIPaddressis255.255.255.0.

TheBlackPearluserinterfaceusesasecureconnection.

User GuideSpectra BlackPearl Gateway

183

Chapter 11 Troubleshooting and Support

Resolving a BlackPearl Management Port IP Address Conflict

5. ResolvethesecuritycertificatewarningfortheBlackPearluser
interface.Thewarningdisplaysbecausethegatewaydoesnothavea
securitycertificate.
Notes:

Consultyourbrowserdocumentationforinstructionson
howtoresolvethesecuritycertificatewarning.

Theabsenceofthecertificatedoesnotaffectfunctionality.

6. Entertheloginusernameandpassword.
Thedefaultusernameandpasswordarebothspectra,usingall
lowercaseletters.
7. Fromthemenubar,selectConfiguration > Network,orclickthe
NetworkpaneontheDashboardscreen.TheNetworkscreendisplays
informationaboutthenetworkconnectionsofthegateway.
8. IntheNetworkInterfacespane,selecttheManagementrow,andthen
selectAction > Edit.TheEditManagementdialogboxdisplays.

Figure 135 The Edit Management dialog box.


9. SelecteitherDHCPorStaticastheaddressingmethod.
Note: IfyouselectDHCP,youarenotabletoseetheIPaddress
assignedbyDHCPbeforeyouareloggedoutoftheBlackPearl
userinterface.Contactyoursystemadministratortodetermine
theDHCPaddressforthemanagementport.
Ifyouselectstaticaddressing,enterthefollowinginformation:

IP AddressEnteravalidIPv4address.

NetmaskEnterthesubnetmask.

Default GatewayEnterthedefaultnetworkgateway.

10. ChangetheMTUvalue,ifdesired.IfyousettheMTUvalueto
somethingotherthan1500,ensurethatyourswitchconfiguration
supportslargerMTUsettings,aswellasallthehostsonthenetwork.

July 2016

User GuideSpectra BlackPearl Gateway

184

Chapter 11 Troubleshooting and Support

Network Setup Tips

11. ClickSave.
Note: WhenyouchangetheIPaddressoftheBlackPearlmanagement
port,youloseyourconnectiontotheuserinterfacewhenyou
saveyourchanges.Toreestablishtheconnection,enterthenew
IPaddressinyourbrowserandloginagain.
12. DisconnecttheEthernetcablefromtheBlackPearlmanagementport.
13. Connectacablefromyournetworktothemanagementportonthe
BlackPearlgateway.Youarenowabletoconnecttothegatewaywith
theIPaddressconfiguredinStep 9onpage 184.

NETWORK SETUP TIPS


TheBlackPearlmanagementportisseparatedfromthedataports.The
managementportanddataportshavetheirowndefaultroutes.Thisdoes
notpreventauserfromhavingthemanagementanddataportsutilizing
thesamenetwork,ifdesired.
Thebasicstepsforconfiguringthemanagementanddataportsforaccess
tothenetworkaresimpleandstraightforward.However,eachnetwork
environmentisuniqueandmayrequiresomeadditionaltroubleshooting
inordertoproperlyconnecttotheBlackPearlgatewayandutilizethe
10GBaseTor10 GigEinterfacescorrectly.

Configuration
Thefirststepistoconfigurethemanagementanddataportsusingthe
BlackPearluserinterfaceorthecommandlineinterface.Donotattemptto
accessthesystemdirectlyandusetherootconsoletomodifyinterfaces.
Thewebandcommandlineinterfacesaretightlyintegratedwiththebase
operatingsystemandconfigureadditionalsystemfeaturesbasedon
networkchanges.
Note: ThecommandlineinterfaceisnotsupportedintheBlackPearl
softwareversion1.2release.

July 2016

User GuideSpectra BlackPearl Gateway

185

Chapter 11 Troubleshooting and Support

Network Setup Tips

Connectivity to the Network


Thefollowingconfigurationsaresupportedforthedatapath:
Recommended:

Single10GigElogicalconnectionusingoneofthe10GigEphysical
ports
OR

Single20GigElogicalconnectionusingtwo10GigEphysicalports
(linkaggregation)

NotRecommended:

Singlegigabitlogicalconnectionutilizingoneofthe10GBaseT
physicalportsandaCategory5eEthernetcable
OR

Single10gigabitlogicalconnectionutilizingoneofthe10GBaseT
physicalportsandaCategory6Ethernetcable

AssigntheappropriateIPaddresstothemanagementanddataports
eitherstaticallyorusingDHCP.IfyouaresettingtheMTUtosomething
otherthan1500,ensurethatyourswitchconfiguration,aswellasallthe
hostsonthenetwork,supportlargerMTUsettings.TheBlackPearl
gatewaycansupportjumboframes(MTU=9000),butallswitchesandhosts
onthenetworkmustbeconfiguredtosupportjumboframesifthisis
selected,orperformancemightbedegraded.

Link Aggregation Notes


SwitchesusedifferentmethodsofroutingtrafficfromhoststoNAS
servers.Therearealsomanydifferentnetworkconfigurationstomove
datafromhoststoNASservers.Forexample,someCiscoswitchesroute
trafficbasedontheMACaddressandtheIPaddress.TheBlackPearl
gatewaypresentsonlyoneMACaddressandoneIPaddresswhenthe
dataportsareaggregatedviaDHCP;ifstaticlinkaggregationischosen,it
presentsonlyoneMACaddress,butcanhaveupto16IPaddressesaliased
totheMACaddress.Itisuptotheswitchtorotatedatatransfersamong
thephysicalportsontheBlackPearlgatewayinordertoachievethe
highestthroughputpossible.
Additionally,iflinkaggregationisconfiguredfortheBlackPearlgateway,
thenswitchesmustalsobeabletosupportlinkaggregationtoaggregateor
trunkthedataportstogethertoprovidehigherbandwidthintothe
gateway.SwitchesmustsupportlinkaggregationusingLACP(Link
AggregationControlProtocol),andtheswitchesmusthashthedestination
IPaddresses.ManuallyconfigureLACPontheswitchports.LACPdoes
notgetenabledautomatically.

July 2016

User GuideSpectra BlackPearl Gateway

186

Chapter 11 Troubleshooting and Support

Network Setup Tips

Forexample,ifonlyasinglehostisconnectedtotheBlackPearlgateway
throughalinkaggregatedconnection,themeasuredperformanceislower
thanthepotentialmaximumtransferratebecauseonlyonephysicalportof
thetwoportlinkaggregationisbeingutilizedbytheswitch.Ifasingle
shareismountedtwotimesusingdifferentIPaddressesandtransfersare
startedtothatsharefromtwoseparatehosts,theresultingthroughput
wouldbeapproximatelytwicethatofasinglehostconnection.Youmay
needtoconfiguremorethantwoIPaddressesontheBlackPearlgatewayto
forcetheswitchhashingalgorithmtoutilizeallphysicalportstomaximize
performance.
Client mounts
IP address 1 Share X
IP address 2 Share X

Client

LACP
Destination IP address hashing
Switch

Single MAC address


2 static IP addresses assigned
IP address 1
IP address 2
Up to 16 static IP addresses
BlackPearl gateway

Link aggregation - two 10 GigE ports

Figure 136 Connection example utilizing two IP addresses assigned to a single


share.
Onceconfiguredcorrectlyandattachedtothenetwork,thestatusinthe
userinterfaceindicatesthespeedoftheconnectionandwhethertheportis
active.Thelinklightsonthenetworkportsshouldbeonandactiveatboth
theBlackPearlgatewayandthenetworkswitch.
Fromyournetwork,usethepingcommand(seePingonpage 188)totest
theassignedIPaddressfortheBlackPearlmanagementportordataport.If
thisisnotsuccessful,followthetroubleshootingtipsbelowtoascertainif
theproblemisanetworksetupissue.

July 2016

User GuideSpectra BlackPearl Gateway

187

Chapter 11 Troubleshooting and Support

Network Setup Tips

Troubleshooting
Port Link LED Does Not Light

Checktheportconfigurationonthenetworkswitch.TheBlackPearl
gatewayonlysupportsautonegotiation.Makesuretheswitchis
configuredtomatchspeedsonbothendsoftheconnection.

Checkthecablesthatconnecttheporttotheotherdevice.Makesure
thattheyareconnected.Verifythatyouareusingthecorrectcabletype
andconnectors.Thisisespeciallycriticalfor10 GigEconnections
utilizingSFPs.

Verifythattheswitchportsarenotadministrativelydisabled.Consult
theswitchUserGuideformoreinformation.

Port Link LED is Lit, But I Cannot Ping the BlackPearl


gateway

ChecktheLACPsettingsontheswitch.Ifyouareusinglink
aggregationontheBlackPearlgateway,theswitchMUSTbeconfigured
touseLACPonthoseports.Ifyouarenotusinglinkaggregation,the
switchmustbeconfiguredNOTtouseLACPonthoseports.

ChecktheVLAN(VirtualLocalAreaNetwork)settingsontheswitch.
EnsurethattheportsareassignedtothecorrectVLAN.

Tools
Ping
Thepingcommandisasimpletool,basedonarequestresponse
mechanism,toverifyconnectivitytoaremotenetworknode.Theping
commandisbasedonICMP(InternetControlMessageProtocol).The
requestisanICMPEchorequestpacketandthereplyisanICMPEcho
Reply.LikearegularIPpacket,anICMPpacketisforwardedbasedonthe
intermediateroutersroutingtable,untilitreachesthedestination.Afterit
reachesthedestination,theICMPEchoReplypacketisgeneratedand
returnedtotheoriginatingnode.

July 2016

User GuideSpectra BlackPearl Gateway

188

Chapter 11 Troubleshooting and Support

Troubleshooting

Forexample,toverifytheconnectivityfromtheswitchtotheIPaddress,
runthecommandshownbelowfromtheswitchcommandlineorclient:
ping 192.168.2.10
AllICMPEchorequestsshouldreceiverepliesincludinginformation
abouttheroundtriptimeittooktoreceivetheresponse.Aresponseof0
msecmeansthatthetimewaslessthan1ms.Iftherequesttimesout,then
checkthesettingsontheswitchtowhichtheBlackPearlgatewayis
connected.

Traceroute
Youcanusethetraceroutecommand,ifitisavailable,orsomething
similar,tonotonlyverifyconnectivitytoaremotenetworknode,butto
tracktheresponsesfromintermediatenodesaswell.Thetraceroute
commandsendsaUDPpackettoaportthatislikelytonotbeusedona
remotenodewithaTTLof1.Afterthepacketreachestheintermediate
router,theTTLisdecremented,andtheICMPtimeexceededmessageis
sentbacktotheoriginatingnode,whichincrementstheTTLto2,andthe
processrepeats.AftertheUDPpacketreachesadestinationhost,anICMP
portunreachablemessageissentbacktothesender.Thisactionprovides
thesenderwithinformationaboutallintermediateroutersonthewayto
thedestination.
Forexample,foraBlackPearlgatewayatIPaddress192.168.2.10,the
outputofthecommandshownbelow,
traceroute 192.168.2.10
showsanumberedlistindicatingthenumberofhopsencounteredwhen
tracingthepacketfromtheswitchtotheBlackPearlgateway

TROUBLESHOOTING
ThissectionhelpsyoutroubleshootproblemswiththeSpectraBlackPearl
gatewayandtheattachedSpectratapelibrary.
Ifyourproblemisnotaddressedbyanyofthebelowentries,contact
SpectraLogicTechnicalSupportforassistance(seeContactingSpectra
Logiconpage 2).

July 2016

User GuideSpectra BlackPearl Gateway

189

Chapter 11 Troubleshooting and Support

Troubleshooting

Issue

Resolution

An email is sent
from the tape
library regarding a
problem with a
tape drive

CheckthetapelibrarysBlueScaleinterfacetoensurethatthetapedrivesare
functioningnormally.
1. LogintotheBlueScaleinterfaceasdescribedinyourTapeLibraryUserGuide.
2. ReviewanySystemMessagesthatwerepostedbythelibraryandtakeany
actiondescribedinthemessage(s).
Ifthesystemmessagesdonotprovideenoughinformationtoresolvetheissue,
lookforadditionalinformationontheDLM(DriveLifecycleManagement)
Detailsscreen.
1. Fromthemenubar,selectConfiguration > DLM.TheDLMscreendisplays.
2. Examinethestatusofeachtapedrive.Ifadriveshowsanystatusbesidesa
goodstatus(greencheckmarkinacircle),clickDetailsforthatdrive,and
takeanyactiondescribedinthedetailsscreen.
3. Oncethetapedrivesarereturnedtogoodstatus,retrythejob.
Note: Ifyoucannotreturnyourtapedrivestogoodstatus,contactSpectra
LogicTechnicalSupport(seeContactingSpectraLogiconpage 2).

An email is sent
from the tape
library that a tape
drive cannot eject a
tape cartridge

ContactSpectraLogicTechnicalSupport(seeContactingSpectraLogicon
page 2).

July 2016

User GuideSpectra BlackPearl Gateway

190

Chapter 11 Troubleshooting and Support

Troubleshooting

Issue

Resolution

An email is sent
from the tape
library indicating
that drives need
cleaning

IftheBlackPearlgatewayisconnectedtoaSpectraT200,T380,T680,T950,or
TFinitylibrary,thelibraryshouldbeconfiguredwithacleaningpartition,
whichautomaticallycleansdriveswhencleaningisrequestedbythedrive.
IftheBlackPearlgatewayisconnectedtoaSpectraT50eorT120library,there
canonlybeonepartitiononthelibraryifyouwanttousetheBlackPearl
gatewaysejectfunction.Ifthereiscleaningmediainthedatapartition,the
BlackPearlgatewayautomaticallyinitiatescleaningtapedrivesusingthis
media.
IfyourcleaningtapesareLTOandMLMenabled,youcanusetheMLM
featuretomonitorthestatusofcleaningmedia.Checkthatvalidcleaning
mediaispresentinthecleaningpartitionasdescribedbelow.
1. LogintotheBlueScaleinterfaceasdescribedinyourTapeLibraryUserGuide.
2. T50eSelectMENU >General > Media Lifecycle Management.
AllotherlibrariesSelectGeneral > Media Lifecycle Management.
TheMLMReportscreendisplays.
3. UsingthePartitiondropdownmenu,selectTotal Library.
4. UsingtheReportdropdownmenu,selectCleans Remaining.
5. ClickGo.Thescreenredisplaystoshowthenumberofcleansremainingfor
allcleaningcartridgespresentinthelibrary.Confirmatleastonetapestill
hascleansremaining.
IfyourcleaningtapesarenotMLMenabled,ortheyareTS11x0media,you
cannotuseMLMtomonitorcleaningmedia.Youmustusethemessages
postedtothetapelibrarysSystemMessagesscreentodeterminewhena
pieceofcleaningmediaexpires.
Iftherearenocleaningtapeswithcleansremaining,usetheTapeLibraryUser
Guideappropriateforyourlibrarytypeforinstructionsonexchangingexpired
cleaningmedia.
Ifyoucontinuetoreceiveemailsthatdrivesarenotbeingcleaned,contact
SpectraLogicTechnicalSupportforassistance(seeContactingSpectraLogicon
page 2)

An email is sent
from the tape
library that
indicates a robotics
failure in the
library

GatheranASLasdescribedintheConfiguringandUsingAutoSupport
chapterinyourTapeLibraryUserGuide,andcontactSpectraLogicTechnical
Support(seeContactingSpectraLogiconpage 2).

July 2016

User GuideSpectra BlackPearl Gateway

191

Chapter 11 Troubleshooting and Support

Troubleshooting

Issue

Resolution

An email is sent
from the tape
library indicating a
tape cartridge
experienced a read
or write error

IftheBlackPearlgatewaydetectsamediaerrorwithatapecartridge,the
gatewayattemptstorollbacktoapreviouslysaved,knowngoodcheckpoint.
Usetheinstructionsinthissectiontoresolveamediaerror.
1. Makenoteofthetapebarcodethatexperiencedthemediaerror,andwhat
driveitwasinwhentheerroroccurred.
2. LogintothetapelibraryasdescribedinyourTapeLibraryUserGuide.
3. UsetheinstructionsinCleaningaDriveinyourTapeLibraryUserGuideto
cleantheaffecteddrivetwice.
4. SeeUseDLMtoTestanLTODriveinyourTapeLibraryUserGuidetotest
thedrive.Ifthedrivetestfails,contactSpectraLogicTechnicalSupportfor
assistance(seeContactingSpectraLogiconpage 2).
5. LogintotheBlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34.
6. IntheBlackPearluserinterface,selectStatus > Tape Management.TheTape
Managementscreendisplays.
7. Selectthetapethatexperiencedtheerror,andthenselectAction > Eject Tape.
TheEjectTapedialogboxdisplays.
8. Ifdesired,enterinformationintheEjectLabelandEjectLocationfields.This
informationisstoredonthetapeandisvisiblewhenreimportingthetape
intoaBlackPearlgateway.Youarenotrequiredtoenterthisinformation.
9. ClickEject.ThetapeismarkedasejectedintheBlackPearlgatewaydatabase,
andmovedtotheEntry/Exitpoolintheattachedtapelibrary.
10.ExportthecartridgefromthetapelibraryasdescribedinyourTapeLibrary
UserGuide.
11.Inspectthecartridgefordamage.Ifthetapedoesnotshowanysignsof
damage,reimportthecartridgeintothetapelibrary.Ifthecartridgeis
damaged,discardthecartridge.
Ifyoucontinuetoexperiencemediaerrors,contactSpectraLogicTechnical
Supportforassistance(seeContactingSpectraLogiconpage 2).

The BlackPearl
gateway reports
tapes as Write
Protected on the
Tape Management
screen

Ifthetapehaswriteprotectionsetintentionallytoprotectvaluabledatafrom
beingoverwritten,thenselectanothertape.Ifthetapenolongerneedsto
remainwriteprotected,useyourTapeLibraryUserGuidetoexportthetapeand
disablewriteprotection.Thenreimportthetapecartridgeintothetapelibrary.
Note: IfthetapeisstillreportedasWriteProtected,contactSpectraLogic
TechnicalSupport(seeContactingSpectraLogiconpage 2).

A system message
on the BlackPearl
gateway reports
No tapes
available for a
storage domain

WhentheBlackPearlgatewayrunsoutofusabletapemedia,itpostsamessage
thatindicatesthereareNotapesavailable.Importadditionalcartridgesinto
thetapelibraryasdescribedinyourTapeLibraryUserGuide.
Note: Ifyourtapelibraryisatfullcapacity,youmayneedtoexchangefull
tapesfornewones,orincreasethecapacitylicenseonyourlibrary.If
exchangingtapes,youmustejectthetapesfromtheBlackPearlgatewaybefore
exportingthetapesfromthetapelibrary.SeeEjectTapesonpage 108.

July 2016

User GuideSpectra BlackPearl Gateway

192

Chapter 11 Troubleshooting and Support

Troubleshooting

Issue

Resolution

The BlackPearl
gateway displays
an error message
when attempting
to eject a tape

InordertousetheBlackPearlejectfunctiononaT50eorT120library,youmust
configureasinglepartitionandselectStandardasthepartitionsEntry/ExitPort
Mode.IfyouconfigurethepartitiontouseeithertheSharedorQueuedEject
mode,oryouconfiguremorethanonepartitiononyourlibrary,ejectsfromthe
BlackPearlgatewayfail.
SeeConfiguringandManagingPartitionsintheT50eLibraryUserGuide,or
PartitionManagementintheT120LibraryUserGuideforinstructionson
configuringapartitiontousetheStandardmodefortheEntry/Exitport.

An email is sent
from the BlackPearl
gateway indicating
that the tape
backend is
deactivated

Thisissuecanoccuriftheattachedtapelibraryeitherrebootsorpowersdown.
Ifthetapelibraryreboots,waitwhilethelibrarycompletesinitialization.The
BlackPearlgatewayautomaticallyestablishescommunicationwiththetape
libraryonceitcompletesitsinitialization.
Ifthetapelibrarypowersdown,poweronthelibrarybypressingthepower
buttononthefrontpanel(seeyourTapeLibraryUserGuideformore
information).Thenwaitwhilethelibrarycompletesinitialization.The
BlackPearlgatewayautomaticallyestablishescommunicationwiththetape
libraryonceitcompletesitsinitialization.
YoumayneedtoactivatethedatapathbackendontheBlackPearlgateway.
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34.
2. Fromthemenubar,selectConfiguration > Services.TheServicesscreen
displays.
3. SelecttheS3ServiceandselectAction > Show Details.TheS3Servicedetails
screendisplays.
4. OntheS3Servicedetailscreen,makesuretheData Path Backend Activatedis
settoYes.Ifnot,selectAction > Activate Data Path Backend.
Ifyoucontinuetoexperienceproblemswiththetapelibrary,gatheran
AutoSupportlogasdescribedinyourTapeLibraryUserGuide,andcontact
SpectraLogicTechnicalSupport(seeContactingSpectraLogiconpage 2).

An email is sent
from the BlackPearl
gateway indicating
that a tape it needs
to complete a GET
operation is not
present in the tape
library

Thetapemayhavebeenexportedfromthetapelibraryeitheronpurposeorby
mistake.Locateandreimportthetapeintothetapelibraryasdescribedinyour
TapeLibraryUserGuide.Oncethetapeisreimported,thegatewayinspectsthe
tapeandusesitasneeded.

July 2016

User GuideSpectra BlackPearl Gateway

193

Chapter 11 Troubleshooting and Support

Troubleshooting

Issue

Resolution

An email is sent
from the BlackPearl
gateway indicating
a hardware failure

Overtime,replaceablecomponentsintheBlackPearlgatewaymayweardown
andfail.Usetheinstructionsinthissectiontodeterminethefailedcomponent.
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34.
2. Fromthemenubar,selectStatus > Hardware.TheHardwarescreen
displays.
3. ExaminetheHardwarescreenforanyfailedcomponents,whichare
designatedbyaredXinacircle.
4. ContactSpectraLogicTechnicalSupporttorequestapartreplacement(see
ContactingSpectraLogiconpage 2).SpectraLogicprovidesyouwiththe
replacementpart.Thedocumentationforallreplacementpartscanbefound
ontheSpectraLogicsupportportal,atsupport.spectralogic.com,afteryou
logintotheportal.
Thelistofcustomerreplaceablepartsisasfollows.Anyotherpartfailuresare
resolvedbyonsiteSpectrarepresentatives.
DataDrives
BootDrives
Fans
PowerSupplies
HBAs
TapeDrives(installedinthetapelibrary)

July 2016

User GuideSpectra BlackPearl Gateway

194

Chapter 11 Troubleshooting and Support

Troubleshooting

Issue

Resolution

An email is sent
from the BlackPearl
gateway indicating
that the cache is
full

TheBlackPearlcachecanbecomefullforseveralreasons:
ForPUTjobs,oneormoredatarepositories(tapelibrary,diskpartition)is
offline,ordoesnothavesufficientspacetowriteallthedatacurrentlyinthe
cache.Datawillsitinthecacheuntiltheproblemiscorrected.
Checktomakesurethedatapathbackendisactivated.
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34.
2. Fromthemenubar,selectConfiguration > Services.TheServicesscreen
displays.
3. SelecttheS3service,andselectAction > Show Details.
4. Ontheservicedetailscreen,ensurethestatusofData Path Backend Activated
isYes.Ifthedatapathisnotenabled,selectAction > Activate Data Path
Backend.
Checktomakesurethatnotapelibrariesareinstandbystate.
1. Fromthemenubar,selectConfiguration > Advanced Bucket Management.
TheAdvancedBucketManagementscreendisplays.
2. UnderTapePartitions,makesurealltapepartitionslistedshowaStateof
OnlineandaStandbystatusofNo.Ifanytapepartitionsareinstandbystate,
selectthetapepartition,andthenselectAction > Activate Tape Partition.
Checkforsystemmessagesthatindicatethepartitionisoutofspace.SeeA
systemmessageontheBlackPearlgatewayreportsNotapesavailablefora
storagedomainonpage 192.
ForGETjobs,dataretrievedintothecachewillremaininthecacheuntilthe
clienteithergetsthedataorthejobiscancelled.Eitheruseyourclientto
completetheGETjob,orcancelthejobasdescribedbelow.
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34.
2. Fromthemenubar,selectStatus > S3 Jobs.TheS3Jobsscreendisplays.
3. SelectthejobyouwanttocancelandselectAction > Cancel Job.

An email is sent
from the BlackPearl
gateway indicating
that the database is
full

Ifthedatabasereachesfullcapacity,theBlackPearlgatewayisnolongerusable.
Additionaldrivesmustbeinstalledtoaccommodatethedatabasesize.Contact
SpectraLogicTechnicalSupportforassistance(seeContactingSpectraLogicon
page 2).

July 2016

User GuideSpectra BlackPearl Gateway

195

Chapter 11 Troubleshooting and Support

Troubleshooting

Issue

Resolution

A system message
on the BlackPearl
gateway indicates
that the database is
not being backed
up

TheBlackPearlgatewayreportsafailuretobackupthedatabaseinthesystem
messages.Checkthesystemmessagestodeterminethecause.
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34.
2. IntheBlackPearluserinterface,selectStatus > Messages.TheMessages
screendisplays.Examinethelistofmessagesforadditionalinformation
aboutthefailure.
Ifthedatabasebackupscheduleisnotconfigured,theBlackPearlgateway
displaysthefollowingmessageonceperday:Thedatabaseisnotbeing
backedup.SelectadatapolicyfromtheDatabasebackupscreentoenable
backups.SeeDatabaseBackup&RestoreintheBlackPearlUserGuidefor
moreinformation.

The BlackPearl
gateway does not
display tapes with
duplicate barcodes
on the Tape
Management
screen

AlthoughaSpectratapelibraryallowsduplicatebarcodeswithinthesame
partition,theBlackPearlgatewaydoesnotallowduplicatebarcodes.Anytapes
withduplicatebarcodesarenotdisplayedontheTapeManagementscreenand
arenotusedbythegateway.
1. UseyourTapeLibraryUserGuidetoejecttapeswithduplicatebarcodes.
2. Applynew,nonduplicatebarcodestothetapesandreimportthemintothe
tapelibrary.
3. TheBlackPearlgatewayautomaticallyinspectsandusesthetapesasneeded.

The BlackPearl
Tape Management
screen shows
media in the
attached tape
library as Inspect
Failed

TheBlackPearlgatewayusestapesformattedwithLTFStostoredata.Only
LTO5andhighertapemediasupportsLTFS.Ifyourtapelibrarycontains
LTO4oroldermedia,oryouimportLTO4oroldermediaintoapartition
beingutilizedbyaBlackPearlgateway,theunsupportedpiecesofmedia
displayaTypeofInspectFailedontheTapeManagementscreen.Usethe
followingstepstoexportLTO4andoldermediafromyourtapelibrary.
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34.
2. IntheBlackPearluserinterface,selectStatus > Tape Management.TheTape
Managementscreendisplays.
3. ExaminetheTapeManagementscreenforanytapesthatdisplayaTypeof
InspectFailed.MakenoteofallbarcodesofInspectFailedtapes.
4. Selecttheaffectedtape,andthenselectAction > Eject Tape.TheEjectTape
dialogboxdisplays.
5. Ifdesired,enterinformationintheEjectLabelandEjectLocationfields.This
informationisstoredonthetapeandisvisiblewhenreimportingthetape
intoaBlackPearlgateway.Youarenotrequiredtoenterthisinformation.
6. ClickEject.ThetapeismarkedasejectedintheBlackPearlgatewaydatabase,
andmovedtotheEntry/Exitpoolintheattachedtapelibrary.
7. ExportthemediafromthetapelibraryasdescribedinyourTapeLibraryUser
Guide.

July 2016

User GuideSpectra BlackPearl Gateway

196

Chapter 11 Troubleshooting and Support

FAQ

Issue

Resolution

The BlackPearl
gateway displays a
system message
that a Job did not
complete in a 24
hour period

IftheBlackPearlgatewayexperiencesanetworkerrorwhentransferringdata,
thedatatransferfails.Networkerrorsoccurduetoavarietyofcircumstances.
Usetheinformationinthissectiontohelpyoutroubleshootanetworkerror.
Networkerrorsmayoccuriftheclientissaturatingthenetworkwith
information.Considerreducingthenumberofthreadstheclientusesto
transferdata.Forexample,a1GBconnectionshouldbesettoamaximumof3
threads.
Networkerrorsmayalsooccurduetoproblemswithcabling,networkswitch
issues,orSANissues.SeetheNetworkSetupTipsonpage 185for
troubleshootinginformation.Ifyoucannotresolvethenetworkissue,use
thestepsbelowtocollectlogsandopenaticketwithSpectraLogicTechnical
Support.
1. Intheclientsoftware,collectasetoflogs,ifavailable.
2. DownloadtheArchiveProviderlogsontoyourlocalhostcomputer.
3. LogintotheBlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34.
4. Fromthemenubar,selectSupport > Logs.TheLogsscreendisplays.
5. SelectAction > New Log Settogeneratealogsetforuseingeneral
troubleshooting.
6. Selectthelogsetyoujustgenerated,andthenselectAction > Download.The
logsetbeginsdownloadingtoyourhostcomputer.
7. SubmitasupportincidentusingtheSpectraLogicTechnicalSupportportal
asdescribedinOpeningaSupportTicketintheBlackPearlUserGuide.

The BlackPearl user


interface does not
appear to update
correctly

TheBlackPearlgatewaymayhaverebooted.Ifthegatewayreboots,allin
progressjobsareresumedorrestarted,buttheBlackPearluserinterfaceisnot
beingupdated.Logoutandthenlogbackintoreestablishaconnectionwith
thegateway.

FAQ
Thissectioncontainsanswerstofrequentlyaskedquestionsaboutthe
BlackPearlgatewayandSpectratapelibraries.

July 2016

WhydoesauserneedtobackuptheBlackPearldatabase?Howdoesa
userverifythedatabasebackupschedule?onpage 198

HowdoesausercreateaBucketIsolateddatapolicyforthedatabase
backuptapes?onpage 199

HowdoesauserconfiguretheirT50eorT120librarytosupport
ejectingtapesfromtheBlackPearlgateway?onpage 200

Howdoestheuserknowwhichtapesmustbetakenoffsiteand
broughtback?onpage 200

Whathappensiftheuserejectsthewrongtape?onpage 202

User GuideSpectra BlackPearl Gateway

197

Chapter 11 Troubleshooting and Support

FAQ

HowdoesauserusecleaningmediainaT50eorT120librarythatdoes
nothaveacleaningpartition?onpage 202

Howdousersknowtheircleaningmediaisexpired?onpage 203

Howdoesauserknowifthetapemediaisrunningoutofspace?on
page 204

Candatabeoverwrittenonexistingtapes?onpage 204

HowdoesausercancelawritefromtheBlackPearlcachetotape?
(cancelaninprogressjob)onpage 205

Howdoesauserknowifacomponentofthearchivesolutionhasan
error?onpage 205

Generally,howdoesauserupgradetolatergenerationsofmediainthe
samelibrary?onpage 206

Why does a user need to backup the BlackPearl database? How


does a user verify the database backup schedule?
TheBlackPearldatabaseiscontainedonasetofflash(SSD)driveswithin
BlackPearlgateway.Informationoneveryobjectstoredbythegatewayis
saved,includingobjectname,policy,physicallocation(includingwhich
tapeordisklocation),andotherinformationcriticalforsearchand
retrievalofobjects.Whileallofthisinformationcouldberetrievedby
allowingthegatewaytophysicallyloadandreadeverytape,thisisatime
consumingprocessandsomebucketlocationinformationmaybelost.If
thedatabaseislost,nodataislost,butretrievalbecomesdifficult.
Therefore,schedulingregularbackupsofthedatabaseisabestpracticeto
ensurelongtermreliableoperation.TheBlackPearluserinterfaceallows
theadministratortosetupregularandautomaticdatabasebackupsto
bothtapeanddisk,andalsoallowscreationofanoffsiteejectcopy.
Thedefaultdatabasebackupschedulegeneratesabackuponceperday,
andretainsamaximumoftwobackups.Todeterminethecurrentdatabase
backupschedule,dothefollowing:
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntothe
BlackPearlUserInterfaceonpage 34.

July 2016

User GuideSpectra BlackPearl Gateway

198

Chapter 11 Troubleshooting and Support

FAQ

2. FromtheBlackPearlmenubar,selectConfiguration > Database


Backup.TheDatabaseBackupscreendisplays.IntheBackupSchedule
pane,viewthecurrentschedule.IntheBackupspane,viewthedate
codeinthenameofthecompletebackupsavailabletoverifythemost
recentbackups.

Figure 137 The Database Backup screen.


Note: SeeDatabaseBackup&Restoreonpage 138formore
information.

How does a user create a Bucket Isolated data policy for the
database backup tapes?
Creatingabucketisolateddatapolicyforyourdatabasebackuptapes
ensuresthatonlythedatabasebackupbucketispresentonatape
cartridge.Thismakesoffsitearchivalofyourdatabasebackuptapes
easier.However,thedefaultdatapoliciescreatedbytheBlackPearl
gatewayarenotconfiguredforbucketisolationbydefault.Usethe
instructioninthissectiontocreateadatapolicywithbucketisolation.
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntothe
BlackPearlUserInterfaceonpage 34.

2. FollowtheinstructionsinCreateaStorageDomainonpage 67tocreate
anewstoragedomainforthedatabasebackups.
3. FollowtheinstructionsinCreateaDataPolicyonpage 71tocreatea
newdatapolicyforthedatabasebackups.Itishelpfultouseaname
similartoDataBaseBackup.MakesureyouselectBucket Isolation
whenassigningthestoragedomaincreatedinStep 2tothedatapolicy.
4. SelectConfiguration > Database Backup.TheDatabaseBackupscreen
displays.
5. SelectAction > Edit Data Policy.TheModifyDataPolicywindow
displays.
6. UsingtheData Policy to Usedropdownmenu,selectthedatapolicy
youcreatedinStep 3.

July 2016

User GuideSpectra BlackPearl Gateway

199

Chapter 11 Troubleshooting and Support

FAQ

How does a user configure their T50e or T120 library to support


ejecting tapes from the BlackPearl gateway?
TheBlackPearlejectfunctionallowsyoutoejecttapesfromtheBlackPearl
userinterface,whicharethenmovedtotheEntry/Exitportonthetape
library.
InordertousetheBlackPearlejectfunctiononaT50eorT120library,you
mustconfigureasinglepartitionandselectStandardasthepartitions
Entry/ExitPortMode.Ifyouconfigurethepartitiontouseeitherthe
SharedorQueuedEjectmode,oryouconfiguremorethanonepartitionon
yourlibrary,ejectsfromtheBlackPearlgatewayfail.
SeeConfiguringandManagingPartitionsintheT50eLibraryUserGuide,
orPartitionManagementintheT120LibraryUserGuideforinstructions
onconfiguringapartitiontousetheStandardmodefortheEntry/Exitport.
Note: T200,T380,T680,T950andTFinitylibrariesdonothave
limitationsonthepartitioncountorEntry/Exitmodefor
BlackPearltapeejection.

How does the user know which tapes must be taken off site and
brought back?
Atapeejectstrategymustbeconsideredaspartofadatapolicy.For
informationaboutthedefaultdatapoliciesandoptionsavailableto
customizedatapolicies,seeUnderstandingSpectraAdvancedBucket
ManagementConceptsonpage 43.Foradditionalinformationabout
ejectingandimportingtapes,seeEjectTapesonpage 108andImportTapes
onpage 111.
Spectrarecommendskeepingatleastonecopyofallarchiveddatainthe
libraryatalltimes.Librariescanbeeasilyupgradedbypurchasingmore
slotlicenses,or,iftheslotsbecomecompletelyfull,upgradingthelibrary
itselftoonewithmoreslotsusingtheexclusiveSpectraTranScale
technology.
Atapelibraryuseroradministratormaydecidetoejectmediacartridges
fromatapelibraryforanyofthereasonsdescribedbelow:

July 2016

Ejectingacopyforoffsitedisasterrecovery:TheBlackPearlgateway
allowsausertomakemultiplecopiesofdataautomatically.Atypical
usecaseistocreateatapefirstcopythatisintendedtobeleftinthe
libraryforeasyretrievalaswellasanejectcopyintendedtobe
removedfromthelibraryoncefullforarchivalatanalternatesitefor
safety.SeeseeUnderstandingSpectraAdvancedBucketManagement
Conceptsonpage 43forinformationonsettingupmultiplecopiesand
ejectingacopy,andtheTapeLibraryUserGuidefordetailsonthe
physicalprocessofexportingandimportingtapesintothelibrary.

User GuideSpectra BlackPearl Gateway

200

Chapter 11 Troubleshooting and Support

FAQ

Ejectingacopyofdatafortransfertoanotherlocation:Insome
workflows,auserejectsatapeoranentirebuckettotransferthedatato
anotherfacility.Individualtapesorentirebucketscanbeejected
manuallyusingtheBlackPearluserinterface(seeEjectTapeson
page 108).

Ejectingtapestofreeupspaceinthelibrary:Someworkflowsand
budgets,requireolderorunusedmediatobeejected,makingitnot
readilyavailable.Individualtapesorentirebucketscanbeejected
manuallyusingtheBlackPearluserinterface(seeEjectTapeson
page 108).
Note: Ifatapecartridgeisexportedfromthetapelibraryandajobis
queuedforthetape,theclientdisplaysanerror.Iftheclienterror
messagedoesnotdisplaythebarcodeofthetape,logintothe
BlackPearluserinterfaceasdescribedinLogIntotheBlackPearl
UserInterfaceonpage 34andselectStatus > Messages,orclick
theMessageslinkonthestatusbar,todisplaytheMessages
screen.Inspectthemessagestodeterminethebarcodeofthe
missingtape.SeetheTapeLibraryUserGuideforinstructionsfor
importingthetapeintothelibrary.

July 2016

User GuideSpectra BlackPearl Gateway

201

Chapter 11 Troubleshooting and Support

FAQ

What happens if the user ejects the wrong tape?


Ejecthasmultipledefinitionswithinthesystem:
FromtheBlackPearlgatewaysperspective,ejectmeansthatatapehas
beenmarkedasejectedintheBlackPearldatabaseandaninstructionhas
beengiventothetapelibrarytomovethetapeforejectionfromthelibrary.
Note: Youcannotejectatapethatiscurrentlyinuse.
Fromatapelibraryperspective,ejectindicatesthephysicalprocessof
exportingtapesfromthelibrary.
Note: Tapemediashouldnotbeexportedfromthetapelibrary
withoutfirstejectingthetapesintheBlackPearlwebinterface.
Ifyoususpectthatatapewasexportedfromthelibrarywithoutbeing
ejectedfromtheBlackPearlgateway,logintotheBlackPearluserinterface
asdescribedinLogIntotheBlackPearlUserInterfaceonpage 34andselect
Status > Tape Management.TheTapeManagementscreendisplays.Re
importthetapewiththestatusManagedNotInInventory.SeetheTape
LibraryUserGuideforinstructionsforimportingthetapeintothelibrary.
Oncethetapeisreimported,thegatewayinspectsthetapeandusesitas
needed.
Ifatapeisexportedfromthetapelibraryandisqueuedforajob,theclient
displaysanerror.Iftheclienterrormessagedoesnotdisplaythebarcode
ofthetape,logintotheBlackPearluserinterfaceasdescribedinLogInto
theBlackPearlUserInterfaceonpage 34andselectStatus > Messages,or
clicktheMessageslinkonthestatusbar,todisplaytheMessagesscreen.
Inspectthemessagestodeterminethebarcodeofthemissingtape.Seethe
TapeLibraryUserGuideforinstructionsforimportingthetapeintothe
library.Oncethetapeisreimported,thegatewayinspectsthetapeand
usesitasneeded.

How does a user use cleaning media in a T50e or T120 library


that does not have a cleaning partition?
InordertousetheBlackPearlejectfunctiononaT50eorT120library,the
librarycanonlyhaveasingledatapartition.Inorderfordrivestobe
automaticallycleaned,youmuststorecleaningmediainthesingledata
partitiononyourT50eorT120library.
WhentheBlackPearlgatewaydetectscleaningmediainthedatapartition,
thegatewayautomaticallycleansdriveswhencleaningisrequestedbya
tapedrive.

July 2016

User GuideSpectra BlackPearl Gateway

202

Chapter 11 Troubleshooting and Support

FAQ

How do users know their cleaning media is expired?


Cleaningmediaexpiresafteraspecifiednumberofusestoensurethat
drivesarethoroughlycleaned.TheBlackPearlgatewaydoesnottrack
cleaningmediahealth.Onlythetapelibrarytrackscleaningmediahealth.
Whenapieceofcleaningmediaexpires,amessageispostedtotheSystem
MessagesscreeninthetapelibrarysBlueScaleinterface.
IfyourcleaningmediaareLTOtapeswithMLMenabled,youcan
proactivelymonitorthestatusofcleaningmediathroughthetapelibrarys
BlueScaleinterface.
Note: IfyourcleaningtapesarenotMLMenabled,ortheyareTS11x0
media,youcannotuseMLMtoproactivelymonitorcleaning
media.YoumustusethemessagespostedtotheSystem
Messagesscreentodeterminewhenapieceofcleaningmedia
expires.
Usetheinstructionsinthissectiontodetermineifyourcleaningmediais
expiredorabouttoexpire.
T120 and larger libraries
1. LogintotheBlueScaleinterfaceasdescribedinyourTapeLibraryUser
Guide.
2. SelectGeneral > Media Lifecycle Management.TheMLMReportscreen
displays.
3. SelectthepartitionfromthePartitiondropdownlistandCleans
RemainingfromtheReportdropdownlist.
4. ClickGo.Thescreenredisplaystoshowthenumberofcleans
remainingforallcleaningcartridgespresentinthepartition.Confirm
atleastonetapestillhascleansremaining.
Note: Iftherearenocleaningtapeswithcleansremaining,seeyour
TapeLibraryUserGuideforinstructionsonexchangingexpired
cleaningmedia.
T50e library
1. LogintotheBlueScaleinterfaceasdescribedintheSpectraT50eLibrary
UserGuide.
2. ClickMENU,thenselectGeneral > MLM.TheMLMReportsscreen
displays.
3. SelectTotal LibraryfromthePartitiondropdownlistandCleans
RemainingfromtheReportdropdownlist.

July 2016

User GuideSpectra BlackPearl Gateway

203

Chapter 11 Troubleshooting and Support

FAQ

4. ClickGo.TheMLMReportsscreenrefreshestodisplaytheCleanings
Remainingreportwithalistofthebarcodelabelsforallcleaningtapes
intheselectedlocationandthenumberofcleaningsremainingforeach
tape.
Note: Iftherearenocleaningtapeswithcleansremaining,seeyour
TapeLibraryUserGuideforinstructionsonexchangingexpired
cleaningmedia.

How does a user know if the tape media is running out of


space?
Theavailablecapacityshouldbemonitoredperthedailyoperationand
maintenanceproceduresbyusingtheBlackPearldashboardtoensurethat
adequatemediaisavailableforBlackPearlgatewaytouseforplanned
archivejobs,ortomaintainaminimumavailablecapacitypercompany
policy.

Can data be overwritten on existing tapes?


Withafulladministratorloginandmultipleconfirmationscreens,anytape
canbemanuallydesignatedtobereformattedandputbackintotheblank
mediapoolforusebytheBlackPearlgateway.Oldertapeswithexpired
datawouldbehandledinthismannerforreuse.
UserswithadequatepermissionsforabucketcouldalsousetheBlackPearl
webinterface,aBlackPearlclient,oranS3browsertoolliketheSpectra
DeepStorageBrowsertodeleteobjectsfromabucket.Whenallobjectson
atapehavebeendeleted,thetapeisautomaticallyreclaimed.
Deletingobjectsorbucketsisamanualprocessandextremecaution
shouldbeexercisedtoensurethatonlydatathatisnolongerneededis
deleted.

July 2016

User GuideSpectra BlackPearl Gateway

204

Chapter 11 Troubleshooting and Support

FAQ

How does a user cancel a write from the BlackPearl cache to


tape? (cancel an in-progress job)
UsetheinstructionsinthissectiontocancelaSpectraS3job.
1. LogintotheBlackPearluserinterfaceasdescribedinLogIntothe
BlackPearlUserInterfaceonpage 34.
2. Fromthemenubar,selectStatus > S3 Jobs todisplaytheS3Jobs
screen.

Figure 138 The S3 Jobs screen.


3. SelectthejobtocancelandthenselectAction > Cancel.TheCancelJob
windowdisplays.

Figure 139 The Cancel Job screen.


4. ClickDeletetocancelthejobinprogress.

How does a user know if a component of the archive solution


has an error?
Duringinstallationofthearchivesolution,usersareconfiguredtoreceive
emailsiftheBlackPearlgatewayorthetapelibraryissuesawarningor
errormessage.SeeConfigureMailUsersinyourTapeLibraryUserGuide
andConfigureMailRecipientsonpage 161toverifyorsetupemail
recipients.
Usetheinformationinthemessageemails,andtheMessagesscreeninthe
BlackPearluserinterface,andthelibrarysBlueScaleuserinterface,along
withtheTroubleshootingsectionpage 12tocorrectanyissues.

July 2016

User GuideSpectra BlackPearl Gateway

205

Chapter 11 Troubleshooting and Support

Spectra Logic Technical Support

Generally, how does a user upgrade to later generations of


media in the same library?
Anewergenerationofmedia(forinstanceLTO7ifthelibrarywas
originallypurchasedwithLTO6drivesandmedia)isallowedtobeadded
toatapepartitionaslongasafewbasicrulesarefollowed:

TheBlackPearlgatewayrequiresthateachgenerationofdrivesneedsto
beinitsownseparatelibrarypartition.
Oldermediacanbeplacedinanewerdrivepartition(LTO6mediain
LTO7drivepartition)butonlyLTO6performanceisachieved.

SPECTRA LOGIC TECHNICAL SUPPORT


SpectraLogicTechnicalSupportprovidesaworldwideserviceand
maintenancestructure.

Before Contacting Support


IfyouhaveaproblemwithyourBlackPearlgateway,usetheinformation
inthissectiontoattempttoresolvetheproblem.
System Messages Ifyouareencounteringproblems,reviewanySystem
Messagesthatwereposted(seeCheckSystemMessagesonpage 124)and
takeanyactiondescribedinthemessage(s).
Product Support TheSpectraLogicTechnicalSupportportalat
support.spectralogic.comprovidesinformationaboutthemostcurrent
versionoftheBlackPearlsoftware,andadditionalserviceandsupport
tools.Afterloggingintothesupportportal,checktheoptionsunderthe
Support by Product andKnowledge Basetabsforadditionaltroubleshooting
information.
Contact Support Iftheproblempersists,openasupportticket(see
OpeningaSupportTicketonpage 207).

Determine Gateway Serial Number


BeforecontactingSpectraLogicTechnicalSupport,itisnecessaryto
determinetheserialnumberofthegateway.Usethefollowingstepsto
displaythegatewayserialnumber.
1. Fromthemenubar,selectSupport > Contact Information. TheContact
Informationscreendisplays.

July 2016

User GuideSpectra BlackPearl Gateway

206

Chapter 11 Troubleshooting and Support

Spectra Logic Technical Support

2. ThegatewayserialnumberislistedintheProductInformationpane.

Figure 140 The gateway serial number.

Opening a Support Ticket


YoucanopenasupportticketusingtheSpectraLogicTechnicalSupport
portalortelephone.
1. Makenotesabouttheproblem,includingwhathappenedjustbefore
theproblemoccurred.
2. Gatherthefollowinginformation:

Companyname,contactname,phonenumber,andemailaddress
Typeofhostsystembeingused
Typeandversionofhostoperatingsystembeingused
Typeandversionofhostfilestoragesoftwarebeingused

3. Submitasupportincident.

TousetheSpectraLogicTechnicalSupportportal:
a. LogintoyouraccountontheTechnicalSupportportalat
support.spectralogic.com.

Note: SeeCreateanAccountonpage 171ifyoudidnotpreviously


createdanaccountontheTechnicalSupportportal.

July 2016

User GuideSpectra BlackPearl Gateway

207

Chapter 11 Troubleshooting and Support

Spectra Logic Technical Support

b. SelectIncidents & Inventory > Open or View Incidents, oronthe


Homepage,clickOpen a Support Incident.

Figure 141 SelectIncidents & Inventory > Open or View Incidents to open a
support incident.

July 2016

User GuideSpectra BlackPearl Gateway

208

Chapter 11 Troubleshooting and Support

Spectra Logic Technical Support

c. OntheOpenorViewIncidentspage,youaregivenan
opportunitytosearchforexistingsupportcontentthatmayhelp
yousolveyourproblemimmediately.Ifthesearchdoesnot
provideananswer,clickOpen a New Incident.

Figure 142 Click Open a New Incident.

July 2016

User GuideSpectra BlackPearl Gateway

209

Chapter 11 Troubleshooting and Support

Spectra Logic Technical Support

d. OntheCreateIncidentpage,entertherequestedinformation
providingasmuchdetailaspossible.Whenyouarefinished,
clickCreate Incident.

Figure 143 The Create Incident page.

July 2016

Ifitiswithinthehoursofcoverageprovidedbyyoursupport
contract,contactSpectraLogicTechnicalSupportbytelephone.See
ContactingSpectraLogiconpage 4.

User GuideSpectra BlackPearl Gateway

210

Chapter 11 Troubleshooting and Support

Spectra Logic Technical Support

Enabling Remote Support


RemoteSupportisanoptionthatallowsSpectraLogicTechnicalSupport
personneltoaccesstherootconsoleofthesystem.Thisoptionisfor
troubleshootingpurposesonly.
1. EntertheRemoteSupportactivationkeyasdescribedinDatabase
Backup&Restoreonpage 138.
2. Fromthemenubar,selectConfiguration > Users.TheUsersscreen
displaysalistofallconfiguredusers.
3. DoubleclicktheSpectraaccountinthePrimaryAdministratorspane,
orselecttheSpectraaccount,andthenselectAction > Edit.TheEdit
Userdialogboxappears.

Figure 144 The Edit User dialog box.


4. SelecttheEnable Remote Supportcheckbox.
Note: TheEnableRemoteSupportcheckboxdoesnotdisplayuntil
youenteraRemoteSupportactivationkey.SeeDatabaseBackup
&Restoreonpage 138formoreinformation.
5. ClickSave.

Important

July 2016

After Spectra Logic Technical Support informs you that they no longer require root
access to the gateway, you should disable Remote Support to prevent any potential
unauthorized access. See Disabling Remote Support on page 212 for more
information.

User GuideSpectra BlackPearl Gateway

211

Chapter 11 Troubleshooting and Support

Spectra Logic Technical Support

Disabling Remote Support


UsetheinstructioninthissectiontodisableRemoteSupport.
1. Fromthemenubar,selectConfiguration > Users.TheUsersscreen
displaysalistofallusersconfiguredonthegateway.
2. DoubleclicktheSpectraaccountinthePrimaryAdministratorspane,
orselecttheSpectraaccount,andthenselectAction > Edit.TheEdit
Userdialogboxappears.

Figure 145 The Edit User dialog box.


3. CleartheEnable Remote Supportcheckbox.
4. ClickSave.

July 2016

User GuideSpectra BlackPearl Gateway

212

APPENDIX A
Specifications
ThisappendixprovidesdetailedspecificationsfortheSpectraBlackPearl
DeepStorageGateways.Thespecificationslistedherepertaintothe
currentlyshippingBlackPearlchassis.
Note: ForspecificationsthatdifferfortheBlackPearl1.0chassis,see
Appendix B BlackPearl1.0ChassisOverview&Specifications
onpagepage 222.
Specification
DataStorageSpecifications

page 214

DriveSpecifications

page 214

GatewaySpecifications

page 215

SystemSpecification

page 215

SizeandWeight

page 216

EnvironmentalSpecifications

page 217

PowerRequirements

page 218

InputPowerRequirements

page 218

PowerCords

page 219

InterfaceSpecifications

page 220

InterfaceConnectors

page 220

NetworkInterfaceCables

page 220

UniversalSerialBus(USB)Support

page 221

Note: Allspecificationsinthischapteraresubjecttochangewithout
notice.

213

Appendix A Specifications

Data Storage Specifications

DATA STORAGE SPECIFICATIONS


Thefollowingtableshowsthedatastoragespecificationsforthe
BlackPearlgateways.

Drive Specifications
BlackPearl 4U gateway
Parameter

Specification

Drivetype

SolidStateSATA

Singledrivecapacity,native

400GB

Parameter

Specification a

Drivetype

SpinningDiskSAS

Singledrivecapacity,native

4TB

a. 1 TB is defined as 1,000,000,000,000 bytes.

BlackPearl 2U gateway
Parameter

Specification a

Drivetype

SpinningDiskSAS

Singledrivecapacity,native

4TB

a. 1 TB is defined as 1,000,000,000,000 bytes.

BlackPearl expansion node


Parameter

Specification a

Drivetype

SpinningDiskSAS

Singledrivecapacity,native

4TB

a. 1 TB is defined as 1,000,000,000,000 bytes.

ArcticBlue expansion node


Parameter

Specification a

Drivetype

SpinningDiskSATA

Singledrivecapacity,native

4TB

a. 1 TB is defined as 1,000,000,000,000 bytes.

July 2016

User GuideSpectra BlackPearl Gateway

214

Appendix A Specifications

System Specification

Gateway Specifications
Parameter

Specification a

BlackPearl4UGatewaycapacity

52TB

BlackPearl2UGatewaycapacity

26TB

RAIDlevel

DoubleParity

a. 1 TB is defined as 1,000,000,000,000 bytes.

SYSTEM SPECIFICATION
Thefollowingtableprovidesanoverviewofthesystemdevicesinstalledin
theBlackPearlgateways.
Note: ForSystemSpecificationfortheBlackPearl1.0chassis,see
Appendix B BlackPearl1.0ChassisOverview&Specifications
onpagepage 222.

BlackPearl 2U Gateway
Parameter

Specifications

CPU

Onemulticoreprocessors

Systemdiskdrives

Two250GBSATAdiskdrives

Memory

64GB(4x16GBDIMMs)

Interfaceconnections

Twointegrated10GBaseTEthernetportsa
Onedualport10 GigabitEthernetNIC
(Optional)fourportSAScard
(Optional)twoportSAScard
(Optional)twoportFibreChannelcard

a. 10GBase-T ports can negotiate down to 10/100/1000Base-T speeds.

July 2016

User GuideSpectra BlackPearl Gateway

215

Appendix A Specifications

Size and Weight

BlackPearl 4U Gateway
Parameter

Specifications

CPU

Twomulticoreprocessors

Systemdiskdrives

Two250GBSATAdiskdrives

Memory

128GB(8x16GBDIMMs)

Interfaceconnections

Twointegrated10GBaseTEthernetportsa
Onedualport10 GigabitEthernetNIC
(Optional)fourportSAScard
(Optional)twoportSAScard
(Optional)twoportFibreChannelcard

a. 10GBase-T ports can negotiate down to 10/100/1000Base-T speeds.

SIZE AND WEIGHT


Thefollowingtablesprovidethesizeandweightofeachchassis.
Specificationsareprovidedforeachunitinbothanoperational
environment,andintheshippingcontainer.

BlackPearl 2U Gateway
Parameter

BlackPearl 2U gateway

Shipping Container a

Dimensions
Height(2U)
Width
Depth

3.5in.(8.9cm)
19in.(48.3cm)
27.5in.(69.9cm)b

13.25in.(33.7cm)
26in.(66.0cm)
34.25in.(87.0cm)

Weightc
Emptychassis
Tendrives

39.0lb(17.7kg)
55.9lb(25.4kg)

N/A
76.9lb(34.9kg)

a. Includes chassis, drives, box, and packaging.


b. Includes the front bezel.
c. Weights are approximate.

July 2016

User GuideSpectra BlackPearl Gateway

216

Appendix A Specifications

Environmental Specifications

BlackPearl 4U Gateway
Parameter

BlackPearl 4U gateways

Shipping Container a

Dimensions
Height(4U)
Width
Depth

7in.(17.8cm)
19in.(48.3cm)
29.5in.(74.9cm)b

17.5in.(44.5cm)
27in.(68.6cm)
39in.(99.0cm)

57lb(25.9kg)
76.6lb(34.7kg)

N/A
110.9lb(50.3kg)

97.8lb(44.4kg)

N/Af

Weightc
Emptychassis
Chassisandtwelve
drivesd
Chassisandtwenty
sixdrivese
a.
b.
c.
d.
e.
f.

Includes chassis, drives, box, and packaging.


Includes the front bezel.
Weights are approximate.
Drive configuration is two solid-state drives and ten spinning-disk drives.
Drive configuration is six solid-state drives and twenty spinning-disk drives.
The base gateway ships with two solid-state drives and ten spinning-disk drives. Additional drives are
shipped separately.

ENVIRONMENTAL SPECIFICATIONS
Parameter

Operating Environment a

Storing and Shipping


(Non-Operating)
Environment b

Humidity

8%to90%
(noncondensing)

5%to95%
(noncondensing)

Temperature

50Fto95F
(10Cto35C)

40Fto158F
(40Cto70C)

Altitude

Sealevelto10,000feet
(3,048 meters)

Sealevelto39,370feet
(12,000meters)

Maximum wet
bulb temperature

84F(29C)

95F(35C)

a. When the BlackPearl gateway is moved from a cold storage environment to a warm operating
environment, it must be acclimated in its packaging for at least 12 hours before opening to prevent
serious condensation damage from occurring.
b. The BlackPearl gateway is in its original packaging. The packaging is designed to protect the BlackPearl
gateway from condensation caused by extreme temperature variations (27 F per hour or 15 C per hour,
or more).

July 2016

User GuideSpectra BlackPearl Gateway

217

Appendix A Specifications

Power Requirements

POWER REQUIREMENTS
ThissectiondescribesthepowerspecificationsfortheBlackPearlgateways.

Input Power Requirements


Thefollowingtablesprovidetheinputpowerrequirementsforeachgateway.

BlackPearl 2U gateway
Parameter

Requirements

InputVoltage

100240VAC,114.5A,920wattsmaximum

InputFrequency

5060Hz

Current

4A

BlackPearl 4U gateway

July 2016

Parameter

Requirements

InputVoltage

100140VAC,128A,1000wattsmaximum
180240VAC,86A,1280wattsmaximum

InputFrequency

5060Hz

Current

4.2A

User GuideSpectra BlackPearl Gateway

218

Appendix A Specifications

Power Requirements

Power Cords
ThepowercordsincludedwiththeBlackPearlgatewaysareconsidered
partoftheunitandarenotintendedforusedwithanyotherequipment.
CablesprovidedbySpectraLogicare6.5ft(2m)inlength.Ifyouneedto
usealongercord,makesureitconformstothespecificationslistedbelow.
Powercordsmustcomplywithlocalelectricalcodes.
North American 120 Volt-AC Power Cord. Thecriteriafora120voltpower
cordforuseintheUnitedStatesandCanadaareasfollows:
Parameter

Specification

Powercordage

Threeconductor,14AWG

Powerinputconnectors

Male:NEMA515PorIEC60320C14
Female:IEC60320C13

OR

NEMA 5-15P
male connector

IEC 60320 C14


male connector

IEC 60320 C13


female connector

North American 220 Volt-AC Power Cord. Thecriteriafora220voltpower


cordforuseintheUnitedStatesandCanadaareasfollows:
Parameter

Specification

Powercordage

SJTtype,threeconductor,14AWGminimum

Powerinputconnectors

Male:Connectormustbeofthepropertype,
rating,andsafetyapproval.
Female:IEC60320C13

International 220 Volt-AC Power Cord. Thecriteriaforaninternational


220voltACpowercordareasfollows:

July 2016

Parameter

Specification

Powercordage

Flexible,HAR(harmonized)typeH05VVF,three
conductor,cordwithminimumconductorsizeof
1.7squaremillimeters(0.0026350squareinches).

Powerinputconnectors

Male:Connectormustbeofthepropertype,
rating,andsafetyapprovalfortheintended
country.
Female:IEC60320C13

User GuideSpectra BlackPearl Gateway

219

Appendix A Specifications

Interface Specifications

INTERFACE SPECIFICATIONS
Thissectionprovidesinformationabouttheinterfacesusedtoconnecta
BlackPearlgatewaytothehostsystems.
Note: ForInterfaceSpecificationsfortheBlackPearl1.0chassis,see
Appendix B BlackPearl1.0ChassisOverview&Specifications
onpagepage 222.

Interface Connectors
Interface Type

Number of Ports and Connector Type

Ethernet(10GBaseT)

TwoRJ45sockets

Ethernet(10GigE)

TwoSFP+opticalmoduleswithaduplexLC
connector

SAS

FourSFF8644socketsperoptionalSAScardfor
connectiontoaBlackPearlexpansionnode.

SAS

TwoSFF8644socketsperoptionalSAScardto
connecttoanArcticBlueexpansionnode.

FibreChannel

TwoSFP+opticalmoduleswithLCconnectorsper
optionalFibreChannelcard

Network Interface Cables


ThetypeofcablesrequiredtoconnecttheBlackPearlgatewaytothe
networkdependonthetypeofinterfacebeingused.

July 2016

Interface Type

Cable Requirements

Ethernet(10GBaseT
or10/100/1000BaseT)

10GBaseTShieldedCategory6Adatagradecable
withaRJ45connector.
10/100/1000BaseTShieldedCategory 5datagrade
cablewithaRJ45connector

Ethernet(10GigE)

MultimodeopticalcablewithduplexLCconnectors

SAS

BlackPearlexpansionnode:6Gbps4lanecablewith
SFF8644andSFF8088connectors
ArcticBlueexpansionnode:12GbpscablewithSFF
8644connectors

FibreChannel

50micron400M5SNIclassification

User GuideSpectra BlackPearl Gateway

220

Appendix A Specifications

Interface Specifications

Universal Serial Bus (USB) Support


SpectraLogicsupportsusingtheUSBportsonthegatewayforthe
following:

USBmassstoragedevices(forexample,flashdrives)
Keyboards&pointerdevices(forexample,acomputermouse)
CDorDVDdriveswithUSBinterface

SpectraLogicdoesnotsupportusingtheUSBportsforthefollowing:

July 2016

Cameras
Multimediadevices(forexample,MP3players)

User GuideSpectra BlackPearl Gateway

221

APPENDIX B
BlackPearl 1.0 Chassis
Overview & Specifications
ThischapterprovidesanoverviewandspecificationsfortheSpectraLogic
BlackPearlDeepStorageGateway1.0chassis.
Topic
Components

page 223

FrontView

page 223

RearView

page 224

RearPanel

page 225

Specifications

page 226

SystemSpecification

page 226

InterfaceSpecifications

page 227

222

Appendix B BlackPearl 1.0 Chassis Overview & Specifications

Components

COMPONENTS
Thefollowingsectionsshowthelocationsofandbrieflydescribethe
BlackPearl1.0chassismajorfrontandrearpanelcomponents.

Front View
Figure 146andFigure 147showthecomponentsonthefrontofthe
BlackPearlgatewayswiththefrontbezelremoved.
Visual Status Beacon
control sled

Power button and


system status LEDs

Latch

Data drive status LEDs


Visual Status Beacon
control sled

Data drives

Figure 146 The front view of the BlackPearl 4U


gateway.

Power button and


system status LEDs

Latch

Data drive status LEDs

Data drives

Figure 147 The front view of the BlackPearl 2U


gateway.

Component

Description

Front bezel
(not shown)

Thefrontbezelmountsonthefrontofthechassis,andcontainstheVisual
StatusBeaconlightbar,whichprovidesstatusinformationforthesystem.See
FrontBezelVisualStatusBeacononpage 121formoreinformation.

Visual Status
Beacon control sled

Thedrivesledintheupperleftcornerofthefrontofthechassisprovidescontrolfor
theVisualStatusBeacon.Adiskdrivecannotbeinstalledinthisposition.

Power button

ThepowerbuttoncontrolsthemainACpowerfortheBlackPearlgateway.

System status LEDs

ThestatusLEDsindicatepowerstatus,diskandnetworkactivity,aswellas
hardwarefaults.SeeSystemStatusLEDsonpage 123formoreinformation.

Data drives

ThebaseBlackPearl4Ugatewayincludesonehighperformancesolidstatedrive,
andfivespinningdiskdrivesmountedonindividualdrivesledsinthefrontofthe
chassis.Additionaldrivesareinstalledintherearofthechassis.TheBlackPearl2U
gatewayincludestenspinningdiskdrivesinthefrontofthechassis.
ThedrivesledsslideintobaysinBlackPearlenclosureandlockinplace.The
frontofeachdrivesledhasahandleforremovingthesledfromthechassisand
alatchforlockingthedrivesledinplace.

Data drive status


LEDs

TwoLEDsoneachdrivesledindicatethestatusofthedrive.OneLEDisfor
drivestatuswhiletheothershowsdriveactivity.

Empty drive sleds

Emptydrivesledsareinstalledintheunuseddrivebaystoprevent
contaminantsfromenteringtheenclosureandtomaintainproperairflow.

July 2016

User GuideSpectra BlackPearl Gateway

223

Appendix B BlackPearl 1.0 Chassis Overview & Specifications

Components

Rear View
Figure 148andFigure 149showthemajorcomponentsontherearofthe
BlackPearlgateway.
Rear panel

Power supplies

Power supplies

Rear panel

Boot drives

Data drives

Figure 148 The rear view of the BlackPearl 4U


gateway.

Figure 149 The rear view of the BlackPearl 2U


gateway.

Component

Description

Power supplies

ThestandardBlackPearlgatewayconfigurationincludestwopowersuppliesto
provideN+1redundancyandfailoverprotection.
EachpowersupplyhasitsownACpowerconnector.
EachpowersupplyhasasingleLEDthatlightstoindicatewhenthepoweris
onandfunctioningnormally.

Rear panel

TherearpaneloftheBlackPearlgatewayallowsforEthernet,FibreChannel,
SAS,USB,andotherconnections.SeeRearPanelonpage 225foradetailed
description.

Boot drives

ThebootdrivesprovidestoragefortheoperatingsystemandBlackPearluser
interface.ThebootdrivesfortheBlackPearl2Ugatewayarehotswappable
whichallowsforuninterruptedoperationduringreplacement.
Note: ThebootdrivesfortheBlackPearl4Ugatewayarelocatedinsidethe
chassisandarenotaccessiblefromtheoutside.

Data drives
(BlackPearl 4U
gateway only)

ThebaseBlackPearl4Ugatewayincludesonehighperformancesolidstate
drive,andfivespinningdiskdrivesmountedonindividualdrivesledsinthe
rearofthechassis.Additionaldrivesareinstalledinthefrontofthechassis.
ThedrivesledsslideintobaysintheBlackPearlenclosureandlockinplace.
Thefrontofeachdrivesledhasahandleforremovingthesledfromthechassis
andalatchforlockingthedrivesledinplace.
Note: TheBlackPearl2Ugatewaydoesnothavedatadrivesintherearofthe
chassis.

Empty drive sleds


(BlackPearl 4U
gateway only)

Emptydrivesledsareinstalledintheunuseddrivebaystoprevent
contaminantsfromenteringtheenclosureandtomaintainproperairflow.

July 2016

User GuideSpectra BlackPearl Gateway

224

Appendix B BlackPearl 1.0 Chassis Overview & Specifications

Components

Rear Panel
Figure 150showsthecomponentsontherearpaneloftheBlackPearl4U
and2Ugateways.
IPMI management port

Serial
port

Gigabit
Ethernet ports (4)

USB
ports (4)

Monitor 10 GigE ports (2)


connector
Optional SAS ports (4)

BlackPearl
management port

Expansion
slots

Figure 150 The BlackPearl rear panel components.


Component

Description

IPMI management
port

Notcurrentlysupported.

Gigabit Ethernet
ports (GigE)

TheBlackPearlgatewayincludesfourGigEports.ThreeoftheGigEportscan
beusedfornetworkconnectivityonaGigEnetwork.Thebottomleftportofthe
fourGigEportsisdedicatedastheBlackPearlmanagementportandcannotbe
usedfordatatransfer.
Note: SpectraLogicrecommendsusingthe10GigEportsfordatatransferto
ensuremaximumperformance.

Monitor connector

Ifnecessary,youcanconnectamonitortotheSVGAconnectoronthe
BlackPearlgatewayfortroubleshootingpurposes.Onlyconnectamonitorfor
initialconfigurationoftheBlackPearlmanagementport,orasdirectedby
SpectraLogicTechnicalSupport.

10 GigE ports

Thetwo10GigabitEthernet(10 GigE)portscanbeusedfornetwork
connectivityona10GigEnetwork.
Note: SpectraLogicrecommendsusingthe10GigEportsfordatatransferto
ensuremaximumperformance.

SAS ports
(optional)

Dependingonyourconfiguration,theremaybeaSAScardinstalledinan
availableexpansionslot.TheSAScardprovidesconnectivitytoSASdrivesina
SpectraLogictapelibrary.

Fibre Channel ports


(optional,
not shown)

Dependingonyourconfiguration,theremaybeaFibreChannelcardinstalled
inanavailableexpansionslot.TheFibreChannelcardprovidesconnectivityto
FibreChanneldrivesinaSpectraLogictapelibrary.

July 2016

User GuideSpectra BlackPearl Gateway

225

Appendix B BlackPearl 1.0 Chassis Overview & Specifications

Specifications

Component

Description

Expansion slots

Theexpansionslotsaccommodateoptionalinterfacecardstoprovideadditional
connectivity.Aninstalled10GigabitEthernetnetworkinterfacecardprovides
highspeeddataconnectionbetweenhostsandtheBlackPearlgateway.An
optionalSASorFibreChannelcardprovidesconnectivitybetweenthe
BlackPearlgatewayandtapedrivesinaSpectraLogictapelibrary.

BlackPearl
management port

TheBlackPearlmanagementportisusedtoconnecttoabrowserbaseduser
interfacetoconfigure,manage,andmonitortheBlackPearlgateway.The
BlackPearlmanagementportcannotbeusedfordatatransfer.

USB ports

Ifnecessary,youcanusetheseportstoconnectaUSBdrive,orUSBkeyboardto
thechassisfortroubleshootingpurposes.OnlyconnectaUSBdriveor
keyboardasdirectedbySpectraLogicTechnicalSupport.

Serial port

Notcurrentlyused.

SPECIFICATIONS
ThefollowingsectionsdescribethespecificationsoftheBlackPearl1.0
chassis,wheretheydifferfromthecurrentchassis.See
Appendix A Specificationsonpage 213forspecificationinformationnot
listedhere.

System Specification
Thefollowingtableprovidesanoverviewofthesystemdevicesinstalledin
theBlackPearlgateways.

BlackPearl 2U Gateway

July 2016

Parameter

Specifications

CPU

Onemulticoreprocessors

Systemdiskdrives

Two250GBSATAdiskdrives

Memory

64GB(4x16GBDIMMs)

Interfaceconnections

FourintegratedGigabitEthernetports
Onedualport10 GigabitEthernetNIC
(Optional)fourportSAScard
(Optional)twoportFibreChannelcard

User GuideSpectra BlackPearl Gateway

226

Appendix B BlackPearl 1.0 Chassis Overview & Specifications

Specifications

BlackPearl 4U Gateway
Parameter

Specifications

CPU

Twomulticoreprocessors

Systemdiskdrives

Two250GBSATAdiskdrives

Memory

128GB(8x16GBDIMMs)

Interfaceconnections

FourintegratedGigabitEthernetports
Onedualport10 GigabitEthernetNIC
(Optional)fourportSAScard
(Optional)twoportFibreChannelcard

Interface Specifications
Thissectionprovidesinformationabouttheinterfacesusedtoconnecta
BlackPearlgatewaywithaBlackPearl1.0chassis,tothehostsystems.

Interface Connectors
Interface Type

Number of Ports and Connector Type

Ethernet(GigE)

FourRJ45sockets

Ethernet(10GigE)

TwoSFP+opticalmoduleswithaduplexLCconnector

SAS

FourSFF8644socketsperoptionalSAScard

FibreChannel

TwoSFP+opticalmoduleswithLCconnectorsper
optionalFibreChannelcard

Network Interface Cables


ThetypeofcablesrequiredtoconnecttheBlackPearlgatewaytothe
networkdependonthetypeofinterfacebeingused.

July 2016

Interface Type

Cable Requirements

Ethernet(GigE)

ShieldedCategory 5(10/100BaseTconnection)
datagradecablewithaRJ45connector

Ethernet(10GigE)

MultimodeopticalcablewithduplexLCconnectors

SAS

6Gbps4lanecablewithSFF8644andSFF8088
connectors

FibreChannel

50micron400M5SNIclassification

User GuideSpectra BlackPearl Gateway

227

APPENDIX C
Regulatory & Safety Standards
TheSpectraBlackPearlDeepStorageGatewaycomplieswiththesafety
andregulatoryagencystandardslistedbelowwheninstalledbyaSpectra
Logiccertifiedengineerorthirdpartyprovider.

EU DECLARATION OF CONFORMITY
We:
SpectraLogicCorporation
6101LookoutRoad
Boulder,CO80301USA
declareundersoleresponsibilitythatthe
SpectraBlackPearlDeepStorageGateway
towhichthisdeclarationrelates,meetstheessentialhealthandsafety
requirementsandisinconformitywiththeEUDirectiveslistedbelow
usingtherelevantsectionoftheEUstandardsandothernormative
documentslistedinthefollowingtable.

MattStarr
ChiefTechnicalOfficer,SpectraLogicCorporations
Directive

Compliance

EUEMCDirective
89/336/EEC

Essentialhealthandsafetyrequirementsrelatingtoelectromagnetic
compatibility.

EN55022
(CISPER22)ClassA

Limitsandmethodsofmeasurementsofradiointerferencecharacteristicsof
informationtechnologyequipment.

EN55024

1998,InformationTechnologyEquipmentImmunityCharacteristicsLimits
andMethodsofMeasurement.

EN6100042

1995+A1:1998+A2:2001,ElectrostaticDischarge

EN6100043

1995+A1:1998+A2:2001,ENV50204:1995,RadiatedRFImmunity

228

Appendix C Regulatory & Safety Standards

EU Declaration of Conformity

Directive

Compliance

EN6100044

1995+A1:2001,ElectricalFastTransient/Burst

EN6100045

1995+A1:2001+A2:2001,SurgeImmunity

EN6100046

1996+A1:2001+A2:2001,ConductedRFImmunity

EN6100048

1994+A1:2001,PowerFrequencyHfieldImmunity

EN61000411

1994+A1:2001,VoltageDipsandInterrupts

EN6100032

2000,PowerLineHarmonics

EN6100033

1995,PowerLineFlicker

ECLowVoltage
Directive72/336/EEC

Essentialhealthandsafetyrequirementsrelatingtoelectricalequipment
designedforusewithcertainviolatelimits.

EN609501
(EN609501)

Safetyrequirementsofinformationtechnologyequipmentincluding
electricalmachines.

Certifications
Country

Certification

Covers

Canada

UL

BlackPearlgateway

China

CCC

Powersupplyonly

EU

CE

BlackPearlgateway

Taiwan

BSMI

Powersupplyonly

USA

UL,FCC

BlackPearlgateway

Japan

VCCI

BlackPearlgateway

TheBlackPearlgatewaycomplieswithallsafetyrelevantprovisionsreferring
to:

Protectionagainstelectricalhazards
Protectionagainsthazardssuchas:
Mechanicalhazards
Firehazards
Noise
Vibration
Thesafetyissuesofthisinformationtechnologyequipmenttypehavebeen
evaluatedbyagovernmentaccreditedEuropeanthirdpartyorganization,
suchasNemko.

July 2016

User GuideSpectra BlackPearl Gateway

229

Appendix C Regulatory & Safety Standards

CE Marking

CE MARKING
TheCEmarkingisaffixedonthisdeviceaccordingtoArticle10oftheEU
Directive90/336/EEC.
Note: TomeetCEcertificationrequirements,youmustberunningthe
BlackPearlgatewayonuninterruptablepowersupplies.

FCC NOTICE
Thisequipmenthasbeentestedandfoundtocomplywiththelimitsfora
ClassAdigitaldevice,pursuanttoCFR47Part15oftheFCCRules.These
limitsaredesignedtoprovidereasonableprotectionagainstharmful
interferencewhentheequipmentisoperatedinacommercial
environment.Thisequipmentgenerates,uses,andcanradiateradio
frequencyenergy,and,ifnotinstalledandusedinaccordancewiththe
instructionguide,maycauseharmfulinterferencetoradio
communications.Operationofthisequipmentinaresidentialareaislikely
tocauseharmfulinterference,inwhichcasetheuserisrequiredtocorrect
theinterferenceattheusersownexpense.

SAFETY STANDARDS AND COMPLIANCE


TheSpectraBlackPearlgatewaycomplieswiththefollowingdomesticand
internationalproductsafetystandards.

EN609501SecondEdition
UL609501SecondEdition
CSAC22.2No.60950103
LowVoltageDirective(EU:CEMark)

Waste of Electronic and Electrical Equipment (WEEE) Directive


Thefollowingsymbolonthebackofthisproduct
indicatesthatthisproductmeetstheEuropeanDirective
2000/96/EConWasteElectricalandElectronicEquipment
knownastheWEEEdirective.Thisdirective,only
applicableinEuropeanUnioncountries,indicatesthatthis
productshouldnotbedisposedofwithnormalunsorted
municipalwaste.

July 2016

User GuideSpectra BlackPearl Gateway

230

Appendix C Regulatory & Safety Standards

Conflict Minerals Policy

WithinparticipatingEuropeanUnioncountries,specialcollection,
recycling,anddisposalarrangementhavebeenestablishedforthis
product.Attheendoflife,theproductusershoulddisposeofthisproduct
usingspecialWEEEcollectionsystems.Thesespecialsystemsmitigatethe
potentialaffectsontheenvironmentandhumanhealththatcanresult
fromhazardoussubstancesthatmaybecontainedinthisproduct.
EuropeanUnionusersshouldcontacttheirlocalwasteadministrationfor
WEEEcollectioninstructionsforthisproduct.

Restriction of Hazardous Substances in Electrical and Electronic


Equipment (RoHS)
TheRoHSmarkingindicatesthatthisproductisin
compliancewithEuropeanCouncilDirective2011/65/2008,
ontherestrictionoftheuseofcertainhazardoussubstances
inelectricalandelectronicequipment.

CONFLICT MINERALS POLICY


SpectraLogiciscommittedtocomplyingwiththeOECDDueDiligence
GuidanceforResponsibleSupplyChainsofMineralsfromConflict
AffectedandHighRiskAreas,aswellastheapplicablerequirementsof
Section1502oftheDoddFrankAct,whichaimstopreventtheuseof
mineralsthatdirectlyorindirectlyfinanceorbenefitarmedgroupsinthe
DemocraticRepublicoftheCongo(DRC)orinadjoiningcountries
(conflictminerals).
AffectedsupplierstoSpectraLogicwillberequiredtocommittobeingor
becomingconflictfree(whichmeansthatsuchsupplierdoesnotsource
conflictminerals)andsourcing,wherepossible,onlyfromconflictfree
smelters.EachaffectedsuppliertoSpectraLogicwillberequiredto
providecompletedEICCGeSIdeclarationsevidencingsuchsuppliers
commitmenttobecomingconflictfreeanddocumentingcountriesof
originforthetin,tantalum,tungsten,andgoldthatitpurchases.
FormoreinformationonSpectraLogicsconflictmineralsprogramcontact
conflictminerals@spectralogic.com.

July 2016

User GuideSpectra BlackPearl Gateway

231

APPENDIX D
Open Source Code
Acknowledgements & Package List
Copyright20102015SpectraLogicCorporation.Allrightsreserved.
Thisappendixcontainsthelicensesandnoticesforopensourcesoftware
usedintheBlackPearlproduct.Ifyouhaveanyquestionsorwantto
receiveacopyofthefree/opensourcesoftwaretowhichyouareentitled
undertheapplicablefree/opensourcelicense(s)(suchastheCommon
DevelopmentandDistributionLicense(CCDL)),contactSpectraLogic
TechnicalSupport(seeContactingSpectraLogiconpage 4).

APACHE
LicensedundertheApacheLicense,Version2.0(theLicense);youmay
notusethisfileexceptincompliancewiththeLicense.
YoumayobtainacopyoftheLicenseat:
http://www.apache.org/licenses/LICENSE2.0
Unlessrequiredbyapplicablelaworagreedtoinwriting,software
distributedundertheLicenseisdistributedonanASISBASIS,
WITHOUTWARRANTIESORCONDITIONSOFANYKIND,either
expressorimplied.SeetheLicenseforthespecificlanguagegoverning
permissionsandlimitationsundertheLicense.

FREEBSD
Copyright19922015TheFreeBSDProject.Allrightsreserved.
Redistributionanduseinsourceandbinaryforms,withorwithout
modification,arepermittedprovidedthatthefollowingconditionsare
met:
1. Redistributionsofsourcecodemustretaintheabovecopyrightnotice,
thislistofconditionsandthefollowingdisclaimer.

232

Appendix D Open Source Code Acknowledgements & Package List

Java

2. Redistributionsinbinaryformmustreproducetheabovecopyright
notice,thislistofconditionsandthefollowingdisclaimerinthe
documentationand/orothermaterialsprovidedwiththedistribution.
THISSOFTWAREISPROVIDEDBYTHEFREEBSDPROJECT``ASIS
ANDANYEXPRESSORIMPLIEDWARRANTIES,INCLUDING,BUT
NOTLIMITEDTO,THEIMPLIEDWARRANTIESOF
MERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSE
AREDISCLAIMED.INNOEVENTSHALLTHEFREEBSDPROJECTOR
CONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,
INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIAL
DAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOF
SUBSTITUTEGOODSORSERVICES;LOSSOFUSE,DATA,ORPROFITS;
ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANY
THEORYOFLIABILITY,WHETHERINCONTRACT,STRICTLIABILITY,
ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGIN
ANYWAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISED
OFTHEPOSSIBILITYOFSUCHDAMAGE.
Theviewsandconclusionscontainedinthesoftwareanddocumentation
arethoseoftheauthorsandshouldnotbeinterpretedasrepresenting
officialpolicies,eitherexpressedorimplied,oftheFreeBSDProject.

JAVA
ORACLEAMERICA,INC.(ORACLE),FORANDONBEHALFOF
ITSELFANDITSSUBSIDIARIESANDAFFILIATESUNDERCOMMON
CONTROL,ISWILLINGTOLICENSETHESOFTWARETOYOUONLY
UPONTHECONDITIONTHATYOUACCEPTALLOFTHETERMS
CONTAINEDINTHISBINARYCODELICENSEAGREEMENTAND
SUPPLEMENTALLICENSETERMS(COLLECTIVELYAGREEMENT).
PLEASEREADTHEAGREEMENTCAREFULLY.BYSELECTINGTHE
ACCEPTLICENSEAGREEMENT(ORTHEEQUIVALENT)BUTTON
AND/ORBYUSINGTHESOFTWAREYOUACKNOWLEDGETHAT
YOUHAVEREADTHETERMSANDAGREETOTHEM.IFYOUARE
AGREEINGTOTHESETERMSONBEHALFOFACOMPANYOR
OTHERLEGALENTITY,YOUREPRESENTTHATYOUHAVETHE
LEGALAUTHORITYTOBINDTHELEGALENTITYTOTHESETERMS.
IFYOUDONOTHAVESUCHAUTHORITY,ORIFYOUDONOTWISH
TOBEBOUNDBYTHETERMS,THENSELECTTHEDECLINE
LICENSEAGREEMENT(ORTHEEQUIVALENT)BUTTONANDYOU
MUSTNOTUSETHESOFTWAREONTHISSITEORANYOTHER
MEDIAONWHICHTHESOFTWAREISCONTAINED.

July 2016

User GuideSpectra BlackPearl Gateway

233

Appendix D Open Source Code Acknowledgements & Package List

Java

1.DEFINITIONS.Softwaremeansthesoftwareidentifiedaboveinbinary
formthatyouselectedfordownload,installoruse(intheversionYou
selectedfordownload,installoruse)fromOracleoritsauthorized
licensees,anyothermachinereadablematerials(including,butnotlimited
to,libraries,sourcefiles,headerfiles,anddatafiles),anyupdatesorerror
correctionsprovidedbyOracle,andanyusermanuals,programming
guidesandotherdocumentationprovidedtoyoubyOracleunderthis
Agreement.GeneralPurposeDesktopComputersandServersmeans
computers,includingdesktopandlaptopcomputers,orservers,usedfor
generalcomputingfunctionsunderendusercontrol(suchasbutnot
specificallylimitedtoemail,generalpurposeInternetbrowsing,andoffice
suiteproductivitytools).TheuseofSoftwareinsystemsandsolutionsthat
providededicatedfunctionality(otherthanasmentionedabove)or
designedforuseinembeddedorfunctionspecificsoftwareapplications,
forexamplebutnotlimitedto:Softwareembeddedinorbundledwith
industrialcontrolsystems,wirelessmobiletelephones,wirelesshandheld
devices,kiosks,TV/STB,BlurayDiscdevices,telematicsandnetwork
controlswitchingequipment,printersandstoragemanagementsystems,
andotherrelatedsystemsareexcludedfromthisdefinitionandnot
licensedunderthisAgreement.Programsmeans(a)Javatechnology
appletsandapplicationsintendedtorunontheJavaPlatform,Standard
EditionplatformonJavaenabledGeneralPurposeDesktopComputers
andServers;and(b)JavaFXtechnologyapplicationsintendedtorunonthe
JavaFXRuntimeonJavaFXenabledGeneralPurposeDesktopComputers
andServers.CommercialFeaturesmeansthosefeaturesidentifiedin
Table11(CommercialFeaturesInJavaSEProductEditions)oftheJavaSE
documentationaccessibleathttp://www.oracle.com/technetwork/java/
javase/documentation/index.html.READMEFilemeanstheREADME
filefortheSoftwareaccessibleathttp://www.oracle.com/technetwork/java/
javase/documentation/index.html.
2.LICENSETOUSE.SubjecttothetermsandconditionsofthisAgreement
including,butnotlimitedto,theJavaTechnologyRestrictionsofthe
SupplementalLicenseTerms,Oraclegrantsyouanonexclusive,non
transferable,limitedlicensewithoutlicensefeestoreproduceanduse
internallytheSoftwarecompleteandunmodifiedforthesolepurposeof
runningPrograms.THELICENSESETFORTHINTHISSECTION2DOES
NOTEXTENDTOTHECOMMERCIALFEATURES.YOURRIGHTS
ANDOBLIGATIONSRELATEDTOTHECOMMERCIALFEATURES
AREASSETFORTHINTHESUPPLEMENTALTERMSALONGWITH
ADDITIONALLICENSESFORDEVELOPERSANDPUBLISHERS.

July 2016

User GuideSpectra BlackPearl Gateway

234

Appendix D Open Source Code Acknowledgements & Package List

Java

3.RESTRICTIONS.Softwareiscopyrighted.TitletoSoftwareandall
associatedintellectualpropertyrightsisretainedbyOracleand/orits
licensors.Unlessenforcementisprohibitedbyapplicablelaw,youmaynot
modify,decompile,orreverseengineerSoftware.Youacknowledgethat
theSoftwareisdevelopedforgeneraluseinavarietyofinformation
managementapplications;itisnotdevelopedorintendedforuseinany
inherentlydangerousapplications,includingapplicationsthatmaycreate
ariskofpersonalinjury.IfyouusetheSoftwareindangerousapplications,
thenyoushallberesponsibletotakeallappropriatefailsafe,backup,
redundancy,andothermeasurestoensureitssafeuse.Oracledisclaims
anyexpressorimpliedwarrantyoffitnessforsuchuses.Noright,titleor
interestinortoanytrademark,servicemark,logoortradenameofOracle
oritslicensorsisgrantedunderthisAgreement.Additionalrestrictionsfor
developersand/orpublisherslicensesaresetforthintheSupplemental
LicenseTerms.
4.DISCLAIMEROFWARRANTY.THESOFTWAREISPROVIDEDASIS
WITHOUTWARRANTYOFANYKIND.ORACLEFURTHER
DISCLAIMSALLWARRANTIES,EXPRESSANDIMPLIED,INCLUDING
WITHOUTLIMITATION,ANYIMPLIEDWARRANTIESOF
MERCHANTABILITY,FITNESSFORAPARTICULARPURPOSEOR
NONINFRINGEMENT.
5.LIMITATIONOFLIABILITY.INNOEVENTSHALLORACLEBE
LIABLEFORANYINDIRECT,INCIDENTAL,SPECIAL,PUNITIVEOR
CONSEQUENTIALDAMAGES,ORDAMAGESFORLOSSOFPROFITS,
REVENUE,DATAORDATAUSE,INCURREDBYYOUORANYTHIRD
PARTY,WHETHERINANACTIONINCONTRACTORTORT,EVENIF
ORACLEHASBEENADVISEDOFTHEPOSSIBILITYOFSUCH
DAMAGES.ORACLESENTIRELIABILITYFORDAMAGES
HEREUNDERSHALLINNOEVENTEXCEEDONETHOUSAND
DOLLARS(U.S.$1,000).
6.TERMINATION.ThisAgreementiseffectiveuntilterminated.Youmay
terminatethisAgreementatanytimebydestroyingallcopiesofSoftware.
ThisAgreementwillterminateimmediatelywithoutnoticefromOracleif
youfailtocomplywithanyprovisionofthisAgreement.Eitherpartymay
terminatethisAgreementimmediatelyshouldanySoftwarebecome,orin
eitherpartysopinionbelikelytobecome,thesubjectofaclaimof
infringementofanyintellectualpropertyright.Upontermination,you
mustdestroyallcopiesofSoftware.

July 2016

User GuideSpectra BlackPearl Gateway

235

Appendix D Open Source Code Acknowledgements & Package List

Java

7.EXPORTREGULATIONS.YouagreethatU.S.exportcontrollawsand
otherapplicableexportandimportlawsgovernyouruseoftheSoftware,
includingtechnicaldata;additionalinformationcanbefoundonOracles
GlobalTradeCompliancewebsite(http://www.oracle.com/products/
export).YouagreethatneithertheSoftwarenoranydirectproductthereof
willbeexported,directly,orindirectly,inviolationoftheselaws,orwillbe
usedforanypurposeprohibitedbytheselawsincluding,without
limitation,nuclear,chemical,orbiologicalweaponsproliferation.
8.TRADEMARKSANDLOGOS.Youacknowledgeandagreeasbetween
youandOraclethatOracleownstheORACLEandJAVAtrademarksand
allORACLEandJAVArelatedtrademarks,servicemarks,logosandother
branddesignations(OracleMarks),andyouagreetocomplywiththe
ThirdPartyUsageGuidelinesforOracleTrademarkscurrentlylocatedat
http://www.oracle.com/us/legal/thirdpartytrademarks/index.html.Any
useyoumakeoftheOracleMarksinurestoOraclesbenefit.
9.U.S.GOVERNMENTLICENSERIGHTS.IfSoftwareisbeingacquired
byoronbehalfoftheU.S.GovernmentorbyaU.S.Governmentprime
contractororsubcontractor(atanytier),thentheGovernmentsrightsin
Softwareandaccompanyingdocumentationshallbeonlythosesetforthin
thisAgreement.
10.GOVERNINGLAW.Thisagreementisgovernedbythesubstantive
andprocedurallawsofCalifornia.YouandOracleagreetosubmittothe
exclusivejurisdictionof,andvenuein,thecourtsofSanFrancisco,orSanta
ClaracountiesinCaliforniainanydisputearisingoutoforrelatingtothis
agreement.
11.SEVERABILITY.IfanyprovisionofthisAgreementisheldtobe
unenforceable,thisAgreementwillremainineffectwiththeprovision
omitted,unlessomissionwouldfrustratetheintentoftheparties,inwhich
casethisAgreementwillimmediatelyterminate.
12.INTEGRATION.ThisAgreementistheentireagreementbetweenyou
andOraclerelatingtoitssubjectmatter.Itsupersedesallprioror
contemporaneousoralorwrittencommunications,proposals,
representationsandwarrantiesandprevailsoveranyconflictingor
additionaltermsofanyquote,order,acknowledgment,orother
communicationbetweenthepartiesrelatingtoitssubjectmatterduring
thetermofthisAgreement.NomodificationofthisAgreementwillbe
binding,unlessinwritingandsignedbyanauthorizedrepresentativeof
eachparty.

July 2016

User GuideSpectra BlackPearl Gateway

236

Appendix D Open Source Code Acknowledgements & Package List

Java

SUPPLEMENTALLICENSETERMS
TheseSupplementalLicenseTermsaddtoormodifythetermsofthe
BinaryCodeLicenseAgreement.Capitalizedtermsnotdefinedinthese
SupplementalTermsshallhavethesamemeaningsascribedtotheminthe
BinaryCodeLicenseAgreement.TheseSupplementalTermsshall
supersedeanyinconsistentorconflictingtermsintheBinaryCodeLicense
Agreement,orinanylicensecontainedwithintheSoftware.
A.COMMERCIALFEATURES.YoumaynotusetheCommercialFeatures
forrunningPrograms,Javaappletsorapplicationsinyourinternal
businessoperationsorforanycommercialorproductionpurpose,orfor
anypurposeotherthanassetforthinSectionsB,C,DandEofthese
SupplementalTerms.IfYouwanttousetheCommercialFeaturesforany
purposeotherthanaspermittedinthisAgreement,Youmustobtaina
separatelicensefromOracle.
B.SOFTWAREINTERNALUSEFORDEVELOPMENTLICENSEGRANT.
SubjecttothetermsandconditionsofthisAgreementandrestrictionsand
exceptionssetforthintheREADMEFileincorporatedhereinbyreference,
including,butnotlimitedtotheJavaTechnologyRestrictionsofthese
SupplementalTerms,Oraclegrantsyouanonexclusive,nontransferable,
limitedlicensewithoutfeestoreproduceinternallyanduseinternallythe
Softwarecompleteandunmodifiedforthepurposeofdesigning,
developing,andtestingyourPrograms.

July 2016

User GuideSpectra BlackPearl Gateway

237

Appendix D Open Source Code Acknowledgements & Package List

Java

C.LICENSETODISTRIBUTESOFTWARE.Subjecttothetermsand
conditionsofthisAgreementandrestrictionsandexceptionssetforthin
theREADMEFile,including,butnotlimitedtotheJavaTechnology
RestrictionsandLimitationsonRedistributionoftheseSupplemental
Terms,Oraclegrantsyouanonexclusive,nontransferable,limitedlicense
withoutfeestoreproduceanddistributetheSoftware,providedthat(i)
youdistributetheSoftwarecompleteandunmodifiedandonlybundledas
partof,andforthesolepurposeofrunning,yourPrograms,(ii)the
ProgramsaddsignificantandprimaryfunctionalitytotheSoftware,(iii)
youdonotdistributeadditionalsoftwareintendedtoreplaceany
component(s)oftheSoftware,(iv)youdonotremoveoralterany
proprietarylegendsornoticescontainedintheSoftware,(v)youonly
distributetheSoftwaresubjecttoalicenseagreementthat:(a)isa
complete,unmodifiedreproductionofthisAgreement;or(b)protects
OraclesinterestsconsistentwiththetermscontainedinthisAgreement
andthatincludesthenoticesetforthinSectionH,and(vi)youagreeto
defendandindemnifyOracleanditslicensorsfromandagainstany
damages,costs,liabilities,settlementamountsand/orexpenses(including
attorneysfees)incurredinconnectionwithanyclaim,lawsuitoractionby
anythirdpartythatarisesorresultsfromtheuseordistributionofanyand
allProgramsand/orSoftware.ThelicensesetforthinthisSectionCdoes
notextendtotheSoftwareidentifiedinSectionG.
D.LICENSETODISTRIBUTEREDISTRIBUTABLES.Subjecttotheterms
andconditionsofthisAgreementandrestrictionsandexceptionssetforth
intheREADMEFile,includingbutnotlimitedtotheJavaTechnology
RestrictionsandLimitationsonRedistributionoftheseSupplemental
Terms,Oraclegrantsyouanonexclusive,nontransferable,limitedlicense
withoutfeestoreproduceanddistributethosefilesspecificallyidentified
asredistributableintheREADMEFile(Redistributables)providedthat:
(i)youdistributetheRedistributablescompleteandunmodified,andonly
bundledaspartofPrograms,(ii)theProgramsaddsignificantandprimary
functionalitytotheRedistributables,(iii)youdonotdistributeadditional
softwareintendedtosupersedeanycomponent(s)oftheRedistributables
(unlessotherwisespecifiedintheapplicableREADMEFile),(iv)youdo
notremoveoralteranyproprietarylegendsornoticescontainedinoron
theRedistributables,(v)youonlydistributetheRedistributablespursuant
toalicenseagreementthat:(a)isacomplete,unmodifiedreproductionof
thisAgreement;or(b)protectsOraclesinterestsconsistentwiththeterms
containedintheAgreementandincludesthenoticesetforthinSectionH,
(vi)youagreetodefendandindemnifyOracleanditslicensorsfromand
againstanydamages,costs,liabilities,settlementamountsand/orexpenses
(includingattorneysfees)incurredinconnectionwithanyclaim,lawsuit
oractionbyanythirdpartythatarisesorresultsfromtheuseor
distributionofanyandallProgramsand/orSoftware.Thelicensesetforth
inthisSectionDdoesnotextendtotheSoftwareidentifiedinSectionG.

July 2016

User GuideSpectra BlackPearl Gateway

238

Appendix D Open Source Code Acknowledgements & Package List

Java

E.DISTRIBUTIONBYPUBLISHERS.Thissectionpertainstoyour
distributionoftheJavaTMSEDevelopmentKitSoftware(JDK)with
yourprintedbookormagazine(asthosetermsarecommonlyusedinthe
industry)relatingtoJavatechnology(Publication).Subjecttoand
conditioneduponyourcompliancewiththerestrictionsandobligations
containedintheAgreement,Oracleherebygrantstoyouanonexclusive,
nontransferablelimitedrighttoreproducecompleteandunmodified
copiesoftheJDKonelectronicmedia(theMedia)forthesolepurposeof
inclusionanddistributionwithyourPublication(s),subjecttothe
followingterms:(i)YoumaynotdistributetheJDKonastandalonebasis;
itmustbedistributedwithyourPublication(s);(ii)Youareresponsiblefor
downloadingtheJDKfromtheapplicableOraclewebsite;(iii)Youmust
refertotheJDKasJavaTMSEDevelopmentKit;(iv)TheJDKmustbe
reproducedinitsentiretyandwithoutanymodificationwhatsoever
(includingwithrespecttoallproprietarynotices)anddistributedwith
yourPublicationsubjecttoalicenseagreementthatisacomplete,
unmodifiedreproductionofthisAgreement;(v)TheMedialabelshall
includethefollowinginformation:Copyright[YEAR],OracleAmerica,
Inc.Allrightsreserved.Useissubjecttolicenseterms.ORACLEandJAVA
trademarksandallORACLEandJAVArelatedtrademarks,service
marks,logosandotherbranddesignationsaretrademarksorregistered
trademarksofOracleintheU.S.andothercountries.[YEAR]istheyearof
OraclesreleaseoftheSoftware;theyearinformationcantypicallybe
foundintheSoftwaresAboutboxorscreen.Thisinformationmustbe
placedontheMedialabelinsuchamannerastoonlyapplytotheJDK;(vi)
YoumustclearlyidentifytheJDKasOraclesproductontheMediaholder
orMedialabel,andyoumaynotstateorimplythatOracleisresponsible
foranythirdpartysoftwarecontainedontheMedia;(vii)Youmaynot
includeanythirdpartysoftwareontheMediawhichisintendedtobea
replacementorsubstitutefortheJDK;(viii)Youagreetodefendand
indemnifyOracleanditslicensorsfromandagainstanydamages,costs,
liabilities,settlementamountsand/orexpenses(includingattorneysfees)
incurredinconnectionwithanyclaim,lawsuitoractionbyanythirdparty
thatarisesorresultsfromtheuseordistributionoftheJDKand/orthe
Publication;;and(ix)YoushallprovideOraclewithawrittennoticefor
eachPublication;suchnoticeshallincludethefollowinginformation:(1)
titleofPublication,(2)author(s),(3)dateofPublication,and(4)ISBNor
ISSNnumbers.SuchnoticeshallbesenttoOracleAmerica,Inc.,500Oracle
Parkway,RedwoodShores,California94065U.S.A,Attention:General
Counsel.
F.JAVATECHNOLOGYRESTRICTIONS.Youmaynotcreate,modify,or
changethebehaviorof,orauthorizeyourlicenseestocreate,modify,or
changethebehaviorof,classes,interfaces,orsubpackagesthatareinany
wayidentifiedasjava,javax,sun,oracleorsimilarconventionas
specifiedbyOracleinanynamingconventiondesignation.

July 2016

User GuideSpectra BlackPearl Gateway

239

Appendix D Open Source Code Acknowledgements & Package List

Java

G.LIMITATIONSONREDISTRIBUTION.Youmaynotredistributeor
otherwisetransferpatches,bugfixesorupdatesmadeavailablebyOracle
throughOraclePremierSupport,includingthosemadeavailableunder
OraclesJavaSESupportprogram.
H.COMMERCIALFEATURESNOTICE.Forpurposeofcomplyingwith
SupplementalTermSectionC.(v)(b)andD.(v)(b),yourlicenseagreement
shallincludethefollowingnotice,wherethenoticeisdisplayedina
mannerthatanyoneusingtheSoftwarewillseethenotice:
UseoftheCommercialFeaturesforanycommercialorproductionpurpose
requiresaseparatelicensefromOracle.CommercialFeaturesmeans
thosefeaturesidentifiedTable11(CommercialFeaturesInJavaSE
ProductEditions)oftheJavaSEdocumentationaccessibleathttp://
www.oracle.com/technetwork/java/javase/documentation/index.html
I.SOURCECODE.Softwaremaycontainsourcecodethat,unless
expresslylicensedforotherpurposes,isprovidedsolelyforreference
purposespursuanttothetermsofthisAgreement.Sourcecodemaynotbe
redistributedunlessexpresslyprovidedforinthisAgreement.
J.THIRDPARTYCODE.Additionalcopyrightnoticesandlicenseterms
applicabletoportionsoftheSoftwarearesetforthinthe
THIRDPARTYLICENSEREADMEfileaccessibleathttp://
www.oracle.com/technetwork/java/javase/documentation/index.html.In
additiontoanytermsandconditionsofanythirdpartyopensource/
freewarelicenseidentifiedintheTHIRDPARTYLICENSEREADMEfile,
thedisclaimerofwarrantyandlimitationofliabilityprovisionsin
paragraphs4and5oftheBinaryCodeLicenseAgreementshallapplyto
allSoftwareinthisdistribution.
K.TERMINATIONFORINFRINGEMENT.Eitherpartymayterminate
thisAgreementimmediatelyshouldanySoftwarebecome,orineither
partysopinionbelikelytobecome,thesubjectofaclaimofinfringement
ofanyintellectualpropertyright.
L.INSTALLATIONANDAUTOUPDATE.TheSoftwaresinstallationand
autoupdateprocessestransmitalimitedamountofdatatoOracle(orits
serviceprovider)aboutthosespecificprocessestohelpOracleunderstand
andoptimizethem.Oracledoesnotassociatethedatawithpersonally
identifiableinformation.Youcanfindmoreinformationaboutthedata
OraclecollectsasaresultofyourSoftwaredownloadathttp://
www.oracle.com/technetwork/java/javase/documentation/index.html.

July 2016

User GuideSpectra BlackPearl Gateway

240

Appendix D Open Source Code Acknowledgements & Package List

Likewise

LIKEWISE
Licensing:
Thispackageiscomposedofcomponentsreleasedundervaryinglicenses.
LikewiseOpenisprovidedunderthetermsoftheGNUGeneralPublic
License(GPLversion2)andtheGNULibraryGeneralPublicLicense
(LGPLversion2.1).Theadditionalcomponentslistedbelowarecovered
underseparatelicenseagreements:
Samba3.0ClientlibrariesandtoolsGPLv2
NovellDCERPCBSD
libiconvLGPLv2
Formoredetailsandforthefulltextforeachoftheselicenses,readthe
LICENSESandCOPYINGfilesincludedwiththesourcepackagingofthis
software.
OnDebianGNU/Linuxsystems,thecompletetextoftheGNUGeneral
PublicLicensecanbefoundin`/usr/share/commonlicenses/GPL.

RUBY
RubyiscopyrightedfreesoftwarebyYukihiroMatsumoto
<matz@netlab.jp>.
Youcanredistributeitand/ormodifyitundereitherthetermsofthe
2clauseBSDL(seethefileBSDL),ortheconditionsbelow:
1. Youmaymakeandgiveawayverbatimcopiesofthesourceformofthe
softwarewithoutrestriction,providedthatyouduplicateallofthe
originalcopyrightnoticesandassociateddisclaimers.
2. Youmaymodifyyourcopyofthesoftwareinanyway,providedthat
youdoatleastONEofthefollowing:
a. placeyourmodificationsinthePublicDomainorotherwisemake
themFreelyAvailable,suchasbypostingsaidmodificationsto
Usenetoranequivalentmedium,orbyallowingtheauthorto
includeyourmodificationsinthesoftware.
b. usethemodifiedsoftwareonlywithinyourcorporationor
organization.
c. givenonstandardbinariesnonstandardnames,withinstructions
onwheretogettheoriginalsoftwaredistribution.
d. makeotherdistributionarrangementswiththeauthor.

July 2016

User GuideSpectra BlackPearl Gateway

241

Appendix D Open Source Code Acknowledgements & Package List

Ruby on Rails

3. Youmaydistributethesoftwareinobjectcodeorbinaryform,provided
thatyoudoatleastONEofthefollowing:
a. distributethebinariesandlibraryfilesofthesoftware,togetherwith
instructions(inthemanualpageorequivalent)onwheretogetthe
originaldistribution.
b. accompanythedistributionwiththemachinereadablesourceofthe
software.
a. givenonstandardbinariesnonstandardnames,withinstructions
onwheretogettheoriginalsoftwaredistribution.
b. makeotherdistributionarrangementswiththeauthor.
4. Youmaymodifyandincludethepartofthesoftwareintoanyother
software(possiblycommercial).Butsomefilesinthedistributionare
notwrittenbytheauthor,sothattheyarenotundertheseterms.
Forthelistofthosefilesandtheircopyingconditions,seethefile
LEGAL.
5. Thescriptsandlibraryfilessuppliedasinputtoorproducedasoutput
fromthesoftwaredonotautomaticallyfallunderthecopyrightofthe
software,butbelongtowhomevergeneratedthem,andmaybesold
commercially,andmaybeaggregatedwiththissoftware.
6. THISSOFTWAREISPROVIDEDASISANDWITHOUTANY
EXPRESSORIMPLIEDWARRANTIES,INCLUDING,WITHOUT
LIMITATION,THEIMPLIEDWARRANTIESOF
MERCHANTABILITYANDFITNESSFORAPARTICULAR
PURPOSE.

RUBY ON RAILS
Permissionisherebygranted,freeofcharge,toanypersonobtaininga
copyofthissoftwareandassociateddocumentationfiles(theSoftware),
todealintheSoftwarewithoutrestriction,includingwithoutlimitationthe
rightstouse,copy,modify,merge,publish,distribute,sublicense,and/or
sellcopiesoftheSoftware,andtopermitpersonstowhomtheSoftwareis
furnishedtodoso,subjecttothefollowingconditions:
THESOFTWAREISPROVIDEDASIS,WITHOUTWARRANTYOF
ANYKIND,EXPRESSORIMPLIED,INCLUDINGBUTNOTLIMITED
TOTHEWARRANTIESOFMERCHANTABILITY,FITNESSFORA
PARTICULARPURPOSEANDNONINFRINGEMENT.INNOEVENT
SHALLTHEAUTHORSORCOPYRIGHTHOLDERSBELIABLEFOR
ANYCLAIM,DAMAGESOROTHERLIABILITY,WHETHERINAN
ACTIONOFCONTRACT,TORTOROTHERWISE,ARISINGFROM,
OUTOFORINCONNECTIONWITHTHESOFTWAREORTHEUSEOR
OTHERDEALINGSINTHESOFTWARE.

July 2016

User GuideSpectra BlackPearl Gateway

242

Appendix D Open Source Code Acknowledgements & Package List

ZFS

ZFS
COMMONDEVELOPMENTANDDISTRIBUTIONLICENSE(CDDL)
Version1.0

INCLUDED PACKAGES
alsalib1.0.28
atf0.21
bash4.3.33
black_pearl2.0
bluestorm_backend2.0.1171632
bluestorm_frontend2.1.1174119
bluestorm_gui2.0.1174192_1
bluestorm_mgmt2.0.1174119
bluestorm_tests2.0.1173052
bluestorm_workers2.0.1173837_4
boostlibs1.57.0
ca_root_nss3.17.4_1
cdbcmd0.0.1171356,1
cscope15.8a
ctags5.8
curl7.43.0
cyrussasl2.1.26_9
cyrussaslgssapi2.1.26_3
dejavu2.34_4
dmidecode2.12
ds30.0.2.1173725
e2fsprogslibuuid1.42.12
expat2.1.0_2
fio2.1.9
fixesproto5.0
fontconfig2.11.1,1
freetype22.5.5
July 2016

User GuideSpectra BlackPearl Gateway

243

Appendix D Open Source Code Acknowledgements & Package List

Included Packages

fsx1.0.1135963_1
fusefslibs2.9.3_4
gdb7.8.2_1
gettextruntime0.19.4
giflib5.0.6
glib2.42.1
gmake4.1_1
go1.5,1
icu53.1
indexinfo0.2.2
inputproto2.3.1
iozone3.420
iperf2.0.5
ipmitool1.8.14_1
jakartacommonsdaemon1.0.15
javazoneinfo2014.j
javavmwrapper2.5
kbproto1.0.6
krb51.13.2_2
ksh9320120801_2
kyua0.11,2
libICE1.0.9,1
libSM1.2.2_2,1
libX111.6.2_2,1
libXau1.0.8_2
libXdmcp1.1.1_2
libXext1.3.3,1
libXfixes5.0.1_2
libXi1.7.4,1
libXmu1.1.2_2,1
libXrender0.9.8_2
libXt1.1.4_2,1
libXtst1.2.2_2
libedit3.1.20141030_2

July 2016

User GuideSpectra BlackPearl Gateway

244

Appendix D Open Source Code Acknowledgements & Package List

Included Packages

libeio4.18.0_1
libev4.15_1,1
libffi3.2.1
libgcrypt1.6.2_1
libgpgerror1.17
libiconv1.14_6
libpthreadstubs0.3_6
libsmi0.4.8_1
libxcb1.11
libxml22.9.3
libxslt1.1.28_6
libyaml0.1.6_2
likewiseplatform6.3.0.1173829_16
logrotate3.8.8
lua525.2.3_4
lutok0.4_6
mbuffer2014.12.27_1
mhash0.9.9.9_2
mkfile1.1.3
monit5.11_1
mtx1.3.12_1
ncurses5.9.20150214
netsnmp5.7.3_8
netcap1.0.0.1171599
netperf2.6.0_3
nginx1.6.2_1,2
node0.12.6
npm2.6.0
openjdk88.45.14_1
openldapsaslclient2.4.40_1
p42014.2.978861
pcre8.37_4
pdksh5.2.14p2_6
perl55.18.4_11

July 2016

User GuideSpectra BlackPearl Gateway

245

Appendix D Open Source Code Acknowledgements & Package List

Included Packages

pjdfstest1.0.1135963_1
pkg1.4.12
pkgconf0.9.7
popt1.16_1
postgresql93client9.3.10
postgresql93contrib9.3.10
postgresql93server9.3.10
pureftpd1.0.36_3
python22_3
python272.7.9
readline6.3.8
recordproto1.14.2
redis3.0.2
renderproto0.11.1
rrdtool1.4.8_6
ruby2.1.6,1
ruby21gems2.4.7
rubygemabsolute_time1.0.0_3
rubygemactionmailer3.2.22
rubygemactionpack3.2.22
rubygemactivemodel3.2.22
rubygemactiverecord3.2.22
rubygemactiverecordimport0.3.1
rubygemactiveresource3.2.22
rubygemactivesupport3.2.22
rubygemaddressable2.3.6
rubygemansi1.5.0
rubygemarel33.0.3,1
rubygembluestorm_cli3.0.0.1173286
rubygembuilder3.0.4
rubygembundler1.7.3
rubygembyebug3.4.0
rubygemcoffeerails3.2.2_1
rubygemcoffeescript2.3.0

July 2016

User GuideSpectra BlackPearl Gateway

246

Appendix D Open Source Code Acknowledgements & Package List

Included Packages

rubygemcoffeescriptsource1.8.0
rubygemcolorize0.7.5
rubygemcolumnize0.8.9
rubygemcookiejar0.3.2
rubygemdaemon_controller1.2.0
rubygemdaemons1.1.9
rubygemdebuggerlinecache1.2.0
rubygemdevctl0.0.3.1173859
rubygemdevstat_stat0.0.1.1103472
rubygemdigestcrc0.4.1
rubygemdocile1.1.5
rubygemds30.0.1.1164174
rubygemejs1.1.1
rubygememhttprequest1.1.2
rubygememsocksify0.3.0
rubygemerubis2.7.0_1
rubygemeventmachine1.0.5
rubygemexecjs2.2.2
rubygemfacter2.4.1
rubygemfaraday0.9.1
rubygemfastthread1.0.7
rubygemfaye1.1.2
rubygemfayewebsocket0.10.0
rubygemffi1.9.10
rubygemffilocale1.0.1_2
rubygemffincurses0.4.0_3
rubygemfio_rb1.1.0.1141562
rubygemfreebsd_cam1.0.4.1173344
rubygemfreebsd_mps1.1.0.1141562
rubygemfreebsd_ses1.3.1.1141562
rubygemhaml4.0.5
rubygemhike1.2.3,1
rubygemhttp_parser.rb0.6.0
rubygemi18n0.7.0,2

July 2016

User GuideSpectra BlackPearl Gateway

247

Appendix D Open Source Code Acknowledgements & Package List

Included Packages

rubygemi18njs2.1.2_2
rubygemjasminerice0.0.9_2
rubygemjourney1.0.4
rubygemjqueryrails3.1.3
rubygemjson1.8.2
rubygemjson_pure1.8.1
rubygemkey_verify1.0.0.1155188
rubygemlibxmlruby2.7.0
rubygemlikewise0.1.0.1150919
rubygemlive_record0.2.0.1160814
rubygemliveresource2.1.1.1158953
rubygemlsiexp1.2.2.1165611
rubygemmail252.5.4,2
rubygemmetaclass0.0.4
rubygemmimetypes11.25.1
rubygemminitest5.4.2
rubygemmocha0.14.0
rubygemmulti_json1.10.1
rubygemmultipartpost2.0.0
rubygemnetssh2.9.1,2
rubygemopen41.3.4
rubygempam1.5.2.1082167
rubygempassenger4.0.59
rubygempg0.17.1
rubygempmbus1.1.1.1172325
rubygempolyglot0.3.5
rubygempower_assert0.1.4
rubygempqueue2.1.0
rubygemrack1.4.6,3
rubygemrackcache1.2
rubygemrackssl1.3.4,1
rubygemracktest0.6.3
rubygemrack161.6.4
rubygemrails3.2.22

July 2016

User GuideSpectra BlackPearl Gateway

248

Appendix D Open Source Code Acknowledgements & Package List

Included Packages

rubygemrailties3.2.22
rubygemrake10.4.2
rubygemrbkqueue0.2.3
rubygemrbcurse1.5.0_2
rubygemrbcursecore0.0.3_2
rubygemrdoc4.1.2
rubygemrdoc33.12.2
rubygemredis3.2.1
rubygemredisactionpack3.2.4
rubygemredisactivesupport3.2.5
rubygemredisrack1.4.4
rubygemredisrails3.2.4
rubygemredisstore1.1.4
rubygemrice1.7.0
rubygemrrdffi0.2.14_1
rubygemrubytermios0.9.6
rubygemsass3.4.10
rubygemsassrails3.2.6_4
rubygemsimplecov0.9.1
rubygemsimplecovhtml0.8.0_2
rubygemslop3.6.0
rubygemsmart_data0.0.1.1173155
rubygemsnmp1.1.1
rubygemspectra_cli1.0.2.1170850
rubygemspectra_platform1.3.0.1173108
rubygemspectra_support0.2.0.1173244
rubygemspectra_view2.3.0.1174201_6
rubygemspectra_workers0.4.0.1174213
rubygemsprockets222.2.3_1
rubygemsqlite31.3.10
rubygemstaf4ruby0.1.0.1141562,1
rubygemtape_backend0.1.1166905
rubygemtestunit3.0.1
rubygemthin1.6.3

July 2016

User GuideSpectra BlackPearl Gateway

249

Appendix D Open Source Code Acknowledgements & Package List

Included Packages

rubygemthor0.19.1
rubygemtilt2.0.1
rubygemtilt11.4.1
rubygemtreetop1.4.15
rubygemturn0.9.7
rubygemtzinfo030.3.42
rubygemuglifier2.7.0
rubygemuuidtools2.1.5
rubygemwebsocketdriver0.6.2
rubygemwebsocketextensions0.1.2
rubygemyard0.8.7.6
rubygemzfs0.0.10.1168181_2
sg3_utils1.40
smartmontools6.3
smp_utils0.98_1
spectra_ltfs2.2.1.0.1164357
sqlite33.8.10.1
staf3.4.18_3
t5seeprom0.0.1135916_1
tomcat88.0.24_1
verde_hotpair2.0.1122072
vim7.4.640
xauth1.0.9_1
xextproto7.3.0
xproto7.0.26
zfsstats1.2.2_1
zip3.0_1
zsh5.0.7_2

July 2016

User GuideSpectra BlackPearl Gateway

250

INDEX
A
agencydeclarations
conflictmineralpolicy 231
RoHS 231
autosupport
about 160
configuremailrecipient 161
entercontactinformation 160

B
BlackPearl
components 18 to 22,
223 to 225
features 16
monitoring 120
overview 15
power 31
serialnumber 206
sizeandweight 216
specifications 215,226
updating 174
BlackPearlsoftware
currentavailableversion 175
BlackPearluserinterface
about 25
currentversion 175
exit 149
login 34
menus 26
overview 25
statusicons 29
supportedbrowsers 26,29

CleansRemaining,MLM
report 203,203
componentOKicon 29
components
frontview 18,223
rearpanel 22,225
configuring
DNS 87
email 88
Ethernetports 86
mailrecipients 161
networkconnections 85
NTP 90
services 80
conflictmineralpolicy 231
contactinformation,enter 160
contacting
TechnicalSupport 206
contactingSpectraLogic 4
corporateheadquarters,Spectra
Logic 4

D
DeepStoragebrowser
about 151
connecttogateway 152
download 151
interfaceoverview 155
launch 152
requirements 151
transferfiles 157
DNS,configure 87

E
C
cleaningcartridges,usingwith
MLM
CleansRemainingreport 203,
203

email
configuring 88
sendtest 163
SpectraLogicoffices 4
errorconditionicon 29
Ethernetports,configure 86

251

F
faxnumbers,SpectraLogic
frontview 18,223

H
hardware
monitorstatus

125

I
icons
componentOK 29
errorcondition 29
information 29
unknownstate 29
warning 29
informationicon 29

L
license,software

M
mailrecipients
add 161
configure 161
mailingaddress,SpectraLogic 4
maintenance,replace
component 179
managementport,use 86
MLMreports
CleansRemaining 203,203

Index N

N
network
cables 220,227
configure 85
configureDNS 87
NTP
configuring 90

P
password
change 96
performancemetrics 135
phonenumbers,SpectraLogic
offices 4
portal
accessingfortechnical
support 171 to 172
Seealsotechnicalsupport
power
poweroff 147
poweron 31
reboot 147
requirements 218

softwareversion
checkcurrentavailable
version 175
specifications
datastorage 214
environmental 217
power 218 to 219
powercords 219
sizeandweight 216
system 215,226
SpectraLogic
contacting 4
SpectraS3
browser 150
clients 45
onlineforum 14
statuslights 123
support
contacting 206
openingticket 207
supportportal
accessing 171
supportticket
sending 207
systemmessages 124

V
VisualStatusBeacon,lights

121

W
warningicon 29
website
SpectraLogic 4

T
R
rearpanel 22,225
rearview 20,224
reports,MLM
CleansRemaining

S
sales,contacting 4
serialnumber
wheretofind 206
services
configuring 80
edit 80
status 126
software
license 3

July 2016

203,203

technicalsupport
accessingtheTechnical
Supportportal 171 to 172
contacting 4
Seealsoportal
timeout
sessionchange 96
timeoutsetting
change 96
typographicalconventions 13

U
unknownstateicon 29
updates
download 176
USB,support 221

User GuideSpectra BlackPearl Gateway

252

You might also like