X-Git-Url: https://gitweb.dragonflybsd.org/ikiwiki.git/blobdiff_plain/6848ea64ba8747ad2eb761963765a8dc9aa6e126..HEAD:/varialus/index.mdwn diff --git a/varialus/index.mdwn b/varialus/index.mdwn index 7ffd3bf0..3861c924 100644 --- a/varialus/index.mdwn +++ b/varialus/index.mdwn @@ -1,85 +1,84 @@ # et # Anisoptera -*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.* +*The following is an unpaid personal wiki page about my experiences, issues, and workarounds related to DragonFly BSD.* ## Table of Contents 1. **Featured** -* Walkthrough of Xfce 4.6 Installation via Custom DVD/IMG Installer +* Long Walkthrough of **DragonFly BSD** Installation and Configuration +* [Golang Tutorial](http://varialus.wikidot.com/golang) +* [Wingo Tutorial](http://varialus.wikidot.com/wingo) +* [Git GUI Tutorial](http://varialus.wikidot.com/git-gui) +* [Agar Tutorial](http://varialus.wikidot.com/agar) +* Long Walkthrough of **MATE** Installation and Configuration +* Short Walkthrough of **Enlightenment** Installation and Configuration 2. **Tidbits** -* Hammer -* DragonFly BSD -* Xfce -* Dissonance/Apache Harmony -* Jython/Python -* ee/nano -* pkgin/apt-get +* Shell/Console/Command-Line-Prompt: tcsh/bash, ctrl-d/tab-tab, partial-previous-command-up-key/ctrl-r-partial-previous-command, rehash +* Package-Management: pkgng/apt-get +* Text-Editor: ee/nano, vi :q! +* Manual: man man +* Power-Down: shutdown -p now +* Find File: grep, find / -name fileName +* Process Management: top, ps, pkill, kill +* File-System: Hammer +* Operating System: DragonFly BSD -3. **Reminders** - -* DNS Settings in Debian Squeeze -* Shutdown command in DragonFly BSD - -4. **Issues** +3. **Issues** * Disclaimer -* Default GUI Too Bare -* Early Keyboard Selection -* GUI Keyboard Selection -* Encryption Keyboard Selection -* Disabled Caps Lock in GUI -* Random Key for Encrypted Swap -* Stay Decrypted for Configuration -* No Confirmation for Decryption -* Plain Text Password in Install Log -* USB Installation Media Named Uniquely -* 3TB+ HD Install -* Overwrite 3TB+ Partition Table -* Lackluster Default Shell -* Wiki Centered Text -* XOrg Quit Errors - -5. **Workarounds** - -* Enable Caps Lock in GUI +* Installer Supported Desktops: dfly 3.8.1 +* Early Keyboard Selection: dfly 3.8.1 +* Encryption Keyboard Selection: dfly 3.0.2 +* Random Key for Encrypted Swap: dfly 3.0.2 +* Stay Decrypted for Configuration: dfly 3.0.2 +* No Confirmation for Decryption: dfly 3.0.2 +* Plain Text Password in Install Log: dfly 3.8.1 +* USB Installation Media Named Uniquely: dfly 3.0.2 +* 3TB+ HD Install: dfly 3.0.2, fixed in snapshot on 8/14/2012 +* Overwrite 3TB+ Partition Table: snapshot 8/14/2012 +* Wiki Centered Text: 8/25/2012 +* XOrg Quit Errors: dfly 3.0.2, VirtualBox 4.1.20 + +4. **Workarounds** + * Install Non-GUI on 3TB+ Hard Drive -* Install Xfce 4.6 (Notes) -* Install Xfce 4.8 (Stub) -* Install Xfce 4.10 (Stub) -* Set GUI Keyboard Layout -5. **Raw** +5. **Contribute** -* ToDo +* Port VirtualBox to DragonFly BSD +* Update and Fix Bugs of Desktop Environments in DPorts +* DragonFly BSD Network Shares Walkthrough ## Featured -**Walkthrough of Xfce 4.6 Installation via Custom DVD/IMG Installer** +### Long Walkthrough of DragonFly BSD Installation and Configuration + +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. -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! +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 -1. Download and extract the [Xfce installer](http://island.quantumachine.net/~swildner/LiveDVD/). -2. If the version of the installer is less than or equal to 20120826-2055, then installing onto a uniprocessor computer may not work. -3. If installng onto a VirtualBox virtual machine, the recommended operating system type is FreeBSD (64 bit). -4. If installing onto a VirtualBox virtual machine, set the hardware clock to UTC time. -5. After starting the computer but before it finishes booting, you will be greeted with the following boot menu. +2. Set the the virtual hardware clock set to UTC time. + +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. + +4. Start the virtual machine. Before it finishes booting, the will be greeted with the following boot menu. DragonFly/i386 bootstrap loader, Revision 1.1 - (s@advancer.yo, Sun Aug 26 21:24:11 CEST 2012) + (justin@pkgbox64.dragonflybsd.org, Mon Jun 16 21:33:12 PDT 2014) | 1. Boot DragonFly [kernel] | ,--, | ,--, 2. Boot DragonFly in Safe Mode | | `-, ,^, ,-' | 3. Boot DragonFly without AHCI driver | `, `-, (/ \) ,-' ,' 4. Boot DragonFly without ACPI driver | `-, `-,/ \,-' ,-' 9. Escape to loader prompt (also ESC) | `------( )------' - s. Boot DragonFly in single user mode | ,----------( )----------, - v. Boot DragonFly with verbose logging | | _,-( )-,_ | - R. Reboot | `-,__,-' \ / `-,__,-' - | | | + r. Boot DragonFly to a rescue ramdisk | ,----------( )----------, + s. Boot DragonFly in single user mode | | _,-( )-,_ | + v. Boot DragonFly with verbose logging | `-,__,-' \ / `-,__,-' + R. Reboot | | | | | | | | | | | | @@ -89,19 +88,20 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s | Booting in 10 seconds... _ -6. After the computer finishes booting, you will be greeted with the following welcome message and login prompt. +5. After the computer finishes booting, you will be greeted with the following welcome message and login prompt. Welcome to DragonFly! - To Start the installer, login as 'installer'. To just get a shell prompt, - login as 'root'. To start a root gui, login as 'root' and run 'startx'. + To start the installer, login as 'installer'. To just get a shell prompt, + login as 'root'. + + DragonFly/x86_64 (Amnesiac) (ttyv0) - DragonFly/x86_64 (dflyd.yo) (ttyv0) - login: _ -7. Type 'installer' without quotes and press enter. -8. You will be greeted with the following menu. +6. Type 'installer' without quotes and press enter. + +7. The following menu will be displayed. F10=Refresh Display . . @@ -129,9 +129,11 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . Install DragonFly BSD on a HDD or HDD partition on this computer . -10. The bottom line changes depending on which option is selected. -11. Highlight the option < Install DragonFly BSD > and press enter. -12. You will then be greeted by the following menu. +8. The bottom line changes depending on which option is selected. + +9. Highlight the option < Install DragonFly BSD > and press enter. + +10. The following menu will be displayed. F10=Refresh Display . . @@ -160,8 +162,9 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -13. Highlight the option < Install DragonFly BSD > and press enter. -14. The following menu, specific to your hardware, will be displayed. +11. Highlight the option < Install DragonFly BSD > and press enter. + +12. The following menu, specific to your hardware, will be displayed. F10=Refresh Display . . @@ -170,17 +173,17 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s `, `-, (/ \) ,-' ,' . `-, `-,/ \,-' ,-' . `------( )------' . - ,----------( )----------, . - | _,-( )-,_ | . - ----------------------| Select Disk |----------------------,__,-' . - | | . - | Select a disk on which to install DragonFly BSD | . - | | . - | < ad1: 1337TB at ata0-master UDMA33 >_| . - | < Return to Begin Installation > | . - ----------------------------------------------------------- . - `|' . - . + -----------------------| Select Disk |----------------------- ---, . + | | | . + | Select a disk on which to install DragonFly BSD |_,-' . + | | . + | < ad0: 131072MB at ata0-master UDMA33 >_| . + | < vn0 > | . + | < vn1 > | . + | < vn2 > | . + | < vn3 > | . + | < Return to Begin Installation > | . + ------------------------------------------------------------- . . . . @@ -189,8 +192,9 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -15. Highlight the disk on which to install DragonFly BSD and press Enter. -16. The following menu will be displayed. +13. Highlight the disk on which to install DragonFly BSD, in this case ad0, and press Enter. + +14. The following menu will be displayed. F10=Refresh Display . . @@ -200,15 +204,15 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s `-, `-,/ \,-' ,-' . `------( )------' . ,----------( )----------, . - ----------------------------| Select Disk |---------------------- | . - | |' . - | Select how much of this disk you want to use for DragonFly BSD | . - | | . - | ad1: 1337TB at ata0-master UDMA33 | . - | | . - | < Use Entire Disk >_ < Use Part of Disk > | . - | < Return to Select Disk > | . - ----------------------------------------------------------------- . + ------------------------| How Much Disk? |------------------------ | . + | |' . + | Select how much of this disk you want to use for DragonFly BSD. | . + | | . + | ad0: 131072MB at ata0-master UDMA33 | . + | | . + | < Use Entire Disk >_ < Use Part of Disk > | . + | < Return to Select Disk > | . + ------------------------------------------------------------------ . . . . @@ -218,19 +222,20 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -17. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter. -18. The following menu will be displayed. +15. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter. + +16. The following menu will be displayed. F10=Refresh Display . . ,--, | ,--, . | `-, ,^, ,-' | . - ------| Are you absolutely sure? |------/ \) ,-' ,' . + ------| Are you absolutely sure? |------ \) ,-' ,' . | | \,-' ,-' . | WARNING! ALL data in ALL partitions on | )------' . | the disk | )----------, . | | )-,_ | . - | ad1: 1337TB at | / `-,__,-' . + | ad0: 131072MB at | / `-,__,-' . | ata0-master UDMA33 | | . | | | . | will be IRREVOCABLY ERASED! | | . @@ -247,8 +252,9 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -19. If you are absolutely sure, highlight < OK > and press enter. -20. The following menu will be displayed. +17. If you are absolutely sure, highlight < OK > and press enter. + +18. The following menu will be displayed. F10=Refresh Display . . @@ -257,17 +263,17 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s `, `-, (/ \) ,-' ,' . `-, `-,/ \,-' ,-' . `------( )------' . - ---------| Information |-------------( )----------, . - | |( )-,_ | . - | The disk |\ / `-,__,-' . - | | | | . - | ad1: 1337TB at | | | . - | ata0-master UDMA33 | | | . - | | | | . - | was formatted. | | | . - | | | | . - | < OK > | `|' . - ------------------------------------ . + -----------| Information |------------ )----------, . + | | )-,_ | . + | The disk | / `-,__,-' . + | || | . + | ad0: 131072MB at || | . + | ata0-master UDMA33 || | . + | || | . + | was formatted. || | . + | || | . + | < OK > |`|' . + -------------------------------------- . . . . @@ -276,8 +282,9 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -21. Press enter. -22. The following menu will be displayed. +19. Press enter. + +20. The following menu will be displayed. F10=Refresh Display . . @@ -286,7 +293,7 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s `, `-, (/ \) ,-' ,' . `-, `-,/ \,-' ,-' . `------( )------' . - -----------------| Select file system |------------------------, . + -----------------| Select file system |------------------ -----, . | | | . | Please select the file system you want to use with |,__,-' . | DragonFly BSD. | . @@ -305,25 +312,26 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -23. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter. -24. The following menu will be displayed. +21. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter. + +22. The following menu will be displayed. F10=Refresh Display . . ,--, | ,--, . --------------------| Create Subpartitions |--------------------- | . | | ,' . - | Set up the partitions (also knows as just `partitions' in |' . + | Set up the subpartitions (also knows as just `partitions' in |' . | BSD tradition) you want to have on this primary partition. In | . | most cases you should be fine with the default settings. |-, . | | | . | For Capacity, use 'M' to indicate megabytes, 'G' to indicate |-' . - | gigabytes, or a single '*' to indicate 'use the remaining space | . - | on the primary partition'. | . + | gigabytes, and so on (up to 'E'.) A single '*' indicates 'use | . + | the remaining space on the primary partition'. | . | | . | Mountpoint Capacity Encrypted | . | [/boot_ ] [768M ] [ ] < Ins > < Del > | . - | [swap ] [2048M ] [ ] < Ins > < Del > | . + | [swap ] [8192M ] [ ] < Ins > < Del > | . | [/ ] [* ] [ ] < Ins > < Del > | . | < Add > | . | | . @@ -334,8 +342,9 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -25. Highlight < Accept and Create > and press enter. -26. The following menu will be displayed. +23. Highlight < Accept and Create > and press enter. + +24. The following menu will be displayed. F10=Refresh Display . . @@ -364,8 +373,9 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -27. Highlight < Begin Installing Files > and press enter. -28. The following progress bar will be displayed. +25. Highlight < Begin Installing Files > and press enter. + +26. The following progress bar will be displayed. F10=Refresh Display . . @@ -377,9 +387,9 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s ,----------( )----------, . -------------------| Executing Commands |------------------- | . | |_,-' . - | /bin/cpdup -o -vvv -u /usr/pkg /mnt/usr/pkg | . + | /bin/cpdup -o -vvv -u /usr/share /mnt/usr/share | . | | . - | [*#################58%# ] | . + | [*#################65%### ] | . | | . | < Cancel >_ | . ------------------------------------------------------------ . @@ -393,8 +403,7 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . . -29. Go brush your teeth. And don't forget to floss. -30. When it finishes, the following menu will be displayed. +27. When it finishes, the following menu will be displayed. F10=Refresh Display . . @@ -408,10 +417,10 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s | your boot manager separately.) If you installed |-,__,-' . | DragonFly BSD on a disk other than your first disk, | . | you will need to put the bootblock on at least your | . - | first disk and the DragonFly disk. | . + | first disk and the DragonFly BSD disk. | . | | . | Disk Drive Install Bootblock? Packet Mode? | . - | [ad1_ ] [X] [X] | . + | [ad0_ ] [X] [X] | . | | . | < Accept and Install Bootblocks > | . | < Skip this Step > | . @@ -422,309 +431,993 @@ There is a new [Xfce based DVD/IMG installer](http://island.quantumachine.net/~s . The disk on which you wish to install a bootblock . -31. Highlight < Accept and Install Bootblocks > and press enter. -32. An Information dialog box will be displayed which says: Bootblocks were successfully installed! -33. Press enter. -34. The following menu will be displayed. - - ---| DragonFly BSD is Installed! |-- - | - | Congratulations! - | - | DragonFly BSD has successfully been installed on this computer. - | You may now proceed to configure the installation. Alternately, - | you may wish to reboot the computer and boot into the installed - | system to confirm that it works. - | - | < Configure this System >_ < Reboot > - | < Return to Welcome Menu > - --- - -35. Highlight < Configure this System > and press enter. -36. The following menu will be displayed. - - ---| Configure an Installed System |-- - | - | The options on this menu allow you to - | configure a DragonFly BSD system after - | it has already been installed. - | < Select timezone >_ - | < Set date and time > - | < Set keyboard map > - | < Set root password > - | < Add a user > - | < Configure network interfaces > - | < Configure hostname and domain > - | < Set console font > - | < Set screen map > - | < Remove software packages > - | < Return to Welcome Menu > - --- - -37. Highlight < Select timezone > and press enter. - -(The only purpose of this line is to reduce the indentation of the following bullet points.) - -* Highlight < Set keyboard map > and press enter. -* Highlight < Set root password > and press enter. -* changeme -* Highlight < Add a user > and press enter. -* Password: changeme -* Highlight < Configure network interfaces > and press enter. -* Highlight < Configure hostname and domain > and press enter. -* Highlight < Return to Welcome Menu > and press enter. -* Highlight < Reboot this Computer > and press enter. -* Highlight < Reboot > and press enter. -* Remove installation media. -* The operating system has halted. -* Please press any key to reboot. -* Log in as root. -* Change password. -* ee /etc/hosts -* # Replace hostname and domain with the ones that you chose during configuration. -* ::1 localhost hostname.domain -* 127.0.0.1 localhost hostname.domain -* Ctrl-[ -* a) leave editor -* a) save changes -* exit -* Log in as user. -* Change password. -* startxfce4 (I think that running startx from the root user starts Xfce, but running it from a regular user starts the non-Xfce GUI.) +28. Highlight < Accept and Install Bootblocks > and press enter. -## Tidbits -* **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. -* **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. -* **[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/). -* **[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. -* **[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. -* **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'. -* **pkgin** is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities. - -## Reminders -* 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. -* 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. +29. The following dialog box will be displayed. -## Issues -* 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. -* The installer should offer the Xfce desktop environment as a supported option. Observed in DragonFly 3.0.2. See workaround below. -* The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.0.2. -* The installer should set the keyboard layout for the GUI. Observed in DragonFly 3.0.2. See workaround below. -* The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2. -* 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. -* 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. -* 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. -* 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. -* 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. -* 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. -* 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. -* 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. -* 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. -* ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012. -* The following errors should not occur when quitting from the GUI. + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + `------( )------' . + ,----------( )----------, . + | _,-( )-,_ | . + -------------| Information |------------- / `-,__,-' . + | | | . + | Bootblocks were successfully installed! | | . + | | | . + | < OK > | | . + ----------------------------------------- | . + | | . + `|' . + . + . + . + . + . + . + . + . - waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0" - xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0" - failed to unset mtrr: Device not configured - +30. Press enter. + +31. The following menu will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + -----------------| DragonFly BSD is Installed! |----------------- . + | |-, . + | Congratulations! | | . + | |-' . + | DragonFly BSD has successfully been installed on this computer. | . + | You may now proceed to configure the installation. Alternately, | . + | you may wish to reboot the computer and boot into the installed | . + | system to confirm that it works. | . + | | . + | < Configure this System >_ < Reboot > | . + | < Return to Welcome Menu > | . + ----------------------------------------------------------------- . + +32. Highlight < Configure this System > and press enter. + +33. The following menu will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + ---| Configure an Installed System |---- ^, ,-' | . + | | \) ,-' ,' . + | The options on this menu allow you to | \,-' ,-' . + | configure a DragonFly BSD system after | )------' . + | it has already been installed. | )----------, . + | | )-,_ | . + | < Select timezone >_ | / `-,__,-' . + | < Set date and time > | | . + | < Set keyboard map > | | . + | < Set root password > | | . + | < Add a user > | | . + | < Configure network interfaces > | | . + | < Configure hostname and domain > | | . + | < Set console font > ||' . + | < Set screen map > | . + | < Remove software packages > | . + | < Return to Welcome Menu > | . + ---------------------------------------- . + . + . + . + Set the Time Zone of your physical location . + +34. Highlight < Select timezone > and press enter. + +35. The following menu will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + `------( )------' . + ,----------( )----------, . + | Local or UTC (Greenwich Mean Time) clock | )-,_ | . + | |/ `-,__,-' . + | Is this machine's CMOS clock set to | . + | UTC? | . + | | . + | If it is set to local time, or you | . + | don't know, please choose NO here! | . + | | . + | < Yes >_ < No > | . + -------------------------------------------- . + . + . + . + . + . + . + . + +36. Highlight < Yes > and press enter. + +37. The following menu will be displayed. + + F10=Refresh Display ----------| Select Time Zone |---------- . + | # . + | Select a Time Zone appropriate to your #| ,--, . + | physical location. #^, ,-' | . + | # \) ,-' ,' . + | < Africa >_ # \,-' ,-' . + | < America > # )------' . + | < Antarctica > # )----------, . + | < Arctic > # )-,_ | . + | < Asia > # / `-,__,-' . + | < Atlantic > # | . + | < Australia > # | . + | < CET > # | . + | < CST6CDT > # | . + | < EET > # | . + | < EST > # | . + | < EST5EDT > #|' . + | < Etc > # . + | < Europe > * . + | < GMT > * . + | < HST > * . + | < Indian > * . + | < MET > * . + | < MST > * . + ---------------------------------------- . + +38. Highlight < GMT > and press enter. + +39. The following dialog box will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + `------( )------' . + ,----------( )----------, . + | _,-( )-,_ | . + --------| Information |-------- \ / `-,__,-' . + | | | | . + | The Time Zone has been set to | | | . + | /mnt/usr/share/zoneinfo/GMT. | | | . + | | | | . + | < OK >_ | | | . + ------------------------------- | | . + `|' . + . + . + . + . + . + . + . + . + +40. Press enter. + +41. The menu from step 33 will be displayed. + +42. If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, highlight < Set keyboard map > and press enter. Otherwise skip to step 46. + +43. The following menu will be displayed. + + F10=Refresh Display -------| Select Keyboard Map |-------- . + | # . + | Select a keyboard map appropriate to # | ,--, . + | your keyboard layout. #,^, ,-' | . + | #/ \) ,-' ,' . + | < be.iso.acc.kbd >_ # \,-' ,-' . + | < be.iso.kbd > # )------' . + | < bg.bds.ctrlcaps.kbd > * )----------, . + | < bg.phonetic.ctrlcaps.kbd > * )-,_ | . + | < br275.cp850.kbd > * / `-,__,-' . + | < br275.iso.acc.kbd > *| | . + | < br275.iso.kbd > *| | . + | < by.cp1131.kbd > *| | . + | < by.cp1251.kbd > *| | . + | < by.iso5.kbd > *| | . + | < ce.iso2.kbd > *| | . + | < colemak.iso15.acc.kbd > *'|' . + | < cs.latin2.qwertz.kbd > * . + | < cz.iso2.kbd > * . + | < danish.cp865.kbd > * . + | < danish.iso.kbd > * . + | < el.iso07.kbd > * . + | < estonian.cp850.kbd > * . + | < estonian.iso.kbd > * . + -------------------------------------- . + +44. Highlight < us.dvorak.kbd > and press enter. + +45. The menu from step 33 will be displayed. + +46. Highlight < Add a user > and press enter. + +47. The following menu will be displayed. + + F10=Refresh D -------------------| Add user |-------------------- . + | | . + | Here you can add a user to an installed system. | ,--, . + | | ,-' | . + | You can leave the Home Directory, User ID, and | ,-' ,' . + | Login Group fields empty if you want these items |' ,-' . + | to be automatically allocated by the system. |----' . + | |--------, . + | Note: this user's password will appear in the |_ | . + | install log. If this is a problem, please add the | `-,__,-' . + | user manually after rebooting into the installed | . + | system instead. | . + | | . + | Username [_ ] | . + | Real Name [ ] | . + | Password [ ] | . + | Password (Again) [ ] | . + | Shell [/bin/tcsh ] | . + | Home Directory [ ] | . + | User ID [ ] | . + | Login Group [ ] | . + | Other Group Memberships [ ] | . + | | . + | < Accept and Add > < Return to Configure Menu > | . + Enter the use --------------------------------------------------- . + +48. In the following fields type the following values without quotes and then highlight < Accept and Add > and press enter. + +* Username: 'user' +* Real Name: 'User' +* Password: 'ChangeMe' +* Password (Again): 'ChangeMe' + +49. The following dialog box will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + `------( )------' . + ,----------( )----------, . + | _,-( )-,_ | . + -----| Information |---- ,-' \ / `-,__,-' . + | | | | . + | User `user' was added. | | | . + | | | | . + | < OK >_ | | | . + ------------------------ | | . + | | . + `|' . + . + . + . + . + . + . + . + . + +50. Press enter. + +51. The menu from step 33 will be displayed. + +52. Highlight < Set root password > and press enter. + +53. The following menu will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + -------------------| Set Root Password |------------------- ,-' . + | |' . + | Here you can set the super-user (root) password. |----, . + | | | . + | Note: root's new password will appear in the install log. |__,-' . + | If this is a problem, please set root's password manually | . + | after rebooting into the installed system instead. | . + | | . + | Root password [_ ] | . + | Root password again [ ] | . + | | . + | < Accept and Set Password > | . + | < Return to Configure Menu > | . + ----------------------------------------------------------- . + . + . + . + . + . + . + Enter the root password you would like to use . + +54. In the following fields type the following values without quotes and then highlight < Accept and Set Password > and press enter. + +* Root password: 'ChangeMe' +* Root password again: 'ChangeMe' + +55. The following dialog box will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + `------( )------' . + ,----------( )----------, . + | _,-( )-,_ | . + ------------| Information |----------- \ / `-,__,-' . + | | | | . + | The root password has been changed. | | | . + | | | | . + | < OK >_ | | | . + -------------------------------------- | | . + | | . + `|' . + . + . + . + . + . + . + . + . + +56. Press enter. + +57. The menu from step 33 will be displayed. + +58. Highlight < Configure network interfaces > and press enter. + +59. The following menu will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + ----------| Assign IP Address |---------- )------' . + | | )----------, . + | Please select which interface you would | )-,_ | . + | like to configure: | / `-,__,-' . + | | | . + | < em0 >_ | | . + | < faith0 > | | . + | < lo0 > | | . + | < ppp0 > | | . + | < sl0 > | | . + | < Cancel > ||' . + ----------------------------------------- . + . + . + . + . + . + . + . + +60. Highlight < em0 > and press enter. + +61. The following menu will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + `------( )------' . + --------------| Use DHCP? |-------------- )----------, . + | | )-,_ | . + | DHCP allows the interface to | / `-,__,-' . + | automatically obtain an IP address from | | . + | a nearby DHCP server. | | . + | | | . + | Would you like to enable DHCP for em0? | | . + | | | . + | < Use DHCP >_ < Configure Manually > | | . + ----------------------------------------- |' . + . + . + . + . + . + . + . + . + +62. Highlight < Use DHCP > and press enter. + +63. The following menu, specific to your hardware and network connection, will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + -------------| Information |------------- \) ,-' ,' . + | | \,-' ,-' . + | em0: | )------' . + | flags=8843 mtu 1500 | )-,_ | . + | options=1b | | . + | inet6 fe80::a00:27ff:fe98:67cc%em0 | | . + | prefixlen 64 scopeid 0x1 | | . + | ether 08:00:27:98:67:cc | | . + | media: Ethernet autoselect (1000baseT | | . + | ) | | . + | status: active ||' . + | | . + | | . + | < OK >_ | . + ----------------------------------------- . + . + . + . + . + +64. Press enter. + +65. The menu from step 33 will be displayed. + +66. Highlight < Configure hostname and domain > and press enter. + +67. The following menu will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + `------( )------' . + -------| Set Hostname/Domain |-------- )----------, . + | | )-,_ | . + | Please enter this machine's hostname | / `-,__,-' . + | and domain name. || | . + | || | . + | Hostname [_ ] || | . + | Domain [ ] || | . + | || | . + | || | . + | < OK > < Cancel > |`|' . + -------------------------------------- . + . + . + . + . + . + . + Enter the Hostname (e.g. `machine') . + +68. In the following fields type the following values without quotes and then highlight < OK > and press enter. + +* Hostname: 'dfly' +* Domain: 'localhost' + +69. The menu from step 33 will be displayed. + +70. Highlight < Return to Welcome Menu > and press enter. + +71. The menu from step 7 will be displayed. + +72. Highlight < Reboot this Computer > and press enter. + +73. The following menu will be displayed. + + F10=Refresh Display . + . + ,--, | ,--, . + | `-, ,^, ,-' | . + `, `-, (/ \) ,-' ,' . + `-, `-,/ \,-' ,-' . + `------( )------' . + ---------------| Reboot |--------------- )----------, . + | | )-,_ | . + | This machine is about to be shut down. | / `-,__,-' . + | After the machine has reached its | | . + | shutdown state, you may remove the CD | | . + | from the CD-ROM drive tray and press | | . + | Enter to reboot from the HDD. | | . + | | | . + | < Reboot > | | . + | < Return to Welcome Menu > ||' . + ---------------------------------------- . + . + . + . + . + . + . + . + +74. Highlight < Reboot > and press enter. + +75. The following message will be displayed. + + The operating system has halted. + Please press any key to reboot. + +76. Remove the virtual CD installation media from the virtual machine. + +77. Press any key to reboot. Before it finishes booting, the will be greeted with the menu from step 4. + +78. After the computer finishes booting, you will be greeted with the following welcome message and login prompt. + + DragonFly/x86_64 (dfly.localhost) (ttyv0) - xauth: (argv):1: bad display name "myhostname.mysubdomain.mytld:0" in "remove" command + login: _ - Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze. +79. Log in as root. -## Workarounds -**Enable the Caps Lock Key within the GUI** +80. You will be greeted with the following message and shell prompt. + + Copyright (c) 2003-2014 The DragonFly Project. . + Copyright (c) 1992-2003 The FreeBSD Project. . + Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994 . + The Regents of the University of California. All rights reserved. . + . + DragonFly v4.0.0.32.gce3e27-RELEASE (X86_64_GENERIC) #25 Mon Nov 24 20:15:26 PS. + T 2014 . + . + Welcome to DragonFly! . + . + dfly# _ . -Edit the file /etc/X11/xorg.conf. +81. Type 'passwd' without quotes and press enter. - ee /etc/X11/xorg.conf +82. Type in a new root password and press enter and then retype the new root password and press enter again. -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. +83. Type 'ee /etc/hosts' without quotes and press enter. - Section "InputDevice" - Identifier "Keyboard0" - Driver "kbd" - #Option "XkbOptions" "ctrl:nocaps" - EndSection +84. Without quotes twice replace 'localhost.my.domain' with 'dfly.localhost'. -Observed in DragonFly BSD 3.0.2. +85. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter. -**Install Non-GUI on 3TB+ Hard Drive** +86. Type 'ee .cshrc' without quotes and press enter. -*WARNING:* This workaround includes instructions which will delete all data from a hard drive. +87. Without quotes replace 'setenv Editor vi' with 'setenv Editor ee'. -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). +88. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter. -Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases. +89. Type 'source .cshrc' without quotes and press enter. -Tested in snapshot on 8/14/2012. +90. Type 'pkg update' without quotes and press enter. + +91. The following output will be displayed. + + Updating Avalon repository catalogue... + Fetching meta.txz: 100% 264 B 0.3k/s 00:01 + Fetching digests.txz: 100% 2 MB 313.9k/s 00:06 + Fetching packagesite.txz: 100% 4 MB 579.3k/s 00:08 + Processing new repository entries: 100% + Avalon repository update completed. 21772 packages processed: + 0 updated, 0 removed and 21772 added. + +92. Type 'pkg search sudo' without quotes, press enter and note the full name of sudo. + +93. Type 'pkg search -f sudo-1.8.11.p1' without quotes and press enter. + +94. Type 'pkg install sudo' without quotes and press enter. Then when prompted, type 'y' without quotes and press enter. (If it fails to install, try typing 'pkg upgrade' without quotes and then press enter.) + +95. Type 'rehash' without quotes and press enter. + +96. Type 'visudo' without quotes and press enter. + +97. Without quotes replace '# %wheel ALL=(ALL) ALL' with ' %wheel ALL=(ALL) ALL'. + +98. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter. + +99. Type 'pw usermod user -G wheel' without quotes and press enter. + +100. Type 'exit' without quotes and press enter. + +101. Log in as user. + +102. You will be greeted with the following message and shell prompt. + + Copyright (c) 2003-2014 The DragonFly Project. . + Copyright (c) 1992-2003 The FreeBSD Project. . + Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994 . + The Regents of the University of California. All rights reserved. . + . + DragonFly v4.0.0.32.gce3e27-RELEASE (X86_64_GENERIC) #25 Mon Nov 24 20:15:26 PS. + T 2014 . + . + Welcome to DragonFly! . + . + Man pages are divided into section depending on topic. There are 9 different . + sections numbered from 1 (General Commands) to 9 (Kernel Developer's Manual). . + You can get an introduction to each topic by typing . + . + man intro . + . + In other words, to get the intro to general commands, type . + . + man 1 intro . + > _ . + +103. Type 'passwd' without quotes and press enter. + +104. Type 'ChangeMe' without quotes and press enter, then type a new password and press enter, and then retype the new password and press enter again. + +105. Type 'ee .cshrc' without quotes and press enter. + +106. Without quotes replace 'setenv Editor vi' with 'setenv Editor ee'. + +107. Press Ctrl-[ or Esc, then highlight 'a) leave editor' and press enter, then highlight 'a) save changes' and press enter. + +108. Type 'source .cshrc' without quotes and press enter. + +109. Type 'exit' without quotes and press enter. + +### Long Walkthrough of MATE Installation and Configuration + +This walkthrough describes how I install and configure the MATE desktop environment on DragonFly BSD. You should customize your installation as you see fit. This walkthrough is being run on DragonFly BSD as installed and configured in "Long Walkthrough of DragonFly BSD Installation and Configuration" by Varialus. + +MATE is my favorite desktop environment. When currently installed and configured as described in this walkthrough, MATE works but has the following issues. + +* DPorts has MATE 1.6.1 but MATE 1.8 is the current stable release. +* DPorts currently does not include the MATE meta package. +* Enabling hald prevents applications from launching via the MATE menu. +* Many non-fatal errors are logged in the /home/user and /var/log directories. +* The console-kit-daem command in the CLI program top has high CPU utilization. +* One of the post installation messages mentions devstat, but devstat is not in DPorts. + +I hope this walkthrough will make it easier for developers to properly fix these issues. + + login: user + Password: + ... + By pressing "Scroll Lock" you can use the arrow keys to scroll backward + through the console output. Press "Scroll Lock" again to turn it off. + > pkg search xorg + xorg-7.7 + ... + > pkg search -f xorg-7.7 + ... + This is a metaport for all the X.org packages available in the ports tree. + + WWW: http://www.x.org/ + > sudo pkg install xorg-7.7 + Password: + ... + The installation will require 200 MB more space + + 70 MB to be downloaded + + Proceed with installing packages [y/N]: y + ... + ================================================================================ + You installed xterm with wide chars support. This introduces some limitations + comparing to the plain single chars version: this version of xterm will use + UTF-8 charset for selection buffers, breaking 8-bit copy/paste support unless + you are using UTF-8 or ISO8859-1 locale. If you want 8-bit charset selections to + work as before, use "eightBitSelectTypes" XTerm resource setting. + + For further information refer to the SELECT/PASTE section of xterm(1) manual + page. + ================================================================================ + ... + > pkg search xdm + ... + xdm-1.1.11_2 + ... + > pkg search -f xdm-1.1.11_2 + ... + This package contains xdm, the X.Org X Display manager. + > sudo pkg install xdm-1.1.11_2 + ... + The installation will require 287 KB more space + + 97 KB to be downloaded + Proceed with installing packages [y/N]: y + ... + > pkg search mate + ... + > pkg search -x "mate-[a-z]+" + Password: + ... + The installation will require 955 MB more space + + 201 MB to be downloaded + + Proceed with installing packages [y/N]: y + ... + =============================================================================== + + In order to use the File System read/write monitor, you must chmod + /dev/devstat so that all users can open it read-only. For example: + + # chmod 0444 /dev/devstat + + In order for this to persist across reboots, add the following to + /etc/devfs.conf: + + perm devstat 0444 + + =============================================================================== + ... + Note: in order to use the script dvipdf, dvips must be installed. + This program may be provided by either print/dvips or print/dvipsk-tetex + (print/dvipsk-tetex may be preferable since it doesn't conflict with + tetex things). + + Also note that FAPIfontmap and FAPIcidfmap in /usr/local/share/ghostscript/9.06/Resource/Init + have to be configured first. + ... + ************************************************************************** + Congratulations! MATE base has been successfully installed on your system. + For help on starting it up, as well as answers to common questions, and + some known issues, please see the FreeBSD GNOME homepage at: + + http://www.FreeBSD.org/gnome/ + + ************************************************************************** + ... + > sudo ee /etc/rc.conf + ... + +*Add the following two lines.* + + hald_enable="NO" + dbus_enable="YES" + +*Press Esc or Ctl-[* + + ... + a) leave editor + ... + a) save changes + ... + > sudo ee /etc/ttys + Password: + ... + +*Find the following line.* + + ttyv8 "/usr/local/bin/xdm -nodaemon" xterm off secure + +*Edit the previous line to match the following line.* + + ttyv8 "/usr/local/bin/xdm -nodaemon" xterm on secure + +*Press Esc or Ctl-[* + + ... + a) leave editor + ... + a) save changes + ... + > sudo ee /usr/local/lib/X11/xdm/Xsetup_0 + ... + +*Find the following line.* + + xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail + +*Edit the previous line to match the following line.* + + #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail + +*If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, add the following line.* + + setxkbmap dvorak + +*Press Esc or Ctl-[* + + ... + a) leave editor + ... + a) save changes + ... + > ee .xsession + ... + +*Add the following line.* -**Install Xfce 4.6** + exec mate-session -*WARNING:* This workaround is not yet complete. Contributions are welcome. +*Press Esc or Ctl-[* -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. + ... + a) leave editor + ... + a) save changes + ... + > sudo ee /usr/local/lib/X11/xdm/xdm-config + Password: + ... -*DragonFly BSD 3.1-DEVELOPMENT Non-GUI Instructions* +*Find the following line.* -Summary + DisplayManager*authorize: true -* Install XOrg if it's not already installed. -* Ensure that mouse works. -* Get the xfce4 meta-package make file. -* Install binary files listed in xfce4 meta-package make file. +*Edit the previous line to match the following line.* -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. + DisplayManager*authorize: false -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. +*Press Esc or Ctl-[* - cd /usr/ - make pkgsrc-create - make pkgsrc-update - cd /usr/pkgsrc/meta-pkgs/xfce4 - pkgin update - pkgin in `cat Makefile | grep -E "xfce4.*mk" | sed -e 's/.include.*\/xf/xf/g' -e 's/\/.*/ /g' | tr -d "\n"` - pkg_radd modular-xorg - ls /dev/ + ... + a) leave editor + ... + a) save changes + ... + > sudo shutdown -r now + Password: + ... + Login: user + Password: + ... -Log into another console window by pressing Ctrl-Alt-F2 or in VirtualBox, Alt-F2. +The MATE desktop will be displayed. - man moused +### Short Walkthrough of Enlightenment Installation and Configuration -Scroll down until you find where it mentions mouse dev names. +This walkthrough describes how I install and configure the Enlightenment desktop environment on DragonFly BSD. You should customize your installation as you see fit. This walkthrough is being run on DragonFly BSD as installed and configured in "Long Walkthrough of DragonFly BSD Installation and Configuration" by Varialus. - ee /etc/X11/xorg.conf +Enlightenment currently has a great balance of stability, features, and performance compared to other desktop environments on DragonFly BSD. I plan on using Enlightenment for personal use until MATE on DragonFly BSD has improved significantly. When currently installed and configured as described in this walkthrough, Enlightenment works but has the following issues. -Comment out the /dev/sysmouse line by putting a # in front of it. Add the following line. +* DPorts has Enlightenment E17 0.17.5 but Enlightenment E18 0.18.8 is the current stable release. I prefer that the Enlightenment version not be updated until the current stable release works at least as well as the version currently in DPorts. +* The splash screen significantly slows down the desktop from being displayed. This walkthrough disables the splash screen but the user has to wait for it during the first login. +* The Enlightenment initial graphical configuration of keyboard layouts doesn't include the Dvorak keyboard layout. +* The System > Restart and System > Power Off menu options don't work unless the Composite module is unloaded. - Option "Device" "/dev/psm0" +I hope this walkthrough will make it easier for developers to properly fix these issues. -Except replace psm0 with whichever mouse you've got listed in /dev. Then save the file. +1. From DPorts install the following packages and their dependencies. - startxfce4 + * xorg + * xdm + * enlightenment + * e17-modules. -*DragonFly BSD 3.0.2 GUI Instructions* +2. Add the following line to /etc/rc.conf and save the change to disk. -I got the message Error Code 1 while creating and updating my pkgsrc tree. I haven't yet looked into it further. + dbus_enable="YES" -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). +3. Skim through /etc/ttys to find the following line. - cd /usr/ - make pkgsrc-create - make pkgsrc-update + ttyv8 "/usr/local/bin/xdm -nodaemon" xterm off secure -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. + Then edit the previous line to match the following line and save the change to disk. - cd /usr/ - make pkgsrc-update + ttyv8 "/usr/local/bin/xdm -nodaemon" xterm on secure -*Notes* +4. Skim through /usr/local/lib/X11/xdm/Xsetup_0 to find the following line. -* [XFCE based LiveDVD/IMG](http://leaf.dragonflybsd.org/mailarchive/users/2012-07/msg00123.html) -* [Installing a Desktop Environment: Xfce4](http://www.dragonflybsd.org/docs/how_to_get_to_the_desktop/#index11h3) -* [Desktop Environments: Xfce](http://www.dragonflybsd.org/docs/newhandbook/X/#index9h3) -* [Longest DragonFly BSD Review: Running Xfce in DragonFlyBSD 3.0.1](http://insidesocal.com/click/2012/04/review-dragonflybsd-301----the-5.html) -* [Instructions via Google Translate](http://www.google.com/translate_c?langpair=en&u=http://dragonflybsd.fr/index.php?page=Installation+de+Xfce4) -* [Installing pkgsrc](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2) + xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail - pkgin search xfce + Then edit the previous line to match the following line and save the change to disk. -**Install Xfce 4.8** + #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail -*WARNING:* This workaround is not yet complete. Contributions are welcome. +5. If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, add the following line to /usr/local/lib/X11/xdm/Xsetup_0 and save the change to disk. -* [Choosing between portability and innovation](http://lwn.net/Articles/430598/) -* [Xfce 4.8 on BSD flavors](http://gezeiten.org/post/2011/01/Xfce-4.8-on-BSD-flavors) -* [Xfce 4.8 tour](http://xfce.org/about/tour48) + setxkbmap dvorak -**Install Xfce 4.10** +6. Skim through /usr/local/lib/X11/xdm/xdm-config to find the following line. -*WARNING:* This workaround is not yet complete. Contributions are welcome. + DisplayManager*authorize: true -* [Xfce 4.10 released](http://www.xfce.org/about/news/?post=1335571200) -* [Xfce 4.10 tour](http://xfce.org/about/tour) + Then edit the previous line to match the following line and save the change to disk. -**Set the GUI Keyboard Layout** + DisplayManager*authorize: false -Edit the file /etc/X11/xorg.conf. +7. If it doesn't already exist, create the file /home/user/.xsession then add the following line to it and save the change to disk. - ee /etc/X11/xorg.conf + exec enlightenment_start -Set the XkbVariant option to your keyboard variant. +8. Set the SUID bit with execute permission on /usr/local/lib/enlightenment/utils/enlightenment_sys by running the following command. "WARNING: this program might be vulnerable so do not set suid bit if do not trust all users of this machine." - Section "InputDevice" - Identifier "Keyboard0" - Driver "kbd" - Option "XkbVariant" "dvorak" - EndSection + sudo chmod u+s /usr/local/lib/enlightenment/utils/enlightenment_sys -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. +9. Restart DragonFly BSD and log in as user. - grep --color -n -r dvorak /usr/pkg/share/X11/xkb/symbols +10. The Enlightenment initial graphical configuration will be displayed. Select the following options. -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. +* Language: English +* Keyboard: English (US) +* Profile: Computer (Standard Enlightenment) +* Sizing: 1.2 Title +* Window Focus: Click +* Updates: Enable update checking +* Taskbar: Enable Taskbar -Tested in DragonFly 3.0.2. +11. The Enlightenment desktop will be displayed but only after a significant delay from the splash screen. This step disables the splash screen so you'll only have to wait for it this one time. After the desktop is finally displayed, click on the left side of the desktop and select Settings > All > Look > Startup, then disable the option "Show Splash Screen on Login" and click OK. -**Raw** +12. If you use the Dvorak keyboard layout instead of the QWERTY keyboard layout, click on the left side of the desktop and select Settings > All > Input > Keyboard, then click Add > English (US) (us) > Variant > dvorak (English (Dvorak)) > OK > us (default, basic) > Remove > OK. -ToDo +13. Click on the left side of the screen and select either System > Reboot or System > Power Off. If DragonFly BSD does not reboot or power off, then click on the left side of the desktop and select Settings > Modules, click Look > Composite > Unload > Close. + +## Tidbits +* Shell/Console/Command-Line-Prompt: In the default shell, **tcsh**, ctrl-d is equivalent to tab-tab in **bash**, both of which display possible auto completions. If the list of possible auto completions has changed, running the command rehash will update it. Typing part of a previous command and then pressing the up key is equivalent to pressing ctrl-r and then typing part of a previous command, both of which search previously run commands. +* Package-Management: **pkg**, also known as pkgng, is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities. +* Text-Editor: **ee** is roughly equivalent to **nano**. They are both easy to use command line text editors. The exit option will ask you whether you want to save. You can get to the exit confirmation by pressing Ctrl-[ or Esc and selecting 'a) leave editor'. The console text editor vi is supposedly great, but if you're not familiar with it and some command you run opens some system file with it, it can be quite alarming. Don't panic! To exit without saving changes type ':q!' without quotes and then press enter. +* Manual: The command line program man, short for manual, is very handy for finding out information about programs, system files and more. One way to navigate man pages is by using your arrow keys. You can exit out of a manual page by pressing the letter q on your keyboard. To learn more about the man command, run the command man man which will show you the manual page for the man command. +* Power-Down: sIn DragonFly BSD the command *shutdown -p now* will shutdown and turn off your computer. Using the -h switch instead of -p will shutdown and halt the computer but not turn it off. In Debian and probably other Linux distributions, the command *shutdown -h now* will shutdown and turn off your computer. The -p switch isn't available, but there may be a way to shutdown and halt without turning off your computer. +* Find File: **grep** is great for finding text in a file and **find** is great for finding a file by name. +* Process Management: Some good commands are top, ps, pkill and kill. There are no doubt others. +* File-System: **Hammer** is hands down the best file system currently in existence. It has block level deduplication, it is supported out of the box by an operating system with great underpinnings, and it runs great on regular hardware. +* Operating System: **DragonFly BSD** is an awesome operating system for many reasons other than that it's the only OS with Hammer, but Hammer is why I'm making the switch. DragonFly's default GUI configuration is a bit rough around the edges for everyday use. But it's nothing that a little ironing can't fix. + +## Issues +* Disclaimer: I know that I should ensure that these issues are properly logged, but until that happens, hopefully these notes will be of some use to somebody. +* Installer Supported Desktops: The installer should offer various desktop environment as supported options. Observed in DragonFly 3.8.1. I'm working on various walkthroughs as a workaround. +* Early Keyboard Selection: The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.8.1. +* Encryption Keyboard Selection: The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2. +* Random Key for Encrypted Swap: When encrypting the swap partition, the installer should configure the boot loader to generate a random key each time the system is booted so that the password doesn't have to be typed twice when the system is booted. Observed in DragonFly 3.0.2. +* Stay Decrypted for Configuration: When configuring the system from the installer, if the system just finished installing with encryption, the hard drive should stay unlocked so that the user doesn't have to type in his password again. Observed in DragonFly 3.0.2. +* No Confirmation for Decryption: When configuring the system from the installer, if the system is encrypted but was not just barely installed, the user should only have to type in his password once, not twice. Observed in DragonFly 3.0.2. +* Plain Text Password in Install Log: When creating a user password in the installer, the password should not be written to a plain text installation log. Observed in DragonFly BSD 3.8.1. An adequate warning is given. +* USB Installation Media Named Uniquely: When installing from a USB device onto a USB device, the installer should ensure that installed media is named such that when booted without the USB installer, the installed device name doesn't change. Observed in DragonFly 3.0.2. +* 3TB+ HD Install: When installing onto a 3TB+ hard drive, the default partition table should be able to handle that size. Observed in DragonFly 3.0.2. Fixed and tested in snapshot on 8/14/2012. See workaround below. +* Overwrite 3TB+ Partition Table: After selecting to install using all of a 3TB+ hard drive that already has an MS-DOS/MBR partition table on it, the installer should overwrite the partition table with an adequate partition table such as GPT. Observed in snapshot on 8/14/2012. +* Wiki Centered Text: ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012. +* XOrg Quit Errors: The following errors should not occur when quitting from the GUI. + + waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0" + xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0" + failed to unset mtrr: Device not configured + + + xauth: (argv):1: bad display name "myhostname.mysubdomain.mytld:0" in "remove" command + + Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze. + +## Workarounds +**Install Non-GUI on 3TB+ Hard Drive** + +*WARNING:* This workaround includes instructions which will delete all data from a hard drive. + +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). + +Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases. + +Tested in snapshot on 8/14/2012. -Port VirtualBox to DragonFly BSD - - Build VirtualBox in GhostBSD (GhostBSD is FreeBSD with Gnome or LXDE installed out of the box.) - - Install GhostBSD (Gnome version 3.0 RC1 in VirtualBox) - - Initialize build environment: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html - - Handbook Instructions: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html - - portsnap fetch (68 MB as root) - - portsnap extract (as root) - - portsnap update (as root) - - Install Guest Additions (from FreeBSD, not from Oracle) - - Initialize build environment (See above) - - Wiki Instructions: http://wiki.freebsd.org/VirtualBox#Installing_Guest_Additions_for_FreeBSD_guests - - Handbook Instructions: http://www.freebsd.org/doc/handbook/virtualization-guest.html - - Notes: http://forums.ghostbsd.org/viewtopic.php?f=8&t=693 - - More Notes: http://forums.freebsd.org/showthread.php?t=29172 - - Create a supfile. - - ee /root/9rel-supfile (as root) - - Firefox http://forums.freebsd.org/showthread.php?t=29172 - - Copy and paste supfile. - - Firefox http://www.freebsd.org/doc/en/books/handbook/cvsup.html#CVSUP-MIRRORS - - Pick close server and change line *default host=CHANGE_THIS.FreeBSD.org - - Optionally pick fastest server: http://www.freshports.org/sysutils/fastest_cvsup -*default host=CHANGE_THIS.FreeBSD.org -*default base=/var/db -*default prefix=/usr -*default release=cvs tag=RELENG_9_1 -*default delete use-rel-suffix -*default compress -src-all - - Ctrl-[ - - a) leave editor - - a) save changes - - csup 9rel-supfile (as root probably while in /root/) - - cd /usr/ports/emulators/virtualbox-ose-additions && make install clean (probably as root) - - Build VirtualBox - - Initialize build environment (See above) - - Build Guest Additions - - Build VirtualBox in DragonFly BSD - - Install DragonFly BSD (Xfce IMG/ISO Installer) - - Build VirtualBox - - Install VirtualBox - - Test VirtualBox - - Build Guest Additions - - Install Guest Additions - - Test Guest Additions - - Package for pkgsrc - - Upload to pkgsrc - -Port Xfce 4.10 to DragonFly BSD - - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox) - - Build Instructions: http://docs.xfce.org/xfce/building - - Package for pkgsrc - - Upload to pkgsrc - -Use DragonFly BSD as a Storage Appliance - - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox) - -Port bxpkg to DragonFly BSD - - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox) +## Contribute +**Port VirtualBox to DragonFly BSD** + + - Build VirtualBox in FreeBSD + - Install FreeBSD + - Compile VirtualBox + - Compile Guest Additions + - Build VirtualBox in DragonFly BSD + - Install DragonFly BSD (Xfce IMG/ISO Installer) + - Compile VirtualBox + - Install VirtualBox + - Test VirtualBox + - Compile Guest Additions + - Install Guest Additions + - Test Guest Additions + - Package for DPorts + - Upload to DPorts + +**Update and Fix Bugs of Desktop Environments in DPorts** + + - Install DragonFly BSD + - Compile Updated Desktop Environments + - Install Updated Desktop Environments + - Test, Log Bugs, and Fix Bugs in Updated Desktop Environments + - Package for DPorts + - Upload to DPorts + +**DragonFly BSD Network Shares Walkthrough** + + - Install DragonFly BSD + - Figure out network shares and write a walkthrough.