sun.com | 1-800-123-4000 | How To Buy | My Sun | Worldwide Sites |  |  |  |  |

Sun Java System Portal Server 7.0 Patch 1 Release Notes

Table of Contents
Special Installation Instructions for WebSphere Post Patch Installation Instructions Detach Not Working in Tab Created Using MakeMyOwnTab (# 6379001) Issues With WSRP Enabling (RSS, GuessNumber, Invoice) Sample Portlets. (# 6243708) Issues Related to Portal Server on WebSphere | Issues Related to Deployment on Weblogic Upgrade: Search Data Not Migrated From JES3/JES4 to PS7.0 Support For JCAPS Applications (# 6371722) Post Patch Uninstallation Instructions Known Issues
#### 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 121914-01 Back to top
#### Post Patch Installation Instructions You must perform the following steps to make 121914-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 121914-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 121914-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. 121914-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 121914-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 121914-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

Company Info | Contact | Terms of Use | Privacy | Copyright 1994-2006 Sun Microsystems