AFSLore/WindowsTroubleshootingGuide.mdwn

   1 # <a name="Troubleshooting Guide for _OpenA"></a> Troubleshooting Guide for [[OpenAFS]] for Windows
   2
   3 <div>
   4   <ul>
   5     <li><a href="#Troubleshooting Guide for _OpenA"> Troubleshooting Guide for OpenAFS for Windows</a><ul>
   6         <li><a href="#Bugs"> Bugs</a><ul>
   7             <li><a href="#How come my non-ASCII filename c"> How come my non-ASCII filename characters are wrong; code page problems?</a></li>
   8             <li><a href="#Why does _OpenAFS for Windows cr"> Why does OpenAFS for Windows crash on my Hyperthreaded Pentium 4?</a></li>
   9           </ul>
  10         </li>
  11         <li><a href="#Error Messages"> Error Messages</a><ul>
  12             <li><a href="#What is this _MrxSmb event 3019"> What is this MrxSmb event 3019 that pops up in my System Log?</a></li>
  13             <li><a href="#Why isn't the AFS Light Gateway"> Why isn't the AFS Light Gateway working anymore?</a></li>
  14           </ul>
  15         </li>
  16         <li><a href="#Nomenclature"> Nomenclature</a><ul>
  17             <li><a href="#What is a "submount"?"> What is a "submount"?</a></li>
  18           </ul>
  19         </li>
  20       </ul>
  21     </li>
  22   </ul>
  23 </div>
  24
  25 ## <a name="Bugs"></a> Bugs
  26
  27 ### <a name="How come my non-ASCII filename c"></a> How come my non-ASCII filename characters are wrong; code page problems?
  28
  29 Yes, it is. Currently, the [[OpenAFS]] implementation uses a SMB server with which Windows communicates. This server is not yet able to handle all code pages. So, if you are accessing files from other systems as well, you will experience the old code page missmatch problem.
  30
  31 The CIFS protocol itself has support for Unicode. Hopefully, it will be implemented in [[OpenAFS]] in the future. (from J. Altman)
  32
  33 ### <a name="Why does _OpenAFS for Windows cr"></a> Why does [[OpenAFS]] for Windows crash on my Hyperthreaded Pentium 4?
  34
  35 This is due to a known bug. Set `MaxCPUs` (type DWORD) (in `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\TransarcAFSDaemon\Parameters`) to 1. This restricts the [[OpenAFS]] Client Service to use one processor.
  36
  37 ## <a name="Error Messages"></a> Error Messages
  38
  39 ### <a name="What is this _MrxSmb event 3019"></a><a name="What is this _MrxSmb event 3019 "></a> What is this [[MrxSmb]] event 3019 that pops up in my System Log?
  40
  41 The [[MrxSmb]] event 3019 is due to the use of the Loop Back device. It can be safely ignored. (from [JSI FAQ, 3136](http://www.jsiinc.com/SUBG/TIP3100/rh3136.htm))
  42
  43 ### <a name="Why isn&#39;t the AFS Light Gateway"></a><a name="Why isn&#39;t the AFS Light Gateway "></a> Why isn't the AFS Light Gateway working anymore?
  44
  45 The Light Gateway works by simply publishing what [[OpenAFS]] has already built for internal use. If you install the Microsoft Loop Back Adapter, the submounts will only be published on the local computer. Either remove the Loop Back Adapter, or stop using the gateway functionality.
  46
  47 ## <a name="Nomenclature"></a> Nomenclature
  48
  49 ### <a name="What is a &quot;submount&quot;?"></a> What is a "submount"?
  50
  51 A submount is used in [[OpenAFS]] for Windows to map drives. Instead of mapping drives directly to the AFS server, the [[OpenAFS]] Client uses another approach. It uses the CIFS file system as an intermediary. So, the Windows computer really thinks it maps a normal Windows share. These shares are the same thing as a submount. When you want to map a drive, the [[OpenAFS]] service creates a submount, exports it for Windows to see it, and maps the share. The submount "all" is always available and is the root of the AFS file system (`/afs` in Unix). This means you can always access any cell by writing `\\AFS\all\cell\...`.
  52
  53 This is a quick-and-dirty approach, but it has an upside. In Unix, the way to shorten a path is to install a symbolic link. In Windows, this is not possible. Using submounts, however, you can create shortcuts to any AFS path. Say you often use the path `/afs/openafs.org/usr/someone/development/code/openafs/src/WINNT`. Then you could create a submount (say, "openafs-nt") of it, thus reducing the path to `\\AFS\openafs-nt`.