Installation and upgrade for new HCL Digital Experience customers
HCL Digital Experience 9.5 can run on top of IBM WebSphere Application Server Version ND 9.0.5 using the following installation path. This guide is meant to provide a step-by-step information for the setup and installation of a standalone HCL Portal 9.5.
Preparing the environment
Before you install HCL Digital Experience, review the hardware and software requirements to 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.
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
Installing HCL Digital Experience 8.5 with IBM WebSphere Application Server ND Version 9.0.5 and JDK Version 8 using the IBM Installation Manager
This guide was written using Windows as the base operating system, however the steps/concepts listed in this guide are independent of the operating system. The only significant difference is that for Windows, you must use the batch file commands instead of the UNIX shell commands listed in this guide.
./ConfigEngine.sh config-ch-integ
ConfigEngine.bat config-ch-integ
Also, it is
recommended to use the Command Prompt (cmd.exe
) on Windows instead
of PowerShell.
- Documentation resource: Installing the HCL Digital Experience software
- <AppServer_root> - The root path of the AppServer directory. For example C:\IBM\WebSphere\AppServer
- <PortalServer_root> - The root path of the PortalServer directory. For example C:\IBM\WebSphere\PortalServer
<wp_profile_root>
- The root path of the wp_profile directory. For example C:\IBM\WebSphere\wp_profile
<IM_DATA_DIR>/logs
<IM_DATA_DIR>/installed.xml
<IM_DATA_DIR>/installed.xsl
<IM_DATA_DIR>/installRegistry.xml
<wp_profile root>/logs
<wp_profile root>/ConfigEngine/log/ConfigTrace.log
<AppServer root>/logs
- In UNIX:
/<user_home>/var/ibm/InstallationManager
- In Windows:
C:\ProgramData\IBM\Installation Manager
In any case of problems during the installation, please collect the above data and contact HCL Software Support.
Installing IBM Installation Manager
The IBM Installation Manager (IIM) is a tool you can use to install and maintain your software packages. Wizards guide you through the steps that you must take to install, modify, update, roll back, or uninstall your IBM or HCL products.
To install IIM, navigate to C:\Users\Administrator\Downloads\portal95Binaries\SETUP\IIM folder.
Within that folder, there are multiple IIM binaries for their relevant operating systems.
Select Next. Agree to the licensing terms and select Next again.
Set install path for IIM:
Select Next. Review the install summary and select Install.
When the installation is complete, select the Restart Installation Manager button.
Install the Portal 8.5 Base
This is a temporary step while Portal environment is being built up to the final goal of Portal 9.5 on WAS 9.0.5. Portal 8.5 is NOT supported on WAS 9.0.5 as a final configuration.
- Open IBM Installation Manager (IIM) and under File > Preferences > Repositories and select the Add Repository button.
- In the next IIM Window, we need to navigate to the
repository.config file. Navigate to
portal95Binaries\SETUP\products\WASND905 and select
the file as shown in the next image:Continue adding the following repositories noted below: Reminder: For the iFix PI59896, point the repository to the zip file itself.Then, select OK.
- Within IIM, select Install icon, then highlight all
the items listed. Note: Due to the way WAS defines the SDK as a co-requirement, we get two entries for SDK. Both entries are the same package and only one needs to be selected.Select Next.
- Select iFix listed.Warning: This iFix is required for Portal 8.5 to be installed while on WAS 9.0 using JDK8.Select Next.
- Accept terms of licensing agreement. Then select Next.
- Set location of IMShared. Select Next.
- Set the path you wish the WAS and Portal package to be installed.Note: The WebSphere Application Server package installation path will need to be customized as it tries to put it under the Program Files folder by default.Select Next.
- Select the translations you wish to use. Select Next.
- Review the packages that are going to be installed. Select Next.
- Enter the user id and password for the ConfigWizard admin user. This user is used to access the configuration wizard for when you do your database transfer, or create your cluster, etc. Select Next.
- Enter the user id and password for the Portal Admin user. This is your Admin user for logging into Portal Administration page or the WAS admin console. Select Next.
- Final review the package information. Select Next.
- When the installation is finished, select the None option for "Which program do you want to start?” and click Finish. Verify that you can access your Portal in an internet browser by navigating to: http://myportal.hcl.com:10039/wps/portal.
While you have successfully installed HCL Portal v8.5 with WebSphere Application Server 9.0.5 using JDK 8.0.5, please note you are still in an UNSUPPORTED state.
Install the latest Fixpack update (CF17 or later) using IBM Installation Manager to upgrade HCL Digital Experience to CF17 or later
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.
- 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.
Next, 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>
- Unix/Linux:
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.
Install HCL Digital Experience 9.5 using IBM Installation Manager
- 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 8.5 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.