REPLICATE NODE（复制属于客户机节点的文件空间中的数据）

使用此命令可复制属于一个或多个客户机节点或定义的客户机节点组的文件空间中的数据。

发出此命令时，将启动一个进程，其中会根据复制规则对属于指定客户机节点的数据进行复制。 在此进程中，将删除不再存储于源复制服务器中、但位于目标复制服务器中的文件。

如果已对此命令指定的客户机节点运行节点复制进程，那么将跳过此节点，并对启用复制的其他节点启动复制操作。

节点复制进程完成之后，可以在目标复制服务器上启动恢复进程。 仅在满足以下所有条件时才恢复文件：
  • 在源和目标复制服务器上安装 Tivoli® Storage Manager V7.1.1 或更高版本。
  • REPLRECOVERDAMAGED 系统参数设置为 ON。 可以使用 SET REPLRECOVERDAMAGED 命令设置此系统参数。
  • 源服务器包含至少一个在节点中标记为受损并且正在复制的文件。
  • 在发生损坏之前已复制节点数据。
下表描述设置如何影响受损的已复制文件的恢复。
限制： 不能将 REPLRECOVERDAMAGED 参数用于目录/容器或云存储池。
表 1. 影响受损文件恢复的设置
REPLRECOVERDAMAGED 系统参数的设置 REPLICATE NODE 命令上 RECOVERDAMAGED 参数的值 REGISTER NODE 和 UPDATE NODE 命令上的 RECOVERDAMAGED 参数 结果
OFF YES、NO 或不指定 YES 或 NO 在节点复制期间，将发生标准复制，不从目标复制服务器恢复受损文件。
OFF ONLY YES 或 NO 显示错误消息，因为当 REPLRECOVERDAMAGED 系统参数设置为 OFF 时无法恢复文件。
ON YES YES 或 NO 在节点复制期间，将发生标准复制，并从目标复制服务器恢复受损文件。
ON No YES 或 NO 在节点复制期间，将发生标准复制，不从目标复制服务器恢复受损文件。
ON ONLY YES 或 NO 从目标复制服务器恢复受损文件，但不会发生标准节点复制。
ON 未指定 YES 在节点复制期间，将发生标准复制，并从目标复制服务器恢复受损文件。
ON 未指定 No 在节点复制期间，将发生标准复制，不从目标复制服务器恢复受损文件。
提示： 当在节点复制期间发出了 QUERY PROCESS 命令时，针对已完成的复制数，输出可能会显示意外结果。 原因是，出于节点复制目的，每个文件空间将视为包含三个逻辑文件空间：
  • 一个用于备份对象
  • 一个用于归档对象
  • 一个用于空间受管对象
缺省情况下，QUERY PROCESS 命令针对每个逻辑文件空间生成相应结果。 其他因素也会影响 QUERY PROCESS 命令的输出：
  • 如果文件空间的复制规则设置为 NONE，那么正在处理的文件空间的计数中不会包含该文件空间。
  • 如果在 REPLICATE NODE 命令中指定了数据类型，那么要处理的文件空间的计数中仅包含这些数据类型，减去排除的任何文件空间。

在作为复制数据的源的服务器上发出此命令。

特权级别

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

语法

阅读语法图跳过直观语法图
                 .-,-----------------------.   
                 V                         |   
>>-REPLicate 节点------+-node_name-------+---+-------------------->
                     '-node_group_name-'       

   .-*------------------------------.   
>--+--------------------------------+--------------------------->
   |       .-,------------------.   |   
   |  (1)  V                    |   |   
   '-----+-----filespace_name---+-+-'   
         | .-,------------.       |     
         | V        (2)   |       |     
         '-----FSID-------+-------'     

   .-NAMEType--=--SERVER-------.   
>--+---------------------------+-------------------------------->
   '-NAMEType--=--+-SERVER---+-'   
                  +-UNIcode--+     
                  |      (2) |     
                  '-FSID-----'     

   .-CODEType--=--BOTH-----------.   
