To ensure that the resource type that you are modifying is upgrade-aware, include the #$upgrade directive in the resource type's RTR file. After the #$upgrade directive, add zero or more #$upgrade_from directives for each earlier version of the resource type that you want to support.
The #$upgrade and #$upgrade_from directives must appear between the resource type property declarations and the resource declarations sections in the RTR file. See the rt_reg(4) man page.
#$upgrade_from "1.1" WHEN_OFFLINE #$upgrade_from "1.2" WHEN_OFFLINE #$upgrade_from "1.3" WHEN_OFFLINE #$upgrade_from "2.0" WHEN_UNMONITORED #$upgrade_from "2.1" ANYTIME #$upgrade_from "" WHEN_UNMANAGED
The format of the #$upgrade_from directive is as follows:
#$upgrade_from version tunability
The RT_version. If any resource type does not have a version, or for versions other than what you defined previously in the RTR file, specify the empty string (“”).
The conditions under which, or when, the cluster administrator can upgrade the specified RT_version.
Use the following tunability values in the #$upgrade_from directives:
Use when there are no restrictions on when the cluster administrator can upgrade the resource. The resource can be completely online during the upgrade.
Use when the new resource type version's methods are as follows:
The Update, Stop, Monitor_check, and Postnet_stop methods are compatible with the older resource type version's starting methods (Prenet_stop and Start)
The Fini method is compatible with the Init method of older versions
The cluster administrator must only stop the resource monitor program before upgrading.
Use when the new resource type version's Update, Stop, Monitor_check, or Postnet_stop method is as follows:
Compatible with the Init method of an older version
Incompatible with an older resource type version's starting methods (Prenet_stop and Start)
The cluster administrator must take the resource offline before upgrading.
Similar to WHEN_OFFLINE. However, the cluster administrator must disable the resource before upgrading.
Use when the new resource type version's Fini method is incompatible with the Init method of an older version. The cluster administrator must switch the existing resource group to the unmanaged state before upgrading.
If a version of the resource type does not appear in the list of #$upgrade_from directives, the RGM imposes the tunability of WHEN_UNMANAGED to that version by default.
Use to prevent existing resources from being upgraded to the new version of the resource type. The cluster administrator must delete and re-create a resource.