Date: August 2005

 	About this interim fix

This section includes the following topics:
*  2.1, "Interim fix contents and prerequisites"
*  2.2, "New features contained in this interim fix"
*  2.3, "Product compatibility"
*  2.4, "Fixes contained in this interim fix"

2.1 Interim fix contents and prerequisites

IBM(R) Configuration Manager, Version 4.2.3, Interim Fix 4.2.3-TCM-0001
prerequisites IBM Tivoli(R) Configuration Manager, Version 4.2.3.

Perform the following steps to extract the interim fix:
1. Extract the contents into a scratch directory. Assume that the symbol
   $PATCH points to this directory. Five tar files are provided:
   *  4.2.3-TCM-0001_docs.tar
   *  4.2.3-TCM-0001_images.tar
   *  4.2.3-TCM-0001_package.tar
   *  4.2.3-TCM-0001_spb_installer.tar
   *  4.2.3-TCM-0001_tools.tar

2. cd $PATCH
3. tar -xvf 4.2.3-TCM-0001_docs.tar. Under the $PATCH you will find the
   following Directory or Path Contents:

   /docs    Readme files.
4. tar -xvf 4.2.3-TCM-0001_images.tar. Under the $PATCH you will find
   the following Directory or Path Contents:

   /xml     To install interim fixes using the ISMP installation
            program, 423CM001.xml file contained in this directory must
            be copied locally and referred to at the installation time.

   /images  Images required for this interim fix.
5. tar -xvf 4.2.3-TCM-0001_package.tar. Under the $PATCH you will find
   the following Directory or Path Contents:

   /package Software package block files used to patch GUI components
            and the CM423_SPB_0001.xml descriptor file.
6. tar -xvf 4.2.3-TCM-0001_spb_installer.tar. Under the $PATCH you will
   find the following Directory or Path Contents:

   /spb_installer
            SPB Patch Installer that installs SPB interim fixes locally.
7. tar -xvf 4.2.3-TCM-0001_tools.tar. Under the $PATCH you will find the
   following Directory or Path Contents:

   /JarVersion
            Scripts to retrieve and display the version of the .jar
            files currently installed.

   /LoginControl
            Software package blocks and executable files used to
            implement the concurrent login feature. For more information
            on this feature, see 2.2, "New features contained in this
            interim fix".

2.2 New features contained in this interim fix

The following feature has been introduced in this interim fix:

Table 1. Customer enhancement request references
+-------------------------------------------------------+-------------+
| Description                                           | Feature     |
+-------------------------------------------------------+-------------+
| Avoiding concurrent logins during critical            | Feature     |
| distributions                                         | 54613       |
+-------------------------------------------------------+-------------+
| Performing the logoff operation on Windows(R)         | Feature     |
| endpoints                                             | 55186       |
+-------------------------------------------------------+-------------+
| Displaying the .jar files version                     | Feature     |
|                                                       | 55204       |
+-------------------------------------------------------+-------------+
| Displaying the patch level for the Activity Plan      | Feature     |
| Editor and Activity Plan Monitor                      | 55205       |
+-------------------------------------------------------+-------------+
| Completing workflows separately                       | Feature     |
|                                                       | 55260       |
+-------------------------------------------------------+-------------+
| Enabling proxy support for the Patch Management       |             |
| solution                                              |             |
+-------------------------------------------------------+-------------+

For details on new features refer to the Readme file in the /docs directory.


2.3 Product compatibility

Compatibility is defined as whether different versions of a Tivoli
product can communicate with different versions of Tivoli Management
Framework.

IBM Tivoli Configuration Manager, Version 4.2.3 Interim Fix
4.2.3-TCM-0001 was tested using Tivoli Management Framework, Version
4.1.1 plus the following interim fixes:
*  4.1.1-TMF-0044
*  4.1.1-TMF-0039
*  4.1.1-LCF-0020

2.4 Fixes contained in this interim fix

Table 2 lists the fixes included in this interim fix:

