WebSphere

 

Portal Express, Version 6.0
Operating systems: i5/OS, Linux, Windows

 

Configure the WebSphere Portal Express server to recognize Lotus QuickPlace

You run the IBM® Lotus® QuickPlace® configuration task on the IBM WebSphere® Portal Express server. Running the task allows the portal to recognize the presence of the Lotus QuickPlace server so that Lotus Collaborative Services can use the server for Lotus QuickPlace portlets.

WebSphere Portal Express (which includes Collaborative Services) must be installed before you can run this task.

You run the configuration task by entering commands at a command line on the portal server.

Commands are case sensitive.

During the instructions for this task, you will edit the wpconfig.properties file. Create a backup copy of this file before performing the following instructions.

For security reasons, you should not store passwords in the wpconfig.properties file. Edit the wpconfig.properties before running a configuration task, inserting the passwords needed for that task. Then, after the task has run, delete all passwords from the wpconfig.properties file.

For detailed information on working with property files, see Configuration properties reference.

Perform the following steps to run the configuration task:

  1. Use the following commands to stop WebSphere Portal Express.

    1. Open a command prompt and change to the following directory:

    2. Enter the following command:

      • Linux:

        ./stopServer.sh WebSphere_Portal -user admin_userid -password admin_password

      • Windows:

        stopServer.bat WebSphere_Portal -user admin_userid -password admin_password

      • i5/OS:

        stopServer.sh WebSphere_Portal -profileName profile_root -user admin_userid -password admin_password

        where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

    The default name of the application server is the profile name.

  2. Locate the wpconfig.properties and wpconfig_dbdomain_config.properties files and make a backup copy of each before changing any values. The files are located in the following directory:

     

    Windows: portal_server_root\config

     

    Linux: portal_server_root/config

     

    i5/OS (UserData): portal_server_root_user/config

  3. Use a text editor to open the appropriate configuration properties file and enter the appropriate values for your environment. Note the following:

    • Do not change any settings other than those specified in these steps. For instructions on working with these files, see Configuration properties reference for a complete properties reference, including default values.

    • Use / instead of \ for all platforms.

    • Some values, shown in italics below, may need to be modified to your specific environment.

    • Depending on which database domain has to be configured, dbdomain may need to be replaced by:

      • release

      • customization

      • community

      • jcr (DB2 Content Manager Runtime Edition)

      • wmm

      • feedback

      • likeminds

     

    Section of wpconfig.properties file: Lotus QuickPlace Properties

    Property Value
    LCC.QuickPlace.Enabled The property that determines whether Lotus QuickPlace is enabled.

    Setting LCC.QuickPlace.Enabled to true enables this component. Setting the value to false disables it.

     

    Recommended Value: true

     

    Default Value: false

    LCC.QuickPlace.Server The name of the Lotus QuickPlace server.

     

    Recommended Value: my.server.com

     

    Default Value: my.server.com

    LCC.QuickPlace.Protocol The protocol used to connect to the Lotus QuickPlace server.

     

    Recommended Value: http

     

    Default Value: http

    LCC.QuickPlace.Port The port number for the Lotus QuickPlace server.

     

    Recommended Value: 80

     

    Default Value: 80

  4. Save the file.

  5. Change to the portal_server_root/config directory and type the following command: Windows: 

    WPSconfig.bat lcc-configure-quickplace

     

    Linux: 

    ./WPSconfig.sh lcc-configure-quickplace

     

    i5/OS (UserData): 

    WPSconfig.sh -profileName profile_root lcc-configure-quickplace

  6. Check the output for any error messages. If you encounter an error, check the appropriate logs file for more information.

  7. Use the following commands to start WebSphere Portal Express:

    1. Open a command prompt and change to the following directory:

    2. Enter the following command:

      • Linux:

        ./startServer.sh WebSphere_Portal

      • Windows:

        startServer.bat WebSphere_Portal

      • i5/OS:

        startServer.sh WebSphere_Portal -profileName profile_root

        where profile_root is the name of the WebSphere Application Server profile where WebSphere Portal Express is installed; for example, wp_profile.

If you intend to use Lotus Domino Directory as the LDAP server for the portal, also complete the steps in Checklist of tasks: LDAP server for Lotus Collaborative Services. Tip: The task lcc-configure-quickplace is specific for configuring Collaborative Services to use Lotus QuickPlace only. It is possible to change and save other Collaborative Services values in wpconfig.properties, and then run the configuration task ./WPSconfig.sh lcc-configure-all (Linux) or WPSconfig.bat lcc-configure-all (Windows) to configure multiple Domino and Extended Products servers at once.

 

Parent topic:

Checklist of tasks: Lotus QuickPlace server and portlets

 

Next topic

Configuring the list of servers for the Inline QuickPlace portlet

 

Related concepts
WebSphere Portal Express logs

 

Related information
Starting and stopping WebSphere Application Server and WebSphere Portal Express