3fcb34fce2819cfba0aba1647de35f12a8c85eaf
[ikiwiki.git] / varialus / index.mdwn
1 # et
2 # Anisoptera
3 *The following is an unpaid personal wiki page about my experiences, issues, and workarounds related to DragonFly BSD.*
4
5 ## Table of Contents
6
7 1. **Featured**
8
9 * Walkthrough of DragonFly BSD Installation and Configuration
10 * (Not Yet Started) Walkthrough of Xfce Installation and Configuration
11 * (Not Yet Started) Walkthrough of Applications Installation and Configuration
12 * (Not Yet Started) Walkthrough of C and Go Development Environment Installation and Configuration
13
14 2. **Tidbits**
15
16 * Shell/Console/Command-Line-Prompt: tcsh/bash, ctrl-d/tab-tab, partial-previous-command-up-key/ctrl-r-partial-previous-command, rehash
17 * Package-Management: pkgin/apt-get
18 * Administration/root su/sudo/wheel
19 * Text-Editor: vi :q!
20 * Manual: man man
21 * Networking: hosts
22 * Power-Down: shutdown -p now
23 * File-System: Hammer
24 * Operating System: DragonFly BSD
25 * Graphical-User-Interface: Xfce
26 * Programming: Dissonance/Apache Harmony
27 * Programming: Jython/Python
28 * Text-Editor: ee/nano
29 * Networking: Debian resolv.conf
30
31 3. **Issues**
32
33 * Disclaimer
34 * Default GUI Too Bare
35 * Early Keyboard Selection
36 * GUI Keyboard Selection
37 * Encryption Keyboard Selection
38 * Disabled Caps Lock in GUI
39 * Random Key for Encrypted Swap
40 * Stay Decrypted for  Configuration
41 * No Confirmation for Decryption
42 * Plain Text Password in Install Log
43 * USB Installation Media Named Uniquely
44 * 3TB+ HD Install
45 * Overwrite 3TB+ Partition Table
46 * Lackluster Default Shell
47 * Wiki Centered Text
48 * XOrg Quit Errors
49
50 4. **Workarounds**
51
52 * Enable Caps Lock in GUI
53 * Install Non-GUI on 3TB+ Hard Drive
54 * Install Xfce 4.6 (Notes)
55 * Install Xfce 4.8 (Stub)
56 * Install Xfce 4.10 (Stub)
57 * Set GUI Keyboard Layout
58
59 5. **Contribute**
60
61 * Port VirtualBox to DragonFly BSD
62 * Port Xfce 4.10 to DragonFly BSD
63 * DragonFly BSD Network Shares Walkthrough
64 * Port bxpkg to DragonFly BSD
65
66 6. **Not Yet Formatted Text Dump**
67
68 * Project HAMMER Debian
69
70 ## Featured
71
72 **Walkthrough of DragonFly BSD Installation and Configuration**
73
74 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.
75
76 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
77
78 2. Set the the virtual hardware clock set to UTC time.
79
80 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.
81
82 4. Start the virtual machine. Before it finishes booting, the will be greeted with the following boot menu.
83
84         
85         DragonFly/i386 bootstrap loader, Revision 1.1
86         (justin@pkgbox64.dragonflybsd.org, Mon Jun 16 21:33:12 PDT 2014)
87                                                    |
88         1. Boot DragonFly [kernel]                 |   ,--,           |           ,--,
89         2. Boot DragonFly in Safe Mode             |   |   `-,       ,^,       ,-'   |
90         3. Boot DragonFly without AHCI driver      |    `,    `-,   (/ \)   ,-'    ,'
91         4. Boot DragonFly without ACPI driver      |      `-,    `-,/   \,-'    ,-'
92         9. Escape to loader prompt (also ESC)      |         `------(   )------'
93         r. Boot DragonFly to a rescue ramdisk      |     ,----------(   )----------,
94         s. Boot DragonFly in single user mode      |    |        _,-(   )-,_        |
95         v. Boot DragonFly with verbose logging     |     `-,__,-'   \   /   `-,__,-'
96         R. Reboot                                  |                 | |
97                                                    |                 | |
98                                                    |                 | |
99                                                    |                 | |
100                                                    |                 | |
101                                                    |                 | |
102                                                    |                 `|'
103                                                    |
104         Booting in 10 seconds... _
105
106 5. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
107
108         Welcome to DragonFly!
109         
110         To start the installer, login as 'installer'.  To just get a shell prompt,
111         login as 'root'.
112         
113         DragonFly/x86_64 (Amnesiac) (ttyv0)
114         
115         login: _
116
117 6. Type 'installer' without quotes and press enter.
118
119 7. The following menu will be displayed.
120
121         F10=Refresh Display                                                            .
122                                                                                        .
123                                                       ,--,           |           ,--,  .
124          ------------------------| Welcome to DragonFly BSD |------------------------- .
125         |                                                                             |.
126         | Welcome to the DragonFly BSD Live CD.                                       |.
127         |                                                                             |.
128         | DragonFly BSD is an efficient and elegant BSD Unix-derived operating        |.
129         | system.  For more information, see http://www.dragonflybsd.org              |.
130         |                                                                             |.
131         | From this CD, you can boot into DragonFly BSD ``live'' (without installing  |.
132         | it) to evaluate it, to install it manually, or to troubleshoot problems     |.
133         | with an existing installation, using either a command prompt or menu-driven |.
134         | utilities.                                                                  |.
135         |                                                                             |.
136         | Also, you can use this automated application to assist you in installing    |.
137         | DragonFly BSD on this computer and configuring it once it is installed.     |.
138         |                                                                             |.
139         |        < Install DragonFly BSD >_ < Configure an Installed System >         |.
140         |    < Live CD Utilities >  < Exit to Live CD >  < Reboot this Computer >     |.
141         |                     < Setup NetBoot Install Services >                      |.
142          ----------------------------------------------------------------------------- .
143                                                                                        .
144                                                                                        .
145         Install DragonFly BSD on a HDD or HDD partition on this computer               .
146
147 8. The bottom line changes depending on which option is selected.
148
149 9. Highlight the option < Install DragonFly BSD > and press enter.
150
151 10. The following menu will be displayed.
152
153         F10=Refresh Display                                                            .
154                                                                                        .
155                                                       ,--,           |           ,--,  .
156                                                       |   `-,       ,^,       ,-'   |  .
157                                                        `,    `-,   (/ \)   ,-'    ,'   .
158          --------------------------| Begin Installation |----------------------------- .
159         |                                                                             |.
160         | This application will install DragonFly BSD on one of the hard disk drives  |.
161         | attached to this computer. It has been designed to make it easy to install  |.
162         | DragonFly BSD in the typical case. If you have special requirements that    |.
163         | are not addressed by this installer, or if you have problems using it, you  |.
164         | are welcome to install DragonFly BSD manually. To do so select Exit to Live |.
165         | CD, login as root, and follow the instructions given in the file /README .  |.
166         |                                                                             |.
167         | NOTE! As with any installation process, YOU ARE STRONGLY ENCOURAGED TO BACK |.
168         | UP ANY IMPORTANT DATA ON THIS COMPUTER BEFORE PROCEEDING!                   |.
169         |                                                                             |.
170         | < Install DragonFly BSD >_ < Return to Welcome Menu >  < Exit to Live CD >  |.
171          ----------------------------| Press F1 for Help |---------------------------- .
172                                                                                        .
173                                                                                        .
174                                                                                        .
175                                                                                        .
176                                                                                        .
177                                                                                        .
178                                                                                        .
179
180 11. Highlight the option < Install DragonFly BSD > and press enter.
181
182 12. The following menu, specific to your hardware, will be displayed.
183
184         F10=Refresh Display                                                            .
185                                                                                        .
186                                                       ,--,           |           ,--,  .
187                                                       |   `-,       ,^,       ,-'   |  .
188                                                        `,    `-,   (/ \)   ,-'    ,'   .
189                                                          `-,    `-,/   \,-'    ,-'     .
190                                                             `------(   )------'        .
191                                                         ,----------(   )----------,    .
192                                                        |        _,-(   )-,_        |   .
193                  -----------------------| Select Disk |----------------------- _,-'    .
194                 |                                                             |        .
195                 | Select a disk on which to install DragonFly BSD             |        .
196                 |                                                             |        .
197                 | < ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33 >_|        .
198                 | < Return to Begin Installation >                            |        .
199                  -------------------------------------------------------------         .
200                                                                     `|'                .
201                                                                                        .
202                                                                                        .
203                                                                                        .
204                                                                                        .
205                                                                                        .
206                                                                                        .
207                                                                                        .
208                                                                                        .
209
210 13. Highlight the disk on which to install DragonFly BSD and press Enter.
211
212 14. The following menu will be displayed.
213
214         F10=Refresh Display                                                            .
215                                                                                        .
216                                                       ,--,           |           ,--,  .
217                                                       |   `-,       ,^,       ,-'   |  .
218                                                        `,    `-,   (/ \)   ,-'    ,'   .
219                                                          `-,    `-,/   \,-'    ,-'     .
220                                                             `------(   )------'        .
221                                                         ,----------(   )----------,    .
222                ------------------------| How Much Disk? |------------------------  |   .
223               |                                                                  |'    .
224               | Select how much of this disk you want to use for DragonFly BSD.  |     .
225               |                                                                  |     .
226               | ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33          |     .
227               |                                                                  |     .
228               |            < Use Entire Disk >_ < Use Part of Disk >             |     .
229               |                    < Return to Select Disk >                     |     .
230                ------------------------------------------------------------------      .
231                                                                                        .
232                                                                                        .
233                                                                                        .
234                                                                                        .
235                                                                                        .
236                                                                                        .
237                                                                                        .
238                                                                                        .
239
240 15. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter.
241
242 16. The following menu will be displayed.
243
244         F10=Refresh Display                                                            .
245                                                                                        .
246                                                       ,--,           |           ,--,  .
247                                                       |   `-,       ,^,       ,-'   |  .
248                             ------| Are you absolutely sure? |------  \)   ,-'    ,'   .
249                            |                                        |  \,-'    ,-'     .
250                            | WARNING! ALL data in ALL partitions on |  )------'        .
251                            | the disk                               |  )----------,    .
252                            |                                        |  )-,_        |   .
253                            | ad0: 131072MB <VBOX HARDDISK 1.0> at   |  /   `-,__,-'    .
254                            | ata0-master UDMA33                     | |                .
255                            |                                        | |                .
256                            | will be IRREVOCABLY ERASED!            | |                .
257                            |                                        | |                .
258                            | Are you ABSOLUTELY SURE you wish to    | |                .
259                            | take this action? This is your LAST    | |                .
260                            | CHANCE to cancel!                      ||'                .
261                            |                                        |                  .
262                            |           < OK >_ < Cancel >           |                  .
263                             ----------------------------------------                   .
264                                                                                        .
265                                                                                        .
266                                                                                        .
267                                                                                        .
268                                                                                        .
269
270 17. If you are absolutely sure, highlight < OK > and press enter.
271
272 18. The following menu will be displayed.
273
274         F10=Refresh Display                                                            .
275                                                                                        .
276                                                       ,--,           |           ,--,  .
277                                                       |   `-,       ,^,       ,-'   |  .
278                                                        `,    `-,   (/ \)   ,-'    ,'   .
279                                                          `-,    `-,/   \,-'    ,-'     .
280                                                             `------(   )------'        .
281                              -----------| Information |------------    )----------,    .
282                             |                                      |   )-,_        |   .
283                             | The disk                             |   /   `-,__,-'    .
284                             |                                      || |                .
285                             | ad0: 131072MB <VBOX HARDDISK 1.0> at || |                .
286                             | ata0-master UDMA33                   || |                .
287                             |                                      || |                .
288                             | was formatted.                       || |                .
289                             |                                      || |                .
290                             |                < OK >                |`|'                .
291                              --------------------------------------                    .
292                                                                                        .
293                                                                                        .
294                                                                                        .
295                                                                                        .
296                                                                                        .
297                                                                                        .
298                                                                                        .
299
300 19. Press enter.
301
302 20. The following menu will be displayed.
303
304         F10=Refresh Display                                                            .
305                                                                                        .
306                                                       ,--,           |           ,--,  .
307                                                       |   `-,       ,^,       ,-'   |  .
308                                                        `,    `-,   (/ \)   ,-'    ,'   .
309                                                          `-,    `-,/   \,-'    ,-'     .
310                                                             `------(   )------'        .
311                    -----------------| Select file system |------------------ -----,    .
312                   |                                                         |      |   .
313                   | Please select the file system you want to use with      |,__,-'    .
314                   | DragonFly BSD.                                          |          .
315                   |                                                         |          .
316                   | HAMMER is the new DragonFly BSD file system. UFS is the |          .
317                   | traditional BSD file system.                            |          .
318                   |                                                         |          .
319                   | < Use HAMMER >_ < Use UFS >  < Return to Select Disk >  |          .
320                    ---------------------------------------------------------           .
321                                                                                        .
322                                                                                        .
323                                                                                        .
324                                                                                        .
325                                                                                        .
326                                                                                        .
327                                                                                        .
328                                                                                        .
329
330 21. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter.
331
332 22. The following menu will be displayed.
333
334         F10=Refresh Display                                                            .
335                                                                                        .
336                                                       ,--,           |           ,--,  .
337                --------------------| Create Subpartitions |---------------------    |  .
338               |                                                                 | ,'   .
339               | Set up the partitions (also knows as just `partitions' in       |'     .
340               | BSD tradition) you want to have on this primary partition. In   |      .
341               | most cases you should be fine with the default settings.        |-,    .
342               |                                                                 |  |   .
343               | For Capacity, use 'M' to indicate megabytes, 'G' to indicate    |-'    .
344               | gigabytes, and so on (up to 'E'.) A single '*' indicates 'use   |      .
345               | the remaining space on the primary partition'.                  |      .
346               |                                                                 |      .
347               | Mountpoint  Capacity  Encrypted                                 |      .
348               | [/boot_   ] [768M   ] [ ]     < Ins > < Del >                   |      .
349               | [swap     ] [8192M  ] [ ]     < Ins > < Del >                   |      .
350               | [/        ] [*      ] [ ]     < Ins > < Del >                   |      .
351               |                               < Add >                           |      .
352               |                                                                 |      .
353               |     < Accept and Create >  < Return to Select Disk >            |      .
354                -------------------| Press F1 for Help |-------------------------       .
355                                                                                        .
356                                                                                        .
357                                                                                        .
358                                                                                        .
359
360 23. Highlight < Accept and Create > and press enter.
361
362 24. The following menu will be displayed.
363
364         F10=Refresh Display                                                            .
365                                                                                        .
366                                                       ,--,           |           ,--,  .
367                                                       |   `-,       ,^,       ,-'   |  .
368                                                        `,    `-,   (/ \)   ,-'    ,'   .
369                                                          `-,    `-,/   \,-'    ,-'     .
370                -------------------------| Install OS |--------------------------       .
371               |                                                                 |-,    .
372               | Everything is now ready to install the actual files which       |  |   .
373               | comprise the DragonFly BSD operating system on the selected     |-'    .
374               | partition of the selected disk.                                 |      .
375               |                                                                 |      .
376               | Note that this process will take quite a while to finish. You   |      .
377               | may wish to take a break now and come back to the computer in a |      .
378               | short while.                                                    |      .
379               |                                                                 |      .
380               | < Begin Installing Files >_ < Return to Create Subpartitions >  |      .
381                -----------------------------------------------------------------       .
382                                                                                        .
383                                                                                        .
384                                                                                        .
385                                                                                        .
386                                                                                        .
387                                                                                        .
388                                                                                        .
389                                                                                        .
390
391 25. Highlight < Begin Installing Files > and press enter.
392
393 26. The following progress bar will be displayed.
394
395         F10=Refresh Display                                                            .
396                                                                                        .
397                                                       ,--,           |           ,--,  .
398                                                       |   `-,       ,^,       ,-'   |  .
399                                                        `,    `-,   (/ \)   ,-'    ,'   .
400                                                          `-,    `-,/   \,-'    ,-'     .
401                                                             `------(   )------'        .
402                                                         ,----------(   )----------,    .
403                   -------------------| Executing Commands |-------------------     |   .
404                  |                                                            |_,-'    .
405                  | /bin/cpdup -o -vvv -u /usr/share /mnt/usr/share            |        .
406                  |                                                            |        .
407                  |          [*#################65%###              ]          |        .
408                  |                                                            |        .
409                  |                         < Cancel >_                        |        .
410                   ------------------------------------------------------------         .
411                                                                     `|'                .
412                                                                                        .
413                                                                                        .
414                                                                                        .
415                                                                                        .
416                                                                                        .
417                                                                                        .
418                                                                                        .
419                                                                                        .
420
421 27. When it finishes, the following menu will be displayed.
422
423         F10=Refresh Display                                                            .
424                                                                                        .
425                                                       ,--,           |           ,--,  .
426                                                       |   `-,       ,^,       ,-'   |  .
427                     ---------------| Install Bootblock(s) |----------------,-'    ,'   .
428                    |                                                       |   ,-'     .
429                    | You may now wish to install bootblocks on one or more |--'        .
430                    | disks. If you already have a boot manager installed,  |------,    .
431                    | you can skip this step (but you may have to configure |       |   .
432                    | your boot manager separately.)  If you installed      |-,__,-'    .
433                    | DragonFly BSD on a disk other than your first disk,   |           .
434                    | you will need to put the bootblock on at least your   |           .
435                    | first disk and the DragonFly BSD disk.                |           .
436                    |                                                       |           .
437                    | Disk Drive  Install Bootblock?  Packet Mode?          |           .
438                    | [ad0_     ] [X]                 [X]                   |           .
439                    |                                                       |           .
440                    |           < Accept and Install Bootblocks >           |           .
441                    |                  < Skip this Step >                   |           .
442                     -----------------| Press F1 for Help |-----------------            .
443                                                                                        .
444                                                                                        .
445                                                                                        .
446                                                                                        .
447         The disk on which you wish to install a bootblock                              .
448
449 28. Highlight < Accept and Install Bootblocks > and press enter.
450
451 29. The following dialog box will be displayed.
452
453         F10=Refresh Display                                                            .
454                                                                                        .
455                                                       ,--,           |           ,--,  .
456                                                       |   `-,       ,^,       ,-'   |  .
457                                                        `,    `-,   (/ \)   ,-'    ,'   .
458                                                          `-,    `-,/   \,-'    ,-'     .
459                                                             `------(   )------'        .
460                                                         ,----------(   )----------,    .
461                                                        |        _,-(   )-,_        |   .
462                            -------------| Information |-------------   /   `-,__,-'    .
463                           |                                         | |                .
464                           | Bootblocks were successfully installed! | |                .
465                           |                                         | |                .
466                           |                 < OK >                  | |                .
467                            -----------------------------------------  |                .
468                                                                     | |                .
469                                                                     `|'                .
470                                                                                        .
471                                                                                        .
472                                                                                        .
473                                                                                        .
474                                                                                        .
475                                                                                        .
476                                                                                        .
477                                                                                        .
478
479 30. Press enter.
480
481 31. The following menu will be displayed.
482
483         F10=Refresh Display                                                            .
484                                                                                        .
485                                                       ,--,           |           ,--,  .
486                                                       |   `-,       ,^,       ,-'   |  .
487                                                        `,    `-,   (/ \)   ,-'    ,'   .
488                                                          `-,    `-,/   \,-'    ,-'     .
489                -----------------| DragonFly BSD is Installed! |-----------------       .
490               |                                                                 |-,    .
491               | Congratulations!                                                |  |   .
492               |                                                                 |-'    .
493               | DragonFly BSD has successfully been installed on this computer. |      .
494               | You may now proceed to configure the installation. Alternately, |      .
495               | you may wish to reboot the computer and boot into the installed |      .
496               | system to confirm that it works.                                |      .
497               |                                                                 |      .
498               |              < Configure this System >_ < Reboot >              |      .
499               |                   < Return to Welcome Menu >                    |      .
500                -----------------------------------------------------------------       .
501
502 32. Highlight < Configure this System > and press enter.
503
504 33. The following menu will be displayed.
505
506         F10=Refresh Display                                                            .
507                                                                                        .
508                                                       ,--,           |           ,--,  .
509                             ---| Configure an Installed System |---- ^,       ,-'   |  .
510                            |                                        | \)   ,-'    ,'   .
511                            | The options on this menu allow you to  |  \,-'    ,-'     .
512                            | configure a DragonFly BSD system after |  )------'        .
513                            | it has already been installed.         |  )----------,    .
514                            |                                        |  )-,_        |   .
515                            | < Select timezone >_                   |  /   `-,__,-'    .
516                            | < Set date and time >                  | |                .
517                            | < Set keyboard map >                   | |                .
518                            | < Set root password >                  | |                .
519                            | < Add a user >                         | |                .
520                            | < Configure network interfaces >       | |                .
521                            | < Configure hostname and domain >      | |                .
522                            | < Set console font >                   ||'                .
523                            | < Set screen map >                     |                  .
524                            | < Remove software packages >           |                  .
525                            | < Return to Welcome Menu >             |                  .
526                             ----------------------------------------                   .
527                                                                                        .
528                                                                                        .
529                                                                                        .
530 Set the Time Zone of your physical location                                            .
531
532 34. Highlight < Select timezone > and press enter.
533
534 35. The following menu will be displayed.
535
536         F10=Refresh Display                                                            .
537                                                                                        .
538                                                       ,--,           |           ,--,  .
539                                                       |   `-,       ,^,       ,-'   |  .
540                                                        `,    `-,   (/ \)   ,-'    ,'   .
541                                                          `-,    `-,/   \,-'    ,-'     .
542                                                             `------(   )------'        .
543                                                         ,----------(   )----------,    .
544                           | Local or UTC (Greenwich Mean Time) clock | )-,_        |   .
545                          |                                            |/   `-,__,-'    .
546                          | Is this machine's CMOS clock set to        |                .
547                          | UTC?                                       |                .
548                          |                                            |                .
549                          | If it is set to local time, or you         |                .
550                          | don't know, please choose NO here!         |                .
551                          |                                            |                .
552                          |              < Yes >_ < No >               |                .
553                           --------------------------------------------                 .
554                                                                                        .
555                                                                                        .
556                                                                                        .
557                                                                                        .
558                                                                                        .
559                                                                                        .
560                                                                                        .
561
562 36. Highlight < Yes > and press enter.
563
564 37. The following menu will be displayed.
565
566         F10=Refresh Display ----------| Select Time Zone |----------                   .
567                            |                                        #                  .
568                            | Select a Time Zone appropriate to your #|           ,--,  .
569                            | physical location.                     #^,       ,-'   |  .
570                            |                                        # \)   ,-'    ,'   .
571                            | < Africa >_                            #  \,-'    ,-'     .
572                            | < America >                            #  )------'        .
573                            | < Antarctica >                         #  )----------,    .
574                            | < Arctic >                             #  )-,_        |   .
575                            | < Asia >                               #  /   `-,__,-'    .
576                            | < Atlantic >                           # |                .
577                            | < Australia >                          # |                .
578                            | < CET >                                # |                .
579                            | < CST6CDT >                            # |                .
580                            | < EET >                                # |                .
581                            | < EST >                                # |                .
582                            | < EST5EDT >                            #|'                .
583                            | < Etc >                                #                  .
584                            | < Europe >                             *                  .
585                            | < GMT >                                *                  .
586                            | < HST >                                *                  .
587                            | < Indian >                             *                  .
588                            | < MET >                                *                  .
589                            | < MST >                                *                  .
590                             ----------------------------------------                   .
591
592 38. Highlight < GMT > and press enter.
593
594 39. The following dialog box will be displayed.
595
596         F10=Refresh Display                                                            .
597                                                                                        .
598                                                       ,--,           |           ,--,  .
599                                                       |   `-,       ,^,       ,-'   |  .
600                                                        `,    `-,   (/ \)   ,-'    ,'   .
601                                                          `-,    `-,/   \,-'    ,-'     .
602                                                             `------(   )------'        .
603                                                         ,----------(   )----------,    .
604                                                        |        _,-(   )-,_        |   .
605                                 --------| Information |--------    \   /   `-,__,-'    .
606                                |                               |    | |                .
607                                | The Time Zone has been set to |    | |                .
608                                | /mnt/usr/share/zoneinfo/GMT.  |    | |                .
609                                |                               |    | |                .
610                                |            < OK >_            |    | |                .
611                                 -------------------------------     | |                .
612                                                                     `|'                .
613                                                                                        .
614                                                                                        .
615                                                                                        .
616                                                                                        .
617                                                                                        .
618                                                                                        .
619                                                                                        .
620                                                                                        .
621
622 40. Press enter.
623
624 41. The menu from step 33 will be displayed.
625
626 42. Highlight  < Set keyboard map > and press enter.
627
628 43. The following menu will be displayed.
629
630         F10=Refresh Display  -------| Select Keyboard Map |--------                    .
631                             |                                      #                   .
632                             | Select a keyboard map appropriate to # |           ,--,  .
633                             | your keyboard layout.                #,^,       ,-'   |  .
634                             |                                      #/ \)   ,-'    ,'   .
635                             | < be.iso.acc.kbd >_                  #   \,-'    ,-'     .
636                             | < be.iso.kbd >                       #   )------'        .
637                             | < bg.bds.ctrlcaps.kbd >              *   )----------,    .
638                             | < bg.phonetic.ctrlcaps.kbd >         *   )-,_        |   .
639                             | < br275.cp850.kbd >                  *   /   `-,__,-'    .
640                             | < br275.iso.acc.kbd >                *| |                .
641                             | < br275.iso.kbd >                    *| |                .
642                             | < by.cp1131.kbd >                    *| |                .
643                             | < by.cp1251.kbd >                    *| |                .
644                             | < by.iso5.kbd >                      *| |                .
645                             | < ce.iso2.kbd >                      *| |                .
646                             | < colemak.iso15.acc.kbd >            *'|'                .
647                             | < cs.latin2.qwertz.kbd >             *                   .
648                             | < cz.iso2.kbd >                      *                   .
649                             | < danish.cp865.kbd >                 *                   .
650                             | < danish.iso.kbd >                   *                   .
651                             | < el.iso07.kbd >                     *                   .
652                             | < estonian.cp850.kbd >               *                   .
653                             | < estonian.iso.kbd >                 *                   .
654                              --------------------------------------                    .
655
656 44. Highlight < us.dvorak.kbd > and press enter.
657
658 45. The menu from step 33 will be displayed.
659
660 46. Highlight < Add a user > and press enter.
661
662 47. The following menu will be displayed.
663
664         F10=Refresh D -------------------| Add user |--------------------              .
665                      |                                                   |             .
666                      | Here you can add a user to an installed system.   |       ,--,  .
667                      |                                                   |    ,-'   |  .
668                      | You can leave the Home Directory, User ID, and    | ,-'    ,'   .
669                      | Login Group fields empty if you want these items  |'    ,-'     .
670                      | to be automatically allocated by the system.      |----'        .
671                      |                                                   |--------,    .
672                      | Note: this user's password will appear in the     |_        |   .
673                      | install log. If this is a problem, please add the | `-,__,-'    .
674                      | user manually after rebooting into the installed  |             .
675                      | system instead.                                   |             .
676                      |                                                   |             .
677                      | Username                 [_                 ]     |             .
678                      | Real Name                [                  ]     |             .
679                      | Password                 [                  ]     |             .
680                      | Password (Again)         [                  ]     |             .
681                      | Shell                    [/bin/tcsh         ]     |             .
682                      | Home Directory           [                  ]     |             .
683                      | User ID                  [                  ]     |             .
684                      | Login Group              [                  ]     |             .
685                      | Other Group Memberships  [                  ]     |             .
686                      |                                                   |             .
687                      | < Accept and Add >  < Return to Configure Menu >  |             .
688         Enter the use ---------------------------------------------------              .
689
690 48. In the following fields type the following values without quotes and then highlight <Accept and Add > and press enter.
691
692 * Username: 'user'
693 * Real Name: 'User'
694 * Password: 'ChangeMe'
695 * Password (Again): 'ChangeMe'
696
697 49. The following dialog box will be displayed.
698
699         F10=Refresh Display                                                            .
700                                                                                        .
701                                                       ,--,           |           ,--,  .
702                                                       |   `-,       ,^,       ,-'   |  .
703                                                        `,    `-,   (/ \)   ,-'    ,'   .
704                                                          `-,    `-,/   \,-'    ,-'     .
705                                                             `------(   )------'        .
706                                                         ,----------(   )----------,    .
707                                                        |        _,-(   )-,_        |   .
708                                    -----| Information |----  ,-'   \   /   `-,__,-'    .
709                                   |                        |        | |                .
710                                   | User `user' was added. |        | |                .
711                                   |                        |        | |                .
712                                   |         < OK >_        |        | |                .
713                                    ------------------------         | |                .
714                                                                     | |                .
715                                                                     `|'                .
716                                                                                        .
717                                                                                        .
718                                                                                        .
719                                                                                        .
720                                                                                        .
721                                                                                        .
722                                                                                        .
723                                                                                        .
724
725 50. Press enter.
726
727 51. The menu from step 33 will be displayed.
728
729 52. Highlight < Set root password > and press enter.
730
731 53. The following menu will be displayed.
732
733         F10=Refresh Display                                                            .
734                                                                                        .
735                                                       ,--,           |           ,--,  .
736                                                       |   `-,       ,^,       ,-'   |  .
737                                                        `,    `-,   (/ \)   ,-'    ,'   .
738                   -------------------| Set Root Password |-------------------  ,-'     .
739                  |                                                           |'        .
740                  | Here you can set the super-user (root) password.          |----,    .
741                  |                                                           |     |   .
742                  | Note: root's new password will appear in the install log. |__,-'    .
743                  | If this is a problem, please set root's password manually |         .
744                  | after rebooting into the installed system instead.        |         .
745                  |                                                           |         .
746                  | Root password        [_                 ]                 |         .
747                  | Root password again  [                  ]                 |         .
748                  |                                                           |         .
749                  |                < Accept and Set Password >                |         .
750                  |               < Return to Configure Menu >                |         .
751                   -----------------------------------------------------------          .
752                                                                                        .
753                                                                                        .
754                                                                                        .
755                                                                                        .
756                                                                                        .
757                                                                                        .
758         Enter the root password you would like to use                                  .
759
760 54. In the following fields type the following values without quotes and then highlight <Accept and Set Password > and press enter.
761
762 * Root password: 'ChangeMe'
763 * Root password again: 'ChangeMe'
764
765 55. The following dialog box will be displayed.
766
767         F10=Refresh Display                                                            .
768                                                                                        .
769                                                       ,--,           |           ,--,  .
770                                                       |   `-,       ,^,       ,-'   |  .
771                                                        `,    `-,   (/ \)   ,-'    ,'   .
772                                                          `-,    `-,/   \,-'    ,-'     .
773                                                             `------(   )------'        .
774                                                         ,----------(   )----------,    .
775                                                        |        _,-(   )-,_        |   .
776                             ------------| Information |----------- \   /   `-,__,-'    .
777                            |                                      | | |                .
778                            | User root password has been changed. | | |                .
779                            |                                      | | |                .
780                            |                < OK >_               | | |                .
781                             --------------------------------------  | |                .
782                                                                     | |                .
783                                                                     `|'                .
784                                                                                        .
785                                                                                        .
786                                                                                        .
787                                                                                        .
788                                                                                        .
789                                                                                        .
790                                                                                        .
791                                                                                        .
792
793 56. Press enter.
794
795 57. The menu from step 33 will be displayed.
796
797 58. Highlight < Configure network interfaces > and press enter.
798
799 59. The following menu will be displayed.
800
801         F10=Refresh Display                                                            .
802                                                                                        .
803                                                       ,--,           |           ,--,  .
804                                                       |   `-,       ,^,       ,-'   |  .
805                                                        `,    `-,   (/ \)   ,-'    ,'   .
806                                                          `-,    `-,/   \,-'    ,-'     .
807                            ----------| Assign IP Address |----------   )------'        .
808                           |                                         |  )----------,    .
809                           | Please select which interface you would |  )-,_        |   .
810                           | like to configure:                      |  /   `-,__,-'    .
811                           |                                         | |                .
812                           | < em0 >_                                | |                .
813                           | < faith0 >                              | |                .
814                           | < lo0 >                                 | |                .
815                           | < ppp0 >                                | |                .
816                           | < sl0 >                                 | |                .
817                           | < Cancel >                              ||'                .
818                            -----------------------------------------                   .
819                                                                                        .
820                                                                                        .
821                                                                                        .
822                                                                                        .
823                                                                                        .
824                                                                                        .
825                                                                                        .
826
827 60. Highlight < em0 > and press enter.
828
829 61. The following menu will be displayed.
830
831         F10=Refresh Display                                                            .
832                                                                                        .
833                                                       ,--,           |           ,--,  .
834                                                       |   `-,       ,^,       ,-'   |  .
835                                                        `,    `-,   (/ \)   ,-'    ,'   .
836                                                          `-,    `-,/   \,-'    ,-'     .
837                                                             `------(   )------'        .
838                            --------------| Use DHCP? |--------------   )----------,    .
839                           |                                         |  )-,_        |   .
840                           | DHCP allows the interface to            |  /   `-,__,-'    .
841                           | automatically obtain an IP address from | |                .
842                           | a nearby DHCP server.                   | |                .
843                           |                                         | |                .
844                           | Would you like to enable DHCP for em0?  | |                .
845                           |                                         | |                .
846                           |  < Use DHCP >_ < Configure Manually >   | |                .
847                            ----------------------------------------- |'                .
848                                                                                        .
849                                                                                        .
850                                                                                        .
851                                                                                        .
852                                                                                        .
853                                                                                        .
854                                                                                        .
855                                                                                        .
856
857 62. Highlight < Use DHCP > and press enter.
858
859 63. The following menu, specific to your hardware and network connection, will be displayed.
860
861         F10=Refresh Display                                                            .
862                                                                                        .
863                                                       ,--,           |           ,--,  .
864                            -------------| Information |------------- ^,       ,-'   |  .
865                           |                                         | \)   ,-'    ,'   .
866                           | em0:                                    |  \,-'    ,-'     .
867                           | flags=8843<UP,BROADCAST,RUNNING,SIMPLEX |  )------'        .
868                           | MULTICAST> mtu 1500                     |  )----------,    .
869                           | options=1b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_ |  )-,_        |   .
870                           | WTAGGING>                               |  /   `-,__,-'    .
871                           | inet6 fe80::a00:27ff:fe98:67cc%em0      | |                .
872                           | prefixlen 64 scopeid 0x1                | |                .
873                           | inet 10.0.2.15 netmask 0xffffff00       | |                .
874                           | broadcast 10.0.2.255                    | |                .
875                           | ether 08:00:27:98:67:cc                 | |                .
876                           | media: Ethernet autoselect (1000baseT   | |                .
877                           | <full-duplex>)                          ||'                .
878                           | status: active                          |                  .
879                           |                                         |                  .
880                           |                                         |                  .
881                           |                 < OK >_                 |                  .
882                            -----------------------------------------                   .
883                                                                                        .
884                                                                                        .
885                                                                                        .
886
887 64. Press enter.
888
889 65. The menu from step 33 will be displayed.
890
891 66. Highlight < Configure hostname and domain > and press enter.
892
893 67. The following menu will be displayed.
894
895         F10=Refresh Display                                                            .
896                                                                                        .
897                                                       ,--,           |           ,--,  .
898                                                       |   `-,       ,^,       ,-'   |  .
899                                                        `,    `-,   (/ \)   ,-'    ,'   .
900                                                          `-,    `-,/   \,-'    ,-'     .
901                                                             `------(   )------'        .
902                              -------| Set Hostname/Domain |--------    )----------,    .
903                             |                                      |   )-,_        |   .
904                             | Please enter this machine's hostname |   /   `-,__,-'    .
905                             | and domain name.                     || |                .
906                             |                                      || |                .
907                             | Hostname  [_                 ]       || |                .
908                             | Domain    [                  ]       || |                .
909                             |                                      || |                .
910                             |                                      || |                .
911                             |          < OK >  < Cancel >          |`|'                .
912                              --------------------------------------                    .
913                                                                                        .
914                                                                                        .
915                                                                                        .
916                                                                                        .
917                                                                                        .
918                                                                                        .
919         Enter the Hostname (e.g. `machine')                                            .
920
921 68. In the following fields type the following values without quotes and then highlight <OK > and press enter.
922
923 * Hostname: 'dfly'
924 * Domain: 'localhost'
925
926 69. The menu from step 33 will be displayed.
927
928 70. Highlight < Return to Welcome Menu > and press enter.
929
930 71. The menu from step 7 will be displayed.
931
932 72. Highlight < Reboot this Computer > and press enter.
933
934 73. The following menu will be displayed.
935
936         F10=Refresh Display                                                            .
937                                                                                        .
938                                                       ,--,           |           ,--,  .
939                                                       |   `-,       ,^,       ,-'   |  .
940                                                        `,    `-,   (/ \)   ,-'    ,'   .
941                                                          `-,    `-,/   \,-'    ,-'     .
942                                                             `------(   )------'        .
943                             ---------------| Reboot |---------------   )----------,    .
944                            |                                        |  )-,_        |   .
945                            | This machine is about to be shut down. |  /   `-,__,-'    .
946                            | After the machine has reached its      | |                .
947                            | shutdown state, you may remove the CD  | |                .
948                            | from the CD-ROM drive tray and press   | |                .
949                            | Enter to reboot from the HDD.          | |                .
950                            |                                        | |                .
951                            |               < Reboot >               | |                .
952                            |       < Return to Welcome Menu >       ||'                .
953                             ----------------------------------------                   .
954                                                                                        .
955                                                                                        .
956                                                                                        .
957                                                                                        .
958                                                                                        .
959                                                                                        .
960                                                                                        .
961
962 74. Highlight < Reboot > and press enter.
963
964 75. The following message will be displayed.
965
966         The operating system has halted.
967         Please press any key to reboot.
968
969 76. Remove the virtual CD installation media from the virtual machine.
970
971 77. Press any key to reboot. Before it finishes booting, the will be greeted with the menu from step 4.
972
973 78. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
974
975         DragonFly/x86_64 (dfly.localhost) (ttyv0)
976         
977         login: _
978
979 79. Log in as root.
980
981 80. You will be greeted with the following message and shell prompt.
982
983         Copyright (c) 2003-2014 The DragonFly Project.                              .
984         Copyright (c) 1992-2003 The FreeBSD Project.                                .
985         Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994    .
986                 The Regents of the University of California. All rights reserved.   .
987                                                                                     .
988         DragonFly v3.8.1-RELEASE (X86_64_GENERIC) #16 Mon Jun 16 21:36:15 PDT 2014  .
989                                                                                     .
990         Welcome to DragonFly!                                                       .
991                                                                                     .
992         dfly# _                                                                     .
993
994 81. Type 'passwd' without quotes and press enter.
995
996 82. Type in a new root password and press enter and then retype the new root password and press enter again.
997
998 83. Type 'ee /etc/hosts' without quotes and press enter.
999
1000 84. Without quotes twice replace 'localhost.my.domain' with 'dfly.localhost'.
1001
1002 85. Press Ctrl-[, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter.
1003
1004 86. Type 'exit' without quotes and press enter.
1005
1006 87. Log in as user.
1007
1008 88. You will be greeted with the following message and shell prompt.
1009
1010         Copyright (c) 2003-2014 The DragonFly Project.                                 .
1011         Copyright (c) 1992-2003 The FreeBSD Project.                                   .
1012         Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994       .
1013                 The Regents of the University of California. All rights reserved.      .
1014                                                                                        .
1015         DragonFly v3.8.1-RELEASE (X86_64_GENERIC) #16 Mon Jun 16 21:36:15 PDT 2014     .
1016                                                                                        .
1017         Welcome to DragonFly!                                                          .
1018                                                                                        .
1019         Man pages are divided into section depending on topic.  There are 9 different  .
1020         sections numbered from 1 (General Commands) to 9 (Kernel Developer's Manual).  .
1021         You can get an introduction to each topic by typing                            .
1022                                                                                        .
1023                 man <number> intro                                                     .
1024                                                                                        .
1025         In other words, to get the intro to general commands, type                     .
1026                                                                                        .
1027                 man 1 intro                                                            .
1028         > _                                                                            .
1029
1030 89. Type 'passwd' without quotes and press enter.
1031
1032 90. 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.
1033
1034 91. Type 'exit' without quotes and press enter.
1035
1036 ## Tidbits
1037 * 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.
1038 * **pkgin** is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities. Regular programs installed via pkgin are generally located in /usr/pkg/bin.
1039 * Like Debian, DragonFly BSD is configured by default to use su by default rather sudo, which is the default in Ubuntu. Running su changes the user you are logged in within a single shell instance whereas sudo lets you run a single command as another user. Both programs default to changing the user to root user. To enable your regular user to use su to become root, as root run nano /etc/groups and then change the line wheel:*:0:root to wheel:*:root,yourusername except of course replace rourusername with your user name. Running su - will change the shell environment variables to that of the user to which you're changing.
1040 * 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! and then press enter.
1041 * 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.
1042 * When your computer contacts another computer over the Internet, it converts server's name, such as example.com, to numbered address. The server's name is called a domain name and the numbered address is called an IP address, short for Internet protocol address. To find out which domain name goes with which IP address, you computer usually contacts a special server called a DNS server, DNS being an abbreviation of domain name system. DNS generally works pretty well automatically, but when it causes a problem, it can be very frustrating. As of DragonFly BSD 3.0.3, there's a non-critical DNS configuration setting that the DragonFly BSD installer doesn't set. The file /etc/hosts is a text file that can override DNS name-address bindings. The IP addresses 127.0.0.1 and ::1 always point to one's own computer, so your computer's domain name should always point to these two addresses. This is the setting that currently doesn't get set automatically. You can see or set your host name within the file /etc/rc.conf on a line by itself in the following format.
1043
1044         hostname="computername.localnetworkname"
1045
1046     And with that name, you can update your /etc/hosts file with your computer's domain name by editing it to contain the following lines.
1047
1048         ::1 localhost computername.localnetworkname
1049         127.0.0.1 localhost computername.localnetworkname
1050
1051 * In 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.
1052 * **Hammer** is hands down the best file system currently in existence. It has block level deduplication, it is supported out of the box by operating system with great underpinnings, and it runs great on regular hardware.
1053 * **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.
1054 * **[Xfce](http://xfce.org/)** is a lightweight yet feature rich desktop environment. It has maintains an excellent balance between [innovation and compatibility](http://lwn.net/Articles/430598/).
1055 * **[Dissonance](https://github.com/varialus/dissonance)** is my fork of Apache Harmony, which is a clean room implementation of Java with a permissive license. Sun and now Oracle refuse to license the TCK, a tool used to validate Java compatibility, for use with Harmony. As a result of the dissonance caused by this refusal to cooperate with the community, Apache retired Harmony and resigned from the Java Community Process Executive Committee. I would have preferred for Apache and the community to have instead just written their own TCK, but I don't know what effects the dissonance had on their organization and it was their decision to make, so I can't blame them. It's unfortunate that such a great project has been effectively abandoned, and so it it is with that in mind that I call on the community to support Dissonance; make your own TCK and make it so much better so as to make passing Oracle's TCK effectively meaningless.
1056 * **[Jython](http://www.jython.org/)** is Python written in Java. It's not included in DragonFly BSD by default, but it's a great tool and I use it.
1057 * **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-[ and selecting 'a) leave editor'.
1058 * If NetworkManager Applet is installed, use it to override an unreliable DNS server rather than editing /etc/resolv.conf directly. Observed in NetworkManager 0.8.1 on Debian Squeeze. (This seems to not always work, particularly the first time you connect and perhaps after idling for a certain amount of time. I haven't narrowed down the exact cause.)
1059
1060 ## Issues
1061 * Varialus should ensure that these issues are properly logged. Yes, I know that they should be properly logged and I intend to eventually get them all logged. In the mean time hopefully my notes will help someone still trying to find the answers to life's persistent questions.
1062 * The installer should offer the Xfce desktop environment as a supported option. Observed in DragonFly 3.0.2. See workaround below.
1063 * The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.0.2.
1064 * The installer should set the keyboard layout for the GUI. Observed in DragonFly 3.0.2. See workaround below.
1065 * The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2.
1066 * The installer should configure the keyboard within the GUI to be able to use the caps lock key. Observed in DragonFly 3.0.2. See workaround below.
1067 * 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.
1068 * 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.
1069 * 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.
1070 * 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.0.2.
1071 * 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.
1072 * 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.
1073 * 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.
1074 * The default shell provided by the installer should list valid auto completion options after typing a partial command and then pressing tab two or more times. Observed in DragonFly 3.0.2.
1075 * ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012.
1076 * The following errors should not occur when quitting from the GUI.
1077
1078         waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0"
1079         xterm:  fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0"
1080         failed to unset mtrr: Device not configured
1081         
1082         
1083         xauth: (argv):1:  bad display name "myhostname.mysubdomain.mytld:0" in "remove" command
1084
1085     Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze.
1086
1087 ## Workarounds
1088 **Enable the Caps Lock Key within the GUI**
1089
1090 Edit the file /etc/X11/xorg.conf.
1091
1092     ee /etc/X11/xorg.conf
1093
1094 Delete the ctrl:nocaps XkbOptions option from the InputDevice section with the identifier Keyboard0 of the xorg.conf file. Or comment it out by prefixing the line with the # symbol.
1095
1096     Section "InputDevice"
1097         Identifier  "Keyboard0"
1098         Driver      "kbd"
1099         #Option      "XkbOptions" "ctrl:nocaps"
1100     EndSection
1101
1102 Observed in DragonFly BSD 3.0.2.
1103
1104 **Install Non-GUI on 3TB+ Hard Drive**
1105
1106 *WARNING:* This workaround includes instructions which will delete all data from a hard drive.
1107
1108 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).
1109
1110 Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases.
1111
1112 Tested in snapshot on 8/14/2012.
1113
1114 **Install Xfce 4.6**
1115
1116 *WARNING:* This workaround is not yet complete. Contributions are welcome.
1117
1118 The following testing is being done with a root account and no user account. Additional testing with a regular user account will be done later.
1119
1120 *DragonFly BSD 3.1-DEVELOPMENT Non-GUI Instructions*
1121
1122 Summary
1123
1124 * Install XOrg if it's not already installed.
1125 * Ensure that mouse works.
1126 * Get the xfce4 meta-package make file.
1127 * Install binary files listed in xfce4 meta-package make file.
1128
1129 These instructions are currently a mess. They're currently just a rough outline of how I got it working. I'll go through and clean it up later.
1130
1131 Get a list of which packages would be included if Xfce was installed from source. If you haven't already done so, [create and update the pkgsrc tree](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2). Running make pkgsrc-create failed for me when I ran it in my virtual machine with 2 GB, but succeeded when I ran it with 3171 MB.
1132
1133     cd /usr/
1134     make pkgsrc-create
1135     make pkgsrc-update
1136     cd /usr/pkgsrc/meta-pkgs/xfce4
1137     pkgin update
1138     pkgin in `cat Makefile | grep -E "xfce4.*mk" | sed -e 's/.include.*\/xf/xf/g' -e 's/\/.*/ /g' | tr -d "\n"`
1139     pkg_radd modular-xorg
1140     ls /dev/
1141
1142 Log into another console window by pressing Ctrl-Alt-F2 or in VirtualBox, Alt-F2.
1143
1144     man moused
1145
1146 Scroll down until you find where it mentions mouse dev names.
1147
1148     ee /etc/X11/xorg.conf
1149
1150 Comment out the /dev/sysmouse line by putting a # in front of it. Add the following line.
1151
1152     Option "Device" "/dev/psm0"
1153
1154 Except replace psm0 with whichever mouse you've got listed in /dev. Then save the file.
1155
1156     startxfce4
1157
1158 *DragonFly BSD 3.0.2 GUI Instructions*
1159
1160 I got the message Error Code 1 while creating and updating my pkgsrc tree. I haven't yet looked into it further.
1161
1162 Get a list of which packages would be included if Xfce was installed from source. If you haven't already done so, [create and update the pkgsrc tree](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2).
1163
1164     cd /usr/
1165     make pkgsrc-create
1166     make pkgsrc-update
1167
1168 Get a list of which packages would be included if Xfce was installed from source. The pkgsrc tree was maybe already created by default on this version of DragonFly BSD. If it has not already been created, you'd first want to [create it](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2) before continuing. Update the pkgsrc tree.
1169
1170     cd /usr/
1171     make pkgsrc-update
1172
1173 *Notes*
1174
1175 * [XFCE based LiveDVD/IMG](http://leaf.dragonflybsd.org/mailarchive/users/2012-07/msg00123.html)
1176 * [Installing a Desktop Environment: Xfce4](http://www.dragonflybsd.org/docs/how_to_get_to_the_desktop/#index11h3)
1177 * [Desktop Environments: Xfce](http://www.dragonflybsd.org/docs/newhandbook/X/#index9h3)
1178 * [Longest DragonFly BSD Review: Running Xfce in DragonFlyBSD 3.0.1](http://insidesocal.com/click/2012/04/review-dragonflybsd-301----the-5.html)
1179 * [Instructions via Google Translate](http://www.google.com/translate_c?langpair=en&u=http://dragonflybsd.fr/index.php?page=Installation+de+Xfce4)
1180 * [Installing pkgsrc](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2)
1181
1182     pkgin search xfce
1183
1184 **Install Xfce 4.8**
1185
1186 *WARNING:* This workaround is not yet complete. Contributions are welcome.
1187
1188 * [Choosing between portability and innovation](http://lwn.net/Articles/430598/)
1189 * [Xfce 4.8 on BSD flavors](http://gezeiten.org/post/2011/01/Xfce-4.8-on-BSD-flavors)
1190 * [Xfce 4.8 tour](http://xfce.org/about/tour48)
1191
1192 **Install Xfce 4.10**
1193
1194 *WARNING:* This workaround is not yet complete. Contributions are welcome.
1195
1196 * [Xfce 4.10 released](http://www.xfce.org/about/news/?post=1335571200)
1197 * [Xfce 4.10 tour](http://xfce.org/about/tour)
1198
1199 **Set the GUI Keyboard Layout**
1200
1201 Edit the file /etc/X11/xorg.conf.
1202
1203     ee /etc/X11/xorg.conf
1204
1205 Set the XkbVariant option to your keyboard variant.
1206
1207     Section "InputDevice"
1208         Identifier  "Keyboard0"
1209         Driver      "kbd"
1210         Option      "XkbVariant" "dvorak"
1211     EndSection
1212
1213 Valid keyboard options can be found by searching through /usr/pkg/share/X11/xkb/symbols/ for example to find references to the dvorak keyboard layout, run the following command.
1214
1215     grep --color -n -r dvorak /usr/pkg/share/X11/xkb/symbols
1216
1217 If too many lines scroll by, you can use your arrow buttons to scroll back within the non-graphical console screen by pressing the Scroll Lock button on your keyboard.
1218
1219 Tested in DragonFly 3.0.2.
1220
1221 ## Contribute
1222
1223 **Port VirtualBox to DragonFly BSD**
1224
1225      - Build VirtualBox in GhostBSD (GhostBSD is FreeBSD with Gnome or LXDE installed out of the box.)
1226         - Install GhostBSD (Gnome version 3.0 RC1 in VirtualBox)
1227            - It's easier to change the keyboard layout in the Gnome version.
1228            - If your keyboard stops working during the install then do the following.
1229               - Restart GhostBSD LiveCD/LiveUSB
1230               - Applications > Accessories > Text Editor
1231               - Type your answers to the following fields.
1232                  - root password
1233                  - username
1234                  - full name of user
1235                  - user password
1236                  - hostname.
1237               - Copy and paste your answers into the installer.
1238         - Initialize build environment: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html
1239            - Handbook Instructions: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html
1240            - portsnap fetch (68 MB as root)
1241            - portsnap extract (as root)
1242            - portsnap update (as root)
1243         - Install Guest Additions (from FreeBSD, not from Oracle)
1244            - Initialize build environment (See above)
1245            - Wiki Instructions: http://wiki.freebsd.org/VirtualBox#Installing_Guest_Additions_for_FreeBSD_guests
1246            - Handbook Instructions: http://www.freebsd.org/doc/handbook/virtualization-guest.html
1247            - Notes: http://forums.ghostbsd.org/viewtopic.php?f=8&t=693
1248            - More Notes: http://forums.freebsd.org/showthread.php?t=29172
1249            - Create a supfile.
1250               - ee /root/9rel-supfile (as root)
1251               - Firefox within VM http://www.dragonflybsd.org/varialus/
1252               - Copy and paste the following into your supfile.
1253     *default host=CHANGE_THIS.FreeBSD.org
1254     *default base=/var/db
1255     *default prefix=/usr
1256     *default release=cvs tag=RELENG_9_1
1257     *default delete use-rel-suffix
1258     *default compress
1259     src-all
1260               - Firefox http://www.freebsd.org/doc/en/books/handbook/cvsup.html#CVSUP-MIRRORS
1261               - Pick close server and change line *default host=CHANGE_THIS.FreeBSD.org
1262                  - Optionally pick fastest server: http://www.freshports.org/sysutils/fastest_cvsup
1263               - Ctrl-[
1264               - a) leave editor
1265               - a) save changes
1266             - cd /root/ (as root)
1267             - csup 9rel-supfile (as root)
1268             - If outgoing connections to port 5999 are blocked, here are a few possible solutions which I have not yet tried.
1269                - http://lists.freebsd.org/pipermail/freebsd-stable/2005-August/017991.html
1270                - http://lists.freebsd.org/pipermail/freebsd-questions/2004-February/034761.html
1271                - http://lists.freebsd.org/pipermail/freebsd-questions/2004-March/041566.html
1272             - cd /usr/ports/emulators/virtualbox-ose-additions && make install clean (as root)
1273             - The following console dialog will be be displayed.
1274                - Options for virtualbox-ose-additions 4.1.22
1275                - [ ] DEBUG   Install debug symbols
1276                - [ ] OPENGL  OpenGL support
1277                - [X] X11     X11 support (graphics)
1278                - <  OK  >            <Cancel>
1279             - Highlight <  OK  > and press enter.
1280                - The first time I ran this I got a missing dependency error because there had been a minor version update recently. The dependency error was fixed a few hours later. Right after that, the official version of 4.2 was released. To see the original error error, see the edit from 01:48:39 09/13/12.
1281             - The following console dialog will be be displayed.
1282                - Options for help2man1.40.11
1283                - [X] NLS  Native Language Support
1284                - <  OK  >            <Cancel>
1285             - Highlight <  OK  > and press enter.
1286             - The following console dialog will be be displayed.
1287                - Options for m4 1.4.16_1,1
1288                - [ ] LIBSIGSEGV  Use libsigsegv for better diagnostics
1289                - <  OK  >            <Cancel>
1290             - Highlight <  OK  > and press enter.
1291             - Wait for a little while until it successfully finishes.
1292             - Restart virtual machine. (This probably wasn't needed yet.)
1293             - Screen resolution increased, but no mouse integration nor copy and paste. Host is Debian Squeeze.
1294             - ee /etc/rc.conf (as root)
1295             - Add the following lines
1296     
1297     vboxguest_enable="YES"
1298     vboxservice_enable="YES"
1299     
1300             - The notes at the URL above mention adding lines to xorg.conf for mouse integration, but I didn't see an xorg.conf in /etc/X11 or in /etc so I skipped this step for now.
1301             - The notes also mentioned creating a file for HAL users or copying it, but I didn't see a file at /usr/local/share/hal/fdi/policy/10osvendor/90-vboxguest.fdi so I am skipping this step for the moment.
1302             - Restart.
1303             - I just noticed that the lines had already been added to /etc/rc.conf, so I removed the extra ones that I had added.
1304             - Changed to terminal without X server. Host+F2 in VirtualBox, Ctrl-Alt-F2 on hardware.
1305             - Log in as root.
1306             - The following didn't work.
1307             - killall -9 gdm gdm-binary Xorg
1308             - Xorg -configure
1309             - Xorg -config /root/xorg.conf.new
1310             - X started with black screen, no mouse.
1311             - I've run out of time to look into this at the moment. I'll return to it later.
1312         - Build VirtualBox
1313            - Initialize build environment (See above)
1314         - Build Guest Additions
1315      - Build VirtualBox in DragonFly BSD
1316         - Install DragonFly BSD (Xfce IMG/ISO Installer)
1317         - Build VirtualBox
1318         - Install VirtualBox
1319         - Test VirtualBox
1320         - Build Guest Additions
1321         - Install Guest Additions
1322         - Test Guest Additions
1323      - Package for pkgsrc
1324      - Upload to pkgsrc
1325
1326 **Port Xfce 4.10 to DragonFly BSD**
1327
1328      - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
1329      - Build Instructions: http://docs.xfce.org/xfce/building
1330      - Package for pkgsrc
1331      - Upload to pkgsrc
1332
1333 **DragonFly BSD Network Shares Walkthrough**
1334
1335      - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
1336
1337 **Port bxpkg to DragonFly BSD**
1338
1339      - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
1340
1341 ## Not Yet Formatted Text Dump
1342
1343 **Project HAMMER Debian**
1344 The goal of project HAMMER Debian is to recreate Debian Squeeze using the MATE desktop environment, the DragonFly BSD kernel, and the newer of the frozen Debian testing repository or the Debian stable repository.
1345
1346 Parallel Sub-Project Documentation
1347 0. Setup Common to Subsequent Sub-Project Documentation
1348 1. Recreate Debian Squeeze using the MATE desktop environment and the newer of the frozen Debian testing repository or the Debian stable repository.
1349 2. Recreate Debian Squeeze using the MATE desktop environment and DragonFly BSD.
1350 3. Recreate Debian Squeeze using the MATE desktop environment and the newer of the frozen kFreeBSD testing repository or the kFreeBSD stable repository.
1351 4. Recreate Debian Squeeze using the MATE desktop environment and FreeBSD.
1352 5. Recreate Debian Squeeze using the MATE desktop environment, the DragonFly BSD kernel, and the newer of the frozen Debian testing repository or the Debian stable repository.
1353
1354 0.1. Default values implied where steps are skipped.
1355 0.2. Installation steps are given using the apt command, but using the aptitude command instead of apt is recommended.
1356 0.3. These instructions sudo for root user authentication, but some systems may use su or some other method instead.
1357 0.4.0. The use of the nano terminal command is implied for steps which involve editing text files.
1358 0.4.1. The Ctrl-x shortcut can be used to bring up the save prompt and then exit from nano.
1359 0.5.0. Set up a development machine.
1360 0.5.1.0. The Oracle build of VirtualBox is recommended for its ease of use and highly active development.
1361 0.5.1.1. Here's a link to the VirtualBox download page. https://www.virtualbox.org/wiki/Downloads
1362 0.5.1.2. Here's a link to the VirtualBox Linux download page. https://www.virtualbox.org/wiki/Linux_Downloads
1363 0.5.1.3. Here's the /etc/apt/sources.list repository line for Debian Wheezy. deb http://download.virtualbox.org/virtualbox/debian wheezy contrib
1364 0.5.1.4. Here's the command to authenticate the Oracle Virtualbox repository. wget -q http://download.virtualbox.org/virtualbox/debian/oracle_vbox.asc -O- | sudo apt-key add -
1365 0.5.1.5. Here's the authentication fingerprint for the Oracle Virtualbox repository. 7B0F AB3A 13B9 0743 5925  D9C9 5442 2A4B 98AB 5139
1366 Oracle Corporation (VirtualBox archive signing key) <info@virtualbox.org>
1367 0.5.1.6. Here are the commands to install VirtualBox. sudo apt-get update
1368 sudo apt-get install dkms
1369 sudo apt-get install virtualbox-4.2
1370 0.5.1.7. It's recommended to add your regular user to the vboxusers group and the following is the recommended method. Gnome 2 Menu > System > Administration > Users and Groups > Manage Groups > vboxusers > Properties > Select Check Box of Your Regular User > OK > Password: > Your Regular User Password > Authenticate > Close > Close
1371 0.5.2. The recommended host software environment is a recreation of Debian Squeeze using the MATE desktop environment and the newer of the frozen Debian testing repository or the Debian stable repository.
1372 0.5.3. The recommended host hardware environment is an x64 computer with at least a dual core processor, 2 GB memory, a 250 GB hard disk and an Internet connection.
1373 0.6.