Table 2. Fixes included in this interim fix
+----------------------------------+----------------------------------+
| Interim fix                      | Component/Service                |
+----------------------------------+----------------------------------+
|  4.2.3-SWDSRV-0001               | Software Distribution, Version   |
|                                  | 4.2.3                            |
+----------------------------------+----------------------------------+
| 4.2.3-SWDGW-0001                 | Software Distribution Gateway,   |
|                                  | Version 4.2.3                    |
+----------------------------------+----------------------------------+
| 4.2.3-SWDJPS-0001                | Software Distribution Software   |
|                                  | Package Editor, Version 4.2.3    |
+----------------------------------+----------------------------------+
| 4.2.3-APM-0001                   | Activity Planner, Version 4.2.3  |
+----------------------------------+----------------------------------+
| 4.2.3-CCM-0001                   | Change Manager, Version 4.2.3    |
+----------------------------------+----------------------------------+
| 4.2.3-WEB-0001                   | Web Interface, Version 4.2.3     |
+----------------------------------+----------------------------------+
| 4.2.3-PRI-0001                   | Pristine Manager, Version 4.2.3  |
+----------------------------------+----------------------------------+
| 4.2.3-PMG-0001                   | Patch Management, Version 4.2.3  |
+----------------------------------+----------------------------------+
| 4.2.3-CLL-0001                   | Scalable Collection Service,     |
|                                  | Version 4.2.3                    |
+----------------------------------+----------------------------------+
| 4.2.3-INV-0001                   | Inventory, Version 4.2.3         |
+----------------------------------+----------------------------------+
| 4.2.3-INVGW-0001                 | Inventory Gateway, Version 4.2.3 |
+----------------------------------+----------------------------------+

2.4.1 APARs and internal defects fixed for Inventory

Table 3 lists the APARs and internal defects that were fixed for
Inventory:

Table 3. APARs and internal defects for Inventory
+---------------------------------------------------------------------+
|              Inventory, Version 4.2.3, 4.2.3-INV-0001               |
+-----------------------+----------------------+----------------------+
| IY69466               | IY70283              | IY70916              |
+-----------------------+----------------------+----------------------+
| IY70604               |  IY71015             | IY72989              |
+-----------------------+----------------------+----------------------+
| IY73177               | IY73657              | 179423               |
+-----------------------+----------------------+----------------------+
| 179893                | 180462               |                      |
+---------------------------------------------------------------------+
|         Inventory Gateway, Version 4.2.3, 4.2.3-INVGW-0001          |
+-----------------------+----------------------+----------------------+
| IY63636               | IY70006              | IY70234              |
+-----------------------+----------------------+----------------------+
| IY70308               | IY70912              | IY70951              |
+-----------------------+----------------------+----------------------+
| IY71000               | IY71001              | IY71336              |
+-----------------------+----------------------+----------------------+
| IY72224               | IY72269              | IY72860              |
+-----------------------+----------------------+----------------------+
| IY72944               | IY73290              | IY73560              |
+-----------------------+----------------------+----------------------+


2.4.2 APARs and internal defect fixed for Scalable Collection Service

Table 4 lists the APARs and internal defects that were fixed for
Scalable Collection Service:

Table 4. APARs and internal defects for Scalable Collection Service
+---------------------------------------------------------------------+
|     Scalable Collection Service, Version 4.2.3, 4.2.3-CLL-0001      |
+-----------------------+----------------------+----------------------+
| IY66400               | IY69816              | IY70039              |
+-----------------------+----------------------+----------------------+


2.4.3 APARs and internal defects fixed for Software Distribution

Table 5 lists the APARs and internal defects that were fixed for
Software Distribution:

Table 5. APARs and internal defects for Software Distribution
+---------------------------------------------------------------------+
|       Software Distribution, Version 4.2.3, 4.2.3-SWDSRV-0001       |
+-----------------------+----------------------+----------------------+
| IY70587               | IY70596              |                      |
+-----------------------+----------------------+----------------------+
| IY71192               | IY71401              | IY71403              |
+-----------------------+----------------------+----------------------+
| IY71443               | IY71461              | IY71795              |
+-----------------------+----------------------+----------------------+
| IY72216               | IY72454              | 54846                |
+-----------------------+----------------------+----------------------+
| 55063                 | 55194                | 55275                |
+-----------------------+----------------------+----------------------+
|                       |                      |                      |
+---------------------------------------------------------------------+
|   Software Distribution Gateway, Version 4.2.3, 4.2.3-SWDGW-0001    |
+-----------------------+----------------------+----------------------+
| IY68380               |                      |                      |
+-----------------------+----------------------+----------------------+
| IY69280               | IY70198              | IY70495              |
+-----------------------+----------------------+----------------------+
| IY71010               | IY71192              | IY71983              |
+-----------------------+----------------------+----------------------+
| IY71991               | IY72454              | IY72698              |
+-----------------------+----------------------+----------------------+
| IY72786               | 55063                | 55194                |
+-----------------------+----------------------+----------------------+
| 55275                 |                      |                      |
+-----------------------+----------------------+----------------------+
|                       |                      |                      |
+---------------------------------------------------------------------+
|     Software Package Editor, Version 4.2.3, 4.2.3-SWDJPS--0001      |
+-----------------------+----------------------+----------------------+
| IY67885               | IY72632              |                      |
+-----------------------+----------------------+----------------------+
|                       |                      |                      |
+---------------------------------------------------------------------+
|        Software Package Editor for Endpoints, Version 4.2.3,        |
|                          4.2.3-SWDEP-0001                           |
+-----------------------+----------------------+----------------------+
| IY68380               | IY69280              | IY70198              |
+-----------------------+----------------------+----------------------+
| IY70495               | IY71010              | IY71991              |
+-----------------------+----------------------+----------------------+
| IY72698               | IY72490              | IY72786              |
+-----------------------+----------------------+----------------------+


