i-fix Name: PK31637 Problem Summary: Viewing links associated with certain tags gives: unrecognised reference PLEASE install JCR fix PK33003 which is required for this fix. Detailed Problem Description: Certain component types are displayed as Unrecognised Reference when viewed in the Referential Integrity dialogs. Specifically, IDCmpnt, alternate design, ProfileCmpnt HistoryCmpnt or SecurityCmpnt display as unrecognised. Problem Analysis: The referential integrity engine can determine that there are references - however, it cannot determine the type of the reference. Failing Module: WCM - Web Content Management (General) Problem Solution: This fix allows the referential integrity engine to determine the type of the reference. In addition, a module is provided to 'refresh', ie. save, all the items in a library. This may be required to help rebuild the referential integrity engine in order to recognise references for HTML Components, Presentation Templates or Rich Text Components. The module needs to be run if the user has data that was created or migrated prior to PK30057. RefreshAllItems module iterates through all items in a library, loading them and re-saving them. Taking this action ensures that all items in the library are saved in the new data formats which the Referential Integrity code understands. The URL to invoke the module is: http://:/wps/wcm/connect?MOD=RefreshAllItems[&library=][&preserve_dates=true] if library is not specified the default library is processed; otherwise, the named library is processed. if preserve_dates=true, the last mod date for the items is preserved; otherwise it is updated Affected Users: All Users Requisites: pre-requisite Portal Component: WCM 6.0.0.0 GA build 298.0 pre-requisite interim fixes: PK30057, PK31598, PK33003 (these also pre-req: PK30516, PK31363, PK31758) Platform Specific: No Fix pack: This fix will be integrated into WP v6.0.1 Installation Steps: NOTE: YOU MUST FIRST DOWNLOAD THE UPDATE INSTALLER TOOL IN ORDER TO INSTALL A FIX. The Portal Update Installer can be downloaded from the following link: http://www.ibm.com/software/genservers/portal/support Preparation: If you have changed the CellName from the default values during the installation of Portal, you would need to also update this change in the [WPS_ROOT]\config\wpconfig.properties file. If you have not changed the default CellName value during the Portal installation, you can skip this step, and continue. - Go to [WPS_ROOT]\config\wpconfig.properties - Search for the "CellName=" field - Change the CellName to point to what you have changed it too, during the installation. Install: - Create a temporary "fix" directory to store the jar file.- Copy jar file to this directory.- Shutdown WebSphere Portal.- Ensure the pre-requisite fix(es) are installed.- Follow the fix installation instructions that are packaged with the Portal Update Installer on how to install a fix. NOTE: If a pre-requisite fix is not installed, the Portal Update Installer will fail and will list the missing pre-requisite fix(es).- Restart WebSphere Portal.- Update the deployed remote rendering portlet: - Log in to Portal as the Portal Administrator - Navigate to: Administration / Portlet Management / Web Modules - Find and select the remote rendering portlet web module - Click the Update Portlet Icon to the right of the selected portlet - Select the portlet WAR file located in: [PortalServer]\installableApps - Click Next and Finish - Log out of Portal for the changes to take effect. - Please note, the following configuration setting is optional and may be appended to your [WPS_ROOT]\wcm\shared\app\config\wcmservices\WCMConfigService.properties <-- begin --> connect.businesslogic.module.refreshallitems.class=com.aptrix.pluto.security.RefreshAllItemsModule connect.businesslogic.module.refreshallitems.remoteaccess=true connect.businesslogic.module.refreshallitems.autoload=false The following value needs to be appended to the "connect.businesslogic.module": connect.businesslogic.module=template,multi_template,web,mail,form,aggregator,default,ajpe,federatedproxy,ajpecatselect,memberfixer,versioningenablement,workflowenablement,itemdispatcher,plutouploadfile,plutodownloadfile,ensureusermanagement,pdmproxy,synd,subs,syndication,refreshallitems Refer to the "Maintaining the cluster" section of the Portal Information Center for information on installing fixes in clustered environments while maintaining continuous availability of your Portal. Note: If you are tryng to deploy the ifix on a horizontal cluster, Before you run the portal update installer, please take note of the cell name of your deployment manager. You can get the cell nameby going to the deployment manager machine, open /profiles//config/cell//cell.xml and there will be a field indicating the cellname. (by default its called servernameCell01) For each node you are applying the ifix too, you need to: - Go into /config/ - Open up wpconfig.properties - Search for the properties Field "CellName=" - Change it to point to the deployment manager's cellname. i.e. "CellName=DeploymentManagerCell" Un-Installation Steps: NOTE: FIXES MUST BE REMOVED IN THE ORDER THEY WERE APPLIED. DO NOT REMOVE A FIX UNLESS ALL FIXES APPLIED AFTER IT HAVE FIRST BEEN REMOVED. YOU MAY REAPPLY ANY REMOVED FIX. - Shutdown WebSphere Portal.- Follow the instructions that are packaged with the Portal Update Installer on how to uninstall a fix.- Restart WebSphere Portal.- Update the deployed remote rendering portlet: - Log in to Portal as the Portal Administrator - Navigate to: Administration / Portlet Management / Web Modules - Find and select the remote rendering portlet web module - Click the Update Portlet Icon to the right of the selected portlet - Select the portlet WAR file located in: [PortalServer]\installableApps - Click Next and Finish - Log out of Portal for the changes to take effect. Refer to the "Maintaining the cluster" section of the Portal Information Center for information on installing fixes in clustered environments while maintaining continuous availability of your Portal. Note: If you are tryng to deploy the ifix on a horizontal cluster, Before you run the portal update installer, please take note of the cell name of your deployment manager. You can get the cell nameby going to the deployment manager machine, open /profiles//config/cell//cell.xml and there will be a field indicating the cellname. (by default its called servernameCell01) For each node you are applying the ifix too, you need to: - Go into /config/ - Open up wpconfig.properties - Search for the properties Field "CellName=" - Change it to point to the deployment manager's cellname. i.e. "CellName=DeploymentManagerCell" DISCLAIMER: This fix has received limited testing only and has not undergone IBM's complete quality assurance process. It is therefore recommended that it be tested in a testing environment before applying it to a working (authoring, production/live) system. You should always backup your data before installing a fix or fixpack.