关于 stager.cmd 文件

关于 `stager.cmd` 文件

在 stager.cmd 文件中，指定要覆盖默认行为的指令。您可以对回写程序进行配置，以便立即回写文件、从不回写文件、回写部分文件以及指定其他回写操作。例如，指定 never-stage 属性对访问大型文件中小型记录的应用程序有益，因为不必联机回写文件即可从归档介质直接访问数据。

本节将介绍回写程序指令。有关回写程序指令的更多信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"stager.cmd(4)"。如果您使用的是 SAM-QFS Manager 软件，则可以通过 "File System Summary"（文件系统摘要）页或 "File System Details"（文件系统详细信息）页来控制回写。您可以浏览文件系统并查看各个文件的状态，可以使用过滤器查看某些文件并选择要回写的特定文件。可以选择从哪个副本回写，也可以让系统选择该副本。

示例 15-1 stager.cmd 文件

以下示例显示了设置所有可能指令后的 stager.cmd 文件。

# This is stager.cmd file /etc/opt/SUNWsamfs/stager.cmd
drives=dog 1
bufsize=od 8 lock
logfile=/var/adm/stage.log
maxactive=500

如何创建 `stager.cmd` 文件

在 /etc/opt/SUNWsamfs/stager.cmd 文件中，根据以下各节的信息添加控制站点回写的指令：
保存并关闭 stager.cmd 文件。
传播文件更改并重新启动系统。
```
# samd config
```

`drives` 指令：指定进行回写的驱动器数量

默认情况下，回写程序在回写文件时使用所有可用的驱动器。如果回写程序使所有驱动器处于繁忙状态，则会影响归档程序的活动。drives 指令用于指定回写程序可用的驱动器数量。此指令的格式如下：

drives = library count

参数	定义
library	`mcf` 文件中出现的库的系列集名。
count	所要使用的驱动器的最大数量。默认情况下，此数量与在 `mcf` 文件中为该库配置的驱动器数量相同。

示例 15-2 drives 指令

下面的示例指定，dog 系列集的库中只有一个驱动器用于回写文件：

drives = dog 1

`bufsize` 指令：设置回写缓冲区大小

默认情况下，要回写的文件先被读取到缓冲区的内存中，然后再从归档介质恢复到磁盘高速缓存。使用 bufsize 指令指定缓冲区大小，还可以选择锁定缓冲区。这些操作可以改善性能。您可以尝试各种 buffer-size 值。该指令的格式如下：

bufsize = media buffer-size [lock]

参数	定义
media	指定 `mcf`(4) 手册页中列出的某归档介质类型。
buffer-size	一个介于 2 到 8192 的数字。默认值为 16。此值乘以该介质类型的 `dev_blksize` 值，计算结果即为所使用的缓冲区大小。`dev_blksize` 的值是在 `defaults.conf` 文件中指定的。为 `buffer-size` 指定的数值越大，所使用的内存就越多。有关更多信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"defaults.conf(4)"。
`lock`	`lock` 参数指明回写程序在回写归档副本时应当使用锁定的缓冲区。如果指定 `lock`，回写程序将在复制操作期间在内存中的回写缓冲区上设置文件锁定。这可以避免由于为每一个 I/O 请求锁定和取消锁定缓冲区而造成的开销，从而减少占用系统 CPU 的时间。仅在配有大量内存的大型系统上，才有必要指定 `lock` 参数。如果内存不足，则可能会导致内存用尽。只有已为需要回写的文件启用直接 I/O 时，`lock` 参数才有效。默认情况下，不会指定 `lock` 参数，并且文件系统会在所有直接 I/O 缓冲区上设置锁定（包括用于回写的缓冲区）。有关启用直接 I/O 的更多信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"setfa(1)"、《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"sam_setfa(3)"或《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"mount_samfs(1M)"上的 `-O forcedirectio` 选项。

`logfile` 指令：指定日志文件

可以请求 SAM-QFS 软件收集文件回写事件信息，并将此信息写入日志文件中。默认情况下，不写入任何日志文件。logfile 指令用于指定回写程序可在其中写入记录信息的日志文件。回写程序在日志文件中写入一行或多行有关每个已回写文件的信息。该行中包括文件名、回写日期和时间以及卷序列号 (volume serial number, VSN) 等信息。该指令的格式如下：

logfile=filename [event]

参数

定义

filename

指定一个全路径名。

event