2.4.4 APARs and internal defects fixed for Activity Planner

Table 6 lists the APARs and internal defects that were fixed for
Activity Planner:

Table 6. APARs and internal defects for Activity Planner
+---------------------------------------------------------------------+
|           Activity Planner, Version 4.2.3, 4.2.3-APM-0001           |
+-----------------------+----------------------+----------------------+
| IY69394               | IY70587              | IY71064              |
+-----------------------+----------------------+----------------------+
| IY71340               | IY71810              | IY71812              |
+-----------------------+----------------------+----------------------+
| IY71963               | IY72845              | IY72998              |
+-----------------------+----------------------+----------------------+
| IY73503               | IY73905              | IY74468              |
+-----------------------+----------------------+----------------------+
| 54559                 | IY74948              |                      |
+-----------------------+----------------------+----------------------+

2.4.5 APAR fixed for Change Manager

Table 7 lists the APAR that was fixed for Change Manager:

Table 7. APARs and internal defects for Change Manager
+---------------------------------------------------------------------+
|            Change Manager, Version 4.2.3, 4.2.3-CCM-0001            |
+-----------------------+----------------------+----------------------+
| IY64369               |                      |                      |
+-----------------------+----------------------+----------------------+

2.4.6 APARs fixed for the Web Interface

Table 8 lists the APARs that were fixed for Web Interface:

Table 8. APARs and internal defects for Web interface
+---------------------------------------------------------------------+
|            Web Interface, Version 4.2.3, 4.2.3-WEB-0001             |
+-----------------------+----------------------+----------------------+
| IY70838               | IY71394              |                      |
+-----------------------+----------------------+----------------------+


2.4.7 APAR fixed for Pristine Manager

Table 9 lists the APAR that was fixed for Pristine Manager:

Table 9. APARs and internal defects for Pristine Manager
+---------------------------------------------------------------------+
|           Pristine Manager, Version 4.2.3, 4.2.3-PRI-0001           |
+-----------------------+----------------------+----------------------+
| IY71465               |                      |                      |
+-----------------------+----------------------+----------------------+


2.4.8 Internal defects fixed for Patch Management

 Table 10 lists the internal defects that were fixed for Patch
Management:

Table 10. APARs and internal defects for Patch Management
+---------------------------------------------------------------------+
|           Patch Management, Version 4.2.3, 4.2.3-PMG-0001           |
+-----------------------+----------------------+----------------------+
| 53932                 | 53934                | 54956                |
+-----------------------+----------------------+----------------------+
| 55130                 | 55273                | 55329                |
+-----------------------+----------------------+----------------------+


3.0 Implementing the concurrent login feature

For details on this feature refer to the Readme file in the /docs directory.

4.0 Installation

This section includes the following topics:
*  4.1, "Traditional interim fix installation methods"
*  4.2, "Software package block (SPB) interim fix installation for GUI
   components"
*  4.4, "Upgrading plug-ins"

4.1 Traditional interim fix installation methods

4.1.1 Installing interim fixes using ISMP

The InstallShield MultiPlatform (ISMP) program provides a wizard-guided
process for installing interim fixes. It performs a check of the
environment and installs prerequisites required, if any, to perform the
upgrade process.

The ISPM tool generates an activity plan in XML file format that you can
use to upgrade your IBM Tivoli Configuration Manager environment.

It provides a depoting mechanism and allows you to plan the upgrade of
the entire Tivoli region by creating activity plans that can be
scheduled at a later date. This installation can be used on all
platforms supported as a Tivoli server, excluding Linux for S/390(R).

Before starting the upgrade process, back up the object database on the
Tivoli server.

Before running each generated activity plan, back up the object database
on the Tivoli server and each affected managed node.

For details about performing backup operations, see
Tivoli Management Framework: Maintenance and Troubleshooting Guide. To
upgrade your IBM Tivoli Configuration Manager environment using the
interim fixes included in this set, complete the following steps:
1. Copy locally the 423CM001.xml file provided located in the $PATCH/xml
   directory (from 4.2.3-TCM-0001_images.tar). Click Next.
