docs/docbook/faq/install.xml

   1 <chapter id="FAQ-Install">
   2 <title>Compiling and installing Samba on a Unix host</title>
   3
   4 <sect1>
   5 <title>My client reports "cannot locate specified share name" or similar</title>
   6 <para>
   7 This message indicates that your client CAN locate the specified
   8 server, which is a good start, but that it cannot find a service of
   9 the name you gave.
  10 </para>
  11
  12 <para>
  13 The first step is to check the exact name of the service you are
  14 trying to connect to (consult your system administrator). Assuming it
  15 exists and you specified it correctly (read your client's docs on how
  16 to specify a service name correctly), read on:
  17 </para>
  18
  19 <simplelist>
  20 <member>Many clients cannot accept or use service names longer than eight characters.</member>
  21 <member>Many clients cannot accept or use service names containing spaces.</member>
  22 <member>Some servers (not Samba though) are case sensitive with service names.</member>
  23 <member>Some clients force service names into upper case.</member>
  24 </simplelist>
  25 </sect1>
  26
  27 <sect1>
  28 <title>Why are my file's timestamps off by an hour, or by a few hours?</title>
  29 <para>
  30 This is from Paul Eggert eggert@twinsun.com.
  31 </para>
  32
  33 <para>
  34 Most likely it's a problem with your time zone settings.
  35 </para>
  36
  37 <para>
  38 Internally, Samba maintains time in traditional Unix format,
  39 namely, the number of seconds since 1970-01-01 00:00:00 Universal Time
  40 (or ``GMT''), not counting leap seconds.
  41 </para>
  42
  43 <para>
  44 On the server side, Samba uses the Unix TZ variable to convert
  45 internal timestamps to and from local time.  So on the server side, there are
  46 two things to get right.
  47 <simplelist>
  48 <member>The Unix system clock must have the correct Universal time. Use the shell command "sh -c 'TZ=UTC0 date'" to check this.</member>
  49 <member>The TZ environment variable must be set on the server before Samba is invoked.  The details of this depend on the server OS, but typically you must edit a file whose name is /etc/TIMEZONE or /etc/default/init, or run the command `zic -l'.</member>
  50 </simplelist>
  51 </para>
  52
  53 <para>TZ must have the correct value.</para>
  54
  55 <para>
  56 If possible, use geographical time zone settings
  57 (e.g. TZ='America/Los_Angeles' or perhaps
  58  TZ=':US/Pacific').  These are supported by most
  59 popular Unix OSes, are easier to get right, and are
  60 more accurate for historical timestamps.  If your
  61 operating system has out-of-date tables, you should be
  62 able to update them from the public domain time zone
  63 tables at <ulink url="ftp://elsie.nci.nih.gov/pub/">ftp://elsie.nci.nih.gov/pub/</ulink>.
  64 </para>
  65
  66 <para>If your system does not support geographical timezone
  67 settings, you must use a Posix-style TZ strings, e.g.
  68 TZ='PST8PDT,M4.1.0/2,M10.5.0/2' for US Pacific time.
  69 Posix TZ strings can take the following form (with optional
  70                                                                                           items in brackets):
  71 <programlisting>
  72         StdOffset[Dst[Offset],Date/Time,Date/Time]
  73 </programlisting>
  74                 where:
  75 </para>
  76
  77 <para><simplelist>
  78 <member>`Std' is the standard time designation (e.g. `PST').</member>
  79 <member>`Offset' is the number of hours behind UTC (e.g. `8').
  80 Prepend a `-' if you are ahead of UTC, and
  81 append `:30' if you are at a half-hour offset.
  82 Omit all the remaining items if you do not use
  83 daylight-saving time.</member>
  84
  85 <member>`Dst' is the daylight-saving time designation
  86 (e.g. `PDT').</member>
  87
  88 <member>The optional second `Offset' is the number of
  89 hours that daylight-saving time is behind UTC.
  90 The default is 1 hour ahead of standard time.
  91 </member>
  92
  93 <member>`Date/Time,Date/Time' specify when daylight-saving
  94 time starts and ends.  The format for a date is
  95 `Mm.n.d', which specifies the dth day (0 is Sunday)
  96 of the nth week of the mth month, where week 5 means
  97 the last such day in the month.  The format for a
  98 time is [h]h[:mm[:ss]], using a 24-hour clock.
  99 </member>
 100
 101 </simplelist>
 102 </para>
 103
 104 <para>
 105 Other Posix string formats are allowed but you don't want
 106 to know about them.</para>
 107
 108 <para>
 109 On the client side, you must make sure that your client's clock and
 110 time zone is also set appropriately.  [[I don't know how to do this.]]
 111 Samba traditionally has had many problems dealing with time zones, due
 112 to the bizarre ways that Microsoft network protocols handle time
 113 zones.
 114 </para>
 115 </sect1>
 116
 117 </chapter>