%ZHSLIB.AbstractInstaller
abstract class %ZHSLIB.AbstractInstaller
Abstract base class that defines the interface for product-level Installer.Install classes.Method Inventory
- OnComponentMaintenanceVersion()
- OnComponentVersion()
- OnConfigureComponent()
- OnInstallComponent()
- OnUnInstallComponent()
- OnUnconfigureComponent()
- OnUpgradeSteps()
Parameters
deprecated parameter MaintenanceVersion;
DEPRECATED. NO LONGER USED. Version is read from module.xml instead.
deprecated parameter Version;
DEPRECATED. NO LONGER USED. Version is read from module.xml instead.
Methods
DEPRECATED. NO LONGER USED. Version is read from module.xml instead.
Callback to return the minor version of the component. This implementation uses the MaintenanceVersion, which must by implemented by the installer subclass (or else the subclass must override this method using some other approach). If not overridden, and the Version parameter is not populated, this method will throw an exception (not merely return an error status). pMinorVersion is generally set to the value of a product-level macro which defines the minor version, e.g.
Callback to return the minor version of the component. This implementation uses the MaintenanceVersion, which must by implemented by the installer subclass (or else the subclass must override this method using some other approach). If not overridden, and the Version parameter is not populated, this method will throw an exception (not merely return an error status). pMinorVersion is generally set to the value of a product-level macro which defines the minor version, e.g.
$$$HSLIBminorVersion for HealthShare Core.DEPRECATED. NO LONGER USED. Version is read from module.xml instead.
Callback to return the major version of the component. This implementation uses the Version, which must by implemented by the installer subclass (or else the subclass must override this method using some other approach). If not overridden, and the Version parameter is not populated, this method will throw an exception (not merely return an error status). pMajorVersion is generally set to the value of a product-level macro which defines the major version, e.g.
Callback to return the major version of the component. This implementation uses the Version, which must by implemented by the installer subclass (or else the subclass must override this method using some other approach). If not overridden, and the Version parameter is not populated, this method will throw an exception (not merely return an error status). pMajorVersion is generally set to the value of a product-level macro which defines the major version, e.g.
$$$HSLIBmajorVersion for HealthShare Core.
classmethod OnConfigureComponent(pNamespace As %String, pVerbose As %Boolean = 0, ByRef pVars) as %Status
Callback that is invoked during namespace (re)activation. Subclasses SHOULD override this method.
pVars is an array of miscellaneous information, populated by the calling code in the installation/configuration framework (mainly HS.Util.Installer). Subscripts appearing in pVars include:
- Production - set to (namespace)_"PKG.FoundationProduction"
- LogFile - current log file for install operation
- Upgrade - boolean, indicating whether the current operation is an upgrade
- Type - hardcoded to "Foundation"
- Component - current component name
classmethod OnInstallComponent(pDatabase As %String, pVerbose As %Boolean = 0, pDevMode As %Boolean = 0, pIsUpgrade As %Boolean = 0) as %Status
Callback that is invoked during product installation to allow for
system-level changes to be performed. Common examples of such changes include:
- Definition of resources and roles
- Definition/configuration of the product library database
- Import of localized messages for the product
Callback that is invoked when removing a product.
classmethod OnUnconfigureComponent(pNamespace As %String, pVerbose As %Boolean = 0, pPurgeFiles As %Boolean = 0, ByRef pVars) as %Status
Callback that is invoked when removing a product from a namespace.
Subclasses SHOULD override this method.
What to do system wide (not specific namespaces) during an upgrade. Not currently called by the framework, but present for future use.