2. Locate and run the Upgrade_$(INTERP) executable in the Upgrade
   directory on the IBM Tivoli Configuration Manager Version 4.2.3
   Installation CD-ROM, where $(INTERP) represents the operating system
   on which you are launching the upgrade process. Click Next.
3. Accept the Software License Agreement.
4. Either accept the default Directory Name, $DBDIR/Upgrade, or type the
   path to the $PATCH/xml directory on the local machine. Click Next.
5. The system determines which components are installed in your Tivoli
   region. Select the components you want to upgrade. Click Next.
6. The actions necessary to upgrade your environment are being
   generated. When the process completes, a panel displays the interim
   fixes you must install. Click Next.
7. Accept the default Directory Name, $DBDIR/Upgrade/Depot, or specify a
   different one. The installation images for the upgrade will be stored
   in this directory. Click Next.
8. You are prompted for the installation images. Navigate to the
   $PATCH/images directory that contains all the interim fix
   installation images (.IND files).
9. Select whether to create a single plan or an individual plan. Create
   a single plan: creates a single plan that contains all the activities
   to perform an upgrade. Create individual plan: creates a plan for
   each application, service or component, to upgrade. Click Next.
10. The generated plans can be submitted immediately or scheduled at a
   later date.

If you selected to create individual plans, only the first one is
submitted. The remaining activity plans are not queued. You must submit
the remaining plans one at a time in the same sequence in which they
were generated. If an activity plan fails, you can restart it using the
instructions for the Activity Planner component as documented in
IBM Tivoli Configuration Manager: User's Guide for Deployment Services.

Note: The Automatically recycle of object dispatcher option does not
      apply to the Tivoli Management Region server.

4.1.2 Installing interim fixes using the Tivoli desktop

When installing interim fixes using the Tivoli desktop, the images are
located in the $PATCH/images directory (from 4.2.3-TCM-0001_images.tar).
The Tivoli desktop can upgrade the same product on multiple machines
serially. The basic procedure for using the Tivoli desktop to upgrade a
product is as follows:
1. From the Tivoli desktop, select Install -> Install Patch from the
   Desktop menu.
2. Select the media and component to be upgraded.
3. Select the machines where the component is to be upgraded.
4. Click Install.

For detailed information about using the Tivoli desktop to install or
upgrade products, see Tivoli Enterprise(TM): Installation Guide.

4.1.3 Installing interim fixes using the CLI

When upgrading products using the wpatch command, specify the name of
the index file using the file shown below. When using the wpatch command
to upgrade a product, you specify the following information on the
command line:
1. The location of the image on the installation media.
2. The name of the index file associated with the product to be
   installed or upgraded.
3. The machines where the image is to be installed as described in the
   following example:
   wpatch -c $PATCH/images -i index file managed node

where

-c $PATCH/images
         Specifies the path where images are located

-i index file
         Specifies the managed node on which the interim fix is
         installed.

managed node
         Specifies the product installation index file to which the
         interim fix is installed.

If you do not specify a machine when running the wpatch command, the
image is installed on all managed nodes in the Tivoli region when there
is a prior version of this image. For detailed information about using
the wpatch command, see Tivoli Management Framework: Reference Manual.
The following table contains a list of IND files included in this
interim fix.

Table 11. IND files included in this interim fix
+-----------------------+----------------------+----------------------+
| IND file              | Component name       | Tag                  |
+-----------------------+----------------------+----------------------+
| 423SWD01              | Software             | 4.2.3-SWDSRV-0001    |
|                       | Distribution,        |                      |
|                       | Version 4.2.3        |                      |
+-----------------------+----------------------+----------------------+
| 423SGW01              | Software             | 4.2.3-SWDGW-0001     |
|                       | Distribution         |                      |
|                       | Gateway, Version     |                      |
|                       | 4.2.3                |                      |
+-----------------------+----------------------+----------------------+
| 423JPS01              | Software             | 4.2.3-SWDJPS-0001    |
|                       | Distribution         |                      |
|                       | Software Package     |                      |
|                       | Editor, Version      |                      |
|                       | 4.2.3                |                      |
+-----------------------+----------------------+----------------------+
| 423APM01              | Activity Planner,    | 4.2.3-APM-0001       |
|                       | Version 4.2.3        |                      |
+-----------------------+----------------------+----------------------+
| 423CCM01              | Change Manager,      | 4.2.3-CCM-0001       |
|                       | Version 4.2.3        |                      |
+-----------------------+----------------------+----------------------+
| 423WEB01              | Web Interface,       | 4.2.3-WEB-0001       |
|                       | Version 4.2.3        |                      |
+-----------------------+----------------------+----------------------+
| 423PRI01              | Pristine Manager,    | 4.2.3-PRI-0001       |
|                       | Version 4.2.3        |                      |
+-----------------------+----------------------+----------------------+
| 423PMG01              | Patch Management,    | 4.2.3-PMG-0001       |
|                       | Version 4.2.3        |                      |
+-----------------------+----------------------+----------------------+
| 423CLL01              | Scalable Collection  | 4.2.3-CLL-0001       |
|                       | Service, Version     |                      |
|                       | 4.2.3                |                      |
+-----------------------+----------------------+----------------------+
| 423INV01              | Inventory, Version   | 4.2.3-INV-0001       |
|                       | 4.2.3                |                      |
+-----------------------+----------------------+----------------------+
| 423LCF01              | Inventory Gateway,   | 4.2.3-INVGW-0001     |
|                       | Version 4.2.3        |                      |
+-----------------------+----------------------+----------------------+

