| Skip Navigation Links | |
| Exit Print View | |
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
|
|
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME
archiver - SAM-QFS file archiver command file processor
SYNOPSIS
/opt/SUNWsamfs/sbin/archiver directive [value]
/opt/SUNWsamfs/sbin/archiver [-A] [-a] [-b] [ -c archive_cmd
] [-f] [-l] [ -n file_system ] [-v]
AVAILABILITY
SUNWsamfs
DESCRIPTION
The archiver command has two functions. It is used by the
archiver daemon (sam-archiverd) to process the archiver com-
mand file. The command file used by the archiver daemon is
/etc/opt/SUNWsamfs/archiver.cmd. This file does not have to
be present for the archiver to execute. If the archiver.cmd
file is present, however, it must be free of errors. Errors
in the archiver.cmd file prevent the archiver from execut-
ing. If the archiver.cmd file is not present, all files on
the file system are archived to the available removable
media according to archiver defaults.
The second function allows you to use the command with the
options to evaluate the archiver commands file, archive_cmd.
No archiving is performed when the command is used in this
manner. When options are used, information about archiving
operations is written to standard output. It is recommended
that you test your archiver commands file each time it is
changed because any error found prevents the archiver from
running. If an archive_cmd file is not specified,
/etc/opt/SUNWsamfs/archiver.cmd is assumed.
Sample default output:
Reading archiver command file "example1.cmd"
Notify file: /etc/opt/SUNWsamfs/scripts/archiver.sh
Archive media:
media:sg bufsize: 4 archmax: 512.0M Volume overflow not selected
media:mo bufsize: 4 archmax: 4.8M Volume overflow not selected
Archive libraries:
Device:mo20 drives_available:0 archive_drives:1
Device:tp30 drives_available:0 archive_drives:3
Archive file selections:
Filesystem samfs1 interval: 300
Logfile: /var/opt/SUNWsamfs/archiver.log
samfs1 Metadata
copy:1 arch_age:240
big path:. minsize: 500.0k
copy:1 arch_age:30
copy:2 arch_age:7200
all path:.
copy:1 arch_age:30
Archive sets:
allsets
reserve: set//
allsets.1
.reserve: set//
allsets.2
archmax: 5G
.reserve: set//
allsets.3
.reserve: set//
allsets.4
.reserve: set//
all.1
.reserve: set//
media: mo
Total space available: 2.1G
big.1
.reserve: set//
media: sg
Total space available: 77.5G
big.2
.archmax: 5G
.reserve: set//
media: sg
Total space available: 77.5G
samfs1.1
.reserve: set//
media: mo
Total space available: 2.1G
Archive Set parameters set by the archiver command file are
listed for all Archive Sets. Parameters defined by allsets
and allsets.n are preceeded by the '.' character.
OPTIONS
-A Turn on all list options except -a and -b.
-a List archive detail for files.
The -a option produces a line of output for each
file found in an inodes scan of a file system.
The line lists present and future archive activity
for the file. The line is in a fixed format con-
sisting of space (' ') separated fields as fol-
lows:
1 A single character that identifies the file type:
'l' Symbolic link
'R' Removable media file
'I' Segment index
'd' Directory
'f' Regular file
'b' Block special
'?' Other
2 The name of the file quoted using '"'.
The '"' and '\' characters in the file name are represented
by '\"' and '\\'.
3 inode.gen Inode and generation number
4 Archive Set name. If the file is not to be archived, '-'.
5 - 8 Archive information for the four possible copies.
If no archive copy required '-'
If archived, 'media.VSN'
If not archived, the time at which archiving will begin
'yyyy-mm-ddThh:mm:ss' (ISO 8601)
If the copy is to be unarchived, the time for unarchiving
'/yyyy-mm-ddThh:mm:ss'
The '-a' option will clear any previously set
option, except a file system name set by '-n'.
This allows a user to generate only the archive
activity information to standard out. This could
be used as input to sort, a spreadsheet or data-
base.
-b Print the total size in bytes in base 10 units for
-v, and the capacity and space for -l. By default,
base 2 units is used.
-c archive_cmd
The name of the archiver command file to be
evaluated. Default is
/etc/opt/SUNWsamfs/archiver.cmd.
-f List file system content. Sample output:
Filesystems:
qfs1 mount: /qfs1
Examine: noscan Interval: 2h
Logfile:/var/opt/SUNWsamfs/archiver/log
Producing statistics
File type Count Percent Bytes Percent Bytes
All 411,958 100.00% 8.3G 100.00% 8935481659
offline 26 0.1% 264.1M 3.10% 276878242
archdone 19,962 4.85% 1.9G 22.58% 2018002292
copy1 658 0.16% 1.8G 21.74% 1942851010
copy2 0
copy3 0
copy4 0
Regular 411,479 99.88% 8.3G 99.84% 8921596219
offline 26 0.01% 264.1M 3.10% 276878242
archdone 19,492 4.73% 1.9G 22.50% 2010445172
copy1 189 0.05% 1.8G 21.66% 1935297986
copy2 0
copy3 0
copy4 0
Segmented 0 0.00% 0 0.00% 0
offline 0
archdone 0
copy1 0
copy2 0
copy3 0
copy4 0
Directories 473 0.11% 13.2M 0.16% 13881344
offline 0
archdone 469 0.11% 7.2M 0.08% 7553024
copy1 469 0.11% 7.2M 0.08% 7553024
copy2 0
copy3 0
copy4 0
Symbolic links 5 0.00% 0 0.00% 0
offline 0
archdone 0
copy1 0
copy2 0
copy3 0
copy4 0
Removable media 1 0.00% 4.0k 0.00% 4096
offline 0
archdone 1 0.00% 4.0k 0.00% 4096
copy1 0
copy2 0
copy3 0
copy4 0
Column 2 is the number of files. Column 3 is the
percent of the total number of files. Column 4 is
the total size in bytes. Column 5 is the percent
of the total size. Column 6 is the exact total
size in bytes.
-l List input lines. Sample output:
1: logfile = /var/opt/SUNWsamfs/archiver.log
2: interval = 5m
3: big . -minsize 500k
4: 1 30s
5: 2 2h
6: all .
7: 1 30s
8: params
9: allsets -reserve set
10: allsets.2 -archmax 5G
11: endparams
12: vsns
13: samfs1.1 mo .*
14: all.1 mo .*
15: big.1 sg .*
16: big.2 sg .*
-n file_system
List file system content (same as -f) for a single
file system.
-v List VSNs. Only lists VSNs with space available.
Sample output:
Archive libraries:
Device:mo20 drives_available:0 archive_drives:1
Catalog:
mo.mo0001 capacity: 1.2G space: 1.1G -il-o-------
mo.mo0002 capacity: 1.2G space: 1.0G -il-o-------
Device:tp30 drives_available:0 archive_drives:3
Catalog:
sg.004977 capacity: 20.0G space: 18.0G -il-o-b-----
sg.004978 capacity: 20.0G space: 0 -il-o-b-----
sg.004979 capacity: 20.0G space: 10.4G -il-o-b-----
sg.004975 capacity: 20.0G space: 18.0G -il-o-b-----
sg.004970 capacity: 20.0G space: 18.0G -il-o-b-----
sg.004971 capacity: 20.0G space: 13.1G -il-o-b-----
.
.
.
Archive sets:
allsets
reserve: set//
allsets.1
.reserve: set//
allsets.2
archmax: 5G
.reserve: set//
allsets.3
.reserve: set//
allsets.4
.reserve: set//
all.1
.reserve: set//
media: mo
Volumes:
mo0001
mo0002
Total space available: 2.1G
big.1
.reserve: set//
media: sg
Volumes:
004977
004979
004975
004970
004971
Total space available: 77.5G
big.2
.archmax: 5G
.reserve: set//
media: sg
Volumes:
004977
004979
004975
004970
004971
Total space available: 77.5G
samfs1.1
.reserve: set//
media: mo
Volumes:
mo0001
mo0002
Total space available: 2.1G
SEE ALSO
archiver.cmd(4), sam-archiverd(1M), sam-arcopy(1M), sam-
arfind(1M)
|