Shortened MATE and dfly walkthroughs
[ikiwiki.git] / varialus / index.mdwn
1 # et
2 # Anisoptera
3 *The following is an unpaid personal wiki page about my experiences, issues, and workarounds related to DragonFly BSD.*
4
5 ## Table of Contents
6
7 ### 1. Featured
8
9 * **Walkthrough Prerequisite Knowledge**
10 * Walkthrough of **Enlightenment** Installation and Configuration
11 * Walkthrough of **MATE** Installation and Configuration
12 * Walkthrough of **DragonFly BSD** Installation and Configuration
13 * (In Progress) Walkthrough of **Applications** Installation and Configuration
14 * (In Progress) Walkthrough of **KDE** Installation and Configuration
15 * (In Progress) Walkthrough of **Xfce** Installation and Configuration
16 * (In Progress) Walkthrough of **LXDE** Installation and Configuration
17 * (Not Yet Started) Walkthrough of **C** and **Go** Development Environment Installation and Configuration
18
19 ### 2. Tidbits
20
21 * Shell/Console/Command-Line-Prompt: tcsh/bash, ctrl-d/tab-tab, partial-previous-command-up-key/ctrl-r-partial-previous-command, rehash
22 * Package-Management: pkgng/apt-get
23 * Text-Editor: ee/nano, vi :q!
24 * Manual: man man
25 * Power-Down: shutdown -p now
26 * Find File: grep, find / -name fileName
27 * Process Management: top, ps, pkill, kill
28 * File-System: Hammer
29 * Operating System: DragonFly BSD
30
31 ### 3. Issues
32
33 * Disclaimer
34 * Installer Supported Desktops: dfly 3.8.1
35 * Early Keyboard Selection: dfly 3.8.1
36 * Encryption Keyboard Selection: dfly 3.0.2
37 * Random Key for Encrypted Swap: dfly 3.0.2
38 * Stay Decrypted for  Configuration: dfly 3.0.2
39 * No Confirmation for Decryption: dfly 3.0.2
40 * Plain Text Password in Install Log: dfly 3.8.1
41 * USB Installation Media Named Uniquely: dfly 3.0.2
42 * 3TB+ HD Install: dfly 3.0.2, fixed in snapshot on 8/14/2012
43 * Overwrite 3TB+ Partition Table: snapshot 8/14/2012
44 * Wiki Centered Text: 8/25/2012
45 * XOrg Quit Errors: dfly 3.0.2, VirtualBox 4.1.20
46
47 ### 4. Workarounds
48
49 * Install Non-GUI on 3TB+ Hard Drive
50
51 ### 5. Contribute
52
53 * Port VirtualBox to DragonFly BSD
54 * Update and Fix Bugs of Desktop Environments in DPorts
55 * DragonFly BSD Network Shares Walkthrough
56
57 # Featured
58
59 ## Varialus Walkthrough Prerequisite Knowledge
60
61 When I write documentation I prefer to target as wide an audience as possible by assuming as little prior knowledge as possible. This preference previously caused some of my documentation to be unwieldingly long. In an effort to condense my documentation, I have factored out the most frequently repeated concepts below.
62
63 1. "By pressing "Scroll Lock" you can use the arrow keys to scroll backward through the console output.  Press "Scroll Lock" again to turn it off."
64
65 2. "Search for the given pattern in the remote package repositories."
66
67         pkg search PackageName
68
69 3. "Show ``full'' information about the package."
70
71         pkg search -f PackageName-Version.Number
72
73 4. "Install a package from a remote package repository."
74
75         pkg install PackageName-Version.Number
76
77 5. "The  command  ee is a simple screen oriented text editor." Press Esc or Ctrl-[ to be prompted to exit and optionally save changes to disk.
78
79         ee /path/to/new/or/existing/text/file
80
81 6. "To shut down the system properly, use shutdown. It notifies all users and processes of the impending shutdown, blocks new logins, and brings the system down cleanly."
82
83     "The system is halted and the power is turned off (hardware support required) at the specified time."
84
85         shutdown -p now
86
87     "The system is rebooted at the specified time."
88
89         shutdown -r now
90
91 7. "Sudo is a program designed to let system administrators allow some users to execute some commands as root (or another user)."
92
93         sudo CommandToRunAsRoot
94         sudo pkg install PackageName-Version.Number
95         sudo ee /path/to/new/or/existing/text/file
96         sudo shutdown -p now
97         sudo shutdown -r now
98
99 ## Walkthrough of Enlightenment Installation and Configuration
100
101 This walkthrough describes how I install and configure the Enlightenment desktop environment on DragonFly BSD. You should customize your installation as you see fit. This walkthrough is being run on DragonFly BSD as installed and configured in "Walkthrough of DragonFly BSD Installation and Configuration" by Varialus.
102
103 Enlightenment currently has a great balance of stability, features, and performance compared to other desktop environments on DragonFly BSD. I plan on using Enlightenment for personal use until MATE on DragonFly BSD has improved significantly. When currently installed and configured as described in this walkthrough, Enlightenment works but has the following issues.
104
105 * DPorts has Enlightenment E17 0.17.5 but Enlightenment E18 0.18.8 is the current stable release. Until MATE or Xfce issues are resolved, I prefer that the version of Enlightenment in DPorts not be updated unless the current stable release of Enlightenment has been confirmed to work at least as well as the version currently in DPorts.
106 * The splash screen significantly slows down the desktop from being displayed. This walkthrough disables the splash screen but the user has to wait for it during the first login.
107 * The Enlightenment initial graphical configuration of keyboard layouts doesn't include the Dvorak keyboard layout.
108 * The System > Restart and System > Power Off menu options don't work unless the Composite module is unloaded.
109
110 I hope this walkthrough will make it easier for developers to properly fix these issues.
111
112 1. From DPorts install the following packages and their dependencies.
113
114 * xorg
115 * xdm
116 * enlightenment
117 * e17-modules
118 * slock
119
120 2. Add the following line to /etc/rc.conf and save the change to disk.
121
122         dbus_enable="YES"
123
124 3. Skim through /etc/ttys to find the following line.
125
126         ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   off secure
127
128     Then edit the previous line to match the following line and save the change to disk.
129
130         ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   on  secure
131
132 4. Skim through /usr/local/lib/X11/xdm/Xsetup_0 to find the following line.
133
134         xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
135
136     Then edit the previous line to match the following line and save the change to disk.
137
138         #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
139
140 5. If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, add the following line to /usr/local/lib/X11/xdm/Xsetup_0 and save the change to disk.
141
142         setxkbmap dvorak
143
144 6. Skim through /usr/local/lib/X11/xdm/xdm-config to find the following line.
145
146         DisplayManager*authorize:       true
147
148     Then edit the previous line to match the following line and save the change to disk.
149
150         DisplayManager*authorize:       false
151
152 7. If it doesn't already exist, create the file /home/user/.xsession then add the following line to it and save the change to disk.
153
154         exec enlightenment_start
155
156 8. Set the SUID bit with execute permission on /usr/local/lib/enlightenment/utils/enlightenment_sys by running the following command. "WARNING: this program might be vulnerable so do not set suid bit if do not trust all users of this machine."
157
158         sudo chmod u+s /usr/local/lib/enlightenment/utils/enlightenment_sys
159
160 9. Restart DragonFly BSD and log in as user. The Enlightenment initial graphical configuration will be displayed. Select the following options.
161
162 * Language: English
163 * Keyboard: English (US)
164 * Profile: Computer (Standard Enlightenment)
165 * Sizing: 1.2 Title
166 * Window Focus: Click
167 * Updates: Enable update checking
168 * Taskbar: Enable Taskbar
169
170 10. The Enlightenment desktop will be displayed but only after a significant delay from the splash screen. This step disables the splash screen so you'll only have to wait for it this one time. After the desktop is finally displayed, click on the left side of the desktop and select Settings > All > Look > Startup, then disable the option "Show Splash Screen on Login" and click OK.
171
172 11. If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, click on the left side of the desktop and select Settings > All > Input > Keyboard, then click Add > English (US) (us) > Variant > dvorak (English (Dvorak)) > OK > us (default, basic) > Remove > OK.
173
174 12. Click on the left side of the screen and select either System > Reboot or System > Power Off. If DragonFly BSD does not reboot or power off, then click on the left side of the desktop and select Settings > Modules, click Look > Composite > Unload > Close.
175
176 13. Click on the left side of the screen and select Settings > All > Screen > Screen Lock, then type 'slock' without quotes within the Custom Screenlock Command text field, click to enable the check box labeled Use Custom Screenlock Command, and click OK.
177
178 ## Walkthrough of MATE Installation and Configuration
179
180 This walkthrough describes how I install and configure the MATE desktop environment on DragonFly BSD. You should customize your installation as you see fit. This walkthrough is being run on DragonFly BSD as installed and configured in "Walkthrough of DragonFly BSD Installation and Configuration" by Varialus.
181
182 MATE is my favorite desktop environment. When currently installed and configured as described in this walkthrough, MATE works but has the following issues.
183
184 * DPorts has MATE 1.6.1 but MATE 1.8 is the current stable release. 
185 * DPorts currently does not include the MATE meta package.
186 * Enabling hald prevents applications from launching via the MATE menu.
187 * Many non-fatal errors are logged in the /home/user and /var/log directories.
188 * The console-kit-daem command in the CLI program top has high CPU utilization.
189 * One of the post installation messages mentions devstat, but devstat is not in DPorts.
190
191 I hope this walkthrough will make it easier for developers to properly fix these issues.
192
193 1. From DPorts install the following packages and their dependencies.
194
195 * xorg
196 * xdm
197 * mate
198
199     Because DPorts currently does not include the MATE meta package, use the following command to install it.
200
201         sudo pkg install -x "mate-[a-z]+"
202
203 2. Add the following lines to /etc/rc.conf and save the change to disk.
204
205         hald_enable="NO"
206         dbus_enable="YES"
207
208 3. Skim through /etc/ttys to find the following line.
209
210         ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   off secure
211
212     Then edit the previous line to match the following line and save the change to disk.
213
214         ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   on  secure
215
216 4. Skim through /usr/local/lib/X11/xdm/Xsetup_0 to find the following line.
217
218         xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
219
220     Then edit the previous line to match the following line and save the change to disk.
221
222         #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
223
224 5. If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, add the following line to /usr/local/lib/X11/xdm/Xsetup_0 and save the change to disk.
225
226         setxkbmap dvorak
227
228 6. Skim through /usr/local/lib/X11/xdm/xdm-config to find the following line.
229
230         DisplayManager*authorize:       true
231
232     Then edit the previous line to match the following line and save the change to disk.
233
234         DisplayManager*authorize:       false
235
236 7. If it doesn't already exist, create the file /home/user/.xsession then add the following line to it and save the change to disk.
237
238         exec mate-session
239
240 8. Restart DragonFly BSD and log in as user. The MATE desktop will be displayed.
241
242 ## Walkthrough of DragonFly BSD Installation and Configuration
243
244 This walkthrough describes how I install and configure DragonFly BSD. You should customize your installation as you see fit. The walkthrough is being run on VirtualBox which in turn is running on a recent MacBook with plenty of memory.
245
246 1. Create a virtual machine in VirtualBox using the FreeBSD (64 bit) template with 4 GB memory, 128 GB dynamically allocated VDI virtual disk image. Set the the virtual hardware clock set to UTC time, then download and extract the x86_64 CD [installation media](http://www.dragonflybsd.org/download/) and add it to the virtual machine, but remember to remove it before taking VirtualBox snapshots. Start the virtual machine. Before it finishes booting, the will be greeted with the following boot menu.
247
248         DragonFly/i386 bootstrap loader, Revision 1.1
249         (justin@pkgbox64.dragonflybsd.org, Mon Jun 16 21:33:12 PDT 2014)
250                                                    |
251         1. Boot DragonFly [kernel]                 |   ,--,           |           ,--,
252         2. Boot DragonFly in Safe Mode             |   |   `-,       ,^,       ,-'   |
253         3. Boot DragonFly without AHCI driver      |    `,    `-,   (/ \)   ,-'    ,'
254         4. Boot DragonFly without ACPI driver      |      `-,    `-,/   \,-'    ,-'
255         9. Escape to loader prompt (also ESC)      |         `------(   )------'
256         r. Boot DragonFly to a rescue ramdisk      |     ,----------(   )----------,
257         s. Boot DragonFly in single user mode      |    |        _,-(   )-,_        |
258         v. Boot DragonFly with verbose logging     |     `-,__,-'   \   /   `-,__,-'
259         R. Reboot                                  |                 | |
260                                                    |                 | |
261                                                    |                 | |
262                                                    |                 | |
263                                                    |                 | |
264                                                    |                 | |
265                                                    |                 `|'
266                                                    |
267         Booting in 10 seconds... _
268
269     After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
270
271         Welcome to DragonFly!
272         
273         To start the installer, login as 'installer'.  To just get a shell prompt,
274         login as 'root'.
275         
276         DragonFly/x86_64 (Amnesiac) (ttyv0)
277         
278         login: _
279
280 2. Type 'installer' without quotes and press enter. The following menu will be displayed.
281
282         F10=Refresh Display                                                            .
283                                                                                        .
284                                                       ,--,           |           ,--,  .
285          ------------------------| Welcome to DragonFly BSD |------------------------- .
286         |                                                                             |.
287         | Welcome to the DragonFly BSD Live CD.                                       |.
288         |                                                                             |.
289         | DragonFly BSD is an efficient and elegant BSD Unix-derived operating        |.
290         | system.  For more information, see http://www.dragonflybsd.org              |.
291         |                                                                             |.
292         | From this CD, you can boot into DragonFly BSD ``live'' (without installing  |.
293         | it) to evaluate it, to install it manually, or to troubleshoot problems     |.
294         | with an existing installation, using either a command prompt or menu-driven |.
295         | utilities.                                                                  |.
296         |                                                                             |.
297         | Also, you can use this automated application to assist you in installing    |.
298         | DragonFly BSD on this computer and configuring it once it is installed.     |.
299         |                                                                             |.
300         |        < Install DragonFly BSD >_ < Configure an Installed System >         |.
301         |    < Live CD Utilities >  < Exit to Live CD >  < Reboot this Computer >     |.
302         |                     < Setup NetBoot Install Services >                      |.
303          ----------------------------------------------------------------------------- .
304                                                                                        .
305                                                                                        .
306         Install DragonFly BSD on a HDD or HDD partition on this computer               .
307
308 3. The bottom line changes depending on which option is selected. Highlight the option < Install DragonFly BSD > and press enter. The following menu will be displayed.
309
310         F10=Refresh Display                                                            .
311                                                                                        .
312                                                       ,--,           |           ,--,  .
313                                                       |   `-,       ,^,       ,-'   |  .
314                                                        `,    `-,   (/ \)   ,-'    ,'   .
315          --------------------------| Begin Installation |----------------------------- .
316         |                                                                             |.
317         | This application will install DragonFly BSD on one of the hard disk drives  |.
318         | attached to this computer. It has been designed to make it easy to install  |.
319         | DragonFly BSD in the typical case. If you have special requirements that    |.
320         | are not addressed by this installer, or if you have problems using it, you  |.
321         | are welcome to install DragonFly BSD manually. To do so select Exit to Live |.
322         | CD, login as root, and follow the instructions given in the file /README .  |.
323         |                                                                             |.
324         | NOTE! As with any installation process, YOU ARE STRONGLY ENCOURAGED TO BACK |.
325         | UP ANY IMPORTANT DATA ON THIS COMPUTER BEFORE PROCEEDING!                   |.
326         |                                                                             |.
327         | < Install DragonFly BSD >_ < Return to Welcome Menu >  < Exit to Live CD >  |.
328          ----------------------------| Press F1 for Help |---------------------------- .
329                                                                                        .
330                                                                                        .
331                                                                                        .
332                                                                                        .
333                                                                                        .
334                                                                                        .
335                                                                                        .
336
337 4. Highlight the option < Install DragonFly BSD > and press enter. The following menu, specific to your hardware, will be displayed.
338
339         F10=Refresh Display                                                            .
340                                                                                        .
341                                                       ,--,           |           ,--,  .
342                                                       |   `-,       ,^,       ,-'   |  .
343                                                        `,    `-,   (/ \)   ,-'    ,'   .
344                                                          `-,    `-,/   \,-'    ,-'     .
345                                                             `------(   )------'        .
346                                                         ,----------(   )----------,    .
347                                                        |        _,-(   )-,_        |   .
348                  -----------------------| Select Disk |----------------------- _,-'    .
349                 |                                                             |        .
350                 | Select a disk on which to install DragonFly BSD             |        .
351                 |                                                             |        .
352                 | < ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33 >_|        .
353                 | < Return to Begin Installation >                            |        .
354                  -------------------------------------------------------------         .
355                                                                     `|'                .
356                                                                                        .
357                                                                                        .
358                                                                                        .
359                                                                                        .
360                                                                                        .
361                                                                                        .
362                                                                                        .
363                                                                                        .
364
365 5. Highlight the disk on which to install DragonFly BSD and press Enter. The following menu will be displayed.
366
367         F10=Refresh Display                                                            .
368                                                                                        .
369                                                       ,--,           |           ,--,  .
370                                                       |   `-,       ,^,       ,-'   |  .
371                                                        `,    `-,   (/ \)   ,-'    ,'   .
372                                                          `-,    `-,/   \,-'    ,-'     .
373                                                             `------(   )------'        .
374                                                         ,----------(   )----------,    .
375                ------------------------| How Much Disk? |------------------------  |   .
376               |                                                                  |'    .
377               | Select how much of this disk you want to use for DragonFly BSD.  |     .
378               |                                                                  |     .
379               | ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33          |     .
380               |                                                                  |     .
381               |            < Use Entire Disk >_ < Use Part of Disk >             |     .
382               |                    < Return to Select Disk >                     |     .
383                ------------------------------------------------------------------      .
384                                                                                        .
385                                                                                        .
386                                                                                        .
387                                                                                        .
388                                                                                        .
389                                                                                        .
390                                                                                        .
391                                                                                        .
392
393 6. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter. The following menu will be displayed.
394
395         F10=Refresh Display                                                            .
396                                                                                        .
397                                                       ,--,           |           ,--,  .
398                                                       |   `-,       ,^,       ,-'   |  .
399                             ------| Are you absolutely sure? |------  \)   ,-'    ,'   .
400                            |                                        |  \,-'    ,-'     .
401                            | WARNING! ALL data in ALL partitions on |  )------'        .
402                            | the disk                               |  )----------,    .
403                            |                                        |  )-,_        |   .
404                            | ad0: 131072MB <VBOX HARDDISK 1.0> at   |  /   `-,__,-'    .
405                            | ata0-master UDMA33                     | |                .
406                            |                                        | |                .
407                            | will be IRREVOCABLY ERASED!            | |                .
408                            |                                        | |                .
409                            | Are you ABSOLUTELY SURE you wish to    | |                .
410                            | take this action? This is your LAST    | |                .
411                            | CHANCE to cancel!                      ||'                .
412                            |                                        |                  .
413                            |           < OK >_ < Cancel >           |                  .
414                             ----------------------------------------                   .
415                                                                                        .
416                                                                                        .
417                                                                                        .
418                                                                                        .
419                                                                                        .
420
421 7. If you are absolutely sure, highlight < OK > and press enter. The following menu will be displayed.
422
423         F10=Refresh Display                                                            .
424                                                                                        .
425                                                       ,--,           |           ,--,  .
426                                                       |   `-,       ,^,       ,-'   |  .
427                                                        `,    `-,   (/ \)   ,-'    ,'   .
428                                                          `-,    `-,/   \,-'    ,-'     .
429                                                             `------(   )------'        .
430                              -----------| Information |------------    )----------,    .
431                             |                                      |   )-,_        |   .
432                             | The disk                             |   /   `-,__,-'    .
433                             |                                      || |                .
434                             | ad0: 131072MB <VBOX HARDDISK 1.0> at || |                .
435                             | ata0-master UDMA33                   || |                .
436                             |                                      || |                .
437                             | was formatted.                       || |                .
438                             |                                      || |                .
439                             |                < OK >                |`|'                .
440                              --------------------------------------                    .
441                                                                                        .
442                                                                                        .
443                                                                                        .
444                                                                                        .
445                                                                                        .
446                                                                                        .
447                                                                                        .
448
449 8. Press enter. The following menu will be displayed.
450
451         F10=Refresh Display                                                            .
452                                                                                        .
453                                                       ,--,           |           ,--,  .
454                                                       |   `-,       ,^,       ,-'   |  .
455                                                        `,    `-,   (/ \)   ,-'    ,'   .
456                                                          `-,    `-,/   \,-'    ,-'     .
457                                                             `------(   )------'        .
458                    -----------------| Select file system |------------------ -----,    .
459                   |                                                         |      |   .
460                   | Please select the file system you want to use with      |,__,-'    .
461                   | DragonFly BSD.                                          |          .
462                   |                                                         |          .
463                   | HAMMER is the new DragonFly BSD file system. UFS is the |          .
464                   | traditional BSD file system.                            |          .
465                   |                                                         |          .
466                   | < Use HAMMER >_ < Use UFS >  < Return to Select Disk >  |          .
467                    ---------------------------------------------------------           .
468                                                                                        .
469                                                                                        .
470                                                                                        .
471                                                                                        .
472                                                                                        .
473                                                                                        .
474                                                                                        .
475                                                                                        .
476
477 9. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter. The following menu will be displayed.
478
479         F10=Refresh Display                                                            .
480                                                                                        .
481                                                       ,--,           |           ,--,  .
482                --------------------| Create Subpartitions |---------------------    |  .
483               |                                                                 | ,'   .
484               | Set up the partitions (also knows as just `partitions' in       |'     .
485               | BSD tradition) you want to have on this primary partition. In   |      .
486               | most cases you should be fine with the default settings.        |-,    .
487               |                                                                 |  |   .
488               | For Capacity, use 'M' to indicate megabytes, 'G' to indicate    |-'    .
489               | gigabytes, and so on (up to 'E'.) A single '*' indicates 'use   |      .
490               | the remaining space on the primary partition'.                  |      .
491               |                                                                 |      .
492               | Mountpoint  Capacity  Encrypted                                 |      .
493               | [/boot_   ] [768M   ] [ ]     < Ins > < Del >                   |      .
494               | [swap     ] [8192M  ] [ ]     < Ins > < Del >                   |      .
495               | [/        ] [*      ] [ ]     < Ins > < Del >                   |      .
496               |                               < Add >                           |      .
497               |                                                                 |      .
498               |     < Accept and Create >  < Return to Select Disk >            |      .
499                -------------------| Press F1 for Help |-------------------------       .
500                                                                                        .
501                                                                                        .
502                                                                                        .
503                                                                                        .
504
505 10. Highlight < Accept and Create > and press enter. The following menu will be displayed.
506
507         F10=Refresh Display                                                            .
508                                                                                        .
509                                                       ,--,           |           ,--,  .
510                                                       |   `-,       ,^,       ,-'   |  .
511                                                        `,    `-,   (/ \)   ,-'    ,'   .
512                                                          `-,    `-,/   \,-'    ,-'     .
513                -------------------------| Install OS |--------------------------       .
514               |                                                                 |-,    .
515               | Everything is now ready to install the actual files which       |  |   .
516               | comprise the DragonFly BSD operating system on the selected     |-'    .
517               | partition of the selected disk.                                 |      .
518               |                                                                 |      .
519               | Note that this process will take quite a while to finish. You   |      .
520               | may wish to take a break now and come back to the computer in a |      .
521               | short while.                                                    |      .
522               |                                                                 |      .
523               | < Begin Installing Files >_ < Return to Create Subpartitions >  |      .
524                -----------------------------------------------------------------       .
525                                                                                        .
526                                                                                        .
527                                                                                        .
528                                                                                        .
529                                                                                        .
530                                                                                        .
531                                                                                        .
532                                                                                        .
533
534 11. Highlight < Begin Installing Files > and press enter. The following progress bar will be displayed.
535
536         F10=Refresh Display                                                            .
537                                                                                        .
538                                                       ,--,           |           ,--,  .
539                                                       |   `-,       ,^,       ,-'   |  .
540                                                        `,    `-,   (/ \)   ,-'    ,'   .
541                                                          `-,    `-,/   \,-'    ,-'     .
542                                                             `------(   )------'        .
543                                                         ,----------(   )----------,    .
544                   -------------------| Executing Commands |-------------------     |   .
545                  |                                                            |_,-'    .
546                  | /bin/cpdup -o -vvv -u /usr/share /mnt/usr/share            |        .
547                  |                                                            |        .
548                  |          [*#################65%###              ]          |        .
549                  |                                                            |        .
550                  |                         < Cancel >_                        |        .
551                   ------------------------------------------------------------         .
552                                                                     `|'                .
553                                                                                        .
554                                                                                        .
555                                                                                        .
556                                                                                        .
557                                                                                        .
558                                                                                        .
559                                                                                        .
560                                                                                        .
561
562     When it finishes, the following menu will be displayed.
563
564         F10=Refresh Display                                                            .
565                                                                                        .
566                                                       ,--,           |           ,--,  .
567                                                       |   `-,       ,^,       ,-'   |  .
568                     ---------------| Install Bootblock(s) |----------------,-'    ,'   .
569                    |                                                       |   ,-'     .
570                    | You may now wish to install bootblocks on one or more |--'        .
571                    | disks. If you already have a boot manager installed,  |------,    .
572                    | you can skip this step (but you may have to configure |       |   .
573                    | your boot manager separately.)  If you installed      |-,__,-'    .
574                    | DragonFly BSD on a disk other than your first disk,   |           .
575                    | you will need to put the bootblock on at least your   |           .
576                    | first disk and the DragonFly BSD disk.                |           .
577                    |                                                       |           .
578                    | Disk Drive  Install Bootblock?  Packet Mode?          |           .
579                    | [ad0_     ] [X]                 [X]                   |           .
580                    |                                                       |           .
581                    |           < Accept and Install Bootblocks >           |           .
582                    |                  < Skip this Step >                   |           .
583                     -----------------| Press F1 for Help |-----------------            .
584                                                                                        .
585                                                                                        .
586                                                                                        .
587                                                                                        .
588         The disk on which you wish to install a bootblock                              .
589
590 12. Highlight < Accept and Install Bootblocks > and press enter. The following dialog box will be displayed.
591
592         F10=Refresh Display                                                            .
593                                                                                        .
594                                                       ,--,           |           ,--,  .
595                                                       |   `-,       ,^,       ,-'   |  .
596                                                        `,    `-,   (/ \)   ,-'    ,'   .
597                                                          `-,    `-,/   \,-'    ,-'     .
598                                                             `------(   )------'        .
599                                                         ,----------(   )----------,    .
600                                                        |        _,-(   )-,_        |   .
601                            -------------| Information |-------------   /   `-,__,-'    .
602                           |                                         | |                .
603                           | Bootblocks were successfully installed! | |                .
604                           |                                         | |                .
605                           |                 < OK >                  | |                .
606                            -----------------------------------------  |                .
607                                                                     | |                .
608                                                                     `|'                .
609                                                                                        .
610                                                                                        .
611                                                                                        .
612                                                                                        .
613                                                                                        .
614                                                                                        .
615                                                                                        .
616                                                                                        .
617
618 13. Press enter. The following menu will be displayed.
619
620         F10=Refresh Display                                                            .
621                                                                                        .
622                                                       ,--,           |           ,--,  .
623                                                       |   `-,       ,^,       ,-'   |  .
624                                                        `,    `-,   (/ \)   ,-'    ,'   .
625                                                          `-,    `-,/   \,-'    ,-'     .
626                -----------------| DragonFly BSD is Installed! |-----------------       .
627               |                                                                 |-,    .
628               | Congratulations!                                                |  |   .
629               |                                                                 |-'    .
630               | DragonFly BSD has successfully been installed on this computer. |      .
631               | You may now proceed to configure the installation. Alternately, |      .
632               | you may wish to reboot the computer and boot into the installed |      .
633               | system to confirm that it works.                                |      .
634               |                                                                 |      .
635               |              < Configure this System >_ < Reboot >              |      .
636               |                   < Return to Welcome Menu >                    |      .
637                -----------------------------------------------------------------       .
638
639 14. Highlight < Configure this System > and press enter. The following menu will be displayed.
640
641         F10=Refresh Display                                                            .
642                                                                                        .
643                                                       ,--,           |           ,--,  .
644                             ---| Configure an Installed System |---- ^,       ,-'   |  .
645                            |                                        | \)   ,-'    ,'   .
646                            | The options on this menu allow you to  |  \,-'    ,-'     .
647                            | configure a DragonFly BSD system after |  )------'        .
648                            | it has already been installed.         |  )----------,    .
649                            |                                        |  )-,_        |   .
650                            | < Select timezone >_                   |  /   `-,__,-'    .
651                            | < Set date and time >                  | |                .
652                            | < Set keyboard map >                   | |                .
653                            | < Set root password >                  | |                .
654                            | < Add a user >                         | |                .
655                            | < Configure network interfaces >       | |                .
656                            | < Configure hostname and domain >      | |                .
657                            | < Set console font >                   ||'                .
658                            | < Set screen map >                     |                  .
659                            | < Remove software packages >           |                  .
660                            | < Return to Welcome Menu >             |                  .
661                             ----------------------------------------                   .
662                                                                                        .
663                                                                                        .
664                                                                                        .
665 Set the Time Zone of your physical location                                            .
666
667 15. Highlight < Select timezone > and press enter. The following menu will be displayed.
668
669         F10=Refresh Display                                                            .
670                                                                                        .
671                                                       ,--,           |           ,--,  .
672                                                       |   `-,       ,^,       ,-'   |  .
673                                                        `,    `-,   (/ \)   ,-'    ,'   .
674                                                          `-,    `-,/   \,-'    ,-'     .
675                                                             `------(   )------'        .
676                                                         ,----------(   )----------,    .
677                           | Local or UTC (Greenwich Mean Time) clock | )-,_        |   .
678                          |                                            |/   `-,__,-'    .
679                          | Is this machine's CMOS clock set to        |                .
680                          | UTC?                                       |                .
681                          |                                            |                .
682                          | If it is set to local time, or you         |                .
683                          | don't know, please choose NO here!         |                .
684                          |                                            |                .
685                          |              < Yes >_ < No >               |                .
686                           --------------------------------------------                 .
687                                                                                        .
688                                                                                        .
689                                                                                        .
690                                                                                        .
691                                                                                        .
692                                                                                        .
693                                                                                        .
694
695 16. Highlight < Yes > and press enter. The following menu will be displayed.
696
697         F10=Refresh Display ----------| Select Time Zone |----------                   .
698                            |                                        #                  .
699                            | Select a Time Zone appropriate to your #|           ,--,  .
700                            | physical location.                     #^,       ,-'   |  .
701                            |                                        # \)   ,-'    ,'   .
702                            | < Africa >_                            #  \,-'    ,-'     .
703                            | < America >                            #  )------'        .
704                            | < Antarctica >                         #  )----------,    .
705                            | < Arctic >                             #  )-,_        |   .
706                            | < Asia >                               #  /   `-,__,-'    .
707                            | < Atlantic >                           # |                .
708                            | < Australia >                          # |                .
709                            | < CET >                                # |                .
710                            | < CST6CDT >                            # |                .
711                            | < EET >                                # |                .
712                            | < EST >                                # |                .
713                            | < EST5EDT >                            #|'                .
714                            | < Etc >                                #                  .
715                            | < Europe >                             *                  .
716                            | < GMT >                                *                  .
717                            | < HST >                                *                  .
718                            | < Indian >                             *                  .
719                            | < MET >                                *                  .
720                            | < MST >                                *                  .
721                             ----------------------------------------                   .
722
723 17. Highlight < GMT > and press enter. The following dialog box will be displayed.
724
725         F10=Refresh Display                                                            .
726                                                                                        .
727                                                       ,--,           |           ,--,  .
728                                                       |   `-,       ,^,       ,-'   |  .
729                                                        `,    `-,   (/ \)   ,-'    ,'   .
730                                                          `-,    `-,/   \,-'    ,-'     .
731                                                             `------(   )------'        .
732                                                         ,----------(   )----------,    .
733                                                        |        _,-(   )-,_        |   .
734                                 --------| Information |--------    \   /   `-,__,-'    .
735                                |                               |    | |                .
736                                | The Time Zone has been set to |    | |                .
737                                | /mnt/usr/share/zoneinfo/GMT.  |    | |                .
738                                |                               |    | |                .
739                                |            < OK >_            |    | |                .
740                                 -------------------------------     | |                .
741                                                                     `|'                .
742                                                                                        .
743                                                                                        .
744                                                                                        .
745                                                                                        .
746                                                                                        .
747                                                                                        .
748                                                                                        .
749                                                                                        .
750
751 18. Press enter. The menu from step 33 will be displayed. Highlight < Set keyboard map > and press enter. The following menu will be displayed.
752
753         F10=Refresh Display  -------| Select Keyboard Map |--------                    .
754                             |                                      #                   .
755                             | Select a keyboard map appropriate to # |           ,--,  .
756                             | your keyboard layout.                #,^,       ,-'   |  .
757                             |                                      #/ \)   ,-'    ,'   .
758                             | < be.iso.acc.kbd >_                  #   \,-'    ,-'     .
759                             | < be.iso.kbd >                       #   )------'        .
760                             | < bg.bds.ctrlcaps.kbd >              *   )----------,    .
761                             | < bg.phonetic.ctrlcaps.kbd >         *   )-,_        |   .
762                             | < br275.cp850.kbd >                  *   /   `-,__,-'    .
763                             | < br275.iso.acc.kbd >                *| |                .
764                             | < br275.iso.kbd >                    *| |                .
765                             | < by.cp1131.kbd >                    *| |                .
766                             | < by.cp1251.kbd >                    *| |                .
767                             | < by.iso5.kbd >                      *| |                .
768                             | < ce.iso2.kbd >                      *| |                .
769                             | < colemak.iso15.acc.kbd >            *'|'                .
770                             | < cs.latin2.qwertz.kbd >             *                   .
771                             | < cz.iso2.kbd >                      *                   .
772                             | < danish.cp865.kbd >                 *                   .
773                             | < danish.iso.kbd >                   *                   .
774                             | < el.iso07.kbd >                     *                   .
775                             | < estonian.cp850.kbd >               *                   .
776                             | < estonian.iso.kbd >                 *                   .
777                              --------------------------------------                    .
778
779 19. Highlight < us.dvorak.kbd > and press enter. The menu from step 33 will be displayed. Highlight < Add a user > and press enter. The following menu will be displayed.
780
781         F10=Refresh D -------------------| Add user |--------------------              .
782                      |                                                   |             .
783                      | Here you can add a user to an installed system.   |       ,--,  .
784                      |                                                   |    ,-'   |  .
785                      | You can leave the Home Directory, User ID, and    | ,-'    ,'   .
786                      | Login Group fields empty if you want these items  |'    ,-'     .
787                      | to be automatically allocated by the system.      |----'        .
788                      |                                                   |--------,    .
789                      | Note: this user's password will appear in the     |_        |   .
790                      | install log. If this is a problem, please add the | `-,__,-'    .
791                      | user manually after rebooting into the installed  |             .
792                      | system instead.                                   |             .
793                      |                                                   |             .
794                      | Username                 [_                 ]     |             .
795                      | Real Name                [                  ]     |             .
796                      | Password                 [                  ]     |             .
797                      | Password (Again)         [                  ]     |             .
798                      | Shell                    [/bin/tcsh         ]     |             .
799                      | Home Directory           [                  ]     |             .
800                      | User ID                  [                  ]     |             .
801                      | Login Group              [                  ]     |             .
802                      | Other Group Memberships  [                  ]     |             .
803                      |                                                   |             .
804                      | < Accept and Add >  < Return to Configure Menu >  |             .
805         Enter the use ---------------------------------------------------              .
806
807 20. In the following fields type the following values without quotes and then highlight < Accept and Add > and press enter.
808
809 * Username: 'user'
810 * Real Name: 'User'
811 * Password: 'ChangeMe'
812 * Password (Again): 'ChangeMe'
813
814 21. The following dialog box will be displayed.
815
816         F10=Refresh Display                                                            .
817                                                                                        .
818                                                       ,--,           |           ,--,  .
819                                                       |   `-,       ,^,       ,-'   |  .
820                                                        `,    `-,   (/ \)   ,-'    ,'   .
821                                                          `-,    `-,/   \,-'    ,-'     .
822                                                             `------(   )------'        .
823                                                         ,----------(   )----------,    .
824                                                        |        _,-(   )-,_        |   .
825                                    -----| Information |----  ,-'   \   /   `-,__,-'    .
826                                   |                        |        | |                .
827                                   | User `user' was added. |        | |                .
828                                   |                        |        | |                .
829                                   |         < OK >_        |        | |                .
830                                    ------------------------         | |                .
831                                                                     | |                .
832                                                                     `|'                .
833                                                                                        .
834                                                                                        .
835                                                                                        .
836                                                                                        .
837                                                                                        .
838                                                                                        .
839                                                                                        .
840                                                                                        .
841
842 22. Press enter. The menu from step 33 will be displayed. Highlight < Set root password > and press enter. The following menu will be displayed.
843
844         F10=Refresh Display                                                            .
845                                                                                        .
846                                                       ,--,           |           ,--,  .
847                                                       |   `-,       ,^,       ,-'   |  .
848                                                        `,    `-,   (/ \)   ,-'    ,'   .
849                   -------------------| Set Root Password |-------------------  ,-'     .
850                  |                                                           |'        .
851                  | Here you can set the super-user (root) password.          |----,    .
852                  |                                                           |     |   .
853                  | Note: root's new password will appear in the install log. |__,-'    .
854                  | If this is a problem, please set root's password manually |         .
855                  | after rebooting into the installed system instead.        |         .
856                  |                                                           |         .
857                  | Root password        [_                 ]                 |         .
858                  | Root password again  [                  ]                 |         .
859                  |                                                           |         .
860                  |                < Accept and Set Password >                |         .
861                  |               < Return to Configure Menu >                |         .
862                   -----------------------------------------------------------          .
863                                                                                        .
864                                                                                        .
865                                                                                        .
866                                                                                        .
867                                                                                        .
868                                                                                        .
869         Enter the root password you would like to use                                  .
870
871 23. In the following fields type the following values without quotes and then highlight <Accept and Set Password > and press enter.
872
873 * Root password: 'ChangeMe'
874 * Root password again: 'ChangeMe'
875
876 24. The following dialog box will be displayed.
877
878         F10=Refresh Display                                                            .
879                                                                                        .
880                                                       ,--,           |           ,--,  .
881                                                       |   `-,       ,^,       ,-'   |  .
882                                                        `,    `-,   (/ \)   ,-'    ,'   .
883                                                          `-,    `-,/   \,-'    ,-'     .
884                                                             `------(   )------'        .
885                                                         ,----------(   )----------,    .
886                                                        |        _,-(   )-,_        |   .
887                             ------------| Information |----------- \   /   `-,__,-'    .
888                            |                                      | | |                .
889                            | User root password has been changed. | | |                .
890                            |                                      | | |                .
891                            |                < OK >_               | | |                .
892                             --------------------------------------  | |                .
893                                                                     | |                .
894                                                                     `|'                .
895                                                                                        .
896                                                                                        .
897                                                                                        .
898                                                                                        .
899                                                                                        .
900                                                                                        .
901                                                                                        .
902                                                                                        .
903
904 25. Press enter. The menu from step 33 will be displayed. Highlight < Configure network interfaces > and press enter. The following menu will be displayed.
905
906         F10=Refresh Display                                                            .
907                                                                                        .
908                                                       ,--,           |           ,--,  .
909                                                       |   `-,       ,^,       ,-'   |  .
910                                                        `,    `-,   (/ \)   ,-'    ,'   .
911                                                          `-,    `-,/   \,-'    ,-'     .
912                            ----------| Assign IP Address |----------   )------'        .
913                           |                                         |  )----------,    .
914                           | Please select which interface you would |  )-,_        |   .
915                           | like to configure:                      |  /   `-,__,-'    .
916                           |                                         | |                .
917                           | < em0 >_                                | |                .
918                           | < faith0 >                              | |                .
919                           | < lo0 >                                 | |                .
920                           | < ppp0 >                                | |                .
921                           | < sl0 >                                 | |                .
922                           | < Cancel >                              ||'                .
923                            -----------------------------------------                   .
924                                                                                        .
925                                                                                        .
926                                                                                        .
927                                                                                        .
928                                                                                        .
929                                                                                        .
930                                                                                        .
931
932 26. Highlight < em0 > and press enter. The following menu will be displayed.
933
934         F10=Refresh Display                                                            .
935                                                                                        .
936                                                       ,--,           |           ,--,  .
937                                                       |   `-,       ,^,       ,-'   |  .
938                                                        `,    `-,   (/ \)   ,-'    ,'   .
939                                                          `-,    `-,/   \,-'    ,-'     .
940                                                             `------(   )------'        .
941                            --------------| Use DHCP? |--------------   )----------,    .
942                           |                                         |  )-,_        |   .
943                           | DHCP allows the interface to            |  /   `-,__,-'    .
944                           | automatically obtain an IP address from | |                .
945                           | a nearby DHCP server.                   | |                .
946                           |                                         | |                .
947                           | Would you like to enable DHCP for em0?  | |                .
948                           |                                         | |                .
949                           |  < Use DHCP >_ < Configure Manually >   | |                .
950                            ----------------------------------------- |'                .
951                                                                                        .
952                                                                                        .
953                                                                                        .
954                                                                                        .
955                                                                                        .
956                                                                                        .
957                                                                                        .
958                                                                                        .
959
960 27. Highlight < Use DHCP > and press enter. The following menu, specific to your hardware and network connection, will be displayed.
961
962         F10=Refresh Display                                                            .
963                                                                                        .
964                                                       ,--,           |           ,--,  .
965                            -------------| Information |------------- ^,       ,-'   |  .
966                           |                                         | \)   ,-'    ,'   .
967                           | em0:                                    |  \,-'    ,-'     .
968                           | flags=8843<UP,BROADCAST,RUNNING,SIMPLEX |  )------'        .
969                           | MULTICAST> mtu 1500                     |  )----------,    .
970                           | options=1b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_ |  )-,_        |   .
971                           | WTAGGING>                               |  /   `-,__,-'    .
972                           | inet6 fe80::a00:27ff:fe98:67cc%em0      | |                .
973                           | prefixlen 64 scopeid 0x1                | |                .
974                           | inet 10.0.2.15 netmask 0xffffff00       | |                .
975                           | broadcast 10.0.2.255                    | |                .
976                           | ether 08:00:27:98:67:cc                 | |                .
977                           | media: Ethernet autoselect (1000baseT   | |                .
978                           | <full-duplex>)                          ||'                .
979                           | status: active                          |                  .
980                           |                                         |                  .
981                           |                                         |                  .
982                           |                 < OK >_                 |                  .
983                            -----------------------------------------                   .
984                                                                                        .
985                                                                                        .
986                                                                                        .
987
988 28. Press enter. The menu from step 33 will be displayed. Highlight < Configure hostname and domain > and press enter. The following menu will be displayed.
989
990         F10=Refresh Display                                                            .
991                                                                                        .
992                                                       ,--,           |           ,--,  .
993                                                       |   `-,       ,^,       ,-'   |  .
994                                                        `,    `-,   (/ \)   ,-'    ,'   .
995                                                          `-,    `-,/   \,-'    ,-'     .
996                                                             `------(   )------'        .
997                              -------| Set Hostname/Domain |--------    )----------,    .
998                             |                                      |   )-,_        |   .
999                             | Please enter this machine's hostname |   /   `-,__,-'    .
1000                             | and domain name.                     || |                .
1001                             |                                      || |                .
1002                             | Hostname  [_                 ]       || |                .
1003                             | Domain    [                  ]       || |                .
1004                             |                                      || |                .
1005                             |                                      || |                .
1006                             |          < OK >  < Cancel >          |`|'                .
1007                              --------------------------------------                    .
1008                                                                                        .
1009                                                                                        .
1010                                                                                        .
1011                                                                                        .
1012                                                                                        .
1013                                                                                        .
1014         Enter the Hostname (e.g. `machine')                                            .
1015
1016 29. In the following fields type the following values without quotes and then highlight <OK > and press enter.
1017
1018 * Hostname: 'dfly'
1019 * Domain: 'localhost'
1020
1021 30. The menu from step 33 will be displayed. Highlight < Return to Welcome Menu > and press enter. The menu from step 7 will be displayed. Highlight < Reboot this Computer > and press enter. The following menu will be displayed.
1022
1023         F10=Refresh Display                                                            .
1024                                                                                        .
1025                                                       ,--,           |           ,--,  .
1026                                                       |   `-,       ,^,       ,-'   |  .
1027                                                        `,    `-,   (/ \)   ,-'    ,'   .
1028                                                          `-,    `-,/   \,-'    ,-'     .
1029                                                             `------(   )------'        .
1030                             ---------------| Reboot |---------------   )----------,    .
1031                            |                                        |  )-,_        |   .
1032                            | This machine is about to be shut down. |  /   `-,__,-'    .
1033                            | After the machine has reached its      | |                .
1034                            | shutdown state, you may remove the CD  | |                .
1035                            | from the CD-ROM drive tray and press   | |                .
1036                            | Enter to reboot from the HDD.          | |                .
1037                            |                                        | |                .
1038                            |               < Reboot >               | |                .
1039                            |       < Return to Welcome Menu >       ||'                .
1040                             ----------------------------------------                   .
1041                                                                                        .
1042                                                                                        .
1043                                                                                        .
1044                                                                                        .
1045                                                                                        .
1046                                                                                        .
1047                                                                                        .
1048
1049 31. Highlight < Reboot > and press enter. The following message will be displayed.
1050
1051         The operating system has halted.
1052         Please press any key to reboot.
1053
1054 32. Remove the virtual CD installation media from the virtual machine. Press any key to reboot. Before it finishes booting, the will be greeted with the menu from step 4. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
1055
1056         DragonFly/x86_64 (dfly.localhost) (ttyv0)
1057         
1058         login: _
1059
1060 33. Log in as root. You will be greeted with the following message and shell prompt.
1061
1062         Copyright (c) 2003-2014 The DragonFly Project.                              .
1063         Copyright (c) 1992-2003 The FreeBSD Project.                                .
1064         Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994    .
1065                 The Regents of the University of California. All rights reserved.   .
1066                                                                                     .
1067         DragonFly v3.8.1-RELEASE (X86_64_GENERIC) #16 Mon Jun 16 21:36:15 PDT 2014  .
1068                                                                                     .
1069         Welcome to DragonFly!                                                       .
1070                                                                                     .
1071         dfly# _                                                                     .
1072
1073 34. Type 'passwd' without quotes and press enter. Type in a new root password and press enter and then retype the new root password and press enter again.
1074
1075 35. Skim through /etc/hosts to find the following lines.
1076
1077         ::1                     localhost.my.domain
1078         127.0.0.1               localhost.my.domain
1079
1080     Then edit the previous lines to match the following lines and save the change to disk.
1081
1082         ::1                     dfly.localhost
1083         127.0.0.1               dfly.localhost
1084
1085 36. Skim through /home/user/.cshrc to find the following lines.
1086
1087         setenv  EDITOR  vi
1088
1089     Then edit the previous lines to match the following lines and save the change to disk.
1090
1091         setenv  EDITOR ee
1092
1093     To apply this change to the current shell, type 'source .cshrc' without quotes and press enter.
1094
1095 37. Type 'pkg update' without quotes and press enter. The following output will be displayed.
1096
1097         Updating repository catalogue
1098         digests.txz                         100%  995KB 497.6KB/s 845.1KB/s   00:02
1099         packagesite.txz                     100% 4398KB   1.4MB/s   1.8MB/s   00:03
1100         Incremental update completed, 21327 packages processed:
1101         0 packages updated, 0 removed and 21327 added.
1102
1103 38. From DPorts install the sudo package and its dependencies. To apply this change to the current shell, type 'rehash' without quotes and press enter.
1104
1105 39. Type 'visudo' without quotes and press enter. This will open a sudo configuration file within ee, the default text editor. Skim through the file to find the following line.
1106
1107         # %wheel ALL=(ALL) ALL
1108
1109     Then edit the previous line to match the following line and save the change to disk.
1110
1111         %wheel ALL=(ALL) ALL
1112
1113 40. Add user to the administrative wheel group by typing 'pw usermod user -G wheel' without quotes and press enter. Type 'exit' without quotes and press enter. Log in as user. You will be greeted with the following message and shell prompt.
1114
1115         Copyright (c) 2003-2014 The DragonFly Project.                                 .
1116         Copyright (c) 1992-2003 The FreeBSD Project.                                   .
1117         Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994       .
1118                 The Regents of the University of California. All rights reserved.      .
1119                                                                                        .
1120         DragonFly v3.8.1-RELEASE (X86_64_GENERIC) #16 Mon Jun 16 21:36:15 PDT 2014     .
1121                                                                                        .
1122         Welcome to DragonFly!                                                          .
1123                                                                                        .
1124         Man pages are divided into section depending on topic.  There are 9 different  .
1125         sections numbered from 1 (General Commands) to 9 (Kernel Developer's Manual).  .
1126         You can get an introduction to each topic by typing                            .
1127                                                                                        .
1128                 man <number> intro                                                     .
1129                                                                                        .
1130         In other words, to get the intro to general commands, type                     .
1131                                                                                        .
1132                 man 1 intro                                                            .
1133         > _                                                                            .
1134
1135 41. Type 'passwd' without quotes and press enter. Type 'ChangeMe' without quotes and press enter, then type a new password and press enter, and then retype the new password and press enter again.
1136
1137 42. Skim through /home/user/.cshrc to find the following lines.
1138
1139         setenv  EDITOR  vi
1140
1141     Then edit the previous lines to match the following lines and save the change to disk.
1142
1143         setenv  EDITOR ee
1144
1145     To apply this change to the current shell, type 'source .cshrc' without quotes and press enter.
1146
1147 # Tidbits
1148
1149 * Shell/Console/Command-Line-Prompt: In the default shell, **tcsh**, ctrl-d is equivalent to tab-tab in **bash**, both of which display possible auto completions. If the list of possible auto completions has changed, running the command rehash will update it. Typing part of a previous command and then pressing the up key is equivalent to pressing ctrl-r and then typing part of a previous command, both of which search previously run commands.
1150 * Package-Management: **pkg**, also known as pkgng, is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities.
1151 * Text-Editor: **ee** is roughly equivalent to **nano**. They are both easy to use command line text editors. The exit option will ask you whether you want to save. You can get to the exit confirmation by pressing Ctrl-[ or Esc and selecting 'a) leave editor'. The console text editor vi is supposedly great, but if you're not familiar with it and some command you run opens some system file with it, it can be quite alarming. Don't panic! To exit without saving changes type ':q!' without quotes and then press enter.
1152 * Manual: The command line program man, short for manual, is very handy for finding out information about programs, system files and more. One way to navigate man pages is by using your arrow keys. You can exit out of a manual page by pressing the letter q on your keyboard. To learn more about the man command, run the command man man which will show you the manual page for the man command.
1153 * Power-Down: sIn DragonFly BSD the command *shutdown -p now* will shutdown and turn off your computer. Using the -h switch instead of -p will shutdown and halt the computer but not turn it off. In Debian and probably other Linux distributions, the command *shutdown -h now* will shutdown and turn off your computer. The -p switch isn't available, but there may be a way to shutdown and halt without turning off your computer.
1154 * Find File: **grep** is great for finding text in a file and **find** is great for finding a file by name.
1155 * Process Management: Some good commands are top, ps, pkill and kill. There are no doubt others.
1156 * File-System: **Hammer** is hands down the best file system currently in existence. It has block level deduplication, it is supported out of the box by an operating system with great underpinnings, and it runs great on regular hardware.
1157 * Operating System: **DragonFly BSD** is an awesome operating system for many reasons other than that it's the only OS with Hammer, but Hammer is why I'm making the switch. DragonFly's default GUI configuration is a bit rough around the edges for everyday use. But it's nothing that a little ironing can't fix.
1158
1159 # Issues
1160
1161 * Disclaimer: I know that I should ensure that these issues are properly logged, but until that happens, hopefully these notes will be of some use to somebody.
1162 * Installer Supported Desktops: The installer should offer various desktop environment as supported options. Observed in DragonFly 3.8.1. I'm working on various walkthroughs as a workaround.
1163 * Early Keyboard Selection: The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.8.1.
1164 * Encryption Keyboard Selection: The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2.
1165 * Random Key for Encrypted Swap: When encrypting the swap partition, the installer should configure the boot loader to generate a random key each time the system is booted so that the password doesn't have to be typed twice when the system is booted. Observed in DragonFly 3.0.2.
1166 * Stay Decrypted for  Configuration: When configuring the system from the installer, if the system just finished installing with encryption, the hard drive should stay unlocked so that the user doesn't have to type in his password again. Observed in DragonFly 3.0.2.
1167 * No Confirmation for Decryption: When configuring the system from the installer, if the system is encrypted but was not just barely installed, the user should only have to type in his password once, not twice. Observed in DragonFly 3.0.2.
1168 * Plain Text Password in Install Log: When creating a user password in the installer, the password should not be written to a plain text installation log. Observed in DragonFly BSD 3.8.1. An adequate warning is given.
1169 * USB Installation Media Named Uniquely: When installing from a USB device onto a USB device, the installer should ensure that installed media is named such that when booted without the USB installer, the installed device name doesn't change. Observed in DragonFly 3.0.2.
1170 * 3TB+ HD Install: When installing onto a 3TB+ hard drive, the default partition table should be able to handle that size. Observed in DragonFly 3.0.2. Fixed and tested in snapshot on 8/14/2012. See workaround below.
1171 * Overwrite 3TB+ Partition Table: After selecting to install using all of a 3TB+ hard drive that already has an MS-DOS/MBR partition table on it, the installer should overwrite the partition table with an adequate partition table such as GPT. Observed in snapshot on 8/14/2012.
1172 * Wiki Centered Text: ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012.
1173 * XOrg Quit Errors: The following errors should not occur when quitting from the GUI.
1174
1175         waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0"
1176         xterm:  fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0"
1177         failed to unset mtrr: Device not configured
1178         
1179         
1180         xauth: (argv):1:  bad display name "myhostname.mysubdomain.mytld:0" in "remove" command
1181
1182     Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze.
1183
1184 # Workarounds
1185 ## Install Non-GUI on 3TB+ Hard Drive
1186
1187 *WARNING:* This workaround includes instructions which will delete all data from a hard drive.
1188
1189 Delete the partition table from the hard drive. There are various tools with which to do this, one particularly easy to use tool is the [GParted Live CD/USB](http://gparted.sourceforge.net/livecd.php).
1190
1191 Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases.
1192
1193 Tested in snapshot on 8/14/2012.
1194
1195 # Contribute
1196 ## Port VirtualBox to DragonFly BSD
1197
1198      - Build VirtualBox in FreeBSD
1199         - Install FreeBSD
1200         - Compile VirtualBox
1201         - Compile Guest Additions
1202      - Build VirtualBox in DragonFly BSD
1203         - Install DragonFly BSD (Xfce IMG/ISO Installer)
1204         - Compile VirtualBox
1205         - Install VirtualBox
1206         - Test VirtualBox
1207         - Compile Guest Additions
1208         - Install Guest Additions
1209         - Test Guest Additions
1210      - Package for DPorts
1211      - Upload to DPorts
1212
1213 ## Update and Fix Bugs of Desktop Environments in DPorts
1214
1215      - Install DragonFly BSD
1216      - Compile Updated Desktop Environments
1217      - Install Updated Desktop Environments
1218      - Test, Log Bugs, and Fix Bugs in Updated Desktop Environments
1219      - Package for DPorts
1220      - Upload to DPorts
1221
1222 ## DragonFly BSD Network Shares Walkthrough
1223
1224      - Install DragonFly BSD
1225      - Figure out network shares and write a walkthrough.