Installing HCL DX on AIX using a console

Use the IBM Installation Manager to install HCL Digital Experience (DX) to an existing IBM WebSphere Application Server.

The installation program verifies the operating system and its prerequisites, available disk space, and any required software prerequisites before installation. You cannot install two instances of the server at the same time, even if you are installing to different directories. You must install each server completely before you install the next one.

Preparing the installation

Download and extract the latest HCL DX Cumulative Fix (CF) from the My HCLSoftware download portal (for example, HCL-DX-CF237_Server_Update.zip) to a local directory (for example, /opt/HCL/INSTALL/CF237).
Start all servers and applications that require a port value to avoid port conflicts when you install HCL DX. If you are installing multiple copies of HCL DX on your server, start the existing Configuration Wizard servers.

Note

The cw_profile port value defaults to 10200. If you install a second version of DX on the same server, you must customize the cw_profile port value by adding -Dcwprofile_startingport=new_starting_port_number to the InstallationManager_root/InstallationManager/eclipse/tools/imcl.ini file.
Open a terminal and navigate to the <InstallationManager_root>/eclipse/tools directory:

bash cd /IBM/InstallationManager/eclipse/tools
Start the IBM Installation Manager in console mode:
```
./imcl -c
```

Complete the following steps to add all required 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 DX repository file.

For example, when installing the Web Content Manager (WCM) 9.5 offering:

Add the following DX repositories:

<DX-install-image>/SETUP/products/IFPI59896/8.5.0.0-WP-Server-IFPI59896.zip
<DX-install-image>/SETUP/products/JDK805/repository.config
<DX-install-image>/SETUP/products/WASND905/repository.config
<DX-install-image>/SETUP/products/WP85_Server/repository.config
<DX-install-image>/SETUP/products/WP95_Server/repository.config
<DX-install-image>/SETUP/products/WP85_WCM/repository.config
<DX-install-image>/SETUP/products/WP95_WCM/repository.config

Add the latest CF repository. For example:

<DOWNLOAD_FOLDER>/<CF_version>/repository/repository.config

Enter A to apply your repositories and return to the Preferences menu.
Enter R to return to the Main menu.

Installing IBM WebSphere Application Server

In the main menu, enter 1 to install the software packages.
Select the following packages for the initial installation, and then enter N to continue:
- IBM WebSphere Application Server Network Deployment 9.0.5.0
- IBM SDK, Java Technology Edition, Version 8 \
Note
- If an IBM WebSphere Application Server Network Deployment 9.0.5.x is already installed, skip this step.
- For new installations, you must have IBM WebSphere Application Server & SDK Java version 8.0.3 installed to install HCL DX on top of it.
- You must select the IBM WebSphere SDK Java Technology Edition package for HCL DX, even though it is labeled Optional on the Select packages to install prompt.
Enter A to accept the license agreement, and then enter N to continue.
Specify the shared resources directory.
- To accept the default directory, enter N to continue.
- To change the directory, enter M, enter the path (for example, /opt/IBM/IMShared), and then enter N to continue.
At the New package group prompt, configure the package group and installation directory:
1. Ensure that IBM WebSphere Application Server V9.0 is selected.
2. To change the installation directory, enter M, and then enter the path (for example, /opt/IBM/WebSphere/AppServer).
3. Keep the default architecture setting.
4. Enter N to continue.
Note

The installation directory must be empty and cannot contain spaces or special characters.
Choose the translation packages to install:
- To use the default English package, enter N to continue.
- To install additional languages, enter the numbers corresponding to the packages, and then enter N to continue.
At the Features prompt, enter N to deploy the default applications only. To install sample applications, enter 4, and then enter N to continue.
At the Summary prompt, enter I to start the installation.
When the installation completes, enter F to finish.

Installing HCL DX

At the main menu, enter 1 to install software packages.
At the Select packages to install prompt, select the packages to install:
1. Select IBM WebSphere Portal Server 8.5.0.0 and any packages required for your offering:
  - IBM Web Content Manager 8.5.0.0 for HCL WCM
  - IBM WebSphere Portal Enable 8.5.0.0 for HCL Portal Enable
  - IBM WebSphere Portal Extended 8.5.0.0 for HCL Portal Extended
2. If the menu displays CF<version>, select the base version instead of the CF:
  1. Select the package number for your offering.
  2. Enter 2 to display all available versions of the package.
  3. Select the base version (for example, select Version 8.5.5.0 instead of Version CF237 for v8.5, v9.0 and v9.5).
  4. Enter O to confirm the selection.
  For example, when you install HCL WCM, select options 2 and 6:
```
Select packages to install:
1. [ ] IBM WebSphere Application Server Network Deployment 9.0.5.0
2. [X] IBM WebSphere Portal Server 8.5.0.0
3. [ ] HCL Portal Server 9.5.0.0
4. [ ] HCL Web Content Manager 9.5.0.0
5. [ ] IBM SDK, Java Technology Edition, Version 8 8.0.5.35
6. [X] IBM Web Content Manager  8.5.0.0
```
3. Enter N to continue.
At the Select Fixes prompt, enter 2 to select the 8.5.0.0-WP-Server-IFPI59896 8.5.0.20161201_1732 iFix, and then enter N to continue:

Note

