Skip to content

v0.8.1 - zopen package manager

Compare
Choose a tag to compare
@IgorTodorovskiIBM IgorTodorovskiIBM released this 05 Dec 13:46
· 528 commits to main since this release

Getting the new zopen package manager onto your z/OS system

Changes in this release:

  • zopen upgrade meta will now automatically refresh your zopen-config.
  • zopen init --re-init will now default to your $ZOPEN_ROOTFS file system location
  • Several zopen man pages have been updated and also available online here
  • The kill no such process message is now fixed
  • Several issues fixed related to zopen query, zopen list and zopen clean
  • Updates to the zopen release JSON API, zopen_releases.json
    • Use ETag vs Last modified to check if zopen_releases.json is updated
    • Domain to remote json changed from http://zosopentools.github.io/ to raw.githubusercontent.com
  • and much more!

Getting Started

Note: In the documentation that follows, text inside < ... > indicates a value you need to provide, e.g. <z/OS system> would be replaced with the name of the z/OS system you are using.

To get started, you need to get the meta-0.8.1.pax.Z to your z/OS system. Here is one approach:

  • log on to your desktop system
  • download the meta-0.8.1.pax.Z file by clicking on the file in the assets below
  • open a terminal window on your desktop
  • cd into the directory you downloaded the file to
  • sftp <z/OS system>
  • log in if required
  • put meta-0.8.1.pax.Z
  • quit

Setting up your environment

The following environment variables are required:

export _BPXK_AUTOCVT=ON
export _CEE_RUNOPTS="$_CEE_RUNOPTS FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)"
export _TAG_REDIR_ERR=txt
export _TAG_REDIR_IN=txt
export _TAG_REDIR_OUT=txt

Also, make sure the character device $SSH_TTY is untagged or you may experience unexpected behaviour. Run chtag -r $SSH_TTY to remove any tags.

Installing

  • ssh <z/OS system> or enter tso omvs if running under ISPF from any ISPF panel command field.
  • cd into the directory you transferred the pax.Z file to
  • pax -rf meta-0.8.1.pax.Z # extract the pax
  • After this step, you may delete the meta-0.8.1.pax.Z file
  • cd meta-0.8.1
  • . ./.env
  • zopen init # Follow the instructions. If you are installing to an existing zopen location, specify it in the prompt
  • You can now safely remove meta-0.8.1.pax.Z and the meta-0.8.1 directory
  • Source the .zopen-config, using the dot (.) operator, as instructed in the last line from the zopen init output.
  • zopen list # list the available tools, this will list 100+ tools available under z/OS Open Tools
  • zopen install git

Upgrading zopen

  • You can use zopen upgrade to upgrade meta
  • zopen upgrade meta