Sun Logo
Products and Services
 
Support and Training
 
 

Sun Java System Portal Server 7.0 Patch 1 Release Notes
Table of Contents
 
 
 
 

Special Installation Instructions for WebSphere

When using WebSphere, you must perform the following steps:

  • Prepare WebSphere install.
  • Install Portal Server 7.0 software in Configure Later mode.
  • Apply the patch.
  • Configure the portal using psconfig utility.
  • Perform the post patch installation instructions for 121913-01

Back to top

 
 

Post Patch Installation Instructions

You must perform the following steps to make 121913-01 effective.

1. Restart the servers (CACAO and web container)
2. Run the doPatchUpdate script that is bundled with the patch.

  • cd <PSINSTALLDIR>/SUNWportal/bin
  • ./doPatchUpdate
Note: See Trail run of doPatchUpdate script
3. Redeploy the psconsole from <PSINSTALLDIR>/SUNWportal/admin/psconsole.war using the web container's deploy command
Steps to redeploy psconsole:
  • With Sun ONE Web Server as the web container:
    • cd /opt/SUNWwbsvr/bin/https/bin
    • ./wdeploy delete -u uri_path -i instance -v vs_id [ [-V verboseLevel] | [-q] ] [-n] hard|soft
    • ./wdeploy deploy -u uri_path -i instance -v vs_id [ [-V verboseLevel]| [-q] ] [-n] [-d directory] war_file
  • With Sun ONE Application Server as the web container:
    • cd /opt/SUNWappserver/appserver/bin
    • ./asadmin undeploy --user ADMINUSER --host AS81HOST --port AS81PORT --target AS81INSTANCE DEPLOYURI
    • ./asadmin --user ADMINUSER --host AS81HOST --port AS81PORT --contextroot DEPLOY_WARPREFIX --target AS81INSTANCE warfile

4. Redeploy the portletapps for each portal in your system.
Note:
Perform this step only if your portal uses portlet applications such as file sharing, shared events, shared tasks, surveys, wiki and rssportlet.

