RAS Profile Version Updater
Identifier:
com.ibm.xtools.ras.profile.core.updater
Since:
6.0.0
Description:
Each updater is used to update a RAS manifest from one version to another.
All services should access the manifests as if they were the latest supported version. The updater service is used to make sure old manifests are still supported.
Configuration Markup:
<!ELEMENT extension (updater+)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT updater EMPTY>
<!ATTLIST updater
profile-id CDATA #REQUIRED
class CDATA #REQUIRED
profile-major-version CDATA #REQUIRED
profile-minor-version CDATA #REQUIRED
name CDATA #IMPLIED>
Each updater is used to update a RAS manifest from one version to another.
- profile-id - This is used to select the right updater for each manifest. Set this attribute to the profile id that is supported by the updater.
This allows the updater service to only load the plug-ins that support the manifest instead of having to load them all.
- class - a fully qualified name of the Java class that implements com.ibm.xtools.ras.profile.core.IRASVersionUpdater interface
- profile-major-version - This is used to select the right updater for each manifest. Set this attribute to the profile's minimum versions that are supported by the updater.
So for example if the profiles supported by the upgader are versions {major=1, minor=0}, {major=1, minor=5} and {major=2, minor=0} then the version should be 1
This allows the updater service to only load the plug-ins that support the manifest instead of having to load them all.
The updaters are ordered by version number, first by major then by minor. The version's value is converted to an integer and then we the standard ordering. This means that a version of 1 and 10 are treated as 2 different versions while 1 and 01 as treated the same.
- profile-minor-version - This is used to select the right updater for each manifest. Set this attribute to the profile's minimum versions that are supported by the updater.
So for example if the profiles supported by the upgader are versions {major=1, minor=0}, {major=1, minor=5} and {major=2, minor=0} then the version should be 0 (the 0 from the 1,0 version)
This allows the updater service to only load the plug-ins that support the manifest instead of having to load them all.
The updaters are ordered by version number, first by major then by minor. The version's value is converted to an integer and then we the standard ordering. This means that a version of 1 and 10 are treated as 2 different versions while 1 and 01 as treated the same.
- name - The localized name of the updater. This is used to display the name of the updater in any UIs.
Examples:
<extension point="com.ibm.xtools.ras.profile.core.updater">
<updater
profile-id="F1C842AD-CE85-4261-ACA7-178C457018A1::31E5BFBF-B16E-4253-8037-98D70D07F35F"
profile-major-version="1"
class="com.ibm.xtools.ras.profile.defauld.versions.Update1dot04to1dot10"
profile-minor-version="04">
</updater>
</extension>
API Information:
Plug-ins that want to extend this extension point must implement com.ibm.xtools.ras.profile.core.IRASVersionUpdater interface
Licensed Materials - Property of IBM
© Copyright IBM Corp. 2003, 2004 All Rights Reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.