Installing z/OS Provisioning Toolkit

z/OS PT is packaged as a compressed file that you can download without charge. Install z/OS PT, ready for subsequent configuration.

1. Find z/OS PT for download on IBM z/OS Provisioning Toolkit product page.
2. Extract the .zip file.
3. Transfer the .pax file in binary format to the system where you want to run z/OS PT.
4. Issue the following command to extract the .pax file:

   pax -rf zospt_v#######.pax

   The zospt installation directory is created.
5. Ensure that the user ID under which z/OSMF runs (the default user ID is IZUSVR), has both read and execute permissions for all directories and subdirectories in the zospt path. To change the permissions, issue this command:

   chmod -R 755 zospt_install_dir

6. Ensure all user IDs under which you run zospt have the necessary permissions:
   • Read and run permissions for all directories in the zospt path.
   • Read, write, and run permissions for the images and logs directories in the zospt path.
7. Add zospt to the PATH.
   For quick access to the toolkit, issue the following command, where zospt_directory is the full path of the z/OS PT installation directory:

   export PATH=$PATH:zospt_directory/bin

   To persist the PATH declaration between sessions, add this command to your .profile file on z/OS UNIX System Services. For more information, see Customizing your .profile in the z/OS UNIX System Services User's Guide.
8. Optional: If you do not want to use the default domain and tenant in z/OSMF, add the following environment variables:

   zospt_domain=zospt_domain_name
   zospt_tenant=zospt_tenant_name

   One way to do this is to update your .profile in z/OS UNIX System Services. For further details, see Configuring z/OS Provisioning Toolkit.

9. Enter the following command from the zospt directory:

   zospt --help

   If the installation is successful, the command help prints to the command line.