1 creating an rtc hot fix september 18, 2013. 2 steps for creating a hot fix find the work item...
TRANSCRIPT
![Page 1: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/1.jpg)
1
Creating an RTC Hot Fix
September 18, 2013
![Page 2: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/2.jpg)
2
Steps for creating a hot fix
• Find the work item where the defect is resolved.• Check for existing hot fixes.• Create a target release installation.• Create a repository workspace for the target release.• Build.• Merge.• Rebuild.• Create the hot fix.• Test.• Deliver.
![Page 3: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/3.jpg)
3
Find the work item where the defect is resolved.
• Often is will be mentioned in the hot fix summary or description.
• Example– Hot fix request 275925– Summary: Defect 255803 backport to 3.0.1.3
![Page 4: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/4.jpg)
4
Check for existing hot fixes
• Sometimes a hot fix will be requested, and such a hot fix will already exist. The first step should be to see if a hot for already exists.
• Look for links on the original defect.
• If no links found, run a query.
![Page 5: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/5.jpg)
5
Example
• Hot Fix 275925 requested– Defect 255803 backport to 3.0.1.3
• Look at defect 255803– Links tab– Link tab shows Hot Fix 259824 under Related.
![Page 6: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/6.jpg)
6
Example
– But, I added it after the fact! It wasn’t there before. So, don’t give up if you don’t see a link.
– Search• Jazz Support (Private) project area• I queried for all delivered source control hot fixes
– Type is “Hot Fix”– Status is “Delivered”– Filed against in RTC-CCM->Source Control– This returned 36 work items– One of them is 259824: Hotfix request for wi 255803
User without permission can unlock file
![Page 7: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/7.jpg)
7
Create a target release installation.
• If the hot fix is client only, you might be able to get by creating only a client installation, if you can find a compatible server.
• For server hot fixes, you will need to create a server installation, and probably a client installation as well.
![Page 8: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/8.jpg)
8
Example
• Hot fix request 277616– Summary: PM95023 - Cannot browse
baselines before the latest 1024– Customer requested hot fix for 4.0.1.– I did the fix for 4.0.5, so I know that the fix is
client only.– So, I installed a 4.0.1 client.
• C:\RTC\RTC-Client-Win-4.0.1
![Page 9: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/9.jpg)
9
Create a repository workspace for the target release.
• First create a new Eclipse workspace.• You don’t want to use the same Eclipse
workspace you are using for Source Control Integration, because the sanddbox for the common components would be written to the same location.
• Workspaces– RTC-dev (for current release development)– RTC-test (for current release testing)– RTC-dev-4.0.1 (for building 4.0.1 hotfix)– RTC-test-4.0.1 (for testing 4.0.1 hotfix)
![Page 10: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/10.jpg)
10
Create a repository workspace for the target release.
• Find the appropriate snapshot.• Team Artifacts View
– Rational Team Concert• Source Control
– RTC Integration stream -> Show Snapshots
• Find the GA snapshot for the release– Note use of RTC Integration stream, not
Source Control Integration stream– Note that naming conventions changed over
time
![Page 11: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/11.jpg)
11
Example (4.0.1)
![Page 12: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/12.jpg)
12
Example (3.0.1.6)
![Page 13: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/13.jpg)
13
Example (4.0)
![Page 14: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/14.jpg)
14
Create the repository workspace from the snapshot
• Don’t set a flow target.– Hot fixes do not flow to a stream.
• Load the appropriate components– Typical list is the following
• Filesystem• RelEng• RelEng Common• RelEng RTC• RelEngBuilder• RTC Commons• SCM• Target Definitions*
![Page 15: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/15.jpg)
15
Find the target platform
• Newer releases– Target Definitions component
• Older releases– RTC Commons component– Name might not mention “target platform”
• Look at history of the relevant component.
• Find the correct change set.
![Page 16: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/16.jpg)
16
Find the target platform
• Release 3.0.1.3– Target platform is in RTC Commons
component.– From the RTC Commons component in your
repository workspace• Show History• Look for change sets near the date of the snapshot
that might reference “target platform”
![Page 17: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/17.jpg)
17
Find the target platform
• The 3.0.1.3 GA snapshot is dated March 26, 2012
![Page 18: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/18.jpg)
18
RTC Commons History
![Page 19: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/19.jpg)
19
Find the target platform
• It looks like the change set for the target platform is this one.
– "203079: [RTC] Prepare the 3.0.1.3 stream for GA - end game - rtc.3x.jcb RTC-I20120326-1442", "Li Zhu", "Mar 27, 2012 6:35 AM“
• To verify, I looked for a hot fix that Matt created on top of 3.0.1.3 to see what he used for his target platform.– I compared his hot fix repository workspace
with the 3.0.1.3 snapshot.
![Page 20: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/20.jpg)
20
Find the target platform
![Page 21: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/21.jpg)
21
Find the target platform
• Yes, this is the correct change set for the target platform.
• Accept the target platform change set.
![Page 22: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/22.jpg)
22
Find the target platform
• 4.0.1 hot fix
• Now it’s in the Target Definitions component and is easier to find!
![Page 23: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/23.jpg)
23
Find the target platform
• The change sets corresponding to target platforms are also listed on two wiki pages.– For older releases (3.X)
• https://jazz.net/wiki/bin/view/Main/RTCTargetPlatformForGAReleases
– For newer releases (4.X)• https://jazz.net/wiki/bin/view/Main/RTCTargetPlatfo
rmForGAReleases40x#RTC_4_0_1
![Page 24: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/24.jpg)
24
Build
• Once you have your repository workspace set up for the target release, and have chosen the correct target platform, build without your changes first.
• If this is successful, then you can merge in your changes.
![Page 25: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/25.jpg)
25
Build
• Some errors are expected and can be ignored
![Page 26: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/26.jpg)
26
Merge and rebuild
– Find the change set or change sets from the fix you are backporting.
– Accept the change set(s) into your repository workspace for your target release.
– You will probably get a message telling you there are gaps, and you will get a chance to merge.
– For simple changes, it is easier to re-apply the change manually, rather than accept the change set.
![Page 27: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/27.jpg)
27
Create change set for your fix
• Create a new change set for your code changes.
• Associate your change set to the hot fix work item.
• When you are done, you can complete your change set, but do not deliver it to a stream.
![Page 28: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/28.jpg)
28
Create the hot fix
• Existing documentation• L3 Wiki page
– https://jazz.net/wiki/bin/view/Main/RTCL3– Two relevant sections discuss server and client hot
fixes.– RTC Server Hotfix (Testfix) Process – RTC Client Hotfix (Testfix) Process
• Work item– Task 16840 discusses how to build an update site
![Page 29: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/29.jpg)
29
Create the hot fix
• For an Eclipse client– Build an update site
• For RTC CLI or server– Deliver jar files
• In all cases, create a zip file.
![Page 30: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/30.jpg)
30
Create the hot fix
• Remember to use Eclipse workspace for development, specific to the target release.
• Use the “Plug-in Development” perspective.
• Find the bundles that you need to deliver. This will tell you if your hot fix is client, server, or both.
![Page 31: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/31.jpg)
31
Example
• Hot Fix 276616 - PM95023 - Cannot browse baselines
before the latest 1024 – Changes are in 4.0.5 Enhancement 279270.– One change set, in Filesystem.
![Page 32: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/32.jpg)
32
Example
• Two bundles– com.ibm.team.filesystem.client– com.ibm.team.filesystem.ide.ui
• Both are Eclipse client
![Page 33: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/33.jpg)
33
Creating an update site
Task 168400 - [HOW TO] Build an Update site for the RTC 3.X Client 1. Modify bundle version in the plug-in xml
version number suffix.
2. Create a new feature project.
3. Add plug-ins to the feature project.
4. Create an update site project.
5. Add the feature.
6. Save and build.
![Page 34: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/34.jpg)
34
Example (Hot Fix 276616)
• Two bundles– com.ibm.team.filesystem.client– com.ibm.team.filesystem.ide.ui
• Open each project in Package Explorer or Project Explorer
• Open plugin.xml file
• Click on Overview tab
![Page 35: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/35.jpg)
35
Xml file version
![Page 36: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/36.jpg)
36
Old plug-in version
• The bundle part of the version before the date should match what is in your target installation (3.1.300).
![Page 37: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/37.jpg)
37
Old plug-in version
![Page 38: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/38.jpg)
38
Update plug-in version
• Change the date on the plug-in version to today’s date and time.
![Page 39: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/39.jpg)
39
Update plug-in version
• Do so for both plugins.
![Page 40: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/40.jpg)
40
Creating an update site
Task 168400 - [HOW TO] Build an Update site for the RTC 3.X Client 1. Modify bundle version in the plug-in xml
version number suffix.
2. Create a new feature project.
3. Add plug-ins to the feature project.
4. Create an update site project.
5. Add the feature.
6. Save and build.
![Page 41: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/41.jpg)
41
Feature Project
• Create a new feature project– Make sure you are in the Plug-in
Development perspective– File->New->Project
![Page 42: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/42.jpg)
42
Feature Project
![Page 43: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/43.jpg)
43
Feature Project
Task 168400 - [HOW TO] Build an Update site for the RTC 3.X Client 1. Modify bundle version in the plug-in xml
version number suffix.
2. Create a new feature project.
3. Add plug-ins to the feature project.
4. Create an update site project.
5. Add the feature.
6. Save and build.
![Page 44: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/44.jpg)
44
Select plug-ins
![Page 45: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/45.jpg)
45
Feature Project
![Page 46: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/46.jpg)
46
Feature Project
• Set the versions correctly.• Versions are in Plug-ins tab.
![Page 47: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/47.jpg)
47
Plug-ins tab
![Page 48: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/48.jpg)
48
Update versions and save
![Page 49: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/49.jpg)
49
Update versions and save
![Page 50: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/50.jpg)
50
Create update site
Task 168400 - [HOW TO] Build an Update site for the RTC 3.X Client 1. Modify bundle version in the plug-in xml
version number suffix.
2. Create a new feature project.
3. Add plug-ins to the feature project.
4. Create an update site project.
5. Add the feature.
6. Save and build.
![Page 51: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/51.jpg)
51
Create an update site project
• File->New->Project– Plug-in Development
• Update Site Project
![Page 52: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/52.jpg)
52
Create an update site project
![Page 53: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/53.jpg)
53
Create an update site project
• Name: HotFix276616_For_RTC_Client 4.0.1
![Page 54: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/54.jpg)
54
Update site project
![Page 55: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/55.jpg)
55
Create update site
Task 168400 - [HOW TO] Build an Update site for the RTC 3.X Client 1. Modify bundle version in the plug-in xml
version number suffix.
2. Create a new feature project.
3. Add plug-ins to the feature project.
4. Create an update site project.
5. Add the feature.
6. Save and build.
![Page 56: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/56.jpg)
56
Add the feature
• Create a new category and add the feature project to this category– Category ID: IBMSupportPatch– Category Name: IBM Support patch for work
item 276616
![Page 57: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/57.jpg)
57
Add the feature
![Page 58: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/58.jpg)
58
Add the feature
![Page 59: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/59.jpg)
59
Create update site
Task 168400 - [HOW TO] Build an Update site for the RTC 3.X Client 1. Modify bundle version in the plug-in xml
version number suffix.
2. Create a new feature project.
3. Add plug-ins to the feature project.
4. Create an update site project.
5. Add the feature.
6. Save and build.
![Page 60: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/60.jpg)
60
Build
• Build the update site– Build All button
![Page 61: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/61.jpg)
61
Save and Build All
![Page 62: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/62.jpg)
62
Find the update site
• It will be in the sandbox
![Page 63: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/63.jpg)
63
Check the update site
• Verify that the version ids on the jar files are correct.
![Page 64: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/64.jpg)
64
Check the update site
• The version id on the feature jar file will be 1.0.0.qualifier
![Page 65: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/65.jpg)
65
Test the update site
• Start an Eclipse client from the target release installation (4.0.1)
• Use a different Eclipse workspace– E.g., RTC-test-4.0.1
• Install the hot fix– Help --> Install New Software– Add the update site pointing into your
sandbox
![Page 66: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/66.jpg)
66
Test the update site
![Page 67: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/67.jpg)
67
Test the update site
![Page 68: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/68.jpg)
68
Test the update site
![Page 69: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/69.jpg)
69
Test the update site
![Page 70: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/70.jpg)
70
Test the update site
![Page 71: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/71.jpg)
71
Test the update site
![Page 72: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/72.jpg)
72
Test the update site
![Page 73: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/73.jpg)
73
Verify Installation
• The directories or jar files in the plugins directory of the installation should show the new bundles.
![Page 74: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/74.jpg)
74
Verify Installation
![Page 75: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/75.jpg)
75
Verify Installation
![Page 76: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/76.jpg)
76
Verify Installation
• Help->About Rational Team Concert– Installation Details -> Installed Software
![Page 77: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/77.jpg)
77
Verify Installation
• Help->About Rational Team Concert– Installation Details -> Plug-ins
![Page 78: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/78.jpg)
78
Verify Installation
• Test your fix in the target installation against your original work item.
![Page 79: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/79.jpg)
79
Deliver the Hot Fix
• Package hot fix as a zip file
• Create a Readme
• Resolve the work item
• Upload to Rational Fix Portal
![Page 80: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/80.jpg)
80
Package hot fix as a zip file
• HotFix276616_For_RTC_Client_4.0.1.zip
![Page 81: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/81.jpg)
81
Create a Readme
• HotFix27716_ReadMe.txt
![Page 82: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/82.jpg)
82
ReadmeHot Fix 276616: Cannot browse baselines before the latest 1024
Hot Fix Contents: Eclipse update site (archive format): HotFix276616_For_RTC_Client_4.0.1.zip
Contains contains the following enhancement: 279270: Add System property to control maximum number of baselines returned in a query in the Eclipse
client
- This hot fix is valid only for RTC 4.0.1- This hot fix is not operating system dependent.- This is an RTC client-side hot fix. It only needs to be applied to RTC Eclipse clients.
How to Apply the Hot Fix: 1) Unzip the hot fix "update site" from the supplied zip file into a temporary directory: <temp-dir>/HotFix276616_For_RTC_Client_4.0.1/
2) From the RTC Eclipse client, install the hot fix from the hot fix update site: Help -> Install New Software... -> Add->Local -> <temp-dir>/HotFix276616_For_RTC_Client_4.0.1/
3) Restart Eclipse
![Page 83: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/83.jpg)
83
Readme4) Verify the hot fix applied correctly:
Help->About->Installation Details->Installed Software "Hot Fix 276616 for RTC Client 4.0.1"
Help->About->Installation Details->Plug-ins IBM Jazz File System IDE Plug-in 3.1.200.v201300909_1745 com.ibm.team.filesystem.ide.ui
^^^^^^^^^^^^^^^ IBM Jazz File System Client Library Plug-in 3.1.300.v201300909_1745 com.ibm.team.filesystem.client
^^^^^^^^^^^^^^^ verify new plug-in versions
5) To use the feature, set the system property SCM_MAX_BASELINE_QUERY_RESULTS in the client eclipse.ini file, under the vmargs section. Here is an example.
-DSCM_MAX_BASELINE_QUERY_RESULTS=9999
This will set the maximum number of baselines returned by a query in the Eclipse client to 9999, instead of the default 1024.
![Page 84: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/84.jpg)
84
CLI or Server Hot Fixes
• CLI and Server hot fixes cannot be installed with an update site
• Deliver just the zipped jar files and the Readme– Export the plug-in that contains the hot fix
change• From the package explorer view, click export,
expand the Plugin Development node, select deployable plugins and fragments..
![Page 85: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/85.jpg)
85
Server Hot Fixes
– Be sure that the plug-in names (build ids) match the target release. The plug-in version (e.g. v20110503_1003) must match the original plug-in. You will need to rename the plug-in that is exported
• Example:– Original jar file:
» com.ibm.team.scm.service_3.0.4.v20120210_0348.jar
– Exported jar file:» com.ibm.team.scm.service_3.0.4.201309161700.jar
– Rename it to match the original jar file.
![Page 86: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/86.jpg)
86
Server Hot Fixes
• Extra steps for server hot fixes– Add extension code to the plugin.xml file to
identify the hot fix.
![Page 87: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/87.jpg)
87
Server Hot Fix Extension Code
<extension point="com.ibm.team.jazz.foundation.server.patch">
<patch
name="Fixed a problem with FOO“
productId=“<The id of the product being patched> " id="com.ibm.team.support.fixWorkItemXXXXX_to_v301iFixX" buildId="<buildid of component>“
version="3.X.Y.Z wiXXXX"/>
</extension>
![Page 88: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/88.jpg)
88
Example (with context) </projectMoveHandler> </extension> <extension point="com.ibm.team.jazz.foundation.server.patch"> <patch name="Hot Fix 259824 for defect 255803: User without permission
can unlock file” productId="com.ibm.team.rtc.web.product"
id="com.ibm.team.support.fixWorkItem259824_to_v3013" buildId="v20130411_1645" version=“3.0.1.3 hotfix259824"/> </extension> </plugin>
• Note that the buildId for the XML file (above) corresponds to the date and time that you created the hot fix, not the old version id that you must use for the name of the jar file.
![Page 89: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/89.jpg)
89
Example Server Hot Fix Readme
Hot Fix 259824 for defect 255803: User without permission can unlock file===========================================================================
Hot Fix Contents: compressed Zip file containing an RTC server plug-in jar: HotFix259824.zip
Contains fix for this defect: 255803: User without permission can unlock file
- This hot fix is valid only for RTC 3.0.1.3 servers. It is not valid for any other version of RTC.- This hot fix is not operating system dependent.- This is an RTC server-side hot fix.
How to Apply this Hot Fix========================1) Prepare your RTC server to recognize the new plug-in. With the server running, open the the following URL in a browser using account with jazzadmin privilege:
https://<your-RTC-server-name>:<port-number>/ccm/admin/cmd/requestReset
2) Shut down the RTC server
![Page 90: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/90.jpg)
90
Example Server Hot Fix Readme
3) Make a back-up copy of the existing plug-in being patched. Open the RTC server's CCM update site "plugins" folder:
<RTC-server-install-directory>/conf/ccm/sites/rtc-commons-update-site/plugins/
and make a copy of the existing plug-in:
com.ibm.team.scm.service_3.0.4.v20120210_0348.jar.BACKUP
4) Extract the new version of the plug-in from HotFix255780.zip into the update site "plugins" folder:
com.ibm.team.scm.service_3.0.4.v20120210_0348.jar
5) Restart the RTC server.
6) Verify the hot fix applied correctly. - Open this URL in your browser:
https://<your-RTC-server-name>:<port-number>/ccm/admin
- Click on "Status Summary" on the left side of the page - The "Build Information" section should list this hot fix:
"Hot Fix 259824 for defect 255803: User without permission can unlock file 3.0.1.3 hotfix259824 (v20130411_1645)"
plus other hot fixes (if any) that you previously applied to this server.
![Page 91: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/91.jpg)
91
Resolve the Hot Fix Work Item
• Release Information Ta b– Attach the zip file and the Readme– Copy Readme into the Readme File field– Set “Adopted in Release” to the release that
contains the fix. For example, a hot fix on top of 3.0.1.3 might be adopted in release 4.0.4.
• In theory, wait for approval from L2 before uploading to Rational Fix Portal.
![Page 92: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/92.jpg)
92
Upload to Rational Fix Portal• https://rcs-testfix.ratl.swg.usma.ibm.com/cgi-bin/fix_portal.pl• Login with your IBM Intranet ID.• Click tab “Submit A Fix/Remove A Fix”• Step 1: Select a product: Rational Team Concert• Step 2: Select an operation: Submit A New Fix to FTP• Fix Archive File
– Upload the zip file
• Readme– Upload the Readme
• Fix Description
– Hot Fix 273164: stream-snapshot compare affected by unload or folder rename
(defect 271076) • E-mail Others
– Make sure (IBM) requestor of hot fix is included
• Fix-Type is “Test Fix”.
![Page 93: 1 Creating an RTC Hot Fix September 18, 2013. 2 Steps for creating a hot fix Find the work item where the defect is resolved. Check for existing hot fixes](https://reader034.vdocuments.site/reader034/viewer/2022051516/56649efb5503460f94c0da3c/html5/thumbnails/93.jpg)
93
Upload to Rational Fix Portal
• You will get an FTP link. Add it as a comment to the Hot Fix work item.• Example
9. Steven Holtsberg, Jul 31, 2013, 4:28 PM@charlesvi @jmlennon Charles,
I have uploaded the hot fix to the Rational Fix Portal. Look for the email confirmation. Once it's ready, the customer can download the hot fix from here:
ftp://ftp.software.ibm.com/software/rational/private/RTC-Jt0jPY18K43H
Please review, as appropriate, before informing the customer of the hot fix.