clearcase environment how do i web page - samecssamecs.com/how_do_i/clearcase...

ClearCase Environment How do I

Page 1 of 341

Soft - is your software and documentation Asset - is something that must be protected

Management - is what we do Enterprise - is the capability Computing - is the power Services - are what we provide

ClearCase Environment How do I:(Last update 12-Dec-12) Anti-virus software and ClearCase recommendations, etc...

Server processes lockmgr (redundancy in v7) & new vob_almd_params file, stopping and starting (windows & remotely), etc...

ClearCase Registry commands requiring the registry password, etc...

Multi Version File System (MVFS) layer understanding, debugging, flushing the cache, etc...

LDAP and Active Directory services issues, etc...

Shell access understanding, etc...

Network Attached Storage devices - root permissions and, chown_pool & chown_container, etc...

Storage default location for Views on windows, etc...

.NET issues understanding etc,...

Regions Tags, etc...

Email configuring, etc...

Problems and Issues - The Evil twins , eclipsed files, protectvob and, etc...

Installation and patching of ClearCase - including silent install, patching, uninstalling, feature differences ClearCase and ClearCase LT etc...

Firewalls ClearCase and etc...

Upgrading and compatibility issues between major versions, preserving installs, etc...

Plugins & integrations for ClearCase - Eclipse, ClearCase Automation Libraty (CAL), Source Code Control provider (changing), etc...

ClearCase context menus configuring etc...

Temporary files created by and used by ClearCase, etc...

Virtualisation support policy

Interop environment between Windows and UNIX usernames & groups, VOB & View creation in, SaMBa configuration, issues, CLEARCASE_GROUPS, etc...

Licensing commands that dont take a license, etc...

Permissions executables and 770 directories,

Support policies Linux, DFS, Alteris, etc

Caching ClearCase cache directory, etc...

ClearCase environment firewalls, . (dot) files, temporary files, services, magic files, ASP .net framework, name conventions, clearmenuadmin, cache files, encryption software,etc...

ClearCase scheduler using without NIS, groups and, etc...

Anti-virus software and ClearCase recommendations, etc...

file:///C:/Users/AppData/Roaming/Microsoft/Word/ClearCase%20envirnoment%20how%20do%20I.doc%23Permissionsfile:///C:/Users/AppData/Roaming/Microsoft/Word/ClearCase%20envirnoment%20how%20do%20I.doc%23clearcase_environment


Page 2 of 341

Table of contents

CLEARCASE ENVIRONMENT HOW DO I:(LAST UPDATE 12-DEC-12) .................... 1

TABLE OF CONTENTS ................................................................................................................................ 2 ANTI-VIRUS SOFTWARE ........................................................................................................................ 12

1. How do I understand the support Policy for Anti-Virus software and ClearCase ................................................................................................................................................. 12

RELATED INFORMATION ........................................................................................................................ 13 2. How do I understand the RPC: Remote system error - [WINSOCK] No buffer space available issue .............................................................................................................. 13

SERVER PROCESSES ............................................................................................................................... 14 3. How do I understand about the albd_rt_params.conf file .................................. 14 4. How do I understand about Rational ClearCase server processes .................. 15 MultiVersion File System MVFS (MultiVersion File System) is not a server process, it

loads a kernel driver that presents a file system to the user through a standard

interface; see technote 1230196. .................................................................................................. 16 5. How do I understand the Lock Manager process post and pre ClearCase v7 16 6. How do I - monitor the Lock Manager status on Windows ..................................... 18 7. How do I - Monitor the Lock Manager status on UNIX and Linux ........................ 20 8. How do I - diagnosing Lock Manager registry settings on Windows .................. 20 9. How do I understand about the db.conf configuration file ................................. 21 10. How do I understand about deadman lock time-outs .......................................... 21 11. How do I resolve a this client was launched with different lockmgr parameters than those now in the almd file issue ................................................................... 22 12. How do I - start and stop ClearCase from the Windows command line ............ 22 13. How do I - starting and stopping ClearCase services remotely ............................ 23 14. How do I understand the unable to contact albd_server issue ........................ 23 15. How do I understand how ALBD RPC calls can cause significant performance degradation under very high load ........................................................................ 23 16. How do I understand why Rational ClearCase operations hang with the error message of "timed out trying to communicate with ClearCase remote server. " 23

SYMPTOM ................................................................................................................................................. 23 CAUSE ...................................................................................................................................................... 24 ENVIRONMENT ........................................................................................................................................ 24 RESOLVING THE PROBLEM .................................................................................................................... 25

17. How do I understand about RPC services and ClearCase on UNIX and Linux 25

CLEARCASE REGISTRY .......................................................................................................................... 26 18. How do I - manually restoring the primary registry server files from backup 26 19. How do I get a non-root UNIX account to run rgy_passwd ............................... 28 20. How do I understand the ClearCase commands that require a ClearCase registry password ................................................................................................................................. 28 21. How do I deal with the ClearCase 7.0.1 registry files on UNIX and Linux hosts moving from 'rgy' directory to the 'config' directory................................................... 29 22. How do I - set or change the ClearCase registry password ................................... 30 23. How do I understand how a non-root UNIX account can run rgy_passwd... 30 24. How do I understand the computer is not a valid registry server problem . 31 25. How do I - Improve lsview -host and lsvob -host performance ........................... 32

MVFS ...................................................................................................................................................... 33 26. How do I understand why the ClearCase start script prevents MVFS from being unloaded from kernel under some conditions ............................................................... 33


Page 3 of 341

27. How do I understand about the MVFS cache values in ClearCase Control Panel and cleartool getcache ............................................................................................................ 34 28. How do I why the iInstallation of ClearCase 7.1 fails during post-install phase and logs MVFS errors: Trouble mounting the viewroot "/view" ............................ 36 29. How do I understand why you are unable to load MVFS on UNIX or Linux after install .............................................................................................................................................. 37 30. How do I understand why a ClearCase installation on Linux x86 fails because MVFS cannot be loaded. ................................................................................................... 37 31. How do I understand about the MultiVersion File System (MVFS) .................. 38 32. How do I run MVFS Debugging ..................................................................................... 38 33. How do I understand about cleartext lookup and flushing the mvfscache .. 39 34. How do I understand the MVFS Scaling Factor on Windows ............................. 40 35. How do I Understand the invalid MSDOS Function error on Windows copying a file from a UNIX or Linux VOB ..................................................................................... 42 36. How do I - install or uninstall the MVFS on Windows ............................................... 43 37. How do I known the limitations for the MVFS on Microsoft Windows ............ 44 38. How do I - rebuild the mvfs module for use with ClearCase 7.0.x ..................... 44 39. How do I understand why Rebuilding of MVFS modules with kernel symbol exports fails but installation of ClearCase is successful ......................................................... 44 40. How do I configure the MVFS settings for use with eclipse based Rational products and dynamic views ............................................................................................................ 45

LDAP & ACTIVE DIRECTORY............................................................................................................... 45 41. How do I understand the support Policy for LDAP and ClearCase ................... 45 42. How do I use Active Directory Universal Groups and ClearCase ...................... 46 43. How do I understand about Windows Active Directory Distribution and Security groups ..................................................................................................................................... 46 44. How do I understand why ClearCase fails to use LDAP authentication on 64-bit Linux .................................................................................................................................................... 47

SHELL ACCESS & EMULATIONS ............................................................................................................ 48 45. How do I understand why SSH connection hangs when attempting to exit after starting ClearCase ..................................................................................................................... 48 46. How do I understand the support Policy for Shell Access and ClearCase ..... 48 47. How do I understand the support Policy for Xwindows xterm emulators and ClearCase ................................................................................................................................................. 48

