Bug 33937

Summary: Add a timezone related hint to make world section of hb
Product: Documentation Reporter: Nils Holland <nils>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Nils Holland 2002-01-16 10:10:10 UTC
	If a machine's time is set to local time (for example, CET) and
	not GMT, there is a potential that (not too dramatic, but still
	weird) problems may occur during a make installworld process.
	/usr/src/UDPATING therefore suggests that users running at local
	time run "adjkerntz -i" after having booted into single user
	mode and before starting the installworld process. However,
	in order to read this suggestion in UPDATING, one would have
	to scroll way down. Therefore, I guess the handbook should
	probably include the "adjkerntz -i" statement as well, and so
	I included it in the part that tells users how to boot into
	single user mode, right after the commands that are supposed
	to clean / mount the filesystems.

Fix: The following patch, applied to handbook/cutting-edge/chapter.sgml
	fixes it ;-)

How-To-Repeat: 	Boot into single user mode using boot -s, install world, reboot
	and notice that the files you have just installed are dated one
	hour in the future (IF your machine is set to local time). Try the
	same, but run adjkerntz -i before installworld and everything will
	be fine. Browse through /usr/src/UPDATING and see that somewhere,
	near the part on going from 3.x to 4.x, it also suggests local-time
	users to run adjkerntz -i, so I guess we should do the same ;-)
	(NOTE: To actually run into problems with this, you'd have to try
	to install certain ports, which will fail until the timestamp of the
	files installed by installworld is past ;-)
Comment 1 ru freebsd_committer freebsd_triage 2002-01-16 11:09:36 UTC
This info indeed should be added, thanks!

On Wed, Jan 16, 2002 at 11:07:37AM +0100, Nils Holland wrote:
> 
> *** chapter.sgml	Wed Jan 16 10:27:30 2002
> --- chapter-new	Wed Jan 16 10:57:24 2002
> ***************
> *** 754,759 ****
> --- 754,769 ----
>         <para>This checks the filesystems, remounts <filename>/</filename>
>   	read/write, mounts all the other UFS filesystems referenced in
>   	<filename>/etc/fstab</filename> and then turns swapping on.</para>
> + 	
> + 	<para>If your CMOS clock is set to local time and not to GMT,
> + 	you should also run the following command:</para>
> + &prompt.root; <userinput>adjkerntz -i</userinput></screen>
> + 
> + 	<para>This will make sure that your local timezone settings
> + 	get set up correctly - without this, you may later run into some
> + 	not dramatic, but still weird problems.</para>
> + 
> + 
>       </sect2>
>   
>       <sect2>

-- 
Ruslan Ermilov		Oracle Developer/DBA,
ru@sunbay.com		Sunbay Software AG,
ru@FreeBSD.org		FreeBSD committer,
+380.652.512.251	Simferopol, Ukraine

http://www.FreeBSD.org	The Power To Serve
http://www.oracle.com	Enabling The Information Age
Comment 2 Jim Mock freebsd_committer freebsd_triage 2002-02-11 19:04:22 UTC
State Changed
From-To: open->closed

Committed, thanks!