Installation and upgrade for customers running on Portal 8.5 on WAS 8.5/9.0 and Java SDK
7.0
This guide shows how to upgrade the HCL WebSphere Portal 8.5 environment to HCL WebSphere Portal 9.5 and either staying at IBM WebSphere Application Server ND 8.5.x or migrating the WAS layer to IBM WebSphere Application Server ND v9.0.5.
Prepare the environment
Before installing, review the hardware
and software requirementsto ensure that we have the supported versions of prerequisite and co-requisite software and the required
hardware.
Also review the detailed requirements article to ensure that the system meets or exceeds the minimum requirements provided by
HCL.
B. Preparing the operating system for installation
Note: There are
several different Portal 9.5 offerings. Our license determines
which offerings we will see listed as available to download.Example package names for the different Portal 9.5
offerings are:
HCL WebSphere Portal Express v9.5
Multiplatform
HCL WebSphere Portal Server v9.5 Multiplatform
HCL WebSphere Portal Enable v9.5
Multiplatform
HCL WebSphere Portal Extend v9.5 Multiplatform
In this example, we will use HCL WebSphere Portal
Enable v9.5 Multiplatform.
Click on the HCL WebSphere Portal Enable v9.5 Multiplatform
package.
On the package page, we will see a long list of parts/components. But
we only need to download the following four (4) files:
HCL-Portal-95_Enable_SETUP-01.zip
HCL-Portal-95_Enable_SETUP-02.zip
HCL-Portal-95_Enable_SETUP-03.zip
HCL-Portal-95_Enable_SETUP-04.zip
Note: The zip files above contain all the software required to install Portal 9.5 including Installation Manager, WebSphere Application Server, Portal CF213, etc.
Prepare the files for install
Once we have the parts downloaded, create a parent folder wherein the files are
to be extracted. We can name it as portal95binaries as
shown in the example below:
Extract the .zip files to the created parent folder. Once all four (4) files are
extracted, you should have a folder called SETUP under your parent folder as shown below:
Navigate to the SETUP folder, there should be a Product
folder that holds the files and repositories for WAS 9.0.x, JDK 8.0.x, Portal
8.5.0.0, CF213 for Portal 8.5, Portal 9.5, and iFix PI59896.
Use Installation Manager to upgrade HCL WebSphere Portal 8.5 to CF213 or a later
CF
Read the installation instructions and additional system consideration before
applying a cumulative fix to a stand-alone, cluster, remote search and farm portal
installation or to roll back the cumulative fix.
Note: There are several different
methods to install the cumulative fix as stated on Combined
Cumulative Fix Strategy page. The sample procedure below is using a
Graphical User Interface.
Portal now needs to be upgraded to CF213 to support the installation of HCL WebSphere Portal
9.5.
We will need to stop the Portal Server and ConfigWizard to allow us to proceed
with the upgrade.
Open a Command Prompt and navigate to <wp_profile_root>/bin.
Run:
stopServer.bat HCL WebSphere Portal and HCL Web Content Manager
Enter Portal credentials when prompted.
Navigate to <AppServer_root>/profiles/cw_profile/bin.
Run:
stopServer.bat server1
Enter ConfigWizard credentials when prompted.Before proceeding, HCL
highly recommends that you take a backup of the system. Please
review the following links for further details.
Open IBM Installation Manager (IIM) and under File >
Preferences > Repositories, add the following repository
as shown in the image below:
Reminder: Remove the previous
repository entries. Select OK.
Within IIM, select Update icon, then select the Portal package.
Select Next.
Select CF213 package.
Reminder: We need to stop Portal
Server/ConfigWizard to be able to proceed. Select
Next.
Review validation results. Select Next.
Accept terms of licensing agreement. Then select
Next.
Review Features that are going to be installed. Select
Next.
Select Update.
At this point ONLY the Portal binaries have been updated to CF213 . The IIM
only manages the binaries so we will need to run a Portal script to upgrade the profile.
Then, update the profile
Ensure the HCL WebSphere Portal and HCL Web Content Manager server is stopped on
the profile you intend to upgrade.
Execute the following command from within the path of the profile to configure:
Lastly, validate if the server has been updated to CF213 and all
is well. Log in and check the about HCL WebSphere Portal and see if it says
CF213.
Use Installation Manager to upgrade HCL WebSphere Portal 8.5 to HCL WebSphere Portal 9.5
Make sure the server is stopped before doing the following steps:
Add the HCL WebSphere Portal 9.5 repositories to IIM.
In this case, we are using
the Enable offering so need the following repo: Server and
Enable.For the other offerings, this is what we need for
each:
Enable Offering: needs Server and Enable repo
Express Offering: needs Express repo
Extend Offering: needs Extend and Server repo
Server Offering: needs Server repo
Reminder: Remove the previous
repositorySelect OK.
Within IIM, select Install option. Select both
packages.
Select Next.
Accept terms of licensing agreement. Then select
Next.
Use existing Portal 8.5 package.
Select Next.
Enter Admin user id and password for WebSphere Application Server and
Portal Server. Then select Next.
Review Summary. Select Install..
Note: During the install, a series of ConfigEngine tasks will be
run to upgrade Portal 9.0 to 9.5 so upgrading the profile after is
not required.
When the installation is finished, you should now be able to verify that we can access the Portal in an internet browser by navigating to:
http://myportal.hcl.com:10039/wps/portal.
Check
the About HCL WebSphere Portal portlet to make sure it says
9.5.
This completes the upgrade to HCL WebSphere Portal 9.5 standalone.
Optional: Migrate the IBM WebSphere Application Server to 9.0.5
WebSphere Application Server 9.0.5.15 is only supported on HCL WebSphere Portal
9.5. First upgrade to HCL WebSphere Portal 9.5 before migrating to IBM WebSphere Application Server 9.0.5.
