Install HCL WebSphere Portal in Linux using the console

Use the IBM Installation Manager to install HCL 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. We cannot install two instances of the server at the same time, even if we are installing to different directories. Install each server completely before installing the next one.

1. Install IBM WebSphere Application Server.

   Install IBM WebSphere SDK Java Technology Edition into the same directory where IBM WebSphere Application Server is installed. The SDK Java version must be 8.0.3.

2. Start all servers and applications that require a port number to avoid port conflicts when installing HCL WebSphere Portal.

   If we are installing multiple copies of HCL DX on the server, start the existing Configuration Wizard servers. The cw_profile starting point always defaults to 10200. If we install a second version of portal on the same server, customize the cw_profile port value. Edit...

   IM_ROOT/InstallationManager/eclipse/tools/imcl.ini

   ...and add...

   -Dcwprofile_startingport=new_starting_port_number

3. Run the program as an administrator:
   1. cd IM_ROOT/eclipse/tools
   2. Right-click on the imcl command.
   3. Select Properties.
   4. Go to the Compatibility tab.
   5. Select Run this program as an administrator.
   6. Click OK.

4. Start the IBM Installation Manager in console mode:
   IM_ROOT/eclipse/tools
   ./imcl -c

5. Add the repositories:
   1. Enter P to go to the Preferences menu.
   2. Enter 1 to go to the Repositories menu.
   3. Enter D to add repositories.
   4. Type the path for the HCL WebSphere Portal repository file.
   5. Enter A to apply your repositories and return to the Preferences menu.
   6. Enter R to return to the Main menu.

6. Enter 1 to install the software packages.

7. Select HCL WebSphere Portal Server.

   Your existing copy of WebSphere Application Server must meet the following requirements:

   • WebSphere Application Server v8.5.5.2 or later
   • Java v8.0.3.
   • No existing Portal profile

   Tip: For a HCL WebSphere Portal Enable license, select both the HCL WebSphere Portal Server, HCL WebSphere Portal Express, and HCL WebSphere Portal Enable packages.

8. Choose one of the following options:
   • Enter 1 to choose v9.5 for installation.
   • Enter 2 to show all available versions of the package.

9. Enter N.

10. Enter A to accept the license agreement.

11. Enter N.

12. Choose one of the following options for translation packages:
    • Enter N to select the default English package only.
    • Enter the number for the translation package we want to install.

13. On the Incompatible package group menu, choose one of the following options:

    • Enter M to change the installation directory. Then, enter the new installation directory. Read the Tip about installation path length to avoid issues that are caused by long paths.

    • Enter N to keep the existing directory.

    Tip: Ensure that the installation paths for WebSphere Application Server and HCL WebSphere Portal that are reasonably short. Long paths can cause installation problems.

14. Enter the number for the WebSphere Application Server root directory to use as the existing WebSphere Application Server.

15. On the IBM Installation Manager > Install > Licenses > Location > Features menu, enter 1 to select the Portal Server Profile feature. Then, enter N to continue.

    Ensure that Portal Server Profile is selected to create a profile that contains the Portal application server and the product binary files. Clear this option if we need a binary only installation for migration or the clustered environment.

16. Enter the configuration wizard administrator user ID and password.

17. If we selected the Portal Server Profile feature, enter the information for the following prompts:
    • Enter the host name
    • Enter the node name
    • Enter the cell name
    • Enter an administrator user ID for the portal server
    • Enter an administrator user password for the portal server
    • Confirm administrator user password for the portal server

18. Enter Y to enter advanced parameters such as customized Uniform Resource Identifier (URI) settings, profile name, and port numbers. Enter N to accept the default parameters.
    • Enter the context root
    • Enter the default home
    • Enter the personalized home
    • Enter the profile name
    • Enter the starting port number
    • Enter the profile path

19. Enter N.
20. Review the summary information.
21. Choose one of the following options:

    • Enter G to generate a response file.

    • Enter I to install HCL WebSphere Portal.

22. When the installation is complete, enter F to return to the main installation menu.

23. Access the Configuration Wizard. Go to:
    http://your_server:10200/hcl/wizard

    Note: If working with HCL WebSphere Portal 8.5 or 9 software level prior to CF18, the wizard address will be: http://your_server:10200/ibm/wizard. After installing CF18, the configuration wizard will automatically be adjusted to http://your_server:10200/hcl/wizard. Restriction: There is a known issue with Chrome version 45.x and the Configuration Wizard. If we are experiencing difficulties, use a different browser when you access the wizard.

24. Log in to the Configuration Wizard with the administrative ID for the configuration wizard profile, cw_profile.

    Note: If the language is not currently supported for the user interface, we might see the English version. For details on supported languages and the language codes for all of the HCL WebSphere Portal user interfaces, see Supported languages in the HCL WebSphere Portal v8.5 documentation.

What to do next

After you upgrade to CF08 or higher, we can upgrade your SDK to version 7.1. Go to Upgrading the SDK for information.

Parent topic: Run the HCL WebSphere Portal installer in Linux