Cumulative fix instructions: Remote search | HCL Digital Experience 8.5
Read the installation instructions to learn how to apply a cumulative fix to a portal remote search installation or to roll back the cumulative fix.
About Version 8.5 Cumulative Fixes
This cumulative fix can only be applied to an existing functional version of HCL Portal Version 8.5 remote search or document conversion services (DCS) server, with or without a previous cumulative fix applied.
Overview
- If you originally installed the remote service using manual steps, then you must use manual steps to upgrade it. Update the application on the remote search server by copying updated files from the primary portal server and redeploying them. Refer to the Updating remote search by using manual steps topic for details on how to set up the application.
What's New
For a list of the Fixes which have gone into each CF, visit Combined Cumulative Fix Strategy for more information.
Before you begin
Space Requirements
- All platforms: 250 MB in the download directory to download the cumulative fix, 1 MB in the installation directory, and 75 MB in the shared data space, which is the directory where Installation Manager temporarily stores downloaded files for use during the update.
Best Practices
Go to the HCL Software Support page to read the Portal Upgrade Best Practices.
Backing up the Installation Manager data
Backup the contents of the IBM Installation Manager data directory on the server you are upgrading in the event you lose connection during the upgrade, as this could corrupt the data directory.- Windows: C:\ProgramData\IBM\InstallationManager
- Linux/UNIX root users: /var/ibm/InstallationManager
- Linux/UNIX non-root users: /home/(user id)/var/ibm/InstallationManager
- IBM i: Installation location: /QIBM/ProdData/InstallationManager
- IBM i: Agent data location: /QIBM/UserData/InstallationManager
Known Issues
Review the Known issues for combined cumulative fix topic page to be aware of any known issues for the HCL Portal Version 8.5 CF releases.
Review supported hardware/software requirements
For Portal Version 8.5 CF08 or later, the minimum recommended WebSphere Application Server level is at least WAS 8.5.5.6 with the corresponding JDK level applied.
EJBDeploy tool for pre-EJB 3.0
modules
is installed.Check fixes installed on your system
All temporary or interim fixes on your system must be removed before installing this cumulative fix.
Also check whether the fixes installed on your system are included in the list of fixes provided in this cumulative fix. If you have temporary or interim fixes on your system that are not included in this cumulative fix then contact HCL Software Support for an updated version of those fixes or for more information.
Download the cumulative fix
- Download the latest zip file that corresponds to the installation on your system. Go to the HCL Software Support page and download the HCL Portal Remote Search CF file 8.5-WP-RemoteSearch-CFPInnnnn-CFnn.zip.
- Create a directory and extract the downloaded zip file into this directory.
Inside the zip file are a readme file, sample response files, and the actual
cumulative fix file itself. The cumulative fix file is named as follows,
where
nn
represents the CF number associated with this cumulative fix: WP8500CFnn_Remote.zip . - Create a sub-directory and extract theWP8500CFnn_Remote.zip file to this directory. The extraction results in a repository.config file that is used by IBM Installation Manager during the update.
Steps for installing the cumulative fix
- Use a Graphical User Interface (GUI)
- Use a live repository via the Graphical User Interface
- Use a command line
- Use silent mode installation
- Use silent mode installation
Choose one method that is available for your system and follow the detailed steps for that option.
Use a Graphical User Interface (available on Windows, Linux, and Unix operating systems)
- If you are running an external web server such as IBM HTTP server, stop the web server.
- Stop any active application servers by using the
stopServer
command. To see which application servers are active, use theserverStatus
command from the (prs_profile)/bin directory:- Unix/Linux:
./serverStatus.sh -all
- Windows:
serverStatus.bat -all
- Unix/Linux:
- Launch the IBM Installation Manager that was used to install HCL Portal Remote Search Version 8.5.
- Using Installation Manager, click File > Preferences.
- Go to the Repositories panel and select Add Repository.
- Navigate to the repository.config file mentioned earlier and select it.
- Select Update and follow the prompts to update HCL Portal Remote Search.
- If you are running an external web server, restart it now.
Use a live repository via the Graphical User Interface (available on Windows, Linux, and Unix operating systems)
- If you are running an external web server such as IBM HTTP server, stop the web server.
- Stop any active application servers by using the
stopServer
command. To see which application servers are active, use theserverStatus
command from the (prs_profile)/bin directory:- Unix/Linux:
./serverStatus.sh -all
- Windows:
serverStatus.bat -all
- Unix/Linux:
- Launch the IBM Installation Manager that was used to install HCL Portal Remote Search Version 8.5.
- Using Installation Manager, click File > Preferences.
- Go to the Repositories panel and click Search service repositories during installation and updates. Click Apply.
- Select Update and follow the prompts to update HCL Portal Remote Search.
- If you are running an external web server, restart it now.
Use a command line (available on Windows, Linux, and Unix operating systems)
- If you are running an external web server such as IBM HTTP server, stop the web server.
- Stop any active application servers by using the
stopServer
command. To see which application servers are active, use theserverStatus
command from the (prs_profile)/bin directory:- Unix/Linux:
./serverStatus.sh -all
- Windows:
serverStatus.bat -all
- Unix/Linux:
- Open a command window and switch to the eclipse/tools
sub-directory of Installation Manager. By default, this is:
- Unix/Linux: /opt/IBM/InstallationManager/eclipse/tools
- Windows: C:\Program Files\IBM\Installation Manager\eclipse\tools
- Run the following command to launch the installation program of IBM
Installation Manager. Note: The command is shown here on multiple lines for clarity, but the entire command must be entered on one line. Include quotation marks around file paths that include spaces.For Unix/Linux:
For Windows:./imcl install com.ibm.websphere.PORTAL.REMOTESEARCH.v85 -repositories <fullpath/to/repository.config> -installationDirectory <portal_remotesearch_root> -acceptLicense
imcl.exe install com.ibm.websphere.PORTAL.REMOTESEARCH.v85 -repositories <fullpath/to/repository.config> -installationDirectory <portal_remotesearch_root> -acceptLicense
- If you are running an external web server, restart it now.
Use silent mode installation (available on Windows, Linux, Unix, and IBM i operating systems)
- If you are running an external web server such as IBM HTTP server, stop the web server.
- Stop any active application servers by using the
stopServer
command. To see which application servers are active, use theserverStatus
command from the (prs_profile)/bin directory:- Unix/Linux:
./serverStatus.sh -all
- Windows:
serverStatus.bat -all
- Unix/Linux:
- For IBM i only: Run the following command from qshell:
chown QEJBSVR /QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/prs_profile/ConfigEngine/properties/wkplc.properties
- Open a command window and switch to the eclipse/tools sub-directory of
Installation Manager. By default, this is:
- Unix/Linux: /opt/IBM/InstallationManager/eclipse/tools
- Windows: C:\Program Files\IBM\Installation Manager\eclipse\tools
- IBM i: /QIBM/ProdData/InstallationManager/eclipse/tools
- Update the sample response file that is packaged with your cumulative fix level
according to the comments in the file. You can also record a response file to
use to install the fix in silent mode. Go to the HCL Software Support page for detailed instructions
for recording an IBM Installation Manager response file. Note: The feature set
listed in your response file must match the feature set you have installed. You
cannot add or remove features during the cumulative fix update. The feature set
listed in the sample response file
is:
If the server you are applying the fix to is configured only as a remote search server, then you should removefeatures='main.ce,main.rs.install,main.dcs.install,main.rs.deploy,main.dcs.deploy'
main.dcs.deploy
from this list.- Example (Remote Search server only):
features='main.ce,main.rs.install,main.dcs.install,main.rs.deploy'
- Example (Document Conversion server only):
features='main.ce,main.rs.install,main.dcs.install,main.dcs.deploy'
- Example (Remote Search server only):
- Run the following command to install in silent mode:
imcl -acceptLicense -input <Full_path_to_your_response_file> -log <Full_Path_to_a_log_file> -showProgress
- If you are running an external web server, restart it now.
Use Console Mode Interface (available on Windows, Linux, Unix and IBM i operating systems)
- If you are running an external web server such as IBM HTTP server, stop the web server.
- Stop any active application servers by using the
stopServer
command. To see which application servers are active, use theserverStatus
command from the (prs_profile)/bin directory:- Unix/Linux:
./serverStatus.sh -all
- Windows:
serverStatus.bat -all
- Unix/Linux:
- For IBM i only: Run the following command from qshell:
chown QEJBSVR /QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/prs_profile/ConfigEngine/properties/wkplc.properties
- Open a command window and switch to the eclipse/tools
sub-directory of Installation Manager. By default, this is:
- Unix/Linux:
/opt/IBM/InstallationManager/eclipse/tools
- Windows:
C:\Program Files\IBM\Installation Manager\eclipse\tools
- IBM i:
/QIBM/ProdData/InstallationManager/eclipse/tools
- Unix/Linux:
- Run the command to start the IBM Installation Manager in console mode. For
Unix/Linux:
Windows:./imcl -c
IBM i:imcl.exe -c
./imcl -c
- Complete the following steps to add the repositories:
- Enter P to go to the Preferences menu.
- Enter 1 to go to the Repositories menu.
- Enter D to add repositories.
- Type the path for your HCL Portal Remote Search Version 8.5 CF repository file.
- Enter A to apply your repositories and return to the Preferences menu.
- Enter R to return to the Main menu.
- Select Update and follow the prompts to update HCL Portal.
- If you are running an external web server, restart it now.
Reminder: Go to Known Issues in this topic section to be aware of any known issues for HCL Portal CF releases.
Steps for rolling back the cumulative fix
- Use a Graphical User Interface (GUI) to roll back
- Use a command line rollback
- Use silent mode rollback
- Use console mode rollback
Choose one method that is available for your system. Follow the detailed steps for that option, and then proceed with the Post Rollback Steps.
Use a Graphical User Interface to roll back (available on Windows, Linux, and Unix operating systems)
- If you are running an external web server such as IBM HTTP server, stop the web server.
- Stop any active application servers by using the
stopServer
command. To see which application servers are active, use theserverStatus
command from the (prs_profile)/bin directory:- Unix/Linux:
./serverStatus.sh -all
- Windows:
serverStatus.bat -all
- Unix/Linux:
- Open a command window and switch to the eclipse/tools
sub-directory of Installation Manager.
- Unix/Linux: /opt/IBM/InstallationManager/eclipse/tools
- Windows: C:\Program Files\IBM\Installation Manager\eclipse\tools
- Run the following command to launch the installation program of IBM
Installation Manager.Note: The command is shown here on multiple lines for clarity, but the entire command must be entered on one line. Include quotation marks around file paths that include spaces.For Unix/Linux:
Windows:./imcl rollback com.ibm.websphere.PORTAL.REMOTESEARCH.v85 -installationDirectory <portal_remotesearch_root>
imcl.exe rollback com.ibm.websphere.PORTAL.REMOTESEARCH.v85 -installationDirectory <portal_remotesearch_root>
- If you are running an external web server, restart it now.
Use silent mode to roll back (available on Windows, Linux, Unix, and IBM i operating systems)
- If you are running an external web server such as IBM HTTP server, stop the web server.
- Stop any active application servers by using the
stopServer
command. To see which application servers are active, use theserverStatus
command from the (prs_profile)/bin directory.- Unix/Linux:
./serverStatus.sh -all
- Windows:
serverStatus.bat -all
- IBM i:
serverStatus -all
- Unix/Linux:
- For IBM i only: Run the following command from qshell:
chown QEJBSVR /QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/prs_profile/ConfigEngine/properties/wkplc.properties
- Open a command window and switch to the eclipse/tools sub-directory of
Installation Manager. By default, this is:
- Unix/Linux: /opt/IBM/InstallationManager/eclipse/tools
- Windows: C:\Program Files\IBM\Installation Manager\eclipse\tools
- IBM i: /QIBM/ProdData/InstallationManager/eclipse/tools
- Update the sample response file that is packaged with your cumulative fix level according to the comments in the file.
- Run the following command to roll back in silent
mode:
imcl -input (Full_path_to_your_response_file) -log (Full_Path_to_a_log_file) -showProgress
- If you are running an external web server, restart it now.
Use Console Mode Interface (available on Windows, Linux, Unix and IBM i operating systems)
- If you are running an external web server such as IBM HTTP server, stop the web server.
- Stop any active application servers by using the
stopServer
command. To see which application servers are active, use theserverStatus
command from the (prs_profile)/bin directory.- Unix/Linux:
./serverStatus.sh -all
- Windows:
serverStatus.bat -all
- IBM i:
serverStatus -all
- Unix/Linux:
- For IBM i only: Run the following command from qshell:
chown QEJBSVR /QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/prs_profile/ConfigEngine/properties/wkplc.properties
- Open a command window and switch to the eclipse/tools sub-directory of
Installation Manager. By default, this is:
- Unix/Linux: /opt/IBM/InstallationManager/eclipse/tools
- Windows: C:\Program Files\IBM\Installation Manager\eclipse\tools
- IBM i: /QIBM/ProdData/InstallationManager/eclipse/tools
- Run the command to start the IBM Installation Manager in console mode:
- Unix/Linux:
./imcl -c
- Windows:
imcl.exe -c
- IBM i:
./imcl -c
- Unix/Linux:
- Select Roll back and follow the prompts to roll back HCL Portal Remote Search.
- If you are running an external web server, restart it now.