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

Sun Cluster Geographic Edition 参考手册

geoadm(1M)

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

引用名

geoadm– 启用或禁用本地群集上的 Sun Cluster Geographic Edition 基础结构

概览

/usr/cluster/bin/geoadm

subcommand

-?

/usr/cluster/bin/geoadm

-V

/usr/cluster/bin/geoadm show

/usr/cluster/bin/geoadm start

/usr/cluster/bin/geoadm status

/usr/cluster/bin/geoadm stop

-f

-i

说明

geoadm 命令可启用或禁用本地群集上的 Sun Cluster Geographic Edition 基础结构。您还可以使用该命令检查 Sun Cluster Geographic Edition 软件是否已在群集上启用。

安装完 Sun Cluster Geographic Edition 产品后，必须通过运行 geoadm start 命令启用该产品。该命令可将群集加入伙伴关系，并使群集容纳保护组。geoadm start 命令可配置具高可用性的基础结构，以解除锁定群集上的 Sun Cluster Geographic Edition 模块。

geoadm stop 命令可停止具高可用性的基础结构，以使 Sun Cluster Geographic Edition 模块在群集上处于锁定状态。在删除产品软件包之前，请先运行 geoadm stop 命令。

注意 –

只有在一种情况下，geoadm stop 命令可成功禁用群集上的 Sun Cluster Geographic Edition 模块。这种情况即，涉及该群集的保护组的所有本地状态必须为 Offline（脱机）或 Unknown（未知）。

在群集的一个节点上运行 geoadm start 或 geoadm stop 命令会影响到整个群集。

