After the system is in a quiescent state and backed up, you can safely
start the upgrade procedure. The Launchpad provides a way to launch the
GUI installer that leads you through upgrading WebSphere Business Integration
Server Express Plus V4.3 to WebSphere Business Integration Server
Express Plus V4.3.1. The GUI does the following:
- Installs WebSphere Business Integration Server Express Plus
V4.3.1 product components and configures them as
services.
- Installs any new adapters you select and configures them as
services.
- Does not drop your existing database.
- Retains your existing repository and does not redeploy it.
- Note:
- If you have version 4.3 Adapter or Collaboration Capacity Packs for
WebSphere Business Integration Server Express Plus installed, you must upgrade
these to version 4.3.1 as well, after upgrading the
WebSphere Business Integration Server Express Plus product. See the
sections Upgrading the Adapter Capacity Pack for WebSphere Business Integration Server Express Plus V4.3 to V4.3.1 and Upgrading the Collaboration Capacity Pack for WebSphere Business Integration Server Express Plus V4.3 to V4.3.1 for more information.
To invoke the Launchpad to launch the GUI, do the following:
- Select the button labeled Install Product in the left column of
the Launchpad.
The Upgrade Product screen appears.
- On the Upgrade Product screen, select Next.
The Install Server screen appears.
- On the Install Server screen, do one of the following:
- If you have the version 4.3 InterChange Server Express component
installed, the checkbox beside the entry InterChange Server Express
is selected and disabled. Select Next.
- If you do not have the version 4.3 InterChange Server
Express component installed, the checkbox beside the entry InterChange
Server Express is selected and enabled. You can proceed in one of
two ways:
- Leave the entry selected to install the version 4.3.1
InterChange Server Express component during the upgrade of other installed
components.
- Unselect the checkbox to keep the version 4.3.1 InterChange
Server Express component from being installed.
Select Next.
The Install Tools screen appears.
- On the Install Tools screen, do one of the following:
- If you have the version 4.3 Toolset Express Administrative and
Development Tools installed, the checkboxes beside the entries
Administrative Tools and Development Tools are selected
and disabled. Select Next.
- If you have the version 4.3 Toolset Express Administrative Tools
alone installed, the checkbox beside the entry Administrative Tools
is selected and disabled and the checkbox beside the entry Development
Tools is selected and enabled. You can proceed in one of two
ways:
- Leave the entry beside Development Tools selected to install
the version 4.3.1 Development Tools during the upgrade of other
installed components.
- Unselect the checkbox to keep the version 4.3.1 Development
Tools from being installed.
Select Next.
- Note:
- You cannot install only the Development tools. They require that
Administrative tools also be installed.
- If you do not have the version 4.3 Toolset Express
Administrative and Development Tools installed, the checkboxes beside the
entries Administrative Tools and Development Tools are
selected and enabled. You can proceed in one of three ways:
- Leave both checkboxes selected to install the version 4.3.1
Administrative and Development Tools during the upgrade of other installed
components.
- Leave the checkbox beside the entry Administrative Tools
selected and unselect the checkbox beside the entry Development
Tools to install the version 4.3.1 Administrative tools
only.
- Note:
- You cannot install only the Development tools. They require that
Administrative tools also be installed.
- Unselect both checkboxes to keep the version 4.3.1
Administrative and Development Tools from being installed.
- Tip:
- Unselect the checkbox beside Development Tools first. This
action enables the checkbox beside Administrative Tools, so you can
then unselect it.
Select Next.
The Install Adapters screen appears.
- On the Install Adapters screen, if you have version 4.3 adapters
installed, the checkbox beside each installed adapter is selected and
disabled. In addition, if you have not already installed the Adapter
for JText, it is selected by default because it is required to run the System
Test sample. (The System Test sample is part of the Samples component,
which can be selected from the Install Samples screen, described in Step 6.) Do one of the following:
- If you do not want to install any other adapters than the ones you have
already installed, unselect the checkbox beside the Adapter for JText if
necessary and select Next.
- If you want to install only the Adapter for JText in addition to the other
adapters you have already installed, leave the checkbox beside the Adapter for
JText selected and select Next.
- If you want to install other adapters in addition to the Adapter for JText
and the ones you have already installed, leave the checkbox beside the Adapter
for JText selected, select the checkboxes beside the other adapters you want
to add, and then select Next.
The Install Samples screen appears.
- Important:
- You can install as many adapters as you want. However, a maximum of
five can be registered with the InterChange Server Express when you
are installing WebSphere Business Integration Server Express Plus.
- On the Install Samples screen, do one of the
following:
- If you have the version 4.3 Samples component installed, the
checkbox beside the entry Samples is selected and disabled.
Select Next.
- If you do not have the version 4.3 Samples component
installed, the checkbox beside the entry Samples is checked and
enabled. You can proceed in one of two ways:
- Leave the entry selected to install the version 4.3.1
Samples component during the upgrade of other installed components.
- Unselect the checkbox to keep the version 4.3.1 Samples
component from being installed.
Select Next.
The Software Prerequisites screen appears.
- Note:
- The Samples component requires installation of the InterChange Server
Express, the Toolset Express, and the JText Adapter. Therefore, when
you elect to install the Samples component, the InterChange Server Express,
the Toolset Express, and the JText Adapter are installed as well, regardless
of whether you elected to install them in previous screens.
- On the Software Prerequisites screen, the installer informs you of any
required prerequisites. Do one of the following:
- Select the button labeled Install Product
located at the bottom of the Software Prerequisites screen.
The Software License Agreement screen appears.
- Read and accept the terms of the Software License Agreement by selecting
the radio button beside the entry I accept the terms in the license
agreement, then select Next.
The Upgrade Check screen appears.
- On the Upgrade Check screen, select Next.
One of the following occurs:
- If the InterChange Server Express component is already installed and will
be upgraded or you are installing the InterChange Server Express component
during the upgrade, the installer checks that appropriate prerequisites exist
and are configured properly and that two or fewer processors exist on the
machine on which the InterChange Server Express component is to be upgraded or
installed.
- If the prerequisite conditions are not met, an error message is displayed
and you are forced to cancel the installation.
- If the prerequisite conditions are met, product installation
begins. In this case, continue with these instructions at Step 12.
- If the InterChange Server Express component is not already installed and
will not be installed during the upgrade, the Name Server Configuration screen
appears. In this case, continue with these instructions at Step 11.
- On the Name Server Configuration screen, type the IP
address of the computer on which you have installed or plan to install the
InterChange Server Express component, and then select Next to begin
the installation process. See the section Configuring the Name Server for more information about the Name Server.
- As the installation process begins, the installer
verifies that enough disk space exists for the installation:
- If enough space does not exist, the Next button is disabled
since installation cannot be completed with the provided disk space. In
this case, you must select Back and unselect some features or
sub-features or delete some unneeded space on the specified drive.
- If enough space does exist, installation and configuration begin. A
number of informational screens are presented. When installation and
configuration are complete, the Post-installation Summary screen appears,
which indicates if the process was successful or if problems were
encountered. Select Finish to exit the GUI.
If you have version 4.3 Adapter or Collaboration Capacity Packs for
WebSphere Business Integration Express Plus installed, you must upgrade them
to version 4.3.1 as well. See the sections Upgrading the Adapter Capacity Pack for WebSphere Business Integration Server Express Plus V4.3 to V4.3.1 and Upgrading the Collaboration Capacity Pack for WebSphere Business Integration Server Express Plus V4.3 to V4.3.1 for details.
This procedure upgrades one or more adapters installed from the version
4.3 Adapter Capacity Pack for WebSphere Business Integration Server
Express Plus to version 4.3.1. It also allows you to
install an additional adapter during the upgrade. It assumes the
following:
- WebSphere Business Integration Server Express Plus V4.3.1 is
already installed on your machine.
- You have administrative privileges on the machine on which you are
upgrading the adapter.
- WebSphere Business Integration Server Express V4.3.1 is not
installed on the same machine on which you are installing the adapter.
(Adapter Capacity Packs can be used only with an existing WebSphere Business
Integration Server Express Plus 4.3.1 installation.)
- If the adapters to be upgraded or installed do or will not exist on the
same machine as InterChange Server Express, an installation of WebSphere MQ
5.3.0.2 CSD06 exists on the same machine on which the
adapter will be upgraded or installed.
- In order for the adapter license to be registered successfully,
InterChange Server Express must be running and, if installed on a
remote machine, running and reachable.
The Launchpad provides a way to launch the GUI installer that leads you
through upgrading the adapters from an existing Adapter Capacity Pack
installation. The GUI upgrades installed adapters, installs a new
adapter if selected, and configures all adapters as services.
To invoke the Launchpad to launch the GUI, do the following:
- Select the button labeled Install Capacity Pack from the left
column of the Launchpad.
The Install Capacity Pack screen appears with two buttons.
- Select Install Adapter Capacity Pack to launch the GUI to
install the Adapter Capacity Pack.
The Welcome screen appears.
- At the Welcome screen, select Next.
The Software License Agreement screen appears.
- Read and accept the terms of the Software License Agreement by selecting
the radio button beside the entry I accept the terms in the license
agreement, then select Next.
The Upgrade Check screen appears.
- On the Upgrade Check screen, select Next.
The installer checks that the prerequisites listed at the beginning of this
section have been met. If any have not been met, it forces you to
cancel the installation by selecting the Cancel button. If
all prerequisites have been met, the Feature screen appears.
- On the Feature screen, only those adapters that are not
already installed appear. Do one of the following:
- If you do not want to install any other adapter than the ones you are
upgrading, select Next.
- If you want to install another adapter in addition to the ones you are
upgrading, select one adapter from the list of available adapters by selecting
the radio button beside its name, then select Next. For more
information about which adapter to select, see the section Deciding which adapter to install.
One of the following screens appears:
- If the InterChange Server Express is installed on the local machine, the
InterChange Server Express Password screen appears. In this case,
proceed to Step 9.
- If the InterChange Server Express exists on a remote machine, the Server
IP Address Configuration screen appears. In this case, proceed to Step 7.
- On the Server IP Address Configuration screen, type the IP
address of the computer on which you have installed the InterChange Server
Express component. If the InterChange Server Express is on an OS/400
machine, select the checkbox beside the entry InterChange Server Express
is on OS/400. Then select Next. One of the
following screens appears:
- If you selected the checkbox beside the entry InterChange Server
Express is on OS/400, the Server Name Configuration screen
appears. In this case, proceed to Step 8.
- If you did not select the checkbox beside the entry InterChange
Server Express is on OS/400, the InterChange Server Express Password
screen appears. In this case, proceed to Step 9.
- On the Server Name Configuration screen, do the
following:
- Type the name of the InterChange Server Express instance on the OS/400
machine. (The default is QWBIDFT. If you created a
different name for your instance, type it instead.)
- Type the ORB port number. (The default is 14500.
If you used a different port number, type it instead.)
Then select Next.
The InterChange Server Password screen appears.
- On the InterChange Server Express Password screen, type the
password of the user admin for the InterChange Server Express, and
then select Next.
The Pre-installation Summary screen appears.
- On the Pre-installation Summary screen, review your
selection and installation location and select Next.
The installer verifies that enough disk space exists for the
installation. Installation then proceeds, as follows:
- If enough space does not exist, the Next button is disabled
since installation cannot be completed with the provided disk space. In
this case, you must select Back and delete some unneeded space on
the specified drive.
- If enough space does exist, installation and configuration begin.
When installation and configuration are complete, the installer attempts to
connect to the server to register the license for this adapter. A
message dialog informs you if the adapter was registered successfully; an
error dialog alerts you if registration was unsuccessful or if you exceeded
the maximum number of adapters that can be registered with the InterChange
Server Express. Select OK to exit this dialog. For
more information on how the system updates the license file, see Updating the license file. The Post-installation Summary screen appears, which
indicates if the process was successful or if problems were
encountered.
- On the Post-installation Summary screen, select Finish to exit
the installation GUI.
If you have a version 4.3 Collaboration Capacity Pack for WebSphere
Business Integration Express Plus installed, you must upgrade it to version
4.3.1 as well. See the section Upgrading the Collaboration Capacity Pack for WebSphere Business Integration Server Express Plus V4.3 to V4.3.1 for details.
This procedure upgrades a version 4.3 Collaboration Capacity Pack
for WebSphere Business Integration Server Express Plus to version
4.3.1. It assumes the following:
- The Collaboration Capacity Pack for WebSphere Business Integration Server
Express Plus V4.3 is already installed on your machine and you are now
installing V4.3.1.
- You have administrative privileges on the machine on which you are
upgrading the Collaboration Capacity Pack.
- The Collaboration Capacity Pack will be installed on the same machine on
which the InterChange Server Express component is installed.
- The InterChange Server Express component is not running.
The Launchpad provides a way to launch the GUI installer that leads you
through upgrading an existing Collaboration Capacity Pack installation.
The Collaboration Capacity Pack GUI upgrades the selected collaboration group
and deploys the installed content to the InterChange Server Express.
To invoke the Launchpad to launch the GUI, do the following:
- Select the button labeled Install Capacity Pack from the left
column of the Launchpad. The Install Capacity Pack screen appears with
two buttons.
- Select the button labeled Install Collaboration Capacity Pack
to launch the GUI to install the Collaboration Capacity Pack. The
Launchpad first checks if the InterChange Server Express component of
WebSphere Business Integration Server Express Plus is installed on the local
machine. It then acts, as follows:
- If the InterChange Server Express component is not installed on the local
machine, a warning dialog alerts you that installation can fail. Select
Cancel to cancel the installation or Install to continue
the installation. If you elect to continue the installation, the
Welcome screen appears.
- If the InterChange Server Express component is installed on the local
machine, the Welcome screen appears.
- On the Welcome screen, select Next.
The Software License Agreement screen appears.
- Read and accept the terms of the Software License Agreement by selecting
the radio button beside the entry I accept the terms in the license
agreement, then select Next.
The installer checks that the prerequisites listed at the beginning of this
section have been met. If any have not been met, it forces you to
cancel the installation by selecting the Cancel button. If
all prerequisites have been met, the Upgrade Check screen appears.
- On the Upgrade Check screen, confirm that you want to upgrade
the installed Collaboration Capacity Pack by selecting Next.
The installer verifies that enough disk space exists for the
installation. Installation then proceeds, as follows:
- If enough space does not exist, the Next button is disabled
since installation cannot be completed with the provided disk space. In
this case, you must select Back and delete some unneeded space on
the specified drive.
- If enough space does exist, installation and configuration begin.
When installation and configuration are complete, the Post-installation
Summary screen appears, which indicates if the process was successful or if
problems were encountered.
- On the Post-installation Summary screen, select
Finish to exit the GUI.
