Professional Documents
Culture Documents
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
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.
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
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
Contents
About This Guide
12
INTENDEDAUDIENCE..................................
BLACKPEARLUSERINTERFACESCREENS..................
RELATEDINFORMATION................................
TypographicalConventions .................................
RelatedPublications ........................................
ONLINEFORUM ......................................
BLACKPEARLUSERINTERFACE ..........................
Menus ....................................................
StatusIcons ...............................................
SupportedBrowsers ........................................
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
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 ..........
50
52
54
56
58
61
CREATEADISKPARTITION.............................
CREATEATAPEPARTITION .............................
CREATEABLACKPEARLTARGET ........................
CREATEASTORAGEDOMAIN...........................
CREATEADATAPOLICY ...............................
CREATEABUCKET ....................................
TRANSFERDATA......................................
62
64
65
67
71
76
78
79
CONFIGURESERVICES..................................
80
ConfiguretheSNMPService.................................
ConfiguretheSpectraS3Service .............................
July 2016
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 ..........................................
IMPORTTAPES.......................................
IMPORTFOREIGNTAPES...............................
MANAGETAPESNOTININVENTORY....................
MarkTapeasEjected......................................
DeleteLostorEjectedTape .................................
PUTATAPELIBRARYPARTITIONINSTANDBYMODE .......
ACTIVATEATAPELIBRARYPARTITION ..................
July 2016
101
101
101
102
104
105
107
108
108
109
110
111
112
113
113
114
114
115
Contents
DATABASEBACKUP&RESTORE ........................
ManuallyGenerateaDatabaseBackup.......................
CreateaDatabaseBackupSchedule .........................
RestorefromaDatabaseBackup ............................
DeleteBackup............................................
EditBackupDataPolicy....................................
ShowBackupPhysicalPlacement ...........................
MANUALLYSTARTINGTHES3DATAPATHBACKEND......
REBOOTORSHUTDOWNABLACKPEARLGATEWAY .......
UsingtheBlackPearlUserInterface ..........................
PowerCycleReset ........................................
EXITTHEBLACKPEARLUSERINTERFACE .................
July 2016
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
159
ABOUTAUTOSUPPORT ................................
ENTERCONTACTINFORMATION ........................
CONFIGUREMAILRECIPIENTS..........................
AddaNewRecipient ......................................
EditaMailRecipient ......................................
SendaTestEmail .........................................
DeleteaMailRecipient ....................................
LOGSETS ...........................................
ManuallyGenerateLogSets................................
EmailaLogSet ...........................................
DownloadaLogSet.......................................
ConfigureaLogSetSchedule ...............................
DeleteaLogSetorLogSetSchedule .........................
CONFIGURINGAUTOMATEDSOFTWAREUPLOAD ..........
UPDATINGSOFTWARE ................................
ChecktheCurrentSoftwareVersion .........................
ChecktheCurrentlyReleasedSoftwareVersion ...............
DownloadandStagetheUpdatedSoftware ..................
InstalltheUpdate.........................................
REPLACINGAFAILEDCOMPONENT .....................
IdentifytheFailedComponent ..............................
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
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 ..........................
SPECIFICATIONS .....................................
SystemSpecification .......................................
InterfaceSpecifications.....................................
CEMARKING .......................................
FCCNOTICE ........................................
July 2016
189
197
206
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 ..........................
July 2016
230
230
231
231
232
232
232
233
241
241
242
243
243
11
Thisguidedescribeshowtoconfigure,monitor,andmaintaintheSpectra
BlackPearlDeepStorageGateway,sometimesreferredtoasthegatewayin
theseinstructions.Italsoprovidesproductspecifications.
INTENDED AUDIENCE
Thisguideisintendedfordatacenteradministratorsandoperatorswho
maintainandoperatefilestoragesystems.Theinformationinthisguide
assumesafamiliaritywithcomputingterminologyandwithnetwork
connectivityprotocolssuchasSAS,FibreChannel,andEthernet.Youalso
needtobefamiliarwithinstalling,configuring,andusingdatafilestorage
andarchivalsoftware.
RELATED INFORMATION
Thissectioncontainsinformationaboutthisdocumentandother
documentsrelatedtotheSpectraBlackPearlgateway.
12
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.
July 2016
TheSpectraBlackPearlSitePreparationGuideprovidesimportant
informationthatyoushouldknowbeforeinstallingaBlackPearl
gatewayinyourstorageenvironment.
TheSpectraBlackPearlRackMountInstallationGuideprovidesdetailed
instructionsforinstallingtheBlackPearlgatewayinastandardrack.
TheSpectraBlackPearlNetworkSetupTipsdocumentprovideshelpful
instructionsfortroubleshootingcommonconnectivityproblems.
TheSpectraBlackPearlSpectraS3APIReferenceprovidesinformationon
understandingandusingtheSpectraS3API.
User GuideSpectra BlackPearl Gateway
13
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
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
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
16
Features
July 2016
17
Components
COMPONENTS
Thefollowingsectionsshowthelocationsofandbrieflydescribethe
BlackPearlgatewaymajorfrontandrearpanelcomponents.
Front View
Figure 1andFigure 2showthecomponentsonthefrontoftheBlackPearl
gatewayswiththefrontbezelremoved. .
Visual Status Beacon control sled
Latch
Data drives
Figure 1 The front view of the BlackPearl 4U gateway (front bezel removed).
Latch
Data drives
Figure 2 The front view of the BlackPearl 2U gateway (front bezel removed).
July 2016
18
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.
ThestatusLEDsindicatepowerstatus,diskandnetworkactivity,aswellas
hardwarefaults.SeeSystemStatusLEDsonpage 123formoreinformation.
Data drives
ThebaseBlackPearl4Ugatewayincludesonehighperformancesolidstate
drive,andfivespinningdiskdrivesmountedonindividualdrivesledsinthe
frontofthechassis.Additionaldrivesareinstalledintherearofthechassis.The
BlackPearl2Ugatewayincludestenspinningdiskdrivesandtwohigh
performancesolidstatedrivesinthefrontofthechassis.
ThedrivesledsslideintobaysinBlackPearlenclosureandlockinplace.The
frontofeachdrivesledhasahandleforremovingthesledfromthechassisand
alatchforlockingthedrivesledinplace.
TwoLEDsoneachdrivesledindicatethestatusofthedrive.OneLEDisfor
drivestatuswhiletheothershowsdriveactivity.
Emptydrivesledsareinstalledintheunuseddrivebaystoprevent
contaminantsfromenteringtheenclosureandtomaintainproperairflow.
July 2016
19
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
Rear panel
Power supplies
Boot drives
July 2016
20
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.
Emptydrivesledsareinstalledintheunuseddrivebaystoprevent
contaminantsfromenteringtheenclosureandtomaintainproperairflow.
July 2016
21
Components
Rear Panel
Figure 5showsthecomponentsontherearpanelofthecurrentchassisfor
theBlackPearl4Uand2Ugateways.
ForadescriptionofthecomponentsontheBlackPearl1.0chassis,see
Appendix B BlackPearl1.0ChassisOverview&Specificationsonpage
page 222.
10GBase-T
Ethernet ports (2)
Serial
port
USB
ports (4)
BlackPearl
management port
Expansion
slots
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
22
Components
Component
Description
SAS ports
(optional)
Dependingonyourconfiguration,theremaybeaSAScardinstalledinan
availableexpansionslot.AfourportSAScardprovidesconnectivitytoSAS
drivesinaSpectraLogictapelibrary,orprovidesconnectivityforuptotwo
BlackPearlexpansionnodes.AtwoportSAScardprovidesconnectivitytoup
totwoArcticBlueexpansionnodes.
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
23
Components
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
24
Fans
SAS connectors
Fans
Power supplies
Description
Fans
FivehotswappablefansprovidethecoolingfortheArcticBlueexpansionnode.
Power supplies
TheArcticBlueexpansionnodeincludestwopowersuppliestoprovideN+1
redundancyandfailoverprotection.
EachpowersupplyhasitsownACpowerconnector.
EachpowersupplyhasasingleLEDthatlightstoindicatewhenthepoweris
onandfunctioningnormally.
SAS connectors
TherearpaneloftheArcticBlueexpansionnodehastwoSASportsusedto
connectanexpansionnodetoaBlackPearlgateway.
July 2016
25
Menus
Themenubarappearsalongthetopedgeofeachscreen.Usethemenubar
dropdownmenustonavigatethroughtheinterface.
Menu
bar
Status
bar
Power
Alerts
Available Options
Dashboard
TheDashboardnavigationlinkreturnsyoutotheDashboardscreenfromanyother
screenintheinterface.TheDashboardscreendisplaysthegeneralstatusofthe
gateway,tapecache,andnetworkconnections.Clickinganyofthepanesonthe
Dashboardtakesyoutoadetailsscreenforthatselection.TheDashboardscreenalso
displaysperformancemetricsforthegateway.
July 2016
26
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
27
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
28
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
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
30
Power
button
Power LED
July 2016
31
Power
button
Power LED
July 2016
32
Important
Note: UsingtheBlackPearlconsoleistherecommendedwaytochange
themanagementportIPaddress.Ifyoucannotusetheconsole,
seeResolvingaBlackPearlManagementPortIPAddress
Conflictonpage 183forinformationonalternatemethods.
1. ConnectamonitorandUSBkeyboardtotherearoftheBlackPearl
gateway.SeeRearPanelonpage 22tolocatethemonitorandUSB
connectors.TheConsolescreendisplays.
July 2016
33
2. PressCTRL-N.TheConfigureManagementNetworkInterfacescreen
displays.
IP AddressEnteravalidIPv4address.
NetmaskEnterthesubnetmask.
Default GatewayEnterthedefaultnetworkgateway.
4. SelectOK.TheconsolescreendisplaysshowingthenewIPaddress.
5. ConnectacablefromyournetworktotheBlackPearlmanagementport
ontheBlackPearlgateway.Youarenowabletoconnecttothe
BlackPearluserinterfacewiththeIPaddressdisplayedinStep 4.
6. DisconnectthemonitorandUSBkeyboardfromtheBlackPearl
gateway.
July 2016
34
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).
July 2016
35
5. Click> tologin.
Note: Thereisnolimittothenumberofuserswhocanlogintothe
userinterface.SpectraLogicrecommendsonlyonepersonuse
theinterfaceatatimetoavoidconflictingoperations.
Important
The remainder of this guide assumes you are logged in to the BlackPearl user interface.
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.
July 2016
36
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
37
Youcanonlycreateonedataconnectiontothegateway.You
canconfigurelinkaggregationforbetterperformance.
YoucanonlyusetheBlackPearlmanagementporttoaccess
theBlackPearluserinterface.Youcannotusethisportfor
datatransfer.
1. Fromthemenubar,selectConfiguration > Network,orselectthe
NetworkpanefromtheDashboardscreen.TheNetworkscreen
displayswithinformationaboutthenetworkconnectionsofthe
gateway.
July 2016
38
2. DoubleclicktheDatarowintheNetworkInterfacespane,orselectthe
DatarowandselectAction > Editfromthemenubar.TheEditData
Portsdialogboxdisplays.
Note: Dependingonyourhardwareconfiguration,theEditDataPorts
dialogboxmaylookdifferentthanwhatisshownbelow
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
39
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.
40
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.
July 2016
41
View S3 Credentials
VIEW S3 CREDENTIALS
UsetheinstructionsinthissectiontoviewtheS3credentialsofauser.
1. Fromthemenubar,selectConfiguration > Users. TheUsersscreen
displays(seeFigure 18onpage 40).
2. SelecttheuserforwhichyouwanttoviewtheS3credentialsfromthe
UserpaneoftheUsersscreen,andthenselectAction > Show S3
Credentials.TheS3Credentialsdialogboxdisplays.
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.
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
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
44
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
45
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.
PermanentAcopyofthedataisplacedinthespecifiedstorage
domaininitiallyandmaintainedtherepermanently.
TemporaryAcopyofthedataisplacedinthespecifiedstorage
domaininitiallyandmaintainedthereatleastuntilthespecified
retentionperiodexpires.
RetiredTheruleisnotappliedforanynewincomingdata,but
continuestoretaindatapreviouslywritten.
Dataiswrittentoeverystoragedomainforwhichthereisapersistence
rulewiththetypeconfiguredaspermanentortemporary.
July 2016
46
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.
July 2016
Ejectingacopyforoffsitedisasterrecovery:TheBlackPearlgateway
allowsausertomakemultiplecopiesofdataautomatically.Atypical
usecaseistocreateatapefirstcopythatisintendedtobeleftinthe
libraryforeasyretrievalaswellasanejectcopyintendedtobe
removedfromthelibraryoncefullforarchivalatanalternatesitefor
safety.SeeConfigureAdvancedBucketManagementSettingson
page 61forinformationonsettingupmultiplecopiesandejectinga
copy,andtheTapeLibraryUserGuidefordetailsonthephysicalprocess
ofexportingandimportingtapesintothelibrary.
Ejectingacopyofdatafortransfertoanotherlocation:Insome
workflows,auserejectsatapetotransferthedatatoanotherfacility.
IndividualtapescanbeejectedmanuallyusingtheBlackPearluser
interface(seeEjectTapesonpage 108).
47
Ejectingtapestofreeupspaceinthelibrary:Someworkflowsand
budgetsrequireolderorunusedmediatobeejected,makingitnot
readilyavailabletotheBlackPearlgateway,inordertofreeupspacein
thetapelibrary.Aftertapesareexported,newtapesareimportedto
providetheBlackPearlgatewaywithnewmediaforstorageoperations.
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
48
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
49
Example Configurations
Value
Description
Storage Domain
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
50
Example Configurations
Parameter
Value
Description
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
51
Example Configurations
Value
Description
Storage Domain
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
52
Example Configurations
Parameter
Value
Description
Bucket Isolation
Level
Standard
(both storage
domains)
Datafromdifferentbucketscanbemixedontothesame
pieceofmedia.
Note: IfyouplantousetheTapeSecondCopystorage
domaintoejecttapes,youmaywanttochangethe
BucketIsolationLevelfortheTapeSecondCopystorage
domaintoBucketIsolated.
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
53
Example Configurations
Value
Description
Storage Domain
Dataiswrittentotheprimarynearlinediskstorage
domain.
Note: Thisdomainiscreatedautomaticallywhenthe
gatewaydetectsthefirstdiskpartitioncreatedonthe
ArcticBlueexpansionnode.
Data Persistence
Rule
Permanent
Dataismovedtonearlinediskandismaintaineduntil
dataisdeletedfromabucket.
Bucket Isolation
Level
Standard
Datafromdifferentbucketscanbemixedontothesame
diskpool.
July 2016
54
Example Configurations
Parameter
Value
Description
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
55
Example Configurations
Value
Description
Storage Domain
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
56
Example Configurations
Parameter
Value
Description
Bucket Isolation
Level
Standard
(for both storage
domains)
Datafromdifferentbucketscanbemixedontothesame
tapeorpool.
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
57
Example Configurations
Value
Description
Storage Domain
Dataiswrittentotheprimarydiskstoragedomainas
wellastheprimaryandsecondarytapestoragedomains.
Allcopiesofthedataareidentical.
Note: Thesedomainsarecreatedautomaticallywhen
thegatewaydetectsthefirstandsecondtapepartitions
createdonthetapelibrary,andthefirstdiskpartition
createdonanArcticBlueexpansionnode.
July 2016
58
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.
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.
59
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
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
July 2016
62
Usetheinstructionsinthissectiontocreateanewdiskpartition.
1. Fromthemenubar,selectConfiguration > Advanced Bucket
Management todisplaytheAdvancedBucketManagementscreen.
July 2016
63
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.
July 2016
64
July 2016
65
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.
Thesourcegatewayonlyreadsdatafromthetarget
gatewayifthesourcegatewaycannotreadfroman
onlinepool.
Thesourcegatewayonlyreadsdatafromthetarget
gatewayifthesourcegatewaycannotreadfroma
nearlinepool.
66
Name
Description
Thesourcegatewayonlyreadsdatafromthetarget
gatewayifthesourcegatewaycannotreadfromanon
ejectabletape.
Never
Dataisneverreadfromthetargetgateway
July 2016
67
July 2016
68
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.
69
70
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.
July 2016
71
July 2016
72
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.
73
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.
July 2016
74
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.
75
Create a Bucket
CREATE A BUCKET
Bucketsaredatatransfertargetsforreadandwriteoperations.The
gatewaystagesdatawrittentoitonthecacheandoptimizeshowitwrites
bucketstostoragedomainsforbestperformance.
ClientswritedatatothegatewayusingabulkPUTcommand,andread
fromthegatewaywithabulkGETcommand.Formoreinformationon
usingthesecommandsseetheSpectraBlackPearlSpectraS3APIReference.
Note: BucketscanalsobecreatedusingaSpectraS3client,orSpectra
S3API.
Usetheinstructionsinthissectiontoconfigureabucket.
1. Fromthemenubar,selectConfiguration > Buckets.TheBucketsscreen
displays.
July 2016
76
Create a Bucket
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.
77
Transfer Data
Name
Description
Owner
Theuserreceivesfullaccesstoallbuckets,includingall
permissionslistedabove.
TRANSFER DATA
Aftercompletingtheabovesectionsofthischapter,youarereadytobegin
transferringdatato,andfrom,theBlackPearlgateway.
July 2016
TotransferdatausingtheSpectraDeepStorageBrowser,seeUsingthe
DeepStorageBrowseronpage 150.
TotransferdatausingaSpectraS3client,consulttheSpectraBlackPearl
SpectraS3APIReference,anddocumentationspecifictoeachSpectraS3
client.
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
Configure Services
CONFIGURE SERVICES
Usethefollowinginstructionstochangetheoperatingstateand
configurationofaservice.
July 2016
80
Configure Services
7. Ifdesired,addclientsthatareallowedtoaccessthegatewayusingSNMP.
July 2016
81
Configure Services
3. ClickDownload MIB.Usingyourwebbrowser,savethefiletoyourlocal
host.
July 2016
82
Configure Services
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.
83
Configure Services
Description
Allow
Newjobrequestsforunavailablemediaareallowedand
willretryforthedurationoftheUnavailable Tape
Partition Max Job RetryorUnavailable Pool Max Job
Retry setting.
Discouraged
Unavailablepartitionscanbeused,butonlyifnoother
mediaisavailable.
Disallow
Newjobrequestsforunavailablemediafail.
Description
Cancel
Aborttheimportprocessifafilenameconflictis
discovered.
Keepthefilewiththemostrecentcreationdate.
Accept Existing
KeepthefilecurrentlyintheBlackPearldatabase.
11. ClickSave.
July 2016
84
July 2016
85
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
July 2016
86
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.
July 2016
87
2. IntheDNSpaneoftheNetworkscreen,doubleclickthesinglerow,or
selecttherowandthenselectAction >Edit.TheEditDNSscreen
displays.
July 2016
88
UsethefollowinginstructionstoenterSMTPinformationonthegateway.
1. Fromthemenubar,selectConfiguration > Network,orselectthe
NetworkpanefromtheDashboardscreen.TheNetworkscreen
displays.
July 2016
89
Configure Users
CONFIGURE USERS
UsetheinstructionsinthissectiontocreateanewS3usergroup,edit
existingusers,changepasswords,andconfigurethesessiontimeout
setting.Tocreatenewusers,seeCreateaUseronpage 40.
July 2016
90
Configure Users
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.
July 2016
91
Configure Users
UsetheinstructionsinthissectiontocreateanewS3group.
1. Fromthemenubar,selectConfiguration > Users. TheUsersscreen
displays.
July 2016
92
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.
Edit a User
1. Fromthemenubar,selectConfiguration > Users.TheUsersscreen
displaysalistofallconfiguredusers(seeFigure 18onpage 40).
July 2016
93
Configure Users
2. Doubleclickthenameoftheuseryouwanttoedit,orselecttheuser
andthenselectAction > Edit.TheEditUsersdialogboxdisplays.
July 2016
Name
Description
List
Theusercanseethebucketandcanlisttheobjectsina
bucket.
Read
TheusercangetobjectsandcreateGETjobs.
Write
TheusercanputobjectsandcreatePUTjobs.
94
Configure Users
Name
Description
Delete
Theusercandeleteobjects,butcannotdeletethebucket.
Job
Theusercanmodifyorcanceljobscreatedbyotherusers.
Theusercanalsoseethedetailsofjobscreatedbyother
users.
Note: Alluserscanviewalljobs,butbydefault,only
theinitiatorofthejobcanseethefulldetailsofajob.
Owner
Theuserreceivesfullaccesstoallbuckets,includingall
permissionslistedabove.
Delete a User
1. Fromthemenubar,selectConfiguration > Users.TheUsersscreen
displaysalistofallconfiguredusers(seeFigure 18onpage 40).
July 2016
95
Configure Users
96
Configure Certificates
CONFIGURE CERTIFICATES
TheBlackPearlgatewayshipswithnonsignedSSLcertificatesforboththe
dataandmanagementportsonthegateway.Becausethecertificatesare
notsigned,youmustpassasecuritycheckeverytimeyouattemptto
accessthemanagementporttoviewtheBlackPearluserinterface,orwhen
youattempttotransferdatausingthedataport.
Ifdesired,youcaninstallsigned,trustedSSLcertificatesforyourdataand
managementportssothatyounolongerneedtopassthesecuritycheck
whenaccessingtheseports.
UsetheinstructionsinthissectiontoinstallanSSLcertificate.
1. Fromthemenubar,selectConfiguration > Certificates.TheCertificates
screendisplays.
July 2016
97
Configure Buckets
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
98
Configure Buckets
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.
99
Configure Buckets
Name
Description
Owner
Theuserreceivesfullaccesstoallbuckets,includingall
permissionslistedabove.
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.
July 2016
100
July 2016
101
2. SelecttheonlinepoolyouwanttodeleteintheStoragePoolspane,and
selectAction > Delete Online Disk Pool.TheAreYouSureconfirmation
windowdisplays.
July 2016
102
4. DiskpoolseligibleforimportdisplaywithahealthofForeign.Selectthe
nearlinepoolyouwanttoimportintheStoragePoolspane,andselect
Action > Import Pool.TheImportdialogboxdisplays.
Description
ThegatewayusesthebehaviordisplayedintheSystem
Default Conflict Resolution Mode rowoftheImport
dialogbox.
Cancel
Aborttheimportprocessifafilenameconflictis
discovered.
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
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
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.
July 2016
105
Format Tapes
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.
July 2016
106
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.
July 2016
107
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.
July 2016
108
Eject Tapes
July 2016
109
Eject Tapes
July 2016
110
Import Tapes
Usetheinstructionsinthissectiontocancelatapeejection.
1. SelectStatus > Tape Management todisplaytheTapeManagement
screen.
Tocancelasingletapeejection,selectthetapeforwhichyouwantto
canceltheejection,andthenselectAction > Cancel Tape Eject.
IMPORT TAPES
UsetheinstructionsinthissectiontoimporttapemediaintotheBlackPearl
gatewaydatabase.
1. ImportthetapemediaintotheEntry/Exitpoolofthetapelibrary
associatedwiththeBlackPearlgatewayasdescribedinyourlibrary
UserGuide.
2. SelectStatus > Tape Managementfromthemenubar.TheTape
Managementscreendisplays.
July 2016
111
Ifyouimportednewmedia,thetapecartridgesneedtobe
formattedasdescribedinFormatTapesonpage 105.
IfyouimportedmediapreviouslyexportedfromtheBlackPearl
gateway,itisautomaticallyassignedtothebuckettowhichitwas
previouslyassociated.Theobjectsstoredonthetapemediaare
immediatelyavailableforretrieval.
Note: Ifthebucketassociatedwiththeimportedtapemedianolonger
exists,thetapecartridgesaremarkedforformattingand
reclaimedbythegateway.
July 2016
112
113
4. Intheconfirmationwindow,clickConfirm.TheTapeManagement
screenupdatesthetapestatustoEjected.
July 2016
114
2. SelectthetapepartitionintheTapePartitionspane,andselectAction >
Put Tape Partition in Standby.ThePutTapePartitioninStandby
confirmationwindowdisplays.
July 2016
115
2. SelectthetapepartitionintheTapePartitionspane,andselectAction >
Activate Tape Partition.TheActivateTapePartitionconfirmation
windowdisplays.
July 2016
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
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.
July 2016
118
July 2016
119
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).
120
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
121
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
122
Power LED
Hard drive LED
Network 1 LED
Network 2 LED
Fan failure/
Overheat LED
Power failure 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
123
124
Toolbar
Beacon
button
Shows the...
Bezel
ColoroftheVisualStatusBeaconthatisdisplayedduringnormaloperation.
SeeFrontBezelVisualStatusBeacononpage 121formoreinformationabout
thecolorsdisplayedbytheVisualStatusBeacon.
Data Drives
Fans
Statusofmidplanefans
Power Supplies
Powersupplystatusandwattage
July 2016
Slotnumberofeachdrive
Statusofeachdrive
Drivesize,serialnumber,andfirmwarelevel
Thenameofthecachetowhichthedriveisassigned
125
Clicking...
Shows the...
System
CPUstatusandtemperature
Systemmemorystatusandsize
Status,manufacturer,model,size,andserialnumberforeachbootdrive
Tape Drives
Statusoftapedrivesinthetapelibraryconnectedtothegateway
Turn Beacon On
July 2016
This column...
Shows...
Name
Thenameoftheservicerunningonthegateway.
State
ThestatusoftheserviceontheBlackPearlgateway.
StartingTheserviceisstartingup.
OperationalTheserviceisrunning.
StoppedTheserviceisnotrunning.
Enabled
Whetherornottheserviceisenabledatsystemstartup.
YesServiceautomaticallystartswhenthegateway
ispoweredon.
NoServicedoesnotstartwhenthegatewayis
poweredon.
126
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.
127
2. Toviewadditionalinformationaboutasystempool,selectthesystem
poolandthenselectAction > Show Details.Thesystempoolname
detailsscreendisplays.
July 2016
This row...
Shows...
Name
Thenameofthepool.Thisnamecannotbeedited.
Health
Thecurrenthealthofthepool.
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.
128
Shows...
Name
Thenameofanobjectinthespecifiedbucket.
Size
Thesizeoftheobject.
Created
Thetimestampofwhentheobjectwaswrittentothe
bucket.
July 2016
129
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.
130
This column...
Shows...
Amount Archived/
Received
Theamountofdatathatiscompletelyprocessedforthis
job.
ForPUTs,thisindicatestheamountofdatawrittento
tapemedia.ForGETs,thisindicatestheamountofdata
thatwasreadsuccessfullybytheclient.ForVERIFYjobs,
thisistheamountofdataloadedintocachefromthe
permanentdatastore.
User
TheS3userthatinitiatedthejob.
Created
Thetimestampofwhenthejobwascreated.
Toviewthestatusofalltapesintheassociatedtapelibrary,fromthe
menubar,selectStatus > Tape Management. TheTapeManagement
screendisplays.
Toviewthestatusofthetapesassociatedwithabucket:
a. Fromthemenubar,selectConfiguration > Buckets.TheBuckets
screendisplays.
July 2016
131
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
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
132
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.
Thelasterror,ifany,thatwasdetectedwhenreadingdatafrom,orwritingdata
to,thetapecartridge.
Write Protected
Thestatusofthewriteprotectswitchonthecartridge.
Last Modified
Thetimestampofthelasttimedatawaswrittentothetapecartridge.
July 2016
133
2. Todisplaydetailedinformationaboutatapecartridge,doubleclickthe
tapecartridgerow.Adetailsscreenfortheselectedtapedisplays.
July 2016
This row...
Shows...
Barcode
Thebarcodelabelonthetapecartridge.
Serial Number
Themanufacturerassignedserialnumberforthetape
cartridge.
Type
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.
134
Ifthereareanytapeerrorsassociatedwiththespecifiedcartridge,they
displayintheTape Errorspaneofthedetailsscreen.
ThefollowingcommandsareavailablefromtheActionmenuonthetape
cartridgedetailsscreen.Usethelinksbelowformoredetailedinformation
abouteachcommand.
EditSeeEditTapeEjectInformationonpage 80.
135
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
July 2016
136
View Reports
TheReportsscreenallowsyoutogeneratereportsonallaspectsofthe
BlackPearlgateway,includingcomponentstatus,andconfiguration.
ReportscanbesavedineitherJSONorXMLformat.
1. Fromthemenubar,selectStatus > ReportstodisplaytheReports
screen.
July 2016
137
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
138
July 2016
139
CreateanHourlyScheduleonpage 140Createbackupsevery
selectednumberofhours.
CreateaDailyScheduleonpage 141Createbackupsevery
selectednumberofdays.
CreateaWeeklyScheduleonpage 142Createbackupsoncertain
daysoftheweek.
July 2016
140
July 2016
141
6. EnteranumberforEvery_days.Thisvaluespecifiestheinterval,in
days,betweengeneratingdatabasebackups.Forexample,ifthisvalue
issetto2,thegatewaygeneratesabackupeverytwodaysatthetime
specifiedinStep 5.
7. ClickSave.
July 2016
142
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.
July 2016
143
2. SelectthebackupyouwanttorestoreintheBackupspane,andthen
selectAction > Restore from Backup.Aconfirmationscreendisplays.
144
3. EnterthenameofthebucketcontainingthearbitraryfileintheBucket
field.
4. EnterthefilenameofthearbitraryfileintheFilefield.
5. EnterRESTOREintheentryfield,andthenclickRestore.Thedatabase
isrestoredtothestateitwasinwhenthebackupwasgenerated.
Delete Backup
Usethefollowinginstructionstodeleteadatabasebackup.
1. Fromthemenubar,selectConfiguration > Database Backup. The
DatabaseBackupscreendisplays.
145
July 2016
146
2. DoubleclicktheS3service,orselecttheS3serviceandselectAction >
Show Details.TheS3detailsscreendisplays.
3. OntheS3servicedetailsscreen,selectAction > Activate Data Path
Backend.TheActivateDataPathBackendconfirmationwindow
displays.
July 2016
147
1. Clickthepowericoninthelowerrighthandcornerofanyscreeninthe
BlackPearluserinterface.ThePowerscreendisplays.
Power
July 2016
148
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.
July 2016
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
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.
July 2016
151
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.
July 2016
152
UsetheinstructionsinthissectiontoconnecttoaBlackPearlgateway.
1. LaunchtheDeepStoragebrowserusingthemethodappropriatefor
youroperatingsystem(seeInstallandLaunchtheDeepStorage
Browser).TheNewDeepStorageBrowserSessiondialogboxdisplays.
July 2016
Notes:
OnlyoneuseratatimecanaccessthegatewayusingaDeep
Storagebrowser.
Onlythebucketsassignedtotheuserareaccessibleusingthe
DeepStoragebrowser.
153
6. Optionally,selecttheSave Sessioncheckbox.Ifselected,theabove
informationispreenteredthenexttimeyoulaunchtheDeepStorage
browser.
7. ClickSave.TheSpectraLogicDeepStorageBrowsermainwindow
displays.
Figure 111 The Spectra Logic Deep Storage Browser main window.
July 2016
154
Interface Overview
ThissectionprovidesanoverviewoftheDeepStoragebrowserinterface.
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
155
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
156
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.
July 2016
IfyoupreviouslyconnectedtotheBlackPearlgatewayandelected
tosavethesessioninformation,thelogininformationispreentered
inthedialogbox.ClickOK.TheDeepStorageBrowsermain
windowdisplays.
157
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
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
About AutoSupport
ABOUT AUTOSUPPORT
AutoSupportletstheBlackPearlgatewayautomaticallycontactmail
recipientswhencertainkindsofmessagesaregenerated.Itisalsousedto
generateAutoSupportLog(ASL)setsforusebySpectraLogicTechnical
Support.YoucanconfigurethegatewaytoemailASLsetswhencritical
eventsoccur,oronamonthlybasis.Youcanalsochoosetohavemail
recipientsreceiveASLsets.
July 2016
160
July 2016
161
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
Choose the
message severities
you want to receive
Selectfromthelistedmessagetypeswhichseveritiesofmessagethismail
recipientshouldreceive.TheBlackPearlgatewayautomaticallysendsemail
messagesoftheselectedseveritytotherecipientwhentheyaregenerated.
Note: Forthemailrecipienttoreceiveallmessagesgeneratedbythegateway,
selectallboxes.
4. ClickCreatetosavetheinformation.TheMailRecipientsscreenre
displayswiththenewmailrecipientaddedtothelistofmailrecipients.
5. RepeatStep 1throughStep 4toconfigureadditionalmailrecipients.
July 2016
162
2. Fromthelistofmailrecipients,doubleclickthenameoftherecipient
whoseinformationyouwanttoedit,orselectthenameandthenselect
Action > Edit.TheEditMailRecipientdialogboxdisplays.
July 2016
163
Log Sets
3. VerifytheuserreceivedtheemailfromtheBlackPearlgateway.Ifthe
emailisnotreceived,verifythatyouenteredtheSMTPserversettings
correctly(seeConfigureSMTPSettingsonpage 88).
LOG SETS
TheBlackPearlgatewayautomaticallygenerateslogsetswhenerrors
occur.Logsetscanalsobegeneratedmanually,orgeneratedonaschedule.
Thegatewaygeneratesthreetypesoflogsets:
July 2016
LogSetscontaininformationabouttheconfigurationandstatusof
theBlackPearlgatewayandareusedforgeneraltroubleshooting.
LogsetscanbemailedtoconfiguredmailrecipientsortoSpectra
LogicTechnicalSupport.
StatisticLogSetscontainperformancedataaboutthegatewayand
areusedbySpectraLogicTechnicalSupportforindepth
troubleshooting.Statisticlogsetsaretoolargetobemaileddirectly
fromthegatewayandmustbedownloaded.
KernelLogSetsaregeneratedwheneveraprocessonthegateway
fails.Thisreportcannotbegeneratedmanually.
164
Log Sets
DataPathLogSetsareusedtodetermineifthereisaprobleminthe
dataplannercode.Thislogsetcontainsnocustomerdataandis
usedbySpectraLogicTechnicalSupport.
UsetheLogsscreentogenerate,email,ordownloadlogsets,aswellasto
configurealogsetschedule.
July 2016
165
Log Sets
Description
S3 Server
TheS3ServerlogshowsallSpectraS3APIcommands
senttothegateway.
Data Planner
TheDataPlannerlogshowshowdatasenttothe
gatewayisorganizedandstoredtotape.
b. ClickCreate.
c. ContinuewithEmailaLogSetonpage 166orDownloadaLog
Setonpage 167.
July 2016
166
Log Sets
167
Log Sets
3. EnteratimevalueforStart Time,andincludeAMorPMafterthevalue.
Thisfieldisnotcasesensitive.
4. SelectoneormoredaysforEvery week on:.Thisdeterminestheday(s)
oftheweekthesystemgenerateslogsets.
5. ClickCreate.TheLogsscreendisplaysshowingthenewlycreatedLog
SetSchedule.
Description
Deletesalllogsetspresentonthegateway.
Deletesallstatisticlogsetsonthegateway.
Deletesallkernellogsetsonthegateway.
Deletesalldatapathlogsetsonthegateway.
July 2016
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
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.
170
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
171
3. Enteryourregistrationinformation.Youraccountisautomatically
associatedwiththeserialnumbersofallSpectraLogicproductsowned
byyoursite.
Ifyouhaveaninvitation,followthelinkandentertheinvitation
code.
Ifyoudonothaveaninvitation,entertherequestedinformationto
createyouraccount.Whenyouarefinished,clickSign Up.
Whentheaccountisapproved,youreceiveanemailwithalinktosetup
yourinitialpassword.Useyouremailaddressandthepasswordprovided
intheemailtologintoyouraccount.Afteryoulogin,youcanchange
yourpasswordifdesired.
172
Important
IfyouselectUse Proxy,enterthefollowinginformation:
Proxy IP AddressEnteravalidIPv4address.
Proxy PortEntertheportusedtoaccesstheproxyserver.
7. ClickSave.
July 2016
173
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.
174
Updating Software
July 2016
175
Updating Software
3. OntheProductSoftwarepage,locatetheBlackPearlgatewayinthe
SpectraProductcolumn.ThecurrentlyreleasedBlackPearlsoftware
versionislistedintheCurrent Versioncolumn.
July 2016
176
Updating Software
July 2016
177
Updating Software
Figure 130 The Software Update screen with an available software package
listed.
Figure 131 The Software Update screen with a software package staged to
the system.
3. ClickUpdate.Aprogressbarshowstheprogressoftheupdate.
178
4. Whentheupdateiscomplete,theBlackPearlgatewayautomatically
rebootstobeginusingthelatestsoftware.
5. Restartfilestorageoperations.
July 2016
179
2. IfyouhavemultipleBlackPearlgateways,youcanusethebeacon
featuretohelplocatethegatewaywiththefailedcomponent.Onthe
Hardwarescreen,clicktheservername.Thescreenrefreshestoshow
themainHardwarescreen.
July 2016
TheSpectra12&36DriveChassisBootDriveReplacementGuide
providesinstructionsforreplacingafailedbootdriveinthe
gateway.
TheSpectra12,36&45DriveChassisDriveReplacementGuide
providesinstructionsforreplacingafaileddatadriveafterthe
gatewayisinstalled.
TheSpectra12,36&45DriveChassisFanReplacementGuide
providesinstructionsforreplacingafailedfaninthegateway.
TheSpectra12,36&45DriveChassisPowerSupplyReplacement
Guideprovidesinstructionsforreplacingafailedpowersupplyafter
thegatewayisinstalled.
TheSpectra12DriveChassisHBAReplacementGuideandSpectra36
DriveChassisHBAReplacementGuideprovideinstructionsfor
replacingafailedHBAinthegateway.
180
July 2016
TheSpectra96DriveChassisDriveReplacementGuideprovides
instructionsforreplacingafaileddatadriveintheArcticBlue
expansionnode.
TheSpectra96DriveChassisFanReplacementGuideprovides
instructionsforreplacingafailedfanintheArcticBlueexpansion
node.
TheSpectra96DriveChassisPowerSupplyReplacementGuide
providesinstructionsforreplacingafailedpowersupplyinthe
ArcticBlueexpansionnode.
TheSpectra96DriveChassisI/OModuleReplacementGuideprovides
instructionsforreplacingafailedI/OmoduleintheArcticBlue
expansionnode.
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
July 2016
Notes:
ThenetmaskforthedefaultIPaddressis255.255.255.0.
TheBlackPearluserinterfaceusesasecureconnection.
183
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.
IP AddressEnteravalidIPv4address.
NetmaskEnterthesubnetmask.
Default GatewayEnterthedefaultnetworkgateway.
10. ChangetheMTUvalue,ifdesired.IfyousettheMTUvalueto
somethingotherthan1500,ensurethatyourswitchconfiguration
supportslargerMTUsettings,aswellasallthehostsonthenetwork.
July 2016
184
11. ClickSave.
Note: WhenyouchangetheIPaddressoftheBlackPearlmanagement
port,youloseyourconnectiontotheuserinterfacewhenyou
saveyourchanges.Toreestablishtheconnection,enterthenew
IPaddressinyourbrowserandloginagain.
12. DisconnecttheEthernetcablefromtheBlackPearlmanagementport.
13. Connectacablefromyournetworktothemanagementportonthe
BlackPearlgateway.Youarenowabletoconnecttothegatewaywith
theIPaddressconfiguredinStep 9onpage 184.
Configuration
Thefirststepistoconfigurethemanagementanddataportsusingthe
BlackPearluserinterfaceorthecommandlineinterface.Donotattemptto
accessthesystemdirectlyandusetherootconsoletomodifyinterfaces.
Thewebandcommandlineinterfacesaretightlyintegratedwiththebase
operatingsystemandconfigureadditionalsystemfeaturesbasedon
networkchanges.
Note: ThecommandlineinterfaceisnotsupportedintheBlackPearl
softwareversion1.2release.
July 2016
185
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.
July 2016
186
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
July 2016
187
Troubleshooting
Port Link LED Does Not Light
Checktheportconfigurationonthenetworkswitch.TheBlackPearl
gatewayonlysupportsautonegotiation.Makesuretheswitchis
configuredtomatchspeedsonbothendsoftheconnection.
Checkthecablesthatconnecttheporttotheotherdevice.Makesure
thattheyareconnected.Verifythatyouareusingthecorrectcabletype
andconnectors.Thisisespeciallycriticalfor10 GigEconnections
utilizingSFPs.
Verifythattheswitchportsarenotadministrativelydisabled.Consult
theswitchUserGuideformoreinformation.
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
188
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
189
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
190
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
191
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
192
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
193
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
194
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
195
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
196
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.
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
197
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
July 2016
198
FAQ
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
199
FAQ
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.
200
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
201
FAQ
July 2016
202
FAQ
July 2016
203
FAQ
4. ClickGo.TheMLMReportsscreenrefreshestodisplaytheCleanings
Remainingreportwithalistofthebarcodelabelsforallcleaningtapes
intheselectedlocationandthenumberofcleaningsremainingforeach
tape.
Note: Iftherearenocleaningtapeswithcleansremaining,seeyour
TapeLibraryUserGuideforinstructionsonexchangingexpired
cleaningmedia.
July 2016
204
FAQ
July 2016
205
TheBlackPearlgatewayrequiresthateachgenerationofdrivesneedsto
beinitsownseparatelibrarypartition.
Oldermediacanbeplacedinanewerdrivepartition(LTO6mediain
LTO7drivepartition)butonlyLTO6performanceisachieved.
July 2016
206
2. ThegatewayserialnumberislistedintheProductInformationpane.
Companyname,contactname,phonenumber,andemailaddress
Typeofhostsystembeingused
Typeandversionofhostoperatingsystembeingused
Typeandversionofhostfilestoragesoftwarebeingused
3. Submitasupportincident.
TousetheSpectraLogicTechnicalSupportportal:
a. LogintoyouraccountontheTechnicalSupportportalat
support.spectralogic.com.
July 2016
207
Figure 141 SelectIncidents & Inventory > Open or View Incidents to open a
support incident.
July 2016
208
c. OntheOpenorViewIncidentspage,youaregivenan
opportunitytosearchforexistingsupportcontentthatmayhelp
yousolveyourproblemimmediately.Ifthesearchdoesnot
provideananswer,clickOpen a New Incident.
July 2016
209
d. OntheCreateIncidentpage,entertherequestedinformation
providingasmuchdetailaspossible.Whenyouarefinished,
clickCreate Incident.
July 2016
Ifitiswithinthehoursofcoverageprovidedbyyoursupport
contract,contactSpectraLogicTechnicalSupportbytelephone.See
ContactingSpectraLogiconpage 4.
210
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.
211
July 2016
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
Drive Specifications
BlackPearl 4U gateway
Parameter
Specification
Drivetype
SolidStateSATA
Singledrivecapacity,native
400GB
Parameter
Specification a
Drivetype
SpinningDiskSAS
Singledrivecapacity,native
4TB
BlackPearl 2U gateway
Parameter
Specification a
Drivetype
SpinningDiskSAS
Singledrivecapacity,native
4TB
Specification a
Drivetype
SpinningDiskSAS
Singledrivecapacity,native
4TB
Specification a
Drivetype
SpinningDiskSATA
Singledrivecapacity,native
4TB
July 2016
214
Appendix A Specifications
System Specification
Gateway Specifications
Parameter
Specification a
BlackPearl4UGatewaycapacity
52TB
BlackPearl2UGatewaycapacity
26TB
RAIDlevel
DoubleParity
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
July 2016
215
Appendix A Specifications
BlackPearl 4U Gateway
Parameter
Specifications
CPU
Twomulticoreprocessors
Systemdiskdrives
Two250GBSATAdiskdrives
Memory
128GB(8x16GBDIMMs)
Interfaceconnections
Twointegrated10GBaseTEthernetportsa
Onedualport10 GigabitEthernetNIC
(Optional)fourportSAScard
(Optional)twoportSAScard
(Optional)twoportFibreChannelcard
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)
July 2016
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.
ENVIRONMENTAL SPECIFICATIONS
Parameter
Operating Environment a
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
217
Appendix A Specifications
Power Requirements
POWER REQUIREMENTS
ThissectiondescribesthepowerspecificationsfortheBlackPearlgateways.
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
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
Specification
Powercordage
SJTtype,threeconductor,14AWGminimum
Powerinputconnectors
Male:Connectormustbeofthepropertype,
rating,andsafetyapproval.
Female:IEC60320C13
July 2016
Parameter
Specification
Powercordage
Flexible,HAR(harmonized)typeH05VVF,three
conductor,cordwithminimumconductorsizeof
1.7squaremillimeters(0.0026350squareinches).
Powerinputconnectors
Male:Connectormustbeofthepropertype,
rating,andsafetyapprovalfortheintended
country.
Female:IEC60320C13
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
Ethernet(10GBaseT)
TwoRJ45sockets
Ethernet(10GigE)
TwoSFP+opticalmoduleswithaduplexLC
connector
SAS
FourSFF8644socketsperoptionalSAScardfor
connectiontoaBlackPearlexpansionnode.
SAS
TwoSFF8644socketsperoptionalSAScardto
connecttoanArcticBlueexpansionnode.
FibreChannel
TwoSFP+opticalmoduleswithLCconnectorsper
optionalFibreChannelcard
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
220
Appendix A Specifications
Interface Specifications
USBmassstoragedevices(forexample,flashdrives)
Keyboards&pointerdevices(forexample,acomputermouse)
CDorDVDdriveswithUSBinterface
SpectraLogicdoesnotsupportusingtheUSBportsforthefollowing:
July 2016
Cameras
Multimediadevices(forexample,MP3players)
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
Components
COMPONENTS
Thefollowingsectionsshowthelocationsofandbrieflydescribethe
BlackPearl1.0chassismajorfrontandrearpanelcomponents.
Front View
Figure 146andFigure 147showthecomponentsonthefrontofthe
BlackPearlgatewayswiththefrontbezelremoved.
Visual Status Beacon
control sled
Latch
Data drives
Latch
Data drives
Component
Description
Front bezel
(not shown)
Thefrontbezelmountsonthefrontofthechassis,andcontainstheVisual
StatusBeaconlightbar,whichprovidesstatusinformationforthesystem.See
FrontBezelVisualStatusBeacononpage 121formoreinformation.
Visual Status
Beacon control sled
Thedrivesledintheupperleftcornerofthefrontofthechassisprovidescontrolfor
theVisualStatusBeacon.Adiskdrivecannotbeinstalledinthisposition.
Power button
ThepowerbuttoncontrolsthemainACpowerfortheBlackPearlgateway.
ThestatusLEDsindicatepowerstatus,diskandnetworkactivity,aswellas
hardwarefaults.SeeSystemStatusLEDsonpage 123formoreinformation.
Data drives
ThebaseBlackPearl4Ugatewayincludesonehighperformancesolidstatedrive,
andfivespinningdiskdrivesmountedonindividualdrivesledsinthefrontofthe
chassis.Additionaldrivesareinstalledintherearofthechassis.TheBlackPearl2U
gatewayincludestenspinningdiskdrivesinthefrontofthechassis.
ThedrivesledsslideintobaysinBlackPearlenclosureandlockinplace.The
frontofeachdrivesledhasahandleforremovingthesledfromthechassisand
alatchforlockingthedrivesledinplace.
TwoLEDsoneachdrivesledindicatethestatusofthedrive.OneLEDisfor
drivestatuswhiletheothershowsdriveactivity.
Emptydrivesledsareinstalledintheunuseddrivebaystoprevent
contaminantsfromenteringtheenclosureandtomaintainproperairflow.
July 2016
223
Components
Rear View
Figure 148andFigure 149showthemajorcomponentsontherearofthe
BlackPearlgateway.
Rear panel
Power supplies
Power supplies
Rear panel
Boot drives
Data drives
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.
Emptydrivesledsareinstalledintheunuseddrivebaystoprevent
contaminantsfromenteringtheenclosureandtomaintainproperairflow.
July 2016
224
Components
Rear Panel
Figure 150showsthecomponentsontherearpaneloftheBlackPearl4U
and2Ugateways.
IPMI management port
Serial
port
Gigabit
Ethernet ports (4)
USB
ports (4)
BlackPearl
management port
Expansion
slots
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.
Dependingonyourconfiguration,theremaybeaFibreChannelcardinstalled
inanavailableexpansionslot.TheFibreChannelcardprovidesconnectivityto
FibreChanneldrivesinaSpectraLogictapelibrary.
July 2016
225
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
226
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
Ethernet(GigE)
FourRJ45sockets
Ethernet(10GigE)
TwoSFP+opticalmoduleswithaduplexLCconnector
SAS
FourSFF8644socketsperoptionalSAScard
FibreChannel
TwoSFP+opticalmoduleswithLCconnectorsper
optionalFibreChannelcard
July 2016
Interface Type
Cable Requirements
Ethernet(GigE)
ShieldedCategory 5(10/100BaseTconnection)
datagradecablewithaRJ45connector
Ethernet(10GigE)
MultimodeopticalcablewithduplexLCconnectors
SAS
6Gbps4lanecablewithSFF8644andSFF8088
connectors
FibreChannel
50micron400M5SNIclassification
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
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
229
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.
EN609501SecondEdition
UL609501SecondEdition
CSAC22.2No.60950103
LowVoltageDirective(EU:CEMark)
July 2016
230
WithinparticipatingEuropeanUnioncountries,specialcollection,
recycling,anddisposalarrangementhavebeenestablishedforthis
product.Attheendoflife,theproductusershoulddisposeofthisproduct
usingspecialWEEEcollectionsystems.Thesespecialsystemsmitigatethe
potentialaffectsontheenvironmentandhumanhealththatcanresult
fromhazardoussubstancesthatmaybecontainedinthisproduct.
EuropeanUnionusersshouldcontacttheirlocalwasteadministrationfor
WEEEcollectioninstructionsforthisproduct.
July 2016
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
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
233
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
234
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
235
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
236
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
237
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
238
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
239
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
240
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
241
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
242
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
243
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
244
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
245
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
246
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
247
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
248
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
249
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
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
252