NETWORK ATTACHED STORAGE (NAS) DEVICES ............................................................................. 49 48. How do I understand about Root permissions on Network Attached Storage and ClearCase ........................................................................................................................................ 49 49. How do I understand the chown_pool and chown_container support on Linux 50 50. How do I - run cleartool protectvob for VOBs stored on NAS ............................... 51

STORAGE.................................................................................................................................................. 52 51. How do I understand the storage device support for ClearCase ...................... 52 52. How do I understand the ClearCase default storage locations for views on Windows ................................................................................................................................................... 52 53. How do I understand about ClearCase Server Storage locations .................... 53

.NET ISSUES ........................................................................................................................................... 54 54. How do I understand the Visual Studio.NET metadata files and the function they serve when integrated with ClearCase ............................................................................... 54 55. How do I set up and use the Rational Modelling Extension for Microsoft.NET - Rational ClearCase Integration ..................................................................................................... 55 56. How do I understand about Microsoft Visual Studio.NET bindings and ClearCase ................................................................................................................................................. 56 57. How do I - add existing ASP.NET 2005 Framework 2.x Web Applications to source control with Rational ClearCase ........................................................................................ 58


Page 4 of 341

58. How do I understand the procedure to integrate ClearCase and VS.NET 2005 and 2003....................................................................................................................................... 63 59. How do I understand about Security settings with Microsoft .NET 2.0 Framework projects under ClearCase control ............................................................................ 65 60. How do I - create new ASP.NET Framework 1.x Web Applications while under source control with Rational ClearCase ........................................................................................ 68 61. How do I - add existing Microsoft ASP.NET Framework 1.x Web Applications to source control with Rational ClearCase ................................................................................... 71 62. How do I understand the ClearCase checkin default options and VS.NET integration ............................................................................................................................................... 73 63. How do I improved handling of the Open from Source Control function within Microsoft Visual Studio .NET ............................................................................................... 75 64. How do I understand the procedure to integrate ClearCase and VS.NET 2005 75 65. How do I understand the possible corruption caused editing files from Visual Studio.NET using remote dynamic views ....................................................................... 79 66. How do I - FIX: The IBM Rational ClearCase remote view may cause file corruption in Visual Studio .NET 2003 .......................................................................................... 79 67. How do I - add existing Microsoft ASP.NET Framework 1.x Web Applications to source control with Rational ClearCase ................................................................................... 80 68. How do I - create new ASP.NET Framework 1.x Web Applications while under source control with Rational ClearCase ........................................................................................ 83 69. How do I - move a Visual Studio.NET project under SourceSafe to ClearCase while retaining history ........................................................................................................................ 86 70. How do I understand about an error occurred during the parsing of a resource required to service this request .................................................................................... 91 71. How do I understand why a project must be in a view error when adding VS.NET solution to source control .................................................................................................. 94

REGIONS .................................................................................................................................................. 95 72. How do I understand the VOB tags are still displayed in the GUI after changing regions issue ....................................................................................................................... 95 73. How do I understand the requirement to tag a VOB in the default region on the VOB and view server ................................................................................................................... 97

EMAIL ....................................................................................................................................................... 97 74. How do I - configure fully qualified domain names in e-mail notifications using SMTP .............................................................................................................................................. 97

PROBLEMS AND ISSUES ......................................................................................................................... 98 75. How do I understand why cleartool checkvob evil_twin displays twins whose names are not identical ............................................................................................ 98 76. How do I understand the Error: albd_rgy_get_entry call failed: RPC: Timed out - Trouble contacting registry on host "hostname" issue ................................ 99 77. How do I understand the MustGather: Required information for UNIX or Linux Core issues .................................................................................................................................. 99 78. How do I understand the ALERT: albd service unexpectedly installed during a ClearCase 7.1 Client Only Installation on Windows ........................................................... 100 79. How do I understand why clearmake core dumps on RHEL 4 64-bit Linux platform .................................................................................................................................................. 101 80. How do I understand the Running Eclipse or compilers or any application that sets file locks in a view causes Linux Kernel Panic issue ......................................... 101 81. How do I understand the MVFS related issue where NFS file locks on Red Hat Linux become stranded causing system panic ................................................................ 103 82. How do I - understand about Evil Twins...................................................................... 103 83. How do I understand eclipsed files in ClearCase .................................................. 107 84. How do I resolve error: unable to set set-id on file ............................................ 107 85. How do I understand the cleartool: Warning: OBSOLETE command or flag: "-gpa[th]" issue ................................................................................................................................... 108


Page 5 of 341

86. How do I resolve a ClearCase Explorer crashes after switching registry servers on host issue ........................................................................................................................ 109 87. How do I understand the cleartool space output versus du output differences ............................................................................................................................................. 110 88. How do I understand about the Microsoft Word Tracked Changes feature and ClearCase ...................................................................................................................................... 111 89. How do I understand the adjusting the MVFS cache size when ClearCase is running may cause a kernel panic issue .................................................................................... 112 90. How do I understand the unsupported Features of Solaris 10 with Rational ClearCase and ClearCase LT issue ............................................................................................... 113 91. How do I understand why the limit of file descriptors (ulimit -n) is changed after setview ......................................................................................................................................... 113 92. How do I resolve the can't check out, or merge elements through xclearcase issue................................................................................................................................... 114 93. How do I understand about XML and the Windows 1252 encoding scheme issue 114 94. How do I understand the ClearCase magic file changes needed to handle .csproj files with the XML type manager ................................................................................... 115 95. How do I understand the reports are not visible in Report Builder issue ... 116 96. How do I understand the empty derived objects not showing up in the config record issue ............................................................................................................................. 117 97. How do I understand the PK27439: SORTING CLEARCASE EXLORER issue 117 98. How do I understand the nable to rename to .keep: Read-only file system issue ............................................................................................................ 118 99. How do I understand the checked out version, but could not copy data to view: Read-only file system issue ................................................................................................ 119 100. How do I understand the ClearCase 7.0 installation fails on Solaris 8 issue 120 101. How do I understand View and VOB creation errors in ClearCase Interop 120 102. How do I understand the MVFS or RWP fails to load after reboot on Secure Linux issue ............................................................................................................................................. 121 103. How do I understand the copy and Paste from html help pages into a command shell delivers incorrect output ................................................................................... 123 104. How do I understand the issues about RHEL4 Linux servers with NFS V4 enabled ................................................................................................................................................... 123 105. How do I understand the data collection for memory reference errors and blue screens on Windows ................................................................................................................ 124 106. How do I understand the persistent VOBs do not remount automatically issue 127 107. How do I understand the segmentation fault (coredump) when running ClearCase operations ......................................................................................................................... 128 ClearCase example: ........................................................................................................................... 128 108. How do I Use Performance Monitor Alerts to warn of Desktop Heap problems ................................................................................................................................................ 128 109. How do I understand the History Browser display is grey and blank issue 133

INSTALLATION & PATCHING .............................................................................................................. 135 110. How do I understand why MVFS does not loading after kernel upgrade or is missing after installation on Linux ............................................................................................... 135 111. How do I understand the ClearCase support for Red Hat Enterprise Linux 5.0 Update 4 ......................................................................................................................................... 136 112. How do I understand that the package IBM Rational ClearCase is already installed. This package can only be installed in one location error reported when

recording a response file using -skipinstall ............................................................................... 136 113. How do I understand being unable to complete ClearCase 7.1 installation if registry or license server host names contain an underscore ........................................... 137


Page 6 of 341

