Installing ZIGI with conda
Ever since ZIGI V1R0 was released there’s been options on how to do the initial install. Straight via git clone (had to have git installed), or via the ZIP download from GitHub (no git required for install) or via CBTTAPE.org ... Seeing as GIT is now only installable via conda, I’ve added this option for ZIGI installs too.. Via https://anaconda.org/zdevops/zigi you can get the ‘short’ instructions on how to install zigi via conda. The good news is, it also installs git and it’s prerequisites. The basic installation steps (after installing miniconda obviously) are: Logon to your USS environment (preferably via an SSH session, not TSO OMVS) and make sure you’re in the ‘conda environment’ you want ZIGI and git to be installed. Assuming you’re creating a neat separated environment for just the goodness of git and ZIGI execute the following commands (the environment used in this example is ‘ispfgit’) to create and activate this environment:
conda create -n ispfgit conda activate ispfgit
Also make sure the zoss-appdev channel (rockets channel with all the goodies) is in the conda config via:
conda config --add channels zoss-appdev
Up next: decide where you want ZIGI to be installed on your z/OS environment. The current version of the ZIGI conda installer will copy the ZIGI.EXEC and ZIGI.PANELS to z/OS datasets prefixed with the environment variable ZPREFIX.
Make sure your user has the required authorisation to allocate datasets with that name. Setting this prefix is done via:
export ZPREFIX=HLQ.PREFIX
With the above example HLQ.PREFIX.ZIGI.EXEC and HLQ.PREFIX.ZIGI.PANELS will be the allocated (and populated) datasets.
Then install ZIGI (and git and the rest) via:
conda install -c zdevops zigi
Conda will then show you what all it’s going to do and ask you if you want to continue:
Solving environment: done ## Package Plan ## environment location: /zdo/conda/envs/ispfgit added / updated specs: - zigi The following packages will be downloaded: package | build ---------------------------|----------------- zigi-3.10 | 2 182 KB The following NEW packages will be INSTALLED: bash: 4.3.48-2 zoss-appdev curl: 7.66.0-1 zoss-appdev expat: 2.2.9-4 zoss-appdev git: 2.26.2-pl524_78 zoss-appdev libtag: 1.4-1 zoss-appdev openssl: 1.0.2k-5 zoss-appdev perl: 5.24.4-4 zoss-appdev zigi: 3.10-2 zdevops zlib: 1.2.11-4 zoss-appdev Proceed ([y]/n)?
Once you reply ‘y’ and conda is done doing what it needs to do you’ll see:
All setup.. you can run ZIGI from HLQ.PREFIX.ZIGI.EXEC(ZIGI) An example environment file (might want to add to ~/.profile?) prepared in /zdo/conda/envs/ispfgit/.zigienv For ZIGI these files need to be in EBCDIC format, keep that in mind (the .zigienv file is in IBM-1047 format already)
This /zdo/conda/envs/ispfgit/.zigienv file (if not copied to your .profile) needs to be entered in the ZIGI dialog upon first start, so ZIGI knows where to find git ... If you (as a lot I hear do) then want to ‘distribute’ the git environment (and ZIGI) to another LPAR/SYSPLEX by copying the files (or the whole ZFS and mounting it at a different spot) make sure to update the environment file and/or the users .profiles (or /etc/profile if you’re REALLY setting things up properly lol)
If you don’t want to mess with that autogenerated env-file, or want to setup your own, the rquired envvars stay the same in regards to the ‘older way’ of installing git...
Here’s an example based on our dev-lpar (where conda is installed in /zdo/conda)
export PATH=/zdo/conda/envs/ispfgit/bin:$PATH export MANPATH=$MANPATH:/zdo/conda/envs/ispfgit/man export PERL5LIB=/zdo/conda/envs/ispfgit/lib/perl5:$PERL5LIB export LIBPATH=/zdo/conda/envs/ispfgit/lib/perl5/5.24.0/os390/CORE:$LIBPATH export GIT_SHELL=/zdo/conda/envs/ispfgit/bin/bash export GIT_EXEC_PATH=/zdo/conda/envs/ispfgit/libexec/git-core export GIT_TEMPLATE_DIR=/zdo/conda/envs/ispfgit/share/git-core/templates export GIT_PAGER=more export _CEE_RUNOPTS="FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)" export _BPXK_AUTOCVT=ON export _TAG_REDIR_ERR=txt export _TAG_REDIR_IN=txt export _TAG_REDIR_OUT=txt
Looking forward to hearing some ‘real world’ expericences...












