IBM Support

Installing Db2 Configuration Manager for z/OS V4.1.2 and above

Product Documentation


Abstract

Installing Db2 Configuration Manager for z/OS V4.1.2 and above

Content

In the details that follow, replace <platform> with your platform:

  • For AIX, use aix. The downloaded file has the extension .tgz.
  • For Linux x86-64, use linux-x86_64. The downloaded file has the extension .tgz.
  • For Linux on Power Systems (little endian), use plinux-le. The downloaded file has the extension .tgz.
  • For Linux on System z, use zlinux. The downloaded file has the extension .tgz.
  • For Windows, use win64. The downloaded file has the extension .zip.

Overview

Important:  On z/OS platforms, Db2 LUW installation package is currently not available for download from IBM Software Shopz . It is therefore recommended to use Db2 z/OS as the repository database unless you have your own Db2 LUW package and LAK.

The following is a summary of how to download, install, and configure either a new Db2 Configuration Manager for z/OS (CMz) installation for versions 4.1.2 and above, or an upgrade from a previous Db2 CMz installation.

Steps include:

  1. Downloading Db2 CMz [the CMz base image package and the Licence Activation Kit (LAK)]
  2. Installing or upgrading Db2 CMz
  3. Applying the Db2 CMz LAK
  4. Enabling Db2 CMz features
  5. Adding or upgrading a repository database
  6. [Optional On-Demand]Reverting back to a previous Db2 CMz installation

 

IMPORTANT NOTE:

 

    1. CMz is not available as a stand-alone product.
    2. CMz is part of the Administration Solution Pack<PID: 5697-ASP> and can be downloaded from IBM Software Shopz if you are entitled to the Administration Solution Pack.
    3. CMz is also part of the Db2 Connect Unlimited Advanced Edition (CUAE) for System z and can be downloaded from Passport Advantage if you are entitled to Db2 CUAE.
    4. To enable the CMz features, you must apply the license activation kit (LAK), the LAK is ONLY available from IBM Software Shopz.
    5. All modification releases and fix packs of CMz will be available for downloading via Fix Central(without LAK).

Step 1: Downloading Db2 Configuration Manager for z/OS:

