varialus/index.mdwn

   1 # et
   2 # Anisoptera
   3 *The following is an unpaid personal wiki page. The views and opinions expressed herein do not necessarily reflect those of the DragonFly BSD mascot nor its management.*
   4
   5 ## Table of Contents
   6
   7 1. **Featured**
   8
   9 * Walkthrough of Xfce 4.6 Installation via Custom DVD/IMG Installer
  10
  11 2. **Tidbits**
  12
  13 * Hammer
  14 * DragonFly BSD
  15 * Xfce
  16 * Dissonance/Apache Harmony
  17 * Jython/Python
  18 * ee/nano
  19 * pkgin/apt-get
  20
  21 3. **Reminders**
  22
  23 * DNS Settings in Debian Squeeze
  24 * Shutdown command in DragonFly BSD
  25
  26 4. **Issues**
  27
  28 * Disclaimer
  29 * Default GUI Too Bare
  30 * Early Keyboard Selection
  31 * GUI Keyboard Selection
  32 * Encryption Keyboard Selection
  33 * Disabled Caps Lock in GUI
  34 * Random Key for Encrypted Swap
  35 * Stay Decrypted for  Configuration
  36 * No Confirmation for Decryption
  37 * Plain Text Password in Install Log
  38 * USB Installation Media Named Uniquely
  39 * 3TB+ HD Install
  40 * Overwrite 3TB+ Partition Table
  41 * Lackluster Default Shell
  42 * Wiki Centered Text
  43 * XOrg Quit Errors
  44
  45 5. **Workarounds**
  46
  47 * Enable Caps Lock in GUI
  48 * Install Non-GUI on 3TB+ Hard Drive
  49 * Install Xfce 4.6 (Notes)
  50 * Install Xfce 4.8 (Stub)
  51 * Install Xfce 4.10 (Stub)
  52 * Set GUI Keyboard Layout
  53
  54 5. **Contribute**
  55
  56 * Port VirtualBox to DragonFly BSD
  57 * Port Xfce 4.10 to DragonFly BSD
  58 * DragonFly BSD Network Shares Walkthrough
  59 * Port bxpkg to DragonFly BSD
  60
  61 ## Featured
  62
  63 **Walkthrough of Xfce 4.6 Installation via Custom DVD/IMG Installer**
  64
  65 There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~swildner/LiveDVD/x86_64/) which is built by [one of](http://leaf.dragonflybsd.org/mailarchive/users/2012-07/msg00123.html) the [DragonFly BSD team members](http://www.dragonflybsd.org/team/). As far as I can tell it is functionally identical to the official GUI installer except that it includes the Xfce 4.6 desktop environment rather than the FVWM window manager. Please help test it out so that we can hopefully get it included in the next stable release!
  66
  67 1. Download and extract the [Xfce installer](http://island.quantumachine.net/~swildner/LiveDVD/).
  68 2. If the version of the installer is less than or equal to 20120826-2055, then installing onto a uniprocessor computer may not work.
  69 3. If installng onto a VirtualBox virtual machine, the recommended operating system type is FreeBSD (64 bit).
  70 4. If installing onto a VirtualBox virtual machine, set the hardware clock to UTC time.
  71 5. After starting the computer but before it finishes booting, you will be greeted with the following boot menu.
  72
  73
  74         DragonFly/i386 bootstrap loader, Revision 1.1
  75         (s@advancer.yo, Sun Aug 26 21:24:11 CEST 2012)
  76                                                    |
  77         1. Boot DragonFly [kernel]                 |   ,--,           |           ,--,
  78         2. Boot DragonFly in Safe Mode             |   |   `-,       ,^,       ,-'   |
  79         3. Boot DragonFly without AHCI driver      |    `,    `-,   (/ \)   ,-'    ,'
  80         4. Boot DragonFly without ACPI driver      |      `-,    `-,/   \,-'    ,-'
  81         9. Escape to loader prompt (also ESC)      |         `------(   )------'
  82         s. Boot DragonFly in single user mode      |     ,----------(   )----------,
  83         v. Boot DragonFly with verbose logging     |    |        _,-(   )-,_        |
  84         R. Reboot                                  |     `-,__,-'   \   /   `-,__,-'
  85                                                    |                 | |
  86                                                    |                 | |
  87                                                    |                 | |
  88                                                    |                 | |
  89                                                    |                 | |
  90                                                    |                 | |
  91                                                    |                 `|'
  92                                                    |
  93         Booting in 10 seconds... _
  94
  95 6. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
  96
  97         Welcome to DragonFly!
  98
  99         To Start the installer, login as 'installer'.  To just get a shell prompt,
 100         login as 'root'.  To start a root gui, login as 'root' and run 'startx'.
 101
 102         DragonFly/x86_64 (dflyd.yo) (ttyv0)
 103
 104         login: _
 105
 106 7. Type 'installer' without quotes and press enter.
 107 8. You will be greeted with the following menu.
 108
 109         F10=Refresh Display                                                            .
 110                                                                                        .
 111                                                       ,--,           |           ,--,  .
 112          ------------------------| Welcome to DragonFly BSD |------------------------- .
 113         |                                                                             |.
 114         | Welcome to the DragonFly BSD Live CD.                                       |.
 115         |                                                                             |.
 116         | DragonFly BSD is an efficient and elegant BSD Unix-derived operating        |.
 117         | system.  For more information, see http://www.dragonflybsd.org              |.
 118         |                                                                             |.
 119         | From this CD, you can boot into DragonFly BSD ``live'' (without installing  |.
 120         | it) to evaluate it, to install it manually, or to troubleshoot problems     |.
 121         | with an existing installation, using either a command prompt or menu-driven |.
 122         | utilities.                                                                  |.
 123         |                                                                             |.
 124         | Also, you can use this automated application to assist you in installing    |.
 125         | DragonFly BSD on this computer and configuring it once it is installed.     |.
 126         |                                                                             |.
 127         |        < Install DragonFly BSD >_ < Configure an Installed System >         |.
 128         |    < Live CD Utilities >  < Exit to Live CD >  < Reboot this Computer >     |.
 129         |                     < Setup NetBoot Install Services >                      |.
 130          ----------------------------------------------------------------------------- .
 131                                                                                        .
 132                                                                                        .
 133         Install DragonFly BSD on a HDD or HDD partition on this computer               .
 134
 135 10. The bottom line changes depending on which option is selected.
 136 11. Highlight the option < Install DragonFly BSD > and press enter.
 137 12. You will then be greeted by the following menu.
 138
 139         F10=Refresh Display                                                            .
 140                                                                                        .
 141                                                       ,--,           |           ,--,  .
 142                                                       |   `-,       ,^,       ,-'   |  .
 143                                                        `,    `-,   (/ \)   ,-'    ,'   .
 144          --------------------------| Begin Installation |----------------------------- .
 145         |                                                                             |.
 146         | This application will install DragonFly BSD on one of the hard disk drives  |.
 147         | attached to this computer. It has been designed to make it easy to install  |.
 148         | DragonFly BSD in the typical case. If you have special requirements that    |.
 149         | are not addressed by this installer, or if you have problems using it, you  |.
 150         | are welcome to install DragonFly BSD manually. To do so select Exit to Live |.
 151         | CD, login as root, and follow the instructions given in the file /README .  |.
 152         |                                                                             |.
 153         | NOTE! As with any installation process, YOU ARE STRONGLY ENCOURAGED TO BACK |.
 154         | UP ANY IMPORTANT DATA ON THIS COMPUTER BEFORE PROCEEDING!                   |.
 155         |                                                                             |.
 156         | < Install DragonFly BSD >_ < Return to Welcome Menu >  < Exit to Live CD >  |.
 157          ----------------------------| Press F1 for Help |---------------------------- .
 158                                                                                        .
 159                                                                                        .
 160                                                                                        .
 161                                                                                        .
 162                                                                                        .
 163                                                                                        .
 164                                                                                        .
 165
 166 13. Highlight the option < Install DragonFly BSD > and press enter.
 167 14. The following menu, specific to your hardware, will be displayed.
 168
 169         F10=Refresh Display                                                            .
 170                                                                                        .
 171                                                       ,--,           |           ,--,  .
 172                                                       |   `-,       ,^,       ,-'   |  .
 173                                                        `,    `-,   (/ \)   ,-'    ,'   .
 174                                                          `-,    `-,/   \,-'    ,-'     .
 175                                                             `------(   )------'        .
 176                                                         ,----------(   )----------,    .
 177                                                        |        _,-(   )-,_        |   .
 178                   ----------------------| Select Disk |----------------------,__,-'    .
 179                  |                                                           |         .
 180                  | Select a disk on which to install DragonFly BSD           |         .
 181                  |                                                           |         .
 182                  | < ad1: 1337TB <VBOX HARDDISK 1.0> at ata0-master UDMA33 >_|         .
 183                  | < Return to Begin Installation >                          |         .
 184                   -----------------------------------------------------------          .
 185                                                                     `|'                .
 186                                                                                        .
 187                                                                                        .
 188                                                                                        .
 189                                                                                        .
 190                                                                                        .
 191                                                                                        .
 192                                                                                        .
 193                                                                                        .
 194
 195 15. Highlight the disk on which to install DragonFly BSD and press Enter.
 196 16. The following menu will be displayed.
 197
 198         F10=Refresh Display                                                            .
 199                                                                                        .
 200                                                       ,--,           |           ,--,  .
 201                                                       |   `-,       ,^,       ,-'   |  .
 202                                                        `,    `-,   (/ \)   ,-'    ,'   .
 203                                                          `-,    `-,/   \,-'    ,-'     .
 204                                                             `------(   )------'        .
 205                                                         ,----------(   )----------,    .
 206                 ----------------------------| Select Disk |----------------------  |   .
 207                |                                                                 |'    .
 208                | Select how much of this disk you want to use for DragonFly BSD  |     .
 209                |                                                                 |     .
 210                | ad1: 1337TB <VBOX HARDDISK 1.0> at ata0-master UDMA33           |     .
 211                |                                                                 |     .
 212                |            < Use Entire Disk >_ < Use Part of Disk >            |     .
 213                |                    < Return to Select Disk >                    |     .
 214                 -----------------------------------------------------------------      .
 215                                                                                        .
 216                                                                                        .
 217                                                                                        .
 218                                                                                        .
 219                                                                                        .
 220                                                                                        .
 221                                                                                        .
 222                                                                                        .
 223
 224 17. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter.
 225 18. The following menu will be displayed.
 226
 227         F10=Refresh Display                                                            .
 228                                                                                        .
 229                                                       ,--,           |           ,--,  .
 230                                                       |   `-,       ,^,       ,-'   |  .
 231                             ------| Are you absolutely sure? |------/ \)   ,-'    ,'   .
 232                            |                                        |  \,-'    ,-'     .
 233                            | WARNING! ALL data in ALL partitions on |  )------'        .
 234                            | the disk                               |  )----------,    .
 235                            |                                        |  )-,_        |   .
 236                            | ad1: 1337TB <VBOX HARDDISK 1.0> at     |  /   `-,__,-'    .
 237                            | ata0-master UDMA33                     | |                .
 238                            |                                        | |                .
 239                            | will be IRREVOCABLY ERASED!            | |                .
 240                            |                                        | |                .
 241                            | Are you ABSOLUTELY SURE you wish to    | |                .
 242                            | take this action? This is your LAST    | |                .
 243                            | CHANCE to cancel!                      ||'                .
 244                            |                                        |                  .
 245                            |           < OK >_ < Cancel >           |                  .
 246                             ----------------------------------------                   .
 247                                                                                        .
 248                                                                                        .
 249                                                                                        .
 250                                                                                        .
 251                                                                                        .
 252
 253 19. If you are absolutely sure, highlight < OK > and press enter.
 254 20. The following menu will be displayed.
 255
 256         F10=Refresh Display                                                            .
 257                                                                                        .
 258                                                       ,--,           |           ,--,  .
 259                                                       |   `-,       ,^,       ,-'   |  .
 260                                                        `,    `-,   (/ \)   ,-'    ,'   .
 261                                                          `-,    `-,/   \,-'    ,-'     .
 262                                                             `------(   )------'        .
 263                               ---------| Information |-------------(   )----------,    .
 264                              |                                    |(   )-,_        |   .
 265                              | The disk                           |\   /   `-,__,-'    .
 266                              |                                    | | |                .
 267                              | ad1: 1337TB <VBOX HARDDISK 1.0> at | | |                .
 268                              | ata0-master UDMA33                 | | |                .
 269                              |                                    | | |                .
 270                              | was formatted.                     | | |                .
 271                              |                                    | | |                .
 272                              |                < OK >              | `|'                .
 273                               ------------------------------------                     .
 274                                                                                        .
 275                                                                                        .
 276                                                                                        .
 277                                                                                        .
 278                                                                                        .
 279                                                                                        .
 280                                                                                        .
 281
 282 21. Press enter.
 283 22. The following menu will be displayed.
 284
 285         F10=Refresh Display                                                            .
 286                                                                                        .
 287                                                       ,--,           |           ,--,  .
 288                                                       |   `-,       ,^,       ,-'   |  .
 289                                                        `,    `-,   (/ \)   ,-'    ,'   .
 290                                                          `-,    `-,/   \,-'    ,-'     .
 291                                                             `------(   )------'        .
 292                    -----------------| Select file system |------------------------,    .
 293                   |                                                         |      |   .
 294                   | Please select the file system you want to use with      |,__,-'    .
 295                   | DragonFly BSD.                                          |          .
 296                   |                                                         |          .
 297                   | HAMMER is the new DragonFly BSD file system. UFS is the |          .
 298                   | traditional BSD file system.                            |          .
 299                   |                                                         |          .
 300                   | < Use HAMMER >_ < Use UFS >  < Return to Select Disk >  |          .
 301                    ---------------------------------------------------------           .
 302                                                                                        .
 303                                                                                        .
 304                                                                                        .
 305                                                                                        .
 306                                                                                        .
 307                                                                                        .
 308                                                                                        .
 309                                                                                        .
 310
 311 23. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter.
 312 24. The following menu will be displayed.
 313
 314         F10=Refresh Display                                                            .
 315                                                                                        .
 316                                                       ,--,           |           ,--,  .
 317                --------------------| Create Subpartitions |---------------------    |  .
 318               |                                                                 | ,'   .
 319               | Set up the partitions (also knows as just `partitions' in       |'     .
 320               | BSD tradition) you want to have on this primary partition. In   |      .
 321               | most cases you should be fine with the default settings.        |-,    .
 322               |                                                                 |  |   .
 323               | For Capacity, use 'M' to indicate megabytes, 'G' to indicate    |-'    .
 324               | gigabytes, or a single '*' to indicate 'use the remaining space |      .
 325               | on the primary partition'.                                      |      .
 326               |                                                                 |      .
 327               | Mountpoint  Capacity  Encrypted                                 |      .
 328               | [/boot_   ] [768M   ] [ ]     < Ins > < Del >                   |      .
 329               | [swap     ] [2048M  ] [ ]     < Ins > < Del >                   |      .
 330               | [/        ] [*      ] [ ]     < Ins > < Del >                   |      .
 331               |                               < Add >                           |      .
 332               |                                                                 |      .
 333               |     < Accept and Create >  < Return to Select Disk >            |      .
 334                -------------------| Press F1 for Help |-------------------------       .
 335                                                                                        .
 336                                                                                        .
 337                                                                                        .
 338                                                                                        .
 339
 340 25. Highlight < Accept and Create > and press enter.
 341 26. The following menu will be displayed.
 342
 343         F10=Refresh Display                                                            .
 344                                                                                        .
 345                                                       ,--,           |           ,--,  .
 346                                                       |   `-,       ,^,       ,-'   |  .
 347                                                        `,    `-,   (/ \)   ,-'    ,'   .
 348                                                          `-,    `-,/   \,-'    ,-'     .
 349                -------------------------| Install OS |--------------------------       .
 350               |                                                                 |-,    .
 351               | Everything is now ready to install the actual files which       |  |   .
 352               | comprise the DragonFly BSD operating system on the selected     |-'    .
 353               | partition of the selected disk.                                 |      .
 354               |                                                                 |      .
 355               | Note that this process will take quite a while to finish. You   |      .
 356               | may wish to take a break now and come back to the computer in a |      .
 357               | short while.                                                    |      .
 358               |                                                                 |      .
 359               | < Begin Installing Files >_ < Return to Create Subpartitions >  |      .
 360                -----------------------------------------------------------------       .
 361                                                                                        .
 362                                                                                        .
 363                                                                                        .
 364                                                                                        .
 365                                                                                        .
 366                                                                                        .
 367                                                                                        .
 368                                                                                        .
 369
 370 27. Highlight < Begin Installing Files > and press enter.
 371 28. The following progress bar will be displayed.
 372
 373         F10=Refresh Display                                                            .
 374                                                                                        .
 375                                                       ,--,           |           ,--,  .
 376                                                       |   `-,       ,^,       ,-'   |  .
 377                                                        `,    `-,   (/ \)   ,-'    ,'   .
 378                                                          `-,    `-,/   \,-'    ,-'     .
 379                                                             `------(   )------'        .
 380                                                         ,----------(   )----------,    .
 381                   -------------------| Executing Commands |-------------------     |   .
 382                  |                                                            |_,-'    .
 383                  | /bin/cpdup -o -vvv -u /usr/pkg /mnt/usr/pkg                |        .
 384                  |                                                            |        .
 385                  |          [*#################58%#                ]          |        .
 386                  |                                                            |        .
 387                  |                         < Cancel >_                        |        .
 388                   ------------------------------------------------------------         .
 389                                                                     `|'                .
 390                                                                                        .
 391                                                                                        .
 392                                                                                        .
 393                                                                                        .
 394                                                                                        .
 395                                                                                        .
 396                                                                                        .
 397                                                                                        .
 398
 399 29. Go brush your teeth. And don't forget to floss.
 400 30. When it finishes, the following menu will be displayed.
 401
 402         F10=Refresh Display                                                            .
 403                                                                                        .
 404                                                       ,--,           |           ,--,  .
 405                                                       |   `-,       ,^,       ,-'   |  .
 406                     ---------------| Install Bootblock(s) |----------------,-'    ,'   .
 407                    |                                                       |   ,-'     .
 408                    | You may now wish to install bootblocks on one or more |--'        .
 409                    | disks. If you already have a boot manager installed,  |------,    .
 410                    | you can skip this step (but you may have to configure |       |   .
 411                    | your boot manager separately.)  If you installed      |-,__,-'    .
 412                    | DragonFly BSD on a disk other than your first disk,   |           .
 413                    | you will need to put the bootblock on at least your   |           .
 414                    | first disk and the DragonFly disk.                    |           .
 415                    |                                                       |           .
 416                    | Disk Drive  Install Bootblock?  Packet Mode?          |           .
 417                    | [ad1_     ] [X]                 [X]                   |           .
 418                    |                                                       |           .
 419                    |           < Accept and Install Bootblocks >           |           .
 420                    |                  < Skip this Step >                   |           .
 421                     -----------------| Press F1 for Help |-----------------            .
 422                                                                                        .
 423                                                                                        .
 424                                                                                        .
 425                                                                                        .
 426         The disk on which you wish to install a bootblock                              .
 427
 428 31. Highlight < Accept and Install Bootblocks > and press enter.
 429 32. An Information dialog box will be displayed which says: Bootblocks were successfully installed!
 430 33. Press enter.
 431 34. The following menu will be displayed.
 432
 433          ---| DragonFly BSD is Installed! |--
 434         |
 435         | Congratulations!
 436         |
 437         | DragonFly BSD has successfully been installed on this computer.
 438         | You may now proceed to configure the installation. Alternately,
 439         | you may wish to reboot the computer and boot into the installed
 440         | system to confirm that it works.
 441         |
 442         |              < Configure this System >_ < Reboot >
 443         |                   < Return to Welcome Menu >
 444          ---
 445
 446 35. Highlight < Configure this System > and press enter.
 447 36. The following menu will be displayed.
 448
 449          ---| Configure an Installed System |--
 450         |
 451         | The options on this menu allow you to
 452         | configure a DragonFly BSD system after
 453         | it has already been installed.
 454         | < Select timezone >_
 455         | < Set date and time >
 456         | < Set keyboard map >
 457         | < Set root password >
 458         | < Add a user >
 459         | < Configure network interfaces >
 460         | < Configure hostname and domain >
 461         | < Set console font >
 462         | < Set screen map >
 463         | < Remove software packages >
 464         | < Return to Welcome Menu >
 465          ---
 466
 467 37. Highlight < Select timezone > and press enter.
 468
 469 (The only purpose of this line is to reduce the indentation of the following bullet points.)
 470
 471 * Highlight  < Set keyboard map > and press enter.
 472 * Highlight < Set root password > and press enter.
 473 * changeme
 474 * Highlight < Add a user > and press enter.
 475 * Password: changeme
 476 * Highlight < Configure network interfaces > and press enter.
 477 * Highlight < Configure hostname and domain > and press enter.
 478 * Highlight < Return to Welcome Menu > and press enter.
 479 * Highlight < Reboot this Computer > and press enter.
 480 * Highlight < Reboot > and press enter.
 481 * Remove installation media.
 482 * The operating system has halted.
 483 * Please press any key to reboot.
 484 * Log in as root.
 485 * Change password.
 486 * ee /etc/hosts
 487 * # Replace hostname and domain with the ones that you chose during configuration.
 488 * ::1       localhost hostname.domain
 489 * 127.0.0.1 localhost hostname.domain
 490 * Ctrl-[
 491 * a) leave editor
 492 * a) save changes
 493 * exit
 494 * Log in as user.
 495 * Change password.
 496 * startxfce4 (I think that running startx from the root user starts Xfce, but running it from a regular user starts the non-Xfce GUI.)
 497
 498 ## Tidbits
 499 * **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.
 500 * **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.
 501 * **[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/).
 502 * **[Dissonance](https://bitbucket.org/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.
 503 * **[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.
 504 * **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'.
 505 * **pkgin** is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities.
 506
 507 ## Reminders
 508 * 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.
 509 * 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.
 510
 511 ## Issues
 512 * 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.
 513 * The installer should offer the Xfce desktop environment as a supported option. Observed in DragonFly 3.0.2. See workaround below.
 514 * The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.0.2.
 515 * The installer should set the keyboard layout for the GUI. Observed in DragonFly 3.0.2. See workaround below.
 516 * The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2.
 517 * 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.
 518 * 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.
 519 * 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.
 520 * 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.
 521 * 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.
 522 * 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.
 523 * 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.
 524 * 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.
 525 * 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.
 526 * ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012.
 527 * The following errors should not occur when quitting from the GUI.
 528
 529         waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0"
 530         xterm:  fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0"
 531         failed to unset mtrr: Device not configured
 532
 533
 534         xauth: (argv):1:  bad display name "myhostname.mysubdomain.mytld:0" in "remove" command
 535
 536     Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze.
 537
 538 ## Workarounds
 539 **Enable the Caps Lock Key within the GUI**
 540
 541 Edit the file /etc/X11/xorg.conf.
 542
 543     ee /etc/X11/xorg.conf
 544
 545 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.
 546
 547     Section "InputDevice"
 548         Identifier  "Keyboard0"
 549         Driver      "kbd"
 550         #Option      "XkbOptions" "ctrl:nocaps"
 551     EndSection
 552
 553 Observed in DragonFly BSD 3.0.2.
 554
 555 **Install Non-GUI on 3TB+ Hard Drive**
 556
 557 *WARNING:* This workaround includes instructions which will delete all data from a hard drive.
 558
 559 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).
 560
 561 Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases.
 562
 563 Tested in snapshot on 8/14/2012.
 564
 565 **Install Xfce 4.6**
 566
 567 *WARNING:* This workaround is not yet complete. Contributions are welcome.
 568
 569 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.
 570
 571 *DragonFly BSD 3.1-DEVELOPMENT Non-GUI Instructions*
 572
 573 Summary
 574
 575 * Install XOrg if it's not already installed.
 576 * Ensure that mouse works.
 577 * Get the xfce4 meta-package make file.
 578 * Install binary files listed in xfce4 meta-package make file.
 579
 580 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.
 581
 582 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.
 583
 584     cd /usr/
 585     make pkgsrc-create
 586     make pkgsrc-update
 587     cd /usr/pkgsrc/meta-pkgs/xfce4
 588     pkgin update
 589     pkgin in `cat Makefile | grep -E "xfce4.*mk" | sed -e 's/.include.*\/xf/xf/g' -e 's/\/.*/ /g' | tr -d "\n"`
 590     pkg_radd modular-xorg
 591     ls /dev/
 592
 593 Log into another console window by pressing Ctrl-Alt-F2 or in VirtualBox, Alt-F2.
 594
 595     man moused
 596
 597 Scroll down until you find where it mentions mouse dev names.
 598
 599     ee /etc/X11/xorg.conf
 600
 601 Comment out the /dev/sysmouse line by putting a # in front of it. Add the following line.
 602
 603     Option "Device" "/dev/psm0"
 604
 605 Except replace psm0 with whichever mouse you've got listed in /dev. Then save the file.
 606
 607     startxfce4
 608
 609 *DragonFly BSD 3.0.2 GUI Instructions*
 610
 611 I got the message Error Code 1 while creating and updating my pkgsrc tree. I haven't yet looked into it further.
 612
 613 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).
 614
 615     cd /usr/
 616     make pkgsrc-create
 617     make pkgsrc-update
 618
 619 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.
 620
 621     cd /usr/
 622     make pkgsrc-update
 623
 624 *Notes*
 625
 626 * [XFCE based LiveDVD/IMG](http://leaf.dragonflybsd.org/mailarchive/users/2012-07/msg00123.html)
 627 * [Installing a Desktop Environment: Xfce4](http://www.dragonflybsd.org/docs/how_to_get_to_the_desktop/#index11h3)
 628 * [Desktop Environments: Xfce](http://www.dragonflybsd.org/docs/newhandbook/X/#index9h3)
 629 * [Longest DragonFly BSD Review: Running Xfce in DragonFlyBSD 3.0.1](http://insidesocal.com/click/2012/04/review-dragonflybsd-301----the-5.html)
 630 * [Instructions via Google Translate](http://www.google.com/translate_c?langpair=en&u=http://dragonflybsd.fr/index.php?page=Installation+de+Xfce4)
 631 * [Installing pkgsrc](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2)
 632
 633     pkgin search xfce
 634
 635 **Install Xfce 4.8**
 636
 637 *WARNING:* This workaround is not yet complete. Contributions are welcome.
 638
 639 * [Choosing between portability and innovation](http://lwn.net/Articles/430598/)
 640 * [Xfce 4.8 on BSD flavors](http://gezeiten.org/post/2011/01/Xfce-4.8-on-BSD-flavors)
 641 * [Xfce 4.8 tour](http://xfce.org/about/tour48)
 642
 643 **Install Xfce 4.10**
 644
 645 *WARNING:* This workaround is not yet complete. Contributions are welcome.
 646
 647 * [Xfce 4.10 released](http://www.xfce.org/about/news/?post=1335571200)
 648 * [Xfce 4.10 tour](http://xfce.org/about/tour)
 649
 650 **Set the GUI Keyboard Layout**
 651
 652 Edit the file /etc/X11/xorg.conf.
 653
 654     ee /etc/X11/xorg.conf
 655
 656 Set the XkbVariant option to your keyboard variant.
 657
 658     Section "InputDevice"
 659         Identifier  "Keyboard0"
 660         Driver      "kbd"
 661         Option      "XkbVariant" "dvorak"
 662     EndSection
 663
 664 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.
 665
 666     grep --color -n -r dvorak /usr/pkg/share/X11/xkb/symbols
 667
 668 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.
 669
 670 Tested in DragonFly 3.0.2.
 671
 672 ## Contribute
 673
 674 **Port VirtualBox to DragonFly BSD**
 675
 676          - Build VirtualBox in GhostBSD (GhostBSD is FreeBSD with Gnome or LXDE installed out of the box.)
 677             - Install GhostBSD (Gnome version 3.0 RC1 in VirtualBox)
 678                - It's easier to change the keyboard layout in the Gnome version.
 679                - If your keyboard stops working during the install then do the following.
 680                   - Restart GhostBSD LiveCD/LiveUSB
 681                   - Applications > Accessories > Text Editor
 682                   - Type your answers to the following fields.
 683                      - root password
 684                      - username
 685                      - full name of user
 686                      - user password
 687                      - hostname.
 688                   - Copy and paste your answers into the installer.
 689             - Initialize build environment: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html
 690                - Handbook Instructions: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html
 691                - portsnap fetch (68 MB as root)
 692                - portsnap extract (as root)
 693                - portsnap update (as root)
 694             - Install Guest Additions (from FreeBSD, not from Oracle)
 695                - Initialize build environment (See above)
 696                - Wiki Instructions: http://wiki.freebsd.org/VirtualBox#Installing_Guest_Additions_for_FreeBSD_guests
 697                - Handbook Instructions: http://www.freebsd.org/doc/handbook/virtualization-guest.html
 698                - Notes: http://forums.ghostbsd.org/viewtopic.php?f=8&t=693
 699                - More Notes: http://forums.freebsd.org/showthread.php?t=29172
 700                - Create a supfile.
 701                   - ee /root/9rel-supfile (as root)
 702                   - Firefox http://forums.freebsd.org/showthread.php?t=29172
 703                   - Copy and paste supfile.
 704                   - Firefox http://www.freebsd.org/doc/en/books/handbook/cvsup.html#CVSUP-MIRRORS
 705                   - Pick close server and change line *default host=CHANGE_THIS.FreeBSD.org
 706                      - Optionally pick fastest server: http://www.freshports.org/sysutils/fastest_cvsup
 707         *default host=CHANGE_THIS.FreeBSD.org
 708         *default base=/var/db
 709         *default prefix=/usr
 710         *default release=cvs tag=RELENG_9_1
 711         *default delete use-rel-suffix
 712         *default compress
 713         src-all
 714                   - Ctrl-[
 715                   - a) leave editor
 716                   - a) save changes
 717                 - csup 9rel-supfile (as root probably while in /root/)
 718                 - cd /usr/ports/emulators/virtualbox-ose-additions && make install clean (probably as root)
 719             - Build VirtualBox
 720                - Initialize build environment (See above)
 721             - Build Guest Additions
 722          - Build VirtualBox in DragonFly BSD
 723             - Install DragonFly BSD (Xfce IMG/ISO Installer)
 724             - Build VirtualBox
 725             - Install VirtualBox
 726             - Test VirtualBox
 727             - Build Guest Additions
 728             - Install Guest Additions
 729             - Test Guest Additions
 730          - Package for pkgsrc
 731          - Upload to pkgsrc
 732
 733 **Port Xfce 4.10 to DragonFly BSD**
 734
 735          - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
 736          - Build Instructions: http://docs.xfce.org/xfce/building
 737          - Package for pkgsrc
 738          - Upload to pkgsrc
 739
 740 **DragonFly BSD Network Shares Walkthrough**
 741
 742          - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
 743
 744 **Port bxpkg to DragonFly BSD**
 745
 746          - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)