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 [,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 [,resourcegroup...] protectiongroupname
/usr/cluster/bin/geopg set-prop protectiongroupname -p property [-p...]
/usr/cluster/bin/geopg start protectiongroupname -e[[local]| [global]] [-n]
/usr/cluster/bin/geopg stop protectiongroupname -e[[local]| [global]] [-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 系统管理指南》中的“Sun Cluster Geographic Edition 软件和 RBAC”。

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

geopg [subcommand] [options] [operands]

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

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

子命令

可支持的子命令如下：

add-device-group

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

add-resource-group

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

将某个资源组添加到保护组时，如果保护组处于联机状态，则该资源组必须处于 unmanaged 状态或 online 状态。要启动处于不受管理状态的资源组，请运行 geopg start 命令。

如果保护组处于脱机状态，则该资源组必须处于 unmanaged 状态。如果该资源组处于脱机状态，请先使它进入 unmanaged 状态，然后再将其添加至脱机的保护组。

create

在现有的伙伴关系中创建一个保护组。

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

delete

删除保护组。

get

通过从伙伴群集获取配置，为远程伙伴群集上已经存在的某一保护组创建本地配置。如果不指定保护组名称，则本地群集上将会创建远程群集上为该伙伴关系配置的所有保护组。

list

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

• 已定义的保护组

• 包含在保护组中的资源组

• 操作状态信息

如果不指定保护组名称，则 list 子命令将会显示本地群集上所配置的全部保护组的信息。

modify-device-group

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

remove-device-group

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

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

remove-resource-group

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

删除应用程序资源组并不会使该应用程序资源组的状态变为 unmanaged。

set-prop

修改保护组的属性。

start

启动保护组。保护组启动后，它在群集中的角色就是您创建该保护组时为其分配的角色。

start 子命令会运行 scswitch -Z -g resourcegroups 命令，以将资源和资源组纳入该保护组的管理范围。有关运行此命令的更多信息，请参见 scswitch(1M) 手册页。

您可以在以下级别启动保护组：

• 在所有已配置保护组的群集上。

• 仅在保护组的主群集上。辅助群集将保持非活动状态。

• 仅在保护组的辅助群集上（激活主群集之后）。

启动保护组可导致发生以下事件：

• 可以验证保护组配置。

• 群集可以确定操作是否已完成。

• 可以启动数据复制。

• 可以启动受保护的应用程序。

• 如果可以访问伙伴群集，则系统会将保护组激活情况通知给伙伴群集。

stop

停止保护组。您可以在以下级别停止保护组：

• 在所有已配置保护组的群集上。

• 仅在保护组的主群集上。辅助群集将保持活动状态。

• 仅在保护组的辅助群集上（取消激活主群集之后）。

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

• 保护组进入脱机状态。

• 数据复制停止（取决于您正在使用的数据复制）。

• 受保护的应用程序停止。

• 如果可以访问伙伴群集，则系统会将保护组已停止这一情况通知给伙伴群集。

switchover

切换保护组中群集的已指定角色。必须先启动保护组，然后才能执行切换操作。

takeover

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

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

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

---

注意 –

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

只有当主群集不可用时或者在意外停机期间，才应当运行 geopg takeover 命令。您必须清楚一点，即发生上述情况时，数据有可能会丢失，并且在辅助群集上修复和重新激活保护组需要一定的时间。

---

update

使用伙伴的配置信息重新同步本地保护组的配置信息。geopg update 命令会使用伙伴群集上的保护组配置覆写本地群集上的保护组配置。

validate

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

选项

指令支持以下选项：

-?
--help

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

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

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

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

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

-D
--only-datarep

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

-d datareplicationtype
--datarep-type datareplicationtype

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

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

avs

指定将安装了修补程序的 Sun Availability Suite Remote Mirror 3.2 版本作为数据复制机制。

srdf

指定将 EMC Symmetrix Remote Data Facility 作为数据复制机制。

truecopy

指定将 Hitachi TrueCopy 作为数据复制机制。该产品可与 Command and Control Interface RAID-Manager/Solaris 版本 01-10-03/02 一起使用，后者要求具备 Sun StorEdge^TM 9970/9980 阵列或 Hitachi Lightning 9900 系列存储硬件。

-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

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

将某个资源组添加到保护组时，如果保护组处于联机状态，则该资源组必须处于 unmanaged 状态或 online 状态。要启动处于不受管理状态的资源组，请运行 geopg start 命令。

将某个资源组添加到保护组时，如果保护组处于脱机状态，则必须先使该资源组处于 unmanaged 状态，然后再添加它。

详细说明

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

保护组通用属性

Description

描述该保护组。

可选属性。

类型：字符串型。

默认值：无。

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

RoleChange_ActionArgs

指定要在执行保护组切换或接管过程中与角色更改回调脚本结合使用的参数，这些参数应当位于系统定义的参数之后。

可选属性。

类型：字符串型。

默认值：无。

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

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 属性被设置为 3000 秒，则 3000 秒内未能完成 geopg start 操作将导致该操作超时。

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

# geopg start -e Global protectiongroupname

如果 timeout 属性被设置为 3000 秒，则 3000 秒内未能在本地群集上完成 geopg start 操作或者 3000 秒内未能在远程群集上完成该操作，都会导致该操作超时。如果本地操作耗时 1500 秒，远程操作耗时 1500 秒，该操作便不会超时。

保护组的 timeout 值是估算值，仅应用于部分子操作。由于 timeout 值不会应用于整个操作过程，因此并非每个针对保护组的操作都会按 timeout 时限进行计时。例如，初始化数据结构和检查操作前提条件所花费的时间就不会计入 timeout 时限内。

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

可选属性。

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

默认值：3600 秒。

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

Sun 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 标识。

必需属性。

类型：整数。

调整建议：您可以随时调整该属性。如果在添加设备组时未指定该属性的值，则 Sun Cluster Geographic Edition 软件会自动搜索属性值并设置该属性。

默认值：无（除非添加的是 Symmetrix Remote Data Facility 设备组）。

数据复制属性：R2_SID

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

必需属性。

类型：整数。

调整建议：您可以随时调整该属性。如果在添加设备组时未指定该属性的值，则 Sun Cluster Geographic Edition 软件会自动搜索属性值并设置该属性。

默认值：无（除非添加的是 Symmetrix Remote Data Facility 设备组）。

退出状态

返回的退出值如下：

0

命令成功完成。

非 0

出现错误。

示例

---

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




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

# 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=3000 avspg

---

---

实例 5 向 Sun StorEdge Availability Suite 3.2.1 保护组添加数据复制设备组




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

# 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 2006Q4  最后修订 2006 年 12 月 7 日

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