WebSphere

 

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

 

Troubleshoot portlets

This section contains information that can assist you in preventing, identifying, and correcting problems related to IBM® WebSphere® Portal Express. For information related to specific components, see the appropriate troubleshooting topic.

 

Problem: Error sending/opening messages with large attachments in CPP Mail and Calendar portlets

The size of messages (message body + attachments) that can be sent or opened by the CPP Mail and Calendar portlets is limited by the amount of free heap space available on the portal server JVM at the time that the operation is attempted. We have successfully tested sending and opening messages of 50 MB in size on an unloaded portal server with all supported back end mail servers, however, because other factors such as server load affect the size of the free memory heap in the JVM, this is not a guaranteed maximum message size which can be supported. We recommend to use small attachments with a size wide below 50 MB to avoid heap fragmentation and potential out of memory errors. Also the system should be tuned - we recommend specifying the maximum JVM heapsize at 1216 MB on Windows using the -Xmx option (For example, -Xmx1216M) in order to provide the largest practical JVM heap and still leave enough system memory for the operating system and other processes. See the WebSphere Portal Express 6.0.x Performance Tuning Guide for more information on heap tuning for WebSphere Portal Express.

 

Problem: Undo and redo not working correctly in rich text editor when composing mail using Firefox browser

When you are composing a mail message using the rich text editor in the Firefox browser, clicking Undo (Ctrl+z) and Redo (Ctrl+y) may not perform as expected. In some cases, when text should reappear, it does not. When text should disappear, it does not.

This is a known limitation when using the Firefox browser.

 

Problem: European comma format for numbers not available in Retirement Planner

Retirement Planner only allows users to use the format x.xx when entering non-whole number values.

 

Problem: Configure proxy for MarketWatch portlets

The MarketWatch portlets My News, My Weather, and My Stocks assume that you have direct access to the Internet to retrieve content for rendering in the portlets. If access is only possible through a proxy, then the proxy must be configured in the portlet by modifying its web.xml file.

 

Solution: There are four context level parameters in web.xml, and by default they are all empty: 

<context-param>
     <param-name>proxyHost</param-name>
     <param-value></param-value>
  </context-param>

  <context-param>
     <param-name>proxyPort</param-name>
     <param-value></param-value>
  </context-param>

  <context-param>
     <param-name>proxyUserName</param-name>
     <param-value></param-value>
  </context-param>

  <context-param>
     <param-name>proxyPassword</param-name>
     <param-value></param-value>
  </context-param>

The values for these parameters should be:

  1. proxyHost: The host name of proxy server (dns name or static IP address).

  2. proxyPort: The proxy server port, such as 8080.

  3. proxyUserName/proxyPassword: If the proxy server requires authentication, specify the user ID and password for the proxyUserName and proxyPassword parameters, respectively.

 

Problem: Click-to-Action menu shown in English, not Chinese

After configuring the Click-to-Action menu of the JDBC portlet in English, when you change the language of the browser to zh_CH, the menu still displays in English.

 

Solution: Replace the Click-to-Action menu items with local language strings.

 

Problem: The administration portlets do not officially support the browser 'Back' or 'Refresh' functions.

For a listing and description of the administration portlets, refer to Portal administration portlets.

 

Limitation: The properties portlet does not list all shareable pages.

The list of shareable pages displayed by the Properties portlet is limited to those pages that the user can navigate to. As a result, a user might not be able to create explicitly derived pages from some shareable pages.

 

Limitation: Privileged user cannot set page properties or Personalization rules.

A user must have at least Editor privileges on a page to be able to edit the properties on that page. Privileged users will not be able to edit a page's properties or edit personalization rules, because Personalization rules are part of a page's properties.

 

Problem: Buttons in Adminstration portlets may not function.

Solution:Enable scripting in Microsoft Internet Explorer using the following steps:

  1. Select the Tools menu.

  2. Select Internet Options.

  3. Select the Security tab.

  4. Click the Custom level button.

  5. Enable the entire Scripting section.

 

Problem: Formatting and JavaScript problems occur in rendered Portal page

Formatting problems and JavaScript console errors and warnings occur when a page is rendering. Formatting problems may include such things as excess white space, alignment issues, and truncation. These problems may occur due to inconsistencies in the way different browsers render markup as well as differences due to the DocType specified for the page. This can be a particular problem when a "strict" DocType is specified but the markup is created based on an older "transitional" ("quirks" mode) DocType.

 

Solution: Ensure that theme and portlet output are consistent with the DocType specified by the theme the page uses. Either set the theme to use a different DocType or update the rendered markup to be compatible with the selected DocType.

 

Problem: In Internet Explorer, using the Enter key to select a Browse button causes a portlet error.

In Internet Explorer, when you highlight a Browse button by tabbing and try using the Enter key to bring up the browse window, the form is submitted instead. This causes a portlet error. Instead of using the Enter key, select the Browse button by tabbing and then use the space bar to bring up the file browser window.

 

Parent topic:

Search the product documentation for a solution