Installing the IWSz Server for AAI
As an AAI administrator, you perform full or deploy installations of the IWSz Server for AAI to either enable the AAI/IWSz integration for the first time, or to perform maintenance activities on the installation.
-
Full Installation
You do a full installation for the initial install and to install new builds of the package. With the initial install, the following is created:
-
The z/OS libraries mentioned in Preparing to Install the IWSz Server for AAI
-
The AISZINST control member in the CUSTLIB library
-
Tailored CLIST members that start the IMS
-
Some JCL members that are used when setting up instances of the IWSz Server for AAI. They are created in the CUSTLIB.
-
-
Deploy Installation
You do a deploy installation to install only the USS executable modules on other LPARs that will then share the z/OS libraries created by an initial full install. A deploy installation updates the existing AISZINST control member in the CUSTLIB with the new LPAR information.
When you do a full installation to apply maintenance, you must do a further deploy installation for any additional LPARs to also update the USS modules on those LPARs to the same maintenance level.
To Install the IWSz Server for AAI
The Installation Checklist (IWSz Server for AAI) topic contains a list of the parameters that you must define during the installation process. Make sure that you have it at hand because you will now need the data that you have specified on that list.
-
Go to https://downloads.automic.com/, log in with your Broadcom account and download the relevant version of the mainframe data provider. For more information, see Downloads.
-
Unzip it to extract the ZOS_Data_Provider_2.0.0.pax.Z distribution package.
To maintain accuracy of the AISZINST control member in the CUSTLIB library used by the IMS, you must use this pax.Z distribution for both full and deploy installations.
-
Upload the pax.Z distribution package to the temporary USS directory that you will use for the installation process. Use a file transfer mechanism in binary mode for this purpose.
-
Using the OMVS environment, extract the contents of the pax.Z distribution package to that temporary directory by using the following command:
pax -rvf ZOS_Data_Provider_2.0.0.pax.Z
-
In the OMVS environment, start the installation program by issuing the following command:
./AISZ_Installer
-
Select one of the installation options:
-
1 = a full installation
-
2 = a deploy installation
-
-
Use the installation checklist now and enter the parameter as required. The following sections provide samples of both the full and deploy install messages and prompts, with example responses:
For more information, see Installation Checklist (IWSz Server for AAI).
-
Once the installation is completed, either full or deploy, you may need to change the permissions and ownership of the execution $HOME USS directory, and the files within it. Whether you must do it depends on how the directory was initially set up and how the User ID under which the IWSz Server for AAI primary STC executes has been defined:
-
The User ID is the Owner of the USS directory (chown command)
The recommended permissions for the directory and files is rwxrw-r-- (chmod 764 command).
-
The User ID is a member of a Group with access to the USS directory
The recommended permissions for the directory and files is rwxrwxr-- (chmod 774 command).
-
Full Install Log
The following is a sample output from performing a full install for an initial installation of the IWSz Server for AAI where the Full REXX Library is installed on the LPAR. The sample full installation permits the specification of SMS parameters, but will default to using SMS values associated with the HLQ used if these are not entered.
=============== z/OS Data Providers for AAI R2.0 Build 220922 ================ = = = System Installer = = = ============================================================================== ----------------------------------------------------------------- z/OS Data Providers for AAI R2.0 Installation Type Selection ----------------------------------------------------------------- Select the Installation Type required : 1 - Full Install creating Installation Libraries 2 - USS Module Deployment Only X - Exit Installer ===> 1 ----------------------------------------------------------------- z/OS Data Providers for AAI R2.0 Library Allocation Settings ----------------------------------------------------------------- Installation Libraries will be created as : 'your_HLQ.CAIZISPF' 'your_HLQ.CAIZLOAD' 'your_HLQ.CUSTLIB' Enter "your_HLQ" or "EXIT" to end Installer ===> cai.aisz Allocations can use SMS Class values or a specific Volume Enter "Management Class" value or blank for defaults ===> Enter "Storage Class" value or blank for defaults ===> Enter "Data Class" value or blank for defaults ===> Enter "Volume Serial" name or blank for defaults ===> ----------------------------------------------------------------- z/OS Data Providers for AAI R2.0 USS Directory specification ----------------------------------------------------------------- Specify the z/OS Data Providers for AAI execution USS directory e.g. "/opt/CA/AISZ" Enter the full path or "EXIT" to end Installer ===> /u/products/cai/AISZ ----------------------------------------------------------------- z/OS Data Providers for AAI R2.0 - REXX Library Type support ----------------------------------------------------------------- Is the "Full Library for REXX on System z" available? NOTE: Execution using the Full REXX Library is more efficient If "N" REXX Alternate Library support will be installed Enter Y/N ===> y ============================================================================== = = = z/OS Data Providers for AAI R2.0 Installation Settings = = = ============================================================================== Installation Package Directory = /u/users/shebi01/AISZPCKG Installation Library High Level Qualifier = CAI.AISZ SMS Management Class = SMS Storage Class = SMS Data Class = Volume Serial Number = z/OS Data Providers for AAI £HOME Directory = /u/products/cai/AISZ ============================================================================== ===> WARNING <=== Existing Installation Libraries will be deleted Existing USS Execution Modules will be replaced Enter "EXIT" and rename to save current Libraries ============================================================================== Enter "Y" to Confirm Full Installation or "EXIT" to end Installer ===> y AIZ.IN03I: Full Installation starting on 22/09/22 at 10:30:03 AIZ.IN05I: Deleting any existing Package XMIT z/OS datasets AIZ.IN06I: Creating temporary Package XMIT z/OS datasets AIZ.IN10I: Temporary XMIT z/OS datasets successfully created AIZ.IN11I: Copying XMIT Package files to z/OS XMIT datasets AIZ.IN13I: Package file CAIZISPF.XMIT successfully copied AIZ.IN16I: Package file CAIZLOAD.XMIT successfully copied AIZ.IN18I: Deleting any existing Installation Libraries AIZ.IN22I: Installation Libraries successfully created AIZ.IN23I: Executing RECEIVE commands to build Installation Libraries AIZ.IN26I: XMIT dataset RECEIVE processing successfully completed AIZ.IN27I: Copying Executables to /u/products/cai/AISZ AIZ.IN34I: Executable modules successfully copied to /u/products/cai/AISZ AIZ.IN35I: Creating Installation Tailored CUSTLIB Library AIZ.IN40I: CUSTLIB member AISZINST successfully created AIZ.IN41I: Populating Installation Tailored CUSTLIB Library AIZ.IN43I: CUSTLIB member AIZCPRIM successfully created AIZ.IN45I: CUSTLIB member AITCPRIM successfully created AIZ.IN47I: CUSTLIB member AI7CPRIM successfully created AIZ.IN49I: CUSTLIB member AIZJGKEY successfully created AIZ.IN50I: Full Installation successfully completed on 22/09/22 at 10:30:07 ============================================================================== = = = Copy the following command to start the ISPF Interface = = " EX 'CAI.AISZ.CUSTLIB(AIZCPRIM)' " = = = = Installation Completed = = = =============== z/OS Data Providers for AAI R2.0 Build 220922 ================
Deploy Install Log
The following is a sample output from performing a deploy install of the IWSz Server for AAI.
=============== z/OS Data Providers for AAI R2.0 Build 220922 ================
= =
= System Installer =
= =
==============================================================================
-----------------------------------------------------------------
z/OS Data Providers for AAI R2.0 Installation Type Selection
-----------------------------------------------------------------
Select the Installation Type required :
1 - Full Install creating Installation Libraries
2 - USS Module Deployment Only
X - Exit Installer
===>
2
-----------------------------------------------------------------
z/OS Data Providers for AAI R2.0 CUSTLIB High Level Qualifier
-----------------------------------------------------------------
Enter HLQ for existing CUSTLIB Library or "EXIT" to end Installer
===>
cai.aisz
-----------------------------------------------------------------
z/OS Data Providers for AAI R2.0 USS Directory specification
-----------------------------------------------------------------
Specify the z/OS Data Providers for AAI execution USS directory
e.g. "/opt/CA/AISZ"
Enter the full path or "EXIT" to end Installer
===>
/u/products/cai/AISZ
-----------------------------------------------------------------
z/OS Data Providers for AAI R2.0 - REXX Library Type support
-----------------------------------------------------------------
Is the "Full Library for REXX on System z" available?
NOTE: Execution using the Full REXX Library is more efficient
If "N" REXX Alternate Library support will be installed
Enter Y/N
===>
y
==============================================================================
= =
= z/OS Data Providers for AAI R2.0 Installation Settings =
= =
==============================================================================
Installation Package Directory = /u/users/shebi01/AISZPCKG
Installation Libraries = Already Exist
CUSTLIB Library = CAI.AISZ.CUSTLIB
z/OS Data Providers for AAI £HOME Directory = /u/products/cai/AISZ
==============================================================================
===> WARNING <===
Existing USS Execution Modules will be replaced
==============================================================================
Enter "Y" to Confirm USS Deployment or "EXIT" to end Installer
===>
y
AIZ.IN04I: USS Deployment starting on 22/09/22 at 11:09:28
AIZ.IN27I: Copying Executables to /u/products/cai/AISZ
AIZ.IN34I: Executable modules successfully copied to /u/products/cai/AISZ
AIZ.IN51I: Checking CUSTLIB Library for CA66 USS Path
AIZ.IN53I: CUSTLIB member AISZINST successfully updated
*----------------------------------------------------------------*
* *
* NOTE: *
* Modify CUSTLIB member AIZJGKEY line 17 to become *
* -f /u/products/cai/AISZ/.ssh/id_rsa
* To use for SSH Authentication Key Generation on this LPAR *
* *
*----------------------------------------------------------------*
AIZ.IN54I: USS Deployment successfully completed on 22/09/22 at 11:09:28
==============================================================================
= =
= USS Deployment Completed =
= =
=============== z/OS Data Providers for AAI R2.0 Build 220922 ================
Next Steps
When the installation process is completed, you are ready to start implementing instances:
- Preparing for the IWSz Server for AAI Implementation
- Implementation Checklists (IWSz Server for AAI)
- Implementing an Instance of the IWSz Server for AAI
- Schedulers
See also: