• No results found

Installation and User s Guide

N/A
N/A
Protected

Academic year: 2021

Share "Installation and User s Guide"

Copied!
289
0
0

Loading.... (view fulltext now)

Full text

(1)

IBM

Ultrium

Device

Drivers

Installation

and

User’s

Guide

GA32-0430-07

(2)
(3)

IBM

Ultrium

Device

Drivers

Installation

and

User’s

Guide

GA32-0430-07

(4)

Note!

Beforeusingthisinformationandtheproductthatitsupports,besuretoreadthegeneralinformationunderAppendixD, “Notices,”onpage259.

EleventhEdition(October2003)

ThiseditionoftheIBMUltriumDeviceDriversInstallationandUser’sGuide,GA32-0430-07obsoletesandreplaces GA32-0430-06.Changesoradditionsareindicatedbyaverticallineintheleftmargin.

©CopyrightInternationalBusinessMachinesCorporation2000,2003.Allrightsreserved.

(5)

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

(6)

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. . . 72

SoftwareInterfacetotheDeviceDriver . . . 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. . . 89

Chapter

20.

Configuration

Parameter

Definitions

.

.

.

.

.

.

.

.

.

.

.

.

. 91

(7)

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 . . . 130

AutomaticallyRetrieveaDriveDump . . . . 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

| || || || | | | | | | | | | | |

(8)

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 . . . 153

ForceDriveDump . . . 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

| || || || || || ||

(9)

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® . . . 194

Windows2000andWindowsServer2003 . . . . 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 . . . 236

DeviceDriverDiagnosisInformation(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

(10)
(11)

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

(12)
(13)

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

| ||

(14)
(15)

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:

(16)

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,

(17)

How

to

Send

Your

Comments

Yourfeedbackisimportantinhelpingtoprovidethemostaccurateandhighest

qualityinformation.Ifyouhavecomments orsuggestionsforimprovingthis

publication,youcansenduscomments electronicallyusingtheseaddresses:

v Internet:STARPUBS@us.ibm.com(orSTARPUBSat us.ibm.com)

v IBMLinkfromU.S.A.: STARPUBSatSJEVM5

v IBMLinkfromCanada:STARPUBSat TORIBM

v IBMMailExchange:USIB3VVDat IBMMAIL

(18)
(19)

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

| | | |

(20)

v Thisrelease alsoincludeschangestocorrecterrorsoromissionsintheprevious editions.

Second

Edition

(March

2001)

(21)

Part

1.

Introduction

to

IBM

Ultrium

Device

Drivers

(22)
(23)

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 “StorageSmartbyIBMUltrium 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.

(24)

Introduction

The IBMUltriumproductfamilyprovides anexcellentsolutionforcustomerswith

smalltolargestorageand performancerequirements.

Figure1 onpage5 illustratestheattachmentofvariousUltriumproductstoan

opensystemsserver.

(25)

Thefollowingare theUltrium DeviceDriverattachments:

v 1OpenSystemsServer

v 2IBMTotalStorage UltriumExternal TapeDrive3580

1 2 3 4 5 a2501 14 6

Figure1.AttachmentArray

Ultrium

Device

Driver

(26)

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

(27)

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

(28)
(29)

Part

2.

AIX

Tape

and

Medium

Changer

Device

Driver

(30)
(31)

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 AIX5LVersions5.1and5.2onPOWER-basedservers

Note: TheAtape devicedriversupportsAIXVersion4.3.3(andlaterreleases)inan

MPSafe(multiprocessing)mode.

Figure3.DataFlowProcess

(32)

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.

(33)

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

(34)

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).

(35)

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)

(36)
(37)

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’.

(38)

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.

(39)

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.

AIX

Device

Driver

(Atape)

References

Related documents

[18] Ghulam A, Shaikh AW, Rehman A, Shaikh ZA, A framework for development of cost- effective irrigation control system based on Wireless Sensor and Actuator

En esta misma línea, Hans Belting desarrolla una antropología en la que las imágenes son sus artefactos de estudio convirtiéndose, por tanto, en objetos de conocimiento (2012, p.

Duties included administration of Center programs, taught undergraduate and graduate courses in business communication; directed college-wide Business Writing Requirement

Selection table Sensing range s n mm Installation in metal. Connection

Figure 42 and Figure 43 show low speed, low torque and high speed, high torque graphs of the pressure trace and rate of heat release (ROHR) curves for the ethanol-diesel fuel

In recent years, genome-wide association studies have identified a few susceptibility loci for the renal complications as well as for diabetic retinopathy, diabetic

total cost of mass deportation and continuing border interdiction and interior enforce- ment efforts would be $285 billion (in 2008 dollars) over five years. Specifically, this

Dit onderzoek kijkt naar de relatie van public service motivatie (PSM) op job performance, in welke mate veranderbereidheid deze relatie medieert en wat de invloed is van PSM-fit