From owner-svn-doc-all@FreeBSD.ORG Thu May 22 15:18:46 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 3A2AE664; Thu, 22 May 2014 15:18:46 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 264CA2C3F; Thu, 22 May 2014 15:18:46 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s4MFIka8005716; Thu, 22 May 2014 15:18:46 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s4MFIkFf005715; Thu, 22 May 2014 15:18:46 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405221518.s4MFIkFf005715@svn.freebsd.org> From: Dru Lavigne Date: Thu, 22 May 2014 15:18:46 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44907 - head/en_US.ISO8859-1/books/handbook/bsdinstall X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 22 May 2014 15:18:46 -0000 Author: dru Date: Thu May 22 15:18:45 2014 New Revision: 44907 URL: http://svnweb.freebsd.org/changeset/doc/44907 Log: Finish editorial review of Post-Install and Troubleshooting sections. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Thu May 22 12:54:22 2014 (r44906) +++ head/en_US.ISO8859-1/books/handbook/bsdinstall/chapter.xml Thu May 22 15:18:45 2014 (r44907) @@ -2294,8 +2294,9 @@ Ethernet address 0:3:ba:b:92:d4, Host ID Add Users - Adding at least one user during the installation allows - the system to be used without being logged in as The next menu prompts to create at least one user account. + It is recommended to login to the system using a user account + rather than as root. When logged in as root, there are essentially no limits or protection on what can be done. @@ -2314,7 +2315,10 @@ Ethernet address 0:3:ba:b:92:d4, Host ID - Enter the information for the user to be added. + Follow the prompts and input the requested information for + the user account. The example shown in creates the asample user account.
Enter User Information @@ -2326,18 +2330,21 @@ Ethernet address 0:3:ba:b:92:d4, Host ID
- - User Information + Here is a summary of the information to input: + Username - The name the user will - enter to log in. Typically the first letter of their - first name combined with their last name. + enter to log in. A common convention is to use the first letter of the + first name combined with the last name, as long as each + username is unique for the system. The username is case + sensitive and should not contain any spaces. Full name - The user's full - name. + name. This can contain spaces and is used as a + description for the user account. @@ -2348,13 +2355,15 @@ Ethernet address 0:3:ba:b:92:d4, Host ID Login group - The user's group. - Typically left blank to accept the default. + Typically this is left blank to accept the default. Invite user into other groups? - Additional groups to which the - user will be added as a member. + user will be added as a member. If the user needs + administrative access, type wheel + here. @@ -2363,9 +2372,10 @@ Ethernet address 0:3:ba:b:92:d4, Host ID - Shell - The interactive shell for - this user. In the example, &man.csh.1; has been - chosen. + Shell - Type in one of the listed + values to set the interactive shell for + the user. Refer to for more + information about shells. @@ -2381,21 +2391,24 @@ Ethernet address 0:3:ba:b:92:d4, Host ID Use password-based authentication? - - Typically yes. + - Typically yes so that the user is + prompted to input their password at login. Use an empty password? - - Typically no. + Typically no as it is insecure to have + a blank password. Use a random password? - Typically - no. + no so that the user can set their own + password in the next prompt. - Enter password - The actual + Enter password - The password for this user. Characters typed will not show on the screen. @@ -2408,13 +2421,12 @@ Ethernet address 0:3:ba:b:92:d4, Host ID Lock out the account after creation? - Typically - no. + no so that the user can login. - After entering everything, a summary is shown, and the - system asks if it is correct. If a mistake was made during - entry, enter no and try again. If + After entering everything, a summary is shown for review. + If a mistake was made, enter no and try again. If everything is correct, enter yes to create the new user. @@ -2458,8 +2470,6 @@ Ethernet address 0:3:ba:b:92:d4, Host ID configuration before completing the installation. - Final Configuration Options - Add User - Described in . @@ -2497,7 +2507,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID After any final configuration is complete, select - Exit to leave the installation. + Exit.
Manual Configuration @@ -2514,7 +2524,7 @@ Ethernet address 0:3:ba:b:92:d4, Host ID are any additional configuration that needs to be done before rebooting into the new system. Select [ Yes ] to exit to a shell - within the new system, or + within the new system or [ No ] to proceed to the last step of the installation. @@ -2529,170 +2539,47 @@ Ethernet address 0:3:ba:b:92:d4, Host ID
If further configuration or special setup is needed, - selecting [ Live CD ] - will boot the install media into Live CD + select [ Live CD ] + to boot the install media into Live CD mode. - When the installation is complete, select + If the installation is complete, select [ Reboot ] to reboot the computer and start the new &os; system. Do not forget to - remove the &os; install CD, - DVD, or USB memory - stick, or the computer may boot from it again. - - - - &os; Booting and Shutdown + remove the &os; install media + or the computer may boot from it again. - - &os;/&arch.i386; Booting - - As &os; boots, many informational messages are - displayed. Most will scroll off the screen; this is normal. + As &os; boots, informational messages are + displayed. After the system finishes booting, a login prompt is - displayed. Messages that scrolled off the screen can be + displayed. At the login: prompt, enter the + username added during the installation. + Avoid logging in as root. Refer to for instructions on how to + become the superuser when administrative access is + needed. + + The messages that appeared during boot can be reviewed by pressing Scroll-Lock to turn on - the scroll-back buffer. The + the scroll-back buffer. The PgUp, PgDn, and arrow keys - can be used to scroll back through the messages. Pressing - Scroll-Lock again unlocks the display and - returns to the normal screen. - - At the login: prompt, enter the - username added during the installation, asample in the example. - Avoid logging in as root except when - necessary. - - The scroll-back buffer examined above is limited in - size, so not all of the messages may have been visible. - After logging in, most of them can be seen from the command - line by typing dmesg | less at the + can be used to scroll back through the messages. When finished, press + Scroll-Lock again to unlock the display and + return to the console. To review these messages once the + system has been up for some time, type + less /var/run/dmesg.boot from a command prompt. Press q to return to the command line after viewing. - Typical boot messages (version information - omitted): + If sshd was enabled in , the first boot may be + a bit slower as the system will generate the RSA and + DSA keys. Subsequent boots will be + faster. The fingerprints of the keys will be displayed, as seen in + this example: - Copyright (c) 1992-2011 The FreeBSD Project. -Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994 - The Regents of the University of California. All rights reserved. -FreeBSD is a registered trademark of The FreeBSD Foundation. - - root@farrell.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64 -CPU: Intel(R) Core(TM)2 Duo CPU E8400 @ 3.00GHz (3007.77-MHz K8-class CPU) - Origin = "GenuineIntel" Id = 0x10676 Family = 6 Model = 17 Stepping = 6 - Features=0x783fbff<FPU,VME,DE,PSE,TSC,MSR,PAE,MCE,CX8,APIC,SEP,MTRR,PGE,MCA,CMOV,PAT,PSE36,MMX,FXSR,SSE,SSE2> - Features2=0x209<SSE3,MON,SSSE3> - AMD Features=0x20100800<SYSCALL,NX,LM> - AMD Features2=0x1<LAHF> -real memory = 536805376 (511 MB) -avail memory = 491819008 (469 MB) -Event timer "LAPIC" quality 400 -ACPI APIC Table: <VBOX VBOXAPIC> -ioapic0: Changing APIC ID to 1 -ioapic0 <Version 1.1> irqs 0-23 on motherboard -kbd1 at kbdmux0 -acpi0: <VBOX VBOXXSDT> on motherboard -acpi0: Power Button (fixed) -acpi0: Sleep Button (fixed) -Timecounter "ACPI-fast" frequency 3579545 Hz quality 900 -acpi_timer0: <32-bit timer at 3.579545MHz> port 0x4008-0x400b on acpi0 -cpu0: <ACPI CPU> on acpi0 -pcib0: <ACPI Host-PCI bridge> port 0xcf8-0xcff on acpi0 -pci0: <ACPI PCI bus> on pcib0 -isab0: <PCI-ISA bridge> at device 1.0 on pci0 -isa0: <ISA bus> on isab0 -atapci0: <Intel PIIX4 UDMA33 controller> port 0x1f0-0x1f7,0x3f6,0x170-0x177,0x376,0xd000-0xd00f at device 1.1 on pci0 -ata0: <ATA channel 0> on atapci0 -ata1: <ATA channel 1> on atapci0 -vgapci0: <VGA-compatible display> mem 0xe0000000-0xe0ffffff irq 18 at device 2.0 on pci0 -em0: <Intel(R) PRO/1000 Legacy Network Connection 1.0.3> port 0xd010-0xd017 mem 0xf0000000-0xf001ffff irq 19 at device 3.0 on pci0 -em0: Ethernet address: 08:00:27:9f:e0:92 -pci0: <base peripheral> at device 4.0 (no driver attached) -pcm0: <Intel ICH (82801AA)> port 0xd100-0xd1ff,0xd200-0xd23f irq 21 at device 5.0 on pci0 -pcm0: <SigmaTel STAC9700/83/84 AC97 Codec> -ohci0: <OHCI (generic) USB controller> mem 0xf0804000-0xf0804fff irq 22 at device 6.0 on pci0 -usbus0: <OHCI (generic) USB controller> on ohci0 -pci0: <bridge> at device 7.0 (no driver attached) -acpi_acad0: <AC Adapter> on acpi0 -atkbdc0: <Keyboard controller (i8042)> port 0x60,0x64 irq 1 on acpi0 -atkbd0: <AT Keyboard> irq 1 on atkbdc0 -kbd0 at atkbd0 -atkbd0: [GIANT-LOCKED] -psm0: <PS/2 Mouse> irq 12 on atkbdc0 -psm0: [GIANT-LOCKED] -psm0: model IntelliMouse Explorer, device ID 4 -attimer0: <AT timer> port 0x40-0x43,0x50-0x53 on acpi0 -Timecounter "i8254" frequency 1193182 Hz quality 0 -Event timer "i8254" frequency 1193182 Hz quality 100 -sc0: <System console> at flags 0x100 on isa0 -sc0: VGA <16 virtual consoles, flags=0x300> -vga0: <Generic ISA VGA> at port 0x3c0-0x3df iomem 0xa0000-0xbffff on isa0 -atrtc0: <AT realtime clock> at port 0x70 irq 8 on isa0 -Event timer "RTC" frequency 32768 Hz quality 0 -ppc0: cannot reserve I/O port range -Timecounters tick every 10.000 msec -pcm0: measured ac97 link rate at 485193 Hz -em0: link state changed to UP -usbus0: 12Mbps Full Speed USB v1.0 -ugen0.1: <Apple> at usbus0 -uhub0: <Apple OHCI root HUB, class 9/0, rev 1.00/1.00, addr 1> on usbus0 -cd0 at ata1 bus 0 scbus1 target 0 lun 0 -cd0: <VBOX CD-ROM 1.0> Removable CD-ROM SCSI-0 device -cd0: 33.300MB/s transfers (UDMA2, ATAPI 12bytes, PIO 65534bytes) -cd0: Attempt to query device size failed: NOT READY, Medium not present -ada0 at ata0 bus 0 scbus0 target 0 lun 0 -ada0: <VBOX HARDDISK 1.0> ATA-6 device -ada0: 33.300MB/s transfers (UDMA2, PIO 65536bytes) -ada0: 12546MB (25694208 512 byte sectors: 16H 63S/T 16383C) -ada0: Previously was known as ad0 -Timecounter "TSC" frequency 3007772192 Hz quality 800 -Root mount waiting for: usbus0 -uhub0: 8 ports with 8 removable, self powered -Trying to mount root from ufs:/dev/ada0p2 [rw]... -Setting hostuuid: 1848d7bf-e6a4-4ed4-b782-bd3f1685d551. -Setting hostid: 0xa03479b2. -Entropy harvesting: interrupts ethernet point_to_point kickstart. -Starting file system checks: -/dev/ada0p2: FILE SYSTEM CLEAN; SKIPPING CHECKS -/dev/ada0p2: clean, 2620402 free (714 frags, 327461 blocks, 0.0% fragmentation) -Mounting local file systems:. -vboxguest0 port 0xd020-0xd03f mem 0xf0400000-0xf07fffff,0xf0800000-0xf0803fff irq 20 at device 4.0 on pci0 -vboxguest: loaded successfully -Setting hostname: machine3.example.com. -Starting Network: lo0 em0. -lo0: flags=8049<UP,LOOPBACK,RUNNING,MULTICAST> metric 0 mtu 16384 - options=3<RXCSUM,TXCSUM> - inet6 ::1 prefixlen 128 - inet6 fe80::1%lo0 prefixlen 64 scopeid 0x3 - inet 127.0.0.1 netmask 0xff000000 - nd6 options=21<PERFORMNUD,AUTO_LINKLOCAL> -em0: flags=8843<UP,BROADCAST,RUNNING,SIMPLEX,MULTICAST> metric 0 mtu 1500 - options=9b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_HWTAGGING,VLAN_HWCSUM> - ether 08:00:27:9f:e0:92 - nd6 options=29<PERFORMNUD,IFDISABLED,AUTO_LINKLOCAL> - media: Ethernet autoselect (1000baseT <full-duplex>) - status: active -Starting devd. -Starting Network: usbus0. -DHCPREQUEST on em0 to 255.255.255.255 port 67 -DHCPACK from 10.0.2.2 -bound to 192.168.1.142 -- renewal in 43200 seconds. -add net ::ffff:0.0.0.0: gateway ::1 -add net ::0.0.0.0: gateway ::1 -add net fe80::: gateway ::1 -add net ff02::: gateway ::1 -ELF ldconfig path: /lib /usr/lib /usr/lib/compat /usr/local/lib -32-bit compatibility ldconfig path: /usr/lib32 -Creating and/or trimming log files. -Starting syslogd. -No core dumps found. -Clearing /tmp (X related). -Updating motd:. -Configuring syscons: blanktime. -Generating public/private rsa1 key pair. + Generating public/private rsa1 key pair. Your identification has been saved in /etc/ssh/ssh_host_key. Your public key has been saved in /etc/ssh/ssh_host_key.pub. The key fingerprint is: @@ -2726,52 +2613,26 @@ The key's randomart image is: | . . o . | | .o. . | +-----------------+ -Starting sshd. -Starting cron. -Starting background file system checks in 60 seconds. - -Thu Oct 6 19:15:31 MDT 2011 - -FreeBSD/amd64 (machine3.example.com) (ttyv0) - -login: - - Generating the RSA and - DSA keys may take some time on slower - machines. This happens only on the initial boot-up of a new - installation, and only if sshd is - set to start automatically. Subsequent boots will be - faster. - - &os; does not install graphical environments by default, - but many are available. See for more - information. - - +Starting sshd. + + Refer to for more information + about fingerprints and SSH. - - &os; Shutdown + &os; does not install a graphical environment by default. + Refer to for more + information about installing and configuring a graphical + window manager. Proper shutdown of a &os; computer helps protect data and - even hardware from damage. Do not turn off the power before - the system has been properly shut down. If the user is a + hardware from damage. Do not turn off the power before + the system has been properly shut down! If the user is a member of the wheel group, become the superuser by typing su at the command line and entering the root password. Otherwise, log - in as root and use - shutdown -p now. The system will close - down cleanly and turn itself off. - - The - - Ctrl - Alt - Del - - key combination can be used to reboot the system, but is not - recommended during normal operation. + class="username">root password. Then, type + shutdown -p now and the system will shut + down cleanly, and if the hardware supports it, turn itself off. @@ -2782,27 +2643,18 @@ login: installation troubleshooting - The following section covers basic installation + This section covers basic installation troubleshooting, such as common problems people have reported. - - What to Do If Something Goes Wrong - - Due to various limitations of the PC architecture, it is - impossible for probing to be 100% reliable, however, there are - a few things to try if it fails. - Check the Hardware Notes (http://www.freebsd.org/releases/index.html) - document for the version of &os; to make sure your hardware is - supported. - - If the hardware is supported and lock-ups or other + document for the version of &os; to make sure the hardware is + supported. If the hardware is supported and lock-ups or other problems occur, build a custom kernel using the instructions in to add support for devices which are not present in the GENERIC - kernel. The kernel on the boot disks is configured assuming + kernel. The default kernel assumes that most hardware devices are in their factory default configuration in terms of IRQs, I/O addresses, and DMA @@ -2810,11 +2662,6 @@ login: kernel configuration file can tell &os; where to find things. - It is also possible that a probe for a device not present - will cause a later probe for another device that is present to - fail. In that case, the probes for the conflicting driver(s) - should be disabled. - Some installation problems can be avoided or alleviated by updating the firmware on various hardware components, @@ -2830,21 +2677,11 @@ login: BIOS incomplete and the computer inoperative. - - - Troubleshooting Questions and Answers - - - - - My system hangs while probing hardware during boot, - or it behaves strangely during install. - - - - &os; makes extensive use of the system - ACPI service on the i386, amd64, and + If the system hangs while probing hardware during boot, + or it behaves strangely during install, + ACPI may be the culprit. &os; makes extensive use of the system + ACPI service on the &arch.i386;, &arch.amd64;, and ia64 platforms to aid in system configuration if it is detected during boot. Unfortunately, some bugs still exist in both the ACPI driver and @@ -2861,10 +2698,6 @@ login: /boot/loader.conf. More information about the boot loader can be found in . - - - -