[Ordering and Downloading From IBM Software Shopz]

 


  • IMPORTANT:
    Db2 Configuration Manager for z/OS V4.1.2 and V4.1.3 is part of the Administration Solution Pack V3.1 <PID: 5697-ASP> and can be ordered and downloaded from IBM Software Shopz if you are entitled to the Administration Solution Pack.

    The following table lists the form numbers in the CMz V4.1.2 and above.
    Description
    Form Number
    IBM Db2 Configuration Manager for z/OS V4.1.3 - License Activation Kit
    LCD4-8589-02
    IBM Db2 Configuration Manager for z/OS V4.1.3 - for AIX Operating Systems
    LCD4-8585-02
    IBM Db2 Configuration Manager for z/OS V4.1.3 - for Linux Operating Systems
    LCD4-8586-02
    IBM Db2 Configuration Manager for z/OS V4.1.3 - for Windows Operating Systems
    LCD4-8587-02
    IBM Db2 Configuration Manager for z/OS V4.1.2 - License Activation Kit
    LCD4-8589-01
    IBM Db2 Configuration Manager for z/OS V4.1.2 - for AIX Operating Systems
    LCD4-8585-01
    IBM Db2 Configuration Manager for z/OS V4.1.2 - for Linux Operating Systems
    LCD4-8586-01
    IBM Db2 Configuration Manager for z/OS V4.1.2 - for Windows Operating Systems
    LCD4-8587-01
    IBM InfoSphere Optim Data Tools Runtime Client v3.1.0.6 - Bulk Deploy
    LCD4-8590-01

    First, order Db2 CMz from IBM Software Shopz:
    1. From the Fast access panel on the Shopz home page, click Sign in for registered users and sign into the site, using the credentials provided to you by IBM.
    2. From the Group page, click create new software orders for service or products.
    3. From the My orders page, under Package category, click the option button to the left of z/OS - Products, select CBPDO (products) from the drop-down list, and then click Continue. The next page presents the basic details of your order:
    4. Verify the details and click Continue.
    5. On the next page, choose a hardware option that matches your machine, and click Continue.
    6. On the next page, choose the option button to the left of Do not use a report for this order, and click Continue.
    7. On the next page, search for Db2 Configuration Manager for z/OS, using the following selections:

      Group: select DBS - Db2 (114 Products)
      Language: (your preferred language)
      Filter: select Show licensed products
      Search field: click the Product ID option button
      Search for: enter 5697-ASP
      Sort by: click the Product ID option button

      Click Show catalog, and then click Continue.
    8. Scroll through the result set to locate Version(e.g. 4.1.2), click the Select check box and click Continue.

      On the next page you should see a message, verifying that your order is fully entitled.
    9. On the next page, under Delivery media, select Internet as the preferred media.
    10. On the next page, review your order, then click Submit.

      You will receive an email containing credentials you need to download the product, and a link to the Shopz download page.
    11.  

    Then, download your ShopZ order

    1. You will receive a series of email after you submit your order. You don’t need to do anything until you get the “Your order is ready” email. The email will have the link to the download site for your products. For example:
    1.  


    2. Click on the download link. You will be asked to log in to ShopZ.
    3. After you log in you will be redirected to the Download page for your order.

    4. On the download page there are two sections that are of interest to us.
    • The CBPDO material or z/OS archives, and
    • The CD/DVD Images and Other Materials or LUW archives




    5. Click on “CD/DVD Images and other materials” download link, for example to click on Db2 Administration Solution Pack for z/OS V3.1 to download License Information:


    6. The File Browser dialog will direct you to download (i.e. save) the file into a location of your choice.

    The customer needs to download these images and burn them onto CDs/DVDs or use a utility like 7zip that can extract from ISO files. Assuming you use 7zip, you should see 3 folders after extraction. AIX, lnx, win.

    7. If you go into the win folder, you will see a .zip file. If you go into the AIX or lnx folders, you will see a tar.gz file.
    Extract again from these files (e.g. using 7zip >Extract…).







    •  
  •  
  •  
  •  
  •  
  •  


[Downloading From Fix Central]

 


  • IMPORTANT:
    To enable Db2 Configuration Manager for z/OS features, you must apply the license activation kit (LAK),The LAK is only available from IBM Software Shopz.

    Fix IDs are listed as below.
    • 4.1.3-Information_Management-Db2-Configuration-Manager-for-zOS-plinux-le
    • 4.1.3-Information_Management-Db2-Configuration-Manager-for-zOS-linux-x86_64
    • 4.1.3-Information_Management-Db2-Configuration-Manager-for-zOS-AIX
    • 4.1.3-Information_Management-Db2-Configuration-Manager-for-zOS-zlinux
    • 4.1.3-Information_Management-Db2-Configuration-Manager-for-zOS-win64
    • 3.1.0.6-Information_Management-DTRC_BulkDeploy_allplatforms(build level:201712041854)
    • 4.1.2-IM-DB2-Configuration-Manager-for-zOS-plinux-le
    • 4.1.2-IM-DB2-Configuration-Manager-for-zOS-linux-x86_64
    • 4.1.2-IM-DB2-Configuration-Manager-for-zOS-AIX
    • 4.1.2-IM-DB2-Configuration-Manager-for-zOS-zlinux
    • 4.1.2-IM-DB2-Configuration-Manager-for-zOS-win64
    • 3.1.0.6-Information_Management-DTRC_BulkDeploy_allplatforms
    1. From the Fix Central home page, click the Find Product tab.
    2. In the Product Selector field, enter Db2 Configuration Manager for z/OS. When a matching result is found, click the option from the drop-down list box.
    3. From the Installed Version drop-down box, select the version from which you wish to upgrade.
    4. From the Platform drop-down box, select All or the option for the platform you want to download. Click Continue.
    5. Confirm Browse for fixes is selected and click Continue.

      Note: You can also select Individual fix IDs and input one of the fix IDs listed above, to find the right install package for your platform.
    6. Click the check box to the left of the package you want to download and click Continue. You will need to enter an IBM ID to perform the download.

