geopg(1M) (Sun Cluster Geographic Edition 参考手册)

Sun Cluster Geographic Edition 参考手册

geopg(1M)

引用名 | 概览 | 说明 | 子命令 | 选项 | 操作对象 | 详细说明 | 退出状态 | 示例 | 属性 | 另请参见

引用名

geopg– 创建或管理保护组

概览

/usr/cluster/bin/geopg

-?

/usr/cluster/bin/geopg

-V

/usr/cluster/bin/geopg add-device-group

-p

property

-p

devicegroupname

protectiongroupname

/usr/cluster/bin/geopg add-resource-group

resourcegroup

protectiongroupname

/usr/cluster/bin/geopg create

protectiongroupname

-s

partnershipname

-o

localrole

-d

datareplicationtype

-p

property

-p

/usr/cluster/bin/geopg delete

protectiongroupname

/usr/cluster/bin/geopg get

protectiongroupname

-s

partnershipname

/usr/cluster/bin/geopg list

protectiongroupname

/usr/cluster/bin/geopg modify-device-group

devicegroupname

protectiongroupname

-p

property

-p

/usr/cluster/bin/geopg remove-device-group

devicegroupname

protectiongroupname

/usr/cluster/bin/geopg remove-resource-group

resourcegroup

protectiongroupname

/usr/cluster/bin/geopg set-prop

protectiongroupname

-p

property

-p

/usr/cluster/bin/geopg start

protectiongroupname

-e

-n

/usr/cluster/bin/geopg stop

protectiongroupname

-e

-D

/usr/cluster/bin/geopg switchover

-m

newprimaryclustername

protectiongroupname

-f

/usr/cluster/bin/geopg takeover

-f

protectiongroupname

/usr/cluster/bin/geopg update

protectiongroupname

/usr/cluster/bin/geopg validate

protectiongroupname

说明

geopg 命令可用于配置和维护保护组。您可以执行以下任务：

在参与伙伴关系的两个群集之间配置保护组。该任务包括配置相关联的数据复制参数。
添加或删除资源组和数据复制磁盘设备组。
添加、修改和删除与保护组属性相关联的数据复制参数。
获取特定保护组或所有已定义保护组的当前配置。
激活保护组。
取消激活保护组。
切换保护组的角色。
接管保护组的主角色。

在您可以创建保护组之前，那些将要容纳该保护组的群集必须已处于某个伙伴关系中。

要运行 geopg 命令以创建、修改或删除保护组或数据复制磁盘设备组，您必须拥有适当的基于角色的访问控制 (RBAC) 权限配置文件。

您如果具有超级用户访问权限，则有权执行任何操作。如果您不具有超级用户访问权限，则以下 RBAC 权限适用：

基本 Solaris 用户。通过运行诸如 geopg list、geohb list 或 geops list 等命令，您可以读取有关 Sun Cluster Geographic Edition 实体的信息。
Geo 管理。您可以执行具基本 Solaris 用户访问权限的用户可执行的所有读取操作。您还可以执行管理和配置任务，如 geohb create、geopg switchover、geoadm start 和 geoadm stop 等。

有关详细信息，请参见 rbac(5) 手册页和Sun Cluster Geographic Edition System Administration Guide中的“Sun Cluster Geographic Edition 软件和 RBAC”。

该命令的一般格式如下所示：

geopg [subcommand] [options] [operands]

只有在 options 指定了选项 -?、-o、- V 或 -v 时，subcommand 才可以省略。

该命令的每个选项都有长短两种格式。每个选项的两种格式都会在此手册页的 OPTIONS 部分加以说明。

了解如何启动保护组

geopg start 命令可同时在主群集和辅助群集上激活保护组。这种激活可对保护组内的资源组启动 Sun Cluster Geographic Edition 管理。但根据您所使用的命令格式，以及发出命令时所在的群集，激活保护组的操作也可能不会启动该群集上的资源组。资源组仅在主群集上启动或处于联机状态。

-e 选项定义了 geopg start 命令的作用范围。如果指定 -e local 选项，geopg start 命令将在您发出该命令的群集上运行。如果指定 -e global 选项，geopg start 命令将同时在处于伙伴关系中的两个群集上运行。

该命令的不同格式有以下不同效果：

