指定 #$upgrade 和 #$upgrade_from 指令

若要確保您正在修改的資源類型為支援升級的資源類型，請將 #$upgrade 指令納入資源類型的 RTR 檔案。對於您要支援的資源類型的每個舊版本，請在 #$upgrade 指令後面增加零個或多個 #$upgrade_from 指令。

#$upgrade 和 #$upgrade_from 指令必須顯示於 RTR 檔案中的資源類型特性宣告區段和資源宣告區段之間。請參閱 rt_reg(4) 線上手冊。

範例 4–1 RTR 檔案中的 #$upgrade_from 指令

#$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

#$upgrade_from 指令的格式如下所示︰

#$upgrade_from version tunability

version

RT_version。如果所有資源類型均沒有版本，或其版本並非您先前在 RTR 檔案中定義的版本，請指定空字串 (“”)。

tunability

叢集管理員可以升級指定的 RT_version 的條件和時間。

使用 #$upgrade_from 指令中的以下可調性值︰

ANYTIME

當對於叢集管理員升級資源的時間無限制時使用。升級期間該資源可完全處於線上狀態。

WHEN_UNMONITORED

當新資源類型版本的方法如下時使用︰

• Update、Stop、Monitor_check 和 Postnet_stop 方法與舊的資源類型版本的啟動方法 (Prenet_stop 和 Start) 相容

• Fini 方法與舊版本的 Init 方法相容

升級之前，叢集管理員必須僅停止資源監視器程式。

WHEN_OFFLINE

當新資源類型版本的 Update、Stop、Monitor_check 或 Postnet_stop 方法符合以下情況時使用︰

• 與舊版本的 Init 方法相容

• 與舊的資源類型版本的啟動方法 (Prenet_stop 和 Start) 不相容

升級之前，叢集管理員必須先將資源離線。

WHEN_DISABLED

類似於 WHEN_OFFLINE。然而升級之前，叢集管理員必須停用資源。

WHEN_UNMANAGED

當新的資源類型版本的 Fini 方法與舊版本的 Init 方法不相容時使用。升級之前，叢集管理員必須將現有資源群組切換為未管理狀態。

如果資源類型的某一版本沒有顯示在 #$upgrade_from 指令的清單中，則依預設，RGM 會將 WHEN_UNMANAGED 的可調性強加至該版本。

AT_CREATION

用於防止現有資源升級為資源類型的新版本。叢集管理員必須刪除然後重建資源。