4.2 Software package block (SPB) interim fix installation for GUI 
    components

Software package blocks included in this interim fix:
*  Tivoli_APM_GUI_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_CCM_GUI_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_SWDEP_AIX_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_SWDEP_HP_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_SWDEP_LINUXPPC_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_SWDEP_LINUX_IX86_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_SWDEP_LINUX_S390_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_SWDEP_NTAS400_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_SWDEP_NT_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_SWDEP_SOLARIS_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_WebUI_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_Web_Gateway_DB_Fix.v4.2.3.FP00.P1.spb
*  Tivoli_Web_Gateway_SRV_Fix.v4.2.3.FP00.P1.spb

IBM Tivoli Configuration Manager, Version 4.2.3 GA package is a
prerequisite of the SPB interim fixes.

You can install the interim fix 4.2.3-SWDEP-0001 using any of the
following different installation mechanisms:
*  4.2.1, "SPB Patch Installer"
*  4.2.2, "Software Distribution server command"
*  4.2.3, "Software Distribution disconnected command"

The default variables defined in the SPB interim fixes are listed in the
following table:

Table 12. Default variables defined in SPB fix packs
+-----------------+--------------------------+------------------------+
| Variable        | Value                    | Description            |
+---------------------------------------------------------------------+
|                  Tivoli_APM_GUI_Fix.v4.2.3.FP00.P1                  |
+-----------------+--------------------------+------------------------+
| DSWIN_DIR       | $(program_files)\Tivoli\ | The directory where    |
|                 | Desktop                  | the Tivoli Desktop is  |
|                 |                          | installed.             |
+-----------------+--------------------------+------------------------+
| TME_JAVATOOLS   | $(program_files)\Tivoli\ | The directory where    |
|                 | JavaTools                | the JRE 1.3 is         |
|                 |                          | installed.             |
+---------------------------------------------------------------------+
|                  Tivoli_CCM_GUI_Fix.v4.2.3.FP00.P1                  |
+-----------------+--------------------------+------------------------+
| DSWIN_DIR       | $(program_files)\Tivoli\ | The directory where    |
|                 | Desktop                  | the Tivoli Desktop is  |
|                 |                          | installed.             |
+-----------------+--------------------------+------------------------+
| TME_JAVATOOLS   | $(program_files)\Tivoli\ | The directory where    |
|                 | JavaTools                | the JRE 1.3 is         |
|                 |                          | installed.             |
+---------------------------------------------------------------------+
|                 Tivoli_SWDEP_AIX_Fix.v4.2.3.FP00.P1                 |
+-----------------+--------------------------+------------------------+
| target_dir      | $(product_dir)/speditor  | The directory where    |
|                 |                          | the Software Package   |
|                 |                          | Editor is installed.   |
+-----------------+--------------------------+------------------------+
| TME_JAVATOOLS   | /opt/Tivoli/JavaTools    | The directory where    |
|                 |                          | JRE 1.3 is installed.  |
+---------------------------------------------------------------------+
|                 Tivoli_SWDEP_HP_Fix.v4.2.3.FP00.P1                  |
+-----------------+--------------------------+------------------------+
| target_dir      | $(product_dir)/speditor  | The directory where    |
|                 |                          | the Software Package   |
|                 |                          | Editor is installed.   |
+-----------------+--------------------------+------------------------+
| TME_JAVATOOLS   | /opt/Tivoli/JavaTools    | The directory where    |
|                 |                          | JRE 1.3 is installed.  |
+---------------------------------------------------------------------+
|             Tivoli_SWDEP_LINUX_IX86_Fix.v4.2.3.FP00.P1              |
+-----------------+--------------------------+------------------------+
| target_dir      | $(product_dir)/speditor  | The directory where    |
|                 |                          | the Software Package   |
|                 |                          | Editor is installed.   |
+-----------------+--------------------------+------------------------+
| TME_JAVATOOLS   | /opt/Tivoli/JavaTools    | The directory where    |
|                 |                          | JRE 1.3 is installed.  |
+---------------------------------------------------------------------+
|             Tivoli_SWDEP_LINUX_S390_Fix.v4.2.2.FP00.P1              |
+-----------------+--------------------------+------------------------+
| target_dir      | $(product_dir)/speditor  | The directory where    |
|                 |                          | the Software Package   |
|                 |                          | Editor is installed.   |
+---------------------------------------------------------------------+
|              Tivoli_SWDEP_LINUXPPC_Fix.v4.2.3.FP00.P1               |
+-----------------+--------------------------+------------------------+
| target_dir      | $(product_dir)/speditor  | The directory where    |
|                 |                          | the Software Package   |
|                 |                          | Editor is installed.   |
+-----------------+--------------------------+------------------------+
| TME_JAVATOOLS   | /opt/Tivoli/JavaTools    | The directory where    |
|                 |                          | JRE 1.3 is installed.  |
+---------------------------------------------------------------------+
|                 Tivoli_SWDEP_NT_Fix.v4.2.3.FP00.P1                  |
+-----------------+--------------------------+------------------------+
| target_dir      | $(product_dir)\speditor  | The directory where    |
|                 |                          | the Software Package   |
|                 |                          | Editor is installed.   |
+-----------------+--------------------------+------------------------+
| TME_JAVATOOLS   | $(program_files)\Tivoli\ | The directory where    |
|                 | JavaTools                | JRE 1.3 is installed.  |
+---------------------------------------------------------------------+
|               Tivoli_SWDEP_NTAS400_Fix.v4.2.3.FP00.P1               |
+-----------------+--------------------------+------------------------+
| target_dir      | $(product_dir)\speditora | The directory where    |
|                 | s400                     | the Software Package   |
|                 |                          | Editor for AS/400(R)   |
|                 |                          | is installed.          |
+-----------------+--------------------------+------------------------+
| TME_JAVATOOLS   | $(program_files)\Tivoli\ | The directory where    |
|                 | JavaTools                | the JRE 1.3 is         |
|                 |                          | installed.             |
+---------------------------------------------------------------------+
|               Tivoli_SWDEP_SOLARIS_Fix.v4.2.3.FP00.P1               |
+-----------------+--------------------------+------------------------+
| target_dir      | $(product_dir)\speditor  | The directory where    |
|                 |                          | the Software Package   |
|                 |                          | Editor is installed.   |
+---------------------------------------------------------------------+
|              Tivoli_Web_Gateway_DB_Fix.v4.2.3.FP00.P1               |
+-----------------+--------------------------+------------------------+
| DMS.Destination | "C:\Program              | The directory where    |
|                 | Files\TivTwg"            | the Tivoli Web Gateway |
|                 |                          | is installed.          |
+---------------------------------------------------------------------+
|              Tivoli_Web_Gateway_SRV_Fix.v4.2.3.FP00.P1              |
+-----------------+--------------------------+------------------------+
| CLUSTER_ENV     | false                    | Specifies whether the  |
|                 |                          | cluster Tivoli Web     |
|                 |                          | Gateway Server is to   |
|                 |                          | be upgraded.           |
+-----------------+--------------------------+------------------------+
| LCF_LIBDIR.UNIX | $(LCFROOT)/lib/$(INTERP) |                        |
+-----------------+--------------------------+------------------------+
| INTERP          | aix4-r1                  | Specifies the INTERP   |
|                 |                          | of the Tivoli Web      |
|                 |                          | Gateway Server.        |
+-----------------+--------------------------+------------------------+
| LCF_LIBDIR      | $(LCF_LIBDIR.$(os_family | The LCF_LIBDIR of the  |
|                 | ))                       | endpoint               |
+-----------------+--------------------------+------------------------+
| AppServer       | /opt/WebSphere/AppServer | Specifies where the    |
|                 |                          | WebSphere(R)           |
|                 |                          | Application Server     |
|                 |                          | home is located.       |
+-----------------+--------------------------+------------------------+
| LCF_LIBDIR.PC   | $(LCF_BINDIR)            |                        |
+-----------------+--------------------------+------------------------+
| LCF_DATDIR      | /opt/Tivoli/lcf/dat/1    | Specifies the LCFDAT   |
|                 |                          | directory for the      |
|                 |                          | endpoint.              |
+-----------------+--------------------------+------------------------+
| LCFROOT         | /opt/Tivoli/lcf          | Specifies the LCFROOT  |
|                 |                          | directory for the      |
|                 |                          | endpoint.              |
+-----------------+--------------------------+------------------------+
| DMS.Destination | /usr/TivTWG              | Specifies where the    |
|                 |                          | Tivoli Web Gateway is  |
|                 |                          | installed.             |
+-----------------+--------------------------+------------------------+
| LCF_BINDIR      | $(LCFROOT)/bin/$(INTERP) | Specifies the          |
|                 | /mrt                     | LCFBINDIR directory    |
|                 |                          | for the endpoint.      |
+-----------------+--------------------------+------------------------+
| Hostname        | hostname.domain          | Specifies the Tivoli   |
|                 |                          | Web Gateway hostname.  |
+---------------------------------------------------------------------+
|                   Tivoli_WebUI_Fix.v4.2.3.FP00.P1                   |
+-----------------+--------------------------+------------------------+
| AppServer       | /opt/WebSphere/AppServer | Specifies the          |
|                 |                          | WebSphere Application  |
|                 |                          | Server home directory. |
+-----------------+--------------------------+------------------------+
| WebSrvDoc       | /usr/IBMHttpServer/htdoc | Specifies the          |
|                 | s/ en_US                 | directory for the Web  |
|                 |                          | Server documentation.  |
+-----------------+--------------------------+------------------------+
| LCF_LIBDIR      | /opt/Tivoli/lcf/lib/aix4 | Specifies the LCFLIB   |
|                 | -r1                      | directory for the      |
|                 |                          | endpoint.              |
+-----------------+--------------------------+------------------------+