114. How do I understand why the Daily Scheduled Jobs do not run by default in ClearCase 7.1.x ................................................................................................................................... 137 115. How do I understand comparing pre-7.1 install technologies to new technologies in 7.1 for achieving enterprise deployment on Windows systems ........ 141 116. How do I understand about the pathname limitation on Windows and its affect on ClearCase ............................................................................................................................ 142 117. How do I - deploy the ClearCase and ClearQuest Help systems on an intranet server 146 118. How do I - enable debugging for ClearCase and ClearQuest installs using Installation Manager .......................................................................................................................... 152 119. How do I understand the knowledge Collection: Available White Papers for the ClearCase Family of Products ................................................................................................. 152 120. How do I understand the White paper: ClearCase Registry server Performance Enhancements for version 7.1 ............................................................................ 154 121. How do I understand why the installation of ClearCase 7.1 fails during post-install phase and logs MVFS errors: Trouble mounting the viewroot "/view" ............. 154 122. How do I understand why applying the latest Fix Pack may yield error: zip com.ibm.rational.team.write.runonce.key 1.0.0.v200810242053 not found .............. 154 123. How do I understand the ClearCase 7.1 equivalent to installing by siteprep in pre 7.1 versions ............................................................................................................................. 155 124. How do I - configure ClearCase on a mobile computer that is disconnected from and then reconnected to the network .............................................................................. 156 125. How do I - install ClearCase v7.1.x on a platform that does not use the GUI 160 126. How do I - update the Windows ClearCase ALBD Password ................................ 162 127. How do I understand why package IBM Rational ClearCase is already installed. This package can only be installed in one location error reported when

recording a response file using -skipinstall ............................................................................... 163 128. How do I understand why after restarting the ClearCase host the CM server does not automatically restart ....................................................................................................... 163 129. How do I understand why the Next button is disabled when installing ClearCase and ClearQuest at the same time ........................................................................... 164 130. How do I understand the compatible ClearCase server and client iFix and Fix Pack levels ...................................................................................................................................... 164 131. How do I understand the Knowledge Collection: Manually uninstall ClearCase ............................................................................................................................................... 164 132. How do I understand about the IBM Rational ClearCase Windows release area 165 133. How do I understand about the ALERT: albd service unexpectedly installed during a ClearCase 7.1 Client Only Installation on Windows ............................................. 166 134. How do I understand the clarification on the alert issued for RHEL 4 Update 5/6 and RHEL 5 and support for ClearCase VOB hosts with Network Attached VOB

storage .................................................................................................................................................... 167 135. How do I understand the issue of db_server or vobrpc_server processes on a RedHat Enterprise Linux VOB server consume 100% CPU when using NAS storage

for VOBs ................................................................................................................................................. 168 136. How do I understand the NFS locking problems impact performance on a RedHat Enterprise Linux VOB server when using NAS storage for VOBs...................... 169 137. How do I understand the system Requirements for ClearCase 7.x .............. 169 Check the ClearCase System Requirements link for the latest system requirements. 169 138. How do I understand about the available iFixes and FixPacks for ClearCase Family 7.x .............................................................................................................................................. 169 139. How do I understand the ClearCase 2003.06.00 and 7.0 release and patch mappings................................................................................................................................................ 169


Page 7 of 341

140. How do I understand the changes made to the behavior of the install_release Reset Selections option in ClearCase 7.0 .................................................... 169 141. How do I understand the issue when only root can run cleartool commands issue 175 142. How do I understand about ClearCase and allow_non_root_installation.... 175 143. How do I do a silent Install and Uninstall of ClearCase on UNIX ................... 175 144. How do I - remove the ClearCase patch subdirectories ........................................ 176 145. How do I remove ClearCase patches from a release area ................................ 176 146. How do I resolve the multitool -ver and cleartool ver not accurately reflection the patched state of a system ................................................................................... 177 147. How do I - manually uninstall ClearCase on Linux .................................................. 177 148. How do I - manually uninstall ClearCase on Solaris ............................................... 178 149. How do I - Manually uninstall ClearCase on HP-UX ................................................ 178 150. How do I - manually uninstall ClearCase on Windows ........................................... 179 151. How do I conduct a silent install of a Rational Software Development Platform desktop products .............................................................................................................. 180 152. How do I - use Microsoft SMS to deploy ClearCase 7.x installations ............... 181 153. How do I deploy a customized Enterprise Installation of IBM Rational ClearCase using CCRC ...................................................................................................................... 181 154. How do I understand the feature differences between ClearCase and ClearCase LT ......................................................................................................................................... 181 155. How do I understand the Supplement to the ClearCase 7.0.0 Administrator's Guide about configuring ClearCase on a ClearQuest server ............... 183 156. How do I understand why the installation of ClearCase 7.0.0.1_IFIX04 and 7.0.1.0_IFIX01 on RHEL 5 do not update the updated.config file properly ................. 183 157. How do I understand the Address already in use error ................................. 184 158. How do I understand about the Stand Alone configuration for Rational ClearCase ............................................................................................................................................... 184 159. How do I understand about ClearCase File Server (CCFS) .............................. 185 160. How do I understand how the ClearCase File Service (CCFS) can be disabled on an IBM Rational ClearCase VOB server? ................................................ 186

FIREWALLS ............................................................................................................................................ 187 161. How do I understand about Firewalls and ClearCase ......................................... 187

UPGRADING AND COMPATIBILITY ISSUES ....................................................................................... 188 162. How do I - update an IBM Rational 7.1.x install through IBM Installation Manager .................................................................................................................................................. 188 163. How do I understand ClearCase Compatibility Across Releases ..................... 195 164. How do I understand about upgrading ClearCase and ClearQuest to version 7.0.1 195 165. How do I understand why db_server process on VOB server consuming 100% of a CPU after upgrading to RHEL 4 Update 5 ............................................................ 196 166. How do I upgrade ClearCase between major version numbers ..................... 196 167. How do I - preserve files when upgrading ClearCase on UNIX and Linux ...... 197 168. How do I resolve an Incompatible versions of ClearCase software and/or databases issue ................................................................................................................................... 198 169. How do I resolve a ClearCase GUIs fail on 64 bit Linux and Solaris operating system issue ..................................................................................................................... 199 170. How do I - understand why the ClearCase GUIs fail on Linux and Solaris operating system ................................................................................................................................ 199 171. How do I understand upgrading to version 7.0 of Rational Software Development Platform - Team products .................................................................................... 202

PLUGINS & INTEGRATIONS ................................................................................................................ 203 172. How do I - integrate Microsoft Word 2007 with ClearCase 7.0 .......................... 203 173. How do I understand how the IBM Rational ClearCase SCM Adapter adds ClearCase functionality to the Eclipse workbench. ................................................................ 206


Page 8 of 341

