Installing Wazi Deploy on z/OS

Wazi Deploy is provided as a Python package, which allows for usage on a multitude of operating systems. The package must be installed in Python to become functional. Install the Wazi Deploy core package on a z/OS® environment in a z/OS UNIX System Services file system.

Note: If you install a Wazi Deploy version earlier than 3.0.3, follow the instructions in Installing Wazi Deploy prior to 3.0.3.

Installing the requisites and Wazi Deploy

If you plan to use Wazi Deploy on z/OS, complete the following steps.

Note: The following steps require you to be active on the (z/OS) UNIX command line. In z/OS, you can use the OMVS TSO command. To return to TSO, use the exit command.

Set the environment variables.
Your command shell must be able to find the Python executable files. On z/OS, the command shell must also allow scripts that are not EBCDIC encoded. To do so, set the environment variables by using the following commands:
```
export PYTHONHOME=/usr/lpp/IBM/cyp/pyz
export PATH=$PYTHONHOME/bin:$PATH
export _BPXK_AUTOCVT=ON
```
Create a Python virtual environment.
Creating a virtual environment is recommended to isolate the Python package installation. You can then manage separate package installations for different projects and test the installations.
To create a virtual environment named gdp in the /global/opt/pyenv directory, enter the following command:
```
python3 -m venv /global/opt/pyenv/gdp
```
Then, activate the virtual environment with the following command:
```
. /global/opt/pyenv/gdp/bin/activate
```
Note: If you use a bash shell, you can use the source command instead of the . command. So for example, you can enter the following command:
```
source /global/opt/pyenv/gdp/bin/activate
```

Get the Wazi Deploy installable files that are present on z/OS.

These files were created on z/OS when the Wazi Deploy FMID was installed through SMP/E, as described in the Wazi Deploy Program Directory.

By default, the SMP/E installation created the /usr/lpp/IBM/gdp z/OS UNIX directory. This directory contains the installable files for usage on z/OS, and a tar subdirectory that contains the wazideploy.tar file. You can extract the installable files from the file by using the following command:

tar -xvf wazideploy.tar

The installable files are wheel files. A wheel file is a ZIP-format archive with a specially formatted file name followed by the .whl extension. It contains a precompiled Python module ready to install. The current Python versions support this installation method.

The /usr/lpp/IBM/gdp directory contains a .whl file for each of the currently supported versions of IBM® Open Enterprise SDK for Python. The following table lists the Wazi Deploy .whl files, the environments where they can be used, and the corresponding versions of IBM Open Enterprise SDK for Python.

File names	Execution environments	IBM Open Enterprise SDK for Python versions
wazideploy_3.0.6-py3.13-none-any.whl	z/OS and distributed (x86 or Linux® on Z)) environments	3.13
wazideploy_3.0.6-py3.12-none-any.whl	z/OS and distributed (x86 or Linux on Z) environments	3.12
wazideploy_3.0.6-py3.11-none-any.whl	z/OS and distributed (x86 or Linux on Z) environments	3.11

Warning: The Python wheel installation method performs version matching against the .whl file name. Any modification to the file name can break and corrupt the installation.

Install the requisites.
The /usr/lpp/IBM/gdp directory contains a dependencies directory that contains all the upstream libraries needed for Wazi Deploy.
In the folder where you have unpacked the .tar file, issue the following command:
```
pip3 install --no-deps --no-cache-dir -r dependencies/requirements.txt --no-index --find-links dependencies
```
Install Wazi Deploy.
Now that Python has access to the requisite libraries, you can install Wazi Deploy on z/OS.

Enter the following installation command, where X represents the Python version in the Wazi Deploy wheel file. For example, the wheel file can be wazideploy-3.0.6-py3.13-none-any.whl.
```
pip3 install --no-deps --no-cache-dir wazideploy-3.0.6-py3.X-none-any.whl
```
Note: If you are not the administrator of the environment where you are installing Wazi Deploy, and if you are not installing Wazi Deploy in a virtual environment, the Wazi Deploy binary files are installed in your home folder ($HOME/.local/bin). In this case, before you validate the Wazi Deploy installation, you must add this folder to the PATH environment variable with the following command:
```
export PATH=$PATH:$HOME/.local/bin
```
Validate the Wazi Deploy installation.
To do so, verify that all the Wazi Deploy command-line interface (CLI) modules are correctly installed by triggering the help options of the various CLI modules with the following commands:
- ```
wazideploy-package -h
```
- ```
wazideploy-generate -h
```
- ```
wazideploy-deploy -h
```
- ```
wazideploy-evidence -h
```
All these commands must display the command arguments.

Upgrading Wazi Deploy

To upgrade Wazi Deploy, download the installation files that are contained in the new wazideploy.tar file. Then, repeat the installation steps that are explained in Installing the requisites and Wazi Deploy.

Results

If you plan to deploy with Python, which directly targets the z/OS environment, the installation is now complete.