DEFINE STGPOOL（定义保留存储池）

在线编辑

使用此命令可定义保留存储池。 此类型的存储池用于存储保留集中的服务器所保留的数据的副本。 数据从主存储器复制到磁带或云对象存储器上的保留存储池。

使用保留存储池，您可以优化在站外位置存储保留数据的过程。 您可以将长期数据与您希望短期保留的数据分隔开。 通过使用保留存储池，你可以减少对其他维护活动（如回收）的需要，如果将长期数据与为恢复运行而保存的短期数据存储在一起，则需要这些活动。
保留副本存储规则: 创建保留存储池时，将同时自动创建同名的保留副本存储规则。 为新规则设置了 MAXPROCESS 参数值，用于指定每个存储池的最大并行复制进程数。 对于云存储池， MAXPROCESS 参数值为 8。 对于磁带存储池，缺省情况下 MAXPROCESS 参数值为 8。 但是，如果目标存储池的磁带库具有的磁带机少于 8 个，那么 MAXPROCESS 参数值就是磁带机数。

保留副本存储规则每天运行一次，以将保留集数据从主存储复制到保留存储池。 要立即运行存储规则，您可以发出 START STGRULE 命令。

特权类

要发出此命令，您必须拥有系统特权。

语法

读取语法图跳过可视语法图 DEFine STGpool Pool_Name 设备类名称POoltype=RETentionPOoltype=RETentionDESCription=描述ACCess=READWriteACCess=READWriteREADOnlyUNAVailableREClaim=100REClaim=percentRECLAIMPRocess=1RECLAIMPRocess=处理COLlocate=NoCOLlocate=GRoupNODeFIlespaceNo MAXSCRatch = 处理1 REUsedelay=0REUsedelay=天OVFLOcation=位置COMPRession=Yes2COMPRession=YesNoENCrypt=Yes3ENCrypt=YesNo
注：
  • 1 定义分配给 CLOUD 设备类的保留存储池时。 此参数不是必需参数。
  • 2 仅在定义分配给 CLOUD 设备类的保留存储池时指定 COMPRESSION 参数。
  • 3 仅在定义分配给 CLOUD 设备类的保留存储池时指定 ENCRYPT 参数。

参数

pool_name (必需)
指定要定义的存储池的名称。 此名称必须唯一，且最大长度为 30 个字符。
device_class_name (必需)
指定设备类名称，以将此存储池分配给它。 设备类名称的最大长度为 30 个字符。 请指定下列其中一个设备类：
  • 3592
  • LTO
  • Ecartridge
  • 云
限制: 以下设备类不适合长期数据保留，因此不支持保留存储池:
  • 文件
  • 3590
  • Generictape
POoltype= RETention
指定您想要定义保留存储池。 要定义保留存储池，您必须指定 POOLTYPE=RETENTION。
DESCription
指定保留存储池的描述。 此参数是可选的。 该描述的最大长度为 255 个字符。 如果描述包含空白字符，请将该描述括在引号中。
ACCess
指定客户机节点和服务器进程（例如，回收）访问该存储池中的文件的方式。 此参数是可选的。 缺省值为 READWRITE。 可指定以下值：
READWrite
指定客户机节点和服务器进程可以读或写存储在存储池卷中的文件。
READOnly
指定客户机节点只能读取存储池卷中的文件。

服务器进程可在此存储池的卷之间移动文件。 但是，不允许从该存储池外部的卷对该存储池中的卷执行新的写操作。

UNAVailable
指定客户机节点不能访问存储在存储池卷中的文件。

服务器进程可在此存储池的卷之间移动文件，也可将此存储池中的文件移动或复制到另一个存储池。 但是，不允许从该存储池外部的卷对该存储池中的卷执行新的写操作。

REClaim
根据卷中的可回收空间百分比，指定服务器回收该卷的时间。 可回收空间是已到期或已从 IBM Storage Protect 数据库中删除的文件所占用的空间量。

回收通过将任何剩余的未到期文件从一个卷移动到另一个卷，使卷上的碎片空间和保留文件所占用的空间可以再次使用。 此操作使原始卷可以重新使用。 此参数是可选的。 可以指定范围 1 - 100 中的整数。 缺省值为 100。

重要事项: 回收处理不会回收处于 ONSITERETRIEVE 或 RESTOREONLY 状态的卷，因为这些卷是为了复原数据而在现场进行的，而不会将数据移动到其他卷。 如果您站内返回保留存储池卷以通过发出 MOVE RETMEDIA 命令并指定 TOSTATE=ONSITERETRIEVE 或 TOSTATE=RESTOREONLY 参数值来复原数据，那么存储器回收处理将跳过这些卷。 要符合回收处理条件，保留存储池卷必须处于 MOUNTABLE 状态。

