Sun Java Enterprise System 2005Q1 Release Notes for HP-UX |
Sun Java Enterprise System Release Notes for HP-UX
Version 2005Q1
Part Number 819-1558-10
This document contains important information available at the time of release of Sun Java Enterprise System 2005Q1 for HP-UX. Known limitations and problems, installation notes, and other information are addressed here. Read this document before installing the Sun Sun Java Enterprise System software.
These release notes can be found at the Sun Java Enterprise System documentation web site at http://docs.sun.com/coll/entsys_05q1. Check the web site before installing and setting up your software and then periodically thereafter to view the up-to-date release notes and product documentation.
This document contains the following sections:
Third-party URLs are referenced in this document and provide additional, related information.
Release Notes Revision History
About Sun Java Enterprise System 2005Q1 for HP-UXThis section contains the information you need to install the Sun Java Enterprise System software in a HP-UX operating environment. This section covers the following topics:
Sun Java Enterprise System Components for HP-UX
The following components are supported in the HP-UX version of Sun Java Enterprise System:
- Sun Java System Access Manager 6 2005Q1
- Sun Java System Administration Server 8 2005Q1
- Sun Java System Application Server 8 2005Q1
- Sun Java System Calendar Server 6 2005Q1
- Sun Java System Directory Proxy Server 5 2005Q1
- Sun Java System Directory Server 5 2005Q1
- Sun Java System Instant Messaging 7 2005Q1
- Sun Java System Message Queue 3 2005Q1
- Sun Java System Messaging Server 6.2 2005Q1
- Sun Java System Portal Server 6 2005Q1
- Sun Java System Web Server 6.1 SP4 2005Q1
Unsupported Components on HP-UX
Sun Java Enterprise System on HP-UX does not support the following components and features:
Hardware and Software Requirements
This HP-UX release of Sun Java Enterprise System is supported only on HP-UX 11i (11.11) PA-RISC platforms. The following requirements are discussed in this section:
Hardware Requirements
Operating System Requirements
The table below lists the operating system requirements in Java Enterprise System 3 for HP-UX.
Table 2 Operating System Requirements for HP-UX in Java Enterprise System 3 .
Platform
Minimum Hardware
Hardware Recommended
Minimum RAM
RAM Recommended
Swap Space
HP-UX11.11
PA-RISC 800MHz
PA-RISC 1GHz
1 GB
2GB
2GB
RAM And HDD Requirements
For Sun Java Enterprise System to be installed on an HP-UX system, the following criteria should be met:
Space and Memory Requirements
Sun Java Enterprise System and its associated components requires a minimum of 2 Gbytes of disk space. The following table lists the space and memory requirements for the various components.
For more information on disk space and RAM requirements, refer to the respective release notes listed in Bugs Fixed in This Release.
Software Requirements
HP-UX Software Group Requirement
This HP-UX release of Sun Java Enterprise System requires the following Perl programming language packages:
Perl (B.5.6.1.F) HP-UX11i
Java 2 Standard Edition Requirement
This HP-UX release of Sun Java Enterprise System is certified with Java 2 Standard Edition (J2SE) 1.5.0 from Hewlett Packard.
Install Java 2 Standard Edition (J2SE) 1.5.0 (JDK and JRE) before running Sun Java Enterprise System 2005Q1 installer or installing any of its components.
Bugs Fixed in This ReleaseNone.
Important InformationThis section covers the following topics:
Component Release Notes
All information on specific Sun Java Enterprise System components appears in the respective component release notes. Release notes for the components can be found at:
http://docs.sun.com/coll/entsys-hp-05q1
- Access Manager 6 2005Q1 Release Notes for HP-UX
http://docs.sun.com/doc/819-1559
- Administration Server 5 2005Q1 Release Notes for HP-UX
- Application Server Enterprise Edition 8 2005Q1 Release Notes for HP-UX
http://docs.sun.com/doc/819-1561
- Calendar Server 6 2005Q1 Release Notes for HP-UX
HP-UX Patch Requirements
This section covers the following topics:
Getting HP-UX Patch Updates for Sun Java Enterprise System
To find the patch requirements for a particular Sun Java Enterprise System component, refer to the respective release notes listed in Bugs Fixed in This Release.
To get HP-UX 11.11i Patches
- Go to http://www.itrc.hp.com
- Click Login in the IT Resource panel.
The Login/Register page appears.
If you do not have a login you need to create one:
- Enter your User ID and password and click Login.
The IT Resource page appears.
- Click Patch/firmware database under the Maintenance and support (HP products) section.
The patch/firmware database page appears.
- Enter the patch name that you need to download under the Find a specific patch section.
For example: Access Manager needs PHSS_30966 to be installed. When you do a search for this patch, the following results are displayed:
- Select the version of the patch you want to download.
- Click Add to the selected patch list.
The Download option for that patch is displayed.
- Follow the instructions given in the download option to install the required patch.
HP-UX Packages Required to Run Java Enterprise System Components
The following system packages also need to be installed for some of the Java Enterprise System components to be run on HP-UX:
HP-UX Patch Level Equivalents With Solaris
All Java Enterprise System 2005Q1 components for HP-UX correspond to the same source code level as the initial Java Enterprise System 2005Q1 release on Solaris, except where stated below. In the list below the patch level quoted for each component is the equivalent of that in Solaris version:
Support for Netscape Security Services 3.9.5
Version 3.9.5 of the Netscape security libraries is included in Sun Java Enterprise System. Directory Server, Directory Proxy Server, and Administration Server depend on the version of the libraries installed under /opt/sun/private/lib.
HP-UX Installation NotesThe procedures and tasks of installing Sun Java Enterprise System in the HP-UX environment are quite similar to the instructions for installing in the Solaris environment. For all basic Sun Java Enterprise System installation instructions, refer to the Sun Java Enterprise System Installation Guide (http://docs.sun.com/doc/819-0056).
However, there are some installation differences for HP-UX. The following sections describe issues and tasks that are specific to HP-UX:
Features That Are Not Supported
Java Enterprise System on HP-UX does not support Sun Cluster, Sun Remote Services Net Connect, third party web containers (BEA WebLogic or IBM WebSphere), or Apache and IIS web servers.
Getting the Sun Java Enterprise System Software
- Go to the Sun web site:
http://www.sun.com/software/javaenterprisesystem/index.xml
- Download the HP-UX zip file.
- Unzip the file:
unzip java_es-05Q1-rr-hpux.zip
The directory folder will be HPUX_PA-RISC.
Note
Before you install Java ES on HP-UX, read Part I, "Installation Planning," in the Sun Java Enterprise System 2005Q1 Installation Guide at http://docs.sun.com/source/819-0056/part1_prepare.html#wp2844
The following table lists the items in a Sun Java Enterprise System HP-UX distribution.
Directory, Command, and Path Equivalencies
The following tables list the HP-UX directories, commands and paths equivalent to Solaris.
Default Installation Directories for Sun Java Enterprise System Components
The Sun Java Enterprise System installer automatically installs components in default directories unless you specify otherwise. In most cases, you can specify a custom location to override a default location when you are using the Configure Now option.
Installation directories for the following components have restrictions:
- Directory Server. You cannot specify the installation location for Directory Server. However, you can specify the location for Directory Server runtime configuration data.
- Portal Server Secure Remote Access. Portal Server Secure Remote Access Core must be installed into the same location as Portal Server.
- Message Queue. You cannot change the location of the installation directories.
The following table lists the default installation directories for the Sun Java Enterprise System components.
Installable Packages
The following sections list the HP-UX 11.11i packages installed by the Sun Java Enterprise System installer:
Uninstall Packages for Java Enterprise System on HP-UX
The following table lists the uninstall packages for Sun Java Enterprise System.
Table 8 Uninstall Packages for Java Enterprise System on HP-UX
Component
Packages
Uninstall program
sun-entsys-uninstall
sun-entsys-uninstall-l10n
Java Enterprise System Packages on HP-UX Installed for Components
This section lists installed Java Enterprise System packages on HP-UX for each Sun Java Enterprise System component.
Access Manager HP-UX Packages
Administration Server HP-UX Packages
Application Server HP-UX Packages
Calendar Server HP-UX Packages
Communications Express HP-UX Packages
Table 13 Communications Express Packages for HP-UX
Component
Packages
Communications Express
sun-uwc
Locale packages
sun-uwc-de
sun-uwc-es
sun-uwc-fr
sun-uwc-ja
sun-uwc-ko
sun-uwc-zh_CN
sun-uwc-zh_TW
Directory Server HP-UX Packages
Directory Proxy Server HP-UX Packages
Instant Messaging HP-UX Packages
Message Queue HP-UX Packages
Messaging Server HP-UX Packages
Portal Server HP-UX Packages
Portal Server Secure Remote Access HP-UX Packages
Web Server HP-UX Packages
Java Enterprise System Packages on HP-UX Installed for Shared Components
The following table lists the names of the HP-UX packages distributed for each shared component.
Post-installation Configuration
When the Sun Java Enterprise System installer finishes installation, most components require that you perform additional configuration tasks before the Sun Java Enterprise System environment is operational. The extent of the tasks depends on the configuration type you selected (Configure Now or Configure Later), and whether or not your components will be configured with the Sun Cluster software.
This section contains the differences between HP-UX and Solaris as in the Sun Java Enterprise System Installation Guide (http:/docs.sun.com/doc/819-0056):
Installed Packages
Before acting on the information in this chapter, you should have completed the installation of the Sun Java Enterprise System components. You can use the swlist command to verify that the component packages have been installed. A list of packages associated with the components is contained Installable Packages
MANPATH Setup
If your components have man pages, you will need to verify that your MANPATH environmental variable is set correctly. After installation, the man pages for the Sun Java Enterprise System components are located in default directories. In some cases, the correct location for the component man pages is already set in your MANPATH environment variable. If the location of your man pages is present, you do not need to take any action. If the location of your man pages is not present, you need to add it to your MANPATH environment variable.
The following table indicates the default locations for the man pages of the Sun Java Enterprise System components. If a component is not listed, the component does not have man pages.
To Update Your MANPATH Variable
The following example shows how to verify that the man pages are available in the C shell:
- On the command line, check your MANPATH environment variable to see if the correct path is already there.
env
- If the correct path is not there, add the location of your Sun Java Enterprise System component man pages to your MANPATH environment variable.
Update the /etc/MANPATH file with the required MANPATH. For example, add this line to the /etc/MANPATH file:
/opt/sun/man
The new man pages will be fully accessible, regardless of path.
- Verify that the man pages are accessible. For example, the following commands should display the asadmin man page for Application Server:
man asadmin
Configure Now Option: Procedures
If you selected the Configure Now option during installation, you were asked to specify configuration values during the installation session. Some of the components that were configured during installation require additional configuring as described in this section. A summary report containing the values that were set during installation is available:
/var/opt/sun/install/logs
The following sections detail the configurations necessary for the particular Sun Java Enterprise System components. If your component does not require additional configuration after a Configure Now installation, proceed to Starting and Stopping Components to verify configuration.
The following sections contain postinstallation configuration information for the Configure Now option:
Configuring Access Manager After a Configure Now Installation
Although you can start Sun Java System Access Manager and log into the Access Manager console immediately after running the Sun Java Enterprise System installer, you cannot perform basic user management operations until you complete some final configuration steps. These steps differ depending on whether or not Access Manager is using a Sun Java System Directory Server instance that is already provisioned with user data.
The next sections explain what to do in the following cases:
When Directory Server is Provisioned With User Data
When Directory Server is already provisioned with user data, refer to “Configuring Access Manager with a Provisioned Directory Server” in the Sun Java System Access Manager Migration Guide, http://docs.sun.com/doc/817-5708, for a description of the final configuration steps.
When Directory Server is Not Yet Provisioned With User Data
When Directory Server is not provisioned with user data, perform the steps in the following sections:
Caution
Before performing the tasks in this section, ensure that Directory Server is configured and running.
Enabling the Referential Integrity Plug-in
When the referential integrity plug-in is enabled, it performs integrity updates on specified attributes immediately after a delete or rename operation. This ensures that relationships between related entries are maintained throughout the database.
To Enable the Referential Integrity Plug-in
- In Directory Server console, click Configuration.
- In the navigation tree, double-click Plug-ins to expand the list of Plug-ins.
- In the Plug-ins list, click Referential integrity postoperation.
- In the properties area, check the Enable plug-in box.
- Click Save.
- Restart Directory Server to enable the plug-in.
Adding Access Manager Indexes
Database indexes enhance the search performance in Directory Server.
To Add Access Manager Indexes
- In Directory Server console, click Configuration.
- Add the nsroledn index.
- In the navigation tree, double-click the Data icon, then click the root suffix that contains the directory entries you want to use in Access Manager.
- Click the Indexes tab.
- Under Additional Indexes, for the nsroledn attribute, check the following checkboxes: Equality, Presence, and Substring.
- Click Save.
- In the Indexes window, after the index is successfully created, click Close.
- Add the memberof index.
- In the Indexes tab, click Add attribute.
- In the Select Attributes window, select the attribute memberof, then click OK.
- In the Indexes tab, for the memberof attribute, check the following checkboxes: Equality and Presence.
- Click Save.
- In the Indexes window, after the index is successfully created, click Close.
- Add the iplanet-am-static-group index.
- In the Indexes tab, click Add attribute.
- In the Select Attributes window, select the attribute iplanet-am-static-group, and then click OK.
- In the Indexes tab, for the iplanet-am-static-group attribute, check the following checkbox: Equality.
- Click Save.
- In the Indexes window, after the index is successfully created, click Close.
- Add the iplanet-am-modifiable-by index.
- In the Indexes tab, click Add attribute.
- In the Select Attributes window, select the attribute iplanet-am-modifiable-by, and then click OK.
- In the Indexes tab, for the iplanet-am-modifiable-by attribute, select the Equality checkbox.
- Click Save.
- In the Indexes window, after the index is successfully created, click Close.
- Add the iplanet-am-user-federation-info-key index.
- In the Indexes tab, click Add attribute...
- In the Select Attributes window, select the attribute iplanet-am-user-federation-info-key, then click OK.
- In the Indexes tab, for the iplanet-am-user-federation-info-key attribute, check the following checkbox: Equality.
- Click Save.
- After the index is successfully created, click Close in the Indexes window.
- Restart Directory Server.
Configuring Message Queue After a Configure Now Installation
Message Queue requires no additional configuration. However, a common optional task is to configure Message Queue for automatic startup. To perform this task, become superuser and edit properties in the imqbrokerd.conf configuration file (in /etc/opt/sun/mq). The properties to edit are:
- AUTOSTART, which specifies (YES or NO) if the broker is automatically started at boot time. The default value is NO.
- ARGS, which specifies command line options and arguments to pass to the broker startup command. See the Sun Java System Message Queue Administration Guide (http://docs.sun.com/doc/819-0066) for a listing and description of imqbrokerd command line options. (For example -name instanceName)
- RESTART, which specifies (YES or NO) if the broker is automatically restarted if it abnormally exits. The default value is YES.
Additional configuration for Message Queue is discussed in the Sun Java System Message Queue Administration Guide (http://docs.sun.com/doc/819-0066). For example, you might want to change the default administration password.
Configuring Portal Server After a Configure Now Installation
Final configuration steps for Portal Server depends on the Sun web container it is deployed.
If you are using Application Server or Web Server as the web container for Portal Server, you must apply changes to the instance. Use the instructions in Chapter 2, “Post Installation Configuration” of the Sun Java System Portal Server Administration Guide (http://docs.sun.com/app/secure/source/817-7691/postinst.html).
Configure Later Option: Procedures
If you selected the Configure Later option during installation, the Sun Java Enterprise System installer placed the component package files in their respective directories. No parameter setting was done, and most components are not operational because runtime services are not available.
A number of the components include configuration tools for completing a Configure Later installation. After running the configuration tools, you can make any additional changes by following the instructions in this guide and in the product documentation for each component.
The following sections contain postinstallation configuration information for the Configure Later option:
Configuring Access Manager After a Configure Later Installation
After a Configure Later installation, the packages are installed and you are ready to configure Access Manager using the Access Manager configuration script, identity_svr_base/bin/amconfig. Instructions for using this program are contained in the Sun Java System Access Manager Administration Guide, http://docs.sun.com/doc/817-7647.
Configuring Administration Server After a Configure Later Installation
After a Configure Later installation, packages are installed and you are ready to begin Administration Server configuration.
To Configure Administration Server After a Configure Later Installation
- Start the configuration utility. For example,
/opt/sun/sbin/mpsadmserver configure
Follow the instructions on each screen.
- Ensure that access permissions for the files under <server root>/alias have been set to prevent access by all user accounts other than those of the servers installed there.
- Verify the common server settings and the Administration Server settings.
Update the settings as needed. Information on these setting can be found in the Sun Java System Administration Server Administration Guide (http://docs.sun.com/doc/817-7612).
Note
If Administration Server was installed with Access Manager, most of the configuration in Step 3 was completed during installation.
Configuring Application Server After a Configure Later Installation
After a Configure Later installation, packages are installed and you are ready to begin Application Server configuration.
To Configure Application Server After a Configure Later Installation
Configuring Calendar Server After a Configure Later Installation
Calendar Server cannot be configured by the Sun Java Enterprise System installer.
To Configure Calendar Server After a Configure Later Installation
- Configure Directory Server for communications services (Calendar Server, Messaging Server and the Delegated Administrator Utility) by running the Directory Preparation Script (comm_dssetup.pl).
Note
Skip this step if you have already run the Directory Preparation Script on the same Directory Server during configuration of another communications component.
- Verify that Directory Server is running.
- On the machine where Directory Server is installed, run the Directory Preparation Script:
perl comm_dssetup.pl
- When prompted by the script, select Schema 2 Native Mode as the schema type unless you need to retain compatibility with previous versions of Calendar Server, Messaging Server, or custom applications. For more information about making the appropriate choice, see Chapter 2, “Configuring Your LDAP Directory,” in the Sun Java System Communications Services Delegated Administrator Guide (http://docs.sun.com/doc/819-0114).
- Verify that the second column in the /etc/hosts file contains the fully-qualified domain name (FQDN) rather than a simple host name. For example:
192.18.99.999 mycomputer.company.com loghost
- If you intend to use Delegated Administrator to provision users for Calendar Server, you must perform additional steps to configure Delegated Administrator. Instructions for configuring the utility and provisioning users are contained in the Sun Java System Communications Services Delegated Administrator Guide (http://docs.sun.com/doc/819-0114).
Caution
Consider this step only if your installation includes Access Manager and LDAP Schema 2, and if this step was not done during configuration of another communications component.
- Configure Calendar Server by running the Calendar Server configuration program,
cal_svr_base/calendar/sbin/csconfigurator.sh.For information on configuring Calendar Server, refer to the Sun Java System Calendar Server Administration Guide, http://docs.sun.com/doc/819-0024.
Configuring Communications Express After a Configure Later Installation
Communications Express cannot be configured by the Sun Java Enterprise System installer.
To Configure Communications Express After a Configure Later Installation
- Configure Communications Express for communications services (Calendar Server, Messaging Server and the Delegated Administrator Utility) by running the Directory Preparation Script (comm_dssetup.pl).
Note
Skip this step if you have already run the Directory Preparation Script on the same Directory Server during configuration of another communications component.
- Complete configuration using the Communication Express configuration program, uwc_base/sbin/config-uwc. Instructions are in Chapter 2, “Installing and Configuring Communications Express” in the Sun Java System Communications Express Administration Guide (http://docs.sun.com/doc/819-0115).
Configuring Directory Server After a Configure Later Installation
After a Configure Later installation, the packages are installed and you are ready to perform the configuration tasks for Directory Server.
To Configure Directory Server After a Configure Later Installation
- Start the configuration utility. For example:
/opt/sun/sbin/directoryserver -u 5.2 configure
Follow the instructions on each screen.
- (Optional) Many command-line scripts written in Perl can read the bind password interactively (-w option). To enable this functionality, do the following:
- Install the Term::ReadKey Perl module, available separately from CPAN (http://cpan.org).
- Edit each Perl script to read the bind password interactively by uncommenting the appropriate lines.
All other Perl script functionality remains available without the Term::ReadKey module.
- Verify the common server settings and the Directory Server settings.
Update the settings as needed.
Configuring Directory Proxy Server After a Configure Later Installation
After a Configure Later installation, the packages are installed and you are ready to perform the configuration tasks for Directory Proxy Server.
To Configure Directory Proxy Server After a Configure Later Installation
- Configure the Directory Proxy Server instance using the quickstart.tcl script. For example:
# /opt/sun/directory-proxy-server/5.2/bin/tcl8.2/tclsh /opt/sun/directory-proxy-server/5.2/bin/dps/install/script/quickstart.tcl -cid <cid_path> -serverroot <serverroot_path> -listen <DPS port number> -password <password> -userID <admin user id>
The arguments of the quickstart.tcl script are described in the following table.
- Verify the common server settings.
- Update the common server settings for Directory Proxy Server.
- Verify the Directory Proxy Server configuration.
- Start the Directory Proxy Server.
Configuring Instant Messaging After a Configure Later Installation
Instant Messaging cannot be configured by the Sun Java Enterprise System installer. When you install the server, the multiplexor is also installed and enabled. If you want to support only a multiplexor on a host, you must disable the server installed on that host. For instructions, refer to the Sun Java System Instant Messaging Administration Guide (http://docs.sun.com/doc/819-0430).
Instructions for using the Instant Messaging configure utility, im_svr_base/configure, are contained in Chapter 1, “Configuring Instant Messenger After Installation” in the Sun Java System Instant Messaging Administration Guide (http://docs.sun.com/app/secure/source/819-0430/PostInstallAdm.html).
Configuring Message Queue After a Configure Later Installation
The Message Queue component requires no additional configuration. However, a common optional task is to configure Message Queue for automatic startup. For instructions on performing this task, refer to Configuring Message Queue After a Configure Now Installation.
Configuring Messaging Server After a Configure Later Installation
Messaging Server cannot be configured by the Sun Java Enterprise System installer.
To Configure Messaging Server After a Configure Later Installation
- Configure Directory Server for communications services (Calendar Server, Messaging Server and the Delegated Administrator Utility) by running the comm_dssetup.pl script.
Note
Skip this step if you have already run the Directory Preparation Script on the same Directory Server during configuration of another communications component.
- Verify that Directory Server is running.
- On the machine where Directory Server is installed, run the Directory Preparation Script:
perl /opt/sun/comms/dssetup/sbin/comm_dssetup.pl
- When prompted by the script, select Schema 2 Native Mode as the schema type unless you need to retain compatibility with previous versions of Calendar Server, Messaging Server, or custom applications. For more information about making the appropriate choice, see Chapter 7, “Understanding Messaging Server Schema and Provisioning Options,” in the Sun Java System Communications Services Deployment Planning Guide (http://docs.sun.com/doc/819-0063).
- Verify that the second column in the /etc/hosts file contains the fully-qualified domain name (FQDN) rather than a simple host name. For example:
192.18.99.1 mycomputer.company.com loghost
- If you intend to use Delegated Administrator to provision users for Messaging Server, you must perform additional steps to configure Delegated Administrator. Instructions for configuring the utility and provisioning users are contained in the Sun Java System Communications Services Delegated Administrator Guide (http://docs.sun.com/doc/819-0114).
Caution
Consider this step only if your installation includes Access Manager and LDAP Schema 2, and if this step was not done during configuration of another communications component.
- Configure Messaging Server by running the initial runtime configuration program for Messaging Server, msg_svr_base/sbin/configure.
For information on configuring Messaging Server, refer to the Sun Java System Messaging Server Administration Guide (http://docs.sun.com/doc/819-0105).
Configuring Portal Server After a Configure Later Installation
Final configuration steps for Portal Server depends on the Sun web container it is deployed.
Configuring Portal Server After a Configure Later Installation on Application Server or Web Server
Portal Server provides a common configurator that can be used to configure all Portal Server subcomponents as well as Portal Server Secure Remote Access.
To Configure Portal Server After a Configure Later Installation on Application Server or Web Server
- Create a runtime configuration for Portal Server by running the Portal Server configurator, portal_svr_base/lib/configurator.
Instructions for running the configurator as well as descriptions of the settings used by the configurator are contained in the “Minimal Installation Configuration” section in Chapter 2 of the Sun Java System Portal Server Administration Guide (http://docs.sun.com/doc/817-5324).
- Apply changes to the instance. Use the instructions in the “Portal Server Post-Installation Tasks” section in Chapter 2 of the Sun Java System Portal Server Administration Guide (http://docs.sun.com/doc/817-5324).
Configuring Web Server After a Configure Later Installation
After a Configure Later configuration installation, the packages are installed and you are ready to configure Web Server.
To Configure Web Server After a Configure Later Installation
Update the settings as needed. Additional information on these settings can be found in the Sun ONE Web Server Installation and Migration Guide (http://docs.sun.com/doc/819-0131-10).
Starting and Stopping Components
This chapter provides instructions for starting and stopping Sun Java Enterprise System components that have been installed and configured. You can use the procedures in this section to verify that components are operational.
This chapter includes the following sections:
Prerequisites
Before using the procedures in this chapter, you should have completed all the post-installation configuration tasks specified in Troubleshooting Installation Problems.
Startup Sequence for Sun Java Enterprise System
To start Sun Java Enterprise System, you start the components one after another, in a specific sequence. You start with the basic services provided by Directory Server and your web container (Web Server or an application server). Sun Java Enterprise System creates runnable instances of these services during installation. Since Portal Server and Access Manager run inside the web container, they start when you start the web container.
The general sequence for bringing up the entire Sun Java Enterprise System component set is shown in the following table. The left column lists the order in which you should perform the startup, the middle column describes the task, and the right column lists the location of the instructions for performing the task.
Table 25 Preferred Startup Sequence for Sun Java Enterprise System
Order
Task
Location of Instructions
1
Start your directory server.
A. Start Directory Server.
B. Start Administration Server.
C. Start Server Console.
2
Start your chosen web container. Access Manager and Portal Server are started if they are installed.
Start Application Server (also starts Message Queue).
To Verify Access Manager and Portal Server on Application Server
Start Web Server.
3
Start Portal Server Secure Remote Access.
4
Start Instant Messaging.
5
Start Messaging Server.
6
Start Calendar Server.
7
Start Directory Proxy Server.
To shut down the entire Sun Java Enterprise System component set, reverse the sequence.
Starting and Stopping Access Manager
Access Manager depends on Directory Server and a web container. To verify Access Manager, you access your specific deployment configurations of Access Manager on the web containers:
This section contains the following procedures:
To Start Access Manager
To Verify Access Manager and Portal Server on Application Server
- Use the following URL to access the default page:
http://appserver-host:port/amconsole
The Access Manager login page appears.
- Log in.
Your login to Access Manager confirms successful deployment of Access Manager on Application Server. The default administrator account is amadmin. a new browser, use the following URL to display the sample Desktop:
http://server:port/portal
Display of the sample Desktop confirms successful deployment of Portal Server on Application Server.
For a mobile device:
http://server:port/portal/dt
To Verify Access Manager and Portal Server on Web Server
- Use the following URL to access the default page:
http://webserver-host:port/amconsole
The Access Manager login page appears.
- Log in.
Your login to Access Manager confirms successful deployment of Access Manager on Web Server.
- In a new browser, use the following URL to display the sample Desktop:
http://server:port/portal
Display of the sample Desktop confirms successful deployment of Portal Server on Web Server.
For a mobile device:
http://server:port/portal/dt
To Stop Access Manager
Starting and Stopping Administration Server
To verify Administration Server, start the Administration Server and the Console Server. Administration Server depends on Directory Server.
To Start Administration Server
To Stop Administration Server
To Start Server Console
- If necessary, configure the $DISPLAY variable to display the Console Server on your machine.
- Verify that the Administration Server processes are running. For example:
/usr/bin/ps -ef | grep admin-serv/config
- Enter the following:
/opt/sun/mps/serverroot/startconsole
- Verify that the Server Console process is running. For example:
/usr/bin/ps -ef | grep console
To Stop Server Console
Starting and Stopping Application Server
To verify Application Server, you need to start the Application Server instance, then start the graphical Administration interface and log in. Application Server depends on Message Queue.
To Start Application Server
- Navigate to application_svr_base/bin and enter this command:
% asadmin start-domain --user admin-id --password admin-password --domain domain-name
- Enter the values that you provided during installation.
A message is displayed telling you that the server is starting:
Starting Domain domain1, please wait. Log redirected to install_dir...
When the startup process has completed, an additional message is displayed:
Domain domain1 started
- Start individual Application Server instances. For example:
./asadmin start-domain --domain domain1
Note
If you receive a message indicating failure to start, configuration changes might not be applied yet. In this case, run the asadmin reconfig command. For example:
asadmin reconfig --user admin --password adminadmin --host\ localhost --port 4849 server
- Verify that the Application Server processes are running. For example:
/usr/bin/ps -ef | grep appserv
root 9888 9886 0 12:55:46 pts/tc 0:00 /bin/sh/var/opt/sun/appserver/nodeagents/sqe-agent/sqe-server/
root 9886 1 0 12:55:38 pts/tc 0:11 /opt/sun/appserver/lib/appservAgent sqe-agent
root 9898 9890 0 12:55:53 pts/tc 0:31 /opt/sun/appserver/lib/appserv sqe-server
root 9890 9888 0 12:55:46 pts/tc 0:00 /opt/sun/appserver/lib/appservLauncher/opt/sun/appserver/lib/a
root 9869 1 0 12:54:28 pts/tc 1:03 /opt/sun/appserver/lib/appservDAS sqe-domain
To Access the Application Server Graphical Interface
To verify that the server is running on your system, use the following URL format in your browser: https://localhost:port
Replace the localhost variable with the name of the system that the browser is currently running on. If Application Server software is running on another system, substitute the name of that system for localhost. Replace the port variable with the Domain Administration Server’s port number assigned during installation. The default port number is 8080. If you changed the port number during the installation, use that number instead. For example:
https://mycomputer.example.com:4849
You should see the Application Server Welcome page if the Domain Administration Server is running.
To Stop Application Server
Starting and Stopping Calendar Server
Calendar Server depends on Directory Server.
To Start Calendar Server
To Access the Calendar Server Graphical Interface
If you are already provisioned in the LDAP directory that Calendar Server points to, you can log into Calendar Server. In your browser, use the http://hostname.domain[:port] format to access Calendar Server. For example:
http://mycomputer.example.com:8000
At initial login, Calendar Server creates a default calendar for you. Your login to Calendar Server confirms successful installation.
To Stop Calendar Server
Starting and Stopping Communication Server
Unified Web Client depends on webcontainer (WebServer/Application Server). It is an integration application for Calendar Server, Messaging Server And Address Book. As it is a client Program, there is nothing to start and stop.
To Access the Unified Web Client Graphical interface
- Navigate to uwc_svr_base/uwc/sbin
- Configure Unified Web Client
./config-uwc (Refer to the Administration Document of UWC)
- Restart webserver for deployment to take place.
- In your browser, use the
http://hostname.domain[:webport]/deployed-uri format to access UWC.
For example: http://mycomputer.example.com:80/uwcStarting and Stopping Directory Server
If Directory Server is part of a cluster, verify that you are working on the active node for the logical host. Directory Server has no dependencies.
To Start Directory Server
To Stop Directory Server
Starting and Stopping Directory Proxy Server
Log in as root if the server runs on ports less than 1024. On ports greater than 1024, log in either as root or with the server's administrator account. Directory Proxy Server depends on Administration Server.
To Start Directory Proxy Server
- Navigate to <DPS Server root>/dps-instance-name (instance-name is usually machine name). For example, the default is:
/opt/sun/mps/serverroot/dps-host1
- Start the Directory Proxy Server process.
./start-dps
- Verify that the Directory Proxy Server process is running. For example:
/usr/bin/ps -ef | grep dps
To Stop Directory Proxy Server
Starting and Stopping Instant Messaging
Instant Messaging depends on Directory Server and Web Server.
To Start Instant Messaging
Note
There are many ways to start the Instant Messaging client. For information, refer to the Sun Java System Instant Messaging Administration Guide (http://docs.sun.com/doc/819-0430).
To Stop Instant Messaging
Starting Message Queue
To Start Message Queue
Starting and Stopping Messaging Server
Messaging Server depends on Directory Server and Administration Server.
To Start Messaging Server
- Navigate to msg_svr_base/sbin.
- Start the Messaging Server processes.
./start-msg
- Verify that the Messaging Server processes are running. For example.
/usr/bin/ps -ef | grep messaging
/opt/sun/messaging/lib/enpd
/opt/sun/messaging/lib/stored -d
/opt/sun/messaging/lib/popd -d 5
/opt/sun/messaging/lib/imapd -d 5 -D 6
/opt/sun/messaging/lib/mshttpd -d 5 -D 6
/opt/sun/messaging/lib/dispatcher
/opt/sun/messaging/lib/job_controller
/opt/sun/messaging/lib/tcp_lmtp_server
/opt/sun/messaging/lib/tcp_smtp_server
/opt/sun/messaging/lib/tcp_smtp_server
/opt/sun/messaging/lib/imsched
/opt/sun/messaging/lib/watcher
Note that the list of processes varies according to the Messaging Server features you have configured use.
To Access Messenger Express
If you are already provisioned in the LDAP directory that Messaging Server points to, you can log into Messaging Server. In your browser, use the http://hostname.domain[:port] format to access Messenger Express.
For example:
http://mycomputer.example.com:8080
To Stop Messaging Server
Some Messaging Server processes might take several minutes to stop because they wait for their current transactions to complete.
Starting and Stopping Portal Server
The Portal Server startup and shutdown mechanisms are part of the startup and shutdown mechanisms for the web container (either Web Server or an application server). Portal Server depends on Directory Server, Access Manager or the Access Manager SDK, and a web container.
To verify Portal Server, go to the following sections:
Starting and Stopping Portal Server Secure Remote Access
Portal Server Secure Remote Access depends on Portal Server and Access Manager or the Access Manager SDK.
To Start Portal Server Secure Remote Access
- After installing the Gateway and creating the required profile, run the following command to start the Gateway:
/opt/sun/portal_svr/bin/gateway -n default start
The default is the default gateway profile that is created during installation.
You can create your own profiles later, and restart the Gateway with the new profile.
- Run the following command to check if the Gateway is running on the specified port:
netstat -a | grep port-number
The default Gateway port is 443.
To Stop Portal Server Secure Remote Access
Starting and Stopping Web Server
Web Server has no dependencies.
To Start Web Server
- Navigate to web_svr_base/https-admserv.
- Start the Web Server administration process.
./start
- Navigate to web_svr_base/https-hostname.domain.
- Start the Web Server instance.
./start
- Verify that the Web Server processes are running. For example:
/usr/bin/ps -ef | grep webservd
./webservd-wdog -r /opt/sun/webserver-d /opt/sun/webserver/https-admserv/config -n http
./webservd-wdog -r /opt/sun/webserver -d /opt/sun/webserver/https-host1.example.com
webservd -r /opt/sun/webserver -d /opt/sun/webserver/https-admserv/config -n https-admserv
webservd -r /opt/sun/webserver -d /opt/sun/webserver/https-admserv/config -n https-admserv
webservd -r /opt/sun/webserver -d /opt/sun/webserver/https-host1.example.com/config
webservd -r /opt/sun/webserver -d /opt/sun/webserver/https-host1.example.com/config
To Access the Web Server Graphical Interface
- In your browser, use the http://hostname.domain:port format to access the Web Server interface. For example:
http://host1.example.com:80
- Use the http://hostname.domain:adminport format to access the administration server. For example:
http://host1.example.com:8888
Your login to Web Server confirms successful installation.
To Stop Web Server
Troubleshooting Installation Problems
The following sections provide suggestions on how to resolve Sun Java Enterprise System installation and uninstallation problems:
General Troubleshooting Methods
This section provides general guidelines for tracking down the source of a problem. The following topics are addressed:
Examine Installation Log Files
If a problem occurs during installation or uninstallation, check the following log for problems relating to Sun Java Enterprise System Installer
For system related problems check the appropriate log files in the logs directory:
Most logs have two versions:
The following table lists the formats of the log files.
Table 26 Sun Java Enterprise System Log File Name Formats
Logged Entity
Log File Name Format
Installer: components
Java_Enterprise_System_install.Atimestamp
Java_Enterprise_System_install.Btimestamp
Java_Enterprise_System_Config_Log.id
Installer: shared components
Java_Enterprise_System_Shared_Component_Install.timestamp
Uninstall program
Java_Enterprise_System_uninstall.Atimestamp
Java_Enterprise_System_uninstall.Btimestamp
Java_Enterprise_System_Config_Log.id
Installation summary
Java_Enterprise_System_Summary_Report_install.timestamp
Java_Enterprise_System_Summary_Report_ uninstall.timestamp
Dependencies
Java_Enterprise_System_Dependency_Check_install.timestamp
Examining the uninstall and installer log files, along with the Sun Java Enterprise System configuration log and component logs, can help locate the source of uninstallation problems. For example, you can compare the packages listed in the installation log to the packages listed in the uninstallation log.
Many components write installation log files to the same directory. For more information about component log files, refer to Component Troubleshooting Information.
To use the log files for troubleshooting, attempt to isolate the first problem that occurred. Often, the first problem leads to successive problems. Use the following sequence:
The log files can give you clues that determine your next steps, such as these:
Examine Component Log Files
If a problem occurs starting a component, examine its log files. Many component log files are listed under Component Troubleshooting Information.
Verify Product Dependencies
A number of components have installation-time interdependencies. Problems that affect one component can affect other components. To check for unmet interdependencies, familiarize yourself with the information in Sun Java Enterprise System Installation Guide (http://docs.sun.com/doc/819-0056) How Do Component Interdependencies Affect My Installation? Next, check the following:
- Review the summary file and log files to see whether related products have failed. These might provide a clue as to what to fix first.
- Check that you have specified correct connection information. For example:
- Does the information that you provided when configuring Directory Server match the directory information you provided for components that use Directory Server?
- Does the Access Manager information that you provided for Portal Server or Portal Server SRA match the information you provided for Access Manager?
Check Resources and Settings
The following host-level issues can cause installation problems.
- Updates. Have you applied the recommended updates (patches)?
- Disk space. How is the disk partitioned, and to what partitions do installation directories point? The installation directories /var/opt and /etc/opt, /opt, /, /tmp or the non-default directories that you specify, need sufficient disk space.
- Network ports. During configuration, you supply port numbers for Sun Java Enterprise System components. Check the following:
- Examine the standard port numbers in the file /etc/services.
- Look at the summary log file to compare your settings with the standards. Did you mistype a port number or set one server to the port that is typically used for another?
- Use the command netstat -a to view current port use on the system. Did you assign a port number that was already in use?
- IP addresses. During configuration, you specify IP addresses. Check that you entered the correct IP addresses. These are some questions to resolve:
Run Verification Procedures
If you are having problems starting components, verify that component processes are running, then perform the verification procedures in Troubleshooting Installation Problems.
Check Directory Server Connectivity
If you are installing a component that relies on Directory Server, problems can be caused by one of these problems:
The interactive modes of the installer check for Directory Server connectivity during installation, but silent mode does not do so. If you perform a silent installation when Directory Server is not available, Access Manager or Portal Server could fail during installation.
Remove Web Server Files and Directory
To prevent the overwriting of customized files, such as edited configuration files, Web Server cannot be installed into a directory that contains files.
If you are reinstalling Web Server, check the installation directories to ensure that they are empty. If they are not empty, archive the files elsewhere and retry the installation.
Verify Passwords
The installer requires that you enter a number of passwords for components. If you are installing different components on different machines, it is important to ensure that you supply matching passwords on each machine.
To resolve password problems, you might need to uninstall and then reinstall. If the uninstall fails, refer to Installation Fails Due to Leftover Files During Uninstallation.
Examine the Installed or Uninstalled Components
If you have installed components but are having problems and cannot reinstall or uninstall, check the packages installed using HP-UX swlist command.
Verify Administrator Access
During uninstallation, you might need to grant administrator access to the uninstall program, as described in Sun Java Enterprise System Installation Guide (http://docs.sun.com/doc/819-0056) Administrator Access for the Uninstall Program. Make sure you provide the correct user IDs and passwords during uninstallation.
Installation Problems
This section addresses the following problems you might encounter during installation:
Installation Fails Due to Leftover Files During Uninstallation
If an uninstallation fails, it can leave behind components or packages. In such a case, you must manually remove the components or packages before you reinstall Sun Java Enterprise System. You might discover this problem in the following ways:
If you have removed all the product and shared components related directories and have not uninstalled the products then you need to uninstall all the products before proceeding to the installation again.
Installer Completes Installation but Product(s) Not Installed on Machine
The installer completes the installation according to the process but the products are not installed on your machine.This could probably be because of the product or products being uninstalled by user manually with swremove without using uninstaller.
Suggestion.
Installer/Uninstaller Hangs at Some Panel Without Any Exceptions
If the installer is abnormally terminated by the user during the installation process, it would create a lock file:
viz.
productregistry.access.lock
productregistry.access.tmp.This induces the installer/uninstaller to hang.
Suggestion.
/var/adm/swInstallation Fails Due to Dependencies
If some of the dependencies are not met, the installation fails. Refer to the following log to see the details of the failure
Suggestion.
Installation Fails When swagent is Busy
If swinstall or swremove commands run in parallel then installation fails.
Suggestion.
Unexpected External Error Occurs
A power failure or system failure might have occurred, or you might have entered CTRL/C to stop the installer process.
Suggestion.
If the failure occurred during the installation or configuration process, you are probably left with a partial installation. Run the uninstall program. If the uninstall program fails, follow the instructions under Uninstallation Fails, Leaving Behind Files.
Graphical Installer Seems Unresponsive
The installer sometimes creates an image on the screen before the image is ready for input. You cannot repeatedly click Next in the installation wizard without waiting.
Suggestion.
Silent Installation Fails: “State File is Incompatible or Corrupted”
If you are using a state file that was created on the same platform on which you are using it, the problem might be due to an unknown file corruption error.
Suggestion.
If you are using a state file that was created on a different platform or version, the problem is that state files must be run on the same type of platform on which they are created.
Suggestion.
Silent Installation Fails
If you edited the state file, you might have introduced errors. For example:, check the following:
Suggestion.
Terminal Echo Goes Off
When a user exits at password request timed out during Silent mode installation the Terminal Echo goes off.
Suggestion.
Man Pages Do Not Display
The most likely reason for man pages not displaying is that your MANPATH environment variable is not set correctly for the components you installed.
Suggestion.
Uninstallation Problems
This section discusses causes and solutions to the following uninstallation problems:
You Cannot Find the Uninstall Program
The Sun Java Enterprise System installation program places the uninstall program on your system at the following location:
If the uninstall program is not at that location, one of the following might have occurred:
Suggestion.
Manually clean up your system as described in Uninstallation Fails, Leaving Behind Files.
Uninstallation Fails, Leaving Behind Files
If manual cleanup is necessary because the uninstall program left behind files or processes, perform the following procedure to remove packages from your system.
To Manually Clean Up Packages
- Determine which packages you want to remove.
Compare the packages on your system with the Sun Java Enterprise System packages listed in Installable Packages. You can use the swlist command to determine which packages are installed.
- Stop all running processes for Sun Java Enterprise System components.
Brief instructions for stopping processes are contained in Starting and Stopping Components. The section on Component Troubleshooting Information provides some information on each component, with links to component documentation.
- Back up all custom configuration and user data if you plan to use in subsequent installations.
Chapter on Uninstallation Behavior for Sun Java Enterprise System Components in Sun Java Enterprise System Installation Guide (http://docs.sun.com/doc/819-0056) provides some information on configuration and user data that should be backed up. For more information, refer to the component documentation for each component.
- Use the swremove command to remove Sun Java Enterprise System component packages.
- Remove any remaining component directories and their content that you do not plan to use in subsequent installations. If you do plan to use these directories later, move them elsewhere.
- Update the product registry file, which is located here:
/var/adm/sw/productregistry
The uninstall program uses this registry to determine which components are installed on a host. Both the installer and uninstall program update the product registry upon completion of an installation or uninstallation.
Note
If you manually remove packages rather than using the uninstall program, then you must edit the product registry so it correctly reflects the software installed on your system.
- Clean up the log files for your system, which are located here:
/var/opt/sun/install/logs
The log files might not correctly reflect the state of your system after you manually remove packages.
Product Registry is Corrupted
During uninstallation, the uninstall program uses the product registry file to determine what needs to be uninstalled:
- If the uninstall program fails, you might need to retry after you restore the product registry from your backup copy.
- If you manually remove packages, the product registry is not automatically updated. When you subsequently run the uninstall program, you might encounter problems because the product registry does not correctly reflect your system. In this case, you can try to reinstall and then run the uninstall program again.
Uninstaller Cannot Connect to Configuration Directory Server
When uninstalling either the Administration Server or Directory Server, the uninstall program attempts to connect to the Configuration Directory Server using the administrator user ID and password supplied earlier when running the uninstall program. If the uninstall program cannot connect to the Configuration Directory Server, or if the administrator user ID and password are not valid, the uninstall program indicates that it cannot proceed by displaying an error message.
Suggestion.
Note
The following procedure assumes you have configured a Directory Server instance at the following location:
/opt/sun/mps/serverroot/slapd-Dir_Svr_Instance_Name
If you specified a different location, modify the instructions in the procedure accordingly.
To Troubleshoot and Complete Administration Server or Directory Server Uninstallation
- Make sure the Directory Server instance hosting the configuration directory is running. For example, search for the slapd process as follows:
/usr/bin/ps -ef | grep slapd
- If the Configuration Directory Server is not running, do the following:
- When the Configuration Directory Server is running, verify that you have a valid administrator user ID and password and proceed with the uninstallation.
- If you do not have a valid administrator user ID and password, the uninstall program stops and displays the following error:
Could not connect to Configuration Directory Server with administrator identity and password supplied
To continue with the uninstallation, manually unconfigure the Directory Server and/or Administration Server:
- Stop the Directory Server instance that is hosting the configuration directory. For example, with root privileges do the following:
/opt/sun/mps/serverroot/slapd-Dir_Svr_Instance_Name
./stop-slapd
- Run the following unconfiguration programs for Administration Server and Directory Server respectively:
/opt/sun/sbin/mpsadmserver unconfigure
/opt/sun/sbin/directoryserver -u 5.2 unconfigure
During unconfiguration, a notice appears informing you that the Configuration Directory Server cannot be contacted.
- Click Continue to continue with unconfiguration.
- After running the unconfiguration programs, proceed with uninstallation.
- You will be prompted for the administrator user ID and password.
- Supply any arbitrary value. These values will be ignored during uninstallation.
- Continue with the uninstallation until it is complete.
Common Agent Container Problems
This section addresses problems that might arise in relation to the common agent container shared component:
Port Number Conflicts
The common agent container inside Sun Java Enterprise System occupies the following port numbers by default:
Compromised Security Around the Root Password
It might be necessary to regenerate security keys on a machine running Sun Java Enterprise System. For example, if there is a risk that a root password has been exposed or compromised, you should regenerate security keys. The keys used by the common agent container services are stored in the following locations:
Under normal operation, these keys can be left in their default configuration. If you need to regenerate the keys due to a possible key compromise, you can regenerate the security keys using the following procedure.
Error Notification About Lock File
When you issue a cacaoadm subcommand, it is possible that another user issued a command at exactly the same time. However, only one cacaoadm subcommand can be run at a time.
The following error message is generated:
If cacaoadm daemon is running, it is busy executing another command.
Otherwise remove lock file /var/opt/sun/cacao/run/lock.The first recommended action when you receive this notification message is to wait a few moments and retry.
If you receive the same notification message when you retry, then it is possible that a lock file has not been removed by the common agent container management daemon. This can happen in the case of a crash. The lock file prevents further cacaoadm subcommands from being run.
Remove the lock file from the location indicated in the error message.
Component Troubleshooting Information
This section provides various quick tips on components, with references to useful documentation.
The following additional information in this guide is useful for troubleshooting:
- Developing Your Installation Sequence in Sun Java Enterprise System Installation Guide (http://docs.sun.com/doc/819-0056) contains information on component interdependencies.
- Refer to the sections Troubleshooting Installation Problems and Starting and Stopping Components for instructions.
Access Manager Troubleshooting Tools
Table 27 Access Manager Troubleshooting Tools
Topic
Details
Log Files
Location of AM debug logs
/var/opt/sun/identity/logs
/var/opt/sun/identity/debug
Configuration File
AMConfig.properties
/etc/opt/sun/identity/config
Debug Mode
Refer to the Sun Java System Access Manager Developer’s Guide (http://docs.sun.com/doc/817-7649).
Administration Server Troubleshooting Tools
Table 28 Administration Server Troubleshooting Tools
Topic
Details
Log Files
Installation log directory:
Configuration log files:
For more information on logging options, refer to the Sun Java System Administration Server Administration Guide (http://docs.sun.com/doc/817-7612).
Troubleshooting
Refer to the Sun Java System Administration Server Administration Guide (http://docs.sun.com/doc/817-7612).
Application Server Troubleshooting Tools
Table 29 Application Server Troubleshooting Tools
Topic
Details
Log Files
Log file directory:
/var/opt/sun/install/logs/
Application Server instance log directory (default location for the initially created instance):
/var/opt/sun/appserver/domains/domain1/logs
Message log file name:
Configuration Files
Configuration file directory: /var
Troubleshooting
Refer to the Sun Java System Application Server Enterprise Edition Troubleshooting Guide (http://docs.sun.com/doc/819-0086).
Calendar Server Troubleshooting Tools
Table 30 Calendar Server Troubleshooting Tools
Topic
Details
Log Files
Administration Service (csadmind): admin.log
Distributed Database Service (csdwpd): dwp.log
HTTP Service (cshttpd): http.log
Notification Service (csnotifyd): notify.logDefault log directory: /var/opt/sun/calendar/logs
For more information, refer to Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024).
Configuration File
/opt/sun/calendar/config/ics.conf
Debug Mode
To use debug mode, a Calendar Server administrator sets the logfile.loglevel configuration parameter in the ics.conf file. For example:
logfile.loglevel = "debug"
For more information, refer to Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024).
Troubleshooting
Refer to Sun Java System Calendar Server Administration Guide (http://docs.sun.com/doc/819-0024).
Communications Express Troubleshooting Tools
For information on troubleshooting Communications Express, refer to the Troubleshooting chapter in the Sun Java System Communications Express Administration Guide, http://docs.sun.com/doc/819-0115
Directory Proxy Server Troubleshooting Tools
Table 31 Directory Proxy Server Troubleshooting Tools
Topic
Details
Log Files
Default log file: <DPS Server root>/dps-hostname/logs/fwd.log
For more information, refer to the Sun Java System Directory Proxy Server Administration Guide (http://docs.sun.com/doc/817-7615).
Troubleshooting
Refer to the Sun Java System Directory Proxy Server Administration Guide (http://docs.sun.com/doc/817-7615).
Directory Server Troubleshooting Tools
Table 32 Directory Server Troubleshooting Tools
Topic
Details
Log Files
Installation log file:
/var/opt/sun/install/logs
Configuration log files:
For information on managing log files, refer to the Sun Java System Directory Server Administration Guide (http://docs.sun.com/doc/817-7613).
Troubleshooting
Refer to the Sun Java System Directory Server Administration Guide (http://docs.sun.com/doc/817-7613).
Instant Messaging Troubleshooting Tools
Table 33 Instant Messaging Troubleshooting Tools
Topic
Details
Log Files
Server log: xmppd.log
Agent calendar log: agent-calendar.log
WatchDog log: iim_wd.log
Multiplexor log: mux.log
Default log directory: /var/opt/sun/im/log
For more information, refer to Sun Java System Instant messaging Server Administration Guide (http://docs.sun.com/doc/ <doc no:>).
Configuration File
/opt/sun/im/config/iim.conf
Debug Mode
To use debug mode, a Instant Messaging Server administrator sets the iim.log.iim_server.severity configuration parameter in the iim.conf file. For example:
For more information, refer to Sun Java System Instant Messaging Server Administration Guide (http://docs.sun.com/doc/ <doc no:>).
Troubleshooting
Refer to Sun Java System Instant Messaging Server Administration Guide http://docs.sun.com/doc/819-0024
Helpful Documentation
Refer client online help and the Sun Java System Instant Messaging Administration Guide (http://docs.sun.com/doc/819-0430).
Message Queue Troubleshooting Tools
Table 34 Message Queue Troubleshooting Tools
Topic
Details
Log Files
Installation Log file:
/var/opt/sun/mq/instances/<instance name>/log
Refer to the Sun Java System Message Queue Administration Guide (http://docs.sun.com/doc/819-0066).
Troubleshooting
For performance problems, refer to Analyzing and Tuning a Message Service chapter in the Sun Java System Message Queue Administration Guide (http://docs.sun.com/doc/819-0066).
Message Queue troubleshooting is discussed in the Troubleshooting Problems chapter of the Sun Java System Message Queue Administration Guide and the MQ Forum, at: http://swforum.sun.com/jive/forum.jspa?forumID=24.
Additional articles are available in Knowledge Base, at http://developers.sun.com/prodtech/msgqueue/reference/techart/index.html
Messaging Server Troubleshooting Tools
Table 35 Messaging Server Troubleshooting Tools
Topic
Details
Executable Location
/opt/sun/messaging/sbin
Log Files
/opt/sun/messaging/log
Troubleshooting
Refer to the Sun Java System Messaging Server Administration Guide (http://docs.sun.com/doc/819-0105).
Portal Server Troubleshooting Tools
Table 36 Portal Server Troubleshooting Tools
Topic
Details
Log Files and Debug Files
Portal Server uses the same log files and debug files as Access Manager. Their directories are as follows:
For information on managing Portal Server log files and debug files, refer to the Sun Java System Portal Server Administration Guide, (http://docs.sun.com/doc/817-5324).
For Portal Server Desktop, the debug files are:
For information on managing these files, refer to the Sun Java System Portal Server Administration Guide, (http://docs.sun.com/doc/817-5324).
The dpadmin, par, rdmgr, and sendrdm Portal Server command line utilities have options to generate debugging messages. Options are described in the Portal Server Administrator’s Guide.
Portal Server Secure Remote Access Troubleshooting Tools
Table 37 Portal Server Secure Remote Access Troubleshooting Tools
Topic
Details
Debug Logs
Portal gateway debug logs are located in this directory:
Web Server Troubleshooting Tools
Table 38 Web Server Troubleshooting Tools
Topic
Details
Log Files
There are two types of Web Server log files: the errors log file and the access log file, both located in the directory /opt/sun/webserver/https-instance_name/logs.
The errors log file lists all the errors the server has encountered. The access log records information about requests to the server and the responses from the server. For more information, refer to the Sun One Web Server 6.1 Administrator’s Guide (http://docs.sun.com/doc/817-6247-10).
Troubleshooting
Refer to the Sun One Web Server 6.1 Installation and Migration Guide (http://docs.sun.com/doc/817-6245-10).
Configuration File Directory
/opt/sun/webserver/https-instance-name/config
Debug Mode
The following options are available:
- Log output might be used for diagnostics and debugging. You can set the value of the loglevel attribute of the LOG element in the /server_root/https-instance_name/config/server.xml file to the following values: info, fine, finer or finest. These values indicate the verbosity of debug messages, with finest giving maximum verbosity. For more information about the LOG element, refer to the Sun ONE Web Server Administrator’s Configuration File Reference (http://docs.sun.com/doc/817-6248-10).
- A debug flag might be enabled to start the server web container in debug mode ready for attachment with a Java Platform Debugger Architecture (JPDA debugger. To do this, set the value of the jvm.debug flag of the JAVA attribute in the /instance_root/https-server_name/config/server.xml file to true. For more information, refer to the Sun ONE Web Server Administrator’s Configuration File Reference (http://docs.sun.com/doc/817-6248-10).
- The Sun Java System Studio 5, Standard Edition, plugin enables the debugging of web applications. For more information, refer to the Sun ONE Web Server Programmer's Guide to Web Applications (http://docs.sun.com/doc/817-6251-10).
Multi-CD installation work around
During multi-CD installation, the Sun Java Enterprise System installer may fail when,
This problem is inconsistent. The following workaround should be adopted if this problem arises.
Workaround: Installation from Local disk.
For better performance of the installer, you should copy the contents of installer CD-1 and CD-2 to the local disk having sufficient disk space (approx. 1 GByte).
Steps for installation from Local disk:
- mkdir <installer-dirname>
- Insert CD-1 and mount it.
mount -o rr,ro,cdcase <mountTarget> <mountPoint>
- cp -r <mountPoint>/HPUX_PA-RISC <installer-dirname>
- cp -r <mountPoint>/README <installer-dirname>
cp -r <mountPoint>/Copyright <installer-dirname>
- umount <mountPoint>
- Insert CD-2 and mount it.
mount -o rr,ro,cdcase <mountTarget> <mountPoint>
- cp -r <mountPoint>/HPUX_PA-RISC/* <installer-dirname>/HPUX_PA-RISC
- cd <installer-dirname>/HPUX_PA-RISC
- ./installer
Known Issues and LimitationsThis section describes the known issues and limitations of Sun Java Enterprise System 6 for HP-UX. For a list of the known issues and limitations in this component, refer to the following Release Notes:
http://docs.sun.com/app/docs/doc/819-0056
Known problems that are associated with the Sun Java Enterprise System components are documented in the respective component release notes on HP-UX. Refer to Bugs Fixed in This Release.
The following topics are the known issues:
Installation
If JDK 1.5 is absent from the system, the Java Enterprise System installer hangs (6296226).
The installation with Java Enterprise System installer hangs in absence of JDK 1.5 with exception at the language panel.
Workaround
Install JDK 1.5 before running Java Enterprise System installer.
Multi CD installation: Portal And Application server installation problems (6294975).
During installation with the components Portal Server and Application Server selected, either in Configure Now or Configure Later mode, the Portal Server installation may pause with pop up screen, Cannot eject CD device is busy. This does not happen all the time.
Workaround
Installation should be done in two sessions as follows:
Web Server and Directory Server installation fails on HP_UX due to prerequisite on jre 1.4.1.03 (6293293).
During installation, the installer checks for the required jre version while checking the disk space and throws the Missing System Resouce... error, if jre1.4 is found missing.
Workaround
Install jre 1.4.1.3 or higher to solve this problem, as this is the basic prerequisite for Java Enterprise System 3 installer.
Uninstallation
During uninstallation, the Application Server directory is not removed (6229908).
The Application Server directory is not automatically removed when uninstalling all components of Sun Java Enterprise System.
Workaround
Manually remove the Application Server directory after uninstallation, provided there is no node agent or instance-related data in this directory.
Redistributable FilesSun Sun Java Enterprise System 2005Q1 does not contain any files which you can redistribute.
How to Report Problems and Provide FeedbackIf you experience problems with Sun Java Enterprise System, contact Sun customer support using one of the following mechanisms:
- Sun Software Support services online at
http://www.sun.com/service/sunone/softwareTo 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
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 document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the guide or at the top of the document.
Additional Sun ResourcesUseful Sun information can be found at the following Internet locations:
- Sun Documentation
http://docs.sun.com/prod/java.sys- Sun Professional Services
http://www.sun.com/service/sunps/sunone- Sun Software Products and Service
http://www.sun.com/software- Sun Software Support Services
http://www.sun.com/service/sunone/software- Sun Support and Knowledge Base
http://www.sun.com/service/support/software- Sun Support and Training Services
http://training.sun.com- Sun Consulting and Professional Services
http://www.sun.com/service/sunps/sunone- Sun Developer Information
http://developers.sun.com- Sun Developer Support Services
http://www.sun.com/developers/support- Sun Software Training
http://www.sun.com/software/training- Sun Software Data Sheets
http://wwws.sun.com/software
Copyright � 2005 Sun Microsystems, Inc. All rights reserved.
Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or more additional patents or pending patent applications in the U.S. and in other countries.
SUN PROPRIETARY/CONFIDENTIAL.
U.S. Government Rights - Commercial software. Government users are subject to the Sun Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its supplements.
Use is subject to license terms.
This distribution may include materials developed by third parties.
Portions may be derived from Berkeley BSD systems, licensed from U. of CA.
Sun, Sun Microsystems, the Sun logo, Java and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the U.S. and other countries.
Copyright � 2005 Sun Microsystems, Inc. Tous droits r�serv�s.
Sun Microsystems, Inc. d�tient les droits de propri�t� intellectuels relatifs � la technologie incorpor�e dans le produit qui est d�crit dans ce document. En particulier, et ce sans limitation, ces droits de propri�t� intellectuelle peuvent inclure un ou plusieurs des brevets am�ricains list�s � l'adresse http://www.sun.com/patents et un ou des brevets suppl�mentaires ou des applications de brevet en attente aux Etats - Unis et dans les autres pays.
Propri�t� de SUN/CONFIDENTIEL.
L'utilisation est soumise aux termes du contrat de licence.
Cette distribution peut comprendre des composants d�velopp�s par des tierces parties.
Des parties de ce produit pourront �tre d�riv�es des syst�mes Berkeley BSD licenci�s par l'Universit� de Californie.
Sun, Sun Microsystems, le logo Sun, Java et Solaris sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays.
Toutes les marques SPARC sont utilis�es sous licence et sont des marques de fabrique ou des marques d�pos�es de SPARC International, Inc. aux Etats-Unis et dans d'autres pays.