>--+-----------------------------+------------------------------>
   '-CODEType--=--+-BOTH-------+-'   
                  +-UNIcode----+     
                  '-NONUNIcode-'     

   .-DATAtype--=--ALl------------------.   
>--+-----------------------------------+------------------------>
   |              .-,----------------. |   
   |              V                  | |   
   '-DATAtype--=----+-ALl----------+-+-'   
                    +-BACKUP-------+       
                    +-BACKUPActive-+       
                    +-ARCHive------+       
                    '-SPACEManaged-'       

   .-PRIORITY--=--ALL--------.   
>--+-------------------------+---------------------------------->
   '-PRIORITY--=--+-ALL----+-'   
                  +-HIGH---+     
                  '-NORMAL-'     

   .-MAXSESSions--=--10------------------.   
>--+-------------------------------------+---------------------->
   '-MAXSESSions--=----number_sessions---'   

   .-Preview--=--No---------------------------------.   
>--+------------------------------------------------+----------->
   '-Preview--=--+-No-----------------------------+-'   
                 |      .-LISTfiles--=--No------. |     
                 '-Yes--+-----------------------+-'     
                        '-LISTfiles--=--+-No--+-'       
                                        '-Yes-'         

   .-Wait--=--No------.                                    
>--+------------------+--+-----------------------------+-------->
   '-Wait--=--+-No--+-'  '-RECOVERDamaged--=--+-Yes--+-'   
              '-Yes-'                         +-No---+     
                                              '-Only-'     

   .-FORCEREConcile--=--No------.   
>--+----------------------------+------------------------------><
   '-FORCEREConcile--=--+-No--+-'   
                        '-Yes-'     
注:
  1. 请勿在同一命令中混用文件空间标识 (FSID) 和文件空间名称。
  2. 如果您针对客户机节点名称使用通配符，那么请不要指定 FSID。

参数

node_name 或者 node_group_name（必需）
指定将复制其数据的客户机节点名称或定义的客户机节点组的名称。 也可指定客户机节点名称和客户机节点组名称的组合。 要指定多个客户机节点名称或客户机节点组名称，请用逗号分隔各个名称，并且中间不要插入空格。 也可以在客户机节点名称中使用通配符，但不能在客户机节点组名称中使用。 已检查指定客户机节点中所有文件空间的复制规则。
filespace_name or FSID

指定要复制的文件空间名称或文件空间标识 (FSID)。 名称或者 FSID 是可选的。 如果未指定名称或 FSID，那么指定客户机节点的所有文件空间中的数据都可进行复制。

filespace_name
指定将复制其数据的文件空间的名称。 文件空间名称是区分大小写的。 要确定文件空间的正确大小写，请发出 QUERY FILESPACE 命令。 用逗号分隔多个名称，中间不要插入空格。 指定名称时，可以使用通配符。

对于具有为 Unicode 启用的文件空间的客户机的服务器，可能需要转换文件空间名称。 例如，服务器可能需要将名称从服务器代码页转换为 Unicode。 有关详细信息，请参阅 NAMETYPE 参数。 如果您未指定文件空间名称，或者指定单个通配符来代表名称，那么可以使用 CODETYPE 参数将操作限制在 Unicode 文件空间或非 Unicode 文件空间范围内。

