Installing the CA7 Server for AAI
As an AAI administrator, you perform full or deploy installations of the CA7 Server for AAI to either enable the AAI/CA7 integration for the first time, or to perform maintenance activities on the integration.
-
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 CA7 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 CA7 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 install to apply maintenance, you must do a further deploy install for any additional LPARs to also update the USS modules on those LPARs to the same maintenance level.
To Install the CA7 Server for AAI
The Installation Checklist (CA7 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; 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 AAI Mainframe Data Provider (AAI.ZOS_DataProvider.Mainframe), which you find under Automation Analytics & Intelligence. For more information ,see Downloads.
Note: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.
-
Unzip the file to extract the zOS_Data_Providers_for_AAI_<version>.pax.Z mainframe distribution package.
-
Upload the pax.Z distribution package to the temporary USS directory that you will use for the installation process. Use a file transfer in binary mode for this purpose.
-
Using the OMVS environment, extract the content of the pax.Z distribution package to that temporary directory by using the following command:
pax -rvf zOS_Data_Providers_for_AAI_<version>.pax.Z
-
In the OMVS environment, start the installation program by issuing the following command:
./AISZ_Installer
-
Select one of the installation options:
-
1 for a full installation
-
2 for a deploy installation
-
-
Use the installation checklist now and enter the parameter as required. For more information, see Installation Checklist (CA7 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 CA7 Server for AAI primary STC executes has been defined:
-
If 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).
-
If 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 CA7 Server for AAI where the Full REXX Library is installed on the LPAR and SDSF is selected for the LOG Access method.
The sample full installation permits the specification of SMS parameters, but has defaulted to using SMS values associated with the HLQ used, as these were not entered.
============== z/OS Data Providers for AAI <R##> Build #### ==================
= =
= System Installer =
= =
==============================================================================
-----------------------------------------------------------------
z/OS Data Providers for AAI <R##> 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 <R##> 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.<R##>
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 <R##> 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/users/cai/AISZ
-----------------------------------------------------------------
z/OS Data Providers for AAI <R##> Log Access Program Setting
-----------------------------------------------------------------
Select the program to access the STC Log :
1 - SDSF
2 - Sysview
X - Exit Installer
===>
1
-----------------------------------------------------------------
z/OS Data Providers for AAI <R##> - REXX Library Type support
-----------------------------------------------------------------
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 <R##> Installation Settings =
= =
==============================================================================
Installation Package Directory = /u/users/shebi01/AISZPCKG
Installation Library High Level Qualifier = CAI.AISZ.AAI <R##>
SMS Management Class =
SMS Storage Class =
SMS Data Class =
Volume Serial Number =
z/OS Data Providers for AAI £HOME Directory = /u/users/cai/AISZ
z/OS Data Providers for AAI LOG Access = SDSF
==============================================================================
===> 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 <date> at <time>
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/users/cai/AISZ
AIZ.IN34I: Executable modules successfully copied to /u/users/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 <date> at <time>
==============================================================================
= =
= Copy the following command to start the ISPF Interface =
= " EX 'CAI.AISZ.<R##>.CUSTLIB(AIZCPRIM)' " =
= =
= Installation Completed =
= =
=========== z/OS Data Providers for AAI AAI <R##> Build ###### ===============
Next Steps
When the installation process is completed, you are ready to start implementing instances:
See also: