IBM
Ultrium
Device
Drivers
Installation
and
User’s
Guide
GA32-0430-07
IBM
Ultrium
Device
Drivers
Installation
and
User’s
Guide
GA32-0430-07
Note!
Beforeusingthisinformationandtheproductthatitsupports,besuretoreadthegeneralinformationunderAppendixD, “Notices,”onpage259.
EleventhEdition(October2003)
ThiseditionoftheIBMUltriumDeviceDriversInstallationandUser’sGuide,GA32-0430-07obsoletesandreplaces GA32-0430-06.Changesoradditionsareindicatedbyaverticallineintheleftmargin.
©CopyrightInternationalBusinessMachinesCorporation2000,2003.Allrightsreserved.
Contents
Figures
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. ix
Tables
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. xi
Preface
.
.
.
.
.
.
.
.
.
.
.
.
.
. xiii
RelatedInformation . . . xiii
IBMTotalStorage® UltriumExternalTapeDrive 3580 . . . xiii
IBMTotalStorageUltriumTapeAutoloader3581 xiii IBMTotalStorageUltriumTapeLibrary3582 . . xiii
IBMTotalStorageUltriumScalableTapeLibrary 3583 . . . xiii
IBMTotalStorageUltraScalableTapeLibrary 3584 . . . xiii
OtherPublications. . . xiii
AdditionalInformation . . . xiii
HowtoSendYourComments . . . xv
Summary
of
Changes
.
.
.
.
.
.
.
. xvii
EleventhEdition(October2003) . . . xvii
TenthEdition(June2003) . . . xvii
NinthEdition(April2003). . . xvii
EightEdition(January2003) . . . xvii
FifthEdition(March2002) . . . xvii
FourthEdition(September2001). . . xvii
ThirdEdition(July2001) . . . xvii
SecondEdition(March2001). . . xviii
Part
1.
Introduction
to
IBM
Ultrium
Device
Drivers
.
.
.
.
.
.
.
.
.
.
. 1
Chapter
1.
Ultrium
Device
Drivers
.
.
.
. 3
Purpose . . . 3
PlatformSupport. . . 3
Introduction . . . 4
IBMTotalStorageUltriumExternalTapeDrive 3580 . . . 6
IBMTotalStorageUltriumTapeAutoloader3581 . 6 IBMTotalStorageUltriumTapeLibrary3582. . . 6
IBMTotalStorageUltriumScalableTapeLibrary 3583 . . . 6
IBMTotalStorageUltraScalableTapeLibrary3584 7 StorageSmart™ byIBMUltriumProducts. . . . 7
Part
2.
AIX
Tape
and
Medium
Changer
Device
Driver
.
.
.
.
.
.
. 9
Chapter
2.
Introduction
and
Product
Requirements
.
.
.
.
.
.
.
.
.
.
.
. 11
Purpose . . . 11
DataFlow. . . 11
ProductRequirements. . . 11
SoftwareRequirements . . . 11
LibraryControlPathFailoverSupport . . . . 12
HardwareRequirements . . . 12
Chapter
3.
Tape
Drive,
Media,
and
Device
Driver
Parameters
.
.
.
.
.
.
. 13
ConfigurationParameters. . . 13
Autoloading . . . 13
BlockSize. . . 14
Compression. . . 14
Logging . . . 14
MaximumSizeoftheLogFile . . . 14
RecordSpaceMode . . . 14
RewindImmediate. . . 15
TrailerLabels. . . 15
MediaParameter . . . 15
Chapter
4.
Installation
and
Configuration
Instructions
.
.
.
.
.
. 17
InstallationProcedure. . . 17
PreinstallationConsiderations . . . 17
InstallationProcedure. . . 18
ConfiguringTapeandMediumChangerDevices. . 19
DeconfiguringTapeDevices. . . 19
DeconfiguringMediumChangerDevices . . . . 20
UninstallationProcedure . . . 20
Chapter
5.
Special
Files
.
.
.
.
.
.
. 21
SpecialFilesforTapeDevices . . . 21
SpecialFilesforMediumChangerDevices. . . . 22
Chapter
6.
Alternate
Pathing
Support
for
Library
Control
Path
Failover
.
.
. 25
ConfiguringandUnconfiguringAlternatePathing Support . . . 25
PrimaryandAlternatePaths. . . 26
QueryingPrimaryandAlternatePathConfiguration 26 ConfiguringandUnconfiguringPrimaryand AlternateDevices . . . 27
Chapter
7.
Alternate
Pathing
Support
for
Tape
Drives
.
.
.
.
.
.
.
.
.
.
. 29
AutomaticFailover. . . 29
DynamicLoadBalancing. . . 30
ConfiguringandUnconfiguringAlternatePathing Support . . . 30
PrimaryandAlternatePaths. . . 31
QueryingPrimaryandAlternatePathConfiguration 32 ConfiguringandUnconfiguringPrimaryand AlternateDevices . . . 32
Chapter
8.
Using
the
Dump
Support
.
. 33
©CopyrightIBMCorp. 2000,2003
iii
Chapter
9.
Tape
Utility
Program
(tapeutil)
.
.
.
.
.
.
.
.
.
.
.
.
.
. 35
InteractiveInterface . . . 35
Command-LineInterface. . . 35
GeneralSubcommands . . . 36
MediumChangerSubcommands . . . 39
TapeSubcommands . . . 40
ServiceAidSubcommands . . . 44
BlockSizeandSCSITransferSize . . . 44
ConfigurationParameters. . . 44
ReserveandReleaseCommands . . . 45
TapeDriveServiceAids . . . 45
VolumeIDforLogging . . . 45
Chapter
10.
Tape
Drive
Service
Aids
.
. 47
DetailsofTapeServiceAids. . . 47
ForceMicrocodeDump . . . 47
ReadDump . . . 48
MicrocodeLoad. . . 48
ErrorLogAnalysis. . . 49
ResetDrive . . . 49
Chapter
11.
Performance
Considerations
.
.
.
.
.
.
.
.
.
.
. 51
DataPath . . . 51
CommonAIXUtilities. . . 51
BeforeCallingSupport . . . 52
Chapter
12.
Device
and
Volume
Information
Logging
.
.
.
.
.
.
.
.
. 53
LogFile . . . 53
TapeLogUtility. . . 53
Chapter
13.
Problem
Determination
.
. 55
ErrorLogging . . . 55
ErrorLogTemplates . . . 55
ErrorLabels . . . 55
DetailData . . . 55
AutomaticDumpFacilityfortheIBM3580Ultrium TapeDrive . . . 57
TraceFacility. . . 57
ATRCUtility. . . 57
Part
3.
Compaq
Tru64
Tape
and
Medium
Changer
Device
Driver
.
.
. 59
Chapter
14.
Introduction
and
Product
Requirements
.
.
.
.
.
.
.
.
.
.
.
. 61
Purpose . . . 61
ProductRequirements. . . 61
HardwareRequirements . . . 61
SoftwareRequirements . . . 61
SettingUptheEnvironment. . . 61
Chapter
15.
RAS
Utility
Program
For
Compaq
Tru64
System
(IBMrasutil)
.
. 63
InstallationProcedurefromtheDeviceDriverCD 63 InstallationProcedurefromtheDeviceDriverftp Site . . . 63 Uninstalling . . . 64 UpdateProcedure . . . 64 QueryProcedure . . . 64 VerifyProcedure. . . 64 InteractiveMode . . . 64 Command-LineMode. . . 64 Command-LineOptions . . . 65
Part
4.
HP-UX
Tape
and
Medium
Changer
Device
Driver
.
.
.
.
.
.
. 67
Chapter
16.
Introduction
and
Product
Requirements
.
.
.
.
.
.
.
.
.
.
.
. 69
Purpose . . . 69 ProductRequirements. . . 69 ATDDImplementation . . . 69 HardwareRequirements . . . 69 SoftwareRequirements . . . 72 DataFlow. . . 72SoftwareInterfacetotheDeviceDriver . . . 73
Chapter
17.
Install,
Uninstall,
and
Configure
.
.
.
.
.
.
.
.
.
.
.
.
. 75
CreatetheDriveConfigurationFile(Optional). . . 76
DeterminetheDriveHardwarePathforIBM 3580UltriumTapeDrive,3581TapeAutoloader withSCSIAttachment. . . 76
DeterminetheDriveHardwarePathsforIBM UltriumTapeLibrarieswithSCSIAttachment. . 77
DeterminetheDriveHardwarePathsforIBM 3580UltriumTapeDrive,IBMUltriumTape LibrarieswithFibreChannelAttachment . . . 77
CreatetheHardwarePathEntry . . . 77
CreatetheDeviceSpecificConfigurationEntries (Optional). . . 78
PowerOfftheTapeDrives . . . 78
InstalltheDriverUsingtheCDInstallationScript 78 InstallDriversManually . . . 79
CopytheSoftwaretotheSoftwareDepot . . . 79
ReviewtheatddREADMEFile. . . 80
InstallATDD. . . 81
Post-ConfigurationofIBMMediumChanger Devices. . . 81
AddinganIBMUltriumDeviceUsingtheCurrently InstalledATTD . . . 84
UninstallingtheSoftware. . . 85
OtherAdministrativeTasks . . . 85
Chapter
18.
Special
Files
.
.
.
.
.
.
. 87
Chapter
19.
Supported
Configurations
89
ModifyingConfigurationParameters. . . 89Chapter
20.
Configuration
Parameter
Definitions
.
.
.
.
.
.
.
.
.
.
.
.
. 91
Driver-SpecificParameters . . . 92
Chapter
21.
Troubleshooting
.
.
.
.
. 93
ErrorLogging . . . 93
Support_infoScript. . . 93
TracingFacility . . . 93
Atdd_dLogDaemon . . . 94
ProblemsandSolutions . . . 95
Chapter
22.
Tape
Utility
Program
(tapeutil)
.
.
.
.
.
.
.
.
.
.
.
.
.
. 97
CommandSequenceInformation . . . 97
ProductRequirements. . . 97
TapeutilImplementation . . . 97
HardwareRequirements . . . 97
InstalltapeutilUsingtheCDInstallationScript . . 98
InstalltapeutilManually . . . 98
CopytheSoftwaretotheSoftwareDepot . . . . 98
ReviewthetapeutilREADMEFile. . . 99
Installtapeutil . . . 99
Uninstallingtapeutil . . . 100
OtherAdministrativeTasks. . . 100
UsingthetapeutilProgram. . . 100
InteractiveMode . . . 101
Command-LineInterface . . . 103
ServiceCommands . . . 103
BasicSCSICommands . . . 103
MediumChangerCommands. . . 104
TapeDriveCommands . . . 104
FlagDescription . . . 105
Part
5.
Linux
Tape
and
Medium
Changer
Device
Driver
.
.
.
.
.
. 109
Chapter
23.
Introduction
and
Product
Requirements
.
.
.
.
.
.
.
.
.
.
. 111
Purpose . . . 111
DataFlow . . . 111
ProductRequirements . . . 111
HardwareRequirementsforIntel™ Processors 112 HardwareRequirementsforIBMERserver pSeriesModels. . . 112
HardwareRequirementsforIBMERserver zSeries® Models . . . 112
LibraryControlPathFailoverSupport . . . . 113
SoftwareRequirementsforIntelProcessors . . 113
SoftwareRequirementsforIBMpSeriesModels 113 SoftwareRequirementsforIBMzSeriesModels 113
Chapter
24.
Tape
Drive,
Media,
and
Device
Driver
Parameters
.
.
.
.
.
. 115
ConfigurationParameters . . . 115 NonchangeableParameters: . . . 116 Autoloading. . . 116 CapacityScaling . . . 116 DensityCode . . . 116 EmulateAutoloader . . . 116 HookWord . . . 116
LogicalWriteProtect. . . 116
MaximumBlockSize. . . 116
MinimumBlockSize . . . 116
MediumType . . . 116
ReadSILIBit . . . 116
RecordSpaceMode . . . 116
VolumeIDforLogging . . . 117
WriteProtect . . . 117
ChangeableParameters:. . . 117
BlockSize . . . 117
BufferedMode. . . 117
Compression . . . 117
DisableAutoDriveDump . . . 117
DisableSIMLogging. . . 117
Logging(VolumeLogging). . . 117
MaximumSCSITransferLength . . . 118
ReadPastFilemark . . . 118
RewindImmediate . . . 118
Trace . . . 118
TrailerLabels . . . 119
Chapter
25.
Installation
and
Configuration
Instructions
.
.
.
.
.
. 121
ConventionsUsed. . . 121
ComponentsCreatedDuringInstallation . . . . 121
InstallationProcedure . . . 122
UpdatingProcedure . . . 123
QueryingInstalledPackage. . . 123
VerifyingInstallation/Updating . . . 123
ConfiguringTapeandMediumChangerDevices onIntel-CompatibleSystems . . . 124
ConfiguringTapeandMediumChangerDevices onIBMERserverpSeriesModels . . . 125
ConfiguringTapeandMediumChangerDevices onIBMERserverzSeriesModels . . . 125
Use/etc/zfcp.confFile . . . 125
Modifythe/etc/modules.confFile . . . 126
DynamicallyAttachingaTapeDevice . . . . 126
UninstallProcedure . . . 127
Chapter
26.
Configure
and
Run
IBMtaped
Daemon
.
.
.
.
.
.
.
.
. 129
InstallIBMtaped . . . 129 ConfigureIBMtaped . . . 129 Tracing . . . 129 ErrorLogging . . . 130 VolumeLogging . . . 130AutomaticallyRetrieveaDriveDump . . . . 131
SelectiveTracing . . . 132
RunIBMtaped . . . 132
Chapter
27.
Special
Files
.
.
.
.
.
. 135
SpecialFilesfortheTapeDevice . . . 135
SpecialFilesfortheMediumChangerDevice . . 135
Chapter
28.
Alternate
Pathing
Support
for
Library
Control
Path
Failover
.
.
. 137
ConfiguringandUnconfiguringAlternatePathing Support . . . 137
PrimaryandAlternatePaths . . . 138
Contents
v
| || || || | | | | | | | | | | |QueryingPrimaryandAlternatePath
Configuration . . . 139
DisableandEnablePrimaryandAlternatePaths 139
Chapter
29.
Tape
Utility
Program
(IBMtapeutil)
.
.
.
.
.
.
.
.
.
.
.
. 141
InteractiveMode . . . 141
Command-LineMode . . . 141
GeneralSubcommands . . . 142
disablepath″primary″|number. . . 142
enablepath″primary″|number . . . 142
inquiry[Page] . . . 143 logpage″Page″. . . 143 modepage″Page″ . . . 143 path . . . 143 print″Text″ . . . 143 qrypath . . . 143 qryversion . . . 143 release. . . 144 reqsense . . . 144 reserve . . . 144 tur. . . 144 TapeSubcommands . . . 144 allow . . . 144 append . . . 144 asf[Count] . . . 144 bsf[Count] . . . 144 bsfm[Count] . . . 144 bsr[Count] . . . 144
compressandnocompress . . . 144
density . . . 145
display″Message″. . . 145
eof[Count]andweof[Count]. . . 145
erase . . . 145 fsf[Count] . . . 145 fsfm[Count]. . . 145 fsr[Count] . . . 145 list. . . 145 load . . . 145 lock . . . 145 mtdevice. . . 145
offline,rewoffl,andunload. . . 145
parms. . . 146
prevent . . . 146
qryinquiry . . . 146
qrypos. . . 146
qrysense . . . 146
read-dDestination[-cCount]. . . 146
rewindandretension. . . 146
rtest[-bBlocksize][-cCount][-rRepetition] . . 146
rwtest[-bBlocksize][-cCount][-rRepetition] 147 seek[Count]. . . 147
seod . . . 147
setblk[BlockSize]. . . 147
setpos[Blockid] . . . 147 status . . . 148 sync . . . 148 tell. . . 148 unlock. . . 148 write-sSource. . . 148
wtest[-bBlocksize][-cCount][-rRepetition] 148 MediumChangerSubcommands. . . 148
allow . . . 148
audit[Address[Count] . . . 149
devids. . . 149
elementinfo . . . 149
exchangeSourceDest1Dest2 . . . 149
inventory. . . 149
mount[Slot]. . . 149
moveSourceDestination . . . 150
positionDestination . . . 150
prevent . . . 150
unmount[Slot]. . . 150
ServiceAidSubcommands. . . 150
dump[Filename] . . . 150
forcedump . . . 150
resetdrive . . . 151
ucode[Filename] . . . 151
AutomaticCartridgeFacilityMode . . . 151
BlockSizeandSCSITransferSize . . . 151
ConfigurationParameters . . . 151
CapacityScaling . . . 151
LogicalWriteProtect. . . 151
ReserveandReleaseCommands . . . 151
ServiceAidsCommands. . . 152
CreateSpecialFiles . . . 152
Chapter
30.
Tape
Drive
Service
Aids
153
DetailsofTapeDriveServiceAids . . . 153ForceDriveDump . . . 153
ReadDump. . . 153
LoadMicrocode . . . 153
ResetDrive . . . 153
Part
6.
Solaris
Tape
and
Medium
Changer
Device
Driver
.
.
.
.
.
. 155
Chapter
31.
Introduction
and
Product
Requirements
.
.
.
.
.
.
.
.
.
.
. 157
Purpose . . . 157
ProductRequirementsandCompatibility . . . . 157
HardwareRequirements. . . 157
SoftwareRequirements . . . 158
SoftwareCompatibility . . . 158
DataFlow . . . 159
SoftwareInterfacetotheDeviceDriver. . . 159
Chapter
32.
Installation,
Removal,
and
Configuration
.
.
.
.
.
.
.
.
.
.
. 161
PreventingConflictswithOtherDeviceDrivers 161 InstallingorUpdatingIBMtape . . . 162
InstallationSteps . . . 162
RemovingIBMtape . . . 169
ConfigurationParameters . . . 169
AddingorRemovingDevices. . . 172
Chapter
33.
Special
Files
.
.
.
.
.
. 175
| || || || || || ||
Chapter
34.
Service
and
Diagnostic
Aids
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 179
FunctionalVerification . . . 179
ProblemDetermination . . . 179
DownloadingDeviceMicrocode . . . 180
ForcingandStoringDeviceDiagnosticDump . . 180
TracingFacility. . . 181
SettingtheIBM_traceLevel . . . 183
RunningtheDiags_infoScript. . . 183
TapeandMediumChangerUtilityProgram . . . 184
ServiceCommands . . . 186
BasicSCSICommands . . . 186
MediumChangerCommands. . . 186
TapeDriveCommands . . . 186
FlagDescription . . . 187
Part
7.
Microsoft
Windows
Tape
Device
Drivers
.
.
.
.
.
.
.
.
.
. 191
Chapter
35.
Introduction
and
Product
Requirements
.
.
.
.
.
.
.
.
.
.
. 193
WindowsNT® . . . 193 HardwareRequirements. . . 193 SoftwareRequirements . . . 194 InstallationNotes® . . . 194Windows2000andWindowsServer2003 . . . . 194
HardwareRequirements. . . 195
SoftwareRequirements . . . 195
InstallationNotes . . . 196
Chapter
36.
Windows
NT
Device
Driver
Management
.
.
.
.
.
.
.
.
. 197
InstallationOverview. . . 197
InstallationProcedure . . . 197
RemovalProcedure . . . 203
ManualStartingandStoppingProcedures. . . . 206
Chapter
37.
Windows
2000
and
Windows
Server
2003
Device
Driver
Management
.
.
.
.
.
.
.
.
.
.
.
. 209
InstallationOverview. . . 209
InstallationProcedures . . . 209
DeviceRemovalorDisableProcedure . . . 220
UninstallingtheDeviceDrivers . . . 220
Chapter
38.
Windows
Utility
Program
(ntutil)
.
.
.
.
.
.
.
.
.
.
.
.
.
. 221
Callingntutil . . . 221 InteractiveMode . . . 222 BatchMode. . . 224 Comments . . . 225 CommandStatements . . . 225 set . . . 235 type . . . 235 pause . . . 235 delay . . . 236 system . . . 236 symbols . . . 236 exit. . . 236 SymbolicValues . . . 236DeviceDriverDiagnosisInformation(forMicrosoft WindowsNT) . . . 239
DeviceDriverDiagnosisInformation(forMicrosoft Windows200x). . . 240
UsingtheDebugVersion . . . 240
RestoringtheNon-DebugVersion . . . 241
Part
8.
Appendixes
.
.
.
.
.
.
.
. 243
Appendix
A.
Accessing
Documentation
and
Software
Online
. 245
Appendix
B.
Verifying
Proper
Attachment
of
Your
Devices
.
.
.
.
. 247
AIXSystem . . . 247
TapeDeviceAttachmentTest . . . 247
MediumChangerDeviceAttachmentTest. . . 248
CompaqTru64System . . . 248
TapeDeviceAttachmentTest . . . 248
MediumChangerDeviceAttachmentTest. . . 249
HP-UXSystem. . . 249
TapeDeviceAttachmentTest . . . 249
AutochangerDeviceAttachmentTest . . . . 250
LinuxSystem . . . 250
TapeDeviceAttachmentTest . . . 250
MediumChangerDeviceAttachmentTest. . . 251
SolarisSystem . . . 252
TapeDeviceAttachmentTest . . . 252
AutochangerDeviceAttachmentTest . . . . 252
MicrosoftWindowsSystem. . . 253
TapeDeviceAttachmentTest . . . 253
AutochangerDeviceAttachmentTest-Windows NTonly . . . 253
Appendix
C.
Managing
the
Microcode
on
the
IBM
Tape
Drive
.
.
.
.
.
.
. 255
AIXSystem . . . 256
CompaqTru64System . . . 256
HP-UXSystem. . . 256
LinuxSystem . . . 256
SunSolarisSystem . . . 257
MicrosoftWindowsSystem. . . 257
Appendix
D.
Notices
.
.
.
.
.
.
.
. 259
Trademarks . . . 260
Index
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 261
Figures
1. AttachmentArray. . . 5
2. ExampleofanUltriumEnvironment . . . . 6
3. DataFlowProcess . . . 11
4. DataPath . . . 51
5. DataFlow . . . 72
6. TAPEUTILProgramMenuforthetapedrive onHP-UX11.00and11iPCIBusSystems . . 102
7. TAPEUTILProgramMenuforthemedium changeronHP-UX11.00and11iPCIBus Systems . . . 102
8. DataFlowProcess . . . 111
9. DataFlow . . . 159
10. TAPEUTILProgramMenufortheTapeDrive 185 11. TAPEUTILProgramMenufortheMedium Changer . . . 185
12. SelectComponentsMenu . . . 198
13. StartMenu . . . 199
14. StartDriverList. . . 199
15. RescanforTapeDevice . . . 199
16. InstallDriverMenu—SelectCancel 200 17. TapeDevicesMenu . . . 201
18. HaveDiskMenu . . . 202
19. InstallDriverMenu . . . 203
20. WindowsNTStatement . . . 203
21. RemoveDriverMenu. . . 204
22. ControlPanelSelection . . . 204
23. Add/RemoveProperties. . . 205
24. DriveRemovalMenu. . . 206
25. ManualStartingandStoppingMenu 207 26. ComputerManagementConsole . . . 210
27. ComputerManagementConsolewithUltrium DeviceSelected. . . 211
28. DeviceDriverPropertieswithReinstall Driver...Selected . . . 212
29. InstallHardwareDeviceDriversDialog 213 30. LocateDriverFilesScreenwithSpecifya LocationSelected . . . 214
31. SpecifyingtheLocationoftheDriver 214 32. FilesNeededMenu—ibmchgr.sys . . . . 215
33. DriverFilesSearchResults . . . 215
34. CompletingtheUpgradeDeviceDriver Wizard. . . 216
35. VerifyingtheUltriumDeviceWasInstalled Correctly . . . 217
36. HardwareUpdateWizardWelcomeScreen 217 37. SearchandInstallationOptions . . . 218
38. WindowsLogoTestingScreen. . . 219
39. CompletingtheHardwareUpdateWizard 219 40. BaseMode . . . 223
41. LibraryMode . . . 224
42. SymbolicValues . . . 237
Tables
1. UltriumProductComparison. . . 7
2. . . 12
3. SpecialFilesforIBM3580TapeDevice 22 4. SpecialFiles . . . 23
5. ErrorDescription . . . 52
6. IBMTapeandMediumChangerDriversfor HP-UX(ATDD)andHP-UXSystem . . . . 70
7. SpecialFiles . . . 87
8. Device-SpecificParameterDefinitions. . . . 91
9. Driver-SpecificParameterDefinitions . . . . 92
10. ProblemsandSolutions . . . 95
11. ComponentsCreatedDuringIBMtape Installation . . . 122
12. ComponentsCreatedDuringIBMtapeutil Installation . . . 122
13. SpecialFilesforIBMUltriumTapeDevices 135 14. IBMtapeComponents. . . 161
15. IBMtapeInstallorUpdate . . . 162
16. EquipmentListing. . . 163
17. EquipmentListing. . . 167
18. EquipmentListing. . . 167
19. SampleEquipmentListing . . . 168
20. IBMSCSITape/MediumChangerSpecial FilesforSolaris. . . 176
21. TracingFacility. . . 181
©CopyrightIBMCorp. 2000,2003
xi
| ||
Preface
Thispublicationprovides programmingreferenceinformationforIBM® Ultrium™
tapedrive,mediumchanger,and librarydevicedrivers.
Related
Information
Thefollowingsectionscontainlistsofsources thatyoumayneedforinformation
relatedtotheIBMUltrium tapedrive,mediumchanger,andlibrarydevicedrivers.
IBM
TotalStorage
®Ultrium
External
Tape
Drive
3580
ThefollowingpublicationsrelatetotheIBM TotalStorageUltrium ExternalTape
Drive 3580:
v IBM3580UltriumTapeDriveSetup,Operator,andServiceGuide,GA32-0415
IBM
TotalStorage
Ultrium
Tape
Autoloader
3581
Thefollowingpublication relatestotheIBM TotalStorageUltrium TapeAutoloader
3581:
v IBM3581UltriumTapeAutoloaderSetup,Operator,and ServiceGuide, GA32-0412
IBM
TotalStorage
Ultrium
Tape
Library
3582
ThefollowingpublicationsrelatetotheIBM TotalStorageUltrium TapeLibrary
3582:
v IBMTotalStorageUltriumTape Library3582Setup,Operator,andServiceGuide, GA32-0458
IBM
TotalStorage
Ultrium
Scalable
Tape
Library
3583
ThefollowingpublicationsrelatetotheIBM TotalStorageUltrium ScalableTape
Library 3583:
v IBM3583UltriumScalableTape LibrarySetupandOperatorGuide,GA32-0411 v IBM3583UltriumScalableTape LibraryServiceGuide, GA32-0425
v IBMStorageAreaNetwork DataGatewayModuleSetup,Operator,andServiceGuide, GA32-0436
IBM
TotalStorage
UltraScalable
Tape
Library
3584
ThefollowingpublicationsrelatetotheIBM TotalStorageUltraScalableTape
Library 3584:
v IBM3584UltraScalableTapeLibraryPlanningandOperatorGuide, GA32-0408 v IBM3584UltraScalableTapeLibraryMaintenance Information,19P2440
Other
Publications
IBM StorageAreaNetwork DataGateway Installationand User’sGuide,SC26-7304
Additional
Information
SpecialPrintingInstructions:
ThisSCSIDevice DriverManualcontains differentsectionsforeachtypeof
operatingplatform,forexample,AIX®,HP-UX,Linux,SunSolaris, andWindows®.
Note: Whenselectingthepagerangeforthesectionyouwishtoprint,notethat
theprintpagerangeisbasedonthepagecontrolsforAdobeAcrobat,not
thepageprintedontheactualdocument.EntertheAdobepagenumbersto
print.
Ifyouwishtoprintoneormoreseparatesectionsofthemanual,followthese
steps:
1. Navigatetothebeginningof thesection andnotethepagenumber.
2. Navigatetothelastpageinthesection andnotethatpagenumber.
3. SelectFile—>Print,then choose″Pages″and enterthepagerangeforthe
section.Onlythepagerangeenteredwillprint.
4. Repeatthesestepstoprintadditionalsections.
Important printer note
This area indicates the
pages that will actually
print in your specified
range of pages.
Ignore the page number
appearing on the page itself
when entering page ranges
for your printer.
Attention: ThereisonlyoneTableofContents andoneIndexforthisentirebook.
Ifyouwishtoprintthoseitems,youmust repeattheprocessabove,entering the
pagerangeoftheTableofContents andtheIndexpagerange, respectively.
The followingpublicationscontainadditionalinformationthattorelatestotheIBM
Ultrium tapedrive,mediumchanger,andlibrarydevicedrivers:
v IBMUltriumDeviceDrivers:ProgrammingReference, GC35-0483. v AmericanNationalStandardsInstituteSmallComputerSystemInterface
X3T9.2/86-109X3.180, X3B5/91-173C,X3B5/91-305,X3.131-199XRevision10H,
How
to
Send
Your
Comments
Yourfeedbackisimportantinhelpingtoprovidethemostaccurateandhighest
qualityinformation.Ifyouhavecomments orsuggestionsforimprovingthis
publication,youcansenduscomments electronicallyusingtheseaddresses:
v Internet:STARPUBS@us.ibm.com(orSTARPUBSat us.ibm.com)
v IBMLink™fromU.S.A.: STARPUBSatSJEVM5
v IBMLinkfromCanada:STARPUBSat TORIBM
v IBMMailExchange:USIB3VVDat IBMMAIL
Summary
of
Changes
Thissummaryofchangesincludesspecificrelease updatestothispublication.
Eleventh
Edition
(October
2003)
Thisreleaseincludesthefollowingnewinformation:
v LibraryPathFailoverinformationforLinux
v InformationregardingIBMEserver pSeries® serversupport
Tenth
Edition
(June
2003)
Thisreleaseincludesthefollowingnewinformation:
v DataPathFailoverinformation
Ninth
Edition
(April
2003)
Thisreleaseincludesthefollowingnewinformation:
v IBMTotalStorageUltrium TapeLibrary 3582
Eight
Edition
(January
2003)
Thisreleaseincludesthefollowingnewinformation:
v IBMTotalStorageUltraScalableTape Library3584mediumchangerAIXfailover
v UltriumGeneration2support
Fifth
Edition
(March
2002)
Thisreleaseincludesthefollowingnewinformation:
v SupportforLinuxoperatingsystems.
v Supportfornew hostbusadaptercards,operatingsystemreleases,and
enhancementstothedevicedrivers.
v Thisrelease alsoincludeschangestocorrecterrorsoromissionsintheprevious
editions.
Fourth
Edition
(September
2001)
Thisreleaseincludesthefollowingnewinformation:
v SupportforLinuxoperatingsystems.
v Supportfornew hostbusadaptercards,operatingsystemreleases,and
enhancementstothedevicedrivers.
v Thisrelease alsoincludeschangestocorrecterrorsoromissionsintheprevious
editions.
Third
Edition
(July
2001)
Thisreleaseincludesthefollowingnewinformation:
v Supportfornew hostbusadaptercards,operatingsystemreleases,and
enhancementstothedevicedrivers.
©CopyrightIBMCorp. 2000,2003
xvii
| | | |
v Thisrelease alsoincludeschangestocorrecterrorsoromissionsintheprevious editions.
Second
Edition
(March
2001)
Part
1.
Introduction
to
IBM
Ultrium
Device
Drivers
Chapter
1.
Ultrium
Device
Drivers
Thispublicationdescribes theIBM TapeandMediumChangerDevice Driversfor
thefollowingdevices:
v “IBMTotalStorage UltriumExternal TapeDrive 3580”onpage6
v “IBMTotalStorage UltriumTapeAutoloader3581” onpage6
v “IBMTotalStorage UltriumTape Library3582” onpage6
v “IBMTotalStorage UltriumScalableTapeLibrary 3583”onpage6
v “IBMTotalStorage UltraScalableTapeLibrary 3584”onpage7
v “StorageSmart™byIBMUltrium Products”onpage7
OnAIX, HP-UX,Linux,Solaris,and Windowsoperatingsystems.
Purpose
TheIBM Ultriumtapeandmediumchangerdevicedriversare designed
specificallytotakeadvantageof thefeaturesprovidedbytheIBM Ultriumtape
drives andmediumchangerdevices.Thegoal istogive applicationsaccesstothe
functionsrequiredforbasictapefunctions(suchasbackupand restore)and
medium changeroperations (suchascartridgemountanddemount),aswellasto
theadvancedfunctionsneededbyfulltapemanagement systems.Whenever
possible,thedriverisdesignedtotakeadvantageofthedevicefeatures
transparent totheapplication.
Platform
Support
Part2, “AIXTapeand MediumChangerDeviceDriver,”onpage9 describesthe
installationand configurationoftheAIXEnhancedTape andMediumChanger
Device DriverforIBM Ultriumproducts.
Part4, “HP-UXTape andMediumChangerDeviceDriver,”onpage67describes
theinstallationand configurationoftheHPEnhancedTape andMediumChanger
Device DriverforIBM Ultriumproducts.
Part5, “LinuxTape andMediumChangerDeviceDriver,”onpage109describes
theinstallationand configurationoftheLinuxEnhancedTapeand Medium
ChangerDevice DriverforIBMUltrium products.
Part6, “SolarisTapeandMediumChangerDevice Driver,”onpage155 describes
theinstallationand configurationoftheSolaris TapeandMediumChangerDevice
Driver forIBMUltrium products,alsoknown asIBMtape.
Part7, “MicrosoftWindowsTapeDevice Drivers,”onpage191 describesthe
installationand configurationofMicrosoft®Windows-basedTape andMedium
ChangerDevice DriversforIBM Ultriumproducts.
Informationinthe“Appendixes”coversaccessingupdateddrivers,microcode,and
documentationonline.ItalsoaddressesattachmenttestingofIBMUltrium devices
tothehostcomputer.
Introduction
The IBMUltriumproductfamilyprovides anexcellentsolutionforcustomerswith
smalltolargestorageand performancerequirements.
Figure1 onpage5 illustratestheattachmentofvariousUltriumproductstoan
opensystemsserver.
Thefollowingare theUltrium DeviceDriverattachments:
v 1OpenSystemsServer
v 2IBMTotalStorage UltriumExternal TapeDrive3580
1 2 3 4 5 a2501 14 6
Figure1.AttachmentArray
Ultrium
Device
Driver
v 3IBMTotalStorage UltriumTapeAutoloader3581
v 4IBMTotalStorage UltriumTape Library3582
v 5IBMTotalStorage UltriumScalableTapeLibrary 3583
v 6IBMTotalStorage UltraScalableTapeLibrary 3584
Figure2 illustratesanUltriumenvironmentthatcould includeanIBM3583
Ultrium ScalableTape Libraryand anIBM3584UltraScalableTapeLibrary.
IBM
TotalStorage
Ultrium
External
Tape
Drive
3580
The IBMTotalStorageUltrium ExternalTapeDrive 3580isastandalone,large
capacity,highperformance tapedrivethatadherestotheLinearTape-Open (LTO)
specifications andsupportstheIBMUltriumformattape.Thedrivesupports
native tapecapacitiesofup to200GBwithuncompresseddatatransfer ratesofup
to35MB persecond.WithbothLowVoltageDifferential (LVD)Ultra-2SCSI and
HighVoltageDifferential(HVD)UltraSCSI attachments,thisdeviceissuitablefor
a varietyof save,restoreandarchivingrequirementsforPCand OpenSystems
platforms.
IBM
TotalStorage
Ultrium
Tape
Autoloader
3581
The IBMTotalStorageUltrium TapeAutoloader3581isanexternal,standaloneor
rack-mountedtapeautoloaderthatincorporatesoneIBMUltrium TapeDrive.The
autoloaderhassevenstorageslotsgivingtheautoloaderupto1,400GBof
uncompresseddatastorage.Theautoloadercanbeusedwithcompatiblesoftware
applicationstoautomate backup/recoveryorotherdatastorageactivities.
IBM
TotalStorage
Ultrium
Tape
Library
3582
The IBMTotalStorageUltrium TapeLibrary 3582isanentrytapelibrary
incorporatinghigh-performance IBMTotalStorageUltrium generation2Tape
Drivesforthemidrangeopensystemsenvironment.Itcanaccomodateoneortwo
Ultrium generation2Tape Drivesand comesstandardwith aone-cartridgeI/O
stationand 23datacartridgeslotsgivinganativelibrarycapacityof4.8TB
uncompressednativestorage.
IBM
TotalStorage
Ultrium
Scalable
Tape
Library
3583
The IBMTotalStorageUltrium ScalableTape Library3583isanautomatedtape
librarythatincorporatesIBMUltriumtapedrivesineither astandaloneor
optional rackmountconfiguration.Threedifferentlibrarymodelsareavailable
with storagecapacitiesof 18through72slotsandonetosix Ultriumtapedrives.
Figure2.ExampleofanUltriumEnvironment
Ultrium
Device
Driver
TheIBM TotalStorageUltrium ScalableTape Library3583canbeusedforsave,
restoreand massstoragearchiveswheremultiterrabytecapacities arerequired.
IBM
TotalStorage
UltraScalable
Tape
Library
3584
TheIBM TotalStorageUltraScalableTape Library3584providesa highlyscalable
midrange tapelibrarythatsupportslogicalpartitioning(multipatharchitecture)
and canhouseupto192IBM Ultriumtapedrives.Withscalabilityofoneto
sixteeenframes,thislibraryprovidesnativestoragecapacityfrom28TBto1,376
TB witha widerangeofhost attachmentconfigurations.
StorageSmart
™by
IBM
Ultrium
Products
TheStorageSmart byIBM UltriumfamilyofproductsiscompatiblewiththeIBM
brandedversions oftheUltriumfamilyproducts.Inthismanual,wherethereisno
specific mentionoftheStorageSmartbyIBMUltriumbrandedset ofproducts,the
documentationpertainingtotheIBMbrandedfamilyof productsshouldbe used.
Thefollowingtable crossreferencestheStorageSmartbyIBMUltriumproductset
totheIBM Ultriumproductset.
Table1.UltriumProductComparison
StorageSmartbyIBMUltrium IBMVersionofUltrium
StorageSmartbyIBMUltriumExternalTape DriveTX200
IBMTotalStorageUltriumExternalTape Drive3580
StorageSmartbyUltriumTapeAutoloader SL7
IBMTotalStorageUltriumTapeAutoloader 3581
StorageSmartbyUltriumScalableTape LibrarySL72
IBMTotalStorageUltriumScalableTape Library3583
NoequivalentintheIBMUltriumproduct set
IBMTotalStorageUltraScalableTapeLibrary 3584
Ultrium
Device
Driver
Part
2.
AIX
Tape
and
Medium
Changer
Device
Driver
Chapter
2.
Introduction
and
Product
Requirements
ThischapterdescribestheIBMAIXEnhancedTapeand MediumChangerDevice
Driver forthefollowingUltrium products:
v IBMTotalStorageUltrium ExternalTape Drive3580
v IBMTotalStorageUltrium TapeAutoloader3581
v IBMTotalStorageUltrium TapeLibrary 3582
v IBMTotalStorageUltrium ScalableTape Library3583
v IBMTotalStorageUltraScalableTape Library3584
Purpose
TheIBMAIXEnhancedTapeandMediumChangerDevice Driverisdesigned
specificallytotakeadvantageof thefeaturesprovidedbytheIBM Ultriumtape
drives andmediumchangerdevices.Thegoal istogive applicationsaccesstothe
functionsrequiredforbasictapeoperations,suchasbackupandrestore,and
medium changeroperations,suchasmountanddemount thecartridges,aswellas
totheadvancedfunctionsneededbyfulltapemanagementsystems.Whenever
possible,thedriverisdesignedtotakeadvantageofthedevicefeatures
transparent totheapplication.
Data
Flow
Thesoftware describedinthischaptercoverstheAIXEnhancedDeviceDriver
(Atape devicedriver)and theinterface betweentheapplication andthetape
device.Figure3illustratesa typicalUltriumdataflowprocess.
Product
Requirements
Thefollowingsoftware andhardwarecomponentsarerequiredtousethetape
devicedriver.
Software
Requirements
TheAIXEnhancedDevice Driver(Atapedevicedriver)supportsthefollowingAIX
operatingsystem levelsforoperationof IBMUltriumtapedrivesandautomation
products:
v AIX4.3.3(dependentonthehostbusadapterbeingused).AIX4.3.3requires
AIXAPARIY17356.See“HardwareRequirements”onpage12.
v AIX5L™Versions5.1and5.2onPOWER-basedservers
Note: TheAtape devicedriversupportsAIXVersion4.3.3(andlaterreleases)inan
MPSafe(multiprocessing)mode.
Figure3.DataFlowProcess
Library
Control
Path
Failover
Support
Inordertousealternatepathingsupport,thefollowingfeaturecodes arerequired
for theassociatedmachine type:
Table2.
MachineType FeatureCode
3582 FC1680
3583 FC1680
3584 FC1680
Hardware
Requirements
TheAtapedevicedriversupportsthefollowingIBM Ultriumtapedrives and
automation products:
v Oneormore ofthefollowingIBM Ultriumtapedevices:
– IBM TotalStorageUltrium ExternalTapeDrive 3580
– IBM TotalStorageUltrium TapeAutoloader3581
– IBM TotalStorageUltrium TapeLibrary3582
– IBM TotalStorageUltrium ScalableTape Library3583
– IBM TotalStorageUltraScalableTapeLibrary 3584
v Oneormore ofthefollowingIBM RS/6000®orpSeriesSCSIhostbusadapters:
– PCIDualChannelUltra-3SCSIAdapter(LVD)(RS/6000orpSeriesFC6203),
AIX4.3.3andlater.
– PCIDifferentialUltra SCSIAdapter (HVD)(RS/6000orpSeriesFC6207)
– PCIUniversalDifferential UltraSCSIAdapter(HVD)(RS/6000orpSeriesFC
6204),AIX4.3.3andlater
– IntegratedLVDport-RS/6000orpSeries7044Models170 and270,AIX4.3.3
and later,IBM3580,3581,and3583only
– PCIDualChannelUltra-2SCSIAdapter(LVD)(RS/6000orpSeriesFC6205),
AIX4.3.3andlater
v Oneormore ofthefollowingIBM RS/6000or pSeriesFC-ALhost busadapters:
– GigabitFibreChannelAdapter (PCI)(RS/6000orpSeriesFC6227)
– TheGigabitFibreChannelAdapter for64–bitPCIbus(RS/6000orpSeriesFC
6228)
– TheIBM 2108–G07(IBMSANDataGateway)and IBM2108–R03(IBM SAN
Data GatewayRouter)canbeusedtoattachSCSI modelsoftheIBMUltrium
familyofproductswithanyofthesupportedFC–ALhostbusadapters.
Attention: Usinga singleFibreChannelhost busadapter(HBA)forconcurrent
tapeanddiskoperations isnotrecommended.Tape anddiskdevicesrequire
incompatibleHBAsettingsfor reliableoperationandoptimal performance
characteristics.Understressconditions (highI/Oratesfortape, disk,orboth)
where diskandtapesubsystemssharea commonHBA,stabilityproblemshave
been observed.Theseissuesare resolvedbyseparatingdiskand tapeI/Ostreams
ontoseparate HBAsand usingSANzoningtominimizecontention.IBMisfocused
onassuringserverandstorageconfigurationinteroperability.Itstrongly
recommends thatyourimplementationplanincludesprovisionsforseparatingdisk
and tapeworkloads.
Chapter
3.
Tape
Drive,
Media,
and
Device
Driver
Parameters
Thischapterdescribestheparametersthatcontroltheoperatingmodesofthetape
drive,media,and devicedriver.
Configuration
Parameters
Theoperatingparametersforthetapedriveand devicedrivercanbe setand
changed bytheconfigurationprocedures.Theinstallationdefaults areprovidedfor
all parametersinitially.TheAIXsmitcommandcanbeusedtosettheseparameters
whenconfiguringadeviceortochange theseparameters.TheAIXchdev command
canalso beusedtochangetheconfigurationparameters.
Theconfigurationparametersareusedtosettheoperatingmodeofthetapedrive
and devicedriverwhenadeviceisopened.Theseparameterscanbequeriedbyan
application. Someparameterscanbe changedtemporarilyduringtheopen
subroutinebyanapplication,buttheyarealways restoredtotheconfiguration
valueswhena deviceisclosed.Theconfigurationparametersare:
v Autoloading
v Blocksize
v Compression
v Logging
v Maximumsizeofthelogfile
v Recordspacemode
v Rewindimmediate
v Trailerlabels
Autoloading
Thisparameterenablestheautoloading featureofthedevicedriver.Itcanbeused
whenone IBM3580UltriumTape DriveisinstalledinanIBM3581UltriumTape
Autoloaderoran IBM3583UltriumScalableTapeLibrary. Thisfeature allows
multivolume backups(withcommandssuchastar)withoutprompting fora
volume change.
Note:Theautoloading featureisnotsupportedontheIBM3584UltraScalableTape
Library andtheIBM3583Ultrium ScalableTape Librarywithmore thanoneIBM
3580Ultrium TapeDrive installed.
Donotenableautoloadingifone ofthefollowingconditions istrue:
v Thedeviceisusedbyanapplicationthatprovideslibrarymediumchanger
supportfortheIBM3581orIBM3583.
v TheapplicationisMKSYSB.
v Thetapesbeingread werenotwrittenusingtheautoloadingfeature.
IftheparameterissettoOn, thetapesintheattachedmedium changerslotsactas
onelargevirtual tape.Duringaread, write,orforwardspacefileoperation,noendof
tapeisdetectedbytheapplication.Whentheendoftapeisreached,thedevice
driverautomaticallyrewindsandunloadsthetape,moves thetapebackintothe
library,loadsthenext tapefromthelibrary,thencontinuesreadingorwritingthe
next tape.
The followingconditions arerequiredtouseautoloading:
v Theautoloadingparametermustbe settoOn.
v Thelibrarymust beloaded withoneormoretapes.
v Thelibrarymodemustbe settoRandommode.
The installationdefaultisOff (noautoloading).
Block
Size
Thisparameterspecifies theblocksizeusedforread andwriteoperations.Avalue
of 0isthevariable blocksize.Anyothervalueisafixed blocksize.
The installationdefaultis0 (usevariable length).
Compression
Hardwarecompressionisimplemented inthedevicehardware.Thisparameter
turnsthecompressionfeatureOn andOff.Ifcompressionisenabled,theeffective
performance canincreasebased onthecompressibility ofthedata.
The installationdefaultisOn (usecompression).
Logging
ThisparameterturnsthevolumeinformationloggingOnandOff. Ifloggingisset
toOn, thestatisticalinformationaboutthedeviceandmedia issavedinalogfile
when atapeisunloaded.Ifloggingisset toOff,theinformationisnotsaved.This
parameter hasnoeffectonerrorloggingbecauseerrorloggingisalwaysenabled.
For moreinformation,seeChapter12,“Deviceand VolumeInformationLogging,”
onpage53.
The installationdefaultisOff (nologging).
Maximum
Size
of
the
Log
File
Thisparameterspecifies thenumber ofentriesmadebefore thelogfilestartsto
wrap.Eachentryisapproximately2 KB(2048bytes).Afterthelogfilestartsto
wrap,thenumberofentriesremainsconstant.Eachtimeanew entryismade,the
oldest entryisoverlaid.Formore information,seeChapter12,“DeviceandVolume
InformationLogging,”onpage53.
The installationdefaultis500.
Record
Space
Mode
Thisparameterspecifies howthedevicedriveroperateswhenaforwardor
backward spacerecordoperationencountersafilemark.Thetwomodesof
operationare SCSIandAIX.
The SCSImodeisthedefaultmodeofoperation.Whenaforwardorbackward
spacerecordoperationisissuedtothedriveranda filemarkisencountered, the
devicedriverreturns-1and theerrnovariableissetto input/outputerror(EIO).
Thetapeisleft-positionedafter thefilemark(theend-of-tapesideofthefilemark
ontheforwardspaceand thebeginning-of-tapesideofthefilemarkonthe
backward space).
TheAIXmodereturnsthesameEIOerrnovalue astheSCSI modewhena filemark
isencountered,exceptthatthetapeisleft-positionedbefore thefilemark(the
beginning-of-tapesideofthefilemarkontheforwardspaceandtheend-of-tape
sideof thefilemarkonthebackwardspace).
Theinstallation defaultisSCSI mode.
Rewind
Immediate
ThisparameterturnstheimmediatebitOn andOff inrewindcommands.Ifitis
set toOn,therewindtapeoperationexecutesfaster,butthenext commandtakesa
longtimetofinishunlesstherewindoperationisphysicallycomplete.Settingthis
parameter reducestheamountoftimethatittakestocloseadevicefora Rewind
onClosespecialfile.
Theinstallation defaultisOff (norewindimmediate).
Trailer
Labels
Ifthis parameterissettoOn,writinga recordpasttheearlywarningmarkonthe
tapeisallowed.Thefirstwriteoperationtodetectendofmark(EOM)failsandthe
errno variableissettoENOSPC.Nodataiswritten duringtheoperation.All
subsequent writeoperationsare allowedtocontinueuntilthephysicalendofthe
volume isreachedand EIOisreturned.
Thisparametercanalsobe selectedusingoneof threedevicespecialfiles that
allowtrailerlabelprocessing.Thespecial filesarermtx.40, rmtx.41,andrmtx.60,
where xisthenameofthedevice(forexample,rmt0.40).
Theinstallation defaultisOff (notrailerlabels).
Media
Parameter
Themedia parametercanbequeriedand setbythetapeutilapplicationusingthe
Query/Set Parametersoption onthemenu.Thisparametercannotbe setor
changed bytheconfigurationprocedures.Themedia parameteris:
v VolumeIDforlogging
ThisparameteristhevolumeIDofthecurrentlyloaded tape.Itisusedinthelog
fileentry(if volumeloggingisactive)toidentifytheentrywitha particular
volume. ThedevicedriversetsthevolumeIDtoUNKNOWNinitially andwhen
thetapeisunloaded.
AIX
Device
Driver
(Atape)
Chapter
4.
Installation
and
Configuration
Instructions
Therecommended procedureforinstallingand configuringthedevicedriveristo
usetheinstallationscriptprovidedontheOpenSystemsDevice DriverCD.
However, beforethis isdone,youneedtophysicallyattachthedeviceto the
server.Consulttheappropriatemanualsforinstructionsonphysicallyattachingthe
tapedevicetotheserver.
Instructionsforuninstallingthedevicedriverareoutlinedbelowin“Uninstallation
Procedure” onpage20.
Attention: Attheendoftheinstallationprocedure,theinstallpfacilitywill
automaticallyruntheAIXbosbootcommandtoupdatetheboot recordwiththe
newlyinstalledAtapefiles.Whenthebosbootcommandcompletes,thefollowing
messages willbe displayed:
0503-292 This update will not fully take effect until after a system reboot.
installp: bosboot process completed.
Thismessageisreferringtotheupdatestotheboot recordonly.Iftheinstallation
summaryshowsthattheAtapedriverwasinstalledsuccessfully,itisnotnecessary
toreboot themachineatthistime.
Iftheinstallationsummaryshowsthattheinstall failed,youshouldreboot the
machine andattempttoinstalltheAtapedrivera secondtime.
Installation
Procedure
For informationonobtainingthelatestversionofdevicedriversandthelatest
documentation, seeAppendixA, “AccessingDocumentationand SoftwareOnline,”
onpage245.
Preinstallation
Considerations
Before proceedingwiththeinstallation,makesureofthefollowingitems:
1. Thetapedeviceisproperlyfunctioning,properlyattachedtotheserver,andis
poweredup.
2. Youhaveloggedontotheserveronanaccountwhichhasrootauthority.
3. Youhaveacommandshellwindowopenontheservertoperformthe
installationprocedure.
4. MakesurethecurrentpathisdefinedinthecommandshellPATHvariable.
Thiscanbeaccomplishedinthekornshellusingthefollowingcommand:
EXPORT PATH=.:$PATH
5. Ifthetapedevicewas configuredpreviouslybyanotherdevicedriver(not
Atape),removeanyexistingdevicedefinitionsforit.For example,’rmdev -l
rmt1 -d’.
Installation
Procedure
Enterthefollowingcommandto listthecurrentlyinstalledAtape.driverversion:
lslpp -l Atape.driver
IfyouhavetheIBMUltriumDevice DriversCD,usethefollowinginstructions to
install andconfigurethedevicedriver:
1. For aninstalledAtapedevicedriver,deconfigureallexistingtapedevices that
usetheAtapedriverbyfollowingtheinstructionsshown in“Deconfiguring
Tape Devices”onpage19or“DeconfiguringMediumChangerDevices” on
page20.
2. PlacetheCDintotheCD-ROMdriveonyourAIXsystem.
3. MounttheCDoveranemptydirectory. Forexample,ifyour CD-ROMdriveis
definedat/dev/cd0andyouhavean emptydirectoryat /cdrom,issue the
followingcommandtomounttheCD:
mount -frv cdrfs /dev/cd0 /cdrom
Youcancreateanemptydirectory usingthemkdircommand,forexample:
mkdir /cdrom
Subsequentinstructionsassumethatyoumounted theCDat mountpoint
/cdrom.
4. Enterthefollowingcommand:
cd /cdrom/AIX
5. ConsulttheAtape.ReadmefileontheCD foranyimportantinformation
pertainingtothedevicedriver.Informationinthisfiletakesprecedence over
informationinthemanual.
6. Executetheinstall_atapescript.Thisscript uninstallsanypreviousversionsof
Atape,installsandcommitsthelatestversionofAtape,then runscfgmgrto
defineyourdevices.
7. Enterthefollowingcommands:
cd /
unmount /cdrom
8. RemovetheCDfromtheCD-ROMdriveandstore itinasafeplace.
IfyouhavetheAtapedevicedriveronadiskette,usethefollowinginstructions to
install andconfigurethedevicedriver:
1. For aninstalledAtapedevicedriver,deconfigurealldefineddevicesby
followingtheinstructionsin“DeconfiguringTapeDevices”onpage19or
“DeconfiguringMediumChangerDevices”onpage20anduninstalltheAtape
driver.UninstalltheAtapedriverbyfollowingtheinstructionsshown in
“UninstallationProcedure”onpage20.
2. PlacethedisketteintothediskettedriveonyourAIXsystem.Thefollowing
stepsassumethatyour diskettedriveisdefinedas/dev/rfd0.
3. Enterthefollowingcommand:
installp -acXd /dev/rfd0 Atape.driver
ThisinstallsandcommitstheAtapedriveronyoursystem.
4. Removethediskettefromthediskettedriveand storeitina safeplace.
5. Followtheinstructionsin“ConfiguringTapeand MediumChangerDevices”
onpage19.
Configuring
Tape
and
Medium
Changer
Devices
Afterthedriversoftwareisinstalledand atapedeviceisconnectedtotheadapter,
thedevicecanbeconfigured andmadeavailableforuse.Accesstothedeviceis
notprovideduntil thedeviceisconfigured.
Note: Ifthetapedevicewasconfigured previouslybyanotherSCSIdevicedriver,
suchasOST(Other SCSITape),issuethefollowingcommandtoremovethe
devicedefinitionbeforeperformingthefollowingsteps:
rmdev -l [device]
Configurea tapedeviceusingoneofthefollowingprocedures:
v Enterthefollowingcommandwithnoparameters:
cfgmgr
Thecommandconfigures alldevicesautomatically(includinganynewtapeor
mediumchangerdevices).
or
v PowerOff yoursubsystemandreboot thesystemtoconfigureitautomatically
andmakeavailable anynewtapeormediumchangerdevicesonthesystem.
Deconfiguring
Tape
Devices
Inthefollowingexamples,replacetheletter nwiththeappropriatenumberforthe
chosendevice.
Deconfigurethetapedeviceusingoneofthefollowingprocedures:
v Thefirstmethodleavesthetapedevicedefinedintheconfigurationdatabase.It
issimilartobringingthedeviceOffline(notinuse).
Enterthefollowingcommandtobringthe/dev/rmtntapedeviceOfflinebut
leaveitdefinedinthedevicedatabase:
rmdev -l rmtn
or
v ThesecondmethodbringsthetapedeviceOfflineand removesitsdefinition
fromthedevicedatabase.
Enterthefollowingcommand:
rmdev -l rmtn -d
Thedevicedriverisnotunloadedfromthekerneluntilthelastdeviceis
deconfigured.