在主群集上运行 geopg start -e local，在任一群集上运行 geopg start -e global：Sun Cluster Geographic Edition 软件会同时在处于伙伴关系中的两个群集上激活保护组。该软件仅在主群集上使资源组联机。资源组将处于受管理状态。
在辅助群集上运行 geopg start -e local：Sun Cluster Geographic Edition 软件将仅在辅助群集上激活保护组。资源组并未在辅助群集上启动。资源组将处于不受管理状态。

子命令

可支持的子命令如下：

add-device-group

使某个数据复制磁盘设备组成为保护组的一部分。

add-resource-group

使某个应用程序资源组成为保护组的一部分。

如果正在添加的资源组处于联机状态，则在添加该资源组之前，保护组也必须处于活动状态。如果保护组处于非活动状态，而正在添加的资源组又处于联机状态，则 geopg add 命令将失败。

注意 –

如果在您添加处于脱机状态的资源组时保护组已启动，则该资源组仍旧保持脱机状态。要启动处于脱机状态的资源组，请运行命令 geopg start。

create

创建保护组或创建数据复制磁盘设备组。

当您创建保护组时，管理模块会更新本地配置并将此配置更改通知到远程群集。

delete

删除保护组。

get

为已在伙伴群集上创建的保护组创建本地配置。

如果伙伴群集之间已实现连接，则现有保护组的配置会传递到容纳该保护组的伙伴群集中。如果您在伙伴群集之间的连接中断时创建保护组，或在伙伴成员加入伙伴关系之前创建保护组，则必须运行 geopg get 命令来传递配置。

list

显示以下有关保护组的信息：

已定义的保护组
包含在保护组中的资源组
操作状态信息

modify-device-group

修改数据复制磁盘设备组的属性。

remove-device-group

将数据复制磁盘设备组从保护组中删除。

删除数据复制设备组不会停止数据复制，也不会更改该数据复制设备组的数据复制状态。

remove-resource-group

将资源组从保护组中删除。

删除应用程序资源组不会将应用程序资源组的状态更改为脱机。

set-prop

修改保护组的属性。

start

激活保护组。启用该子命令后，群集上保护组的角色便是您配置该保护组时为该群集指定的角色。

start 子命令使用 Sun Cluster 命令将资源和资源组联机。

您可以按以下级别激活保护组：

在所有已配置保护组的群集上。
在主群集或辅助群集上。

有关如何激活保护组，以及激活保护组对保护组内的资源组有何影响的更多信息，请参见本手册页 DESCRIPTION 部分的“了解如何启动保护组”。

激活保护组可导致发生以下事件：

可以验证保护组配置。
群集可以确定操作是否已完成。
可以启动数据复制，具体取决于您所使用的数据复制。

使用 Sun StorageTek Availability Suite 软件时，您只能从主群集启动数据复制。使用 Hitachi TrueCopy 或 EMC Symmetrix Remote Data Facility 软件时，您既可以从主群集启动数据复制，也可以从辅助群集启动数据复制。

对于所有受支持的数据复制软件而言，当您使用该命令的这种格式时，一定不要指定 -n 选项。s
可以启动受保护的应用程序。
如果可以访问伙伴群集，则系统会将保护组激活情况通知给伙伴群集。

注意 –

具有“联机”状态的保护组是活动保护组。

stop

取消激活保护组。您可以在以下级别取消激活保护组：

在所有已配置保护组的群集上。
在主群集或辅助群集上。

停止保护组可导致发生以下事件：

保护组转为非活动状态。
数据复制停止（取决于您正在使用的数据复制）。您可以防止数据复制停止，方法是：在停止保护组之前，将资源组从保护组中删除。

使用 Sun StorageTek Availability Suite 软件时，您只能从主群集停止数据复制。使用 Hitachi TrueCopy 或 EMC Symmetrix Remote Data Facility 软件时，您既可以从主群集也可以从辅助群集停止数据复制。

对于所有受支持的数据复制软件，当使用该命令的这种格式时，一定不要指定 -D 选项。
受保护的应用程序停止。
如果可以访问伙伴群集，系统会将保护组已停止的情况通知给伙伴群集。

switchover

切换保护组中群集的已指定角色。

takeover

不考虑伙伴群集的状态，强制使某群集成为 PRIMARY 群集。

