Skip to content

Commit 26178e8

Browse files
ddimatosddimatos
committed
Merge branch 'release-v1.3.0-beta.1'
2 parents e14191c + 980fd5b commit 26178e8

File tree

5 files changed

+134
-22
lines changed

5 files changed

+134
-22
lines changed

‎docs/source/conf.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -147,7 +147,7 @@
147147
# White list which Git tags documentation will be generated and linked into the
148148
# version selection box. This is currently a manual selection, until more
149149
# versions are released, there are no regular expressions used.
150-
scv_whitelist_tags = ('v1.0.0', 'v1.1.0$', 'v1.2.1$',)
150+
scv_whitelist_tags = ('v1.0.0', 'v1.1.0$', 'v1.2.1$', 'v1.3.0-beta.1$')
151151

152152
# Sort versions by one or more values. Valid values are semver, alpha, and time.
153153
# Semantic is referred to as 'semver', this would ensure our latest VRM is

‎docs/source/release_notes.rst‎

Lines changed: 43 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -89,12 +89,47 @@ Reference
8989

9090
.. note::
9191
There is an additional step for `Z Open Automation Utilities 1.1.0`_ (ZOAU)
92-
over prior installations of ZOAU on the target z/OS. After you install ZOAU
93-
whether from a PAX archive or through SMPe, you will need to perform a PIP
94-
installation of the ZOAU Python libraries using this command
95-
``pip install zoautil_py-1.1.0.tar.gz``. This will install the ZOAU
96-
Python libraries on the z/OS target for use z/OS Ansible Core and other
97-
collections.
92+
over prior installations of ZOAU on the target z/OS. After you have
93+
`configured IBM Open Enterprise Python on z/OS`_ **environment variables**
94+
on the z/OS target and have installed ZOAU from a PAX archive or through
95+
SMPe, you will need to perform a PIP installation of the ZOAU Python
96+
libraries and ensure you have either exported or added these environment
97+
variables to your **z/OS** host **.profile**.
98+
99+
**Variables**:
100+
101+
| ``export ZOAU_HOME=/usr/lpp/IBM/zoautil``
102+
| ``export PATH=${ZOAU_HOME}/bin:$PATH``
103+
| ``export LIBPATH=${ZOAU_HOME}/lib:${LIBPATH}``
104+
105+
**PIP installation command**:
106+
107+
| ``pip install zoautil_py-1.1.0.tar.gz``.
108+
109+
This will install the ZOAU Python libraries on the **z/OS** target for use
110+
by **z/OS Ansible core** and other collections.
111+
112+
However, the Python installation may not have the the symbolic link for
113+
``pip`` in which case you can use ``pip3`` to install the libraries:
114+
115+
| ``pip3 install zoautil_py-1.1.0.tar.gz``.
116+
117+
If the Python installation has not installed the ``wheel`` packaging
118+
standard and not updated the ``pip`` version to the latest, the warning
119+
messages can be ignored.
120+
121+
**Example output**:
122+
123+
| Processing ./zoautil_py-1.1.0.tar.gz
124+
| Using legacy setup.py install for zoautil-py, since package 'wheel' is
125+
not installed.
126+
| Installing collected packages: zoautil-py
127+
| Running setup.py install for zoautil-py ... done
128+
| Successfully installed zoautil-py-1.1.0
129+
| WARNING: You are using pip version 20.1.1; however, version 20.2.4 is
130+
available.
131+
| You should consider upgrading via the
132+
'<python_path>/pyz_3_8_2/usr/lpp/IBM/cyp/v3r8/pyz/bin/python3.8 -m pip install --upgrade pip' command.
98133
99134
* Supported by `z/OS V2R3`_ or later
100135
* The `z/OS® shell`_
@@ -139,6 +174,8 @@ Known issues
139174
https://github.com/IBM/z_ansible_collections_samples/blob/master/docs/share/configuration_guide.md#variables
140175
.. _support tickets:
141176
https://github.com/IBM/z_ansible_collections_samples/issues
177+
.. _configured IBM Open Enterprise Python on z/OS:
178+
https://www.ibm.com/support/knowledgecenter/SSCH7P_3.8.0/install.html
142179

143180
.. .............................................................................
144181
.. Blog Links

‎docs/source/requirements-single.rst‎

Lines changed: 44 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -49,13 +49,47 @@ proceed to install the IBM z/OS core collection.
4949
`playbook configuration`_ topic. In addition to the
5050
`playbook configuration`_, review our `FAQs`_ for additional help.
5151