174. How do I understand about base ClearCase and ClearQuest V2 integration Setup and FAQ ..................................................................................................................................... 207 175. How do I understand why the ClearCase menu options bundle is not visible in the menu ........................................................................................................................................... 209 176. How do I understand the setting up and using the Rational Method Composer - Rational ClearCase Integration ............................................................................. 209 177. How do I - enable tracing for the V2 Base ClearCase-ClearQuest Integration 212 178. How do I understand the issue ClearCase SCM Adapter and Eclipse 3.4.1 with the Java EE Bundle is not visible in the menu ............................................................. 213 179. How do I display the settings for the base ClearCase-ClearQuest integration 213 180. How do I get the Eclipse plugins ................................................................................ 216 181. How do I understand about Eclipse plug-in compatibility and version support for the ClearCase SCM Adapter .................................................................................... 216 182. How do I - install the SCM Adapter for Eclipse version 3.4.1 ............................. 217 183. How do I understand the supported Rational integrations with ClearCase and ClearQuest .................................................................................................................................... 218 184. How do I understand the Permission denied error accessing a dynamic view through Apache on Windows issue .............................................................................................. 220 185. How do I understand about the ClearCase 7.0 integration with Apache Ant 221 186. How do I - integrate Microsoft Word 2007 with ClearCase 7.0 .......................... 221 187. How do I - remove the ClearCase integration with Microsoft Word .................. 224 188. How do I - disable the PowerPoint or Excel integrations with ClearCase ....... 225 189. How do I understand why the ClearCase Menu option does not appear on the Menu Bar in Microsoft Word or Excel .................................................................................. 226 190. How do I understand about ClearCase variables run within a batch file .... 227 191. How do I - change the XML Diff/Merge Type Manager .......................................... 228 192. How do I use the ClearCase Automation Library (CAL) ..................................... 232 193. How do I understand the example of the Rational ClearCase Automation Library (CAL) from a Rational Rose script ................................................................................. 233 194. How do I understand the location of the ClearCase ClearQuest integration Perl triggers........................................................................................................................................... 235 195. How do I understand central caching in the ClearCase and ClearQuest V2 integration ............................................................................................................................................. 235 196. How do I - use the cleartool schedule command to run the Cache manager 235 197. How do I understand the ClearCase could not get an object ID (OID), error when checking in a new element version when using the V2 Base ClearCase and

ClearQuest integration issue .......................................................................................................... 236 198. How do I - setup the V2 ClearCase ClearQuest integration to list out all records on a check out or check in .............................................................................................. 236 199. How do I - display the record ID from the command line when using the UCM or Base ClearCase and ClearQuest integration ....................................................................... 238 200. How do I understand conjunction junction, what's your function: more ClearCase integration strategies ................................................................................................... 239 201. How do I - have 2 VOBs on the same machine accessing different ClearQuest databases ............................................................................................................................................... 242 202. How do I - change the source control provider to ClearCase .............................. 243 203. How do I understand the unable to read registry value: Software\Atria\ClearCase\SCCServerName issue .................................................................. 243 204. How do I understand about SCC compliance and Rational ClearCase ......... 243 205. How do I - enable SCC trace operations with ClearCase ...................................... 244

CLEARCASE CONTEXT MENUS ............................................................................................................. 244 206. How do I understand why Menu Choices cannot be added or modified in ClearCase 7.1 Context Menu Editor ............................................................................................. 244


Page 9 of 341

207. How do I customize the ClearCase Windows Interface ...................................... 246 208. How do I - change ClearCase context menus without loading an export file 249

CLEARPROMPT ....................................................................................................................................... 250 209. How do I understand the supplement to the Command Reference Guide about clearprompt .............................................................................................................................. 250

DOCUMENTATION ................................................................................................................................. 251 210. How do I use the ClearCase Information Centre .................................................. 251

TEMPORARY FILES AND (.)DOT FILES ............................................................................................... 252 211. How do I understand the temporary files created by ClearCase ................... 252 212. How do I understand about .dmp files in the ClearCase log directory ........ 253 213. How do I understand the .PID file .............................................................................. 254

VIRTUALISATION ................................................................................................................................. 255 214. How do I understand that Clearlicense -hostid may return invalid results on Red Hat Linux if XEN kernel is running ...................................................................................... 255 215. How do I understand ClearCase Licensing and the MAC address on virtual machines ................................................................................................................................................ 255 216. How do I understand why the Linux Virtual server clients report errors after VOB server crashes or is rebooted ............................................................................................... 255

INTEROP ENVIRONMENT ..................................................................................................................... 256 217. How do I - configure UNIX or Linux clients to access Windows VOBs ............. 256 218. How do I understand the mnode settings and the username.map file with reference to SaMBa ............................................................................................................................ 261 219. How do I understand the ClearCase and Samba: A Supported Configuration 262 220. How do I configure usernames and primary groups in a ClearCase Interop environment they must be identical ........................................................................................ 262 221. How do I understand about the CLEARCASE_PRIMARY_GROUP variable .. 262 222. TROUBLESHOOTING: Here are some related technotes to problems where the CLEARCASE_PRIMARY_GROUP variable was set incorrectly: ............................................ 264 223. How do I understand about the Primary Group requirements for element creation ................................................................................................................................................... 265 224. How do I understand about the CLEARCASE_GROUPS variable .................... 267 225. How do I understand about MVFS limitations on the number of ClearCase groups a user may belong ............................................................................................................... 268 226. How do I understand the maximum groups on UNIX and Linux for use with ClearCase ............................................................................................................................................... 269 227. How do I understand the access denied accessing files from Windows Explorer but not from Command Prompt (CLEARCASE_GROUPS) issue ....................... 271 228. How do I understand the CEARCASE_GROUPS EV when more than 32 groups and accessing 770 directories issue. ............................................................................ 272 229. How do I Create ClearCase VOBs and Views in ClearCase Interoperation environment with UNIX or Linux with Microsoft Windows - you cant ........... 272 230. How do I Create a snapshot view from Windows stored on a ClearCase UNIX server ........................................................................................................................................... 272 231. How do I resolve a checkout fails from Windows only in an interop environment issue .............................................................................................................................. 272 232. How do I understand the specific Samba 3.0.24 configuration required for ClearCase ............................................................................................................................................... 273 233. How do I understand ClearCase configuration in a domain environment with a one-way trust ................................................................................................................................... 273 234. How do I understand usernames and primary groups in a ClearCase Interop environment .......................................................................................................................................... 273 235. How do I - understanding NOBODY in the credmap output ................................. 274 236. How do I - recover ClearCase functionality after users and groups moved to a new domain ........................................................................................................................................... 275


Page 10 of 341

237. How do I understand about ClearCase permissions on Windows .................. 279 238. How do I understand the Cannot bind an admin_server handle on Windows issue .................................................................................................................................... 283 239. How do I - add multiple domain names to the CredmapAllowedDomainList 286

LICENSING ............................................................................................................................................ 288 240. How do I - reset the license usage statistics reported by clearlicense ............ 288 241. How do I - Denying users from pulling a ClearCase license ................................ 288 242. How do I know the ClearCase commands that DO NOT require a ClearCase license 289 243. How do I - switch between Atria and FLEXlm licensing ......................................... 289 244. How do I - configure ClearCase 7.1.x on UNIX to support multiple license servers .................................................................................................................................................... 290 245. How do I understand why windows user is consuming two ClearCase licenses when license server is hosted on UNIX or Linux ................................................... 293

PERMISSIONS ....................................................................................................................................... 295 246. How do I understand the this application has failed to start because the application configuration is incorrect issue ............................................................................... 295 247. How do I understand the access denied errors executing an element in a proxy group configuration issue .................................................................................................... 295

