01. Getting started - intersystems/ipm GitHub Wiki

  1. Go to the latest release and download the XML file.

  2. Import it into IRIS and compile via any desired way (Management Portal, Studio or Terminal)

If you are working with InterSystems IRIS Community Edition in Docker, you can use Docker Images, which already include IPM instead of step 1 and 2.

  1. Check that calling zpm in the command line results in the following
    USER>zpm

    =============================================================================
    || Welcome to the Package Manager Shell (ZPM).                             ||
    || Enter q/quit to exit the shell. Enter ?/help to view available commands ||
    =============================================================================
    zpm:USER>

Prior to IPM 0.9.0, this would automatically be available in all namespaces. To make IPM available in all namespaces as of 0.9.0, run:

zpm "enable -map -globally"

(3.1). After version 0.9.2, you can also call

zpm "enable -community"

This will reset the zpm installation to the community repository and map IPM to all namespaces. If using this method, you can update zpm to newer version by running

zpm "reinstall zpm"
  1. To get the list of all available modules use search command
    zpm: USER>search
    registry https://pm.community.intersystems.com:
    analyzethis 1.1.4
    dsw 2.1.41
    objectscript-package-template 1.0.3

The Registry pm.community.intersystems.com is used by default.

  1. Install or Update a module using install command:
    zpm: USER>install objectscript-package-template

or

    zpm: USER>install objectscript-package-template -v

Key -v (-verbose) produces verbose output from the command.

Updating IPM

To update IPM to a newer version, you can just grab a newer release from latest release, and follow the same procedure as a new install

If you have enabled ipm globally using -zpm "enable -map -globally"-, then this newer version will automatically be used in the rest of the namespaces on your instance as well.

If you are using the community version of ipm, then all you have to do is run

zpm "reinstall zpm"

to get the newest version!