Install HCL WebSphere Portal in AIX system using the console

Use the IBM Installation Manager to install HCL DX to an existing IBM WebSphere Application Server.

A working installation of IBM WebSphere Application Server is required. Ensure it is not used by another copy of HCL WebSphere Portal. Before installing the HCL WebSphere Portal package, install IBM WebSphere SDK Java Technology Edition into the same directory where IBM WebSphere Application Server is installed. The SDK Java version must be 7.0.

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. 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.

   Note: Currently, 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 ddd the following line...

   -Dcwprofile_startingport=new_starting_port_number

2. Complete the following steps to 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.

3. cd IM_ROOT/eclipse/tools

4. Run the command to start the IBM Installation Manager in console mode: ./imcl -c imcl -c 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. To complete this installation option, your existing copy of WebSphere Application Server must meet the following requirements:

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

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

8. Choose one of the following options:

   • Enter 1 to choose version 8.5.0.0 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. Use the following suggested paths or choose locations of this length or shorter to ensure success:

    • WebSphere Application Server installation location: /QIBM/ProdData/WebSphere/AppServer/V85/ND

    • WebSphere Application Server default profile location: /QIBM/UserData/WebSphere/AppServer/V85/ND
    • HCL WebSphere Portal installation location: /QIBM/ProdData/WebSphere/PortalServer/V85/Server
    • Configuration Engine location: /QIBM/ProdData/WebSphere/PortalServer/V85/ConfigEngine
    • HCL WebSphere Portal profile path: /QIBM/UserData/WebSphere/AppServer/V85/ND/profiles/wp_profile

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.

    Note: 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.

      Note: Go to Create a response file for the AIX environment for more information.

    • 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 we 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

Before accessing WebSphere Application Server, configure the software license agreement to set the usage limit from the Proof of Entitlement (POE) or invoice. Go to Configure software license information for information.

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 AIX