3 Administering WSRP Producers with IBM WebSphere Portal

The following administrative tasks are covered in this chapter:

Note:

To implement the EnterpriseOne WSRP portal for WebSphere Portal v7.0, first you need to install and configure the EnterpriseOne HTML Server on a WebSphere Application Server v7.0. Follow the HTML Server installation guide to install the HTML Server. Test the HTML Server to ensure it functions properly before carrying out the following steps. The fully functional HTML Server is going to be the WSRP Producer for the following steps, described below.

3.1 Setting up the URL Rewrite Option on the Producer

To use JD Edwards EnterpriseOne portlets in the IBM WebSphere Portal v7.0, the ”URL Rewrite” option must be set. Follow the steps below to perform this task:

To set up the URL Rewrite option on the producer:

Note:

The steps below must be performed on the JD Edwards EnterpriseOne HTML Web Server.

  1. Sign onto the WebSphere Admin Console on your producer.

    This image is described in the surrounding text.

  2. Select Session Management.

  3. Select the ”Enable URL rewriting” option.

  4. Select OK.

    This image is described in the surrounding text.

  5. Select Save.

  6. Restart the server.

    This image is described in the surrounding text.

3.2 Turning off WSRP Producer Compression

The WSRP producer needs to have compression turned off as the WSRP Portals are not able to handle compressed resources such as Javascript, CSS… etc.

This means that the Java Application Server (JAS) server that is designated as the WSRP producer must have the JAS compression turned off. Please ensure the ”EnableCompression” setting is set to false with server manager.

This also means that other means of compression cannot be used on the JAS WSRP producer instance (for example compression by means of HTTP Server …etc.).

3.3 Registering a New Non-SSL WSRP Producer

  1. Login into the IBM WebSphere Portal v7.0 using an Administrative account (an ID that belongs to the wpsadmins group). This should bring up the Administration portlet, if it does not, click on the Administration link on the top.

    This image is described in the surrounding text.

  2. Click on the ”Web Services” link from the Portlet Management portlets.

    This image is described in the surrounding text.

  3. Click the New Producer button.

    This image is described in the surrounding text.

  4. Type in a Title for the producer and the URL to WSDL service definitions. The URL is of the following format: http://<Producer_JAS_Host>:<Producer JAS Port>/jde/wsdl/oasis/names/tc/wsrp/v1/bind/wsrp_service.wsdl (for example, http://DENQAS8:92/jde/wsdl/oasis/names/tc/wsrp/v1/bind/wsrp_service.wsdl) when this URL is accessed in the browser it should bring up an XML source as shown above. Click Next button.

    This graphic is described in the surrounding text.
    This image is described in the surrounding text.

  5. Click the next button again to proceed.

    This image is described in the surrounding text.
    This image is described in the surrounding text.

The new producer will display in the list once it is registered.

3.4 Registering a New SSL WSRP Producer

This section will discuss the prerequisites and the steps to register a new SSL WSRP producer.

3.4.1 Before You Begin

  1. If you have configured an SSL protocol in your producer, make sure the https URL is working correctly.

  2. Modify the ”soap:address location” with the SSL URL in the wsrp_service.wsdl file in ../webclient.war/wsdl/oasis/names/tc/wsrp/v1/bind folder.

    This graphic is described in the surrounding text.

  3. Login to the WebSphere Portal Integrated Solution Console.

  4. Select ”SSL certificate and key management” from the ”Security” section.

  5. Click ”key Stores and certificates” -> ”NodeDefaultTrustStore” -> ”Singer certificates”.

  6. Click ”Retrieve from port”.

  7. Enter the SSL server and port, and then enter an Alias for this key.

  8. Click the ”Retrieve singer information” button.

    Note:

    If the Portal Server cannot retrieve the certificate automatically, you can export and save the producer's certificate in ”Base_64 encoded X.509” format to ../WebSphere/wp_portal/etc folder. Then select the ”Add” button from ”Signer certificate” option. Enter the Alias and the certificate file name and click ”Apply”.

  9. Review the certification information and click ”OK”.

  10. Click ”Save” to update the master configuration.

3.4.2 Register a New SSL WSRP Producer

  1. Login to the WebPort Portal Server with Administrator privilege.

  2. Click on the ”Web Services” link from the Portlet Management portlets.

    This image is described in the surrounding text.

  3. Click the New Producer button.

    This image is described in the surrounding text.

    Type in a Title for the producer and the URL to WSDL service definitions. The URL is of the following format: https://<Producer_JAS_Host>:<Producer JAS Port>/jde/wsdl/oasis/names/tc/wsrp/v1/bind/wsrp_service.wsdl This graphic is described in the surrounding text.

  4. Click the Next button again to proceed.

    This graphic is described in the surrounding text.

  5. The new producer will display in the list once it is registered.

3.5 Setting up the Consumer

To set up the consumer:

  1. Select the Web Modules option underneath Portlet Management.

    This image is described in the surrounding text.

  2. Click the Consume tab.

    This image is described in the surrounding text.

  3. Choose the newly added WSRP Producer.

    This image is described in the surrounding text.

  4. Click on the newly added WSRP Producer.

    This image is described in the surrounding text.

  5. Select the required portlets that you are planning to use.

  6. Click the OK button.

    This image is described in the surrounding text.

  7. A message will display indicating that the Portlets are successfully consumed.

3.6 Adding Portlets to Page from Registered WSRP Producer

This section covers adding portlets to a page from a registered WSRP producer.

To add portlets to a page from a registered WSRP Producer:

Note:

The following steps are performed on the IBM WebSphere Portal server.

  1. Select the Manage Page option under the Portal User Interface section.

    This image is described in the surrounding text.

  2. Select the Content Root hyperlink.

    This image is described in the surrounding text.

  3. Click the New Page button.

    This image is described in the surrounding text.

  4. Enter the page Title (Unique Name is optional).

    This image is described in the surrounding text.

  5. Select the page theme (this is also optional, the page inherits the currently default them of the portal), select the Theme Style (this is optional).

  6. Click OK button.

  7. Select the Edit Page Layout icon in the same row as the newly-created page.

    This image is described in the surrounding text.

  8. Select the page layout by choosing one of the available layouts.

    This image is described in the surrounding text.

  9. Select the Add portlets button.

  10. Search for the required portlet to be added. For example E1Menu Portlet. Click the OK Button.

    This image is described in the surrounding text.

  11. Select the consumed portlets to add to the page.

  12. Select Done.

    This image is described in the surrounding text.

  13. Select the newly created page to launch it. This operation should only be carried out after the installation of the Collaborative Portal software component.

This image is described in the surrounding text.

The JD Edwards EnterpriseOne menu will display, and you can access the JD Edwards EnterpriseOne applications similar to the HTML Server.

This image is described in the surrounding text.