FSID
指定要复制的文件空间的文件空间标识。 服务器使用 FSID 来查找要复制的文件空间。 要确定文件空间的 FSID，请发出 QUERY FILESPACE 命令。 用逗号将多个 FSID 隔开，且不要插入空格。 如果您指定一个 FSID，NAMETYPE 参数的值必须是 FSID。
NAMEType
指定想要服务器如何来解释所输入的文件空间名称。 对于为 Unicode 启用并使用 Windows、Macintosh OS X 或 NetWare 操作系统的 Tivoli Storage Manager 客户机，可使用此参数。
仅在输入了部分限定文件空间名称或完全限定文件空间名称的情况下使用此参数。 缺省值是 SERVER。 可指定下列某个值：
SERVER
服务器使用服务器代码页来解释文件空间名称。
UNIcode
服务器将文件空间名称从服务器代码页转换为 UTF-8 代码页。 转换是否成功取决于名称中的字符以及服务器代码页。 如果字符串中包含服务器代码页中不可用的字符，或者服务器无法访问系统转换例程，那么转换可能失败。
FSID
服务器通过使用文件空间标识来解释文件空间名称。
CODEType
指定要包含在节点复制过程中的文件空间的类型。 仅当为文件空间名称输入一个单一的通配符字符时，才使用此参数。 缺省值为 BOTH，指定不考虑代码页类型仍将包含文件空间。 可指定下列某个值：
UNIcode
指定仅使用 Unicode 的文件空间。
NONUNIcode
指定不使用 Unicode 的文件空间。
BOTH
指定所有文件空间而不考虑代码页类型。
DATAtype
指定要复制的数据类型。 根据适用于数据类型的复制规则来复制数据。 此参数是可选参数。 您可以指定一个或多个数据类型。 如果您未指定数据类型，那么将复制所有备份、归档和空间受管数据。 用逗号分隔多个数据类型，中间不要插入空格。 不可使用通配符。 可指定下列某个值：
ALl
根据分配给该数据类型的规则来复制文件空间中的所有备份、归档和空间受管数据。 例如，假设 NODE1 具有单个文件空间。 可应用以下复制规则：
  • 文件空间中的备份和归档数据的文件空间规则设置为 ALL_DATA。
  • 空间受管数据的文件空间规则设置为 DEFAULT。
  • 空间受管数据的客户机节点规则设置为 NONE。
如果发出 REPLICATE NODE NODE1 DATATYPE=ALL，那么将仅复制备份数据和归档数据。
BACKUP
如果控制复制规则是 ALL_DATA、ACTIVE_DATA、ALL_DATA_HIGH_PRIORITY 或 ACTIVE_DATA_HIGH_PRIORITY，那么将复制文件空间中的活动和不活动的备份数据。
BACKUPActive
如果控制复制规则是 ACTIVE_DATA 或 ACTIVE_DATA_HIGH_PRIORITY，那么将仅复制文件空间中的活动备份数据。
ARCHive
如果控制复制规则是 ALL_DATA 或 ALL_DATA_HIGH_PRIORITY，那么仅复制文件空间中的归档数据。
SPACEManaged
如果控制复制规则是 ALL_DATA 或 ALL_DATA_HIGH_PRIORITY，那么将仅复制文件空间中的空间受管数据。
PRIority
根据复制规则的优先级来指定要复制的数据。 可指定下列某个值：
All
如果控制复制规则是 ALL_DATA、ACTIVE_DATA、ALL_DATA_HIGH_PRIORITY 或 ACTIVE_DATA_HIGH_PRIORITY，那么将复制文件空间中的所有数据。
High
仅复制文件空间中控制复制规则为 ALL_DATA_HIGH_PRIORITY 或 ACTIVE_DATA_HIGH_PRIORITY 的数据。
Normal
仅复制文件空间中控制复制规则为 ALL_DATA 或 ACTIVE_DATA 的数据。
MAXSESSions
指定用来将数据发送到目标复制服务器所允许的最大数据会话数。 此参数是可选参数。 值可以是 1 - 99。 缺省值为 10。 增加会话数可提高节点复制吞吐量。
设置此值时，请考虑可专用于此复制进程的逻辑磁带机和物理磁带机的数量。 为了访问顺序存取卷，Tivoli Storage Manager 使用安装点，如果设备类型不是 FILE，那么还要使用物理磁带机。 可用安装点和磁带机的数量取决于以下因素：
  • 其他 Tivoli Storage Manager 和系统活动
  • 所涉及的顺序存取存储池的设备类的安装限制
请确保有足够的可用安装点和驱动器，以便完成节点复制过程。 每个复制会话都可能需要在源和目标复制服务器上具有一个安装点以用于存储池卷。 如果设备类型不是 FILE，那么每个会话可能需要在源和目标复制服务器上还具有一个磁带机。

