A Sedona bundle file is a standard format zip file, however, you must arrange the files in a specific folder structure in order for the zip file to be recognized and used by the Sedona Installer. Any of the entries listed below may be omitted from the zip file, but if present, the entry must be placed in the position shown here:
[zip root]/ modules/
overlay/ sedona/ kits/
manifests/ platforms/
Additional information about each of the Bundle specification entries is provided below:
Modules are Java .jar files. They are located directly in the modules/
folder. They will be extracted to the AX !modules
folder during installation.
The Sedona Installer in AX-3.7 allows you to install Sedona TXS bundles from earlier versions as well Sedona TXS-1.2 bundles.
If you install a Sedona TXS-1.1 bundle after you have already installed a later version of Sedona TXS, be sure to uncheck
the box labeled Install Sedona TXS modules?. Otherwise, you will be downgrading the Sedona portion of your installation and may lose functionality.
Overlay files are any additional files that need to be installed automatically along with the usual Sedona environment files.
For example, a vendor might have additional utilities or apps to include with a vendor-specific bundle file. Specify the contents
of the overlay/ folder exactly as the contents are to be installed under !sedona
, for example, if the bundle file contains:
[zip root]/ overlay/
vendorBin/ handyTool.exe
When the bundle is installed, this is how the overlay files are installed in the Workbench environment under !sedona
:
!sedona/ vendorBin/ handyTool.exe
Specify the contents of the sedona/kits folder exactly as the contents are in a normal Sedona installation, for example:
[zip root]/ sedona/
kits/ vendorKit/ vendorKit-abcd1234-1.2.3.kit
As specified in the above example, the kit files are installed in the Workbench environment under !sedona/kits
:
!sedona/ kits/ vendorKit/
vendorKit-abcd1234-1.2.3.kit
Specify the contents of the sedona/manifests folder exactly as the contents are in a normal Sedona installation, for example:
[zip root]/ sedona/
manifests/ vendorKit/
vendorKit-abcd1234.xml
As specified above, the manifest files are installed in the Workbench environment under !sedona/manifests
:
!sedona/ manifests/ vendorKit/
vendorKit-abcd1234.xml
Specify the contents of the sedona/platforms folder exactly as they are in a normal Sedona installation. For example, for
a platform with platform ID “vendor-venModel-9876fedc
”:
[zip root]/ sedona/
platforms/ db/ vendor/
venModel/ 9876fedc/
.par/ platformManifest.xml
In a Sedona TXS bundle file, the platform files are NOT packaged in .par files. This is differs from a Sedona environment
file archive, where they MUST be packaged in .par files in order to be installed.
As specified above, the platform files are installed in the Workbench environment under !sedona/platforms
:
!sedona/ platforms/ db/
vendor/ venModel/
9876fedc/ .par/
platformManifest.xml
Copyright © 2000-2014 Tridium Inc. All rights reserved.