This technical note addresses the post-installation configuration issues for Sun JavaTM System Portal Server Secure Remote Access (SRA) 7. The document contains a list of common issues that occur during and after the configuration of Portal Server SRA 7 and the solutions to address them.
This technical note addresses issues in the following products:
Sun Java System Portal Server 7
Sun Java System Portal Server Secure Remote Access 7
This technical note contains the following sections:
Description of Changes
Initial release of this technical note.
Some error messages displayed during the installation and configuration of Portal Server SRA 7 may not allow you to install and configure the product properly.
The following are some of the configuration and installation issues:
When you select the Start Instance After Install check box in any of the SRA screens during installation, the configurator fails to start the portal instance after installation and the Sun Java System installer displays an error message about the configuration failure.
Check the installer logs to verify whether the configuration or the start of the portal instance failed. If the instance failed to start, then the installation and configuration of Sun Java System is correct. Now, use the psadmin command to start the instance manually.
This incorrect display of error message is fixed in the Sun Java System 5 Portal Server SRA 7.1 release.
Sun Java System Portal Server 7 uses JMX (Java Management Extensions) for management of all servers. Since Cacao is an implementation of the JMX API, it requires a Local Directory Server to run Portal Server 7.
The Cacao server stores metadata in an LDAP (Lightweight Directory Access Protocol) server and needs access to the LDAP server for starting. The gateway is deployed in the DMZ (Demilitarized Zone), and the firewall blocks LDAP access to the gateway host. As a workaround, install a local directory server in the DMZ on the gateway node. Note that the LDAP server does not include all the corporate data but only the bootstrap metadata for Cacao to start.
To install the gateway on a standalone node:
Install a local directory server.
Provide information about the local directory server or about the Portal Directory Server on the gateway screens.
Sun Java System 5 Portal server SRA 7.1 release does not require a Local Directory Server in the DMZ for Cacao to start.
When you configure the Portal Server 7 gateway, the configurator tries to record configuration information into the LDAP server on the intranet. For this purpose, the Cacao server on the intranet connects to the Cacao server running on the Portal Server node, which copies data to the LDAP server. For this data transfer to happen, an explicit trust must be established between the Cacao servers on the intranet gateway node and the Portal Server node. Trust can be established by copying the security folder from the Cacao install on the portal node to the security folder on the Cacao install on the gateway node.
The manual step to establish trust between two nodes is automated in the Sun Java System 5 Portal Server SRA 7.1 release.
Yes. Both Access Manager and Directory Server are required for a two session installation of Portal Server 7. However, you can install them in one session if the Access Manager and Directory Server reside on the same node.
A profile is created in the PSConsole and includes SRA proxy server configuration information. An instance is a combination of a hostname and a profile.
For example, create a profile nameddefault. You can create a gateway instance on host A and a netlet proxy instance on host B with the same name, default. Both instances use the configuration information in the profile default, since the name of the instance and the profile are same.
In the above scenario, it is possible to use the same profile for multiple instances of SRA proxy servers on multiple hosts.
Use the psadmin list-sra-instances command to list all the known profiles along with the available instance information.
Netlet and Rewriter proxies need to be enabled with the help of PSConsole after the installation.
Successful installation and configuration of Sun Java System Portal Server SRA 7 does not mean that the gateway uses Netlet and Rewriter proxies. Manually configure the specific gateways to use the required proxies.
To access PSConsole through the gateway:
Tag replace the request file, enablePSConsoleFromGW.xml with appropriate values.
Load the request file into the Directory Server using amadmin —u <adminuser> —w <ampassword> —t enablePSConsoleFromGW.xml command.
For gateway, netlet, and proxylet to work properly:
Tag replace the request file, enableSRAforPortal.xml with appropriate values.
Load the request file into the Directory Server using amadmin —u <adminuser> —w <ampassword> —t enableSRAforPortal.xml command.
See the Sun Java System Portal Server 7 Release Notes at the following URL to find out about known problems:
If you have problems with Sun Java System Portal Server SRA 7, contact Sun customer support using one of the following mechanisms:
Sun Software Support services online athttp://www.sun.com/service/sunone/software.
This site has links to the Knowledge Base, Online Support Center, and ProductTracker, as well as to maintenance programs and support contact numbers.
The telephone dispatch number associated with your maintenance contract.
So that we can best assist you in resolving problems, please have the following information available when you contact support:
Description of the problem, including the situation where the problem occurs and its impact on your operation
Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
Detailed steps on the methods you have used to reproduce the problem
Any error logs or core dumps
The http://docs.sun.com web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. Books are available as online files in PDF and HTML formats. Both formats are readable by assistive technologies for users with disabilities.
To access the following Sun resources, go to http://www.sun.com:
Downloads of Sun products
Services and solutions
Support (including patches and updates)
Communities (for example, Sun Developer Network)
Third-party URLs are referenced in this document and provide additional, related information.
Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.
Sun is interested in improving its documentation and welcomes your comments and suggestions. To share your comments, go to http://docs.sun.com and click Send Comments. In the online form, provide the full document title and part number. The part number is a 7-digit or 9-digit number that can be found on the book's title page or in the document's URL. For example, the part number of this book is 819-6448-10.