Examples of archiver.cmd Files - Sun Storage Archive Manager 5.3 Configuration and Administration Guide

Examples of `archiver.cmd` Files

This section provides some examples of archiving configurations.

Example 10-1 Simple archiver.cmd File

The following example shows a simple archiver.cmd file that you can modify. Add directives only to accommodate more archive sets, copies, and VSN usage.

archiver.cmd# One file system = samfs1
archmax = sg 2G
examine = noscan
fs = samfs1
logfile = /var/opt/SUNWsamfs/log/samfs1.log
all_archset .
  1 -norelease 10m
  2 -norelease 10m
params
allsets -sort path -offline_copy stageahead -reserve set
allsets -recycle_hwm 50 -recycle_mingain 90 \
-recycle_vsncount 5 -recycle_dataquantity 40G
allsets.1 -startage 6h -startsize 6G -startcount 30000
allsets.2 -startage 10h -startsize 12G \
-startcount 60000 -archmax 12G
endparams
vsns
all.1 li .*
all.2 li .*
endvsns

Example 10-2 Advanced archiver.cmd File

The following example shows a complex archiver.cmd file. The comments indicate the various types of directives.

# Global directives

archmax = li 8G
examine = noscan
scanlist_squash = on

# Limit the drives

drives = stk50 3

# File selection

fs = samfs1
logfile = /var/adm/samfs1.log
archive_archset .
  1 -norelease 5m
  2 -norelease 5m

fs = samfs2
logfile = /var/adm/samfs2.log
archive_archset .
  1 -norelease 5m
  2 -norelease 5m

fs = samfs3
logfile = /var/adm/samfs3.log
archive_archset .
  1 -norelease 5m
  2 -norelease 5m

fs = samfs4
logfile = /var/adm/samfs4.log
archive_archset .
  1 -norelease 5m
  2 -norelease 5m

fs = samfs5
logfile = /var/adm/samfs5.log
archive_archset .
  1 -norelease 5m
  2 -norelease 5m

# The following information is for tape archiving.
# The recycler is not set up to actually recycle. It is set up for
# data checks and file recovery.

params allsets -sort path -offline_copy stageahead -reserve set
allsets -recycle_ignore allsets -recycle_hwm 50 -recycle_mingain 90 -recycle_vsncount 1
allsets.1 -startage 6h -startsize 8G -startcount 90000 -drives 3 -drivemin 10G
allsets.2 -startage 10h -startsize 12G -startcount 90000 
-archmax 12G -drives 3 -drivemin 10G
endparams

# Define VSNS for archive sets

vsns
archive.1 li .*
archive.2 li .*
endvsns

Example 10-3 No archiver.cmd File

This example illustrates the action of the archiver when no archiver.cmd file is used in a SAM-QFS environment that has one file system, an optical automated library with two drives, and six cartridges.

The following archiver -lv output shows that the default media selected by the archiver is type mo. Only the mo media are available.

# archiver -lv
Notify file: /etc/opt/SUNWsamfs/scripts/archiver.sh
Archive media:
media:lt archmax: 512.0M Volume overflow not selected
media:mo archmax: 4.8M Volume overflow not selected

The following archiver -lv output indicates that the archiver uses two drives. It lists the 12 volumes, storage capacity, and VSNs with available space.

Archive libraries:
Device:hp30 drives_available:2 archive_drives:2
Catalog:
mo.optic00 capacity: 1.2G space: 939.7M -il-o-------
mo.optic01 capacity: 1.2G space: 934.2M -il-o-------
mo.optic02 capacity: 1.2G space: 781.7M -il-o-------
mo.optic03 capacity: 1.2G space: 1.1G -il-o-------
mo.optic10 capacity: 1.2G space: 85.5M -il-o-------
mo.optic11 capacity: 1.2G space: 0 -il-o-------
mo.optic12 capacity: 1.2G space: 618.9k -il-o-------
mo.optic13 capacity: 1.2G space: 981.3M -il-o-------
mo.optic20 capacity: 1.2G space: 1.1G -il-o-------
mo.optic21 capacity: 1.2G space: 1.1G -il-o-------
mo.optic22 capacity: 1.2G space: 244.9k -il-o-------
mo.optic23 capacity: 1.2G space: 1.1G -il-o-------

The following archiver -lv output shows that the archive set samfs includes both metadata and data files. The archiver makes one copy of the files when their archive age reaches the default four minutes (240 seconds).

