Symptoms

When you log into POA Provider or Reseller Control Panel, the Guides link in the top right corner of the Control Panel is not displayed. If you login via PBA, for example, using the To Control Panel link in a reseller account properties, the Guides link is displayed:

Cause

The incorrect locale is explicitly defined in the login link. For example, the correct name of locale is en_US (list of currently configured locales can be found in the POA Provider Control Panel at System Director > Configuration Manager > Internationalization & Localization), and you log into POA using the link like below:

https://cp.provider.com/servlet/Turbine/frm/single/action/PLoginHandler?event1234submit=doLogin&user=admin&password=****renderEnv=undefined&lang=en

The important part here is lang=en in the end of the URL, it is not the correct name of the locale.

The name of the locale in the Control Panel URL is used to find the following files on POA User Interface (UI) server:

  1. help.properties - defines whether the Guides link should be displayed at all
  2. help-contents.vm - defines what is displayed when you go to this link

The files are different for the Provider and resellers. For example, below is a failed attempt to find the first file for Provider's user (excerpt from the poa-ui.log file):

2013-09-04 17:01:46,652 fc6985d496 ssor7 DEBUG  OUT                  PEMHelpURL: /usr/local/pem/ui/pem/resources/en/help/admin/help.properties
2013-09-04 17:01:46,652 fc6985d496 ssor7 DEBUG  OUT                  FilesCache:Need to check:/usr/local/pem/ui/pem/resources/en/help/admin/help.properties
2013-09-04 17:01:46,652 fc6985d496 ssor7 DEBUG  OUT                  FilesCache:No file
2013-09-04 17:01:46,652 fc6985d496 ssor7 DEBUG  OUT                  HU: no help.properties

In the case above the Guides link will not be displayed.

Below is the successful attempt to find both files for a reseller:

2013-09-04 17:34:05,596 76ed12d5b5 sor16 DEBUG  OUT                  PEMHelpURL: /usr/local/pem/ui/pem/resources/en_US/help/reseller/help.properties
2013-09-04 17:34:05,596 76ed12d5b5 sor16 DEBUG  OUT                  FilesCache:Need to check:/usr/local/pem/ui/pem/resources/en_US/help/reseller/help.properties
2013-09-04 17:34:05,597 76ed12d5b5 sor16 DEBUG  OUT                  PEMHelpURL: /usr/local/pem/ui/pem/resources/en_US/help/reseller/help-contents.vm

In this case, the Guides link will be displayed.

Resolution

Use the correct locale parameter when logging to POA Control Panel (in the example above it would be lang=en_US) or do not use this parameter at all.

Internal content