Technical Note Revision History

Date

Description of Changes

August 2, 2006

Corrected Web Server parameters in the amconfigcommx file.
Corrected file name to /etc/opt/SUNWam/config/AMConfig.properties and
parameter to com.iplanet.am.directory.host=DS_SERVER_HOSTNAME_FQDN in
Step 5 of the task “To Troubleshoot Communications Express.”

June 2, 2006

Re-issue of this technical note for Sun Java Enterprise System 2005Q4.

Troubleshooting Communications Express Installation
and Configuration

Currently, installing and configuring Communications Express is not
trouble-free. This seems especially true for a two-tiered deployment, with
Communications Express on a front-end host separate from a back-end Access
Manager host.

The following problem topics will aid you in troubleshooting your deployment:

To Troubleshoot Communications Express

Check if the Web Server runtime owner is root:other.
That is, the runtime owner should be the same for Access Manager, Access Manager
SDK, and Communications Express. It is preferred that the runtime owner be root:other.

If the runtime owner for Web Server is not root (but webservd), then do the following:

Change the ownership of the /opt/SUNWwbsvr/https-host.domain directory
to root:other (recursively).

Edit the /opt/SUNWwbsvr/https-host.domain/config/magnus.conf file
and change the line containing “user webservd”
to “user root”.

Restart Web Server.

Check the Access Manager SDK by running the following command
from the front-end AM SDK location (host).

If Step 2 does not work as expected, then check that the Access
Manager SDK classpath is correct in the Web Server on the Communications Express
host (that is, the front end).

Make sure that /opt/SUNWam/lib/am_services.jar, /opt/SUNWam/lib/am_sdk.jar, and /opt/SUNWam/lib/am_sso_provider.jar are in the classpath suffix of the /opt/SUNWwbsvr/https-host.domainconfig/server.xml file.

Note –

Manually editing the server.xml file is generally
not recommended. The correct way is to use the /opt/SUNWam/bin/amconfig command.
See Problem: Web Server Exceptions.

Create a new state file similar to the following for the Access
Manager SDK configuration.

Change to the directory that contains the amconfig input
file template, amsamplesilent.

#
cd /opt/SUNWam/bin

Copy the input template file to a new file.

#
cp amsamplesilent amconfigcommx

Edit the amconfigcommx file to set the Access
Manager SDK configuration parameters as follows (non-default values are shown
in bold):

In an Access Manager deployment, check that the LDAP service property
values are valid.

Log in to the Access Manager console as amAdmin.

Under Identity Management, click the appropriate organization.

Choose Services from the View menu.

The services list
should have at a minimum Authentication Configuration, and Authentication
Modules Core and LDAP. Click the LDAP Properties arrow and verify the information
that appears in the Data pane.

If the service is not added, continue with the steps that follow.

Click Add in the Navigation pane.

A list of available
services is displayed in the Data pane.

Select the checkbox for Authentication Configuration and click
OK.

The Authentication Configuration service will appear in the
Navigation pane assuring you that it has been added.

Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional,
related information.

Note –

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 Welcomes Your Comments

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-5198.