如果卷上的可回收空间百分比大于存储池的可回收阈值，那么服务器确定卷是可回收候选项。

如果不使用缺省值而指定此参数的值为百分之五十或更大的值，这样存储在两个卷上的文件可以合并到一个输出卷上去。

限制: 对于非现场的保留存储池卷，无法进行回收，因为在现场位置可能没有任何版本的文件可用于回收过程。
RECLAIMPRocess
指定用于回收此存储池中的卷的并行进程数。 此参数是可选的。 请输入 1 - 999 范围内的值。 缺省值为 1。
计算该参数的值时，请考虑以下回收处理所需的资源：
  • 顺序存储池的数量。
  • 可专用于此操作的逻辑磁带机和物理磁带机的数量。
为了访问顺序卷， IBM Storage Protect 使用安装点和物理驱动器。

例如，假设您希望同时从两个顺序存储池回收卷，且希望为每个存储池指定四个进程。 存储池具有相同的设备类。 每个进程将需要两个装载点和两个磁带机。 （一个磁带机用于输入卷，另一个磁带机用于输出卷）。 要同时运行 8 个回收进程，总共至少需要 16 个装载点和 16 个磁带机。 存储池设备类的安装限制必须至少为 16。

您可以为每个保留存储池指定一个或多个回收进程。 您可以为单个保留存储池指定多个并发回收进程。 这样，您可以更好地利用可用磁带机。 如果不需要多个并行处理，请将 RECLAIMPROCESS 参数的值指定为 1。

COLlocate
指定当数据属于下列其中一个候选项时，服务器是否尝试将数据存储在尽可能少的卷上：
  • 单个客户机节点
  • 一组文件空间
  • 一组客户机节点
  • 客户机文件空间
此参数是可选的。 缺省值为 NO。

并置操作可减少用于恢复操作的顺序存取介质安装的数目。 但是，并置操作将增加并置文件以进行存储所需的服务器时间量，并增加所需卷数。

可以指定下列其中一个选项：
No
指定禁用并置。 服务器在选择新卷前尝试使用每个卷上的所有可用空间。
GRoup
指定在组级别对客户机节点或文件空间启用并置。 对于并置组，服务器会尝试将属于同一并置组的节点或文件空间的数据放在尽可能少的卷中。

如果指定了 COLLOCATE=GROUP 但未定义任何并置组，或者未向并置组添加节点或文件空间，那么将按节点对数据进行并置。 将客户机节点或文件空间编组到并置组中时，请考虑使用磁带。

例如，如果基于磁带的存储池包含节点中的数据，并且您指定了 COLLOCATE=GROUP，那么服务器将完成下列操作：
  • 按组对已分组节点的数据进行并置。 在可能的情况下，服务器将对属于单个磁带或尽可能少的磁带上的一组节点的数据进行并置。 单一节点的数据也可以分布到与组相关联的多个磁带上。
  • 按节点对未分组节点的数据进行并置。 在可能的情况下，服务器会对单个磁带上单个节点的数据进行存储。 在使用任何其他磁带上的可用空间之前，将使用已具有该节点的数据的所有可用磁带。
如果基于磁带的存储池包含已分组文件空间中的数据，并且您指定了 COLLOCATE=GROUP，那么服务器将完成下列操作：
  • 仅按组对已分组文件空间的数据进行并置。 在可能的情况下，服务器将对属于单一磁带或尽可能少的磁带上的一组文件空间的数据进行并置。 单一文件空间的数据也可以分布到与组相关联的多个磁带上。
  • 按节点并置数据（对于未明确地向文件空间并置组定义的文件空间）。 例如，NODE1 具有名为 A、B、C、D 和 E 的文件空间。 文件空间 A 和 B 属于文件空间并置组，但 C、D 和 E 不属于。 文件空间 A 和 B 将由文件空间并置组并置，而 C、D 和 E 将按节点并置。

这些数据将并置在顺序存取量最低的卷中。

NODe
指定在客户机节点级启用并置。 对于并置组，服务器会尝试将一个节点的数据放在尽可能少的卷中。 如果该节点有多个文件空间，那么服务器不会尝试对这些文件空间进行并置。 为了兼容较早版本，服务器仍接受 COLLOCATE=YES，以指定在客户机节点级别启用并置。

如果存储池包含属于并置组的节点的数据，并且您指定了 COLLOCATE=NODE，那么将按节点对数据进行并置。

FIlespace
指定按文件空间级别对客户机节点启用并置。 服务器会尝试将一个节点和文件空间的数据放在尽可能少的卷中。 如果节点有多个文件空间, 那么服务器会尝试将不同文件空间的数据放在不同的卷上。
MAXSCRatch
指定服务器可以为此存储池请求的临时卷的最大数目。 可以指定范围 0 - 100000000 中的整数。 通过允许服务器根据需要请求临时卷，您避免了不得不定义每个要使用的卷。

