Starting the upgrade process
After the system is in a quiescent state and backed up,
you can safely start the upgrade procedure. Upgrading the system
involves the following tasks:
Upgrading
from WebSphere Business Integration Server Express V4.4 to Express
Plus V4.4
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 V4.4 to Express Plus
V4.4. The GUI does the following:
- Installs WebSphere Business Integration Server Express Plus
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.
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:
- On the Install Tools screen, do one of the following:
- The web-based tools include System Monitor, Failed Event Manager,
and Web Deployment. Refer to the System Implementation Guide for
more information about these tools.
A supported version of WebSphere Application Server or WebSphere Application
Server Express and the IBM HTTP Server are required to be on the OS/400
or i5/OS system for web-based tools to operate. If web-based tools
is selected, then later in the installation process the Launchpad
will inform you whether these prerequisites are already installed
and will prompt you to install them if they are not. (WebSphere
Application Server Express 6.0 can be installed from the Launchpad;
the IBM HTTP Server is supplied with your OS/400 or i5/OS system
and must be installed separately.)
- Leave the check box selected to install Web-based Tools.
- Unselect the check box if you do not want to install Web-based
Tools.
Select Next.
The Install Adapters screen appears.
- On the Install Adapters screen, if you have version 4.4 adapters
installed, the check box 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 7.)
Do one of the following:
- If you do not want to install any other adapters than the ones
you have already installed, unselect the check box 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 check
box 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 check
box beside the Adapter for JText selected, select the check boxes
beside the other adapters you want to add, and then select Next.
The Install Samples screen appears.
-
On the Install Samples screen, do one
of the following:
- If you have the version 4.4 Samples component installed, the
check box beside the entry Samples is selected
and disabled. Select Next.
- If you do not have the version 4.4 Samples
component installed, the check box 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.4 Samples
component during the upgrade of other installed components.
- Unselect the check box to keep the version 4.4 Samples component
from being installed.
Select Next.
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.
The Software Prerequisites screen appears.
- On the Software Prerequisites screen, the installer informs
you of any required prerequisites. Do one of the following:
- If the Software Prerequisites screen indicates that no additional
prerequisites are needed, proceed to Step 9.
- If the Software Prerequisites screen indicates that additional
prerequisites are needed, refer to Step 3 for instructions on how to install the prerequisites,
and the section Software prerequisites for additional
prerequisite information.
-
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.
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.
- 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 11.
-
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.
Installation Summary
The installation process has completed the following tasks,
depending on the features you chose in the Launchpad:
- Installed WebSphere Business Integration Server Express Plus
product components.
- Configured the Cwtools.cfg file used by the Toolset Express.
- Configured the InterchangeSystem.cfg file used by the InterChange Server Express for OS/400 and
i5/OS.
- Configured a queue manager for WebSphere MQ.
- InterChange Server Express is configured to automatically start
with the TCP/IP auto servers.
- Provided platform-specific configuration and registration.
- Deployed content to the InterChange Server Express.
At this point, you can view the files and directory structure
of your system, as detailed in Directory structure and files.
There is one log file containing information about the install
process for the OS/400 and i5/OS installation: the install.log file is located in the directory /QIBM/ProdData/WBIServer44/.
Installing WebSphere Business Integration Server Express
V4.4 to OS/400 or i5/OS with an existing installation of WebSphere Business
Integration Server Express V4.3.1
If you currently have WebSphere Business Integration Server
Express v4.3.1 installed on OS/400 or i5/OS, you can install WebSphere
Business Integration Server Express v4.4 alongside the previous
version. The two versions can coexist on OS/400 and i5/OS and can
run concurrently. The installation of WebSphere Business Integration Server
Express v4.4 will not modify the WebSphere Business Integration
Server Express v4.3.1 installation.
During the installation of WebSphere Business Integration Server
Express v4.4, the Launchpad will detect the WebSphere Business Integration
Server Express v4.3.1 installation. In this case, the InterChange
Server Express default ports for WebSphere Business Integration
Server Express V4.4 will change to 14501, 1417, and 4443.
For specific information on installing WebSphere Business Integration
Server Express v4.4, refer to Chapters 1 through 7 of this guide.
Installing WebSphere Business Integration Server Express
Plus V4.4 to OS/400 or i5/OS with an existing installation of WebSphere
Business Integration Server Express Plus V4.3.1
If you currently have WebSphere Business Integration Server
Express Plus v4.3.1 installed on OS/400 or i5/OS, you can install
WebSphere Business Integration Server Express Plus v4.4 along side
the previous version. The two versions can coexist on OS/400 and
i5/OS and can run concurrently. The installation of WebSphere Business Integration
Server Express Plus v4.4 will not modify WebSphere Business Integration Server
Express Plus v4.3.1 installation.
During the installation of WebSphere Business Integration Server
Express Plus v4.4, the Launchpad will detect the WebSphere Business
Integration Server Express Plus v4.3.1 installation. In this case,
the InterChange Server Express default ports for WebSphere Business
Integration Server Express Plus v4.4 will change to 14501, 1417, and
4443.
For specific information on installing WebSphere Business Integration
Server Express Plus v4.4, refer to Chapters 1 through 7 of this
guide.
Starting the new upgraded version
After the installation completes, you can start the WebSphere
Business Integration Server Express Plus system using your existing
version of the repository by doing the following:
- Verify that all required supporting software is running. Supporting
software includes WebSphere MQ (make sure that Queue manager and
the Listener are both up and running).
- Start InterChange Server Express. For instructions on how to
start InterChange Server Express, refer to Starting WebSphere Business Integration
Server Express or Express Plus.
You can check the InterchangeSystem.log file in the /QIBM/UserData/WBIServer44/QWBIDFT44/log directory for the default instance.
Note:
If InterChange Server Express fails to start up
after you upgrade the system, review this upgrade procedure to be
sure you followed all the instructions. If the cause of the failure
is still unknown, consult IBM technical support for assistance before
attempting adjustments or restoring from backup.
