From cfed927960959cb19c4d26585b20e25e78ebd9cc Mon Sep 17 00:00:00 2001 From: Randy Pratt Date: Sat, 1 Sep 2001 07:27:25 +0000 Subject: [PATCH] Finish the cleanup of sgml markup for and . Revision of text to a more formal tone. Revise parts to reflect the new menus in 4.4 Reviewed by: murray --- .../books/handbook/install/chapter.sgml | 507 ++++++++++++------ 1 file changed, 329 insertions(+), 178 deletions(-) diff --git a/en_US.ISO8859-1/books/handbook/install/chapter.sgml b/en_US.ISO8859-1/books/handbook/install/chapter.sgml index e2bcd06107..2a50d1facf 100644 --- a/en_US.ISO8859-1/books/handbook/install/chapter.sgml +++ b/en_US.ISO8859-1/books/handbook/install/chapter.sgml @@ -1,7 +1,7 @@ @@ -1068,7 +1068,8 @@ Mounting root from ufs:/dev/md0c Selecting The Documentation Menu - From the Main Menu, select "Doc" with the arrow keys and + From the Main Menu, select Doc with + the arrow keys and press Enter.
@@ -1100,7 +1101,8 @@ Mounting root from ufs:/dev/md0c pressing Enter will return to the Documentation Menu. - To return to the Main Installation Menu, select "Exit" with the + To return to the Main Installation Menu, select + Exit with the arrow keys and press Enter. @@ -1108,7 +1110,8 @@ Mounting root from ufs:/dev/md0c Selecting The Keymap Menu To change the keyboard mapping, use the arrow keys to select - "Keymap" from the menu and press Enter + Keymap from the menu and press + Enter
Sysinstall Main Menu @@ -1123,12 +1126,13 @@ Mounting root from ufs:/dev/md0c A different keyboard mapping may be chosen by selecting the menu item using up/down arrow keys and pressing Space. Pressing Space again will unselect the item. When - finished, choose the [OK] item using the arrow keys and press + finished, choose the [ OK ] using the + arrow keys and press Enter. Only a partial list is shown in this screen representation. - Selecting [CANCEL] will use the default keymap and return to the - Main Install Menu. + Selecting [Cancel] will use the default + keymap and return to the Main Install Menu.
Sysinstall Keymap Menu @@ -1145,7 +1149,8 @@ Mounting root from ufs:/dev/md0c Installation Options Screen - Select "Options" and press Enter + Select Options and press + Enter
Sysinstall Main Menu @@ -1172,8 +1177,8 @@ Mounting root from ufs:/dev/md0c The description of the selected item will appear at the bottom of the screen highlighted in blue. Notice that one of the - options is "Use Defaults" to reset all values to startup - defaults. + options is Use Defaults to reset all + values to startup defaults. Press F1 to read the help screen about the various options. @@ -1185,8 +1190,9 @@ Mounting root from ufs:/dev/md0c Begin A Standard Installation - The "Standard" installation is the option recommended for those - new to Unix or FreeBSD. Use the arrow keys to select "Standard" and + The Standard installation is the + option recommended for those new to Unix or FreeBSD. Use the arrow + keys to select Standard and then press Enter to start the installation.
@@ -1847,7 +1853,8 @@ Mounting root from ufs:/dev/md0c
- Make sure [OK] is highlighted, then press Enter + Make sure [ OK ] is highlighted, then + press Enter to continue with the installation. @@ -2209,9 +2216,15 @@ Mounting root from ufs:/dev/md0c If a graphical user interface is desired then a distribution set that is preceded by an X should be chosen. The configuration of XFree86 and selection of a default - desktop is part of the post-installation steps. For more - information on the XFree86 distribution see - . + desktop is part of the post-installation steps. + + The default XFree86 version installed is the 3.x branch. You + should check to see whether your video card is supported at the + XFree86 web site. + If it is only supported under the 4.x branch, then you will need + to install and configure XFree86 4.x after installation. Select a + distribution without X and refer to for + more information. If compiling a custom kernel is anticipated, select an option which includes the source code. For more information on why a @@ -3176,35 +3189,52 @@ To change any of these settings later, edit /etc/rc.conf Configure X-Server + In order to use a graphical user interface such as KDE, GNOME, + or others, the X server will need to be configured. + + To see whether your video card is supported, check the + XFree86 web site. + If your video card is only supported under XFree86 4.x, refer to + for installation and configuration. + User Confirmation Requested Would you like to configure your X server at this time? [ Yes ] No - This can be done later using /stand/sysinstall if you do not - have graphics card and monitor information handy. Equipment - damage can occur if settings are incorrect. Select [Yes] and - press Enter to proceed with configuring the - X server. + + It is necessary to know your monitor specifications and + video card information. Equipment damage can occur if settings + are incorrect. If you do not have this information, select + [ No ] and perform the configuration + after installation when you have the information using + /stand/sysinstall, selecting + Configure and then + XFree86. + + - - Select Configuration Method -
- Select Configuration Method Menu + If you have graphics card and monitor information, select + [ Yes ] and press Enter + to proceed with configuring the X server. - - - - - -
+
+ Select Configuration Method Menu - There are several ways to configure the X - server. XF86Setup is fully graphical and - probably the easiest. Use the arrow keys to select the - "XF86Setup" option and press Enter. + + + + + +
- Message + There are several ways to configure the X + server. XF86Setup is fully graphical and + probably the easiest. Use the arrow keys to select the + XF86Setup and press + Enter. + + Message You have configured and been running the mouse daemon. Choose "/dev/sysmouse" as the mouse port and "SysMouse" or "MouseSystems" as the mouse protocol in the X configuration utility. @@ -3213,165 +3243,251 @@ To change any of these settings later, edit /etc/rc.conf [ Press enter to continue ] - The mouse daemon previously configured has been - detected. Press Enter to continue. + The indicates that the mouse daemon previously configured has been + detected. Press Enter to continue. - Press [Enter] to switch to graphics mode. + Press [Enter] to switch to graphics mode. This may take a while... [ OK ] - Press Enter to switch to the graphics mode and - continue. It will not try to switch to the - graphics mode until Enter is pressed. The screen - will go black and then shortly a screen with a large "X" in the - center will appear. Be patient and wait. + Press Enter to switch to the graphics mode and + continue. It will not try to switch to the + graphics mode until Enter is pressed. The screen + will go black and then shortly a screen with a large X in the + center will appear. Be patient and wait. - After a few more moments, the XF86 Setup Introduction will - appear. Read all instructions carefully. - Press Enter to continue. - + After a few more moments, the XF86Setup + introduction will display. Read all instructions + carefully. Press Enter to + continue. - - X-Mouse + + <application>XF86Setup</application> Overview - The mouse is the first item to be configured. The mouse daemon - was already running and "Emulate3Buttons" was added for my mouse - type. Click on "Apply" and check the mouse actions are working - properly. - + There are several areas of configuration to be completed. + The configuration choices you make will depend on the hardware + in the system so only a general overview can be given here. - - X-Keyboard + Along the top of the configuration tool there are buttons + indicating the areas to be configured. You should be able to use + the mouse if it was previously configured and select each item by + clicking on it. Review each area and make appropriate selections + for your system. - Click on the "Keyboard" menu item. + + <guimenuitem>Mouse</guimenuitem> - The default settings were fine for my keyboard. Select the - options appropriate for your situation then click on "Apply". - + The mouse is the first item to be configured. If you + previously configured your mouse, the mouse daemon will already + be running and should indicate SysMouse + automatically for the mouse protocol. If you are use a two + button mouse, you should also select + Emulate3Buttons. There are other + settings that can be tweaked if necessary. - - Video Card + After completing your selections, click on the + Apply and check the mouse actions are + working properly. If further adjustment is needed, make them + and recheck the operation by clicking on + Apply again. When finished, move + on to the next item. + - Click on the "Card" menu item. + + <guimenuitem>Keyboard</guimenuitem> - Select the appropriate video card from the list using the - scrollbar. Clicking on your card will show as "Card selected:" - above the list box. + Select the appropriate keyboard model. The default + keyboard is Generic 101-key PC. - Next, the "Detailed Setup" was selected just to check any - details. - + Select the language layout for your keyboard. The default + layout is U.S. English. If you are + not using a U.S. keyboard, you may need to additionally + select a variant. - - Monitor + There are other options under Group Shift/Lock behavior and + Control Key Position that can be selected if desired. Generally + the default settings are fine. - Click on the "Monitor" menu item. + After completing the keyboard configuration, click on + Apply and move on to the next + item. + - There are two ways to proceed. One method requires that you - enter the horizontal and vertical sweep capabilities of your - monitor. Choosing one of the options listed that the monitor is - the method used in the illustration. + + <guimenuitem>Card</guimenuitem> - Do not exceed the ratings of your monitor. Damage could - occur. If you have doubts select "ABORT" and get the - information. The remainder of the installation process will be - unaffected and configuring the X-Server can be done later using - /stand/sysinstall. + Click on Read README file for + additional help in configuring your video card. - After selecting a listed option, the screen will display the - horizontal and vertical sweep rates that will be used. Compare - those to the monitor specifications. The monitor must be capable - of using those ranges. - + Select the appropriate video card from the list using the + scrollbar. Clicking on your card will show as + Card selected: above the list box. - - Video Mode Selection + Next, the Detailed Setup was + selected just to check details. Typically, if your video + card was in the list, no changes will be needed here. - Click on the "Modeselection" menu item. + When finished, move on to the next item. + - Selected the modes and color depth appropriate for the - system. - + + <guimenuitem>Monitor</guimenuitem> - - Other + There are two ways to proceed. One method requires that you + enter the horizontal and vertical sweep capabilities of your + monitor in the text boxes. - These are generally reasonable values. + Choosing one of the monitor options listed that the monitor + is the other method. After selecting a listed option, the + horizontal and vertical sweep rates that will be used will + display. Compare those to your monitor specifications. The + monitor must be capable of using those ranges. - Verify all the settings once again and select "Done". + Do not exceed the ratings of your monitor. Damage could + occur. If you have doubts select ABORT + and get the information. The remainder of the installation process + will be unaffected and configuring the X-Server can be done + later using /stand/sysinstall. - It will then attempt to switch to x-mode to verify the - settings. If nothing appears or appears wrong, kill the x-server - using - - CtrlAltBackspace - - and adjust the settings or revisit them after installation. - + When finished, move on to the next item. + - - Saving Configuration + + <guimenuitem>Mode</guimenuitem> - After selecting [DONE] the following message will display: + Select the video mode(s) that you want to use. You can select + more than one option. Typically, useful ranges are 640x480, + 800x600, and 1024x768 but those are a function of video card + capability, monitor size, and eye comfort. - If you've finished configuring everything press the + Next, select the default color depth you want to use. Your + choices are 8bpp, 16bpp, 24bpp, and 32bpp. Select the highest + color depth that your video card will support. + + When finished, move on to the next item. + + + + <guimenuitem>Other</guimenuitem> + + There default settings are reasonable values so you + probably won't need to change anything here. + + The default setting which allows the server to be killed + with the hotkey sequence + CtrlAlt + Backspace should be left on. This + can be executed if somthing is wrong with the server settings and + prevent hardware damage. + + The default setting that allows video mode switching will + permit changing of the mode while running X with the hotkey + sequence + + Alt+ + or + + Alt- + . + + + + + + Testing the Server + + Verify all the settings once again and select + Done and the following message will + display : + + If you've finished configuring everything press the Okay button to start the X server using the configuration you've selected. If you still wish to configure some things, press one of the buttons at the top and then press "Done" again, when you've finished. - After selecting [OKAY], some messages will briefly appear - advising to wait and attempting to start the x-server. This - process takes a few moments, so be patient. The screen will go - blank for a short period of time and then the following should - appear: "Congratulations, you've got a running server! + After selecting Okay, some messages + will briefly appear advising to wait and attempting to start + the x-server. This process takes a few moments, so be + patient. - The configuration can now be saved in the location indicated - and continue with the installation. + The screen will go blank for a short period of time and + then a screen will appear with the message + Congratulations, you've got a running server! - If the monitor display needs adjusted, - xvidtune can be ran - to adjust them. There are warnings that improper settings can - damage your equipment. Heed them. If in doubt, do not do - it. Instead, use the monitor controls to adjust the display for - x-windows. There may be some display differences when switching - back to text mode, but it is better than damaging equipment. The - xvidtune can be ran later using - /stand/sysinstall. + If nothing appears or is distorted, kill the x-server using + + Ctrl + Alt + Backspace + + and adjust the settings or revisit them after installation. + - If it does not appear or is distorted, kill the server with - - CtrlAltBackspace - - to continue and configure the x-server after installation using - /stand/sysinstall. + + Running <command>xvidtune</command> - The installation program will create the 'X' link to the - server by selecting [Yes]: + The display can be adjusted for height, width, or centering + by using xvidtune. - Do you want to create an 'X' link to the SVGA server? + There are warnings that improper settings can + damage your equipment. Heed them. If in doubt, do not do + it. Instead, use the monitor controls to adjust the display for + x-windows. There may be some display differences when switching + back to text mode, but it is better than damaging equipment. The + xvidtune can be ran later using + /stand/sysinstall. + + Read the xvidtune before making + any adjustments. + + + + Saving Configuration + + When you are satisfied, the configuration can now be saved. + Select Save the configuration and Exit + The configuration file will be saved to + /etc/XF86Config. + + + + Once the configuration is done, the installation program will + need to create a link to the server : + + Do you want to create an 'X' link to the SVGA server? (the link will be created in the directory: /usr/X11R6/bin) Okay? [ Yes ] No - Link created successfully. + Select [ Yes ] and press + Enter to create the link. + + Link created successfully. [ OK ] - Press Enter to continue configuration. - + Press Enter to continue configuration. Select Default X Desktop - I selected the K Desktop Environment with the arrow keys and - then pressed Enter to set it as my default window - manager. + There are a variety of window managers available. They range + from very basic environments to full desktop environments with a + large suite of software. Some require only minimal disk space and + low memory while others with more features require much more. The + best way to determine which is most suitable for you is to try a few + different ones. Those are available from the ports collection or as + packages and can be added after installation. + + You can select one of the popular desktops to be installed + and configured as the default desktop. This will allow you + to start it right after installation.
Select Default Desktop @@ -3383,14 +3499,18 @@ when you've finished.
- The selected desktop package will then be loaded on they - system. + Use the arrow keys to select a desktop and press + Enter. Installation of the selected desktop will + proceed. Install Packages - Only one package is shown being added for purposes of + The packages are pre-compiled binaries and are a convenient + way to install software. + + Installation of one package is shown for purposes of illustration. Additional packages can also be added at this time if desired. After installation /stand/sysinstall can be used to add additional @@ -3403,7 +3523,8 @@ when you've finished. [ Yes ] No - Selecting [Yes] and pressing Enter will be + Selecting [ Yes ] and pressing + Enter will be followed by the Package Selection screens:
@@ -3416,15 +3537,13 @@ when you've finished.
- All packages available will be displayed if "All" is - chosen. Additional packages may be on other CDs. These can also - be added later using - /stand/sysinstall. + All packages available will be displayed if + All is selected or you can select a + particular category. Highlight your selection with the arrow + keys and press Enter. - The bash shell is shown selected. Select as many as desired - by highlighting the item and pressing the Space. - A short description of each package will appear in the lower left - corner of the screen. + A menu will display showing all the packages available for + the selection made.
Select Packages @@ -3436,7 +3555,14 @@ when you've finished.
- When the package(s) are selected, select [OK] and then press + The bash shell is shown selected. + Select as many as desired by highlighting the package and pressing + the Space. + A short description of each package will appear in the lower left + corner of the screen. + + When you have finished marking the packages for installation, + select [ OK ] and press Enter to return to the Package Selection menu.
@@ -3449,8 +3575,9 @@ when you've finished.
- Use the arrow keys to select [INSTALL] and pressing - Enter will ask for confirmation. + Use the arrow keys to select [ Install ] + and press Enter. You will then need to confirm + that you want to install the packages.
Confirm Package Installation @@ -3462,7 +3589,8 @@ when you've finished.
- Selecting [OK] and pressing Enter will start + Selecting [ OK ] and pressing + Enter will start the package installation. Installing messages will appear until completed. Make note if there are any error messages. @@ -3473,6 +3601,11 @@ when you've finished. Add User/Groups + You should add at least one user during the installation so + that you can use the system without being logged in as root. The + root partition is generally small and running applications as + root can quickly fill it. A bigger danger is noted below : + User Confirmation Requested Would you like to add any initial user accounts to the system? Adding at least one account for yourself at this stage is suggested since @@ -3481,8 +3614,8 @@ when you've finished. [ Yes ] No - Select "Add User" with the arrow keys then and press - Enter. + Select [ Yes ] and press + Enter to continue with adding a user.
Select Add User @@ -3494,6 +3627,9 @@ when you've finished.
+ Select Add User with the arrow keys + and press Enter. +
Add User Information @@ -3505,7 +3641,8 @@ when you've finished.
The following descriptions will appear in the lower part of - the screen as the items are selected with Tab + the screen as the items are selected with Tab + to assist with entering the required information. @@ -3580,16 +3717,17 @@ when you've finished. The login shell was changed from /bin/sh to - /usr/local/bin/bash to use the bash shell - that was previously installed as a package. + /usr/local/bin/bash to use the + bash shell + that was previously installed as a package. Do not try to + use a shell that does not exist or you will not be able to + login. The user was also added to the group "wheel" to be able to become a superuser with root privileges. - Groups could also be added at this time if specific needs - are known. Otherwise, this may be accessed through using - /stand/sysinstall after installation is - completed. + When you are satisfied, press [ OK ] and + the User and Group Management menu will redisplay.
Exit User and Group Management @@ -3601,7 +3739,13 @@ when you've finished.
- I selected [Exit] with the arrow keys then [OK] and pressed + Groups could also be added at this time if specific needs + are known. Otherwise, this may be accessed through using + /stand/sysinstall after installation is + completed. + + When you are finished adding users, select + Exit with the arrow keys and press Enter to continue the installation. @@ -3616,6 +3760,8 @@ when you've finished. [ Press enter to continue ] + Press Enter to set the root password. + The password will need to be typed in twice correctly. Needless to say, make sure you have a way of finding the password if you forget. @@ -3631,14 +3777,19 @@ when you've finished. Exiting Install + If you need to configure additional network devices or to + do any other configurations, you can do it at this point or + after installation with /stand/sysinstall. + User Confirmation Requested Visit the general configuration menu for a chance to set any last options? Yes [ No ] - Selecting [No] with the arrow keys and pressing - Enter returns to the Main Installation Menu + Selecting [ No ] with the arrow keys + and pressing Enter returns to the Main + Installation Menu
Exit Install @@ -3650,8 +3801,9 @@ when you've finished.
- Select [EXIT INSTALL] with the arrow keys and press - Enter. + Select [X Exit Install] with the arrow + keys and press Enter. You will be asked to + confirm exiting the installation : User Confirmation Requested Are you sure you wish to exit? The system will reboot (be sure to @@ -3659,9 +3811,9 @@ when you've finished. [ Yes ] No - Select [Yes] and remove floppy if booting from floppy. The - CDROM drive is locked until you select yes to exit and press - Enter. The CDROM drive is then unlocked and can + Select [ Yes ] and remove floppy if + booting from floppy. The CDROM drive is locked until the machine + starts to reboot. The CDROM drive is then unlocked and can be removed from drive (quickly). The system will reboot so watch for any error messages that @@ -3671,7 +3823,7 @@ when you've finished. FreeBSD Bootup - If everything goes well, you will see similar messages scroll + If everything went well, you will see messages scroll off the screen and you will arrive at a login prompt. You can view the content of the messages by pressing Scroll-Lock and using PgUp and PgDn. @@ -3679,11 +3831,10 @@ when you've finished. to the prompt. The entire message may not display (buffer limitation) but - can be viewed from the command line after logging in by typing - dmesg at the prompt will get similar - information. + it can be viewed from the command line after logging in by typing + dmesg at the prompt. - Login using the user/password you set during installation + Login using the username/password you set during installation (rpratt, in this example). Avoid logging in as root except when necessary.