Access product repositories on z/OS

WebSphere Application Server for z/OS® Liberty offerings are distributed as IBM Installation Manager repositories. These repositories contain the metadata and files required to create one or more levels of a particular product.

Note that this procedure uses several Installation Manager sample jobs to access the product repositories. These jobs can be found in the GIN.SGINJCL data set installed as part of FMID HGIN140. We can also download the sample jobs by following the instructions on the Sample jobs for Installation Manager on z/OS page.

Choose one of the following options to access the product repositories:

  • To install from web-based product and service repositories, complete the following steps. We can install both the initial product and the latest fix-pack level from the online repositories.

    1. Create a master.password file containing text to be used for an encryption key, and place the file in your Installation Manager file system. The recommended location is /InstallationManager/master.password.
    2. Edit and submit the GIN3CRED Installation Manager sample job to create an im.ssf credentials file containing your IBM user ID and password.

      If we use a firewall proxy to access the IBM website, the credentials file also contains the firewall credentials.

  • To install from local product and service repositories:

    1. Edit and submit the GIN3REPO Installation Manager sample job to allocate and mount a local repository file system at the /InstallationManager/repo location.

    2. For the initial product level, copy the following files from the product media or download them from the ShopzSeries website, and transfer them to your z/OS system. If we use FTP, be sure to transfer the files in binary format.

        was.repo.16002.liberty.zOS.zip

        Initial repository for WebSphere Application Server for z/OS Liberty.

        ShopzSeries download name: cd770150.zip

        was.repo.9000.plugins.zOS.zip

        Initial repository for the Web Server Plug-ins for WebSphere Application Server for z/OS Liberty.

        ShopzSeries download name: cd770160.zip

        was.repo.9000.ihs.zOS.zip

        Initial repository for IBM HTTP Server for z/OS.

        ShopzSeries download name: cd770170.zip

      Notes:

      • For physical media, the files are on the z/OS Compressed Repositories DVD. Transfer them in binary to your z/OS system.

      • For ShopzSeries, go to the Downloads page for your order and select Additional Publications for either Download Director or HTTP. Download each file using the download name listed previously, then rename the file to the repository ZIP file name (for example, was.repo.16002.liberty.zOS.zip) and transfer it in binary to your z/OS system.

      Place the files in the /InstallationManager/repo directory. We do not need to decompress the files, but make sure the Installation Manager user ID or group can read them.

    3. Download the latest fix pack repositories from IBM Fix Central, and copy the repositories to your z/OS system.

      If we use FTP, be sure to transfer the files in binary format.

        n.n.n.n-WS-LIBERTY-ZOS-FP.zip

        Fix pack repository for WebSphere Application Server for z/OS Liberty, where n.n.n.n is the fix pack number, such as 19.0.0.1.

        9.0.0-WS-PLG-ZOS-FPnnn.zip

        Fix pack repository for Web Server Plug-ins for WebSphere Application Server for z/OS Liberty .

        9.0.0-WS-IHS-ZOS-FPnnn.zip

        Fix pack repository for IBM HTTP Server for z/OS.

        ibm-java-sdk-8.0-n.n-zos-arch-installmgr.zip

        Fix pack repository for IBM SDK, Java Technology Edition, Version 8.

      Place the files in the /InstallationManager/repo directory. We do not need to decompress the files, but make sure that the Installation Manager user ID or group can read them.

We can access the initial product repositories and optional service repositories.

To display the exact contents of the repositories, use the Installation Manager imcl listAvailablePackages command.

See the GIN3LSTA Installation Manager sample job for web-based repositories and the GIN3LSTL sample job for local repositories.

These repositories can be supplemented with materials from the web-based service repository or from downloaded service repositories. Service repositories can be obtained from Fix Central.


What to do next

When using IBM Installation Manager to install WebSphere Application Server for z/OS Liberty, specify the path to the appropriate repository in the -repositories parameter of the imcl command.