Archive file selections:
Filesystem samfs Logfile:
samfs Metadata
copy:1 arch_age:240
samfs1 path:.
copy:1 arch_age:240

The following archiver -lv output shows the files in the archive sets archived to the volumes in the indicated order.

Archive sets:
allsets
samfs.1
media: mo (by default)
Volumes:
optic00
optic01
optic02
optic03
optic10
optic12
optic13
optic20
optic21
optic22
optic23
Total space available: 8.1G

Example 10-4 Data Files Archived Separately From Metadata

This example shows how to separate data files into two archive sets separate from the metadata. The environment includes a manually mounted DLT tape drive in addition to an optical automated library. The big files are archived to tape, and the small files are archived to optical cartridges.

The following example shows the content of the archiver.cmd file.

# archiver -lv -c example2.cmd
Reading archiver command file "example2.cmd"
1: # Example 2 archiver command file
2: # Simple selections based on size
3:
4: logfile = /var/opt/SUNWsamfs/archiver/log
5: interval = 5m
6:
7: # File selections.
8: big . -minsize 500k
9: all .
10: 1 30s
11:
12: vsns
13: samfs.1 mo .*0[0-2] # Metadata to optic00 - optic02
14: all.1 mo .*0[3-9] .*[1-2][0-9] # All others for files
15: big.1 lt .*
16: endvsns

The following archiver -lv output shows the media and drives to be used.

Notify file: /etc/opt/SUNWsamfs/scripts/archiver.sh
Archive media:
media:lt archmax: 512.0M Volume overflow not selected
media:mo archmax: 4.8M Volume overflow not selected
Archive libraries:
Device:hp30 drives_available:0 archive_drives:0
Catalog:
mo.optic00 capacity: 1.2G space: 939.7M -il-o-------
mo.optic01 capacity: 1.2G space: 934.2M -il-o-------
mo.optic02 capacity: 1.2G space: 781.7M -il-o-------

mo.optic03 capacity: 1.2G space: 1.1G -il-o-------
mo.optic04 capacity: 1.2G space: 983.2M -il-o-------
mo.optic10 capacity: 1.2G space: 85.5M -il-o-------
mo.optic11 capacity: 1.2G space: 0 -il-o-------
mo.optic12 capacity: 1.2G space: 618.9k -il-o-------
mo.optic13 capacity: 1.2G space: 981.3M -il-o-------
mo.optic20 capacity: 1.2G space: 1.1G -il-o-------
mo.optic21 capacity: 1.2G space: 1.1G -il-o-------
mo.optic22 capacity: 1.2G space: 244.9k -il-o-------
mo.optic23 capacity: 1.2G space: 1.1G -il-o-------
Device:lt40 drives_available:0 archive_drives:0
Catalog:
lt.TAPE01 capacity: 9.5G space: 8.5G -il-o-------
lt.TAPE02 capacity: 9.5G space: 6.2G -il-o-------
lt.TAPE03 capacity: 9.5G space: 3.6G -il-o-------
lt.TAPE04 capacity: 9.5G space: 8.5G -il-o-------
lt.TAPE05 capacity: 9.5G space: 8.5G -il-o-------
lt.TAPE06 capacity: 9.5G space: 7.4G -il-o-------

The following archiver -lv output shows the organization of the file system. Files bigger than 512000 bytes (500 kilobytes) are archived after four minutes. All other files are archived after 30 seconds.

Archive file selections:
Filesystem samfs Logfile: /var/opt/SUNWsamfs/archiver/log
samfs Metadata
copy:1 arch_age:240
big path:. minsize:502.0k
copy:1 arch_age:240
all path:.
copy:1 arch_age:30

The following archiver -lv output shows the division of the archive sets among the removable media.

Archive sets:
allsets
all.1
media: mo
Volumes:
optic03
optic04
optic10
optic12
optic13
optic20
optic21
optic22
optic23
Total space available: 6.3G
big.1
media: lt
Volumes:
TAPE01
TAPE02
TAPE03
TAPE04
TAPE05
TAPE06
Total space available: 42.8G
samfs.1
media: mo
Volumes:
optic00
optic01
optic02
Total space available: 2.6G

Note - The archiver(1M) -lv command shows only VSNs with space available.

Example 10-5 User and Data Files Archived to Various Media

In this example, user files and project data files are archived to various media. Files from the directory data are segregated by size to optical and tape media. Files assigned to the group ID pict are assigned to another set of volumes. Files in the directories tmp and users/bob are not archived. Archiving is performed at 15-minute intervals, and an archiving record is kept.

# archiver -lv -c example3.cmd
Reading archiver command file "example3.cmd"
1: # Example 3 archiver command file
2: # Segregation of users and data
3:
4: interval = 30s
5: logfile = /var/opt/SUNWsamfs/archiver/log
6:
7: no_archive tmp
8:
9: fs = samfs
10: no_archive users/bob
11: prod_big data -minsize 50k
12: 1 1m 30d
13: 2 3m
14: prod data
15: 1 1m
16: proj_1 projs/proj_1
17: 1 1m
18: 2 1m
19: joe . -user joe
20: 1 1m
21: 2 1m
22: pict . -group pict
23: 1 1m
24: 2 1m
25:
26: params
27: prod_big.1 -drives 2
28: prod_big.2 -drives 2
29: endparams
30:
31: vsns
32: samfs.1 mo optic0[0-1]$
33: joe.1 mo optic01$
34: pict.1 mo optic02$
35: pict.2 mo optic03$
36: proj_1.1 mo optic1[0-1]$
37: proj_1.2 mo optic1[2-3]$
38: prod.1 mo optic2.$
39: joe.2 lt 0[1-2]$
40: prod_big.1 lt 0[3-4]$
41: prod_big.2 lt 0[5-6]$
42: endvsns
Notify file: /etc/opt/SUNWsamfs/scripts/archiver.sh
Archive media:
media:lt archmax: 512.0M Volume overflow not selected
media:mo archmax: 4.8M Volume overflow not selected
Archive libraries:
Device:hp30 drives_available:0 archive_drives:0
Catalog:
mo.optic00 capacity: 1.2G space: 939.7M -il-o-------
mo.optic01 capacity: 1.2G space: 934.2M -il-o-------
mo.optic02 capacity: 1.2G space: 781.7M -il-o-------
mo.optic03 capacity: 1.2G space: 1.1G -il-o-------
mo.optic04 capacity: 1.2G space: 983.2M -il-o-------
mo.optic10 capacity: 1.2G space: 85.5M -il-o-------
mo.optic11 capacity: 1.2G space: 0 -il-o-------
mo.optic12 capacity: 1.2G space: 618.9k -il-o-------
mo.optic13 capacity: 1.2G space: 981.3M -il-o-------
mo.optic20 capacity: 1.2G space: 1.1G -il-o-------
mo.optic21 capacity: 1.2G space: 1.1G -il-o-------
mo.optic22 capacity: 1.2G space: 244.9k -il-o-------
mo.optic23 capacity: 1.2G space: 1.1G -il-o-------
Device:lt40 drives_available:0 archive_drives:0
Catalog:
lt.TAPE01 capacity: 9.5G space: 8.5G -il-o-------
lt.TAPE02 capacity: 9.5G space: 6.2G -il-o-------
lt.TAPE03 capacity: 9.5G space: 3.6G -il-o-------
lt.TAPE04 capacity: 9.5G space: 8.5G -il-o-------
lt.TAPE05 capacity: 9.5G space: 8.5G -il-o-------
lt.TAPE06 capacity: 9.5G space: 7.4G -il-o-------
Archive file selections:
Filesystem samfs Logfile: /var/opt/SUNWsamfs/archiver/log
samfs Metadata
copy:1 arch_age:240
no_archive Noarchive path:users/bob
prod_big path:data minsize:50.2k
copy:1 arch_age:60 unarch_age:2592000
copy:2 arch_age:180
prod path:data
copy:1 arch_age:60
proj_1 path:projs/proj_1
copy:1 arch_age:60
copy:2 arch_age:60
joe path:. uid:10006
copy:1 arch_age:60
copy:2 arch_age:60
pict path:. gid:8005
copy:1 arch_age:60
copy:2 arch_age:60
no_archive Noarchive path:tmp
samfs path:.
copy:1 arch_age:240
Archive sets:
allsets
joe.1
media: mo
Volumes:
optic01
Total space available: 934.2M
joe.2
media: lt
Volumes:
TAPE01
TAPE02
Total space available: 14.7G
pict.1
media: mo
Volumes:
optic02
Total space available: 781.7M
pict.2
media: mo
Volumes:
optic03
Total space available: 1.1G
prod.1
media: mo
Volumes:
optic20
optic21
optic22
optic23
Total space available: 3.3G
prod_big.1
media: lt drives:2
Volumes:
TAPE03
TAPE04
Total space available: 12.1G
prod_big.2
media: lt drives:2
Volumes:
TAPE05
TAPE06
Total space available: 16.0G
proj_1.1
media: mo
Volumes:
optic10
Total space available: 85.5M
proj_1.2
media: mo
Volumes:
optic12
optic13
Total space available: 981.9M
samfs.1
media: mo
Volumes:
optic00
optic01
Total space available: 1.8G

