2. Installation and Setup

This document forms a part of the DTK. The following files are included in the DTK installation media:

FileDescription

devkit.pdf

This document

devkit_<version>.mzp

Installer for DTK

Note!

The  Platform must be installed prior to the installation of the DTK.

Installing DTK

To install the Development Toolkit, copy the DTK installation files to a folder in your tmp directory:

> mkdir /tmp/dtk<version>installer
> cp <cdpath>/*.mzp /tmp/dtk<version>installer/
> cd /tmp/dtk<version>installer

Then issue the command below to install DTK at the location stated by the $MZ_HOME environment variable. The files will be copied to a new subdirectory called dtk and example code will be added to the system.

> java -Dmz.home=$MZ_HOME -jar devkit_<version>.mzp install


Setting Up the Environment

Required Files

Place devkit.jar, found in $MZ_HOME/dtk/lib, in any directory.

Environment Variables

CLASSPATH=<path>/devkit.jar:<path>/my_dev_dir
PATH=$PATH:/path/to/SDK/java/bin

Upgrade and Downgrade

Before proceeding with the upgrade or downgrade procedure provided in 6.2 Preparations and 7. Standard Downgrade Procedure in the Installation Instructions, as your custom agents cannot be included in an upgrade or downgrade, you must follow the instructions provided below: 

  1. Export the configurations which include custom agents created using Development Toolkit and ensure that you store the DTK packages in case you later require them.

  2. Use the premove command to remove the DTK packages.

    $ mzsh premove dtk_<version>.mzp
  3. After completing the upgrade or downgrade, reinstall the DTK packages as described above in Installing DTK. 

  4. Import the configurations that you exported, which include your custom agents.