Step 2: Installing/Upgrading Db2 Configuration Manager for z/OS:

[To complete your first installation of Db2 Configuration Manager for z/OS V4.1.2 and above]

  1. After you have downloaded the package, extract the package contents. The extracted package expands into an /ibm-datasrvrmgr installation directory.

    For the remainder of this Tech Note, the installation directory is referred to as <installdirectory>.
  2. If you want a silent installation, change the default values in the <installdirectory>/setup.conf file of your extracted package prior to installing.

    Note: To enable Db2 Configuration Manager for z/OS features, apply the license activation kit (LAK) included with your order. See Applying IBM Db2 Configuration Manager for z/OS V4.1.2 and above license activation kits below for instructions. When finished, continue from step 4.
  3. From the installation directory, run the setup script and follow the prompts. To run in a terminal window, run the following command:
    setup -silent.
  4. Log in to Db2 Configuration Manager for z/OS.
  5. From the Navigation bar, click Settings >Manage Connections.
  6. From the Database Connection pane, select the z/OS connection for which you want to enable the Configuration Manager license, and click Activate License.
  7. Click the URL in the Db2 Edition column to display the current supported capabilities in the Capabilities column. For example, if you have applied your Db2 Configuration Manager for z/OS license to that connection, you will see DSM_ENTERPRISE_Z_CONFIGURE in the Capabilities column.

    Note: You can use HTTPS with SSL security exclusively to connect to your Db2 Configuration Manager for z/OS server. To do this, set the following values in the <installdirectory>/Config/dswebserver.properties file:
    • cookie.secureOnly=true
    • port=-1

Once setup completes and you have configured SSL Security, your DB2 Configuration Manager for z/OS server is ready for use.

 

[To upgrade an existing Db2 CMz installation to Version 4.1.2 and above]

Note: Prior to upgrading, it is a good idea to make a backup of your repository database. Having such a backup is vital to successfully regressing back to an older CMz environment, should you need to do so.

 

  1. Stop your current Db2 CMz server or service. If your server is running as a Windows service, run <installdirectory>\bin\stopservice. Otherwise, run <installdirectory>/bin/stop.sh.
  2. Verify that the server is stopped, by running <installdirectory>/bin/status.
  3. Extract the package for Db2 CMz V4.1.2 and above that you downloaded previously into your install directory. Allow the files to be overwritten and replaced.
  4. From the installation directory, run the setup script and follow the prompts, or do a silent install from a terminal window.
    To do a silent install, review and modify <installdirectory>/setup.conf, as required, and then run the following command: setup -silent.
  5. Verify that the server is started, by running <installdirectory>/bin/status. The message is shown as follows:
    dsserver_home: /data/DSMbuild/ibm-datasrvrmgr
    port: 11080
    https.port: 11081
    status.port: 11082
    SERVER STATUS: ACTIVE

    Note: If you keep historical data from Db2 CMz V4.1.2 in the browser, you will need to clear the browser cache after you upgrade successfully from Db2 CMz V4.1.2 to Db2 CMz V4.1.3. You can find instructions on how to clear the cache for your specific browser at one of the following sites:
  6. Ensure that your repository database is up to date.
    • If your repository database resides on a LUW platform, navigate to the /samples/DB2LUW folder of your CMz installation folder, and locate and run validate.sql. This will tell you if any of your repository tables are missing.
    • If your repository database resides on a z/OS system, you will need to perform additional steps to make it compatible with your new CMz environment.
      For repository migration steps, refer to the IBM Knowledge Center topic, Upgrading an existing Db2 for z/OS repository database

Now the upgrade is complete and your server is ready for use.

 

 

Step 3 : Applying Db2 Configuration Manager for z/OS License Activation Kit (LAK):