SUPPORT POLICIES .............................................................................................................................. 297 248. How do I understand about ClearCase support for Microsoft Windows 7 Operating system................................................................................................................................ 297 249. How do I understand the Support Policy for ClearCase on Solaris Branded Zones 297 250. How do I understand the Support Policy for ClearCase on Linux .................. 298 251. How do I understand about disk encryption software use with ClearCase 299 252. How do I understand the support Policy for Microsoft Windows Vista ......... 299 253. How do I understand the support policy for ClearCase use across multiple Active Directory forests .................................................................................................................... 300 254. How do I understand the support Policy for ClearCase and Xen on Linux . 301 255. How do I understand ClearCase Support for Red Hat Linux 5.0 .................... 301 256. How do I understand the support Policy for High Availability clustering and ClearCase ............................................................................................................................................... 302 257. How do I understand ClearCase Support for HP-UX 11.31 .............................. 303 258. How do I understand the support Policy for DFS (Distributed File System) and ClearCase ...................................................................................................................................... 303 259. How do I understand the support Policy for Altiris Server Management Suite with ClearCase ..................................................................................................................................... 304 260. How do I understand the support Policy for Microsoft Virtual PC on ClearCase and ClearQuest ............................................................................................................... 304 261. How do I understand the support Policy for Anti-Virus and ClearCase ....... 305 262. How do I understand the Rational Support Policy Addendum for VMware support .................................................................................................................................................... 306 263. How do I understand support for IBM SWG products in a VMware environment .......................................................................................................................................... 307 264. How do I understand the support Policy for ClearCase with FLEXlm on HP-UX IA64 .................................................................................................................................................. 308 265. How do I understand the support policy for ClearCase on Macintosh OS X 309

CACHING ................................................................................................................................................ 309 266. How do I understand about the ClearCase cache directory ............................. 309

CLEARCASE ENVIRONMENT ................................................................................................................. 310 267. How do I deploy the ClearCase and ClearQuest Help systems on an intranet server 310 268. How do I understand platform specific IPv6 restrictions for ClearCase ...... 315


Page 11 of 341

269. How do I understand about the limits for simultaneously mounting VOBs on a single host.......................................................................................................................................... 315 270. How do I Understand about Feature Levels and ClearCase ............................. 317 271. How do I modify the Vtree Browser font appearance in ClearCase 7.0.x .. 318 272. How do I understand the Network Environments for ClearCase .................... 318 273. How do I understand the issue that the use of Google Desktop with ClearCase causes conflicts .............................................................................................................. 319 274. How do I understand why MVFS crashes if encryption software is installed on the system ...................................................................................................................................... 320 275. How do I understand about the noatime filesystem mount option and ClearCase ............................................................................................................................................... 320 276. How do I understand why you cannot access files or directories in ncaexported VOB/view from RHEL4 which is fixed in v7.0.1.1 ......................................... 321 277. How do I set up the CCASE_NMASTER_TRIG environmental variable ....... 321 278. How do I resolve non-ClearCase client hangs when attempting to mount an NCA exported view/VOB................................................................................................................... 321 279. How do I understand about the maximum character length of a version extended path ...................................................................................................................................... 322 280. How do I understand the requirements when IP address, hostname and NIS are changed .......................................................................................................................................... 322 281. How do I understand about alternate_hostnames .............................................. 323 282. How do I control the date format displayed by cleartool commands using the CCASE_ISO_DATE_FMT environment variable ................................................................ 324 283. How do I understand about the CCASE_ISO_DATE_FMT environment variable ................................................................................................................................................... 325 284. How do I understand about naming conventions and characters used to create ClearCase objects ................................................................................................................. 326 285. How do I understand about the special characters in file names on UNIX and Linux ............................................................................................................................................... 327 286. How do I remove ClearCase objects whose name begins with a hyphen ... 328 287. How do I understand about the interaction between ClearCase and file system snapshots ............................................................................................................................... 329 288. How do I understand about the TZ environment variable ................................ 330 289. How do I - define TEMP user environment variables for the clearcase_albd account even if you cannot logon with this account ............................................................. 331 290. How do I - stop client names from appearing in the ClearCase Administration Console ................................................................................................................................................... 332 291. How do I - activate ClearCase remote administration on UNIX and Linux .... 333 292. How do I understand about files under source control and the write bit.... 334 293. How do I understand the issue Is there a Windows equivalent of the CLEARCASE_DBG_GRP EV ............................................................................................................. 334

CLEARCASE SCHEDULER ..................................................................................................................... 334 294. How do I understand that the ClearCase Scheduler incorrectly computes next run time on day of transition to standard time ............................................................. 334 295. How do I understand why the Daily View Space scheduled jobs making several DNS calls ................................................................................................................................ 336 296. How do I use the ClearCase Scheduler without NIS on UNIX or Linux ....... 336 297. How do I understand the unable to add a user to the Scheduler ACL list where NIS is not defined issue ...................................................................................................... 337 298. How do I understand the ClearCase -nusers switch can only specify single users to allow access to an object issue .................................................................................... 337 299. How do I - move custom ClearCase Scheduler Jobs from one system to another ................................................................................................................................................... 337 300. How do I - recreate the ClearCase Scheduler database without losing customized default job information ............................................................................................. 338


Page 12 of 341

301. How do I Temporarily disabling jobs in the Scheduler .................................. 339 ANTI-VIRUS SOFTWARE ...................................................................................................................... 340

302. How do I understand the support Policy for Anti-Virus software and ClearCase ............................................................................................................................................... 340 Support Policy for Anti-Virus and ClearCase ..................................................................................... 340 303. How do I understand the RPC: Remote system error - [WINSOCK] No buffer space available issue ............................................................................................................ 340

Anti-virus software

1. How do I understand the support Policy for Anti-Virus software and ClearCase

What is the support policy for Anti-Virus Scanners installed on IBM Rational ClearCase clients and servers and are there any transcripts of known configurations for Virus scanners that are compatible with VOB and View servers? Overview ClearCase is not certified at this time to run with any specific Anti-Virus applications. We are currently testing with some major anti-virus vendors to ensure we do not find any major issues with the anti-virus product and ClearCase. The information in this technote is a compilation of support knowledge related to the configuration of Anti-Virus applications to successfully work along side Rational ClearCase.

This is a consolidation of documents that have been written to detail the lessons-learned to assist you in avoiding known problems when Anti-Virus applications are configured on a ClearCase host. This means that ClearCase can coexist with an anti-virus program running, however, there are some considerations to plan for. Note: If problems caused by anti-virus configuration issues occur in your ClearCase environment, resolution of those issues is beyond the scope of Rational Client Support. Rational Client Support can assist in determining what the specific anti-virus ClearCase problem is, however, you should work with your anti-virus vendor to determine how to resolve the issues. Topics Covered in this technote The general issues to consider when configuring Virus scanners on a ClearCase server are: When and How to Scan

When and How NOT to Scan What to Scan What NOT to Scan When and How to Scan:

When possible scan manually or on a scheduled basis during down time (non-work time). This limits the performance impact virus scanning can impose during normal operations especially ClearCase use as this impact could be significant depending on client speed, network bandwidth, server performance, and the number of clients accessing VOBs and views on any given host.

ClearCase should be shut down on the host being scanned. This avoids any possibility of the scanner affecting or being affected by ClearCase.

When and How NOT to Scan:

"Realtime" or "on-access" scans should be avoided. Depending on how aggressive the virus scanner is, "on-access" scanning can disable ClearCase cleartext and source container creation. The final step in the on-access operation is typically to rename temporary containers and ClearCase creates many of these containers as part of its process. Also, on-access scans may lock a file to perform some operations resulting in the inability of ClearCase to rename the file. This may result in errors from vob_server regarding "operation 'rename_container' failed."

Virus scanner should not be configured to attempt cleaning or deletion of infected files. These options can lead to corrupted or missing source containers and/or derived objects which in turn can lead to a dramatic increase in recovery time as the corrupted/missing containers have to be rebuilt.

What to Scan:

Scan the VOB source pools. Be aware that binary files that have been added to source control may be compressed and inaccessible to the virus scanner unless the scanner can scan inside of zip files.

