(no commit message)
[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 * Long Walkthrough of **DragonFly BSD** Installation and Configuration
10 * [Golang Tutorial](http://varialus.wikidot.com/golang)
11 * [Wingo Tutorial](http://varialus.wikidot.com/wingo)
12 * [Git GUI Tutorial](http://varialus.wikidot.com/git-gui)
13 * [Agar Tutorial](http://varialus.wikidot.com/agar)
14 * Long Walkthrough of **MATE** Installation and Configuration
15 * Short Walkthrough of **Enlightenment** Installation and Configuration
16
17 2. **Tidbits**
18
19 * Shell/Console/Command-Line-Prompt: tcsh/bash, ctrl-d/tab-tab, partial-previous-command-up-key/ctrl-r-partial-previous-command, rehash
20 * Package-Management: pkgng/apt-get
21 * Text-Editor: ee/nano, vi :q!
22 * Manual: man man
23 * Power-Down: shutdown -p now
24 * Find File: grep, find / -name fileName
25 * Process Management: top, ps, pkill, kill
26 * File-System: Hammer
27 * Operating System: DragonFly BSD
28
29 3. **Issues**
30
31 * Disclaimer
32 * Installer Supported Desktops: dfly 3.8.1
33 * Early Keyboard Selection: dfly 3.8.1
34 * Encryption Keyboard Selection: dfly 3.0.2
35 * Random Key for Encrypted Swap: dfly 3.0.2
36 * Stay Decrypted for  Configuration: dfly 3.0.2
37 * No Confirmation for Decryption: dfly 3.0.2
38 * Plain Text Password in Install Log: dfly 3.8.1
39 * USB Installation Media Named Uniquely: dfly 3.0.2
40 * 3TB+ HD Install: dfly 3.0.2, fixed in snapshot on 8/14/2012
41 * Overwrite 3TB+ Partition Table: snapshot 8/14/2012
42 * Wiki Centered Text: 8/25/2012
43 * XOrg Quit Errors: dfly 3.0.2, VirtualBox 4.1.20
44
45 4. **Workarounds**
46
47 * Install Non-GUI on 3TB+ Hard Drive
48
49 5. **Contribute**
50
51 * Port VirtualBox to DragonFly BSD
52 * Update and Fix Bugs of Desktop Environments in DPorts
53 * DragonFly BSD Network Shares Walkthrough
54
55 ## Featured
56
57 ### Long Walkthrough of DragonFly BSD Installation and Configuration
58
59 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.
60
61 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
62
63 2. Set the the virtual hardware clock set to UTC time.
64
65 3. Download and extract the x86_64 CD [installation media](http://www.dragonflybsd.org/download/) and then add it to the virtual machine, but remember to remove it before taking VirtualBox snapshots.
66
67 4. Start the virtual machine. Before it finishes booting, the will be greeted with the following boot menu.
68
69         
70         DragonFly/i386 bootstrap loader, Revision 1.1
71         (justin@pkgbox64.dragonflybsd.org, Mon Jun 16 21:33:12 PDT 2014)
72                                                    |
73         1. Boot DragonFly [kernel]                 |   ,--,           |           ,--,
74         2. Boot DragonFly in Safe Mode             |   |   `-,       ,^,       ,-'   |
75         3. Boot DragonFly without AHCI driver      |    `,    `-,   (/ \)   ,-'    ,'
76         4. Boot DragonFly without ACPI driver      |      `-,    `-,/   \,-'    ,-'
77         9. Escape to loader prompt (also ESC)      |         `------(   )------'
78         r. Boot DragonFly to a rescue ramdisk      |     ,----------(   )----------,
79         s. Boot DragonFly in single user mode      |    |        _,-(   )-,_        |
80         v. Boot DragonFly with verbose logging     |     `-,__,-'   \   /   `-,__,-'
81         R. Reboot                                  |                 | |
82                                                    |                 | |
83                                                    |                 | |
84                                                    |                 | |
85                                                    |                 | |
86                                                    |                 | |
87                                                    |                 `|'
88                                                    |
89         Booting in 10 seconds... _
90
91 5. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
92
93         Welcome to DragonFly!
94         
95         To start the installer, login as 'installer'.  To just get a shell prompt,
96         login as 'root'.
97         
98         DragonFly/x86_64 (Amnesiac) (ttyv0)
99         
100         login: _
101
102 6. Type 'installer' without quotes and press enter.
103
104 7. The following menu will be displayed.
105
106         F10=Refresh Display                                                            .
107                                                                                        .
108                                                       ,--,           |           ,--,  .
109          ------------------------| Welcome to DragonFly BSD |------------------------- .
110         |                                                                             |.
111         | Welcome to the DragonFly BSD Live CD.                                       |.
112         |                                                                             |.
113         | DragonFly BSD is an efficient and elegant BSD Unix-derived operating        |.
114         | system.  For more information, see http://www.dragonflybsd.org              |.
115         |                                                                             |.
116         | From this CD, you can boot into DragonFly BSD ``live'' (without installing  |.
117         | it) to evaluate it, to install it manually, or to troubleshoot problems     |.
118         | with an existing installation, using either a command prompt or menu-driven |.
119         | utilities.                                                                  |.
120         |                                                                             |.
121         | Also, you can use this automated application to assist you in installing    |.
122         | DragonFly BSD on this computer and configuring it once it is installed.     |.
123         |                                                                             |.
124         |        < Install DragonFly BSD >_ < Configure an Installed System >         |.
125         |    < Live CD Utilities >  < Exit to Live CD >  < Reboot this Computer >     |.
126         |                     < Setup NetBoot Install Services >                      |.
127          ----------------------------------------------------------------------------- .
128                                                                                        .
129                                                                                        .
130         Install DragonFly BSD on a HDD or HDD partition on this computer               .
131
132 8. The bottom line changes depending on which option is selected.
133
134 9. Highlight the option < Install DragonFly BSD > and press enter.
135
136 10. The following menu will be displayed.
137
138         F10=Refresh Display                                                            .
139                                                                                        .
140                                                       ,--,           |           ,--,  .
141                                                       |   `-,       ,^,       ,-'   |  .
142                                                        `,    `-,   (/ \)   ,-'    ,'   .
143          --------------------------| Begin Installation |----------------------------- .
144         |                                                                             |.
145         | This application will install DragonFly BSD on one of the hard disk drives  |.
146         | attached to this computer. It has been designed to make it easy to install  |.
147         | DragonFly BSD in the typical case. If you have special requirements that    |.
148         | are not addressed by this installer, or if you have problems using it, you  |.
149         | are welcome to install DragonFly BSD manually. To do so select Exit to Live |.
150         | CD, login as root, and follow the instructions given in the file /README .  |.
151         |                                                                             |.
152         | NOTE! As with any installation process, YOU ARE STRONGLY ENCOURAGED TO BACK |.
153         | UP ANY IMPORTANT DATA ON THIS COMPUTER BEFORE PROCEEDING!                   |.
154         |                                                                             |.
155         | < Install DragonFly BSD >_ < Return to Welcome Menu >  < Exit to Live CD >  |.
156          ----------------------------| Press F1 for Help |---------------------------- .
157                                                                                        .
158                                                                                        .
159                                                                                        .
160                                                                                        .
161                                                                                        .
162                                                                                        .
163                                                                                        .
164
165 11. Highlight the option < Install DragonFly BSD > and press enter.
166
167 12. The following menu, specific to your hardware, will be displayed.
168
169         F10=Refresh Display                                                            .
170                                                                                        .
171                                                       ,--,           |           ,--,  .
172                                                       |   `-,       ,^,       ,-'   |  .
173                                                        `,    `-,   (/ \)   ,-'    ,'   .
174                                                          `-,    `-,/   \,-'    ,-'     .
175                                                             `------(   )------'        .
176                  -----------------------| Select Disk |----------------------- ---,    .
177                 |                                                             |    |   .
178                 | Select a disk on which to install DragonFly BSD             |_,-'    .
179                 |                                                             |        .
180                 | < ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33 >_|        .
181                 | < vn0 >                                                     |        .
182                 | < vn1 >                                                     |        .
183                 | < vn2 >                                                     |        .
184                 | < vn3 >                                                     |        .
185                 | < Return to Begin Installation >                            |        .
186                  -------------------------------------------------------------         .
187                                                                                        .
188                                                                                        .
189                                                                                        .
190                                                                                        .
191                                                                                        .
192                                                                                        .
193                                                                                        .
194
195 13. Highlight the disk on which to install DragonFly BSD, in this case ad0, and press Enter.
196
197 14. The following menu will be displayed.
198
199         F10=Refresh Display                                                            .
200                                                                                        .
201                                                       ,--,           |           ,--,  .
202                                                       |   `-,       ,^,       ,-'   |  .
203                                                        `,    `-,   (/ \)   ,-'    ,'   .
204                                                          `-,    `-,/   \,-'    ,-'     .
205                                                             `------(   )------'        .
206                                                         ,----------(   )----------,    .
207                ------------------------| How Much Disk? |------------------------  |   .
208               |                                                                  |'    .
209               | Select how much of this disk you want to use for DragonFly BSD.  |     .
210               |                                                                  |     .
211               | ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33          |     .
212               |                                                                  |     .
213               |            < Use Entire Disk >_ < Use Part of Disk >             |     .
214               |                    < Return to Select Disk >                     |     .
215                ------------------------------------------------------------------      .
216                                                                                        .
217                                                                                        .
218                                                                                        .
219                                                                                        .
220                                                                                        .
221                                                                                        .
222                                                                                        .
223                                                                                        .
224
225 15. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter.
226
227 16. The following menu will be displayed.
228
229         F10=Refresh Display                                                            .
230                                                                                        .
231                                                       ,--,           |           ,--,  .
232                                                       |   `-,       ,^,       ,-'   |  .
233                             ------| Are you absolutely sure? |------  \)   ,-'    ,'   .
234                            |                                        |  \,-'    ,-'     .
235                            | WARNING! ALL data in ALL partitions on |  )------'        .
236                            | the disk                               |  )----------,    .
237                            |                                        |  )-,_        |   .
238                            | ad0: 131072MB <VBOX HARDDISK 1.0> at   |  /   `-,__,-'    .
239                            | ata0-master UDMA33                     | |                .
240                            |                                        | |                .
241                            | will be IRREVOCABLY ERASED!            | |                .
242                            |                                        | |                .
243                            | Are you ABSOLUTELY SURE you wish to    | |                .
244                            | take this action? This is your LAST    | |                .
245                            | CHANCE to cancel!                      ||'                .
246                            |                                        |                  .
247                            |           < OK >_ < Cancel >           |                  .
248                             ----------------------------------------                   .
249                                                                                        .
250                                                                                        .
251                                                                                        .
252                                                                                        .
253                                                                                        .
254
255 17. If you are absolutely sure, highlight < OK > and press enter.
256
257 18. The following menu will be displayed.
258
259         F10=Refresh Display                                                            .
260                                                                                        .
261                                                       ,--,           |           ,--,  .
262                                                       |   `-,       ,^,       ,-'   |  .
263                                                        `,    `-,   (/ \)   ,-'    ,'   .
264                                                          `-,    `-,/   \,-'    ,-'     .
265                                                             `------(   )------'        .
266                              -----------| Information |------------    )----------,    .
267                             |                                      |   )-,_        |   .
268                             | The disk                             |   /   `-,__,-'    .
269                             |                                      || |                .
270                             | ad0: 131072MB <VBOX HARDDISK 1.0> at || |                .
271                             | ata0-master UDMA33                   || |                .
272                             |                                      || |                .
273                             | was formatted.                       || |                .
274                             |                                      || |                .
275                             |                < OK >                |`|'                .
276                              --------------------------------------                    .
277                                                                                        .
278                                                                                        .
279                                                                                        .
280                                                                                        .
281                                                                                        .
282                                                                                        .
283                                                                                        .
284
285 19. Press enter.
286
287 20. The following menu will be displayed.
288
289         F10=Refresh Display                                                            .
290                                                                                        .
291                                                       ,--,           |           ,--,  .
292                                                       |   `-,       ,^,       ,-'   |  .
293                                                        `,    `-,   (/ \)   ,-'    ,'   .
294                                                          `-,    `-,/   \,-'    ,-'     .
295                                                             `------(   )------'        .
296                    -----------------| Select file system |------------------ -----,    .
297                   |                                                         |      |   .
298                   | Please select the file system you want to use with      |,__,-'    .
299                   | DragonFly BSD.                                          |          .
300                   |                                                         |          .
301                   | HAMMER is the new DragonFly BSD file system. UFS is the |          .
302                   | traditional BSD file system.                            |          .
303                   |                                                         |          .
304                   | < Use HAMMER >_ < Use UFS >  < Return to Select Disk >  |          .
305                    ---------------------------------------------------------           .
306                                                                                        .
307                                                                                        .
308                                                                                        .
309                                                                                        .
310                                                                                        .
311                                                                                        .
312                                                                                        .
313                                                                                        .
314
315 21. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter.
316
317 22. The following menu will be displayed.
318
319         F10=Refresh Display                                                            .
320                                                                                        .
321                                                       ,--,           |           ,--,  .
322                --------------------| Create Subpartitions |---------------------    |  .
323               |                                                                 | ,'   .
324               | Set up the subpartitions (also knows as just `partitions' in    |'     .
325               | BSD tradition) you want to have on this primary partition. In   |      .
326               | most cases you should be fine with the default settings.        |-,    .
327               |                                                                 |  |   .
328               | For Capacity, use 'M' to indicate megabytes, 'G' to indicate    |-'    .
329               | gigabytes, and so on (up to 'E'.) A single '*' indicates 'use   |      .
330               | the remaining space on the primary partition'.                  |      .
331               |                                                                 |      .
332               | Mountpoint  Capacity  Encrypted                                 |      .
333               | [/boot_   ] [768M   ] [ ]     < Ins > < Del >                   |      .
334               | [swap     ] [8192M  ] [ ]     < Ins > < Del >                   |      .
335               | [/        ] [*      ] [ ]     < Ins > < Del >                   |      .
336               |                               < Add >                           |      .
337               |                                                                 |      .
338               |     < Accept and Create >  < Return to Select Disk >            |      .
339                -------------------| Press F1 for Help |-------------------------       .
340                                                                                        .
341                                                                                        .
342                                                                                        .
343                                                                                        .
344
345 23. Highlight < Accept and Create > and press enter.
346
347 24. The following menu will be displayed.
348
349         F10=Refresh Display                                                            .
350                                                                                        .
351                                                       ,--,           |           ,--,  .
352                                                       |   `-,       ,^,       ,-'   |  .
353                                                        `,    `-,   (/ \)   ,-'    ,'   .
354                                                          `-,    `-,/   \,-'    ,-'     .
355                -------------------------| Install OS |--------------------------       .
356               |                                                                 |-,    .
357               | Everything is now ready to install the actual files which       |  |   .
358               | comprise the DragonFly BSD operating system on the selected     |-'    .
359               | partition of the selected disk.                                 |      .
360               |                                                                 |      .
361               | Note that this process will take quite a while to finish. You   |      .
362               | may wish to take a break now and come back to the computer in a |      .
363               | short while.                                                    |      .
364               |                                                                 |      .
365               | < Begin Installing Files >_ < Return to Create Subpartitions >  |      .
366                -----------------------------------------------------------------       .
367                                                                                        .
368                                                                                        .
369                                                                                        .
370                                                                                        .
371                                                                                        .
372                                                                                        .
373                                                                                        .
374                                                                                        .
375
376 25. Highlight < Begin Installing Files > and press enter.
377
378 26. The following progress bar will be displayed.
379
380         F10=Refresh Display                                                            .
381                                                                                        .
382                                                       ,--,           |           ,--,  .
383                                                       |   `-,       ,^,       ,-'   |  .
384                                                        `,    `-,   (/ \)   ,-'    ,'   .
385                                                          `-,    `-,/   \,-'    ,-'     .
386                                                             `------(   )------'        .
387                                                         ,----------(   )----------,    .
388                   -------------------| Executing Commands |-------------------     |   .
389                  |                                                            |_,-'    .
390                  | /bin/cpdup -o -vvv -u /usr/share /mnt/usr/share            |        .
391                  |                                                            |        .
392                  |          [*#################65%###              ]          |        .
393                  |                                                            |        .
394                  |                         < Cancel >_                        |        .
395                   ------------------------------------------------------------         .
396                                                                     `|'                .
397                                                                                        .
398                                                                                        .
399                                                                                        .
400                                                                                        .
401                                                                                        .
402                                                                                        .
403                                                                                        .
404                                                                                        .
405
406 27. When it finishes, the following menu will be displayed.
407
408         F10=Refresh Display                                                            .
409                                                                                        .
410                                                       ,--,           |           ,--,  .
411                                                       |   `-,       ,^,       ,-'   |  .
412                     ---------------| Install Bootblock(s) |----------------,-'    ,'   .
413                    |                                                       |   ,-'     .
414                    | You may now wish to install bootblocks on one or more |--'        .
415                    | disks. If you already have a boot manager installed,  |------,    .
416                    | you can skip this step (but you may have to configure |       |   .
417                    | your boot manager separately.)  If you installed      |-,__,-'    .
418                    | DragonFly BSD on a disk other than your first disk,   |           .
419                    | you will need to put the bootblock on at least your   |           .
420                    | first disk and the DragonFly BSD disk.                |           .
421                    |                                                       |           .
422                    | Disk Drive  Install Bootblock?  Packet Mode?          |           .
423                    | [ad0_     ] [X]                 [X]                   |           .
424                    |                                                       |           .
425                    |           < Accept and Install Bootblocks >           |           .
426                    |                  < Skip this Step >                   |           .
427                     -----------------| Press F1 for Help |-----------------            .
428                                                                                        .
429                                                                                        .
430                                                                                        .
431                                                                                        .
432         The disk on which you wish to install a bootblock                              .
433
434 28. Highlight < Accept and Install Bootblocks > and press enter.
435
436 29. The following dialog box will be displayed.
437
438         F10=Refresh Display                                                            .
439                                                                                        .
440                                                       ,--,           |           ,--,  .
441                                                       |   `-,       ,^,       ,-'   |  .
442                                                        `,    `-,   (/ \)   ,-'    ,'   .
443                                                          `-,    `-,/   \,-'    ,-'     .
444                                                             `------(   )------'        .
445                                                         ,----------(   )----------,    .
446                                                        |        _,-(   )-,_        |   .
447                            -------------| Information |-------------   /   `-,__,-'    .
448                           |                                         | |                .
449                           | Bootblocks were successfully installed! | |                .
450                           |                                         | |                .
451                           |                 < OK >                  | |                .
452                            -----------------------------------------  |                .
453                                                                     | |                .
454                                                                     `|'                .
455                                                                                        .
456                                                                                        .
457                                                                                        .
458                                                                                        .
459                                                                                        .
460                                                                                        .
461                                                                                        .
462                                                                                        .
463
464 30. Press enter.
465
466 31. The following menu will be displayed.
467
468         F10=Refresh Display                                                            .
469                                                                                        .
470                                                       ,--,           |           ,--,  .
471                                                       |   `-,       ,^,       ,-'   |  .
472                                                        `,    `-,   (/ \)   ,-'    ,'   .
473                                                          `-,    `-,/   \,-'    ,-'     .
474                -----------------| DragonFly BSD is Installed! |-----------------       .
475               |                                                                 |-,    .
476               | Congratulations!                                                |  |   .
477               |                                                                 |-'    .
478               | DragonFly BSD has successfully been installed on this computer. |      .
479               | You may now proceed to configure the installation. Alternately, |      .
480               | you may wish to reboot the computer and boot into the installed |      .
481               | system to confirm that it works.                                |      .
482               |                                                                 |      .
483               |              < Configure this System >_ < Reboot >              |      .
484               |                   < Return to Welcome Menu >                    |      .
485                -----------------------------------------------------------------       .
486
487 32. Highlight < Configure this System > and press enter.
488
489 33. The following menu will be displayed.
490
491         F10=Refresh Display                                                            .
492                                                                                        .
493                                                       ,--,           |           ,--,  .
494                             ---| Configure an Installed System |---- ^,       ,-'   |  .
495                            |                                        | \)   ,-'    ,'   .
496                            | The options on this menu allow you to  |  \,-'    ,-'     .
497                            | configure a DragonFly BSD system after |  )------'        .
498                            | it has already been installed.         |  )----------,    .
499                            |                                        |  )-,_        |   .
500                            | < Select timezone >_                   |  /   `-,__,-'    .
501                            | < Set date and time >                  | |                .
502                            | < Set keyboard map >                   | |                .
503                            | < Set root password >                  | |                .
504                            | < Add a user >                         | |                .
505                            | < Configure network interfaces >       | |                .
506                            | < Configure hostname and domain >      | |                .
507                            | < Set console font >                   ||'                .
508                            | < Set screen map >                     |                  .
509                            | < Remove software packages >           |                  .
510                            | < Return to Welcome Menu >             |                  .
511                             ----------------------------------------                   .
512                                                                                        .
513                                                                                        .
514                                                                                        .
515         Set the Time Zone of your physical location                                    .
516
517 34. Highlight < Select timezone > and press enter.
518
519 35. The following menu will be displayed.
520
521         F10=Refresh Display                                                            .
522                                                                                        .
523                                                       ,--,           |           ,--,  .
524                                                       |   `-,       ,^,       ,-'   |  .
525                                                        `,    `-,   (/ \)   ,-'    ,'   .
526                                                          `-,    `-,/   \,-'    ,-'     .
527                                                             `------(   )------'        .
528                                                         ,----------(   )----------,    .
529                           | Local or UTC (Greenwich Mean Time) clock | )-,_        |   .
530                          |                                            |/   `-,__,-'    .
531                          | Is this machine's CMOS clock set to        |                .
532                          | UTC?                                       |                .
533                          |                                            |                .
534                          | If it is set to local time, or you         |                .
535                          | don't know, please choose NO here!         |                .
536                          |                                            |                .
537                          |              < Yes >_ < No >               |                .
538                           --------------------------------------------                 .
539                                                                                        .
540                                                                                        .
541                                                                                        .
542                                                                                        .
543                                                                                        .
544                                                                                        .
545                                                                                        .
546
547 36. Highlight < Yes > and press enter.
548
549 37. The following menu will be displayed.
550
551         F10=Refresh Display ----------| Select Time Zone |----------                   .
552                            |                                        #                  .
553                            | Select a Time Zone appropriate to your #|           ,--,  .
554                            | physical location.                     #^,       ,-'   |  .
555                            |                                        # \)   ,-'    ,'   .
556                            | < Africa >_                            #  \,-'    ,-'     .
557                            | < America >                            #  )------'        .
558                            | < Antarctica >                         #  )----------,    .
559                            | < Arctic >                             #  )-,_        |   .
560                            | < Asia >                               #  /   `-,__,-'    .
561                            | < Atlantic >                           # |                .
562                            | < Australia >                          # |                .
563                            | < CET >                                # |                .
564                            | < CST6CDT >                            # |                .
565                            | < EET >                                # |                .
566                            | < EST >                                # |                .
567                            | < EST5EDT >                            #|'                .
568                            | < Etc >                                #                  .
569                            | < Europe >                             *                  .
570                            | < GMT >                                *                  .
571                            | < HST >                                *                  .
572                            | < Indian >                             *                  .
573                            | < MET >                                *                  .
574                            | < MST >                                *                  .
575                             ----------------------------------------                   .
576
577 38. Highlight < GMT > and press enter.
578
579 39. The following dialog box will be displayed.
580
581         F10=Refresh Display                                                            .
582                                                                                        .
583                                                       ,--,           |           ,--,  .
584                                                       |   `-,       ,^,       ,-'   |  .
585                                                        `,    `-,   (/ \)   ,-'    ,'   .
586                                                          `-,    `-,/   \,-'    ,-'     .
587                                                             `------(   )------'        .
588                                                         ,----------(   )----------,    .
589                                                        |        _,-(   )-,_        |   .
590                                 --------| Information |--------    \   /   `-,__,-'    .
591                                |                               |    | |                .
592                                | The Time Zone has been set to |    | |                .
593                                | /mnt/usr/share/zoneinfo/GMT.  |    | |                .
594                                |                               |    | |                .
595                                |            < OK >_            |    | |                .
596                                 -------------------------------     | |                .
597                                                                     `|'                .
598                                                                                        .
599                                                                                        .
600                                                                                        .
601                                                                                        .
602                                                                                        .
603                                                                                        .
604                                                                                        .
605                                                                                        .
606
607 40. Press enter.
608
609 41. The menu from step 33 will be displayed.
610
611 42. If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, highlight  < Set keyboard map > and press enter. Otherwise skip to step 46.
612
613 43. The following menu will be displayed.
614
615         F10=Refresh Display  -------| Select Keyboard Map |--------                    .
616                             |                                      #                   .
617                             | Select a keyboard map appropriate to # |           ,--,  .
618                             | your keyboard layout.                #,^,       ,-'   |  .
619                             |                                      #/ \)   ,-'    ,'   .
620                             | < be.iso.acc.kbd >_                  #   \,-'    ,-'     .
621                             | < be.iso.kbd >                       #   )------'        .
622                             | < bg.bds.ctrlcaps.kbd >              *   )----------,    .
623                             | < bg.phonetic.ctrlcaps.kbd >         *   )-,_        |   .
624                             | < br275.cp850.kbd >                  *   /   `-,__,-'    .
625                             | < br275.iso.acc.kbd >                *| |                .
626                             | < br275.iso.kbd >                    *| |                .
627                             | < by.cp1131.kbd >                    *| |                .
628                             | < by.cp1251.kbd >                    *| |                .
629                             | < by.iso5.kbd >                      *| |                .
630                             | < ce.iso2.kbd >                      *| |                .
631                             | < colemak.iso15.acc.kbd >            *'|'                .
632                             | < cs.latin2.qwertz.kbd >             *                   .
633                             | < cz.iso2.kbd >                      *                   .
634                             | < danish.cp865.kbd >                 *                   .
635                             | < danish.iso.kbd >                   *                   .
636                             | < el.iso07.kbd >                     *                   .
637                             | < estonian.cp850.kbd >               *                   .
638                             | < estonian.iso.kbd >                 *                   .
639                              --------------------------------------                    .
640
641 44. Highlight < us.dvorak.kbd > and press enter.
642
643 45. The menu from step 33 will be displayed.
644
645 46. Highlight < Add a user > and press enter.
646
647 47. The following menu will be displayed.
648
649         F10=Refresh D -------------------| Add user |--------------------              .
650                      |                                                   |             .
651                      | Here you can add a user to an installed system.   |       ,--,  .
652                      |                                                   |    ,-'   |  .
653                      | You can leave the Home Directory, User ID, and    | ,-'    ,'   .
654                      | Login Group fields empty if you want these items  |'    ,-'     .
655                      | to be automatically allocated by the system.      |----'        .
656                      |                                                   |--------,    .
657                      | Note: this user's password will appear in the     |_        |   .
658                      | install log. If this is a problem, please add the | `-,__,-'    .
659                      | user manually after rebooting into the installed  |             .
660                      | system instead.                                   |             .
661                      |                                                   |             .
662                      | Username                 [_                 ]     |             .
663                      | Real Name                [                  ]     |             .
664                      | Password                 [                  ]     |             .
665                      | Password (Again)         [                  ]     |             .
666                      | Shell                    [/bin/tcsh         ]     |             .
667                      | Home Directory           [                  ]     |             .
668                      | User ID                  [                  ]     |             .
669                      | Login Group              [                  ]     |             .
670                      | Other Group Memberships  [                  ]     |             .
671                      |                                                   |             .
672                      | < Accept and Add >  < Return to Configure Menu >  |             .
673         Enter the use ---------------------------------------------------              .
674
675 48. In the following fields type the following values without quotes and then highlight < Accept and Add > and press enter.
676
677 * Username: 'user'
678 * Real Name: 'User'
679 * Password: 'ChangeMe'
680 * Password (Again): 'ChangeMe'
681
682 49. The following dialog box will be displayed.
683
684         F10=Refresh Display                                                            .
685                                                                                        .
686                                                       ,--,           |           ,--,  .
687                                                       |   `-,       ,^,       ,-'   |  .
688                                                        `,    `-,   (/ \)   ,-'    ,'   .
689                                                          `-,    `-,/   \,-'    ,-'     .
690                                                             `------(   )------'        .
691                                                         ,----------(   )----------,    .
692                                                        |        _,-(   )-,_        |   .
693                                    -----| Information |----  ,-'   \   /   `-,__,-'    .
694                                   |                        |        | |                .
695                                   | User `user' was added. |        | |                .
696                                   |                        |        | |                .
697                                   |         < OK >_        |        | |                .
698                                    ------------------------         | |                .
699                                                                     | |                .
700                                                                     `|'                .
701                                                                                        .
702                                                                                        .
703                                                                                        .
704                                                                                        .
705                                                                                        .
706                                                                                        .
707                                                                                        .
708                                                                                        .
709
710 50. Press enter.
711
712 51. The menu from step 33 will be displayed.
713
714 52. Highlight < Set root password > and press enter.
715
716 53. The following menu will be displayed.
717
718         F10=Refresh Display                                                            .
719                                                                                        .
720                                                       ,--,           |           ,--,  .
721                                                       |   `-,       ,^,       ,-'   |  .
722                                                        `,    `-,   (/ \)   ,-'    ,'   .
723                   -------------------| Set Root Password |-------------------  ,-'     .
724                  |                                                           |'        .
725                  | Here you can set the super-user (root) password.          |----,    .
726                  |                                                           |     |   .
727                  | Note: root's new password will appear in the install log. |__,-'    .
728                  | If this is a problem, please set root's password manually |         .
729                  | after rebooting into the installed system instead.        |         .
730                  |                                                           |         .
731                  | Root password        [_                 ]                 |         .
732                  | Root password again  [                  ]                 |         .
733                  |                                                           |         .
734                  |                < Accept and Set Password >                |         .
735                  |               < Return to Configure Menu >                |         .
736                   -----------------------------------------------------------          .
737                                                                                        .
738                                                                                        .
739                                                                                        .
740                                                                                        .
741                                                                                        .
742                                                                                        .
743         Enter the root password you would like to use                                  .
744
745 54. In the following fields type the following values without quotes and then highlight < Accept and Set Password > and press enter.
746
747 * Root password: 'ChangeMe'
748 * Root password again: 'ChangeMe'
749
750 55. The following dialog box will be displayed.
751
752         F10=Refresh Display                                                            .
753                                                                                        .
754                                                       ,--,           |           ,--,  .
755                                                       |   `-,       ,^,       ,-'   |  .
756                                                        `,    `-,   (/ \)   ,-'    ,'   .
757                                                          `-,    `-,/   \,-'    ,-'     .
758                                                             `------(   )------'        .
759                                                         ,----------(   )----------,    .
760                                                        |        _,-(   )-,_        |   .
761                             ------------| Information |----------- \   /   `-,__,-'    .
762                            |                                      | | |                .
763                            | The root password has been changed.  | | |                .
764                            |                                      | | |                .
765                            |                < OK >_               | | |                .
766                             --------------------------------------  | |                .
767                                                                     | |                .
768                                                                     `|'                .
769                                                                                        .
770                                                                                        .
771                                                                                        .
772                                                                                        .
773                                                                                        .
774                                                                                        .
775                                                                                        .
776                                                                                        .
777
778 56. Press enter.
779
780 57. The menu from step 33 will be displayed.
781
782 58. Highlight < Configure network interfaces > and press enter.
783
784 59. The following menu will be displayed.
785
786         F10=Refresh Display                                                            .
787                                                                                        .
788                                                       ,--,           |           ,--,  .
789                                                       |   `-,       ,^,       ,-'   |  .
790                                                        `,    `-,   (/ \)   ,-'    ,'   .
791                                                          `-,    `-,/   \,-'    ,-'     .
792                            ----------| Assign IP Address |----------   )------'        .
793                           |                                         |  )----------,    .
794                           | Please select which interface you would |  )-,_        |   .
795                           | like to configure:                      |  /   `-,__,-'    .
796                           |                                         | |                .
797                           | < em0 >_                                | |                .
798                           | < faith0 >                              | |                .
799                           | < lo0 >                                 | |                .
800                           | < ppp0 >                                | |                .
801                           | < sl0 >                                 | |                .
802                           | < Cancel >                              ||'                .
803                            -----------------------------------------                   .
804                                                                                        .
805                                                                                        .
806                                                                                        .
807                                                                                        .
808                                                                                        .
809                                                                                        .
810                                                                                        .
811
812 60. Highlight < em0 > and press enter.
813
814 61. The following menu will be displayed.
815
816         F10=Refresh Display                                                            .
817                                                                                        .
818                                                       ,--,           |           ,--,  .
819                                                       |   `-,       ,^,       ,-'   |  .
820                                                        `,    `-,   (/ \)   ,-'    ,'   .
821                                                          `-,    `-,/   \,-'    ,-'     .
822                                                             `------(   )------'        .
823                            --------------| Use DHCP? |--------------   )----------,    .
824                           |                                         |  )-,_        |   .
825                           | DHCP allows the interface to            |  /   `-,__,-'    .
826                           | automatically obtain an IP address from | |                .
827                           | a nearby DHCP server.                   | |                .
828                           |                                         | |                .
829                           | Would you like to enable DHCP for em0?  | |                .
830                           |                                         | |                .
831                           |  < Use DHCP >_ < Configure Manually >   | |                .
832                            ----------------------------------------- |'                .
833                                                                                        .
834                                                                                        .
835                                                                                        .
836                                                                                        .
837                                                                                        .
838                                                                                        .
839                                                                                        .
840                                                                                        .
841
842 62. Highlight < Use DHCP > and press enter.
843
844 63. The following menu, specific to your hardware and network connection, will be displayed.
845
846         F10=Refresh Display                                                            .
847                                                                                        .
848                                                       ,--,           |           ,--,  .
849                                                       |   `-,       ,^,       ,-'   |  .
850                            -------------| Information |-------------  \)   ,-'    ,'   .
851                           |                                         |  \,-'    ,-'     .
852                           | em0:                                    |  )------'        .
853                           | flags=8843<UP,BROADCAST,RUNNING,SIMPLEX |  )----------,    .
854                           | MULTICAST> mtu 1500                     |  )-,_        |   .
855                           | options=1b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_ |  /   `-,__,-'    .
856                           | WTAGGING>                               | |                .
857                           | inet6 fe80::a00:27ff:fe98:67cc%em0      | |                .
858                           | prefixlen 64 scopeid 0x1                | |                .
859                           | ether 08:00:27:98:67:cc                 | |                .
860                           | media: Ethernet autoselect (1000baseT   | |                .
861                           | <full-duplex>)                          | |                .
862                           | status: active                          ||'                .
863                           |                                         |                  .
864                           |                                         |                  .
865                           |                 < OK >_                 |                  .
866                            -----------------------------------------                   .
867                                                                                        .
868                                                                                        .
869                                                                                        .
870                                                                                        .
871
872 64. Press enter.
873
874 65. The menu from step 33 will be displayed.
875
876 66. Highlight < Configure hostname and domain > and press enter.
877
878 67. The following menu will be displayed.
879
880         F10=Refresh Display                                                            .
881                                                                                        .
882                                                       ,--,           |           ,--,  .
883                                                       |   `-,       ,^,       ,-'   |  .
884                                                        `,    `-,   (/ \)   ,-'    ,'   .
885                                                          `-,    `-,/   \,-'    ,-'     .
886                                                             `------(   )------'        .
887                              -------| Set Hostname/Domain |--------    )----------,    .
888                             |                                      |   )-,_        |   .
889                             | Please enter this machine's hostname |   /   `-,__,-'    .
890                             | and domain name.                     || |                .
891                             |                                      || |                .
892                             | Hostname  [_                 ]       || |                .
893                             | Domain    [                  ]       || |                .
894                             |                                      || |                .
895                             |                                      || |                .
896                             |          < OK >  < Cancel >          |`|'                .
897                              --------------------------------------                    .
898                                                                                        .
899                                                                                        .
900                                                                                        .
901                                                                                        .
902                                                                                        .
903                                                                                        .
904         Enter the Hostname (e.g. `machine')                                            .
905
906 68. In the following fields type the following values without quotes and then highlight < OK > and press enter.
907
908 * Hostname: 'dfly'
909 * Domain: 'localhost'
910
911 69. The menu from step 33 will be displayed.
912
913 70. Highlight < Return to Welcome Menu > and press enter.
914
915 71. The menu from step 7 will be displayed.
916
917 72. Highlight < Reboot this Computer > and press enter.
918
919 73. The following menu will be displayed.
920
921         F10=Refresh Display                                                            .
922                                                                                        .
923                                                       ,--,           |           ,--,  .
924                                                       |   `-,       ,^,       ,-'   |  .
925                                                        `,    `-,   (/ \)   ,-'    ,'   .
926                                                          `-,    `-,/   \,-'    ,-'     .
927                                                             `------(   )------'        .
928                             ---------------| Reboot |---------------   )----------,    .
929                            |                                        |  )-,_        |   .
930                            | This machine is about to be shut down. |  /   `-,__,-'    .
931                            | After the machine has reached its      | |                .
932                            | shutdown state, you may remove the CD  | |                .
933                            | from the CD-ROM drive tray and press   | |                .
934                            | Enter to reboot from the HDD.          | |                .
935                            |                                        | |                .
936                            |               < Reboot >               | |                .
937                            |       < Return to Welcome Menu >       ||'                .
938                             ----------------------------------------                   .
939                                                                                        .
940                                                                                        .
941                                                                                        .
942                                                                                        .
943                                                                                        .
944                                                                                        .
945                                                                                        .
946
947 74. Highlight < Reboot > and press enter.
948
949 75. The following message will be displayed.
950
951         The operating system has halted.
952         Please press any key to reboot.
953
954 76. Remove the virtual CD installation media from the virtual machine.
955
956 77. Press any key to reboot. Before it finishes booting, the will be greeted with the menu from step 4.
957
958 78. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
959
960         DragonFly/x86_64 (dfly.localhost) (ttyv0)
961         
962         login: _
963
964 79. Log in as root.
965
966 80. You will be greeted with the following message and shell prompt.
967
968         Copyright (c) 2003-2014 The DragonFly Project.                                 .
969         Copyright (c) 1992-2003 The FreeBSD Project.                                   .
970         Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994       .
971                 The Regents of the University of California. All rights reserved.      .
972                                                                                        .
973         DragonFly v4.0.0.32.gce3e27-RELEASE (X86_64_GENERIC) #25 Mon Nov 24 20:15:26 PS.
974         T 2014                                                                         .
975                                                                                        .
976         Welcome to DragonFly!                                                          .
977                                                                                        .
978         dfly# _                                                                        .
979
980 81. Type 'passwd' without quotes and press enter.
981
982 82. Type in a new root password and press enter and then retype the new root password and press enter again.
983
984 83. Type 'ee /etc/hosts' without quotes and press enter.
985
986 84. Without quotes twice replace 'localhost.my.domain' with 'dfly.localhost'.
987
988 85. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
989
990 86. Type 'ee .cshrc' without quotes and press enter.
991
992 87. Without quotes replace 'setenv Editor vi' with 'setenv Editor ee'.
993
994 88. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
995
996 89. Type 'source .cshrc' without quotes and press enter.
997
998 90. Type 'pkg update' without quotes and press enter.
999
1000 91. The following output will be displayed.
1001
1002         Updating Avalon repository catalogue...
1003         Fetching meta.txz: 100%   264 B   0.3k/s    00:01
1004         Fetching digests.txz: 100%    2 MB 313.9k/s    00:06
1005         Fetching packagesite.txz: 100%    4 MB 579.3k/s    00:08
1006         Processing new repository entries: 100%
1007         Avalon repository update completed. 21772 packages processed:
1008           0 updated, 0 removed and 21772 added.
1009
1010 92. Type 'pkg search sudo' without quotes, press enter and note the full name of sudo.
1011
1012 93. Type 'pkg search -f sudo-1.8.11.p1' without quotes and press enter.
1013
1014 94. Type 'pkg install sudo' without quotes and press enter. Then when prompted, type 'y' without quotes and press enter. (If it fails to install, try typing 'pkg upgrade' without quotes and then press enter.)
1015
1016 95. Type 'rehash' without quotes and press enter.
1017
1018 96. Type 'visudo' without quotes and press enter.
1019
1020 97. Without quotes replace '# %wheel ALL=(ALL) ALL' with ' %wheel ALL=(ALL) ALL'.
1021
1022 98. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
1023
1024 99. Type 'pw usermod user -G wheel' without quotes and press enter.
1025
1026 100. Type 'exit' without quotes and press enter.
1027
1028 101. Log in as user.
1029
1030 102. You will be greeted with the following message and shell prompt.
1031
1032         Copyright (c) 2003-2014 The DragonFly Project.                                 .
1033         Copyright (c) 1992-2003 The FreeBSD Project.                                   .
1034         Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994       .
1035                 The Regents of the University of California. All rights reserved.      .
1036                                                                                        .
1037         DragonFly v4.0.0.32.gce3e27-RELEASE (X86_64_GENERIC) #25 Mon Nov 24 20:15:26 PS.
1038         T 2014                                                                         .
1039                                                                                        .
1040         Welcome to DragonFly!                                                          .
1041                                                                                        .
1042         Man pages are divided into section depending on topic.  There are 9 different  .
1043         sections numbered from 1 (General Commands) to 9 (Kernel Developer's Manual).  .
1044         You can get an introduction to each topic by typing                            .
1045                                                                                        .
1046                 man <number> intro                                                     .
1047                                                                                        .
1048         In other words, to get the intro to general commands, type                     .
1049                                                                                        .
1050                 man 1 intro                                                            .
1051         > _                                                                            .
1052
1053 103. Type 'passwd' without quotes and press enter.
1054
1055 104. 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.
1056
1057 105. Type 'ee .cshrc' without quotes and press enter.
1058
1059 106. Without quotes replace 'setenv Editor vi' with 'setenv Editor ee'.
1060
1061 107. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
1062
1063 108. Type 'source .cshrc' without quotes and press enter.
1064
1065 109. Type 'exit' without quotes and press enter.
1066
1067 ### Long Walkthrough of MATE Installation and Configuration
1068
1069 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 "Long Walkthrough of DragonFly BSD Installation and Configuration" by Varialus.
1070
1071 MATE is my favorite desktop environment. When currently installed and configured as described in this walkthrough, MATE works but has the following issues.
1072
1073 * DPorts has MATE 1.6.1 but MATE 1.8 is the current stable release. 
1074 * DPorts currently does not include the MATE meta package.
1075 * Enabling hald prevents applications from launching via the MATE menu.
1076 * Many non-fatal errors are logged in the /home/user and /var/log directories.
1077 * The console-kit-daem command in the CLI program top has high CPU utilization.
1078 * One of the post installation messages mentions devstat, but devstat is not in DPorts.
1079
1080 I hope this walkthrough will make it easier for developers to properly fix these issues.
1081
1082     login: user
1083     Password:
1084     ...
1085     By pressing "Scroll Lock" you can use the arrow keys to scroll backward
1086     through the console output.  Press "Scroll Lock" again to turn it off.
1087     > pkg search xorg
1088     xorg-7.7
1089     ...
1090     > pkg search -f xorg-7.7
1091     ...
1092     This is a metaport for all the X.org packages available in the ports tree.
1093     
1094     WWW: http://www.x.org/
1095     > sudo pkg install xorg-7.7
1096     Password:
1097     ...
1098     The installation will require 200 MB more space
1099     
1100     70 MB to be downloaded
1101     
1102     Proceed with installing packages [y/N]: y
1103     ...
1104     ================================================================================
1105     You installed xterm with wide chars support. This introduces some limitations
1106     comparing to the plain single chars version: this version of xterm will use
1107     UTF-8 charset for selection buffers, breaking 8-bit copy/paste support unless
1108     you are using UTF-8 or ISO8859-1 locale. If you want 8-bit charset selections to
1109     work as before, use "eightBitSelectTypes" XTerm resource setting.
1110     
1111     For further information refer to the SELECT/PASTE section of xterm(1) manual
1112     page.
1113     ================================================================================
1114     ...
1115     > pkg search xdm
1116     ...
1117     xdm-1.1.11_2
1118     ...
1119     > pkg search -f xdm-1.1.11_2
1120     ...
1121     This package contains xdm, the X.Org X Display manager.
1122     > sudo pkg install xdm-1.1.11_2
1123     ...
1124     The installation will require 287 KB more space
1125     
1126     97 KB to be downloaded
1127     Proceed with installing packages [y/N]: y
1128     ...
1129     > pkg search mate
1130     ...
1131     > pkg search -x "mate-[a-z]+"
1132     Password:
1133     ...
1134     The installation will require 955 MB more space
1135     
1136     201 MB to be downloaded
1137     
1138     Proceed with installing packages [y/N]: y
1139     ...
1140     ===============================================================================
1141     
1142     In order to use the File System read/write monitor, you must chmod
1143     /dev/devstat so that all users can open it read-only.  For example:
1144     
1145     # chmod 0444 /dev/devstat
1146     
1147     In order for this to persist across reboots, add the following to
1148     /etc/devfs.conf:
1149     
1150     perm    devstat 0444
1151     
1152     ===============================================================================
1153     ...
1154     Note: in order to use the script dvipdf, dvips must be installed.
1155     This program may be provided by either print/dvips or print/dvipsk-tetex
1156     (print/dvipsk-tetex may be preferable since it doesn't conflict with
1157     tetex things).
1158     
1159     Also note that FAPIfontmap and FAPIcidfmap in /usr/local/share/ghostscript/9.06/Resource/Init
1160     have to be configured first.
1161     ...
1162     **************************************************************************
1163     Congratulations!  MATE base has been successfully installed on your system.
1164     For help on starting it up, as well as answers to common questions, and
1165     some known issues, please see the FreeBSD GNOME homepage at:
1166     
1167                            http://www.FreeBSD.org/gnome/
1168     
1169     **************************************************************************
1170     ...
1171     > sudo ee /etc/rc.conf
1172     ...
1173
1174 *Add the following two lines.*
1175
1176     hald_enable="NO"
1177     dbus_enable="YES"
1178
1179 *Press Esc or Ctl-[*
1180
1181     ...
1182     a) leave editor
1183     ...
1184     a) save changes
1185     ...
1186     > sudo ee /etc/ttys
1187     Password:
1188     ...
1189
1190 *Find the following line.*
1191
1192     ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   off secure
1193
1194 *Edit the previous line to match the following line.*
1195
1196     ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   on  secure
1197
1198 *Press Esc or Ctl-[*
1199
1200     ...
1201     a) leave editor
1202     ...
1203     a) save changes
1204     ...
1205     > sudo ee /usr/local/lib/X11/xdm/Xsetup_0
1206     ...
1207
1208 *Find the following line.*
1209
1210     xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
1211
1212 *Edit the previous line to match the following line.*
1213
1214     #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
1215
1216 *If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, add the following line.*
1217
1218     setxkbmap dvorak
1219
1220 *Press Esc or Ctl-[*
1221
1222     ...
1223     a) leave editor
1224     ...
1225     a) save changes
1226     ...
1227     > ee .xsession
1228     ...
1229
1230 *Add the following line.*
1231
1232     exec mate-session
1233
1234 *Press Esc or Ctl-[*
1235
1236     ...
1237     a) leave editor
1238     ...
1239     a) save changes
1240     ...
1241     > sudo ee /usr/local/lib/X11/xdm/xdm-config
1242     Password:
1243     ...
1244
1245 *Find the following line.*
1246
1247     DisplayManager*authorize:       true
1248
1249 *Edit the previous line to match the following line.*
1250
1251     DisplayManager*authorize:       false
1252
1253 *Press Esc or Ctl-[*
1254
1255     ...
1256     a) leave editor
1257     ...
1258     a) save changes
1259     ...
1260     > sudo shutdown -r now
1261     Password:
1262     ...
1263     Login: user
1264     Password: 
1265     ...
1266
1267 The MATE desktop will be displayed.
1268
1269 ### Short Walkthrough of Enlightenment Installation and Configuration
1270
1271 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 "Long Walkthrough of DragonFly BSD Installation and Configuration" by Varialus.
1272
1273 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.
1274
1275 * DPorts has Enlightenment E17 0.17.5 but Enlightenment E18 0.18.8 is the current stable release. I prefer that the Enlightenment version not be updated until the current stable release works at least as well as the version currently in DPorts.
1276 * 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.
1277 * The Enlightenment initial graphical configuration of keyboard layouts doesn't include the Dvorak keyboard layout.
1278 * The System > Restart and System > Power Off menu options don't work unless the Composite module is unloaded.
1279
1280 I hope this walkthrough will make it easier for developers to properly fix these issues.
1281
1282 1. From DPorts install the following packages and their dependencies.
1283
1284     * xorg
1285     * xdm
1286     * enlightenment
1287     * e17-modules.
1288
1289 2. Add the following line to /etc/rc.conf and save the change to disk.
1290
1291         dbus_enable="YES"
1292
1293 3. Skim through /etc/ttys to find the following line.
1294
1295         ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   off secure
1296
1297     Then edit the previous line to match the following line and save the change to disk.
1298
1299         ttyv8   "/usr/local/bin/xdm -nodaemon"  xterm   on  secure
1300
1301 4. Skim through /usr/local/lib/X11/xdm/Xsetup_0 to find the following line.
1302
1303         xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
1304
1305     Then edit the previous line to match the following line and save the change to disk.
1306
1307         #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
1308
1309 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.
1310
1311         setxkbmap dvorak
1312
1313 6. Skim through /usr/local/lib/X11/xdm/xdm-config to find the following line.
1314
1315         DisplayManager*authorize:       true
1316
1317     Then edit the previous line to match the following line and save the change to disk.
1318
1319         DisplayManager*authorize:       false
1320
1321 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.
1322
1323         exec enlightenment_start
1324
1325 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."
1326
1327         sudo chmod u+s /usr/local/lib/enlightenment/utils/enlightenment_sys
1328
1329 9. Restart DragonFly BSD and log in as user.
1330
1331 10. The Enlightenment initial graphical configuration will be displayed. Select the following options.
1332
1333 * Language: English
1334 * Keyboard: English (US)
1335 * Profile: Computer (Standard Enlightenment)
1336 * Sizing: 1.2 Title
1337 * Window Focus: Click
1338 * Updates: Enable update checking
1339 * Taskbar: Enable Taskbar
1340
1341 11. 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.
1342
1343 12. 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.
1344
1345 13. 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.
1346
1347 ## Tidbits
1348 * 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.
1349 * Package-Management: **pkg**, also known as pkgng, is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities.
1350 * 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.
1351 * 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.
1352 * 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.
1353 * Find File: **grep** is great for finding text in a file and **find** is great for finding a file by name.
1354 * Process Management: Some good commands are top, ps, pkill and kill. There are no doubt others.
1355 * 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.
1356 * 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.
1357
1358 ## Issues
1359 * 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.
1360 * 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.
1361 * Early Keyboard Selection: The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.8.1.
1362 * Encryption Keyboard Selection: The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2.
1363 * 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.
1364 * 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.
1365 * 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.
1366 * 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.
1367 * 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.
1368 * 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.
1369 * 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.
1370 * Wiki Centered Text: ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012.
1371 * XOrg Quit Errors: The following errors should not occur when quitting from the GUI.
1372
1373         waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0"
1374         xterm:  fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0"
1375         failed to unset mtrr: Device not configured
1376         
1377         
1378         xauth: (argv):1:  bad display name "myhostname.mysubdomain.mytld:0" in "remove" command
1379
1380     Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze.
1381
1382 ## Workarounds
1383 **Install Non-GUI on 3TB+ Hard Drive**
1384
1385 *WARNING:* This workaround includes instructions which will delete all data from a hard drive.
1386
1387 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).
1388
1389 Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases.
1390
1391 Tested in snapshot on 8/14/2012.
1392
1393 ## Contribute
1394 **Port VirtualBox to DragonFly BSD**
1395
1396      - Build VirtualBox in FreeBSD
1397         - Install FreeBSD
1398         - Compile VirtualBox
1399         - Compile Guest Additions
1400      - Build VirtualBox in DragonFly BSD
1401         - Install DragonFly BSD (Xfce IMG/ISO Installer)
1402         - Compile VirtualBox
1403         - Install VirtualBox
1404         - Test VirtualBox
1405         - Compile Guest Additions
1406         - Install Guest Additions
1407         - Test Guest Additions
1408      - Package for DPorts
1409      - Upload to DPorts
1410
1411 **Update and Fix Bugs of Desktop Environments in DPorts**
1412
1413      - Install DragonFly BSD
1414      - Compile Updated Desktop Environments
1415      - Install Updated Desktop Environments
1416      - Test, Log Bugs, and Fix Bugs in Updated Desktop Environments
1417      - Package for DPorts
1418      - Upload to DPorts
1419
1420 **DragonFly BSD Network Shares Walkthrough**
1421
1422      - Install DragonFly BSD
1423      - Figure out network shares and write a walkthrough.