Configuring WebFOCUS Portlets for the BEA AquaLogic Portal

In this section:

The following section describes how to install and register the WebFOCUS Portlets for the BEA AquaLogic Portal running on an application server, which has been configured to run WebFOCUS Business Intelligence Dashboard Version 7 Release 7.02.


Top of page

x
Installation Requirements

Before you install JSR 168 WebFOCUS Portlets, ensure the following components are installed and available:


Top of page

x
USE_GATEWAY Parameter

The USE_GATEWAY parameter is enabled internally by default.

If you are not using a gateway in your environment, you must log in to the WebFOCUS Administration Console and change the value of the USE_GATEWAY parameter to NO, as shown in the following image.

For more information, see Using the WebFOCUS Administration Console to Specify Parameter Values.

For more information on how to install and deploy the WebFOCUS Open Portal Services Gateway, see Installing and Deploying WebFOCUS Open Portal Services Gateway.


Top of page

x
Deploying the Portlet Application on the BEA AquaLogic Portal

How to:

You can use the AquaLogic Interaction console to deploy the JSR168 WebFOCUS Portlets.



x
Procedure: How to Configure and Deploy the WebFOCUS Portlets

To deploy the WebFOCUS Portlets:

  1. Install AquaLogic Interaction JSR-168 Container on the same machine where your BEA AquaLogic Portal Server is installed.

    Note: Information Builders does not provide this container. You must acquire this container from BEA.

  2. Explode opspt.war files located in
    \ibi\WebFOCUS77\worp\components\ops\aqualogic

    to a temporary directory, for example c:\aqualogic.

  3. Copy the files under
    aqualogic\ptjsr168\1.0\devkit\WEB-INF\lib 

    to

    c:\aqualogic\WEB-INF\lib
  4. Because of a known issue in AquaLogic Interaction JSR-168 Container, you must hard code all necessary portlet values inside the portlet.xml file, which is located in
    c:\opspt\WEB-INF
  5. Open the portlet.xml file and make the following changes for each portlet
    <preference>
        <name>trustedkey</name>
        <value></value>
        <read-only>false</read-only>
    </preference>

    to

    <preference>
        <name>trustedkey</name>
        <value>1169656392736</value>
        <read-only>false</read-only>
    </preference>

    Note: The trusted key value is found in the cgivars.wfs file, located in the following directory of the machine where WebFOCUS is installed:

    \ibi\WebFOCUS77\client\wfc\etc

    Search the cgivars.wfs file for the IBIMR_TRUSTED_KEY parameter. The value is the trusted key.

  6. If necessary, modify the default context path from ibi_apps to the new context path. For example:
    <preference>
       <name>contextpath</name>
       <value>/ibi_apps</value>
       <read-only>false</read-only>
    </preference>
  7. Rewar your changes and name your new .WAR file opspt.war.
  8. Deploy this .WAR file to the same application server where your BEA AquaLogic Portal is installed.
  9. Logon to the BEA AquaLogic Portal Server as an administrator.

    The AquaLogic Interaction console opens, as shown in the following image.

  10. Select the JSR-168 folder.

    The contents of the folder are displayed, as shown in the following image.

  11. Click Remote Server.

    The following pane opens.

  12. Select JSR-168 Remote Server.

    The Remote Server Properties pane opens.

  13. Verify the Remote Server authentication information of the server where your BEA AquaLogic Portal is installed.
  14. Return to the previous pane, and select Web Services - Remote Portlet from the Create Object drop-down list.

    The Create Web Service - Remote Portlet pane opens.

  15. In the Server Information section, click Browse next to the Remote Server field.

    The Choose Remote Server dialog box opens.

  16. Select JSR-168 Remote Server from the list of available objects and click OK.

    You are returned to the Create Web Service - Remote Portlet pane.

  17. In the HTTP Settings section, enter the following URL in the Portlet URL field:
    opspt/portlet/name_of_portlet/mode/view

    where:

    name_of_portlet

    Is the name of the Portlet you are deploying, such as Domain, DeferStatus, Favorites, Quicklinks, Report or Output. For example:

    opspt/portlet/Domain/mode/view
  18. Click HTTP Configuration from the Edit Object Settings list in the left pane.

  19. Add the following prefix in the Gateway URL Prefixes section:
    opspt/
  20. Click Finish.

    The Save Object dialog box for the new Web Service opens.

    Perform the following steps:

    1. Select the folder where you want to save the Web Service, for example, JSR-168.

      The most recently used folder is automatically selected.

    2. Provide a name for the Web Service in the Save As field, for example, Domainsrv.
    3. Provide a brief description (optional).
  21. Click Save.

    The Object Saved dialog box opens, as shown in the following image.

  22. Click Create new Portlet.

    The Create Portlet pane opens.

  23. Click Finish.

    The Save Object dialog box for the portlet opens.

    Perform the following steps:

    1. Select the folder where you want to save the portlet, for example, JSR-168.

      The most recently used folder is automatically selected.

    2. Provide a name for the portlet in the Save As field, for example, WFDomain.
    3. Provide a brief description (optional).
  24. Click Save.

    The Object Saved dialog box opens, as shown in the following image.

  25. Click Close.

    The new portlet is now included in the list of available portlets for the BEA AquaLogic Portal.

  26. Repeat steps 18 to 31 for each WebFOCUS portlet you want to configure.

    For more information on adding these portlets to the portal page or BEA AquaLogic Portal community, see your BEA AquaLogic Portal Server documentation.


WebFOCUS