http://www-01.ibm.com/support/docview.wss?uid=swg21149511&myns=swgrat&mynp=OCSSSH32&mynp=OCSSSH27&mync=R#when-tohttp://www-01.ibm.com/support/docview.wss?uid=swg21149511&myns=swgrat&mynp=OCSSSH32&mynp=OCSSSH27&mync=R#when-not-tohttp://www-01.ibm.com/support/docview.wss?uid=swg21149511&myns=swgrat&mynp=OCSSSH32&mynp=OCSSSH27&mync=R#what-tohttp://www-01.ibm.com/support/docview.wss?uid=swg21149511&myns=swgrat&mynp=OCSSSH32&mynp=OCSSSH27&mync=R#what-not-to


Page 13 of 341

Scan VOB cleartext pools. Be aware that the file names in this directory bear little relation to their real names, so a scan by extension (.txt, .exe etc...) will not properly scan.

Scan VOB DO pools. This may protect against file infectors that may find a freshly built executable during a build and make a few minor changes. If that file is then winked in through another build, a virus-infected file would be publicly available. This would at least provide notification.

Scan View storage directories. This would catch new files added to a directory by a virus and view private files modified by a virus.

What NOT to Scan:

Do not scan the MVFS "view" drive ("M:" by default on Microsoft Windows). Scans on this drive will scan all views started on this system and all VOBs mounted on this system. The cleartext lookup/creation phase of a file open in MVFS can lead to serious performance degradation as the scan attempts to open all files in the view.

Avoid scanning mapped drives to the MVFS on Windows. Scanning drives mapped to views is generally considered redundant as long as the view storage directories are being scanned. Similar performance problems related to scanning the MVFS drive itself can manifest itself during mapped drives scans as well.

Avoid scanning /view mount point on UNIX or Linux, as this is a mirror of the root directory for the file system.

Avoid scanning ClearCase Remote Client (CCRC) local view copy area storage directories and CCRC install directory. For optimal performance, consider disabling real-time scanning or avoid scanning the ClearCase Remote Client (CCRC) local view copy area storage directories and avoid scanning the directory into which CCRC is installed.

Related information TOC: ClearCase Matrices and Support Policies Cleaning a virus that was detected in ClearCase Japanese technote 1431194

2. How do I understand the RPC: Remote system error - [WINSOCK] No buffer space available issue

After installing McAfee Enterprise 8.0 on a Microsoft Windows machine, IBM Rational ClearCase omake builds fail with "RPC: Remote system error - [WINSOCK] No buffer space available" and system crashes. Cause Omake builds are failing after installation of McAfee 8.0 with the following errors: RPC: Remote system error - [WINSOCK] No buffer space available omake: Error: Error trying to contact view_server for view view:C:\viewstore\oa12.vws: No such file or directory

omake: Error: Unable to contact View - oa12 RPC: Remote system error - [WINSOCK] No buffer space available cleartool: Error: Error trying to contact view_server for view view:C:\viewstore\a12.vws: No such file or directory Insufficient system resources exist to complete the requested service. Fatal error C1083: Cannot open source file: '.\Font.cpp': Not enough space Solution Upgrade to McAfee Virus Scanner 8.10. or

Apply McAfee Virus Scanner 8.0i patch 15 which resolves this issue by adding the ClearCase MVFS to the "do not scan" list of the McAfee filter driver. The patch is available for download on the McAfee website. Note: This patch will fix a known memory leak issue and resolve other known ClearCase command problems.

http://www.ibm.com/support/docview.wss?uid=swg27007111http://www.ibm.com/support/docview.wss?uid=swg21123029http://www.ibm.com/support/docview.wss?uid=swg21431194https://knowledge.mcafee.com/SupportSite/search.do?cmd=displayKC&docType=kc&externalId=9019409&sliceId=SAL_Public&dialogID=1508712&stateId=0%200%201504577http://www.mcafee.com/us/


Page 14 of 341

Create view fails after uninstalling McAfee Firewall ClearCase commands fail when McAfee 8.x is installed Error running fix_prot with McAfee 8.0 installed Failure removing VOBs & views with McAfee installed

Veritas NetBackup and McAfee AntiVirus conflict About McAfee VirusScan Enterprise 8.0i Patch 11

Server Processes

3. How do I understand about the albd_rt_params.conf file What is the purpose of the IBM Rational ClearCase albd_rt_params.conf file and how can it be used? Answer Important note: The information in this technote provides details about the available options with the albd_rt_params.conf configuration file. These settings should only be changed by a ClearCase or system administrator who understands the impact as improper changes to this file could have negative performance consequences. If you are unsure about what settings to use, contact IBM Rational Client Support for further assistance before proceeding with any changes. About the albd_rt_params.conf file:

The albd_rt_params.conf file provides a run time configuration control of albd_server. Some of these configuration settings were previously controlled by setting environment variables. This caused problems on Unix systems since:

The easiest place to set those environment variables was the ClearCase startup script.

The startup script could be replaced during a patch install, reverting the albd to the default settings.

This file is a user-created file and is stored in the following location: UNIX or Linux:

/var/adm/rational/clearcase/config Windows:

C:\Program Files\Rational\ClearCase\var\config ClearCase 7.0 or later:


Page 15 of 341

Related information Improving VOB host performance MIN/MAX port limitations not honored

4. How do I understand about Rational ClearCase server processes Network protocols The protocols used for network communications are TCP (Transmission Control Protocol) and UDP (User Datagram Protocol), which are layered over IP (Internet Protocol). Most processes use TCP, but for optimization some use UDP. The protocol that a ClearCase server process uses is hard coded and cannot be manually configured, changed or disabled. Rational ClearCase server processes The Rational ClearCase server processes are documented under Rational ClearCase network planning and administration in IBM Rational ClearCase Administrator's Guide:

albd_server

admin_server

credmap_server

view_server

vob_server

db_server

vobrpc_server

lockmgr

rwp

ALBD Configuration File The ALBD configuration file, albd.conf, is used by the albd_server to determine the RPC services that will be available through it. This conf file provides a list of the registered server processes, declares what kind they are and what protocol (udp and/or tcp) they use. It is located

in %CLEARCASEHOME%\ClearCase\config\services, and it can be opened for viewing with a text

editor. However, albd.conf must not be modified manually in attempt to make customizations in the environment. In addition to the above processes (with the exceptions of lockmgr and rwp), this file also list:

promote_server

mntrpc_server

shipping_server

ws_helper

ctrack_server

host_agent

ccfs_server

msadm_server

https://publib.boulder.ibm.com/infocenter/cchelp/v7r1m0/index.jsp?topic=/com.ibm.rational.clearcase.cc_admin.doc/topics/c_perf_svr.htmhttp://www-01.ibm.com/support/docview.wss?uid=swg1PK70970http://publib.boulder.ibm.com/infocenter/cchelp/v7r0m0/topic/com.ibm.rational.clearcase.books.cc_admin.doc/intro.htm?resultof=%22%75%64%70%22%20http://publib.boulder.ibm.com/infocenter/cchelp/v7r0m0/topic/com.ibm.rational.clearcase.books.cc_admin.doc/intro.htm?resultof=%22%75%64%70%22%20http://publib.boulder.ibm.com/infocenter/cchelp/v7r0m0/topic/com.ibm.rational.clearcase.books.cc_admin.doc/cc_admin.htm


Page 16 of 341

MultiSite Configuration File There is a separate configuration file for ClearCase MultiSite, ms_albd.conf, that contains server definitions that are specific to the MultiSite product.

This conf file is also used by albd_server to determine the RPC services that will be available through it,

and it is located in %CLEARCASEHOME%\ClearCase\config\services:

Note: This conf file must not be modified manually in attempt to make customizations in the environment.

syncmgr_server

vob_synctool

Synchronization Management is detailed in IBM Rational ClearCase MultiSite Administrator's Guide. Credentials Manager ClearCase does not have a built-in authentication mechanism, and makes use of the security and access controls provided by the Windows operating system.