如果从辅助群集发出一条接管命令，而该辅助群集可与伙伴群集通信，则 Sun Cluster Geographic Edition 软件会切换此伙伴群集的角色，从而使之成为新的辅助群集。此操作不同于切换操作。在新的辅助群集上，保护组将被取消激活。

成功完成 geopg takeover 命令后，若要在辅助群集上重新激活保护组，可能需要执行数据恢复和数据同步操作。

注意 –

如果可能，请运行 geopg switchover 命令而不是 geopg takeover 命令来协调伙伴群集双方以避免丢失已复制的数据。

仅当迫切需要新的主群集时再运行 geopg takeover 命令。在此情况下，必须慎重考虑可能发生的数据丢失，以及在辅助群集上修复和重新激活保护组所需的时间。

update

使用伙伴的配置信息重新同步本地保护组的配置信息。

validate

通过对动态值进行完整性检查，来验证本地群集上的保护组。

选项

指令支持以下选项：

-? --help

显示帮助信息。如果使用了该选项，系统将不会执行其他处理。

指定该选项时，既可带有子命令也可不带子命令。

如果指定该选项时不带子命令，则显示该命令的所有子命令的列表。

如果带有子命令，则显示该子命令的使用选项。

一些 shell 可能会将问号理解为特殊字符。请使用引号 (-"?") 或者转义符以避免模式匹配。

-D --only-datarep

指定仅取消激活数据复制，而保护组仍保持活动状态。如果不使用该选项，则会取消激活整个保护组。若要停止数据复制子系统已被停止的保护组，必须重新运行 geopg stop 命令并忽略该选项。

-d datareplicationtype --datarep-type datareplicationtype

指定在保护组的群集间进行数据复制的数据复制机制。

datareptype 必须是下列字符串之一：

avs: 指定数据复制机制为 Sun StorageTek Availability Suite Remote Mirror（安装了修补程序）。
srdf: 指定数据复制机制为动态 EMC Symmetrix Remote Data Facility。
truecopy: 指定数据复制机制为 Hitachi TrueCopy。

-e <local|global> --scope <local|global>

指定是仅在本地群集上运行该命令 (local)，还是在已配置保护组的两个群集上运行该命令 (global)。

-f --force

强制该命令执行操作，不要求用户确认。

-m newprimarycluster --primary newprimarycluster

指定将要成为保护组的主群集的群集的名称。

-n --nodatarep

指定该保护组不应使用数据复制。如果省略该选项，数据复制将与保护组同时启动。

-o localrole --role localrole

当与 create 子命令一同使用时，可将本地群集的角色指定为 PRIMARY 或 SECONDARY 。您可以通过运行 geopg switchover 命令来更改群集的角色。

-p property --property property

设置保护组的属性。

使用名称=语句语句对，指定保护组属性值。可通过使用多个语句实现一次设置多个属性。

有关已定义的属性的信息，请参阅 EXTENDED DESCRIPTION 部分。

-s partnershipname --partnership partnershipname

指定伙伴关系的名称，该保护组应可以在该伙伴关系所包含的群集上被激活。

-V --version

显示命令的版本信息。

指定该选项时，请不要带有子命令、操作对象或其他选项。因为子命令、操作对象或其他选项会被忽略。-V 选项仅显示命令的版本信息，系统不执行其他操作。

操作对象

支持以下操作对象：

devicegroupname

指定要创建的磁盘设备组的名称。

protectiongroupname

指定保护组的名称。如果该选项指定的保护组已存在，则 create 子命令将失败。如果指定的保护组无效，则 modify 子命令将失败。

resourcegroupname

指定一个逗号分隔的资源组列表，以便添加到保护组或从保护组中删除。指定的资源组必须已定义。

必须使保护组处于活动状态，然后才能添加资源组。如果保护组处于非活动状态，而正在添加的资源组处于联机状态，则 geopg add-resource-group 命令会失败。

注意 –

给保护组添加资源组时，如果保护组已经启动，则该资源组将保持脱机状态。您必须通过运行 geopg start 命令来手动启动该资源组。

详细说明

下表列出了属性。这些属性的值均在创建保护组时指定。属性值（如 true 和 false）不区分大小写。有关具体何时可调整属性的信息，请参见属性描述。

保护组通用属性