4.2.1 SPB Patch Installer

This installation method uses ISMP technology and enables you to install
interim fixes on an endpoint or stand-alone machine to upgrade IBM
Tivoli Configuration Manager, Version 4.2.3 GUI components. The SPB
Patch Installer is supported on Microsoft Windows, IBM AIX, Solaris
Operating Environment, Linux (forIntel), and HP-UX.

The following is a summary of the upgrade process using the SPB Patch
Installer. Refer to the SPB Patch Installer Guide located in the
spb_installer directory from 4.2.3-TCM-0001_spb_installer.tar for
complete instructions on using this tool. To install the SPB interim
fixes using the SPB Patch Installer, perform the following steps:
1. Locate and run the setup program located in the spb_installer
   directory. 

   On Windows
            run the setup.exe executable file

   On all other platforms
            run the setup_platform.bin
2. Read the Welcome panel and click Next.
3. Specify the XML descriptor file for this interim fix located in the
   $PATCH/package directory. Click Next.
4. Select the Apply option and click Next.
5. Specify the components you want to install and click Next.
6. Clear the selection of the components for which you do not want to
   install in undoable mode. Click Next.
7. You may be prompted to specify the value of some variables defined in
   the SPB. Ensure that they are consistent with the existing
   installation on the machine to be upgraded.