The credentials manager Service, cccredmgr, registers the clearcase group security identifier (SID) at system startup with MVFS.

The credentials manager is not only a server process, but it runs on any ClearCase host that is configured to support local VOBs and views to regulate VOB and view access control.

Active ClearCase Processes When ClearCase is installed on any host, you can run albd_list to show what processes are actually running, see technote 1148639 for more details.

MultiVersion File System MVFS (MultiVersion File System) is not a server process, it loads a kernel driver that presents a file system to the user through a standard interface; see technote 1230196.

5. How do I understand the Lock Manager process post and pre

ClearCase v7 About the Lock Manager prior to 7.0 In addition to the content in the Administrator's Guide, the following highlights outline the purpose, features and limitations of the lock manager process. Windows, Linux, AIX, SGI and other platforms

The lock manager is an individual process that co-ordinates concurrent access to VOB database files.

The lock manager has a hard limit of 1024 users which corresponds to the number of VOBs and or users accessing those VOBs for a given host.

On Solaris and HPUX

The coordination of VOB locking is performed by the db_server and vobrpc_server processes themselves.

A file, /var/adm/atria/almd is memory mapped by the lockmgr and all the db_server and vobrpc_server processes running on a VOB host - known as the shared memory lock manager (introduced in 4.1). Note: The shared memory lock manager has not been implemented for use on pSeries hardware.

A single mutex mechanism is used to control concurrent updates to this file. Note: Mutex is short for mutual exclusion object. A mutex is a program object that allows multiple program threads to share the same resource, such as file access, but not simultaneously. When a program is started, a mutex is created with a unique name. After this stage, any thread that needs the resource must lock the mutex from other threads while it is using the resource. The mutex is set to unlock when the data is no longer needed or the routine is finished.

The lock manager process is more of a lock janitor in this capacity as it just sets up and cleans up after the db_server and vobrpc_server processes.

http://publib.boulder.ibm.com/infocenter/cchelp/v7r0m0/topic/com.ibm.rational.clearcase.cc_ms_admin.doc/c_synch_mgt.htm?resultof=%22%73%79%6e%63%22%20%22%6d%61%6e%61%67%65%72%22%20%22%6d%61%6e%61%67%22%20http://publib.boulder.ibm.com/infocenter/cchelp/v7r0m0/topic/com.ibm.rational.clearcase.cc_ms_admin.doc/c_ms_intro.htmhttp://publib.boulder.ibm.com/infocenter/cchelp/v7r0m0/topic/com.ibm.rational.clearcase.books.cc_admin.doc/access-control.htm?resultof=%22%43%72%65%64%65%6e%74%69%61%6c%73%22%20%22%63%72%65%64%65%6e%74%69%22%20http://www-1.ibm.com/support/docview.wss?&rs=984&uid=swg21148639http://publib.boulder.ibm.com/infocenter/cchelp/v7r0m0/topic/com.ibm.rational.clearcase.hlp.doc/cc_mvfs/default_topic.htmhttp://www-1.ibm.com/support/docview.wss?&rs=984&uid=swg21230196


Page 17 of 341

Changes to the Lock Manager in 7.0 on UNIX and Linux Note: The 7.0 ClearCase Administrator's Guide does not include the details about the new lock manager. All of the information related to the new features are included below. As of ClearCase 7.0 the lock manager process has been removed for HP-UX, Itanium, Solaris, and Linux (x86). The lock manager functions have been absorbed by the db_server and vobrpc_server processes for VOBs and the syncmgr_server process for the MultiSite syncmgrdb. This means that each VOB in essence now has its own lock manager. This change will allow many more VOBs and users on a single machine. Note:

As of ClearCase 7.0 IFIX01, the lock manager enhancements in 7.0 now apply to AIX. Prior to the iFix, AIX uses a lock manager.

There are no changes to the lock manager on Windows (x86 or x64), Linux (x64, iSeries pSeries, and zSeries), or Solais x86. There is still a lock manager process on these platforms. The instructions outlined in the ClearCase Administrator's Guide still applies to these platforms.

New Configuration File on UNIX and Linux: The ability to have different parameters for each VOB on the system as well as a locally-specified override for server-wide settings is now possible through use of a configuration file called vob_almd_params. Note: Modifying this file does not require a reboot or even a restart of the ClearCase services; however, any changes made to the configuration file will be applied when the VOB is idle so as not to impact other operations in progress. A VOB is considered idle in this case when all of the db_server processes have completed work in that VOB. For example, if there are db_server processes still working (actively working or waiting to work) on a

VOB, the changes made to the configuration file will not become active until all but one of those db_servers complete their work. When the last db_server is finished, ClearCase will consider the host idle and will then implement the changes for that VOB. IMPORTANT: For sites with very high and constant activity in their VOBs, it is recommended you stop and restart ClearCase to avoid any potential problems like the one identified in technote 1253547. The vob_almd_params server wide configuration file is located in the /opt/rational/clearcase/config/vob/db directory and controls the settings for all VOBs on the host. The vob_almd_params files in the individual VOB db directory (/db/vob_almd_params) will modify the settings for that individual VOB, rather than all VOBs on a host. Note: The parameter values can be lower than the ones used in previous releases. The syntax employed within the vob_almd_params file: u num q num Upgrading UNIX and Linux:

Since there is no longer a lock manager on UNIX and Linux in Rational ClearCase 7.0, existing lock manager parameters will not be reused upon upgrade. Instead, these parameters are overwritten with default values. To preserve existing values for these parameters, save a copy of the host's /var/adm/rational/clearcase/config/lockmgr.conf before you upgrade. After the upgrade, you can restore these parameter values to one of the vob_almd_params files above. Note:

There is no longer a need to specify f any longer when customizing the vob_almd_params file.

The old u and -q parameters were used for ALL VOBs on the system. You will need to recalculate if you plan to apply settings on a per-VOB basis.

ClearCase Administrator's Guide addendum

The 7.0 and 2003.06.00 ClearCase Administrator's Guide contain the same content. Addendums to the sections listed below are provided.

1. The ClearCase Administrator's Guide under the lockmgr reference information > Options and argument > -u section states: You can compute a very approximate worst case value for u by using the formula: V*(N/4 + 5) where V is the number of VOBs on the host, and N is the number of users who access those

http://www-1.ibm.com/support/docview.wss?rs=984&uid=swg24012293http://www-1.ibm.com/support/docview.wss?rs=984&uid=swg24012808http://www.ibm.com/support/docview.wss?rs=984&uid=swg21253547


Page 18 of 341

VOBs. Note: For UNIX and Linux using the new lock manager process in ClearCase 7.0, V will equal 1 since there is one "lock manager" per VOB.

The formula will compute an approximate value; however, it is not worst case. Since one db_server process can consume up to 4 user table slots for each VOB the process is accessing, the worst case value for the user table (-u) should be: V*(N + 5) Note: The -q value in should be no more than 5*(-u value).

2. The ClearCase Administrator's Guide under the lockmgr reference information > Options and argument > -u section also states a better method to use to calculate the user table. For a more realistic valueone that does not cause the lock manager to consume unnecessary virtual memory on the VOB server hostmonitor the total number of db_server and vobrpc_server processes running on the VOB server host for an extended period of typical use (perhaps a week or two). Then multiply the peak value by a factor that will accommodate growth (two, or perhaps a little more).

