Patch or Install a Taxonomy Package
Patch an installed taxonomy package
Occasionally, taxonomy packages may receive patches (upgrades or revisions) from their issuers. When Taxonomy Package Manager detects that patches are available, these are indicated in the package listings of Taxonomy Package Manager and you can install the patches quickly.
In the GUI
Patches are indicated by the
icon. (Also see the previous topic about status categories.) If a patch is available, then the Patch Selection button will be enabled. Click this button to prepare all patches for installation. The icon of each package that will be patched changes from
to
, and the Messages pane at the bottom of the dialog lists the patches that will be applied. When you are ready to install the selected patches, click Apply. All patches will be applied together.
Note that if you deselect a package marked for patching, you will actually be uninstalling that package when you click Apply.
On the CLI
To apply a patch at the command line interface:
1.Run the list -u command. This lists any packages for which patch upgrades are available.
2.Run the upgrade command to install all the patches.
Install an available taxonomy package
You can install new packages using either the Taxonomy Package Manager GUI or by sending Taxonomy Package Manager the install instructions via the command line.
Note: If the current package references other packages, the referenced packages are also installed.
In the GUI
To install packages using the Taxonomy Package Manager GUI, select the packages you want to install and click Apply.
On the CLI
To install packages via the command line, run the install command:
taxonomypackagemanager.exe install [options] TaxonomyPackage+
where each TaxonomyPackage argument is a package you want to install. A taxonomy package is referenced by an identifier of format <name>-<version>. (The identifiers of packages are displayed when you run the list command.) You can enter as many packages as you like, in a space-separated list. For details, see the description of the install command.
Note: On Linux, use the sudo ./taxonomypackagemanager command.
Installing a required taxonomy package
When you run an XBRL-related command in MapForce Server and MapForce Server discovers that a package it needs for executing the command is not present or is incomplete, Taxonomy Package Manager will display information about the missing package. You can then directly install any missing package via Taxonomy Package Manager.