US Robotics 7931 Guide de l'utilisateur

Sun Microsystems, Inc.www.sun.comSubmit comments about this document at: http://www.sun.com/hwdocs/feedbackSun StorageTek™Storage Archive Manager (SAM

x Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Example recycler.cmd File 156▼ To Run the Recycler 15

76 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07When you use the –drives parameter, multiple drives

Chapter 3 Archiving 77Maximizing Space on a Volume: -fillvsnsBy default, the archiver selects from all volumes assigned to an archive set when itwrite

78 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Making Archive Copies of Offline Files: -offline_cop

Chapter 3 Archiving 79Associative Archiving: -join pathThe archiver employs associative archiving if you specify the -join pathparameter. Associative

80 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07It is also possible to sort files within an archive

Chapter 3 Archiving 81Assume that a patient is in the hospital for four weeks. During this time, all of thispatient’s files are on fast media (copy 1=

82 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Note – The -reserve parameter is intended to reserve

Chapter 3 Archiving 83 File system form – The fs keyword specifies the file system component in thereserved name.TABLE 3-19 shows examples.In the arc

84 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07As CODE EXAMPLE 3-28 shows, the lines in the library

Chapter 3 Archiving 85Setting Archive Priorities: -priorityThe Sun StorageTek SAM file systems offer a configurable priority system forarchiving files

Contents xi▼ To Edit the mcf Files 173▼ To Define a Sun SAM-Remote Client 176▼ To Define a Sun SAM-Remote Server in the Server’s mcf File 176▼ To Crea

86 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07For value, specify a floating-point number in the fo

Chapter 3 Archiving 87The -startage, -startcount, and -startsize directives can be specified in anarchiver.cmd file for each archive copy. If more tha

88 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07An association requires at least three fields: archi

Chapter 3 Archiving 89When the archiver needs volumes for the archive set, it examines each volume of theselected media type in all automated librarie

90 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07A VSN pool is a named collection of volumes. VSN poo

Chapter 3 Archiving 91For more information on VSN associations, see “VSN Association Directives” onpage 87.About Disk ArchivingArchiving is the proces

92 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The following list summarizes some of the similariti

Chapter 3 Archiving 93Configuration GuidelinesAlthough there are no restrictions on where disk archive volumes can reside, it isrecommended that disk

94 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Beginning with version 4U6 of the software, disk arc

Chapter 3 Archiving 95For more information on directives for disk archiving, see the archiver.cmd(4)man page.Note – If you are using the disk volumes

xii Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Enable the Device Log by Editing the defaults.

96 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07b. Use the samd(1M) config command to propagate the

Chapter 3 Archiving 97CODE EXAMPLE 3-37 shows the diskvols.conf file that resides on client systempluto.CODE EXAMPLE 3-38 shows the diskvols.conf file

98 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Example 2In this example, file /sam1/testdir0/filea

Chapter 3 Archiving 99Example 3In this example, file /sam2/my_proj/fileb is on client host snickers in archiveset arset0.1, and the archiver copies th

100 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07 Save your archive logs. The archive logs provide

Chapter 3 Archiving 101You can assign different priorities to preview requests. You can override the FIFOdefault by entering directives in the preview

102 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Note – The archiver(1M) -lv command only shows VSNs

Chapter 3 Archiving 103CODE EXAMPLE 3-49 shows the files in the archive sets archived to the volumes in theindicated order.Example 2: Data Files Archi

104 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07CODE EXAMPLE 3-50 shows the content of the archiver

Chapter 3 Archiving 105Note – The archiver(1M) -lv command only shows VSNs with space available.CODE EXAMPLE 3-52 shows the organization of the file s

Contents xiiiSony Direct Attached 8400 PetaSite Automated Libraries 235▼ To Import Tapes 236Exporting Tapes 236▼ To Export a Tape Without Using the Ma

106 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Example 3: User and Data Files Archived toVarious M

Chapter 3 Archiving 107CODE EXAMPLE 3-54 shows the output of the archiver(1M) -lv -c command in thisexample.CODE EXAMPLE 3-54 archiver(1M) -lv -c Comm

108 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/0733: joe.1 mo optic01$34: pict.1 mo optic02$35: pict

Chapter 3 Archiving 109prod path:data copy:1 arch_age:60proj_1 path:projs/proj_1 copy:1 arch_age:60 copy:2 arch_age:60joe path:. uid:10

110 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Example 4: User and Data Files Archived toOptical M

Chapter 3 Archiving 111CODE EXAMPLE 3-55 shows the archiver.cmd file and archiver output.CODE EXAMPLE 3-55 archiver.cmd File and Archiver OutputReadin

112 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Notify file: /etc/opt/SUNWsamfs/scripts/archiver.sh

Chapter 3 Archiving 113users_pool media: mo Volumes: optic01 optic02 optic03 Total space available: 2.7GArchive sets:allsetsdata.1 reserve:/g

114 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07

115CHAPTER4ReleasingReleasing is the process by which the releaser makes disk cache space available byidentifying archived files and releasing their d

xiv Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07

116 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/072. Scans the file system and collects information a

Chapter 4 Releasing 117 Candidate – A candidate is a file that is eligible to be released. A file is not acandidate under the following circumstances

118 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07About Partial Releasing and PartialStagingReleasing

Chapter 4 Releasing 119 If the -o partial_stage=n option is set to the size of the partial release stub,the default behavior prevents the file from b

120 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07System Administrator Option SummaryAs system admini

Chapter 4 Releasing 121User Option SummaryAs system administrator, you can set maximum and default values for the size of afile stub that can remain i

122 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The following subsections describe the releaser.cmd

Chapter 4 Releasing 123By default, the age of a file is the more recent of the file’s three ages.In some cases, a simple age derived from the most rec

124 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07CODE EXAMPLE 4-2 shows lines in a releaser.cmd file

Chapter 4 Releasing 125The fs Directive: Specifying Directives forIndividual File SystemsYou can use the fs = family-set-name directive in the release

xvTablesTABLE 1-1 Automated Library Daemons 3TABLE 1-2 File System Manager Permission Levels 7TABLE 2-1 Arguments for samcmd(1M) load 15TABLE 2-2 Argu

126 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07These directives are helpful during debugging becau

Chapter 4 Releasing 127The releaser(1M) man page describes the information contained in the log file.Because the size of the log increases with each r

128 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The rearch_no_release Directive: InhibitingReleasin

Chapter 4 Releasing 129TABLE 4-3 shows archive set assignment values that pertain to releasing.For more information about these and the other archiver

130 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07However, most situations are not this straightforwa

Chapter 4 Releasing 131For example, to release files in the /sam1 file system until it reaches 47 percent full,log in as root and type the following:C

132 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07

133CHAPTER5StagingStaging is the process of copying file data from nearline or offline storage back toonline storage.This chapter describes the Sun St

134 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The rest of this section describes the stager direc

Chapter 5 Staging 135For example, the following directive line specifies that only one drive from the dogfamily set’s library be used for staging file

xvi Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07TABLE 3-10 -minsize and -maxsize size Suffixes 64TA

136 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07You can also specify this directive by using the Fi

Chapter 5 Staging 137When a log file is specified, the stager writes one or more lines to the log file for eachfile staged. This line includes informa

138 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07As CODE EXAMPLE 5-1 shows, the stager log file cons

Chapter 5 Staging 139Specifying the Number of Stage RequestsThe maxactive directive enables you to specify the number of stage requests thatcan be act

140 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Chapter 3 describes the archive set assignment dire

Chapter 5 Staging 141The following types of directives can appear in the preview.cmd file: Global directives, which apply to all file systems. These

142 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07If this factor is more than 1.0, it increases the i

Chapter 5 Staging 143Together, the four water mark settings create a dynamic priority factor that includesa percentage value indicating how full the f

144 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Calculating Total Preview RequestPriorityThe numeri

Chapter 5 Staging 145CODE EXAMPLE 5-4 shows an example preview.cmd file that addresses these threeconditions.For environments in which user access to

Tables xviiTABLE A-1 Arguments for the import(1M) Command 230TABLE A-2 Arguments for the samexport(1M) Command 231TABLE A-3 Arguments for the import(1

146 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Example 2: Enforcing Archive RequestsWhen the envir

Chapter 5 Staging 147Example 4: Complex PrioritizationAssume that there are two Sun StorageTek SAM file systems with the followingrequirements: No re

148 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07

149CHAPTER6RecyclingRecycling is the process of reclaiming space on archive volumes. The recycler workswith the archiver to reclaim the space occupied

150 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The capacity of a volume is the total amount of spa

Chapter 6 Recycling 151Before configuring the recycler, note the following: Directives in the archiver.cmd file control recycling by archive set. Dir

152 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Recycling Tape LibrariesYou initiate recycling for

Chapter 6 Recycling 153The following is an example of a logfile= directive line:Preventing Recycling: The no_recycle DirectiveThe no_recycle directive

154 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07For library, specify the library’s name as specifie

Chapter 6 Recycling 155Configuring the recycler for a tape library involves the tasks described in thefollowing sections, in this order:1. “Creating a

xviii Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07

156 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/073. Add one or more directives described in this cha

Chapter 6 Recycling 157Note – You can force a VSN to be recycled by using the following command to setthe recycling flag:#chmed +c lt.VSNWhen the +c f

158 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07TABLE 6-2 shows sample message bodies.▼ To Run the

Chapter 6 Recycling 159Creating a crontab File for the RecyclerIf the system is performing as expected, you can make a crontab entry for thesuperuser

160 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/071. Use vi(1) or another editor to remove the -recyc

Chapter 6 Recycling 161Editing the archiver.cmd FileIf you are archiving to disk, you must edit the archiver.cmd file in order torecycle.If you are re

162 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07For more information about archiver directives, see

Chapter 6 Recycling 163▼ To Remove -recycle_ignore and ignoreParametersIf you have used the -recycle_ignore or ignore parameter to disable recyclingdu

164 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07You can also include a logfile= directive line in t

165CHAPTER7Using the Sun SAM-RemoteSoftwareThe Sun SAM-Remote client and the Sun SAM-Remote server form a client/serverimplementation that allows libr

xixPrefaceThis manual, the Sun StorageTek™ Storage Archive Manager Archive Configuration andAdministration Guide, describes the storage and archive ma

166 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07FeaturesFIGURE 7-1 shows an environment configured

Chapter 7 Using the Sun SAM-Remote Software 167configuration include the ability to create local copies for each server with anadditional archive copy

168 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Client and Server InteractionsSun SAM-Remote client

Chapter 7 Using the Sun SAM-Remote Software 169per daemon. To configure more than ten clients, add an additional remote serverentry in the mcf file fo

170 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Upon initialization, the system builds a client cat

Chapter 7 Using the Sun SAM-Remote Software 171FIGURE 7-3 Example Sun SAM-Remote ConfigurationThe Sun StorageTek SAM file systems on portland and sacr

172 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/077. “To Enable Archiving” on page 180▼ To Log In to

Chapter 7 Using the Sun SAM-Remote Software 173The same release and revision level of Sun StorageTek SAM software must beinstalled on all client and s

174 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Alternatively, you can also idle the drives by usin

Chapter 7 Using the Sun SAM-Remote Software 175The mcf entry on the client consists of a single-line entry for the Sun SAM-Remoteclient and a pseudo-d

PleaseRecycleCopyright 2007 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved.Sun Microsystems, I

xx Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07How This Book Is OrganizedThis manual contains the f

176 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The last two entries in this mcf file define the Su

Chapter 7 Using the Sun SAM-Remote Software 177CODE EXAMPLE 7-5 shows the mcf file on chicago.The syntax of entries is described in “To Edit the mcf F

178 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07As CODE EXAMPLE 7-6 shows, a server configuration f

Chapter 7 Using the Sun SAM-Remote Software 179The parameter line is expressed in a keyword = value pair. You can use theparameter field to specify th

180 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Note – Do not allow the same physical media cartrid

Chapter 7 Using the Sun SAM-Remote Software 181To ensure that the new configuration files on the server and clients are read, youmust start or restart

182 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07CODE EXAMPLE 7-10 shows the samu(1M) status s displ

Chapter 7 Using the Sun SAM-Remote Software 183In CODE EXAMPLE 7-11, the connected client is named portland. The client indexfield indicates that this

184 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/075. From each client, issue the archiver(1M) command

Chapter 7 Using the Sun SAM-Remote Software 185You can prevent accidental recycling of VSNs used by Sun SAM-Remote clientsby creating a no_recycle lis

Preface xxiShell PromptsTABLE P-1 shows the shell prompts that this manual uses.Typographic ConventionsTABLE P-2 lists the typographic conventions use

186 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Configuration Files for Server skyThe server must h

Chapter 7 Using the Sun SAM-Remote Software 187CODE EXAMPLE 7-14 shows the server configuration file on server sky.Configuration Files for Client zeke

188 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Configure Recycling—Method 1The procedure for

Chapter 7 Using the Sun SAM-Remote Software 189CODE EXAMPLE 7-17 The archiver.cmd File on Client zeke# This is file /etc/opt/SUNWsamfs/archiver.cmd#

190 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The directives shown in CODE EXAMPLE 7-17 do the fo

Chapter 7 Using the Sun SAM-Remote Software 1914. Verify that the archiver.cmd file on the server is written to specify recycling byarchive set.When u

192 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/075. Edit the recycler.cmd file on the server.Modify

Chapter 7 Using the Sun SAM-Remote Software 1936. Use the sam-recycler(1M) command to test the recycler on theSun SAM-Remote client.Run the recycler o

194 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07CODE EXAMPLE 7-21 shows a sample log file.CODE EXAM

Chapter 7 Using the Sun SAM-Remote Software 1952 Family: hy Path: /var/opt/SUNWsamfs/catalog/historian Vendor: Sun SAM-FS

xxii Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Related DocumentationThis manual is part of a set

196 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/076 Family: archiveset.2 Path: /etc/opt/SUNW

Chapter 7 Using the Sun SAM-Remote Software 1978. Issue the sam-recycler(1M) command from the Sun SAM-Remote server toverify that the recycler is not

198 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07 13 at 48.5G 361.

Chapter 7 Using the Sun SAM-Remote Software 1993 Family: testset.2 Path: /etc/opt/SUNWsamfs/archiver.cmd Vendor: Sun SAM-FS

200 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Checking 000014. Need to free 0E, quantity limit:

Chapter 7 Using the Sun SAM-Remote Software 201Checking 000026. Need to free 0E, quantity limit: (no limit), VSN count: 0. VSN not in correct media

202 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Checking 000019. Need to free 38.8G, quantity limit

Chapter 7 Using the Sun SAM-Remote Software 203Checking 000013. Need to free 0E, quantity limit: (no limit), VSN count: 0. VSN not in correct media

204 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07 ---Archives--- -----Percent--

Chapter 7 Using the Sun SAM-Remote Software 2059. Analyze the server and client recycler.log files to choose VSNs that arecandidates for recycling.Tow

Preface xxiiiAccessing Sun Documentation OnlineThe Sun StorageTek QFS and Sun StorageTek SAM software distribution includesPDF files that you can view

206 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/072. Examine the recycler.log file from the server an

Chapter 7 Using the Sun SAM-Remote Software 207For example, for tape VSN 000029, use the following command:When this VSN 000029 is relabeled, you rega

208 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The server’s recycler.log file indicates that VSN 0

Chapter 7 Using the Sun SAM-Remote Software 2096. When archiving is complete, issue the sam-recycler(1M) command to rerun therecycler on the client.Th

210 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/072. Analyze the recycler log file for recycling cand

211CHAPTER8Advanced TopicsThis chapter discusses advanced topics that are beyond the scope of basic systemadministration and usage.This chapter contai

212 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07For tape archiving and staging to continue after fa

Chapter 8 Advanced Topics 213 Within the HA-SAM environment, the nosam mount option must be specified forany non-HA-SAM Sun StorageTek QFS file syste

214 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Configuration InstructionsBefore configuring HA-SAM

Chapter 8 Advanced Topics 215b. Verify that the output shows symbolic links similar to the following example.If the symbolic links exist, proceed to “

xxiv Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07or resources. Sun will not be responsible or liabl

216 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/072. Create and configure the SUNW.qfs resource.3. Cr

Chapter 8 Advanced Topics 217Using the samd hastop CommandThe samd command has an option that is specifically for use with HA-SAM. Thesamd hastop comm

218 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07CODE EXAMPLE 8-1 shows the mcf file.CODE EXAMPLE 8-

Chapter 8 Advanced Topics 219Enabling the Device LogYou can enable the device log in one of two ways, as described in the followingsubsections: “To E

220 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/075. Use the samd(1M) config command to propagate the

Chapter 8 Advanced Topics 221▼ To Create a Removable Media or VolumeOverflow File1. Use the tplabel(1M) or odlabel(1M) command to label a tape or magn

222 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Using Segmented FilesThe Sun StorageTek SAM environ

Chapter 8 Advanced Topics 223directive, this file is archived to two drives in parallel. Segments 1, 3, 5, 7, and 9 arearchived using the first drive,

224 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Enable SEF Reporting1. Become superuser.2. Use

Chapter 8 Advanced Topics 225 The -d option. The -d option generates additional device information. It writesan additional header line that contains

1CHAPTER1OverviewThe Sun StorageTek SAM environment provides a configurable file system withstorage, archive management, and retrieval capabilities. T

226 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07 PAGE CODE 3 param code control param value

Chapter 8 Advanced Topics 227For more information about the SEF log file, including its content and format, see thesefdata(4) man page. For more infor

228 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07SEF sysevent FunctionalityIn addition to using the

229APPENDIXABasic Operations for Libraries WithVendor-Specific OperationalProceduresYou can include libraries from many different manufacturers in a S

230 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07ADIC/Grau Automated LibrariesIf you have an ADIC/G

Appendix A Basic Operations for Libraries With Vendor-Specific Operational Procedures 231▼ To Export a CartridgeTo export a cartridge, perform the fol

232 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Import a CartridgeTo import a cartridge, perf

Appendix A Basic Operations for Libraries With Vendor-Specific Operational Procedures 233The samexport(1M) command updates the library catalog as each

234 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07When a cartridge is exported from a partitioned li

Appendix A Basic Operations for Libraries With Vendor-Specific Operational Procedures 2352. Close the door.The library locks the door and moves the me

2 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07files in a Sun StorageTek SAM file system and writes

236 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Import TapesTo import tapes, follow these ste

Appendix A Basic Operations for Libraries With Vendor-Specific Operational Procedures 2372. Push the open/close button on the front panel of the autom

238 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/074. Issue the samexport(1M) command to enable the S

Appendix A Basic Operations for Libraries With Vendor-Specific Operational Procedures 239Sony Network Attached AutomatedLibrariesIf you have a Sony ne

240 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Export a CartridgeTo export a cartridge, perf

Appendix A Basic Operations for Libraries With Vendor-Specific Operational Procedures 241StorageTek 9714 and the StorageTek 9710. The StorageTek 9730

242 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Export Tapes Using a MailboxYou can export ta

243GlossaryAaddressable storage The storage space encompassing online, nearline, offsite, and offline storagethat is user-referenced through a Sun Sto

244 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07block allocation map A bitmap representing each av

Glossary 245direct I/O An attribute used for large block-aligned sequential I/O. The setfa(1)command’s –D option is the direct I/O option. It sets the

Chapter 1 Overview 3 Relabel the volume for immediate reuse. Export the volume to offsite storage as a historical record of file changes. Youcan use

246 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07FDDI Fiber-distributed data interface (FDDI) is a

Glossary 247Iindirect block A disk block that contains a list of storage blocks. File systems have up to threelevels of indirect blocks. A first-level

248 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Mmcf Master configuration file. The file that is r

Glossary 249network attachedautomated library A library, such as those from StorageTek, ADIC/Grau, IBM, or Sony, that iscontrolled using a software pa

250 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07RRAID Redundant array of independent disks. A disk

Glossary 251SAM-QFS A configuration that combines the Sun StorageTek SAM software with the SunStorageTek QFS file system. SAM-QFS offers a high-speed,

252 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Sun SAM-Remoteclient A Sun StorageTek SAM system w

Glossary 253VSN Volume serial name. In the context of archiving to removable media cartridges,the VSN is a logical identifier for magnetic tape and op

254 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07

255IndexA-access archiver directive, 63ACSAPI interface, 3ACSLS-attached library, 240ADIC/Grau automated libraryoperations, 230age_priority preview.cm

4 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07For a list of supported storage devices, contact your

256 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07overview, 1-ovflmin parameter, 41preventing archiving

Index 257auditautomated library, 18volume, 17auditslot(1M) command, 17, 23auto-cleaning, 22automated libraryADIC/Grau, 230auditing, 18catalog, 26clean

258 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07release priority, 2diskvols.conf file, 92display_all_

Index 259load_notify.sh script, 30loading media, 14manually loaded drive, 31-lock archiver directive, 77log filesarchiver, 44, 56backing up, 57, 100dev

260 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07directives, 141hlwm_ priority directive, 143hwm_ pri

Index 261min_residence_age directive, 126no_release directive, 125rearch_no_release directive, 128weight_age directive, 123weight_age_access directive

262 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07options, 224segment(1) command, 222segmented files, 2

Index 263wm_priority preview.cmd file directive, 142

264 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07

Chapter 1 Overview 5High-availability SAM (HA-SAM) depends on the Sun StorageTek QFS Sun Clusteragent, so this configuration must be installed with a

iiiContentsPreface xix1. Overview 1Capabilities 1Storage Devices 3Sun SAM-Remote Software 4High-Availability Configuration Using Sun Cluster (HA-SAM)

6 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/074. At the Password prompt, enter the password.5. Clic

Chapter 1 Overview 72. Use the useradd and passwd commands to add each user.For example, to add a user with account name bobsmith, type the following:

8 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07To assign bobsmith privileges only for staging and re

Chapter 1 Overview 9Managing Additional Servers From the FileSystem ManagerBy default, File System Manager is set up to manage the server on which it

10 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07

11CHAPTER2Using Automated Libraries andManually Loaded DrivesAn automated library is a robotically controlled device designed to load and unloadremova

12 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Automated Library OperationsA number of basic operat

Chapter 2 Using Automated Libraries and Manually Loaded Drives 13If removable media operations are already running when the preceding command isentere

14 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07● Use the samcmd(1M) on command.For eq, specify the

Chapter 2 Using Automated Libraries and Manually Loaded Drives 15▼ To Manually Load a Cartridge● Use the samcmd(1M) load command.You can use this comm

iv Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Turn On an Automated Library 13▼ To Turn Off an

16 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Manually Unload a Cartridge● Use the samcmd(1M)

Chapter 2 Using Automated Libraries and Manually Loaded Drives 17After the command to label or relabel a tape is issued, the tape is loaded andpositio

18 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07● Use the auditslot(1M) command to audit a volume.Fo

Chapter 2 Using Automated Libraries and Manually Loaded Drives 19For eq, specify the equipment ordinal of the automated library as defined in the mcff

20 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The Sun StorageTek SAM system moves the cartridge fr

Chapter 2 Using Automated Libraries and Manually Loaded Drives 21For more information about the chmed(1M) command, see the chmed(1M) manpage.▼ To Rese

22 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07For example, the following command sets the cleaning

Chapter 2 Using Automated Libraries and Manually Loaded Drives 23To invoke the legacy Sun StorageTek SAM auto-cleaning feature, which relies onsense d

24 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07For more information about the auditslot(1M) command

Chapter 2 Using Automated Libraries and Manually Loaded Drives 254. Use the samcmd(1M) on command to turn on the automated library and the drive.Issue

Contents vUsing Drives With Encryption Capability 31Manually Loaded Drive Operations 31▼ To Load a Cartridge 31▼ To Unload a Cartridge 32▼ To View a L

26 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07 Relocate cartridges to off-site storage to use lat

Chapter 2 Using Automated Libraries and Manually Loaded Drives 27Tracking Exported Media – The HistorianThe Sun StorageTek SAM historian keeps track o

28 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Importing and exporting practices differ from manufa

Chapter 2 Using Automated Libraries and Manually Loaded Drives 29You can also perform this step by using samu(1M) or File System Manager.2. Open the m

30 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/072. Wait until the system completes its current task,

Chapter 2 Using Automated Libraries and Manually Loaded Drives 31Using Drives With Encryption CapabilityIf you are archiving files to drives with encr

32 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07▼ To Unload a Cartridge● Use samcmd(1M) idle command

33CHAPTER3ArchivingArchiving is the process of copying a file from a Sun StorageTek SAM file system toa volume that resides on a removable media cartr

34 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The archiver starts automatically when a Sun Storage

Chapter 3 Archiving 35As files are created and modified, the archiver copies them to archive media. Thearchiving process also copies the data necessar

vi Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The drives Directive: Controlling the Number of Driv

36 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Note – Issuing an mv(1) command alters the file name

Chapter 3 Archiving 37The sam-arfind process determines the archive set to which the file belongs byusing the file properties descriptions. The charac

38 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Continuous ArchivingContinuous archiving is the defa

Chapter 3 Archiving 39When the file system scan is complete, the sam-arfind process sends each archiverequest to the archiver daemon, sam-archiverd, t

40 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The sam-archiverd daemon determines whether the file

Chapter 3 Archiving 41DrivesIf the archive set has the -drives parameter specified, the sam-archiverddaemon divides the selected files in the archive

42 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07threshold above which additional volumes or media ar

Chapter 3 Archiving 43When the sam-arcopy process exits, the sam-archiverd daemon examines thearchive request. If any files have not been archived, th

44 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Sample Default OutputCODE EXAMPLE 3-1 shows sample o

Chapter 3 Archiving 45CODE EXAMPLE 3-2 shows sample lines from an archiver log file with definitions foreach field.Reading left to right, the fields i

Contents viiUnarchiving Automatically 72Specifying More Than One Copy for Metadata 72Archive Set Copy Parameters 73Controlling the Size of Archive Fil

46 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Data VerificationIf required, you can enable data ve

Chapter 3 Archiving 47Note – The data verification feature places an additional burden on stager resourcessince data verification requests are placed

48 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/073. Save and close the file.4. Use the archiver(1M) -

Chapter 3 Archiving 49The directives consist of lines of text read from the archiver.cmd file. Eachdirective line contains one or more fields separate

50 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Example archiver.cmd FileCODE EXAMPLE 3-3 shows a sa

Chapter 3 Archiving 51Using Archiver DirectivesThe following sections explain the archiver.cmd directives. They are as follows: “Global Archiving Dir

52 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Global Archiving DirectivesGlobal directives control

Chapter 3 Archiving 53The archmax Directive: Controlling the Size of Archive FilesThe archmax directive specifies the maximum size of an archive file.

54 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07You can specify a buffer size and a lock on an archi

Chapter 3 Archiving 55Also see the -drivemax, -drivemin, and -drives archive set copy parametersdescribed in “Specifying the Number of Drives for an A

viii Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The Preview Queue 100Archiver Examples 101Example

56 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The interval directive initiates full scans only whe

Chapter 3 Archiving 57▼ To Back Up an Archiver Log FileAssume that you want to back up the archiver log file every day by copying theprevious day’s lo

58 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Note – Use volume overflow with caution only after t

Chapter 3 Archiving 59CODE EXAMPLE 3-4 shows that file50 spans three volumes with VSNs of DLT000,DLT001, and DLT005. The position on the volume and th

60 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07performance penalty if archiving on a file system th

Chapter 3 Archiving 61File System DirectivesAfter the general directives in the archiver.cmd file, you can use the fs= directiveto include directives

62 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Archive Set Assignment DirectiveBy default, files ar

Chapter 3 Archiving 63CODE EXAMPLE 3-6 shows typical archive set membership directives.You can suppress the archiver by including files in an archive

64 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07For example, you can use this directive to specify t

Chapter 3 Archiving 65Example. The lines in CODE EXAMPLE 3-8 specify that all files of at least 500 kilobytes,but less than 100 megabytes, belong to t

Contents ix5. Staging 133About the stager.cmd File 133The drives Directive: Specifying the Number of Drives 134Setting the Stage Buffer Size 135Specif

66 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07All files beneath the selected directory (with their

Chapter 3 Archiving 67CODE EXAMPLE 3-12 shows the files that are archived if you specify the directivesshown inCODE EXAMPLE 3-10.In contrast toCODE EX

68 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Release and Stage file-attributes: -release and -sta

Chapter 3 Archiving 69Archive Set Membership ConflictsSometimes the choice of path and other file characteristics for inclusion of a file in anarchive

70 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07Archive Copy DirectivesIf you do not specify archive

Chapter 3 Archiving 71Delaying Disk Space Release: -noreleaseYou might not want to release disk space until multiple archive copies arecompleted. The

72 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07In CODE EXAMPLE 3-19, the files in directory data ar

Chapter 3 Archiving 73File system metadata includes path names in the file system. For this reason, if youhave frequent changes to directories, the ne

74 Sun StorageTek SAM Archive Configuration and Administration Guide • Version 4, Update 6, 04/07The pseudo archive set allsets provides a way to set

Chapter 3 Archiving 75The equivalent of this directive on a global basis is bufsize=media buffer-size. Formore information on that directive, see “The