Remove questions that have been moved to 'Common Errors' in the HOWTO Collection.
[nivanova/samba-autobuild/.git] / 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>