设置 MAXSESSIONS 的值时，还需考虑源复制服务器和目标复制服务器的可用带宽和处理器容量。

提示：
  • MAXSESSIONS 参数所指定的值仅适用于数据会话。 数据会话是将数据发送到目标复制服务器的会话。 但是，如果发出 QUERY SESSION 命令，那么会话总数可能超过数据会话数。 导致此差异的原因是用于查询和设置复制操作的短期控制会话。
  • MAXSESSIONS 参数的值表示允许的最大会话数。 用于复制的会话数取决于要复制的数据量。 如果仅复制少量数据，那么通过增加会话数不会得到任何好处。 会话总数可能小于 MAXSESSIONS 参数指定的值。
Preview
指定是否预览数据。 此参数是可选参数。 缺省值为 NO。 可指定下列某个值：
No
指定将数据复制到目标服务器，但是不预览改数据。
Yes
指定将预览数据，但不进行复制。 如果指定了 PREVIEW=YES，那么将只显示必须物理安装的卷（例如磁带卷）。 不显示分配到具有 FILE 设备类的存储池的卷。

输出中将显示以下信息：

  • 将复制其数据的客户机节点名称。
  • 将进行复制或删除的文件数。
  • 完成节点复制进程所需的估算时间。
  • 将安装的卷列表。
  • 有关已复制的受损数据的信息摘要。 该摘要列出可在复制恢复进程期间恢复的节点数、文件空间数、文件数和字节数。 该摘要仅在指定了 RECOVERDAMAGED=YES 或 RECOVERDAMAGED=ONLY 的情况下列出。

如果从未复制由 REPLICATE NODE 命令所指定的客户机节点数据，并且指定了 PREVIEW=YES，那么在目标复制服务器上将自动定义该节点及其文件空间。

LISTfiles

指定是否列出将进行复制的文件的名称。 此参数是可选参数。 缺省值是 NO。 指定此参数表示 WAIT 参数设置为 YES，并且无法从服务器控制台发出 WAIT 参数。

可指定下列某个值：

No
指定不显示将进行复制的文件的名称。
Yes
指定显示将进行复制的文件的名称。
Wait
指定是否等待服务器在前台完成该命令的处理。 此参数是可选参数。 缺省值为 NO。 可指定下列某个值：
No
指定在后台处理此命令。 要监视 REPLICATE NODE 命令的后台进程，请发出 QUERY PROCESS 命令。
Yes
指定在前台处理命令。 此命令处理完成时才显示消息。 不能从服务器控制台指定 WAIT=YES。
RECOVERDamaged
指定在节点复制进程完成后是否在目标复制服务器上启动恢复进程。 该参数为可选参数，并且它覆盖您定义或更新节点时为 RECOVERDamaged 参数指定的任何值。 可指定下列某个值：
Yes
指定仅当 REPLRECOVERDAMAGED 系统参数设置为 ON 时，才启动复制进程以恢复受损文件。 如果此设置为 OFF，那么不恢复受损文件。
No
指定不恢复受损文件。
Only
指定仅当 REPLRECOVERDAMAGED 系统参数设置为 ON 时，才启动复制进程，仅用于恢复受损文件。 如果此设置为 OFF，那么不恢复受损文件，并且您将接收到未启动恢复的通知。
限制： 如果您为文件恢复指定无效的值和设置组合，那么复制将停止，并显示错误消息。
FORCEREConcile
指定是否将源复制服务器上的所有文件与目标复制服务器上的文件进行比较，并同步这些文件之间的差异。 在 Tivoli Storage Manager V7.1.1 之前，这是复制处理的缺省行为。 在源和目标复制服务器上安装 Tivoli Storage Manager V7.1.1 或更高版本时，初始复制期间会自动完成协调。 初始复制之后，您可以将此参数用于以下目的：
  • 如果源复制服务器和目标复制服务器上的文件不同，那么同步这些文件。
  • 在将复制规则从 ACTIVE_DATA 更改为 ALL_DATA 之后，复制跳过的不活动文件。
  • 在将复制规则从 ALL_DATA 更改为 ACTIVE_DATA 之后，从目标复制服务器删除不活动的文件。
  • 为了确保在使用 ACTIVE_DATA 复制规则时仅复制活动数据，从而使目标复制服务器仅包含活动文件。
  • 再次同步文件，以便在先前已使用或者当前正在使用目标复制服务器上的策略来管理复制的文件时，使目标复制服务器与源复制服务器具有相同的文件。
  • 再同步源和目标复制服务器上的文件（如果使用 DSMSERV RESTORE DB 命令以外的方法将数据库回归至先前的时间点）。
  • 如果在复制文件时此管理类不存在，用于将文件重新绑定到目标复制服务器上的新管理类。 您必须使用在目标复制服务器上定义的策略来管理复制的文件。