为此参数指定的值用于估算保留存储池中可用卷的总数以及保留存储池的相应估算容量。

将自动在临时卷为空时把它们从存储池中删除。 但是，如果临时卷的访问方式是 OFFSITE，那么直到更改访问方式之后才会从保留存储池中删除卷。 然后，管理员可以查询服务器中是否存在空的、站外临时卷并将这些卷返回到站内位置。

提示: 对于使用虚拟卷并存储少量数据的服务器到服务器操作，请考虑为 MAXSCRATCH 参数指定一个高于您通常为其他类型卷的写操作指定的值的值。 对虚拟卷执行写操作后， IBM Storage Protect 会将该卷标记为 FULL ，即使未达到设备类定义上的 MAXCAPACITY 参数的值也是如此。 服务器不会将虚拟卷保持为 FILLING 状态，也不会对其进行追加。 如果 MAXSCRATCH 参数的值太小，那么服务器到服务器的操作可能会失败。
REUsedelay
指定了在所有文件被删除后，在可以重新写入卷或者将卷返回到临时池之前必须经过的天数。 此参数是可选的。 可以指定范围 0 - 9999 中的整数。 缺省值为 0，这意味着一从某卷删除所有的文件就可以改写该卷或返回到临时池。
需求: 使用此参数可确保将数据库复原到较低级别时，对保留存储池中文件的数据库引用仍然有效。 必须将此参数设置为这样一个值：大于您打算将最早的数据库备份保留的天数。 为此参数指定的天数必须与为 SET DRMDBBACKUPEXPIREDAYS 命令指定的天数相同。
OVFLOcation
指定存储池的溢出位置。 服务器将此位置名分配给某个卷，该卷是由某命令从库中弹出的。 此参数是可选的。 位置名称的最大长度可为 255 个字符。 如果位置名称中包含空白字符，请将位置名称用引号引起来。
COMPRession
指定数据在存储池中是否压缩。 仅当您定义了分配给 CLOUD 设备类的保留存储池时，才指定此参数。 此参数是可选的。 您可指定下列其中一个值：
No
指定在保留存储池中未压缩的数据。
Yes
指定在保留存储池中已压缩的数据。 此值是缺省值。

更改 COMPRESSION 参数值只会影响在更改值后写入存储池的数据。 例如，如果 COMPRESSION 参数值为 NO，并且您将值更改为 YES，那么存储池中的现有数据将保持未压缩。 只有写入到存储池的新数据才会被压缩。

您可以发出 QUERY STGPOOL 命令以查看是否压缩了具有 CLOUD 设备类的存储池中的数据。 如果要压缩存储池中的数据，可以在存储池中启用压缩，然后使用 MOVE DATA 命令将数据移动到新的压缩卷中。 您可以将卷的数据移动到同一保留存储池中的新卷。

ENCrypt
指定是否在存储池中加密数据。 仅当您定义了分配给 CLOUD 设备类的保留存储池时，才指定此参数。 此参数是可选的。 您可指定下列其中一个值：
No
指定在保留存储池中未加密的数据。
Yes
指定数据已在保留存储池中加密。 此值是缺省值。

更改 ENCRYPT 参数值只会影响在更改值后写入存储池的数据。 例如，如果 ENCRYPT 参数值为 NO，而您将该值更改为 YES，那么存储池中的现有数据将保持未加密状态。 只有写入到存储池的新数据才会被加密。

您可以发出 QUERY STGPOOL 命令以查看是否加密了具有 CLOUD 设备类的存储池中的数据。 如果要对存储池中的数据进行加密，可以在存储池中启用加密，然后使用 MOVE DATA 命令将数据移动到新的加密卷中。 您可以将卷的数据移动到同一保留存储池中的新卷。

示例：使用 LTO 磁带设备类定义保留存储池

定义一个保留存储池，将其命名为 RETENTIONPOOL_LTO9 LTO 磁带设备类（设备类型为 LTO）。 按节点启用文件的并置。 允许此存储池最多有 5 个临时卷。
define stgpool retentionpool_lto9 lto pooltype=retention collocate=node maxscratch=5

相关命令

表 1. 与 DEFINE STGPOOL 相关的命令
命令 描述
删除 STGPOOL 从服务器存储器删除存储池。
移动数据 将数据从指定存储池卷移动到另一个存储池卷。
查询 STGPOOL 显示关于存储池的信息。
更新 STGPOOL（保留） 更新保留存储池。
更新 STGRULE（保留） 更新有关复制保留数据的存储规则。