If you have already customized these applications, make sure you do not break your customizations.
You may want to have a look at Developer Sample Guide and Community Sample Guide before proceeding further.
  • Perform the following steps for file sharing portletapp:
    • cp -rf <PSINSTALLDIR>/SUNWportal/portletapps/filesharing/src/* /var/opt/SUNWportal/portals/<PORTALID>/portletapps/filesharing/src/.
    • cd /var/opt/SUNWportal/portals/<PORTALID>/portletapps/filesharing
    • export JAVA_HOME=/usr/jdk/entsys-j2se
    • /usr/sfw/bin/ant customize
    • <PSINSTALLDIR>/SUNWportal/bin/psadmin undeploy-portlet -u amadmin -f pwdfile -p <PORTALID> -g filesharing
    • <PSINSTALLDIR>/SUNWportal/bin/psadmin deploy-portlet -u amadmin -f pwdfile -p <PORTALID> -g /var/opt/SUNWportal/portals/<PORTALID>/portletapps/filesharing/build/filesharing.war
  • Follow the above procedure for the other portlet applications. The location of the various portletapps are listed below:
    • <PSINSTALLDIR>/SUNWportal/portletapps/sharedevents
    • <PSINSTALLDIR>/SUNWportal/portletapps/surveys
    • <PSINSTALLDIR>/SUNWportal/portletapps/sharedtasks
    • <PSINSTALLDIR>/SUNWportal/portletapps/rssportlet
    • <PSINSTALLDIR>/SUNWportal/portletapps/wiki
5. Restart all the servers (CACAO and web container)

WebSphere Related Special Instructions

  • Remove the jvm option java.util.logging.manager=com.sun.identity.log.LogManager from server.xml
  • Increase the minimum and maximum heap size to 512M
  • Need to restart WAS after above changes.

Steps to restart the servers:

  • Restart the CACAO Server :
    • /opt/SUNWcacao/bin/cacaoadm stop
    • /opt/SUNWcacao/bin/cacaoadm start
  • Restart the web container:
      Sun ONE Web Server:
    • /opt/SUNWwbsvr/https-INSTANCE/stop
    • /opt/SUNWwbsvr/https-INSTANCE/start
      Sun ONE Application Server:
    • /opt/SUNWappserver/sbin/asadmin stop-domain --domain DOMAINNAME
    • /opt/SUNWappserver/sbin/asadmin start-domain --user admin

Trial run of doPatchUpdate Script

The following section illustrates usage of the doPatchUpdate script:
bash-2.05# cd /space/PS/SUNWportal/bin

bash-2.05# ./doPatchUpdate
Have you restarted all your servers (CACAO, web container)?[y/n]
y
Making changes for 121913-01...

Please Enter Identity Server Super Administrator Password:
Again?

Mon Dec 12 00:26:43 PST 2005 Sun Java(tm) System Portal Server 7.0

Authentication Success ..
Finding the portals in the system ...
Commencing processing for portal portal1..

Redeploying community portlet ..
Please Enter the domain to deploy this portlet {'g' for global or give the exact dn 'o=Dev,dc=india,dc=sun,dc=com'}:

< comment > The value given here depends on domain the portlet is deployed on earlier or you want to deploy it now.
You could determine the level at which a particular portlet is deployed by browsing the DP of an org.
For more information, please read the Portal Server guide. </comment>

g
using -g ..

/space/PS/SUNWportal/bin/psadmin undeploy-portlet -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1 -g communityportlets
/space/PS/SUNWportal/bin/psadmin deploy-portlet -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1 -g /space/PS/SUNWportal/portlet/communityportlets.war
Done !

Redeploying wsssoportlet ..
Please Enter the domain to deploy this portlet {'g' for global or give the exact dn 'o=Dev,dc=india,dc=sun,dc=com'}:

< comment > The value given here depends on domain the portlet is deployed on earlier or you want to deploy it now.
You could determine the level at which a particular portlet is deployed by browsing the DP of an org.
For more information, please read the Portal Server guide. </comment>

o=DeveloperSample,dc=india,dc=sun,dc=com
using -d o=DeveloperSample,dc=india,dc=sun,dc=com..

/space/PS/SUNWportal/bin/psadmin undeploy-portlet -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1 -d o=DeveloperSample,dc=india,dc=sun,dc=com wsssoportlet
/space/PS/SUNWportal/bin/psadmin deploy-portlet -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1 -d o=DeveloperSample,dc=india,dc=sun,dc=com /space/PS/SUNWportal/portlet/wsssoportlet.war
Done !

Redeploying the portal war ..
/space/PS/SUNWportal/bin/psadmin redeploy -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1
Done !

Modifying the parallel processing mode property in desktopconfig.properties ...
Done !

Completed processing for portal portal1..

Redeploying Search server search1
Completed patch update
Restart all your servers

Back to top

 
 

Detach Not Working in Tab Created Using MakeMyOwnTab (# 6379001)

Add the following entry to /var/opt/SUNWportal/portals/<PORTALID>/desktop/classes/JSPTableContainerProviderJSP.properties
logout=Logout

Back to top

 
 

Issues With WSRP Enabling (RSS, GuessNumber, Invoice) Sample Portlets. (# 6243708)

The patch 121913-01 has the fix for this issue.
Note: If you have already customized the guessnumber portlet, take necessary precautions to preserve your customizations.

The fix is present in <PSINSTALLDIR>/SUNWportal/portlet/guessnumber.war

  • Perform the following steps to redeploy guessnumber portlet :
    • <PSINSTALLDIR>/SUNWportal/bin/psadmin undeploy-portlet -u amadmin -f pwdfile {g|-d "o=Dev,dc=sun,dc=com"i} guessnumber
    • <PSINSTALLDIR>/SUNWportal/bin/psadmin deploy-portlet -u amadmin -f pwdfile {g|-d "o=Dev,dc=sun,dc=com"i} <PSINSTALLDIR>/SUNWportal/portlet/guessnumber.war

Back to top

 
 

Issues Related to Portal Server on WebSphere

  • Searching for a discussion throws desktop error on WebSphere. (# 6375526)
    • With WebSphere as the web container, searching for a discussion in the community sample throws a desktop error.
      121913-01 fixes this issue.

      For the fix to take effect, do the following:
      cp <PSINSTALLDIR>/SUNWportal/par-src/community_sample/pbfiles/templateBaseDir/community_sample/JSPDynamicSingleContainer/dynamicSingle.jsp /var/opt/SUNWportal/portals/<PORTALID>/desktop/community_sample/JSPDynamicSingleContainer/dynamicSingle.jsp

  • Portal not accessible after redeployment on WebSphere. (# 6378407)
    • With WebSphere as web container, the portal webapp is not accessible after executing the "psadmin redeploy" command.
      To overcome this issue,

      • Goto the Websphere admin console
      • start the portal webapp

  • Monitoring not working with Websphere version 5.1.1.5. (# 6376117)
    • The patch includes the fix for this issue. But if you have a portal instance created before applying the patch, perform the following workaround:

      • cd /var/opt/SUNWportal/portals/<PORTALID>/config/<INSTANCEID>
      • set the following properties in monitoring.properties files
        • com.sun.portal.monitoring.ConnectorContext.sasl.disable=true
        • com.sun.portal.monitoring.ConnectorContext.ssl.disable=true

  • Logging on WebSphere 5.1 not functional. (# 6301159)
    • The logging functionality is not working for Portal Server hosted on WebSphere 5.1.
      Workaround:

      • Remove the following JVM options from the server configuration file:
        • -Djava.util.logging.manager=com.sun.identity.log.LogManager
        • -Djava.util.logging.config.class=com.sun.identity.log.s1is.LogConfigReader
      • Add the following JVM options as the *first two jvm entries* to the server configuration file:
        • -DLOG_COMPATMODE=Off
        • -Ds1is.java.util.logging.config.class=com.sun.identity.log.s1is.LogConfigReader

  • Not able to configure producer on PS7.0 when WebSphere is the web container. (#6362385)
    Add the following jars to classpath in server configuration file:
    • /opt/SUNWportal/lib/endorsed/xalan.jar
    • /opt/SUNWportal/lib/endorsed/jaxp-api.jar
    • /opt/SUNWportal/lib/endorsed/sax.jar

Back to top

 
 

Issues Related to Deployment on Weblogic

  • The psadmin redeploy on Weblogic managed server throws exception in logs. (# 6374906)
    Workaround:
    • Login to admin console and undeploy the <portal_URI>.war
    • deploy the war file manually from the Weblogic admin console from
      /var/opt/SUNWportal/portals/<PORTALID>/war/<portal_URI>.war

  • Deploying portlets on admin server requires deployment from admin console. (# 6338787)
    If psadmin deploy-portlet is executed, the portlet is not displayed on the desktop.
    Workaround:
    • The portlet war file has to be manually deployed from the admin console from the location
      /var/opt/SUNWportal/portals/<PORTALID>/war/<portlet_name>.war

  • The command psadmin delete-portal does not clean up the startManagedWeblogic.sh script properly. (# 6376297)
    Workaround:
    • Clean the startManagedWeblogic.sh and startWeblogic.sh scripts manually.
  • Not able to configure producer on PS7.0 when Weblogic is the web container. (# 6362963)
    Workaround:
    Add the following jars to classpath in the web container configuration file related to each portal in your system:
    • /opt/SUNWportal/lib/endorsed/xalan.jar
    • /opt/SUNWportal/lib/endorsed/jaxp-api.jar
    • /opt/SUNWportal/lib/endorsed/sax.jar

Back to top

 
 

Upgrade: Search Data Not Migrated From JES3/JES4 to PS7.0

Search data is not migrated from JES3 to PS7.0. In order to fix this issue, do the following:

  • cd <PSINSTALLDIR>upgrade-resource
  • ./update_search.sh <PS6.3.1 Portal instance directory> /var/opt/SUNWportal/searchservers/UpgradedSearch

Back to top

 
 

Support For JCAPS Applications (# 6371722)

This patch 121913-01 introduces functionality to register/unregister portlets present in a EAR file.

Registration is the process by which Display Profile entries can be created for all portlet applications packaged in a EAR file, after the EAR file is deployed to the underlying Application Server. Unregistration is the process of removing Display Profile entries for all portlet applications packaged in a EAR file.

This feature will work only with ear files generated by JCAPS tools since the EAR files need to have Sun Portal proprietary artifacts inserted into them. For the end-to-end use case involving usage of this functionality, please refer to the JCAPS product documentation including the JCAPS Release Notes.


psadmin register-portlet

Description
Registers all all portlet applications packaged in a EAR file. This feature will work only with ear files generated by Java CAPS tools since the EAR files need to have Sun Portal proprietary artifacts inserted into them.

Syntax
Long Format
psadmin register-portlet --adminuser uid --passwordfile password-filename --dn dn | --global [--rolesfile roles-file] [--userinfofile user-info-file] --portal portal-ID portletearfile
Short Format
psadmin register-portlet -u uid -f passwordfile -d [-r roles-file] [-n user-info-file] -p portal-ID portletearfile

Options:
The following options are required:

  • [--adminuser | -u] uid
    Specifies the administrator's distinguished name.
  • [--dn | -d] dn
    Specifies the distinguished name in the LDAP node to access the display profile document. The -d or -g option is required.
  • [--passwordfile | -f] password-filename
    Specifies the administrator's password in the password file.
  • [--portal | -p] portal-ID
    Specifies the portal ID.
The following options are optional:
  • [--global | -g]
    Specifies the global level node in LDAP to access the display profile document. The -d or -g option is required.
  • [--rolesfile | -r] roles-file
    Specifies the file containing the Access Manager software and portlet application role mapping information.
  • [--userinfofile | -n] user-info-file
    Specifies the file containing the user information mapping information.
Operands
  • portletearfile
    Specifies the path to the EAR file.

Usage

psadmin register-portlet -u amadmin -f pfile -p portal1 -g /tmp/helloworld.ear

In the above example, all portlet applications in helloworld.ear are registered at the global level.

psadmin register-portlet -u amadmin -f pfile -p portal1 -d o=DeveloperSample,dc=sun,dc=com ?r /role.props /export/home/myejbapp.ear

In the above example, all portlet applications in myejbapp.ear are registered at the DeveloperSample node. A role mapping file is also specified.

psadmin unregister-portlet

Description
Unregisters all portlet applications packaged in a EAR file. This feature will work only for EAR files that have been already registered using the register-portlet command.

Syntax
Long Format
psadmin unregister-portlet --adminuser uid --passwordfile password-filename --dn dn | --global --portal portal-ID portletearapp
Short Format
psadmin register-portlet -u uid -f passwordfile -d -p portal-ID portletearapp

Options
The following options are required:

  • [--adminuser | -u] uid
    Specifies the administrator's distinguished name.
  • [--dn | -d] dn
    Specifies the distinguished name in the LDAP node to access the display profile document. The -d or -g option is required.
  • [--passwordfile | -f] password-filename
    Specifies the administrator's password in the password file.
  • [--portal | -p] portal-ID
    Specifies the portal ID.
The following options are optional:
  • [--global | -g]
    Specifies the global level node in LDAP to access the display profile document. The -d or -g option is required.
Operands
  • portletearapp
    Name of the EAR application that needs to be unregistered

Usage

psadmin unregister-portlet -u amadmin -f pfile -p portal1 -g helloworld

In the above example, all portlet applications that were packaged as a part of the helloworld.ear application are unregistered from the global level.

psadmin unregister-portlet -u amadmin -f pfile -p portal1 -d o=DeveloperSample,dc=sun,dc=com myejbapp

In the above example, all portlet applications that were packaged as a part of the myejbapp application are unregistered from the DeveloperSample node.

Back to top

 
 

Post Patch Uninstallation Instructions

After patch 121913-01 has been backedout, you need to undo the changes done during your post patch installation.
doPatchUpdate comes with -r option which undoes the changes it performed during post patch installation.

Please do the following:

  • cd <PSINSTALLDIR>/SUNWportal/bin
  • ./doPatchUpdate -r


Note: if you have redeployed the portletapps after patch install, its necessary to redeploy again to bring these apps to original state.
Follow the instructions under Post Patch Installation Instructions-Step 4.

Trial run of doPatchUpdate -r is presented here:

/space/PS/SUNWportal/bin> ./doPatchUpdate -r
Use this option after removing the patch
If you use this option accidentally, Press Control-C immediately and Exit..
Reverting the changes done by 121913-01
Have you restarted all your servers (CACAO, web container)?[y/n]
y
Making changes for 121913-01...

Please Enter Identity Server Super Administrator Password:
Again?

Mon Dec 12 01:10:23 PST 2005 Sun Java(tm) System Portal Server 7.0


Authentication Success ..
Finding the portals in the system ...
Commencing processing for portal portal1..

Redeploying community portlet ..
Please Enter the domain to deploy this portlet {'g' for global or give the exact dn 'o=Dev,dc=india,dc=sun,dc=com'}:
g
using -g ..
/space/PS/SUNWportal/bin/psadmin undeploy-portlet -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1 -g communityportlets
/space/PS/SUNWportal/bin/psadmin deploy-portlet -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1 -g /space/PS/SUNWportal/portlet/communityportlets.war
Done !

Redeploying wsssoportlet ..
Please Enter the domain to deploy this portlet {'g' for global or give the exact dn 'o=Dev,dc=india,dc=sun,dc=com'}:
o=DeveloperSample,dc=iportal,dc=com
using -d o=DeveloperSample,dc=iportal,dc=com..
/space/PS/SUNWportal/bin/psadmin undeploy-portlet -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1 -d o=DeveloperSample,dc=iportal,dc=com wsssoportlet
Done !

Redeploying the portal war ..
/space/PS/SUNWportal/bin/psadmin redeploy -u amadmin -f /space/PS/SUNWportal/bin/pwdfile -p portal1
Done !

Restoring desktopconfig.properties file ...
Completed processing for portal portal1..
Completed patch update
Restart all your servers

Back to top

 
 

Known Issues

  • Online help is broken for NetFile. (# 6375496)
    Unable to access help files for NetFile when portal is deployed on Weblogic.

  • Discussion appears as created by anonymous user when created in Weblogic and WebSphere. (# 6363127)
    When a discussion is created by a user whose "common name" is empty, then the discussion gets displayed as created by anonymous user

  • The command patchadd on Solaris 10 gives some errors
    When you do a patchadd of the patch on Solaris 10, it displays some error messages related to pkginfo files. This is very specific to Solaris 10. Ignore these messages.
    Sample error messages:
    Cannot open pkginfo file /tmp/patch/121913-01/images/pkginfo
    Cannot open pkginfo file /tmp/patch/121913-01/css/pkginfo

Back to top