Here is an example of what that section describes: If you count db_server and vobrpc_server processes and get 13 combined processes at 1:00 PM 18 processes at 1:30 PM 12 processes at 2:00 PM 13 processes at 2:30 PM and continue this pattern throughout the week, you will be able to find the maximum number for the user table. In this example the maximum was 18, so the -u value would be 36 which was derived by using twice the maximum number of processes at any one time ( 2 * 18). Note: The -q value in should be no more than 5*(-u value).

3. The ClearCase Administrator's Guide makes reference to a lockmgr_log file on UNIX and Linux. There is no lockmgr_log file. Any error related to the lock manager would appear in either the vobrpc_server log or the db_server log.

Related information How to monitor the Lock Manager on Windows How to monitor the Lock Manager on UNIX Diagnosing Lock Manager registry settings on Windows About deadman lock timeouts About Rollforward recovery warnings Possible errors when the vob_almd_params is modified

6. How do I - monitor the Lock Manager status on Windows The following steps will assist you in capturing diagnostic output needed to troubleshoot the Lock Manager on Windows.

1. Log onto the VOB server with local administrative rights or as the clearcase_albd account. 2. Stop the lock manager process (lockmgr.exe)

a. Open a command prompt (Start > Run > cmd) b. Execute the following command: net stop lockmgr

Example from 2003.06.00 C:\>net stop lockmgr The Rational Lock Manager service is stopping. The Rational Lock Manager service was stopped successfully.

3. Set up the lock manager with the following parameters by typing: lockmgr -a almd -q 1024 -u 1016 -f 1016 -nosvc

The -nosvc option is important. This option allows the lock manager to run in the command window and NOT AS A SERVICE in order to capture output.

http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21148943http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21122805http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21117488http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21119236http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21123492http://www-1.ibm.com/support/docview.wss?rs=0&uid=swg21253547


Page 19 of 341

Note: Make sure the command window has the ability to copy information from it (you will need it to capture the output).

4. In a separate command window, conduct ClearCase operations or allow the clients to work as usual.

5. Periodically, hit in the command window where lockmgr is running to collect statistics. Note: prints output to the screen. Keep hitting while the problem (what ever it may be) occurs and collect the output.

6. Once this is complete, use the Task Manager to kill the lock manager process and then Stop/Start all the ClearCase services.

a. Right click on the task bar and select Task Manager b. Click the Image Name column to organize the processes and locate the lockmgr.exe

process c. Right click on lockmgr.exe and select End Process d. At the command prompt, type cc.cpl to open the ClearCase Control Panel e. Stop and Restart the ClearCase Services

EXAMPLE OUTPUT: C:\>lockmgr -a almd -q 1024 -u 1016 -f 1016 -nosvc db_VISTA Version 3.20

Database Lock Manager for Microsoft Windows NT Copyright (C) 1986-1990 Raima Corporation, All Rights Reserved Lockmgr Named: almd Lock manager installed, pid = 2136 @ Mon Jun 17 13:43:20 2002 Table size: 1868656 bytes ========================================================== 1 tafs, 1 users, 7 open files Taf #0

Dev/inode: e88e4497/0ae02d99 Taf state: OKAY Tjf state: OKAY Seconds to journal checkpoint: 0 Number of locks: 0 Users: 0 --------------------- User #0 Status: LIVE PID: 3036 TAF: 0 Pending lock request count: 0 Seconds until timeout: 0 Recovering user #: -1 User name: 4469fe9d3036@@@@ Open files: 0 1 2 3 4 5 6

--------------------- File #0 Dev/inode: d4294e1c/2e12c564 Lock status: f Open users: 0 File #1 Dev/inode: 09784514/877aaadf Lock status: f Open users: 0 File #2 Dev/inode: 33544026/3c94d498 Lock status: f Open users: 0 File #3


Page 20 of 341

Dev/inode: bf554bca/399851f0 Lock status: f Open users: 0 File #4 Dev/inode: 736348aa/82fc6c5e

Lock status: f Open users: 0 File #5 Dev/inode: 13bd480b/972e7df5 Lock status: f Open users: 0 File #6 Dev/inode: 92344182/07f5995f Lock status: f Open users: 0 ==========================================================

7. How do I - Monitor the Lock Manager status on UNIX and Linux

Note: The lockmgr process has been retired as of Rational ClearCase 7.0 and replaced with different technology. Review the Documentation supplement referenced below for more details. The following steps will assist you in capturing diagnostic output needed to troubleshoot the Lock Manager on UNIX or Linux.

1. SU to root 2. Run: ps -ef | grep lockmgr 3. Find the lockmgr pid. 4. Run: kill -3 5. Run:

2002.05.00 (and earlier) grep "open files" /var/adm/atria/log/lockmgr_log

2003.06.00 (and later) grep "open files" /var/adm/rational/clearcase/log/lockmgr_log

Similar output as below will be printed to the screen. The last line is the current status of the lockmgr. 0 users, 0 open files 1 users, 7 open files 1 users, 7 open files 2 users, 14 open files

8. How do I - diagnosing Lock Manager registry settings on Windows how to verify if the IBM Rational ClearCase Lock Manager settings you added to the Microsoft Windows registry are in fact being used.

Despite having set the LockMgrCmdLine key and its associated values within the Windows registry, the following errors are still seen in the ClearCase logs: 2/14/03 04:31:57 db_server(4648): Error: db_server.exe(4648): Error: Cannot open database in "d:\ClearCase_Storage\VOBs\this.vbs\db" 02/14/03 04:31:57 db_server(4648): Error: db_server.exe(4648): Error: Too many open databases on host (try increasing -f argument on lockmgr command line) 02/14/03 04:31:52 db_server(4648): Error: db_server.exe(4648): Error: Cannot open database in "d:\ClearCase_Storage\VOBs\mySW.vbs\db" 02/14/03 04:31:52 db_server(4648): Error: db_server.exe(4648): Error: Too many open databases on host (try increasing -f argument on lockmgr command line) 02/14/03 04:31:52 db_server(4648): Error: db_server.exe(4648): Error: Cannot open database in "d:\ClearCase_Storage\VOBs\theSW.vbs\db" 02/14/03 04:31:52 db_server(4648): Error: db_server.exe(4648): Error: Too many open databases on host (try increasing -f argument on lockmgr command line) 02/14/03 04:31:52 db_server(4648): Error: db_server.exe(4648): Error: Cannot open database in

"d:\ClearCase_Storage\VOBs\newSYS.vbs\db" It appears the LockMgrCmdLine value is not being read from the registry and is using the default. Solution

http://www-1.ibm.com/support/docview.wss?rs=984&uid=swg24012293


Page 21 of 341

In order to determine if this is the case, you need to do the following: 1. Download Regmon from http://www.sysinternals.com/utilities/regmon.html. 2. Stop the ClearCase services. 3. Run the regmon utility.

4. Start the ClearCase services. 5. In the regmon tracing, select Edit > Find > LockMgrCmdLine

If the result is SUCCESS/FAILURE, this means that Windows is properly using the registry values assigned. Please review technote 1125258 to help determine the correct value for the -f parameter as it needs to be increased.

If the result is NOT FOUND, double click the entry in Regmon. This will take the you directly to the value in the Registry. Check to make sure the entry is actually there, that there are no spelling errors or a

preceding space in the key or value.

9. How do I understand about the db.conf configuration file The db.conf file is an optional configuration file for the db_server process used for making changes to the way the db_server operates. Note: The db.conf file is not created during the Rational ClearCase installation. This file needs to be created manually and stored in the following locations: UNIX and Linux: /var/adm/atria/config or

/var/adm/rational/clearcase/config Microsoft Windows: C:\Program Files\Rational\ClearCase\var\c

clearcase environment how do i web page - samecssamecs.com/how_do_i/clearcase...

Documents