要使用 geoadm 命令启用或禁用 Sun Cluster Geographic Edition 基础结构，您必须拥有适当的基于角色的访问控制 (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”。

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

geoadm [subcommand] [options] [operands]

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

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

子命令

可支持的子命令如下：

show

显示 Sun Cluster Geographic Edition 软件是否已在群集上启用。

start

在群集上配置并启用 Sun Cluster Geographic Edition 基础结构。

status

显示本地群集上 Sun Cluster Geographic Edition 实体的运行时状态。

您必须先在本地群集上安装 Sun Cluster Geographic Edition 软件，然后才能运行 status 子命令。无论是否已为伙伴关系启用了群集，您都可以运行 status 子命令。

使用 status 子命令可显示以下信息：

本地群集的伙伴关系功能是否已启用。
本地群集是否处于伙伴关系中。如果群集处于伙伴关系中，则使用 status 子命令可列出所有伙伴关系成员。
心跳状态。
保护组状态。
正在进行中的事务的状态。

有关每种状态的可能值的详细信息，请参阅 EXTENDED DESCRIPTION 部分。

stop

禁用群集上的 Sun Cluster Geographic Edition 基础结构和配置。

注意 –

若要成功运行 stop 子命令，群集上的所有保护组都必须处于 Offline（脱机）状态。

stop 子命令可删除群集状态以及群集上的 Sun Cluster Geographic Edition 基础结构资源组。但是，stop 子命令不会删除数据复制资源组。

运行了 stop 子命令后，当您首次运行 start 子命令时，系统会再次启用并配置 Sun Cluster Geographic Edition 基础结构。

选项

指令支持以下选项：

-? --help

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

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

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

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

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

-f --force

表明您希望在禁用 Sun Cluster Geographic Edition 基础结构期间跳过命令确认问题。

-i --interactive

表明您希望在禁用 Sun Cluster Geographic Edition 基础结构期间显示交互式命令确认问题。

-V --version

显示命令的版本信息。

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

详细说明

以下部分列出了对各种状态的描述。

伙伴关系状态

伙伴关系状态只显示本地群集的状态。伙伴关系状态可以是以下情形之一：

正常: 伙伴群集之间已实现连接。
错误: 伙伴群集之间的连接已断开。

同步状态

同步状态显示伙伴关系中所有群集的状态。伙伴关系同步状态可以是以下情形之一：

正常: 伙伴群集之间的配置是同步的。
错误: 伙伴群集之间的配置不同。您必须重新同步伙伴关系。
不匹配: 两个伙伴群集是单独配置的。因此，您必须删除一个群集上的配置，然后将伙伴群集的配置复制过来。
未知: 无法获取信息，因为伙伴群集之间的连接已断开。

群集间资源管理连接状态

群集间资源管理 (Intercluster Resource Management, ICRM) 连接状态显示的是当前正在远程群集上运行的那个群集管理代理的状态。ICRM 连接状态可以是以下情形之一：

正常: 每个伙伴群集上的 ICRM 模块相互间均可通信。
错误: 本地群集上的 ICRM 模块无法与远程群集上的 ICRM 模块通信。

心跳状态

心跳状态只显示本地群集的状态。心跳状态可以是以下情形之一：

正常: 已启用心跳监视，且伙伴群集在规定的超时和重试时限内作出响应。
错误: 心跳监视正在运行，但伙伴群集并未作出响应且重试超时。
脱机: 心跳监视处于脱机状态。

心跳插件状态

心跳插件状态只显示本地群集的状态。心跳插件状态可以是以下情形之一：

正常: 伙伴群集正在响应。
不活动: 插件未在使用。这是一个备用插件，用于在其他插件不响应时进行重试。
无应答: 伙伴群集未作响应。

保护组状态

保护组状态可显示保护组中所有群集的整体状态。保护组的整体状态可以是以下情形之一：

正常: 保护组处于联机状态，应用程序资源组处于联机状态，数据复制正在运行。
脱机: 保护组处于非活动状态。
已降级: 保护组和应用程序资源组处于联机状态，但数据复制并未运行或处于部分错误状态。
错误: 尽管保护组处于联机状态，但伙伴关系中至少有一个组件（如配置、数据复制或资源组）处于错误状态。
未知: 尽管保护组处于联机状态，但伙伴关系中至少有一个组件（如配置、数据复制或资源组）的状态未知。

配置状态

保护组的配置状态只显示单个群集的状态。保护组的配置状态可以是以下情形之一：

正常: 保护组的配置已通过验证，群集上没有错误。
错误: 对保护组配置的验证结果表明存在错误。您必须重新验证保护组。
未知: 无法获取信息，因为伙伴群集之间的连接已断开。

数据复制状态

数据复制状态可显示针对单个群集上的保护组而配置的数据复制的状态。保护组的数据复制状态可以是以下情形之一：

正常: 数据复制已配置并处于联机状态、且运行中未发生错误。
已降级: 数据复制已关闭或处于部分错误状态。
错误: 由于发生错误，数据复制未在进行。
无: 尚未配置数据复制。
未知: 无法获取信息，因为伙伴群集之间的连接已断开。

资源组状况

资源组状态可显示针对单个群集上的保护组而配置的资源组的状态。保护组的资源组状态可以是以下情形之一：

正常: 所有资源组在主群集上处于联机状态，在辅助群集上处于脱机或不受管理状态。
错误: 不是所有资源组都在主群集上处于联机状态，或者不是所有资源组都在辅助群集上处于脱机或不受管理状态。
未知: 无法获取信息，因为伙伴群集之间的连接已断开。

退出状态

返回的退出值如下：

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

示例

实例 1 启用 Sun Cluster Geographic Edition 基础结构

以下 geoadm 命令可在本地群集上启用 Sun Cluster Geographic Edition 控制模块。

# geoadm start

实例 2 禁用 Sun Cluster Geographic Edition 基础结构

以下 geoadm 命令可删除您启用 Sun Cluster Geographic Edition 基础结构时创建的基础结构资源组。

# geoadm stop

实例 3 检查 Sun Cluster Geographic Edition 基础结构的状态

以下 geoadm 命令可显示本地群集上是否启用了 Sun Cluster Geographic Edition 基础结构。如果已启用，则该命令还将显示处于活动状态的基础结构所在的节点。

# geoadm show
--- CLUSTER LEVEL INFORMATION ---
Sun Cluster Geographic Edition is active on:  
node phys-paris-2, cluster cluster-paris

Command execution successful
#

实例 4 监视 Sun Cluster Geographic Edition 软件的运行时状态

以下 geoadm 命令可显示启用了 Sun Cluster Geographic Edition 的本地群集的运行时状态。

# geoadm status
Cluster: cluster-paris

Partnership "paris-newyork-ps": OK
   Partner clusters    : cluster-newyork
   Synchronization     : OK
   ICRM Connection     :OK

   Heartbeat "paris-to-newyork" monitoring "cluster-newyork": OK        
      Heartbeat plug-in "ping_plugin"    : Inactive
      Heartbeat plug-in "tcp_udp_plugin" : OK

Protection group "tcpg"     : OK
   Partnership              : "paris-newyork-ps"
   Synchronization          : OK

   Cluster cluster-paris    : OK
   Role                     : Primary
   PG activation state      : Activated
   Configuration            : OK
   Data replication         : OK
   Resource groups          : OK

  Cluster cluster-newyork   : OK
     Role                   : Secondary
     PG activation state    : Activated
     Configuration          : OK
     Data replication       : OK
     Resource groups        : OK

Pending operations
Protection group "tcpg" : Start

属性

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

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

另请参见

rbac(5)、geohb(1M)、geopg(1M)、geops(1M)

Sun Cluster Geographic Edition 3.1 2006Q4 最后修订 2006 年 12 月 7 日

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