IBM WebSphere Application Server Enterprise Edition Component Broker

WebSphere Application Server Enterprise Edition
Component Broker 3.0.1 Service Pack 1
Readme

Contents

General Notes

The purpose of this Service Pack is to provide support for the Solaris and S/390 platforms on Component Broker 3.0.1. The Solaris and S/390 support involves updates to the VisualAge Component Development for WebSphere Application Server Enterprise Edition tools and some updates to the OLT and debug runtime. The additional functions for S/390 and Solaris are documented in the Component Broker 3.0 Application Development Tools Guide. For information on restrictions and limitations, see the Release Notes.

Who should apply this Service Pack

This Service Pack should be applied to all Component Broker 3.0.1 installations with:.

  1. Component Broker development environment installed
  2. Component Broker runtime environment with OLT and Debugger components installed

Service Pack 1 Installation Instructions

  1. Windows NT Instructions
    1. How to prepare to install Component Broker 3.0.1 Service Pack 1 on Windows NT.
      Stop OLT
      1. If OLT Viewer is running, close it.
      2. If OLT Client Controller is running, close it.
      Stop all Debugger sessions and debugger engines.
      1. If the debugger user interface is running, close it.
      2. If the debugger user interface is started in daemon mode and no debug engine has since connected to this daemon, kill the debug.exe and/or jdebug_sui.exe using the Task Manager.
      3. If a debug engine is started without the debugger user interface running, kill the following debug engine daemon using the Task Manager:
        1. irmtdbgc.exe and derdfsrv.exe for the debug engine for compiles languages
        2. irmtdbgj.exe and java_g for the debug engine for interpreted languages
      Stop CBConnector service to quiesce all servers:
      Note: Only do these three steps if you have Component Broker runtime installed on this system.
      1. Select Start->Settings->Control Panel->Services
      2. Select CBConnector, then click Stop.
      3. Click Close to close Services.
    2. How to download the Component Broker 3.0.1 Service Pack 1 for Windows NT:
      1. Create a directory in which to download the service pack.
      2. The Service Pack 1 is at our ftp site. Download the Component Broker 3.0.1 Service Pack 1 by clicking on the CBspNT.exe file and saving it in the directory created in step 1.
    3. How to install the Component Broker 3.0.1 Service Pack 1 on Windows NT:
      1. Run the self extracting file CBspNT to extract the service pack install image.
      2. Once extraction is complete, run setup.exe in the current directory.
      3. Click Next when the Welcome panel comes up.
      4. A question window is displayed asking if you would like to apply the fix pack; click Yes.
      5. In the event that a file to be replaced as part of the fix pack is still being used during the file transfer, a message box will pop up asking if the file should be overwritten. Click Yes.
      6. If OLT and Debugger is installed on the system and is a version earlier than 8.2, your existing OLT and Debugger install is upgraded to version 8.2. This may take a while.
      7. Click Finish to reboot the system.
      8. After the system is rebooted, remove the directory containing the Component Broker service pack install image.

        If you have the Component Broker runtime installed, then rebooting (step 7 above) should automatically start the CBConnector service. If it does not automatically start for some reason, follow these steps to manually restart CBConnector service:

        1. Select Start->Settings->Control Panel->Services

        2. Select CBConnector, then click Start.
        3. Click Close to close Services.
  2. AIX Instructions
    1. How to prepare to install Component Broker 3.0.1 Service Pack 1 on AIX
      Stop OLT
      1. If OLT Viewer is running, close it.
      2. If OLT Client Controller is running, close it.
      Stop all debugger sessions and debugger engine.
      1. If the debugger user interface is running, close it.
      2. If the debugger user interface is started in daemon mode and no debug engine has since connected to this daemon, kill the debug session idebug and jdebug_sui by using kill -9 <process id> command.
        To look up the process id for the debug session, run the ps | grep <debug session name> command.
        In addition, also ensure jdebug_smd is not running.
      3. If a debug engine is started without the debugger user interface running, kill the following debug engine daemon using the kill -9 <process id of the daemon> command.
        1. irmtdbgc and derdfsrv for the debug engine for compiled languages
        2. irmtdbgj and java_g for the debug engine for interpreted languages.
        To look up the process id for the debug engine daemon, run the ps | grep <daemon name> command.
      Stop System Management Application to quiesce all servers:
      Note: Only do these five steps if you have Component Broker runtime installed on this system.
      1. Logon as Component Broker user.
      2. From a shell prompt, enter smitty apps
      3. Move the cursor to Stop the System Management Application and press Enter.
      4. On the Stop the System Management Application now? screen, press Tab to change the Stop the System Management Application now? entry field to y and then press Enter.
      5. Press PF10 to exit smitty.
    2. How to download Component Broker 3.0.1 Service Pack 1 for AIX.
      1. Logon as root.
      2. Create a directory in which to download the PTF.
      3. The Service Pack 1 can be downloaded from our ftp site. Download the service pack 1 by clicking on the CBspAIX.tar.Z file and saving it in the directory created in step 2.
    3. How to apply the Component Broker 3.0.1 Service Pack 1 on AIX.
      Retrieve the service pack update image by running zcat CBspAIX.tar.Z | tar -xvf -
      1. From a shell prompt, enter: smitty update_all
      2. The Update Install Software to Latest Level (Update All) screen is displayed. On this screen:
        1. Type . in the INPUT device / directory for software field.
        2. Press the Enter key to continue.
      3. Press the Enter key on the next screen.
      4. On the ARE YOU SURE? screen, press the Enter key to confirm the update.
      5. When the update is done, press the F10 key to exit smitty.
      6. Remove the directory containing the Component Broker service pack 1 update image.
    4. After the Component Broker 3.0.1 Service Pack 1 is applied
      If you have Component Broker runtime installed, start the System Management Application to start the servers:
      1. Logon as Component Broker user.
      2. From a shell prompt, enter: smitty apps
      3. Select Start the System Management Application and press Enter.
      4. On the Start the System Management Application now? screen, press Tab to change the Start the System Management Application now? entry field to y and then press Enter.
      5. Press PF10 to exit smitty.