8. A Summary panel is displayed. Click Next.
9. The upgrade process starts.

4.2.2 Software Distribution server command

To use this type of installation, your Tivoli environment must contain
an installation of the Software Distribution Server component, the
Software Distribution Gateway component, and a Tivoli endpoint.

The following steps must be performed to apply the SPB interim fix on
the targets: Create a new Profile in a Profile Manager, using the naming
convention described below:

$(package).spb --> $(package)

1. Import the SPB interim fix provided into the new Profile.
2. Select the endpoints to which you want to distribute the interim fix.
3. Submit the install using either the command line or the Tivoli
   desktop.

If you need to overwrite the values of the default variables, use the -D
option (winstsp -D variable=value GUI_component.spb) from the command
line, or the Default Variables panel from the Tivoli desktop.

4.2.3 Software Distribution disconnected command

To use this type of installation, you must have the Software
Distribution Software Package Editor component installed on the
endpoint. If you need to overwrite the values of the default variables,
use the -D option (wdinstsp -D variable=value GUI_component.spb) from
the command line.

4.3 Upgrading the Patch Management Automation Server driver

If you installed the Patch Management solution, Version 4.2.3, you need
to uninstall the previous Patch Management Automation Server driver and
install the new driver provided in this interim fix. To install the new
driver, perform the following steps:
1. Stop the Tivoli Configuration Manager Automation Server:
   a. Log on as user tioadmin.
   b. Open a Cygwin bash window and switch to the $TIO_HOME/tools
      directory.
   c. To stop the application, run the command: ./tio_stop.cmd
   d. At the User name prompt, type wasadmin and press Enter.
   e. At the Password prompt, if you have not changed the password for
      WebSphere Application Server, type the default password wasadmin
      and press Enter.
   f. Optionally, check the log file $TIO_HOME/logs/tio_stop.log for
      errors.