Description

描述该保护组。

可选属性。

类型：字符串型。

默认值：无。

调整建议：在创建保护组时指定，可在保护组运行时进行调整。

RoleChange_ActionArgs

指定运行角色更改回调 (role-change callback) 命令时，跟随在命令行末尾系统定义参数后的字符串。

可选属性。

类型：字符串型。

默认值：无。

调整建议：在创建保护组时指定，可在保护组运行时进行调整。

RoleChange_ActionCmd

指定当保护组的主群集变化时要运行的可执行命令的绝对路径。该路径应在容纳保护组的所有伙伴群集上均有效。

可选属性。

类型：字符串型。

默认值：无。

调整建议：在创建保护组时指定，可在保护组运行时进行调整。

Timeout

指定运行 geopg 命令（如 start、stop、switchover 和 takeover）后，Sun Cluster Geographic Edition 软件等待响应的最长时间（单位为秒）。如果命令在 timeout 时限内没有返回结果，则 Sun Cluster Geographic Edition 软件将报告操作超时（即使底层命令最终成功完成）。

timeout 时限应用于基于群集的所有操作。如果具有本地作用范围的操作未能在指定的 timeout 时限内完成，则该操作超时。

具全局范围的操作由一个本地群集上的操作和一个远程群集上的操作组成。本地操作和远程操作是分别计时的。因此，如果本地操作未能在指定 timeout 时限内完成，或远程操作未能在指定超时时限内完成，均会造成该全局作用范围操作超时。

例如，以下操作是在本地范围内进行的：

# geopg start -e local protectiongroupname

如果 timeout 属性被设置为 200 秒，当 geopg start 操作未能在 200 秒内完成时，该操作将超时。

您也可以在全局范围内启动相同的操作，如下所示：

# geopg start -e global protectiongroupname

如果 timeout 属性被设置为 200 秒，当 geopg start 操作未能在 200 秒内于本地群集或远程群集上完成，则该操作将超时。如果本地操作耗时 150 秒，远程操作耗时 150 秒，则该操作不超时。

保护组的超时值是估算的。并不是保护组上的所有操作都是按照 timeout 时限计时的。例如，初始化数据结构以及检查操作前提条件的时间是不计算在 timeout 时限里的。

timeout 属性的最大值是 1,000,000 秒。

可选属性。

类型：整数。所要求的最小值至少为 20。

默认值：200 秒。

调整建议：在创建保护组时指定，可在保护组运行时进行调整。

Sun StorageTek Availability Suite 数据复制类型属性

设备组属性：Enable_volume_set

定义是否启用文件中定义的卷集。设置为 True 或 False（不区分大小写）。

可选属性。

类型：布尔值。

调整建议：当设备组被添加到保护组中后，您便无法调整该属性。

默认值：False。

设备组属性：Local_logical_host

定义用于磁盘设备组复制的本地逻辑主机名。请不要在逻辑主机名中使用下划线 (_)。

必需属性。

类型：字符串型。

调整建议：当设备组被添加到保护组中后，您便无法调整该属性。

默认值：无。

数据复制属性：Nodelist

列出可在复制机制中担任主角色的计算机的主机名。列表中的内容以逗号隔开。

可选属性。

类型：字符串数组。

调整建议：仅当保护组处于非活动状态时，您才可以调整该属性。

默认值：空。

设备组属性：Remote_logical_host

指定用于磁盘设备组复制的远程逻辑主机名。

必需属性。

类型：字符串型。

调整建议：当设备组被添加到保护组中后，您便无法调整该属性。

默认值：无。

Hitachi TrueCopy 数据复制类型属性

数据复制属性：Cluster_dgs

列出在其中写入数据的磁盘设备组。列表中的内容以逗号隔开。

可选属性。

类型：字符串数组。

调整建议：仅当保护组在伙伴关系双方的群集上均处于非活动状态时，您才可以调整该属性。

默认值：空。

设备组属性：Fence_level

定义磁盘设备组所使用的防护级别。防护级别决定了该磁盘设备组的主卷和辅助卷之间的一致性级别。可能的值为 data、status、never 和 async。

如果当前对状态为 SMPL，则您可将该属性设置为任意有效的 Fence_level 值。

注意 –