[Apply a license activation kit (LAK) to enable enhanced configuration features]

 

Note: If you are performing an upgrade and have already applied the CMz LAK to your previous version of CMz, you can skip this step.

 

  1. Download the entitled license activation kit package from IBM Software Shopz as described in Step 1.
    Use ibm-db2configmgr-4.1.X-license-activation-kit-<platform>. The plinux-le and zlinux
    platforms share the same LAK as linux-x86_64.
  2. Stop the Db2 Configuration Manager for z/OS server or service.
    If Db2 Configuration Manager for z/OS is running as a Windows service, run <installdirectory>\bin\stopservice. Otherwise, run <installdirectory>/bin/stop.sh.
  3. Verify that the server is stopped by running <installdirectory>/bin/status.
  4. Apply the license activation kit:
    1. Extract each entitled LAK into your install directory.
    2. Allow files to be overwritten and replaced.
      For example: the Config, dscomponents, and license folders in the LAK should be extracted to the Config, dscomponents and license folders in your installation directory.
  5. From the installation directory, run the start script to start the Db2 Configuration Manager server or service.
    If the Configuration Manager is running as a Windows service, run <installdirectory>\bin\startservice. Otherwise, run <installdirectory>/bin/start.sh..


Your Db2 Configuration Manager for z/OS V4.1.2 and above license activation kits have been applied.

Step 4 : Enabling IBM Db2 Configuration Manager for z/OS features:

Once you have installed the package and applied the LAK, you can enable Db2 CMz features for your Db2 for z/OS connections.

[To enable Db2 CMz features]

  1. Log in to Db2 CMz.
  2. From the Navigation bar, click Settings >Manage Connections.
  3. From the Database Connection pane, create a new z/OS connection, or select the z/OS connection for which you want to enable the CMz license, and click Activate License.
  4. From the Edition column, click the corresponding URL to display the current supported capabilities in the Capabilities column. For example, if you have applied your Db2 CMz license to that connection, you will see DSM_ENTERPRISE_Z_CONFIGURE in the Capabilities column.

 

Step 5 : Creating or upgrading a repository database for historical data collection

 

CMz requires a repository database for the storage of historical data. Follow the steps in the IBM Data Server Manager Knowledge Center to add or upgrade a repository database.

 

Step 6 (Optional) : Reverting back to a previous IBM Db2 Configuration Manager for z/OS installation, after upgrading

 

When you upgrade your current CMz environment, the running of the setup script creates a sub-folder within your installation folder, titled dsm_bak_v21x, that is populated with a backup of your current CMz installation.

Note: The naming of this file is dictated by the version of IBM Data Server Manager (DSM) that corresponds to your installed version of CMz, prior to upgrading (e.g., CMz 4.1.2 and DSM 2.1.4), as this mechanism is used by all of the DSM-based management consoles.

In the event that you want to revert back to your original DSM installation, after upgrading, you can use the contents of this folder to re-create your previous DSM environment.

Note: Be advised that, if you have already upgraded your repository database for use with your upgraded DSM version, there are several changes to tables that cannot be reverted. This process will only work using a clean backup of your previous DSM repository database.

To revert back to a previous DSM installation:

 

  1. Install a new instance of the CMz version to which you want to revert back.
  2. From the installation folder of your upgraded CMz instance, locate and open your \dsm_bak_v21x sub-folder.
  3. Copy the contents of the \dsm_bak_v21x sub-folder to the corresponding locations within your newly created CMz installation.
  4. If you have not already done so, start your newly regressed version of the CMz application.
  5. Log in through the web console and examine your product setup. You will find that your settings, such as the Java Heap Size and System port number, have been reverted to their previous values.
  6. Go to Settings > Product Setup and restore the connection to your previous CMz repository database, or to a restored backup of that database.
    You will find all the information in the repository database is still here.

 

[{"Product":{"code":"SSXW2F","label":"IBM Db2 Configuration Manager for z\/OS"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"4.1.3;4.1.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
24 July 2018

UID

swg27046889

Page Feedback