This section describes different ways of managing related packages by using the Command Line tool and by using the Java Command Line tool.

Removing Packages

The following mzsh command can be used for deleting a specific package. The command assumes that you have started mzsh interactively.

...

After a package has been removed, the Platform and Execution Contexts may have to be stopped and restarted. If a removed package contained a bootstrap class, a cache error message will be displayed. The corresponding bootstrap class must be removed from the STR before the pico instance can be restarted.

Package Management Tool

All .mzp files provide a built in management tool. It is executed in a Unix shell by running the following command:

...

The added <management argument> controls the execution of the packages. Currently there are seven different arguments; Create, Extract, Help, Install, Patch , Provides and Query.

Create

Creates the database definitions needed for a package. If no database definitions are needed, the response will be:

...

Unpacking database/oracle/packages/archiving/oracle_tables.sql...done
Unpacking database/oracle/packages/archiving/oracle_grants.sql...done
Unpacking database/oracle/packages/archiving/oracle_synonyms.sql...done

Extract

Adds any package parameters to install.xml in the current directory. If this file does not exist, it will be created.

Help

Displays help for the given argument or a help session about all arguments.

$ help

Install

Performs an installation of the selected package. This command is only used when making a new installation.

...

$ java -Dinstall.types=platform -Dmz.home=$MZ_HOME -jar \ 
archiving_8.0.0.0.mzp install 
... 
Inserting Archiving, 8.0.0.0...done.

Patch

The patch argument is used to perform a patch installation of packages, generally used for upgrading the system, and if necessary, perform patch only specific operations on the system.

...

In order for the changes to take effect after the command has been executed, some components including the upgraded item may have to be restarted. This could include the Desktop user interface, the Platform, the Execution Contexts and the workflows.

Provides

Describes the components that the stated package will install.

Query

This argument will make a query about the existence of a specific package in the installed system.

...

Adding or Updating Packages

During upgrade or addition of new packages, the mz.license file must be available in the directory specified by the platform property  mz.license.file. If this property is not set, the license file must be stored in the $MZ_HOME/etc directory.

...

1. Create all database definitions needed for a package using the create argument.
   
   
2. Log in as database administrator and execute the corresponding sql files.
   
   
3. Install the package using the install argument.