Before you deploy to the IBM® z/OS® platform,
you must install the z/OS deployment
tools and configure the z/OS server
for communication with IBM UrbanCode Deploy.
If the build process runs on a different logical partition (LPAR),
then you must additionally install the deployment tools on the build
LPAR.
Procedure
- Click the Help icon, and then click Tools. The tools that are available for download from the IBM UrbanCode Deploy server
are displayed.
- Download the z/OS deployment
tools and the IBM UrbanCode Deploy client
archive. Extract the archive file that contains the deployment tools
to the UNIX file system of the z/OS server. For example, type the following text at the command line
to extract the archive file: pax -r -pp -vf ucdtoolkit.zip.
- Create and run a job in job control language (JCL) that
loads the SBUZENV, SBUZEXEC, SBUZMENU,
and SBUZSAMP libraries. Use the sample BUZEXPD job
in the tool_installation_directory/mvs directory
as a model. Change #HLQ, #TVOLSER,
and -PATH-PREFIX- as required for your system.
- Extract the archive file that contains the IBM UrbanCode Deploy client,
and then copy the udclient.jar file to the tool_installation_directory/lib directory. If you copy the udclient.jar file over FTP,
use binary mode.
- Create a repository directory in the UNIX file system of
the z/OS server
where you run builds. The repository directory is where
the version artifacts are stored. Ensure that there is sufficient
space for the repository directory and that the user who runs the z/OS deployment
tools has read and write access to the directory.
- Create a token to use for secure communication between
the IBM UrbanCode Deploy server
and the z/OS server.
In IBM UrbanCode Deploy,
click . For
more information, see Tokens.
- Update the property file. Open the high_level_qualifier.SBUZENV(BUZPROF) data
set, and change the following values:
| Parameter |
Description |
| java.home |
The location of the Java Runtime Environment (JRE) |
| ucd.toolkit.usshome |
The deployment tools installation directory |
| ucd.toolkit.mvshlq |
The high-level qualifier for toolkit z/OS libraries |
| ucd.server.url |
The URL of the IBM UrbanCode Deploy server |
| ucd.server.accesstoken |
The security token that you created previously |
| ucd.repository |
The location of the repository directory |
For example, a property file might contain
the following lines:#Thu Apr 03 15:07:08 EDT 2014
java.home=/usr/lpp/java/J7.0_64
ucd.toolkit.usshome=/usr/lpp/ucd/ucdtoolkit
ucd.toolkit.mvshlq=BUZ.BUZ610
ucd.repository=/usr/lpp/ucdtoolkit/repo
ucd.server.url="https://192.0.2.0:8444"
ucd.server.accesstoken="2f615f22-01d1-4d5f-99a5-a12f2c2968e4"
- Use the authorized program facility (APF) to authorize
the checkaccess utility. In the /bin directory
under the directory where you installed the deployment tools, type
the following text at the command line: extattr +a checkaccess. You must have read access to the BPX.FILEATTR.APF resource
in the FACILITY class profile to run this command.
What to do next
After you install and configure the deployment tools, configure
the ISPF gateway.