Interim fix CLM_500_iFix011.zip This interim fix is only valid for the CLM 5.0 release. The Rational solution for CLM 6.0.3 is the next release that will include all these fixes. If you plan to upgrade, upgrade to version 6.0.3 or later. CONTENTS OF THE INTERIM FIX 1. This readme file: readme.txt 2. Server patch file: CLM_server_patch_5.0.0.0-CALM50M-I20180514-0327.zip (see the SERVER PATCH INSTRUCTIONS section) 3. WAR files: jts.war, ccm.war, qm.war, rm.war and admin.war (see the UPDATING APPLICATION WAR FILES section) 4. Rational Team Concert Eclipse client update site: NONE CONTENTS OF THIS FILE 1. SERVER PATCH INSTRUCTIONS 2. ADDITIONAL FIXES 3. UPDATING APPLICATION WAR FILES 4. KNOWN ISSUES 1. SERVER PATCH INSTRUCTIONS Note: Before you install the server patch file CLM_server_patch_5.0.0.0-CALM50M-I20180514-0327.zip, verify that no other test fixes or hot fixes are installed. If other fixes are installed, contact IBM Software Support. For a CLM deployment on a single server, complete the following steps once. For a distributed CLM deployment, complete the same steps on each server. To install the server patch: a. Stop the CLM server. b. Verify whether the following directory exists: /server/patch. -If the directory exists, back up and remove its contents. -If the directory does not exist, create it. c. Copy the server patch file CLM_server_patch_5.0.0.0-CALM50M-I20180514-0327.zip, into the /server/patch directory. d. Clean the application server cache. Follow your application server's documentation on cache cleaning. Use "To clean the application cache in WebSphere" and "To clean the application cache in Tomcat" below as a reference. e. Start the CLM server. f. Run repotools- -clean for each application that is installed to clear the repotools cache. Note: This will also display the help output. For instance: - repotools-jts -clean - repotools-ccm -clean - repotools-qm -clean - repotools-rm -clean Note: For a distributed CLM deployment, complete the same steps on each server. To uninstall the server patch: a. Stop the CLM server. b. Back up and remove the contents of the following directory: /server/patch c. Clean the application server cache. Follow your application server's documentation on cache cleaning. Use "To clean the application cache in WebSphere" and "To clean the application cache in Tomcat" below as a reference. d. Start the CLM server. e. Run repotools- -clean for each application that is installed. Note: This will also display the help output. For instance: - repotools-jts -clean - repotools-ccm -clean - repotools-qm -clean - repotools-rm -clean Note: For a distributed CLM deployment, complete the same steps on each server. To clean the application cache in WebSphere: Remove contents from these directories under the profile root: temp,wstemp,workspace. For example, "rm -rf /{temp,wstemp,workspace}/*" on linux. To clean the application cache in Tomcat: Remove contents from these directories under the tomcat root: temp,work. For example, "rm -rf /server/tomcat/{temp,work}/*" on linux. This server patch contains fixes for the following defects: [APAR ID] [Maintenance Item Summary] [Maintenance Item URL] +-- Product Rational Quality Manager Fixed in release 5.0.1: [APAR PI14100] [Not able to run a test suite with more than 10 test cases on a remote machine unless you view each test case in the run suite dialog.] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/117128] [APAR PI17486] [Multiple steps created when using RFT 8.5.1.X and RQM 4.0.6+ for Manual Test Script Recording.] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/114643] [APAR PI18589] [CRJAZ0368E when saving a 1/1000+ test plans referencing ReqPro requirements.] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/116796] [APAR PI20767] [Cannot create a new CQ defect from a test result step.] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/117387] [APAR PI21934] [AQXIN5014E error when generating PDF reports on test artifacts containing external IDs with URL-reserved characters.] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/121968] [APAR PI21940] [Error "Unable to load the content. Override createTextPredicate" when filter the test scripts in keyword (117229)] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/119445] [APAR PI22794] [Exception while updating the script (script name); Failed to find delta predecessor (119754)] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/119763] [APAR PI22795] [Build information on a test suite result is not displayed in the pdf file generated via the "Export Summary" (118913)] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/120000] [APAR PI22896] [When running a test suite, if there is no machine associated with the step result it renders 'Local Computer' (119171)] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/120001] [APAR PI22901] [Adapter search for Test Suite execution does not honor TSER's test environment. Instead it takes environment of suite step although they are unassigned (115680)] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/120002] [APAR PI24051] [[Export to PDF] Export a large test plan to PDF failed with error.] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/126817] [APAR PI25970] [QM Test execution records and results do not appear in Test Plan Snapshot when Exporting to PDF] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/124200] [APAR PM83738] [Exception while updating the script (script name); Failed to find delta predecessor (113877)] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/120131] Fixed in release 5.0.2: [APAR PI23300] [QM Test Suite Execution : “Error: Deferred Operation failed” (120338)] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/120432] [APAR PI24044] [Major TCER loading inefficiencies / scalability concerns] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/123803] [APAR PI25865] [Error on execution console when displaying deleted Test Case Result "Item Handle must not be null "] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/137846] Fixed in release 6.0: [APAR PI19914] [QMI tests failing on D1 deployment] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/141599] [APAR PI19914] [RQM Reportable REST API JUnit and OSLC API JUnit failures.] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/141057] [APAR PI27748] [Command line Adapter is passing a additional argument com.ibm.rqm.adapter.resultAttachmentsFile=xxx to the script] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/126708] [APAR PI29782] [QM : Unable to save a test script that contains two steps with the same keyword] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/155127] [APAR PI30175] [Precondition "Disallow Saving of Test Plans with State Approved" does not prevent a Formal Approval Group from being deleted and saved.  ] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/130756] [APAR PI30404] [Validate date for RQM Reportable REST API when etlmode=true] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/129852] [APAR PI32571] [Resource Group Names in XDC file should be truncated only if needed] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/134954] [APAR PI33024] [QM : Image Verification Points (RFT Test Script) are not present in the result PDF file output] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/133000] [APAR PI39117] [Test script not included in test case section of Test Suite comprehensive PDF export] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/136031] Fixed in release 6.0.1: [APAR PI19914] [testBulkUpload() failed] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/141692] [APAR PI42597] [IServerStatusRestService/databaseStatus service being called to get login page. Causing unnecessary delays when opening dashboards] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/138188] Fixed in release 6.0.2: [APAR PI19914] [Rational Quality Manager cannot open selection dialogs if the OSLC provider provides selection dialogs but no creation dialogs] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/145983] Fixed in release 6.0.3: [APAR PI64971] [Issue: Duplicate/Copy of Test Data causes a DB constraint error] [https://jazz.net/jazz02/resource/itemName/com.ibm.team.workitem.WorkItem/155129] +-- Product Jazz Foundation Fixed in release 5.0.1: [APAR PI19914] [Rational DM Express Setup Errors] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/316229] [APAR PI21302] ["Unresponsive script" is displayed during selection of report parameters] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/326165] [APAR PI21445] [Deferred operation failed during bulkUpdate with SQL error] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/316386] Fixed in release 5.0.2: [APAR PI26888] [Deadlock issue in JNDI due to classloader problem (Fix in 5.0)] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/340822] Fixed in release 6.0: [APAR PI30407] [RTC ETL's should be able to handle date values where the year is not 4 digits long] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/339828] [APAR PI31729] [5.x Indexer for Excel can run out of memory] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/341400] [APAR PI37026] [Online Migration can skip states in the event of a retry-able DB exception (fix in 5.0)] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/349682] [APAR PI37679] [Query Results from performQuery can be unexpectedly cached (Backport 348143 to 50ifix )] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/354690] [APAR PI37709] [Online migration can skip states on subsequent runs (fix in 5.0)] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/349679] [APAR PI41256] [RRC Project Baselines are inaccessible after migration from 4.0.x in a server renamed environment (fix in 5.0)] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/358038] Fixed in release 6.0.1: [APAR PI40009] [Lucene crashes because of Mmap issue (Backport to 50)] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/375014] +-- Product Rational DOORS Next Generation Fixed in release 5.0.1: [APAR PI19530] [Improve how 'not a binding' is determined in SPARQL from View queries] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/90302] [APAR PI19914] [About dialog does not display patch extension information] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/89280] [APAR PI19914] [RM memory consumption increased during a 7-day long run] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/88056] [APAR PI20693] [Locks which existed before a server rename are unusable after the rename operation] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/93575] [APAR PI23288] [RM Suspicion Indexing taking long time to complete] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/89994] Fixed in release 5.0.2: [APAR PI16245] [Certain view queries with sophisticated link patterns / parameters poorly perform] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/87712] [APAR PI19401] [Unable to create custom links between two team areas] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/88711] [APAR PI19914] [Don't return a meaningless Exception class name as an error message, if we also have a full Message_ID and message from the server] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/90942] [APAR PI22500] [Users with JazzProjectAdmins role can initiate a RequisitePro project import, but the import fails] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/90307] [APAR PI23011] [Query to determine whether resource has OSLC link is poor performing] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/92013] [APAR PI23377] [Reports in module context takes long time and cause the report to not be generated with CRRRW7557E error] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/90271] [APAR PI24181] [Exporting projects created from templates while below version 4.0.5 will not export bookmarks causing empty folders on import.] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/90628] [APAR PI24379] [Large ReqIF files can fail to import due to insufficient timeout value] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/90333] [APAR PI25054] [Requirements Data Collection Job Hangs after Server Rename] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/90587] [APAR PI25187] [CRRRW7557E timeout error when generating large reports from views] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/91744] [APAR PI26127] [Error CRRRW7346E when saving an artifact with a table in IE9] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/91659] [APAR PI26658] [Cannot access audit history for artifacts upgraded from 4.x to 5.x] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/91392] [APAR PI26689] [Attribute modifications for multi-value enum attributes are not saved when done from Module -> Selected Artifact] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/91796] Fixed in release 6.0: [APAR PI04747] [Table in table truncated in export] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/92410] [APAR PI19914] [Filter by attributes in module does not find any requirements] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/94965] [APAR PI28204] [Web client runs query for all artifacts when all filters are cleared, introducing unnecessary load on the server for large projects] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/92439] [APAR PI28321] [Unable to duplicate uploaded artifacts without delete permissions] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/93364] [APAR PI28365] [CSV Export performs very poorly when the exported View definition contains Link terms] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/92058] [APAR PI28689] [View queries involving Modified By and Modified On/After/Before terms perform poorly] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/93559] [APAR PI29339] [View query for artifacts "Locked By" a given user performs poorly] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/93560] [APAR PI31789] [Optimize generated SPARQL with custom attributes] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/93561] Fixed in release 6.0.3: [APAR PI60425] [OSLC queries that involve manifested views are slow] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/105449] [APAR PI63790] [Slow OSLC query for manifested views] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/107070] +-- Product Rational Team Concert Fixed in release 5.0.1: [APAR PI14275] [RTC 5.0 SCM Unable to unlock other users file (destroy file lock in the Web)] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/364144] [APAR PI15910] [WebUI - Duplicate attributeDefinition id found in PA source when using "reuse existing attribute"] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/329063] [APAR PI15913] [Contributor List Picker does not work with "Add" correctly] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/342783] [APAR PI16115] [Contributor List not usable due to exception on loading ArtifactListView] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/330551] [APAR PI16549] [Loading a Plan owned by a Team area with more than 2048 members throws error] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/315121] [APAR PI17733] [Plan editor shows archived work item categories in Filed Against column] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/321025] [APAR PI18284] [Overlapping timespans are not handled correctly while adding timespans in traditional scheduler] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/322915] [APAR PI18631] [Backport of Build Forge connections should retry on APIAccessDenied exceptions] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/334047] [APAR PI19189] [Length error is thrown on loading plans] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/322916] [APAR PI20749] [SCM unusable with Oracle DB after upgrade to 5.0] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/320176] [APAR PI21525] [Buildmap Storage Area and JFS Indexes are growing too large] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/323642] [APAR PI21994] [OSLC parameter to query RTC user details using email fails status 500] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/324301] [APAR PI27681] [Original characters sequence 0x0e + 0x0f transformed to characters sequence 0x1e + 0x1f during roundtrip MVS ==> SCM ==> MVS] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/336193] [APAR PI30592] [Printing work items results in error 500 after upgrading to CLM 5.0 from 4.0.1] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/340271] Fixed in release 5.0.2: [APAR PI22474] [Backport of the TeamBuildService has instances where the IN clause can cause problems on Oracle] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/327102] [APAR PI23359] [Appropriate Overlay images not visible based on the status of the item] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/330917] [APAR PI24384] [Plan load takes a massive amount of time in getWorkItemAttributeValueSets] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/331882] [APAR PI26618] [Cannot compare workspaces with more than 2048 components] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/334462] [APAR PI28159] [Initial baseline appears as incoming] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/336189] Fixed in release 6.0: [APAR PI19914] [AbstractScmTypeHandler should implement INewTypeHandler.onTransactionFailed] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/351632] [APAR PI28849] [Removing the summary from the header section causes formatting problems] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/338350] [APAR PI29832] [Improve user experience when dealing with large (1000+ 2048+) numbers of components] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/341024] [APAR PI30770] [MS932 encoded file is garbled in IE 10.] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/360675] [APAR PI33548] [Slow performance of the recent changesets affecting DB query] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/360153] [APAR PI34523] [Investigate using transactional caches during history for versionable] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/360160] [APAR PI35505] [Tool-tip for long values in the selection pulldowns disappear when search filter is applied] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/376753] [APAR PI37243] [RecentChangeSetsAffectingIterator pulls too much from the inner nodes affecting iterator] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/360162] Fixed in release 6.0.1: [APAR PI41341] [Query feeds "My Teams..." and "My Work Item Changes" broken out-of-the-box] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/376752] [APAR PI46581] [ccm.log is flooded by CRJAZ0368E A database query could not run on the server] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/376748] Fixed in release 6.0.2: [APAR PI55171] [Creating local related artifact link from plan column throws "Location missing required itemType information"] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/451579] [APAR SE63925] [[Server] Command line build does not load source when user properties is changed to 5.0] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/382839] Fixed in release 6.0.3: [APAR SE64794] [[Server] Command line build does not load source when IBM i member text metadata is changed] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/390489] 2. ADDITIONAL FIXES: (if they exist) +-- Product Jazz Foundation Fixed in release 5.0.1: [APAR PI17463] [InvalidRegistryObjectException when trying to update advanced properties] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/455762] This defect requires additional steps to apply: see the UPDATING APPLICATION WAR FILES section ---- Fixed in release 6.0: [APAR PI41256] [RRC Project Baselines are inaccessible after migration from 4.0.x in a server renamed environment (fix in 5.0)] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/358038] This defect requires additional steps to apply: NOTE: You only need to do this once per iFix install. If you have done these steps as the result of another fix, you can skip them. Performing the steps multiple times will not cause problems. 1. Go to the /server directory. 2. Execute the following command: repotools-jts -clean ---- +-- Product Rational DOORS Next Generation Fixed in release 6.0: [APAR PI04747] [Table in table truncated in export] [https://jazz.net/jazz03/resource/itemName/com.ibm.team.workitem.WorkItem/92410] This defect requires additional steps to apply: After you stop the CLM server, delete the contents of the directory: -If you use an Apache Tomcat server, the directory is /server/tomcat/temp/rrc_reports/. -If you use WebSphere Application Server, the directory is /tmp/rrc_reports/. ---- 3. UPDATING APPLICATION WAR FILES [APAR PI17463] [InvalidRegistryObjectException when trying to update advanced properties] [https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/455762] WAR files changed in iFix011 and must be re-deployed. Follow the instructions for the web server you use (WAS or Tomcat). NOTE: If the context root used by the any application is not the default, it will be necessary to rename the war file (and adjust some of the directory paths referenced below) based on the context root currently in use. For example, -- if your current context root for Requirements Management is 'rdm', you must rename the rm.war file to rdm.war. -- if your current context root for Quality Management is 'jazz', you must rename the qm.war file to jazz.war -- if your current context root for Change and Configuration Management is 'jazz', you must rename the ccm.war file to jazz.war In summary, the name of the war file needs to be the same as the respective context root in use NOTE: For users of the RDNG browser add-on, the rm.war file must be properly matched with the browser plugin files. This only applies during installation of the plugin, so for those users that have already installed the plugin, no action is required. For any new installations of the browser plugin, the customer should contact IBM Support and request a refresh of the browser add-on files along with the properly paired version of the rm.war file that includes this fix. DEPLOYING ON WEBSPHERE APPLICATION SERVER 1. Backup these files: a. JAZZ_HOME/server/webapps/jts.war b. JAZZ_HOME/server/webapps/ccm.war c. JAZZ_HOME/server/webapps/qm.war d. JAZZ_HOME/server/webapps/rm.war e. JAZZ_HOME/server/webapps/admin.war 2. Copy the jts.war file somewhere either on your local machine or on the CLM server (you may copy to the JAZZ_HOME/server/webapps directory) 3. In the WAS Admin Console, stop the jts application: Go to Applications>Application Types>Websphere enterprise applications, select the checkbox next to jts_war and click on Stop. 4. Update the jts_war file: Select the checkbox next to jts_war and click on Update. 5. Select "Replace the entire application", then browse to the new jts.war file from step 2 and click on Next. Browse locally if the file was saved on the local machine in step 1, or do a remote browse if the file was saved on a different machine. Follow the Fast Path installation, and accept all of the defaults. 6. Save the configuration changes when prompted after the update completes. 7. Start the jts application: select the checkbox next to jts_war and click on Start. 8. Repeat 2-7 with all other WAR files that you need to upgrade. DEPLOYING ON TOMCAT 1. Backup these files: a. JAZZ_HOME/server/tomcat/webapps/jts.war b. JAZZ_HOME/server/tomcat/webapps/ccm.war c. JAZZ_HOME/server/tomcat/webapps/qm.war d. JAZZ_HOME/server/tomcat/webapps/rm.war e. JAZZ_HOME/server/tomcat/webapps/admin.war 2. Copy the war files to the JAZZ_HOME/server/tomcat/webapps directory. 3. Stop the Tomcat server. 4. Delete the JAZZ_HOME/server/tomcat/webapps/jts directory 5. Delete the JAZZ_HOME/server/tomcat/webapps/ccm directory 6. Delete the JAZZ_HOME/server/tomcat/webapps/qm directory 7. Delete the JAZZ_HOME/server/tomcat/webapps/rm directory 8. Delete the JAZZ_HOME/server/tomcat/webapps/admin directory 9. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/jts directory 10. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/ccm directory 11. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/qm directory 12. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/rm directory 12. Delete the JAZZ_HOME/server/tomcat/work/Catalina/localhost/admin directory 4. KNOWN ISSUES a. An empty /server/patch folder must exist when a patch is applied. If you delete the /server/patch folder when you remove existing patch files, errors occur when the server restarts. For details, see Work Item 315482 (https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.WorkItem/315482) b. As a result of RDNG APAR PI28204 (Web client runs query for all artifacts when all filters are cleared, introducing unnecessary load on the server for large projects (92439)), the "Default View" behavior in the Grid View has now changed. Once all filters have been cleared in the Grid, a message will be displayed indicating, "To show artifacts, select a folder or other filter," and no artifacts will be displayed. * This behavioral change required a new message to be displayed when the user hovers over the "eraser" button for the Filter by Folder section. When the browser locale is English, the hover text will display as, "Clear Folder Filters"; however, for all other browser locales, the hover text will continue to display the appropriate translation of the previous string, "Show Artifacts from All Folders", although the action of clicking the button will still be to return no artifacts.