Example 10-6 User and Data Files Archived to Optical Media

In this example, user files and project data files are archived to optical media.

Four VSN pools are defined. Three pools are used for user, data, and project, and one is a scratch pool. When proj_pool runs out of media, it relies on scratch_pool to reserve volumes. This example shows how to reserve volumes for each archive set based on the set component, owner component, and file system component. Archiving is performed at 10-minute intervals, and an archiving log is kept.

The following example shows the archiver.cmd file and archiver output.

Reading archiver command file "example4.cmd"
1: # Example 4 archiver command file
2: # Using 4 VSN pools
3:
4: interval = 30s
5: logfile = /var/opt/SUNWsamfs/archiver/log
6:
7: fs = samfs
8: users users
9: 1 10m
10:
11: data data
12: 1 10m
13:
14: proj projects
15: 1 10m
16:
17: params
18: users.1 -reserve user
19: data.1 -reserve group
20: proj.1 -reserve dir -reserve fs
21: endparams
22:
23: vsnpools
24: users_pool mo optic0[1-3]$
25: data_pool mo optic1[0-1]$
26: proj_pool mo optic1[2-3]$
27: scratch_pool mo optic2.$
28: endvsnpools
29:
30: vsn
31: samfs.1 mo optic00
32: users.1 mo -pool users_pool -pool scratch_pool
33: data.1 mo -pool data_pool -pool scratch_pool
34: proj.1 mo -pool proj_pool -pool scratch_pool
35: endvsns
Notify file: /etc/opt/SUNWsamfs/scripts/archiver.sh
Archive media:
media:mo archmax: 4.8M Volume overflow not selected
Archive libraries:
Device:hp30 drives_available:0 archive_drives:0
Catalog:
mo.optic00 capacity: 1.2G space: 939.7M -il-o-------
mo.optic01 capacity: 1.2G space: 934.2M -il-o-------
mo.optic02 capacity: 1.2G space: 781.7M -il-o-------
mo.optic03 capacity: 1.2G space: 1.1G -il-o-------
mo.optic04 capacity: 1.2G space: 983.2M -il-o-------
mo.optic10 capacity: 1.2G space: 85.5M -il-o-------
mo.optic11 capacity: 1.2G space: 0 -il-o-------
mo.optic12 capacity: 1.2G space: 618.9k -il-o-------
mo.optic13 capacity: 1.2G space: 981.3M -il-o-------
mo.optic20 capacity: 1.2G space: 1.1G -il-o-------
mo.optic21 capacity: 1.2G space: 1.1G -il-o-------
mo.optic22 capacity: 1.2G space: 244.9k -il-o-------
mo.optic23 capacity: 1.2G space: 1.1G -il-o-------
Archive file selections:
Filesystem samfs Logfile: /var/opt/SUNWsamfs/archiver/log
samfs Metadata
copy:1 arch_age:240
users path:users
copy:1 arch_age:600
data path:data
copy:1 arch_age:600
proj path:projects
copy:1 arch_age:600
samfs path:.
copy:1 arch_age:240
VSN pools:
data_pool media: mo Volumes:
optic10
Total space available: 85.5M
proj_pool media: mo Volumes:
optic12
optic13
Total space available: 981.9M
scratch_pool media: mo Volumes:
optic20
optic21
optic22
optic23
Total space available: 3.3G
users_pool media: mo Volumes:
optic01
optic02
optic03
Total space available: 2.7G
Archive sets:
allsets
data.1
reserve:/group/
media: mo
Volumes:
optic10
optic20
optic21
optic22
optic23
Total space available: 3.4G
proj.1
reserve:/dir/fs
media: mo
Volumes:
optic12
optic13
optic20
optic21
optic22
optic23
Total space available: 4.2G
samfs.1
media: mo
Volumes:
optic00
Total space available: 939.7M
users.1
reserve:/user/
media: mo
Volumes:
optic01
optic02
optic03
optic20
optic21
optic22
optic23
Total space available: 6.0G

Skip Navigation Links
Exit Print View
	Sun Storage Archive Manager 5.3 Configuration and Administration Guide Sun QFS and Sun Storage Archive Manager 5.3 Information Library