Sun Portal Server

• Data Collection

Collect the portal version and patch information.

<portalserver_install-directory>/bin/psadmin --version --patches -u amadmin

You are prompted for entering amadmin password.

On systems with Solaris Operating System use ps6info.sh script for Portal Server version 6.X and ps7info.sh script for Portal Server 7.X to collect all required data for further analysis. The script must be run on all systems hosting Portal Server, Access Manager, Directory Server and Gateways. The readme.txt can provide more details on how to run the script. The script will generate compressed file to be uploaded to Sun Support.

The above data along with a network or deployment diagram should be uploaded to Sun Support.

For all other platforms the below data is required to be collected:

- Products versions:
    – Portal Server. Default location /opt/SUNWportal/bin/psadmin --version --patches --u
    – Access Manager: Default location /opt/SUNWam/bin/amserver version   
    – Directory Server: /opt/SUNWdsee/ds6/bin/dsadm --version
    – Web Container Version
- Portal Server configuration
- Portal Server logs
- Access Manager config files
- Access Manager debug/log files
- Portal Server Web Container's config/log files
- Directory Server logs
- If Gateway used then gateway config/log files
- System related information
    – showrev --p
    – /etc/hosts
    – swap --l
    – swap --s
    – uname --a
    – netstat --an
    – pfiles <PS PID>
- Network/Deployment diagram

• Product Versions

- Portal Server. Default location /opt/SUNWportal/bin/psadmin --vesrion --patches --u amadmin (/opt/sun/portal/bin for Linux)
- Access Manager: Default location /opt/SUNWam/bin/amserver version (/opt/sun/identity/bin for Linux)
- Directory Server: /opt/SUNWdsee/ds6/bin/dsadm --version (/opt/sun/ds6 for Linux)
- Web Container Version

• Products Configuration Files (Default Locations)

- Portal Server:

/var/opt/SUNWportal/portals/portal1/config
/etc/opt/SUNWportal

- Access Manager:

/etc/opt/SUNWam/config

- Directory Server:

/var/opt/SUNWdsee/dsins1/config/dse.ldif

- Portal Server & Access Manager Web Container:

Refer to the documentation. This is default locations for Sun Application Server:

/opt/SUNWappserver/config
/opt/SUNWappserver/domains/domain1/config

- Gateway:

/etc/opt/SUNWportal

• Products Log Files (Default Locations)

- Portal Server:

/var/opt/SUNWportal/portals/portal1/logs/
/var/opt/SUNWportal/logs

- Access Manager:

/var/opt/SUNWam

- Directory Server logs

/var/opt/SUNWdsee/dsins1/logs

- Portal Server & Access Manager Web Container:

Refer to the documentation. This is default locations for Sun Application Server:

/opt/SUNWappserver/domains/domain1/logs/server.log

- Gateway:

/var/opt/SUNWportal

- Cacao Logs

/var/cacao/instances/default/logs/

Please help to zip all your files to a file named <Case ID>-<date>.tar.gz and upload to http://supportuploads.sun.com/upload
Please choose "cores" as the Destination. After the uploading finished, please send us an email with checksum info.

• Sun Application Server

- Recommended Data Collection for Crashes and Hangs in the Application Server (Solaris)
- Recommended Data Collection for Crashes and Hangs in the Application Server (Windows)
- Recommended Data Collection for Crashes and Hangs in Application Server (Linux)

• Sun Web Server

- Recommended Data Collection for Crashes and Hangs in Web Server (All)

• Other Application/Web Servers

Please refer to related documents. The below is general idea of required data on Solaris and Linux systems:

- Crash

Run the pkgcore.sh script to collect core file related library files. Upload the pkgcore.sh script to the portal machine and make it executable:

#chmod +x pkgcore.sh

Syntax of the command is

#./pkgcore.sh <case number> <core file name include core file path> <Web Container PID>

The following is an example in my environment:

#./pkgcore.sh 71151001 core.21716 21716

it will generate 2 .tar.gz files start with the case number 71151001

- Hang or Slow response

a. Data Set 1

 
#prstat -L > prstat.out 
#netstat -an >netstat.out 
#mpstat >mpstat.out
#vmstat 5 5 >vmstat.out
#iostat 5 5 >iostat.out
#df -h >df.out

b. Data Set 2

 
#jstack <appserver pid> >jstack1.out 
wait 1-2 minutes
#jstack <appserver pid> >jstack2.out 
wait 1-2 minutes
#jstack <appserver pid> >jstack3.out 
#pflags <appserver pid> >pflags.out 
#pfiles <appserver pid> >pfiles.out 
#pldd <appserver pid> >pldd.out 
#pmap <appserver pid> >pmap.out 
# jmap -heap  <pid>  > jmapHeap.out
# jmap -histo  <pid>  > jmapHisto.out
# jmap -heap:format=b <pid>
# cacaoadm status >cacaoStatus.out

c. Data Set 3

 
#kill -3 <PS Process ID> 

f. Data Set 4

 
#swap -l   > swap-l.out
#swap -s  > swap-s.out

Please help to zip all your files to a file named <Case ID>-<date>.tar.gz and upload to http://supportuploads.sun.com/upload
Please choose "cores" as the Destination. After the uploading finished, please send us an email with checksum info.

• Portal Server Troubleshooting Tips
• Portal Server Secure Remote Access Troubleshooting Tips