52-
There is an additional step for `Z Open Automation Utilities 1.1.0`_
53-
(ZOAU) over prior installations of ZOAU on the target z/OS. After you
54-
install ZOAU whether from a PAX archive or through SMPe, you will need to
55-
perform a PIP installation of the ZOAU Python libraries using this command
56-
``pip install zoautil_py-1.1.0.tar.gz``. This will install the ZOAU
57-
Python libraries on the z/OS target for use z/OS Ansible Core and other
58-
collections.
52+
There is an additional step for `Z Open Automation Utilities 1.1.0`_ (ZOAU)
53+
over prior installations of ZOAU on the target z/OS. After you have
54+
`configured IBM Open Enterprise Python on z/OS`_ **environment variables**
55+
on the z/OS target and have installed ZOAU from a PAX archive or through
56+
SMPe, you will need to perform a PIP installation of the ZOAU Python
57+
libraries and ensure you have either exported or added these environment
58+
variables to your **z/OS** host **.profile**.
59+
60+
**Variables**:
61+
62+
| ``export ZOAU_HOME=/usr/lpp/IBM/zoautil``
63+
| ``export PATH=${ZOAU_HOME}/bin:$PATH``
64+
| ``export LIBPATH=${ZOAU_HOME}/lib:${LIBPATH}``
65+
66+
**PIP installation command**:
67+
68+
| ``pip install zoautil_py-1.1.0.tar.gz``.
69+
70+
This will install the ZOAU Python libraries on the **z/OS** target for use
71+
by **z/OS Ansible core** and other collections.
72+
73+
However, the Python installation may not have the the symbolic link for
74+
``pip`` in which case you can use ``pip3`` to install the libraries:
75+
| ``pip3 install zoautil_py-1.1.0.tar.gz``.
76+
77+
If the Python installation has not installed the ``wheel`` packaging
78+
standard and not updated the ``pip`` version to the latest, the warning
79+
messages can be ignored.
80+
81+
**Example output**:
82+
83+
| Processing ./zoautil_py-1.1.0.tar.gz
84+
| Using legacy setup.py install for zoautil-py, since package 'wheel' is
85+
not installed.
86+
| Installing collected packages: zoautil-py
87+
| Running setup.py install for zoautil-py ... done
88+
| Successfully installed zoautil-py-1.1.0
89+
| WARNING: You are using pip version 20.1.1; however, version 20.2.4 is
90+
available.
91+
| You should consider upgrading via the
92+
'<python_path>/pyz_3_8_2/usr/lpp/IBM/cyp/v3r8/pyz/bin/python3.8 -m pip install --upgrade pip' command.
5993
6094
* `z/OS OpenSSH`_
6195
* The `z/OS® shell`_
@@ -113,6 +147,9 @@ proceed to install the IBM z/OS core collection.
113147
.. _Z Open Automation Utilities 1.1.0:
114148
https://www.ibm.com/support/knowledgecenter/SSKFYE_1.1.0/install.html
115149

150+
.. _configured IBM Open Enterprise Python on z/OS:
151+
https://www.ibm.com/support/knowledgecenter/SSCH7P_3.8.0/install.html
152+
116153
Python on z/OS
117154
--------------
118155

‎docs/source/requirements_managed.rst‎

Lines changed: 45 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,48 @@ proceed to install the IBM z/OS core collection.
2626
`playbook configuration`_ topic. In addition to the
2727
`playbook configuration`_, review our `FAQs`_ for additional help.
2828

29-
There is an additional step for `Z Open Automation Utilities 1.1.0`_
30-
(ZOAU) over prior installations of ZOAU on the target z/OS. After you
31-
install ZOAU whether from a PAX archive or through SMPe, you will need to
32-
perform a PIP installation of the ZOAU Python libraries using this command
33-
``pip install zoautil_py-1.1.0.tar.gz``. This will install the ZOAU
34-
Python libraries on the z/OS target for use z/OS Ansible Core and other
35-
collections.
29+
There is an additional step for `Z Open Automation Utilities 1.1.0`_ (ZOAU)
30+
over prior installations of ZOAU on the target z/OS. After you have
31+
`configured IBM Open Enterprise Python on z/OS`_ **environment variables**
32+
on the z/OS target and have installed ZOAU from a PAX archive or through
33+
SMPe, you will need to perform a PIP installation of the ZOAU Python
34+
libraries and ensure you have either exported or added these environment
35+
variables to your **z/OS** host **.profile**.
36+
37+
**Variables**:
38+
39+
| ``export ZOAU_HOME=/usr/lpp/IBM/zoautil``
40+
| ``export PATH=${ZOAU_HOME}/bin:$PATH``
41+
| ``export LIBPATH=${ZOAU_HOME}/lib:${LIBPATH}``
42+
43+
**PIP installation command**:
44+
45+
| ``pip install zoautil_py-1.1.0.tar.gz``.
46+
47+
This will install the ZOAU Python libraries on the **z/OS** target for use
48+
by **z/OS Ansible core** and other collections.
49+
50+
However, the Python installation may not have the the symbolic link for
51+
``pip`` in which case you can use ``pip3`` to install the libraries:
52+
53+
| ``pip3 install zoautil_py-1.1.0.tar.gz``.
54+
55+
If the Python installation has not installed the ``wheel`` packaging
56+
standard and not updated the ``pip`` version to the latest, the warning
57+
messages can be ignored.
58+
59+
**Example output**:
60+
61+
| Processing ./zoautil_py-1.1.0.tar.gz
62+
| Using legacy setup.py install for zoautil-py, since package 'wheel' is
63+
not installed.
64+
| Installing collected packages: zoautil-py
65+
| Running setup.py install for zoautil-py ... done
66+
| Successfully installed zoautil-py-1.1.0
67+
| WARNING: You are using pip version 20.1.1; however, version 20.2.4 is
68+
available.
69+
| You should consider upgrading via the
70+
'<python_path>/pyz_3_8_2/usr/lpp/IBM/cyp/v3r8/pyz/bin/python3.8 -m pip install --upgrade pip' command.
3671
3772
* `z/OS OpenSSH`_
3873
* The `z/OS® shell`_
@@ -90,6 +125,9 @@ proceed to install the IBM z/OS core collection.
90125
.. _Z Open Automation Utilities 1.1.0:
91126
https://www.ibm.com/support/knowledgecenter/SSKFYE_1.1.0/install.html
92127

128+
.. _configured IBM Open Enterprise Python on z/OS:
129+
https://www.ibm.com/support/knowledgecenter/SSCH7P_3.8.0/install.html
130+
93131
Python on z/OS
94132
--------------
95133

‎galaxy.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ namespace: ibm
66
name: ibm_zos_core
77

88
# The collection version
9-
version: 1.2.1
9+
version: 1.3.0-beta.1
1010

1111
# Collection README file
1212
readme: README.md

0 commit comments

Comments
 (0)