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 your HCL Portal 8.5 environment to HCL 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 Version 9.0.5.
Preparing the environment
Before you install HCL Digital Experience, review the hardware and software requirementsto ensure that you have the supported versions of prerequisite and co-requisite software and the required hardware.
Make sure to also review the detailed requirements article to ensure that your system meets or exceeds the minimum requirements provided by HCL.
B. Preparing your operating system for installation
Getting the software
Product software can be obtained from the HCL Software Licensing Portal.
- Sign into the HCL Software Licensing Portal.
- Identify the Portal 9.5 offering you wish to install.Note: There are several different Portal 9.5 offerings. Your license determines which offerings you will see listed as available to download.Example package names for the different Portal 9.5 offerings are:
- HCL Portal Express v9.5 Multiplatform
- HCL Portal Server v9.5 MP
- HCL Portal Enable v9.5 Multiplatform
- HCL Portal Extend v9.5MP
In this example, we will use HCL Portal Enable v9.5 Multiplatform.
- Click on the HCL Portal Enable v9.5 Multiplatform package.
- On the package page, you will see a long list of parts/components. But
you 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 CF17, etc.
Preparing the files for install
Use Installation Manager to upgrade HCL Portal 8.5 to CF17 or a later CF
Portal now needs to be upgraded to CF17 to support the installation of HCL Portal 9.5.
- Open a Command Prompt and navigate to <wp_profile_root>/bin.
- Run:
stopServer.bat HCL 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 your system. Please review the following links for further details.
- Documentation resource: Backup and restore
- Documentation resource: How to backup HCL Portal [Video]
- 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 CF17 package.Reminder: You will 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 CF17. 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 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:
- Unix/Linux:
<profile_root>/PortalServer/bin/applyCF.sh -DPortalAdminPwd=<password> -DWasPassword=<password>
- Windows:
<profile_root>\PortalServer\bin\applyCF.bat -DPortalAdminPwd=<password> -DWasPassword=<password>
Lastly, validate if the server has been updated to CF17 and all is well. Log in and check the about HCL Portal and see if it says CF17.
- Unix/Linux:
Use Installation Manager to upgrade HCL Portal 8.5 to HCL Portal 9.5
- Add the HCL 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 you 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
you can access your Portal in an internet browser by navigating to:
http://myportal.hcl.com:10039/wps/portal.
Check the About WebSphere Portal portlet to make sure it says 9.5.
This completes the upgrade to HCL Portal 9.5 standalone.
Optional: Migrate your IBM WebSphere Application Server to 9.0.5
WebSphere Application Server 9.0.5 is only supported on HCL Digital Experience 9.5. You must first upgrade to HCL Portal 9.5 before you migrate to IBM WebSphere Application Server 9.0.5.
Refer to Migrating an HCL Digital Experience cluster to IBM WAS 9.0.5 to proceed with the migration process.
Install the latest supported version of IBM WebSphere SDK Java Technology
Starting with HCL Digital Experience Combined fix pack 12, you can change your SDK Java Technology Edition to version 8.0.
- Documentation resource: For AIX: Upgrading the SDK
- Documentation resource: For Linux: Upgrading the SDK
- Documentation resource: For Windows: Upgrading the SDK