2. Uninstall the previous Patch Management Automation Server driver:
   a. In the $TIO_HOME/tools directory, run the  ./tc-driver-manager.cmd
      uninstallDriver tcm-ms-patches command

3. Copy the new version of the Patch Management Automation Server
   driver:
   a. Switch to the $BINDIR/TME/PATCH_MGMT/TPM_TCM_DRIVER directory.
   b. Copy the new tcm-ms-patches.tcdriver file to the $TIO_HOME/drivers
      directory.
   c. Remove the $TIO_HOME/drivers/lib/tcm-ms-patches.jar file.

4. Install the new version of the Patch Management component:
   a. Switch to the $TIO_HOME/tools directory.
   b. Run the ./tc-driver-manager.cmd installDriver tcm-ms-patches
      command. The following files are created in the $TIO_HOME/xml
      directory:
      *  xml/xml_update.sh
      *  xml/tpm_update.req

5. Modify the tpm_update.req file using Cygwin by providing the
   appropriate values for the following keywords:
   TPM_HOST_NAME=
   TPM_HOME=
   
   SUS_SERVER_NAME=
   SUS_IP_ADDRESS=
   SUS_SERVER_USER=
   SUS_SERVER_PASSWORD=
   
   PROXY_HOST=
   PROXY_PORT=
   PROXY_USER=
   PROXY_PASSWD=

   For the TPM_HOST_NAME keyword, you must specify the hostname of the
   workstation where the Patch Management component is installed.
6. Create the tcm-dcm_2112.xml file:
   a. In the $TIO_HOME/xml directory, run the  ./xml_update.sh command.
      The tcm-dcm_2112.xml file is created.

7. Reinitialize the Patch Management environment:
   a. Switch to the $TIO_HOME/tools directory.
   b. Run the  ./reinit.cmd $TIO_HOME/xml/tcm-dcm_2112.xml command.
   c. Optionally, check the log file $TIO_HOME/logs/reinit.log for any
      errors if unable to start the application.

8. Start the Tivoli Configuration Manager Automation Server:
   a. Switch to the $TIO_HOME/tools directory.
   b. To start the application, run the ./tio_start.cmd command.
   c. At the User name prompt, type wasadmin and press Enter.
   d. At the Password prompt, if you have not changed the password for
      WebSphere Application Server, type the default password wasadmin
      and press Enter.
   e. The window will display a message that Tivoli Configuration
      Manager Automation Server is ready to run.

      +---- Important -------------------------------------------------+

      Do not close the window that informs you that the application is
      running. If you close the window, the Tivoli Configuration Manager
      Automation Server does not start.

      +----------------------------------------------------------------+
   f. Optionally, check the log file $TIO_HOME/logs/tpm_start.log for
      any errors if unable to start the application.


4.4 Upgrading plug-ins

To upgrade plug-ins, you need to run the upgrade scripts.

Activity Planner

If you have installed 4.2.3-APM, 4.2.3-SWDSRV, and 4.2.3-INV run the
following scripts located in the $BINDIR/TME/APM/SCRIPTS directory. You
need the APM_Admin Tivoli region authorization role to run them in the
following way: 
*  sh reg_swd_plugin.sh -r
*  sh reg_inv_plugin_patch.sh
*  sh reg_tl_plugin.sh -r

 The first script enables the Activity Planner for Software
Distribution, the second script enables the Activity Planner for
Inventory, while the third script enables the Task Library.

If you are using 4.2.2-APM instead and want to upgrade to 4.2.3-APM, run
the following Activity Planner scripts located in the
$BINDIR/TME/APM/SCRIPTS directory. You need the APM_Admin Tivoli region
authorization role to run these scripts. 
1. Run the upgr_swd_plugin.sh script to upgrade the Software
   Distribution plug-in.
2. Run the upgr_tl_plugin.sh script to upgrade the Task Library plug-in.

Change Manager

If you have installed both 4.2.3-CCM and 4.2.3-SWDSRV, run the following
command to upgrade the CCM plug-in: 

wccmplugin -s SoftwareDistribution -f $BINDIR/TME/CCM/GUI/swd_plugin.xml

 You need the CCM_Admin Tivoli region authorization role to run it.

If the Activity Planner is up and running before launching this command,
stop the Activity Planner using the wstopapm command.

If you are using 4.2.2-CCM instead and want to upgrade to 4.2.3-CCM, you
need to run the following Change Manager script located in the
$BINDIR/TME/CCM/SCRIPTS directory: 

upgr_swd_plugin.sh

You need the CCM_Admin Tivoli region authorization role to run this
script.

5.0 Documentation notes

This chapter contains new and updated information for IBM Tivoli
Configuration Manager, Version 4.2.3.
Refer to the full Readme file in the /doc directory.

