用于 Solaris OS 的 Sun Cluster 数据服务规划和管理指南

升级资源类型

发行更新版本的资源类型时，您需要安装和注册升级的资源类型。您可能还需要将现有资源升级到更新的资源类型版本。本节提供了以下过程，可用于安装和注册升级的资源类型以及将现有资源升级到新的资源类型版本。

如何安装和注册资源类型的升级版

此过程也可以使用 scsetup 的“资源组”选项来执行。有关 scsetup 的信息，请参见 scsetup(1M) 手册页。

在所有群集节点上安装资源类型升级软件包。

注意：
如果未在所有节点上安装资源类型软件包，则需要执行附加步骤（步骤 3）。

升级文档会指示是否需要以非群集模式引导节点以安装资源类型升级软件包。为避免停机时间，请以滚动升级方式添加新软件包（一次一个节点）。当该节点以非群集模式引导时，其他节点处于群集模式中。

注册新的资源类型版本。
scrgadm -a -t resource_type -f path_to_new_RTR_file
新的资源类型将具有以下格式的名称。
vendor_id.rtname:version
使用 scrgadm —p 或 scrgadm —pv（冗余）可显示新注册的资源类型。

如果未在所有节点上安装新资源类型，请将 Installed_nodes 特性设置为实际已安装新资源类型的节点。
scrgadm -c -t resource_type -h installed_node_list

新版本的资源类型可能在以下方面与以前的版本不同。

资源类型特性的设置可能会更改。
声明的资源特性（包括标准特性和扩展特性）集可能会更改。
资源特性的属性（例如缺省值、最小值、最大值、数组最小值、数组最大值或可调性）可能会更改。
声明的方法集可能不同。
方法和/或监视器的实现可能会更改。

如何将现有资源迁移到新版本的资源类型

此过程也可以使用 scsetup 的“资源组”选项来执行。有关 scsetup 的信息，请参见 scsetup (1M) 手册页。

现有资源类型版本和新版本中的更改确定了如何迁移到新版本类型。资源类型升级文档会告知您是否可以进行迁移。如果不支持迁移，请考虑删除该资源并用升级版本的新资源替换它，或以旧版本的资源类型保留该资源。

迁移现有资源时，以下值可能会更改。

缺省特性值

如果升级版本的资源类型声明了缺省特性的新缺省值，则新的缺省值将由现有资源继承。

新资源类型版本的 VALIDATE 方法将进行检查以确保现有特性的设置是否适当。如果设置不适当，请将现有资源的特性编辑为适当的值。要编辑特性，请参见步骤 3。

资源类型名称

RTR 文件包含用于构成资源类型的全限定名称的以下特性。

Vendor_id
Resource_type
RT_Version

注册升级版本的资源类型时，其名称将存储为 vendor_id.rtname:version。已经迁移到新版本的资源将具有新的 Type 特性，该特性由以上列出的特性组成。

资源 type_version 特性

标准资源特性 Type_version 存储资源类型的 RT_Version 特性。 Type_Version 特性不显示在 RTR 文件中。使用以下命令可编辑 Type_Version 特性。

scrgadm -c -j resource -y Type_version=new_version

将现有资源迁移到新版本的资源类型之前，请阅读附带新资源类型的升级文档以确定是否可以进行迁移。

该文档将指定何时必须进行迁移。
- 任何时候
- 在资源未被监视时
- 在资源脱机时
- 当资源被禁止时
- 在资源组未受管理时
如果不支持迁移，则必须删除该资源并用升级版本的新资源替换它，或以旧版本的资源类型保留该资源。

对于属于要迁移资源类型的每个资源，请将资源或其资源组的状态更改为升级文档所指示的适当状态。

例如，如果资源需要不被监视
scswitch -M -n -j resource
如果资源需要脱机
scswitch -n -j resource
如果资源需要被禁用
scswitch -n -j resource
如果资源组需要不受管理
scsswitch -n -j resource-group scswitch -F -g resource_group scswitch -u -g resource_group

对于属于要迁移资源类型的每个资源，请编辑资源，将其 Type_version 特性更改为新版本。
scrgadm -c -j resource -y Type_version=new_version \ -x extension_property=new_value -y extension_property=new_value
如果需要，可以通过在命令行中添加附加的 -x 和/或 -y 选项，使用同一命令将同一资源的其他特性编辑为适当的值。

通过执行与在步骤 2 中键入的命令相反的命令，恢复资源或资源组的先前状态。

例如，使资源重新被监视
scswitch -M -e -j resource
重新启用资源
scswitch -e -j resource
使资源组受管理并联机
scswitch -o -g resource_group scswitch -Z -g resource_group

示例 1 – 将现有资源迁移到新资源类型版本

此例说明了现有资源向新资源类型版本的迁移。请注意，新资源类型软件包包含的方法位于新路径中。因为在安装期间方法不会被覆写，所以在安装升级的资源类型之前，资源无需被禁用。

此例假定以下条件。

新资源类型版本为 2.0
前一版本的可调性为“when_offline”
资源名称为“myresource”
资源类型名称为“myrt”
新 RTR 文件位于 /opt/XYZmyrt/etc/XYZ.myrt
与要迁移的资源没有相关性
要迁移资源处于脱机状态而包含该要迁移资源的资源组处于联机状态

 （按照供应商的说明在所有节点上安装新软件包。）
# scrgadm -a -t myrt -f /opt/XYZmyrt/etc/XYZ.myrt
# scswitch -n -j myresource
# scrgadm -c -j myresource -y Type_version=2.0
# scswitch -e -j myresource

示例 2 – 将现有资源迁移到新资源类型版本

此例说明了现有资源向新资源类型版本的迁移。请注意，新资源类型软件包仅包含监视器和 RTR 文件。因为在安装期间监视器会被覆写，所以在安装升级的资源类型之前，资源必须被禁用。

此例假定以下条件。

新资源类型版本为 2.0
前一版本的可调性为“when_unmonitored”
资源名称为“myresource”
资源类型名称为“myrt”
新 RTR 文件位于 /opt/XYZmyrt/etc/XYZ.myrt

# scswitch -M -n -j myresource
（按照供应商的说明安装新软件包。）
# scrgadm -a -t myrt -f /opt/XYZmyrt/etc/XYZ.myrt
# scrgadm -c -j myresource -y Type_version=2.0
# scswitch -M -e -j myresource