Wrote most of installation walk through with manually copied ascii art and ascii...
[ikiwiki.git] / varialus / index.mdwn
CommitLineData
f66ddf87 1# et
ed370e87 2# Anisoptera
e04d20e7 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.*
5e91eec6 4
5## Featured
6
7**Install Xfce 4.6 via Custom Xfce based DVD/IMG Installer**
8
66660ae6 9There 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!
10
111. Download and extract the [Xfce installer](http://island.quantumachine.net/~swildner/LiveDVD/).
122. If the version of the installer is less than or equal to 20120826-2055, then installing onto a uniprocessor computer may not work.
133. If installng onto a VirtualBox virtual machine, the recommended operating system type is FreeBSD (64 bit).
144. If installing onto a VirtualBox virtual machine, set the hardware clock to UTC time.
155. After starting the computer but before it finishes booting, you will be greeted with the following boot menu.
16
17
18 DragonFly/i386 bootstrap loader, Revision 1.1
19 (s@advancer.yo, Sun Aug 26 21:24:11 CEST 2012)
20 |
21 1. Boot DragonFly [kernel] | ,--, | ,--,
22 2. Boot DragonFly in Safe Mode | | `-, ,^, ,-' |
23 3. Boot DragonFly without AHCI driver | `, `-, (/ \) ,-' ,'
24 4. Boot DragonFly without ACPI driver | `-, `-,/ \,-' ,-'
25 9. Escape to loader prompt (also ESC) | `------( )------'
26 s. Boot DragonFly in single user mode | ,----------( )----------,
27 v. Boot DragonFly with verbose logging | | _,-( )-,_ |
28 R. Reboot | `-,__,-' \ / `-,__,-'
29 | | |
30 | | |
31 | | |
32 | | |
33 | | |
34 | | |
35 | `|'
36 |
37 Booting in 10 seconds... _
38
396. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
40
41 Welcome to DragonFly!
42
43 To Start the installer, login as 'installer'. To just get a shell prompt,
44 login as 'root'. To start a root gui, login as 'root' and run 'startx'.
45
46 DragonFly/x86_64 (dflyd.yo) (ttyv0)
47
48 login: _
49
507. Type 'installer' without quotes and press enter.
518. You will be greeted with the following menu.
52
53 F10=Refresh Display .
54 .
55 ,--, | ,--, .
56 ------------------------| Welcome to DragonFly BSD |------------------------- .
57 | |.
58 | Welcome to the DragonFly BSD Live CD. |.
59 | |.
60 | DragonFly BSD is an efficient and elegant BSD Unix-derived operating |.
61 | system. For more information, see http://www.dragonflybsd.org |.
62 | |.
63 | From this CD, you can boot into DragonFly BSD ``live'' (without installing |.
64 | it) to evaluate it, to install it manually, or to troubleshoot problems |.
65 | with an existing installation, using either a command prompt or menu-driven |.
66 | utilities. |.
67 | |.
68 | Also, you can use this automated application to assist you in installing |.
69 | DragonFly BSD on this computer and configuring it once it is installed. |.
70 | |.
71 | < Install DragonFly BSD >_ < Configure an Installed System > |.
72 | < Live CD Utilities > < Exit to Live CD > < Reboot this Computer > |.
73 | < Setup NetBoot Install Services > |.
74 ----------------------------------------------------------------------------- .
75 .
76 .
77 Install DragonFly BSD on a HDD or HDD partition on this computer .
78
7910. The bottom line changes depending on which option is selected.
8011. Highlight the option < Install DragonFly BSD > and press enter.
8112. You will then be greeted by the following menu.
82
83 F10=Refresh Display .
84 .
85 ,--, | ,--, .
86 | `-, ,^, ,-' | .
87 `, `-, (/ \) ,-' ,' .
88 --------------------------| Begin Installation |----------------------------- .
89 | |.
90 | This application will install DragonFly BSD on one of the hard disk drives |.
91 | attached to this computer. It has been designed to make it easy to install |.
92 | DragonFly BSD in the typical case. If you have special requirements that |.
93 | are not addressed by this installer, or if you have problems using it, you |.
94 | are welcome to install DragonFly BSD manually. To do so select Exit to Live |.
95 | CD, login as root, and follow the instructions given in the file /README . |.
96 | |.
97 | NOTE! As with any installation process, YOU ARE STRONGLY ENCOURAGED TO BACK |.
98 | UP ANY IMPORTANT DATA ON THIS COMPUTER BEFORE PROCEEDING! |.
99 | |.
100 | < Install DragonFly BSD >_ < Return to Welcome Menu > < Exit to Live CD > |.
101 ----------------------------| Press F1 for Help |---------------------------- .
102 .
103 .
104 .
105 .
106 .
107 .
108 .
109
11013. Highlight the option < Install DragonFly BSD > and press enter.
11114. The following menu, specific to your hardware, will be displayed.
112
113 F10=Refresh Display .
114 .
115 ,--, | ,--, .
116 | `-, ,^, ,-' | .
117 `, `-, (/ \) ,-' ,' .
118 `-, `-,/ \,-' ,-' .
119 `------( )------' .
120 ,----------( )----------, .
121 | _,-( )-,_ | .
122 ----------------------| Select Disk |----------------------,__,-' .
123 | | .
124 | Select a disk on which to install DragonFly BSD | .
125 | | .
126 | < ad1: 1337TB <VBOX HARDDISK 1.0> at ata0-master UDMA33 >_| .
127 | < Return to Begin Installation > | .
128 ----------------------------------------------------------- .
129 `|' .
130 .
131 .
132 .
133 .
134 .
135 .
136 .
137 .
138
13915. Highlight the disk on which to install DragonFly BSD and press Enter.
14016. The following menu will be displayed.
141
142 F10=Refresh Display .
143 .
144 ,--, | ,--, .
145 | `-, ,^, ,-' | .
146 `, `-, (/ \) ,-' ,' .
147 `-, `-,/ \,-' ,-' .
148 `------( )------' .
149 ,----------( )----------, .
150 ----------------------------| Select Disk |---------------------- | .
151 | |' .
152 | Select how much of this disk you want to use for DragonFly BSD | .
153 | | .
154 | ad1: 1337TB <VBOX HARDDISK 1.0> at ata0-master UDMA33 | .
155 | | .
156 | < Use Entire Disk >_ < Use Part of Disk > | .
157 | < Return to Select Disk > | .
158 ----------------------------------------------------------------- .
159 .
160 .
161 .
162 .
163 .
164 .
165 .
166 .
167
16817. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter.
16918. The following menu will be displayed.
170
171 F10=Refresh Display .
172 .
173 ,--, | ,--, .
174 | `-, ,^, ,-' | .
175 ------| Are you absolutely sure? |------/ \) ,-' ,' .
176 | | \,-' ,-' .
177 | WARNING! ALL data in ALL partitions on | )------' .
178 | the disk | )----------, .
179 | | )-,_ | .
180 | ad1: 1337TB <VBOX HARDDISK 1.0> at | / `-,__,-' .
181 | ata0-master UDMA33 | | .
182 | | | .
183 | will be IRREVOCABLY ERASED! | | .
184 | | | .
185 | Are you ABSOLUTELY SURE you wish to | | .
186 | take this action? This is your LAST | | .
187 | CHANCE to cancel! ||' .
188 | | .
189 | < OK >_ < Cancel > | .
190 ---------------------------------------- .
191 .
192 .
193 .
194 .
195 .
196
19719. If you are absolutely sure, highlight < OK > and press enter.
19820. The following menu will be displayed.
199
200 F10=Refresh Display .
201 .
202 ,--, | ,--, .
203 | `-, ,^, ,-' | .
204 `, `-, (/ \) ,-' ,' .
205 `-, `-,/ \,-' ,-' .
206 `------( )------' .
207 ---------| Information |-------------( )----------, .
208 | |( )-,_ | .
209 | The disk |\ / `-,__,-' .
210 | | | | .
211 | ad1: 1337TB <VBOX HARDDISK 1.0> at | | | .
212 | ata0-master UDMA33 | | | .
213 | | | | .
214 | was formatted. | | | .
215 | | | | .
216 | < OK > | `|' .
217 ------------------------------------ .
218 .
219 .
220 .
221 .
222 .
223 .
224 .
225
22621. Press enter.
22722. The following menu will be displayed.
228
229 F10=Refresh Display .
230 .
231 ,--, | ,--, .
232 | `-, ,^, ,-' | .
233 `, `-, (/ \) ,-' ,' .
234 `-, `-,/ \,-' ,-' .
235 `------( )------' .
236 -----------------| Select file system |------------------------, .
237 | | | .
238 | Please select the file system you want to use with |,__,-' .
239 | DragonFly BSD. | .
240 | | .
241 | HAMMER is the new DragonFly BSD file system. UFS is the | .
242 | traditional BSD file system. | .
243 | | .
244 | < Use HAMMER >_ < Use UFS > < Return to Select Disk > | .
245 --------------------------------------------------------- .
246 .
247 .
248 .
249 .
250 .
251 .
252 .
253 .
254
25523. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter.
25624. The following menu will be displayed.
257
258 F10=Refresh Display .
259 .
260 ,--, | ,--, .
261 --------------------| Create Subpartitions |--------------------- | .
262 | | ,' .
263 | Set up the partitions (also knows as just `partitions' in |' .
264 | BSD tradition) you want to have on this primary partition. In | .
265 | most cases you should be fine with the default settings. |-, .
266 | | | .
267 | For Capacity, use 'M' to indicate megabytes, 'G' to indicate |-' .
268 | gigabytes, or a single '*' to indicate 'use the remaining space | .
269 | on the primary partition'. | .
270 | | .
271 | Mountpoint Capacity Encrypted | .
272 | [/boot_ ] [768M ] [ ] < Ins > < Del > | .
273 | [swap ] [2048M ] [ ] < Ins > < Del > | .
274 | [/ ] [* ] [ ] < Ins > < Del > | .
275 | < Add > | .
276 | | .
277 | < Accept and Create > < Return to Select Disk > | .
278 -------------------| Press F1 for Help |------------------------- .
279 .
280 .
281 .
282 .
283
28425. Highlight < Accept and Create > and press enter.
28526. The following menu will be displayed.
286
287 F10=Refresh Display .
288 .
289 ,--, | ,--, .
290 | `-, ,^, ,-' | .
291 `, `-, (/ \) ,-' ,' .
292 `-, `-,/ \,-' ,-' .
293 -------------------------| Install OS |-------------------------- .
294 | |-, .
295 | Everything is now ready to install the actual files which | | .
296 | comprise the DragonFly BSD operating system on the selected |-' .
297 | partition of the selected disk. | .
298 | | .
299 | Note that this process will take quite a while to finish. You | .
300 | may wish to take a break now and come back to the computer in a | .
301 | short while. | .
302 | | .
303 | < Begin Installing Files >_ < Return to Create Subpartitions > | .
304 ----------------------------------------------------------------- .
305 .
306 .
307 .
308 .
309 .
310 .
311 .
312 .
313
31427. Highlight < Begin Installing Files > and press enter.
31528. The following progress bar will be displayed.
316
317 F10=Refresh Display .
318 .
319 ,--, | ,--, .
320 | `-, ,^, ,-' | .
321 `, `-, (/ \) ,-' ,' .
322 `-, `-,/ \,-' ,-' .
323 `------( )------' .
324 ,----------( )----------, .
325 -------------------| Executing Commands |------------------- | .
326 | |_,-' .
327 | /bin/cpdup -o -vvv -u /usr/pkg /mnt/usr/pkg | .
328 | | .
329 | [*#################58%# ] | .
330 | | .
331 | < Cancel >_ | .
332 ------------------------------------------------------------ .
333 `|' .
334 .
335 .
336 .
337 .
338 .
339 .
340 .
341 .
342
34329. Go brush your teeth. And don't forget to floss.
34430. When it finishes, the following menu will be displayed.
345
346 F10=Refresh Display .
347 .
348 ,--, | ,--, .
349 | `-, ,^, ,-' | .
350 ---------------| Install Bootblock(s) |----------------,-' ,' .
351 | | ,-' .
352 | You may now wish to install bootblocks on one or more |--' .
353 | disks. If you already have a boot manager installed, |------, .
354 | you can skip this step (but you may have to configure | | .
355 | your boot manager separately.) If you installed |-,__,-' .
356 | DragonFly BSD on a disk other than your first disk, | .
357 | you will need to put the bootblock on at least your | .
358 | first disk and the DragonFly disk. | .
359 | | .
360 | Disk Drive Install Bootblock? Packet Mode? | .
361 | [ad1_ ] [X] [X] | .
362 | | .
363 | < Accept and Install Bootblocks > | .
364 | < Skip this Step > | .
365 -----------------| Press F1 for Help |----------------- .
366 .
367 .
368 .
369 .
370 The disk on which you wish to install a bootblock .
371
37231. Highlight < Accept and Install Bootblocks > and press enter.
37332. An Information dialog box will be displayed which says: Bootblocks were successfully installed!
37433. Press enter.
37534. The following menu will be displayed.
376
377 ---| DragonFly BSD is Installed! |--
378 |
379 | Congratulations!
380 |
381 | DragonFly BSD has successfully been installed on this computer.
382 | You may now proceed to configure the installation. Alternately,
383 | you may wish to reboot the computer and boot into the installed
384 | system to confirm that it works.
385 |
386 | < Configure this System >_ < Reboot >
387 | < Return to Welcome Menu >
388 ---
5e91eec6 389
390## Tidbits
c73a5f26 391* **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.
392* **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.
8df94b7a 393* **[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/).
12e7194b 394* **[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.
395* **[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.
396* **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'.
397* **pkgin** is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities.
248bec77 398
5e91eec6 399## Reminders
c73a5f26 400* 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.
65e00ca1 401* 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.
c73a5f26 402
5e91eec6 403## Issues
b5491331 404* 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.
8df94b7a 405* The installer should offer the Xfce desktop environment as a supported option. Observed in DragonFly 3.0.2. See workaround below.
74c82ddf 406* The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.0.2.
c1758fdf 407* The installer should set the keyboard layout for the GUI. Observed in DragonFly 3.0.2. See workaround below.
dabfe801 408* The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2.
c1758fdf 409* 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.
74c82ddf 410* 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.
411* 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.
412* 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.
2085015f 413* 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.
74c82ddf 414* 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.
c1758fdf 415* 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.
74c82ddf 416* 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.
dabfe801 417* 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.
74c82ddf 418* ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012.
12e7194b 419* The following errors should not occur when quitting from the GUI.
420
421 waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0"
422 xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0"
423 failed to unset mtrr: Device not configured
424
425
426 xauth: (argv):1: bad display name "myhostname.mysubdomain.mytld:0" in "remove" command
427
428 Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze.
a7b44ded 429
5e91eec6 430## Workarounds
c1758fdf 431**Enable the Caps Lock Key within the GUI**
432
433Edit the file /etc/X11/xorg.conf.
434
435 ee /etc/X11/xorg.conf
436
437Delete 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.
438
439 Section "InputDevice"
440 Identifier "Keyboard0"
441 Driver "kbd"
442 #Option "XkbOptions" "ctrl:nocaps"
443 EndSection
444
c73a5f26 445Observed in DragonFly BSD 3.0.2.
446
c1758fdf 447**Install Non-GUI on 3TB+ Hard Drive**
448
449*WARNING:* This workaround includes instructions which will delete all data from a hard drive.
450
451Delete 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).
452
453Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases.
454
455Tested in snapshot on 8/14/2012.
456
f378b134 457**Install Xfce 4.6**
458
459*WARNING:* This workaround is not yet complete. Contributions are welcome.
460
2085015f 461The following testing is being done with a root account and no user account. Additional testing with a regular user account will be done later.
462
463*DragonFly BSD 3.1-DEVELOPMENT Non-GUI Instructions*
464
5cde5737 465Summary
466
467* Install XOrg if it's not already installed.
468* Ensure that mouse works.
469* Get the xfce4 meta-package make file.
470* Install binary files listed in xfce4 meta-package make file.
471
472These 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.
473
6216ff22 474Get 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.
2085015f 475
476 cd /usr/
477 make pkgsrc-create
478 make pkgsrc-update
6216ff22 479 cd /usr/pkgsrc/meta-pkgs/xfce4
480 pkgin update
5cde5737 481 pkgin in `cat Makefile | grep -E "xfce4.*mk" | sed -e 's/.include.*\/xf/xf/g' -e 's/\/.*/ /g' | tr -d "\n"`
6216ff22 482 pkg_radd modular-xorg
483 ls /dev/
484
485Log into another console window by pressing Ctrl-Alt-F2 or in VirtualBox, Alt-F2.
486
487 man moused
488
489Scroll down until you find where it mentions mouse dev names.
490
491 ee /etc/X11/xorg.conf
492
493Comment out the /dev/sysmouse line by putting a # in front of it. Add the following line.
494
495 Option "Device" "/dev/psm0"
496
497Except replace psm0 with whichever mouse you've got listed in /dev. Then save the file.
498
499 startxfce4
2085015f 500
501*DragonFly BSD 3.0.2 GUI Instructions*
502
503I got the message Error Code 1 while creating and updating my pkgsrc tree. I haven't yet looked into it further.
504
505Get 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).
506
507 cd /usr/
508 make pkgsrc-create
509 make pkgsrc-update
510
511Get 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.
512
513 cd /usr/
514 make pkgsrc-update
515
516*Notes*
f378b134 517
9ddcfc4c 518* [XFCE based LiveDVD/IMG](http://leaf.dragonflybsd.org/mailarchive/users/2012-07/msg00123.html)
519* [Installing a Desktop Environment: Xfce4](http://www.dragonflybsd.org/docs/how_to_get_to_the_desktop/#index11h3)
520* [Desktop Environments: Xfce](http://www.dragonflybsd.org/docs/newhandbook/X/#index9h3)
521* [Longest DragonFly BSD Review: Running Xfce in DragonFlyBSD 3.0.1](http://insidesocal.com/click/2012/04/review-dragonflybsd-301----the-5.html)
f378b134 522* [Instructions via Google Translate](http://www.google.com/translate_c?langpair=en&u=http://dragonflybsd.fr/index.php?page=Installation+de+Xfce4)
523* [Installing pkgsrc](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2)
524
2085015f 525 pkgin search xfce
526
f378b134 527**Install Xfce 4.8**
528
529*WARNING:* This workaround is not yet complete. Contributions are welcome.
530
531* [Choosing between portability and innovation](http://lwn.net/Articles/430598/)
532* [Xfce 4.8 on BSD flavors](http://gezeiten.org/post/2011/01/Xfce-4.8-on-BSD-flavors)
533* [Xfce 4.8 tour](http://xfce.org/about/tour48)
534
9ddcfc4c 535**Install Xfce 4.10**
536
537*WARNING:* This workaround is not yet complete. Contributions are welcome.
538
539* [Xfce 4.10 released](http://www.xfce.org/about/news/?post=1335571200)
540* [Xfce 4.10 tour](http://xfce.org/about/tour)
541
a7b44ded 542**Set the GUI Keyboard Layout**
543
544Edit the file /etc/X11/xorg.conf.
545
546 ee /etc/X11/xorg.conf
547
548Set the XkbVariant option to your keyboard variant.
549
550 Section "InputDevice"
551 Identifier "Keyboard0"
552 Driver "kbd"
553 Option "XkbVariant" "dvorak"
554 EndSection
555
556Valid 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.
557
558 grep --color -n -r dvorak /usr/pkg/share/X11/xkb/symbols
559
560If 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.
561
74c82ddf 562Tested in DragonFly 3.0.2.