切记： 分配 ACTIVE_DATA 规则时，仅针对源复制服务器上的活动文件完成协调。

此参数是可选参数。 可指定下列某个值：

No
指定复制处理不强制执行协调以比较源复制服务器上的所有文件与目标复制服务器上的文件。 而改为由复制处理跟踪自上次复制之后源复制服务器上的文件更改，并将这些更改同步到目标复制服务器。 NO 是缺省值。
Yes
指定复制处理强制执行协调以比较源复制服务器上的所有文件与目标复制服务器上的文件，并将目标复制服务器上的文件与源复制服务器同步。

示例：按数据类型和优先级复制数据

复制属于 PAYROLL 组中所有客户机节点的高优先级活动备份数据和高优先级归档数据。

replicate node payroll datatype=backupactive,archive priority=high

示例：根据指定的复制规则，复制属于某节点的所有数据

NODE1 具有单个文件空间。 可应用以下复制规则：
  • 文件空间规则：
    • 备份数据：ACTIVE_DATA
    • 归档数据：DEFAULT
    • 空间受管数据：DEFAULT
  • 客户机节点规则：
    • 备份数据：DEFAULT
    • 归档数据：ALL_DATA_HIGH_PRIORITY
    • 空间受管数据：DEFAULT
  • 服务器规则：
    • 备份数据：ALL_DATA
    • 归档数据：ALL_DATA
    • 空间受管数据：NONE
replicate node node1 priority=all
文件空间中的活动备份数据将通过正常优先级进行复制。 归档数据通过高优先级进行复制。 空间受管数据不进行复制。

示例：在不启动完整复制进程的情况下恢复受损文件

在不启动完整复制进程的情况下，恢复 PAYROLL 组的客户机节点中的任何受损文件。 请确保 REPLRECOVERDAMAGED 系统参数设置为 ON。 然后，发出以下命令：

replicate node payroll recoverdamaged=only

相关命令

表 2. 与 REPLICATE NODE 相关的命令
命令 描述
CANCEL REPLICATION 取消节点复制进程
QUERY FILESPACE 显示属于客户机的文件空间中数据的相关信息。
QUERY NODE 显示有关一个或多个客户机的部分或完整信息。
QUERY REPLICATION 显示有关节点复制进程的信息。
QUERY REPLNODE 显示关于客户机节点的复制状态的信息。
QUERY REPLRULE 显示有关节点复制规则的信息。
QUERY SERVER 显示有关服务器的信息。
QUERY STATUS 显示服务器参数（例如，SET 命令所选择的参数）的设置。
REGISTER NODE 向服务器定义客户机节点并为该用户设置选项。
REMOVE REPLNODE 从复制中除去节点。
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsPROTECT STGPOOL 保护存储池。
SET REPLRECOVERDAMAGED 指定是否启用节点复制以从目标复制服务器恢复受损文件。
UPDATE FILESPACE 更改文件空间节点复制规则。
UPDATE NODE 更改与客户机节点相关联的属性。
UPDATE REPLRULE 启用或禁用复制规则。
VALIDATE REPLICATION 验证复制的文件空间和数据类型。