为避免主群集上出现应用程序故障，请将 Fence_level 的值指定为 never 或 async。如果未将 Fence_level 参数设置为 never 或 async，则当辅助站点关闭时数据复制可能无法正常进行。

请不要使用会阻止系统将 Fence_level 参数设置为 data 或 status 的程序，因为在某些特殊情况下，可能需要这些值。

如果因特殊情况需要将 Fence_level 设置为 data 或 status，请咨询 Sun 代表。

必需属性。

类型：枚举。

调整建议：仅当保护组处于非活动状态时，您您才可以调整该属性。对于 Hitachi TrueCopy 设备组，如果已创建对，则只能将该属性设置为对的当前 Fence_level。如果要更改某个现有对的 Fence_level，请先使用 Hitachi TrueCopy CCI 命令修改 Fence_level，然后再调整 Fence_level 属性。

默认值：无。

数据复制属性：Nodelist

列出可在复制机制中担任主角色的计算机的主机名。列表中的内容以逗号隔开。

可选属性。

类型：字符串数组。

调整建议：仅当保护组处于非活动状态时，您您才可以调整该属性。

默认值：空。

EMC Symmetrix Remote Data Facility 数据复制类型属性

数据复制属性：Cluster_dgs

列出在其中写入数据的磁盘设备组。列表中的内容以逗号隔开。

可选属性。

类型：字符串数组。

调整建议：您可以随时调整该属性。

默认值：空。

数据复制属性：DG_or_CG

将设备组的标识符指定为 "SRDF Device Group"。必须将该属性设置为 DG。

可选属性。

类型：字符串型。

调整建议：您可以随时调整该属性。

默认值：DG。

数据复制属性：Nodelist

列出可在复制机制中担任主角色的计算机的主机名。列表中的内容以逗号隔开。

可选属性。

类型：字符串数组。

调整建议：仅当保护组处于非活动状态时，您才可以调整该属性。

默认值：空。

数据复制属性：R1_SID

指定主设备的 Symmetrix Remote Data Facility 标识。

必需属性。

类型：字符串数组。

调整建议：您可以随时调整该属性。

默认值：无。

数据复制属性：R2_SID

指定辅助设备的 Symmetrix Remote Data Facility 标识。

必需属性。

类型：字符串数组。

调整建议：您可以随时调整该属性。

默认值：无。

退出状态

返回的退出值如下：

0: 命令成功完成。
非 0: 出现错误。

示例

实例 1 创建一个使用数据复制的保护组

以下 geopg 命令将在主群集 cluster-paris 上创建一个 Sun StorageTek Availability Suite 保护组。

# geopg create -s paris-newyork-ps -d avs -o primary \
-p Nodelist=phys-paris-1,phys-paris-2 avspg

实例 2 创建一个不使用数据复制的保护组

以下 geopg 命令将创建一个配置为不使用数据复制的保护组。

# geopg create -s paris-newyork-ps -o primary example-pg

实例 3 应用程序资源组保持联机时删除保护组

以下 geopg 命令在保持两个应用程序资源组 apprg1 和 apprg2 联机的同时，将它们的保护组 avspg 删除。先从保护组中删除应用程序资源组，然后再删除该保护组。

# geopg remove-resource-group apprg1,apprg2 avspg
# geopg stop -e global avspg
# geopg delete avspg

实例 4 修改保护组

以下 geopg 命令将修改保护组 avspg 的超时属性。

# geopg set-prop -p Timeout=300 avspg

实例 5 将一个数据复制设备组添加到 Sun StorageTek Availability Suite 保护组

以下 geopg 命令将在 avspg 保护组中创建一个 Sun StorageTek Availability Suite 数据复制设备组。

# geopg add-device-group -p Local_logical_host=lh-paris-1 \
-p Remote_logical_host=lh-newyork-1 avsdg avspg

属性

有关下列属性的说明，请参见 attributes(5)。

属性类型	属性值
体系结构	SPARC
可用性	SUNWscgctl
接口稳定性	Evolving

另请参见

rbac(5)、geops(1M)

Sun Cluster Geographic Edition 3.1 8/05 最后修订 2005 年 8 月 29 日

引用名 | 概览 | 说明 | 子命令 | 选项 | 操作对象 | 详细说明 | 退出状态 | 示例 | 属性 | 另请参见