Install OLT and Debugger after applying Service Pack 1

If you would like to add OLT and Debugger capabilities or to install additional OLT and Debugger components for your existing Component Broker install on a Component Broker environment with Service Pack 1 already applied, follow the instructions below.

  1. OLT and Debugger Installation on Windows NT
    1. If the Service Pack 1 install image is available on the system, skip to step C. Otherwise, download the install image by following the steps in "How to download the Component Broker 3.0.1 Service Pack 1 for Windows NT" section.
    2. Run the self extracting file CBspNT to extract the service pack install image.
    3. Change directory to OLT
    4. Run setup -ParentProduct=CBroker=-HomeMenu=IBM Component Broker to bring up IBM Distributed Debugger install.
      1. Click Next on the Welcome screen.
      2. On the Setup Type screen, select Custom, then click Next.
      3. On the Select Components screen:
        1. For Components selection
          1. if you would like to add OLT and Debugger engine capability for Component Broker C++ client runtime, select the following components:
            Debugger Engine (Compiled Languages)
            OLT-Debugger C++ Runtime
            OLT Client Controller
          2. if you would like to add OLT and Debugger engine capability for Component Broker Java client runtime, select the following components:
            Debugger Engine (Interpreted Java)
            OLT-Debugger Java Runtime
            OLT Client Controller
          3. if you would like to add OLT and Debugger engine capability for Component Broker Server runtime, select the following components:
            Debugger Engine (Compiled Languages)
            Debugger Engine (Interpreted Java)
            OLT-Debugger C++ Runtime
            OLT Client Controller
          4. if you would like to add OLT and Debugger User Interface capabilities, select the following components:
            Debugger User Interface
            OLT Server
            OLT Viewer
            OLT Client Controller
            Documentation
          5. if you would like to add OLT development capabilities, select the following component:
            OLT SDK
        2. If IBM Distributed Debugger is not already installed on the system, on the Destination Folder, accept the default destination or use the Browse button to specify a different location.
        3. Click Next to continue.
        4. On the Start Copying Files screen, click Next to start the installation.
        5. When the installation completes, on the Setup Complete screen:
          1. Keep the checkbox selected if you want to view the readme. Click Finish.
          2. Setup Complete screen is refreshed with reboot message. If you want this setup to reboot your system, select "Yes, I want to restart the computer now." Click Finish.
        6. Click OK to acknowledge the successful completion of the install.
      4. If you downloaded the Service Pack 1 install imageas described in step A, remove the directory containing the Component Broker service pack install image.
  2. OLT and Debugger Installation on AIX
    1. If the service pack 1 install image is available on the system, skip to step C. Otherwise, download the install image by following the steps in "How to download Component Broker 3.0.1 Service Pack 1 for AIX" section.
    2. Retrieve the service pack update image by running zcat CBspAIX.tar.Z | tar -xvf -
    3. While logging on as root, from a shell prompt, enter: smitty install_latest
      1. The Install and Update from Latest Available Software screen is displayed. On this screen:
        1. Type the directory which includes the Component Broker Service Pack 1 update image in the INPUT device / directory for software field.
        2. Press the Enter key to continue. This screen is displayed with additional fields:
          1. In the SOFTWARE to install field, press F4 to display a list of the software packages. In the SOFTWARE to install list, scroll down the list of packages to select the following entries:
            1. If you would like to add OLT and Debugger engine capability for Component Broker C++ Client runtime, select the following filesets:
              idebug.engine.compiled
              idebug.rte.olt.Cxx
              idebug.rte.olt.client
            2. If you would like to add OLT and Debugger engine capability for Component Broker Java Client runtime, select the following filesets:
              idebug.engine.interpreted
              idebug.rte.olt.Java
              idebug.rte.olt.client
            3. If you would like to add OLT and Debugger engine capability for Component Broker Server runtime, select the following filesets:
              idebug.engine.compiled
              idebug.engine.interpreted
              idebug.rte.olt.Cxx
              idebug.rte.olt.client
            4. If you would like to add OLT and Debugger User Interface capability for, select the following filesets:
              idebug.client.gui
              idebug.client.olt
              idebug.help.en_US
              idebug.server
            5. If you would like to add OLT and Debugger User Interface capability for, select the following filesets:
              idebug.client.gui
              idebug.client.olt
              idebug.help.en_US
              idebug.server
            6. If you would like to add OLT development capabilities, select the following fileset:
              idebug.adt
        3. Press Enter. The Install and Update from LATEST Available Software screen is redisplayed, but the software packages selected are in the SOFTWARE to install field.
        4. Press Enter. The ARE YOU SURE? screen is displayed.
        5. On the ARE YOU SURE? screen, press the Enter key to confirm the install.
        6. When the install is done, press the F10 key to exit smitty.
    4. If you downloaded the Service Pack 1 install image as described in step A, remove the directory containing the Component Broker ServicePack 1 update image.