This iFix is required when you install Portal 8.5 on IBM WebSphere Application Server 9.0 using Java 8.
Enter A to accept the license agreement, and then enter N to continue.
At the New package group prompt, specify the installation directory:
- To accept the default directory, enter N to continue.
- To change the directory, enter M, enter the path (for example, /opt/HCL/PortalServer), and then enter N to continue.
Ensure that Portal Server Profile is selected, and then enter N to continue.
Enter 1 to select the IBM WebSphere Application Server installation directory.
Enter the username and password for the Configuration Wizard (for example, wpsadmin).
Enter the fully qualified AIX host name.
Enter a node name (for example, DXNode1).
Enter a cell name (for example, DXCell).
Enter the username and password for the portal administrator (for example, wpsadmin).
At the Advanced Parameters prompt, enter N, and then enter N to continue.
At the Summary prompt, verify the packages and enter I to start the installation.

For example, when you install HCL WCM 9.5, the following packages are displayed:
```
Packages to be installed:
1. IBM WebSphere Portal Server 8.5.0.0
2. 8.5.0.0-WP-Server-IFPI59896 8.5.0.20161201_1732
3. IBM Web Content Manager  8.5.0.0
```
Note

During the installation, informational messages might appear, such as com.ibm.wps.workflowWorkflowManager enable WorkflowExecution or INFO: I: Workflow execution is enabled. Ignore these messages and wait for the installation to finish.

When the installation finishes, check for warnings:

Enter V to view message details.

If the following warning appears, enter O to continue:

WARNING: Multiple warnings occurred.  
Details:  
A supported operating system was not detected. Support for your operating system might have been added after the release of the product. See the WebSphere Portal Server detailed system requirements Web pages - http://www.ibm.com/support/docview.wss?uid=swg27007791 for more information about supported operating systems. You can continue with the installation, but the installation or product operation might not succeed without applying maintenance.

Enter F to finish.
Enter X to exit IBM Installation Manager.
Navigate to the <wp_profile_root>/bin directory and stop the WebSphere_Portal server instance:
```
./stopServer.sh WebSphere_Portal
```
For example:
```
cd /opt/HCL/wp_profile/bin
./stopServer.sh WebSphere_Portal
```
If prompted, enter the administrator username and password.
Navigate to the /opt/IBM/WebSphere/AppServer/profiles/cw_profile/bin directory and stop the server1 instance:
```
cd /opt/IBM/WebSphere/AppServer/profiles/cw_profile/bin
./stopServer.sh server1
```
If prompted, enter the IBM WebSphere Application Server administrator username and password.
Verify that all IBM WebSphere Application Server and HCL DX instances are stopped before you apply updates.

Installing the latest CF

Open a terminal and navigate to the <InstallationManager_root>/eclipse/tools directory:

bash cd /IBM/InstallationManager/eclipse/tools
Start the IBM Installation Manager in console mode:
```
./imcl -c
```
At the main menu, enter 2 to update the environment.
Enter 2 to select IBM WebSphere Portal Server 8.5, and then enter N to continue.

If prompted for an IBM ID, enter C repeatedly (up to four times) until the next prompt appears.
Select the CF version (for example, Version CF237 for v8.5, v9.0 and v9.5), and then enter N to continue.

If a warning indicates that no supported operating system was detected, enter N to continue.
Enter A to accept the license agreement, and then enter N to continue.
Ensure that Portal Server Profile is selected, and then enter N to continue.
At the Summary prompt, enter U to update the environment.
When the installation finishes, check for warnings:
- Enter V to view message details.
- If only operating system warnings appear, enter O to continue.
Enter F to finish.
Enter X to exit IBM Installation Manager.
In the terminal, navigate to the <wp_profile_root>/PortalServer/bin directory. For example: /opt/HCL/wp_profile/PortalServer/bin.
Update wp_profile with the CF:
```
./applyCF.sh -DPortalAdminPwd=<password> -DWasPassword=<password>
```
Ensure that the script displays the following message:
```
SUCCESS: Update to Cumulative Fix completed successfully.
```
Note

When the update completes, the WebSphere_Portal server instance starts automatically. Stop the server instance before updating the environment to version 9.5. For more information, refer to Applying a Combined Cumulative Fix.
Go to the <wp_profile_root>/bin directory and stop the WebSphere_Portal server instance:
```
./stopServer.sh WebSphere_Portal
```
For example:
```
cd /opt/HCL/wp_profile/bin
./stopServer.sh WebSphere_Portal
```
If prompted, enter the IBM WebSphere Application Server administrator username and password.

Updating HCL DX to v9.5

Open a terminal and navigate to the <InstallationManager_root>/eclipse/tools directory:

bash cd /IBM/InstallationManager/eclipse/tools
Start the IBM Installation Manager in console mode:
```
./imcl -c
```
At the main menu, enter 1 to install software packages.
At the Select packages to install prompt, select all version 9.5 packages for your offering by entering their corresponding numbers, and then enter N to continue.

For example:
- HCL Portal Server 9.5
- HCL Web Content Manager 9.5
If an operating system warning appears, enter N to continue.
Enter A to accept the license agreement, and then enter N. to continue
Ensure that the existing package group is selected, and then enter N to continue.
Enter the IBM WebSphere Application Server administrator username and password (for example, wpsadmin).
Enter Y to validate the credentials.
Enter the portal administrator username and password.
Enter Y to validate the credentials, and then enter N to continue.
At the Summary prompt, verify that all version 9.5 packages are selected, and then enter I to start the installation.
When the installation finishes, check for warnings:
- Enter V to view message details.
- If only operating system warnings appear, enter O to continue.
Enter F to finish.
Enter X to exit IBM Installation Manager.

Next Steps

To enable version 9.5 UI features, refer to Enabling Practitioner Studio.
Update IBM WebSphere Application Server and its SDK to the latest fix pack using IBM Installation Manager. For more information, refer to Recommended updates for WebSphere Application Server.

Related information

A Step-by-Step Guide to Installing Portal 9.5