指定一个或多个回写事件。如果要指定多个事件，请使用空格将各个事件分隔开。可能的事件规范如下：

all－记录所有回写事件。

start－记录文件开始回写的时间。

finish－记录文件结束回写的时间。默认启用。

cancel－记录操作员取消回写操作的时间。默认启用。

error－记录回写错误。默认启用。

示例 15-3 指定回写程序日志文件

以下指令将创建 /var/adm/stage.log 文件：

logfile=/var/adm/stage.log

示例 15-4 回写程序日志文件

S 2003/12/16 14:06:27 dk disk01 e.76d 2557.1759 1743132 /sam1/testdir0/filebu 1 root other root 0 -
F 2003/12/16 14:06:27 dk disk01 e.76d 2557.1759 1743132 /sam1/testdir0/filebu 1 root other root 0 -
S 2003/12/16 14:06:27 dk disk02 4.a68 1218.1387 519464 /sam1/testdir1/fileaq 1 root other root 0 -
S 2003/12/16 14:06:43 dk disk01 13.ba5 3179.41 750880 /sam1/testdir0/filecl 1 root other root 0 -
F 2003/12/16 14:06:43 dk disk01 13.ba5 3179.41 750880 /sam1/testdir0/filecl 1 root other root 0 -
S 2003/12/16 14:06:59 dk disk01 17.167b 1155.1677 1354160 /sam1/testdir0/filedb 1 root other root 0  /
-
F 2003/12/16 14:06:59 dk disk01 17.167b 1155.1677 1354160 /sam1/testdir0/filedb 1 root other root 0  /
-
S 2003/12/16 14:06:59 dk disk02 f.f82 3501.115 1458848 /sam1/testdir1/filecb 1 root other root 0 -
S 2003/12/16 14:07:15 dk disk01 1f.473 1368.1419 636473 /sam1/testdir0/fileed 1 root other root 0 -
S 2003/12/16 14:07:15 dk disk02 16.f15 3362.45 1065457 /sam1/testdir1/filecz 1 root other root 0 -
S 2003/12/16 14:07:31 dk disk01 23.201d 3005.1381 556807 /sam1/testdir0/fileeq 1 root other root 0 -
S 2003/12/16 14:07:47 dk disk01 26.c4d 2831.1113 1428718 /sam1/testdir0/fileez 1 root other root 0 -
S 2003/12/16 14:07:47 dk disk02 1b.835 3736.59 1787855 /sam1/testdir1/filedp 1 root other root 0 -

下表介绍了回写程序日志文件字段的内容。

字段	示例值	内容描述
1	S	回写活动－`S` 表示启动，`C` 表示已取消，`E` 表示错误，`F` 表示已完成。
2	2003/12/16	回写操作发生的日期，格式为 yyyymm`/`dd。
3	14:06:27	回写操作的时间，格式为 hhmm`:` ss。
4	dk	归档介质类型。有关介质类型的信息，请参见《Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual》中的"mcf(4)"。
5	disk01	VSN。
6	e.76d	介质上归档文件（`tar` 文件）开头的物理位置和归档文件中的文件偏移量（采用十六进制格式）。
7	2557.1759	Inode 编号和生成编号。为了保持唯一性，除了 inode 编号之外，还要使用生成编号，因为 inode 编号可以重复使用。
8	1743132	文件的大小。
9	`/sam1/testdir0/filebu`	文件的名称。
10	1	归档副本数。
11	root	文件的用户 ID。
12	other	文件的组 ID。
13	root	请求者的组 ID。
14	0	待回写文件所在驱动器的设备序号。
15	`-`	此字段中的 `V` 表示针对文件使用数据验证。

`maxactive` 指令：指定回写请求的数量

可以使用 maxactive 指令指定一次可激活的回写请求的数量。该指令的格式如下：

maxactive=number

默认情况下，number 为 4000。允许的最小数量为 1。允许的最大数量为 500,000。

以下示例指定，可以同时存在于队列中的回写请求数量不超过 500 个：

maxactive=500

跳过导航链接
退出打印视图
	Sun Storage Archive Manager 5.3 配置和管理指南 Sun QFS and Sun Storage Archive Manager 5.3 Information Library (简体中文)

如何创建 stager.cmd 文件

drives 指令：指定进行回写的驱动器数量

bufsize 指令：设置回写缓冲区大小

logfile 指令：指定日志文件

maxactive 指令：指定回写请求的数量