Started Project HAMMER Debian
[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
c2c5c660 5## Table of Contents
6
71. **Featured**
8
0befd86f 9* Walkthrough of Xfce 4.6 Installation via Custom DVD/IMG Installer
c2c5c660 10
112. **Tidbits**
12
52ea7cc8 13* Shell/Console/Command-Line-Prompt: tcsh/bash, ctrl-d/tab-tab, partial-previous-command-up-key/ctrl-r-partial-previous-command, rehash
14* Package-Management: pkgin/apt-get
15* Administration/root su/sudo/wheel
16* Text-Editor: vi :q!
17* Manual: man man
18* Networking: hosts
19* Power-Down: shutdown -p now
20* File-System: Hammer
21* Operating System: DragonFly BSD
22* Graphical-User-Interface: Xfce
23* Programming: Dissonance/Apache Harmony
24* Programming: Jython/Python
25* Text-Editor: ee/nano
26* Networking: Debian resolv.conf
27
283. **Issues**
c2c5c660 29
30* Disclaimer
31* Default GUI Too Bare
32* Early Keyboard Selection
33* GUI Keyboard Selection
34* Encryption Keyboard Selection
35* Disabled Caps Lock in GUI
36* Random Key for Encrypted Swap
37* Stay Decrypted for Configuration
38* No Confirmation for Decryption
39* Plain Text Password in Install Log
40* USB Installation Media Named Uniquely
41* 3TB+ HD Install
42* Overwrite 3TB+ Partition Table
43* Lackluster Default Shell
44* Wiki Centered Text
45* XOrg Quit Errors
46
52ea7cc8 474. **Workarounds**
c2c5c660 48
49* Enable Caps Lock in GUI
50* Install Non-GUI on 3TB+ Hard Drive
51* Install Xfce 4.6 (Notes)
52* Install Xfce 4.8 (Stub)
53* Install Xfce 4.10 (Stub)
54* Set GUI Keyboard Layout
55
b1839790 565. **Contribute**
6848ea64 57
b1839790 58* Port VirtualBox to DragonFly BSD
59* Port Xfce 4.10 to DragonFly BSD
60* DragonFly BSD Network Shares Walkthrough
61* Port bxpkg to DragonFly BSD
6848ea64 62
e54b47aa 636. **Not Yet Formatted Text Dump**
64
65* Project HAMMER Debian
66
5e91eec6 67## Featured
68
c2c5c660 69**Walkthrough of Xfce 4.6 Installation via Custom DVD/IMG Installer**
5e91eec6 70
66660ae6 71There 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!
72
731. Download and extract the [Xfce installer](http://island.quantumachine.net/~swildner/LiveDVD/).
742. If the version of the installer is less than or equal to 20120826-2055, then installing onto a uniprocessor computer may not work.
753. If installng onto a VirtualBox virtual machine, the recommended operating system type is FreeBSD (64 bit).
764. If installing onto a VirtualBox virtual machine, set the hardware clock to UTC time.
775. After starting the computer but before it finishes booting, you will be greeted with the following boot menu.
78
79
80 DragonFly/i386 bootstrap loader, Revision 1.1
81 (s@advancer.yo, Sun Aug 26 21:24:11 CEST 2012)
82 |
83 1. Boot DragonFly [kernel] | ,--, | ,--,
84 2. Boot DragonFly in Safe Mode | | `-, ,^, ,-' |
85 3. Boot DragonFly without AHCI driver | `, `-, (/ \) ,-' ,'
86 4. Boot DragonFly without ACPI driver | `-, `-,/ \,-' ,-'
87 9. Escape to loader prompt (also ESC) | `------( )------'
88 s. Boot DragonFly in single user mode | ,----------( )----------,
89 v. Boot DragonFly with verbose logging | | _,-( )-,_ |
90 R. Reboot | `-,__,-' \ / `-,__,-'
91 | | |
92 | | |
93 | | |
94 | | |
95 | | |
96 | | |
97 | `|'
98 |
99 Booting in 10 seconds... _
100
1016. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
102
103 Welcome to DragonFly!
104
105 To Start the installer, login as 'installer'. To just get a shell prompt,
106 login as 'root'. To start a root gui, login as 'root' and run 'startx'.
107
108 DragonFly/x86_64 (dflyd.yo) (ttyv0)
109
110 login: _
111
1127. Type 'installer' without quotes and press enter.
1138. You will be greeted with the following menu.
114
115 F10=Refresh Display .
116 .
117 ,--, | ,--, .
118 ------------------------| Welcome to DragonFly BSD |------------------------- .
119 | |.
120 | Welcome to the DragonFly BSD Live CD. |.
121 | |.
122 | DragonFly BSD is an efficient and elegant BSD Unix-derived operating |.
123 | system. For more information, see http://www.dragonflybsd.org |.
124 | |.
125 | From this CD, you can boot into DragonFly BSD ``live'' (without installing |.
126 | it) to evaluate it, to install it manually, or to troubleshoot problems |.
127 | with an existing installation, using either a command prompt or menu-driven |.
128 | utilities. |.
129 | |.
130 | Also, you can use this automated application to assist you in installing |.
131 | DragonFly BSD on this computer and configuring it once it is installed. |.
132 | |.
133 | < Install DragonFly BSD >_ < Configure an Installed System > |.
134 | < Live CD Utilities > < Exit to Live CD > < Reboot this Computer > |.
135 | < Setup NetBoot Install Services > |.
136 ----------------------------------------------------------------------------- .
137 .
138 .
139 Install DragonFly BSD on a HDD or HDD partition on this computer .
140
14110. The bottom line changes depending on which option is selected.
14211. Highlight the option < Install DragonFly BSD > and press enter.
14312. You will then be greeted by the following menu.
144
145 F10=Refresh Display .
146 .
147 ,--, | ,--, .
148 | `-, ,^, ,-' | .
149 `, `-, (/ \) ,-' ,' .
150 --------------------------| Begin Installation |----------------------------- .
151 | |.
152 | This application will install DragonFly BSD on one of the hard disk drives |.
153 | attached to this computer. It has been designed to make it easy to install |.
154 | DragonFly BSD in the typical case. If you have special requirements that |.
155 | are not addressed by this installer, or if you have problems using it, you |.
156 | are welcome to install DragonFly BSD manually. To do so select Exit to Live |.
157 | CD, login as root, and follow the instructions given in the file /README . |.
158 | |.
159 | NOTE! As with any installation process, YOU ARE STRONGLY ENCOURAGED TO BACK |.
160 | UP ANY IMPORTANT DATA ON THIS COMPUTER BEFORE PROCEEDING! |.
161 | |.
162 | < Install DragonFly BSD >_ < Return to Welcome Menu > < Exit to Live CD > |.
163 ----------------------------| Press F1 for Help |---------------------------- .
164 .
165 .
166 .
167 .
168 .
169 .
170 .
171
17213. Highlight the option < Install DragonFly BSD > and press enter.
17314. The following menu, specific to your hardware, will be displayed.
174
175 F10=Refresh Display .
176 .
177 ,--, | ,--, .
178 | `-, ,^, ,-' | .
179 `, `-, (/ \) ,-' ,' .
180 `-, `-,/ \,-' ,-' .
181 `------( )------' .
182 ,----------( )----------, .
183 | _,-( )-,_ | .
184 ----------------------| Select Disk |----------------------,__,-' .
185 | | .
186 | Select a disk on which to install DragonFly BSD | .
187 | | .
188 | < ad1: 1337TB <VBOX HARDDISK 1.0> at ata0-master UDMA33 >_| .
189 | < Return to Begin Installation > | .
190 ----------------------------------------------------------- .
191 `|' .
192 .
193 .
194 .
195 .
196 .
197 .
198 .
199 .
200
20115. Highlight the disk on which to install DragonFly BSD and press Enter.
20216. The following menu will be displayed.
203
204 F10=Refresh Display .
205 .
206 ,--, | ,--, .
207 | `-, ,^, ,-' | .
208 `, `-, (/ \) ,-' ,' .
209 `-, `-,/ \,-' ,-' .
210 `------( )------' .
211 ,----------( )----------, .
212 ----------------------------| Select Disk |---------------------- | .
213 | |' .
214 | Select how much of this disk you want to use for DragonFly BSD | .
215 | | .
216 | ad1: 1337TB <VBOX HARDDISK 1.0> at ata0-master UDMA33 | .
217 | | .
218 | < Use Entire Disk >_ < Use Part of Disk > | .
219 | < Return to Select Disk > | .
220 ----------------------------------------------------------------- .
221 .
222 .
223 .
224 .
225 .
226 .
227 .
228 .
229
23017. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter.
23118. The following menu will be displayed.
232
233 F10=Refresh Display .
234 .
235 ,--, | ,--, .
236 | `-, ,^, ,-' | .
237 ------| Are you absolutely sure? |------/ \) ,-' ,' .
238 | | \,-' ,-' .
239 | WARNING! ALL data in ALL partitions on | )------' .
240 | the disk | )----------, .
241 | | )-,_ | .
242 | ad1: 1337TB <VBOX HARDDISK 1.0> at | / `-,__,-' .
243 | ata0-master UDMA33 | | .
244 | | | .
245 | will be IRREVOCABLY ERASED! | | .
246 | | | .
247 | Are you ABSOLUTELY SURE you wish to | | .
248 | take this action? This is your LAST | | .
249 | CHANCE to cancel! ||' .
250 | | .
251 | < OK >_ < Cancel > | .
252 ---------------------------------------- .
253 .
254 .
255 .
256 .
257 .
258
25919. If you are absolutely sure, highlight < OK > and press enter.
26020. The following menu will be displayed.
261
262 F10=Refresh Display .
263 .
264 ,--, | ,--, .
265 | `-, ,^, ,-' | .
266 `, `-, (/ \) ,-' ,' .
267 `-, `-,/ \,-' ,-' .
268 `------( )------' .
269 ---------| Information |-------------( )----------, .
270 | |( )-,_ | .
271 | The disk |\ / `-,__,-' .
272 | | | | .
273 | ad1: 1337TB <VBOX HARDDISK 1.0> at | | | .
274 | ata0-master UDMA33 | | | .
275 | | | | .
276 | was formatted. | | | .
277 | | | | .
278 | < OK > | `|' .
279 ------------------------------------ .
280 .
281 .
282 .
283 .
284 .
285 .
286 .
287
28821. Press enter.
28922. The following menu will be displayed.
290
291 F10=Refresh Display .
292 .
293 ,--, | ,--, .
294 | `-, ,^, ,-' | .
295 `, `-, (/ \) ,-' ,' .
296 `-, `-,/ \,-' ,-' .
297 `------( )------' .
298 -----------------| Select file system |------------------------, .
299 | | | .
300 | Please select the file system you want to use with |,__,-' .
301 | DragonFly BSD. | .
302 | | .
303 | HAMMER is the new DragonFly BSD file system. UFS is the | .
304 | traditional BSD file system. | .
305 | | .
306 | < Use HAMMER >_ < Use UFS > < Return to Select Disk > | .
307 --------------------------------------------------------- .
308 .
309 .
310 .
311 .
312 .
313 .
314 .
315 .
316
31723. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter.
31824. The following menu will be displayed.
319
320 F10=Refresh Display .
321 .
322 ,--, | ,--, .
323 --------------------| Create Subpartitions |--------------------- | .
324 | | ,' .
325 | Set up the partitions (also knows as just `partitions' in |' .
326 | BSD tradition) you want to have on this primary partition. In | .
327 | most cases you should be fine with the default settings. |-, .
328 | | | .
329 | For Capacity, use 'M' to indicate megabytes, 'G' to indicate |-' .
330 | gigabytes, or a single '*' to indicate 'use the remaining space | .
331 | on the primary partition'. | .
332 | | .
333 | Mountpoint Capacity Encrypted | .
334 | [/boot_ ] [768M ] [ ] < Ins > < Del > | .
335 | [swap ] [2048M ] [ ] < Ins > < Del > | .
336 | [/ ] [* ] [ ] < Ins > < Del > | .
337 | < Add > | .
338 | | .
339 | < Accept and Create > < Return to Select Disk > | .
340 -------------------| Press F1 for Help |------------------------- .
341 .
342 .
343 .
344 .
345
34625. Highlight < Accept and Create > and press enter.
34726. The following menu will be displayed.
348
349 F10=Refresh Display .
350 .
351 ,--, | ,--, .
352 | `-, ,^, ,-' | .
353 `, `-, (/ \) ,-' ,' .
354 `-, `-,/ \,-' ,-' .
355 -------------------------| Install OS |-------------------------- .
356 | |-, .
357 | Everything is now ready to install the actual files which | | .
358 | comprise the DragonFly BSD operating system on the selected |-' .
359 | partition of the selected disk. | .
360 | | .
361 | Note that this process will take quite a while to finish. You | .
362 | may wish to take a break now and come back to the computer in a | .
363 | short while. | .
364 | | .
365 | < Begin Installing Files >_ < Return to Create Subpartitions > | .
366 ----------------------------------------------------------------- .
367 .
368 .
369 .
370 .
371 .
372 .
373 .
374 .
375
37627. Highlight < Begin Installing Files > and press enter.
37728. The following progress bar will be displayed.
378
379 F10=Refresh Display .
380 .
381 ,--, | ,--, .
382 | `-, ,^, ,-' | .
383 `, `-, (/ \) ,-' ,' .
384 `-, `-,/ \,-' ,-' .
385 `------( )------' .
386 ,----------( )----------, .
387 -------------------| Executing Commands |------------------- | .
388 | |_,-' .
389 | /bin/cpdup -o -vvv -u /usr/pkg /mnt/usr/pkg | .
390 | | .
391 | [*#################58%# ] | .
392 | | .
393 | < Cancel >_ | .
394 ------------------------------------------------------------ .
395 `|' .
396 .
397 .
398 .
399 .
400 .
401 .
402 .
403 .
404
40529. Go brush your teeth. And don't forget to floss.
40630. When it finishes, the following menu will be displayed.
407
408 F10=Refresh Display .
409 .
410 ,--, | ,--, .
411 | `-, ,^, ,-' | .
412 ---------------| Install Bootblock(s) |----------------,-' ,' .
413 | | ,-' .
414 | You may now wish to install bootblocks on one or more |--' .
415 | disks. If you already have a boot manager installed, |------, .
416 | you can skip this step (but you may have to configure | | .
417 | your boot manager separately.) If you installed |-,__,-' .
418 | DragonFly BSD on a disk other than your first disk, | .
419 | you will need to put the bootblock on at least your | .
420 | first disk and the DragonFly disk. | .
421 | | .
422 | Disk Drive Install Bootblock? Packet Mode? | .
423 | [ad1_ ] [X] [X] | .
424 | | .
425 | < Accept and Install Bootblocks > | .
426 | < Skip this Step > | .
427 -----------------| Press F1 for Help |----------------- .
428 .
429 .
430 .
431 .
432 The disk on which you wish to install a bootblock .
433
43431. Highlight < Accept and Install Bootblocks > and press enter.
43532. An Information dialog box will be displayed which says: Bootblocks were successfully installed!
43633. Press enter.
43734. The following menu will be displayed.
438
439 ---| DragonFly BSD is Installed! |--
440 |
441 | Congratulations!
0befd86f 442 |
66660ae6 443 | DragonFly BSD has successfully been installed on this computer.
444 | You may now proceed to configure the installation. Alternately,
445 | you may wish to reboot the computer and boot into the installed
446 | system to confirm that it works.
447 |
448 | < Configure this System >_ < Reboot >
449 | < Return to Welcome Menu >
450 ---
5e91eec6 451
0befd86f 45235. Highlight < Configure this System > and press enter.
45336. The following menu will be displayed.
454
455 ---| Configure an Installed System |--
456 |
457 | The options on this menu allow you to
458 | configure a DragonFly BSD system after
459 | it has already been installed.
460 | < Select timezone >_
461 | < Set date and time >
462 | < Set keyboard map >
463 | < Set root password >
464 | < Add a user >
465 | < Configure network interfaces >
466 | < Configure hostname and domain >
467 | < Set console font >
468 | < Set screen map >
469 | < Remove software packages >
470 | < Return to Welcome Menu >
471 ---
472
47337. Highlight < Select timezone > and press enter.
474
475(The only purpose of this line is to reduce the indentation of the following bullet points.)
476
477* Highlight < Set keyboard map > and press enter.
478* Highlight < Set root password > and press enter.
479* changeme
480* Highlight < Add a user > and press enter.
481* Password: changeme
482* Highlight < Configure network interfaces > and press enter.
483* Highlight < Configure hostname and domain > and press enter.
484* Highlight < Return to Welcome Menu > and press enter.
485* Highlight < Reboot this Computer > and press enter.
486* Highlight < Reboot > and press enter.
487* Remove installation media.
488* The operating system has halted.
489* Please press any key to reboot.
490* Log in as root.
491* Change password.
492* ee /etc/hosts
493* # Replace hostname and domain with the ones that you chose during configuration.
494* ::1 localhost hostname.domain
495* 127.0.0.1 localhost hostname.domain
496* Ctrl-[
497* a) leave editor
498* a) save changes
499* exit
500* Log in as user.
501* Change password.
e59d72e5 502* startxfce4 (I think that running startx from the root user starts Xfce, but running it from a regular user starts the non-Xfce GUI.)
0befd86f 503
5e91eec6 504## Tidbits
52ea7cc8 505* 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.
37b8379c 506* **pkgin** is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities. Regular programs installed via pkgin are generally located in /usr/pkg/bin.
507* Like Debian, DragonFly BSD is configured by default to use su by default rather sudo, which is the default in Ubuntu. Running su changes the user you are logged in within a single shell instance whereas sudo lets you run a single command as another user. Both programs default to changing the user to root user. To enable your regular user to use su to become root, as root run nano /etc/groups and then change the line wheel:*:0:root to wheel:*:root,yourusername except of course replace rourusername with your user name. Running su - will change the shell environment variables to that of the user to which you're changing.
52ea7cc8 508* The console text editor vi is supposedly great, but if you're not familiar with it and some command you run opens some system file with it, it can be quite alarming. Don't panic! To exit without saving changes type :q! and then press enter.
509* 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.
510* When your computer contacts another computer over the Internet, it converts server's name, such as example.com, to numbered address. The server's name is called a domain name and the numbered address is called an IP address, short for Internet protocol address. To find out which domain name goes with which IP address, you computer usually contacts a special server called a DNS server, DNS being an abbreviation of domain name system. DNS generally works pretty well automatically, but when it causes a problem, it can be very frustrating. As of DragonFly BSD 3.0.3, there's a non-critical DNS configuration setting that the DragonFly BSD installer doesn't set. The file /etc/hosts is a text file that can override DNS name-address bindings. The IP addresses 127.0.0.1 and ::1 always point to one's own computer, so your computer's domain name should always point to these two addresses. This is the setting that currently doesn't get set automatically. You can see or set your host name within the file /etc/rc.conf on a line by itself in the following format.
511
512 hostname="computername.localnetworkname"
513
514 And with that name, you can update your /etc/hosts file with your computer's domain name by editing it to contain the following lines.
515
516 ::1 localhost computername.localnetworkname
517 127.0.0.1 localhost computername.localnetworkname
518
519* 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 520* **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.
521* **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 522* **[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/).
88174747 523* **[Dissonance](https://github.com/varialus/dissonance)** is my fork of Apache Harmony, which is a clean room implementation of Java with a permissive license. Sun and now Oracle refuse to license the TCK, a tool used to validate Java compatibility, for use with Harmony. As a result of the dissonance caused by this refusal to cooperate with the community, Apache retired Harmony and resigned from the Java Community Process Executive Committee. I would have preferred for Apache and the community to have instead just written their own TCK, but I don't know what effects the dissonance had on their organization and it was their decision to make, so I can't blame them. It's unfortunate that such a great project has been effectively abandoned, and so it it is with that in mind that I call on the community to support Dissonance; make your own TCK and make it so much better so as to make passing Oracle's TCK effectively meaningless.
12e7194b 524* **[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.
525* **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'.
52ea7cc8 526* If NetworkManager Applet is installed, use it to override an unreliable DNS server rather than editing /etc/resolv.conf directly. Observed in NetworkManager 0.8.1 on Debian Squeeze. (This seems to not always work, particularly the first time you connect and perhaps after idling for a certain amount of time. I haven't narrowed down the exact cause.)
c73a5f26 527
5e91eec6 528## Issues
b5491331 529* 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 530* The installer should offer the Xfce desktop environment as a supported option. Observed in DragonFly 3.0.2. See workaround below.
74c82ddf 531* The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.0.2.
c1758fdf 532* The installer should set the keyboard layout for the GUI. Observed in DragonFly 3.0.2. See workaround below.
dabfe801 533* The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2.
c1758fdf 534* 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 535* 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.
536* 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.
537* 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 538* 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 539* 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 540* 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 541* 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 542* 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 543* ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012.
12e7194b 544* The following errors should not occur when quitting from the GUI.
545
546 waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0"
547 xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0"
548 failed to unset mtrr: Device not configured
549
550
551 xauth: (argv):1: bad display name "myhostname.mysubdomain.mytld:0" in "remove" command
552
553 Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze.
a7b44ded 554
5e91eec6 555## Workarounds
c1758fdf 556**Enable the Caps Lock Key within the GUI**
557
558Edit the file /etc/X11/xorg.conf.
559
560 ee /etc/X11/xorg.conf
561
562Delete 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.
563
564 Section "InputDevice"
565 Identifier "Keyboard0"
566 Driver "kbd"
567 #Option "XkbOptions" "ctrl:nocaps"
568 EndSection
569
c73a5f26 570Observed in DragonFly BSD 3.0.2.
571
c1758fdf 572**Install Non-GUI on 3TB+ Hard Drive**
573
574*WARNING:* This workaround includes instructions which will delete all data from a hard drive.
575
576Delete 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).
577
578Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases.
579
580Tested in snapshot on 8/14/2012.
581
f378b134 582**Install Xfce 4.6**
583
584*WARNING:* This workaround is not yet complete. Contributions are welcome.
585
2085015f 586The following testing is being done with a root account and no user account. Additional testing with a regular user account will be done later.
587
588*DragonFly BSD 3.1-DEVELOPMENT Non-GUI Instructions*
589
5cde5737 590Summary
591
592* Install XOrg if it's not already installed.
593* Ensure that mouse works.
594* Get the xfce4 meta-package make file.
595* Install binary files listed in xfce4 meta-package make file.
596
597These 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.
598
6216ff22 599Get 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 600
601 cd /usr/
602 make pkgsrc-create
603 make pkgsrc-update
6216ff22 604 cd /usr/pkgsrc/meta-pkgs/xfce4
605 pkgin update
5cde5737 606 pkgin in `cat Makefile | grep -E "xfce4.*mk" | sed -e 's/.include.*\/xf/xf/g' -e 's/\/.*/ /g' | tr -d "\n"`
6216ff22 607 pkg_radd modular-xorg
608 ls /dev/
609
610Log into another console window by pressing Ctrl-Alt-F2 or in VirtualBox, Alt-F2.
611
612 man moused
613
614Scroll down until you find where it mentions mouse dev names.
615
616 ee /etc/X11/xorg.conf
617
618Comment out the /dev/sysmouse line by putting a # in front of it. Add the following line.
619
620 Option "Device" "/dev/psm0"
621
622Except replace psm0 with whichever mouse you've got listed in /dev. Then save the file.
623
624 startxfce4
2085015f 625
626*DragonFly BSD 3.0.2 GUI Instructions*
627
628I got the message Error Code 1 while creating and updating my pkgsrc tree. I haven't yet looked into it further.
629
630Get 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).
631
632 cd /usr/
633 make pkgsrc-create
634 make pkgsrc-update
635
636Get 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.
637
638 cd /usr/
639 make pkgsrc-update
640
641*Notes*
f378b134 642
9ddcfc4c 643* [XFCE based LiveDVD/IMG](http://leaf.dragonflybsd.org/mailarchive/users/2012-07/msg00123.html)
644* [Installing a Desktop Environment: Xfce4](http://www.dragonflybsd.org/docs/how_to_get_to_the_desktop/#index11h3)
645* [Desktop Environments: Xfce](http://www.dragonflybsd.org/docs/newhandbook/X/#index9h3)
646* [Longest DragonFly BSD Review: Running Xfce in DragonFlyBSD 3.0.1](http://insidesocal.com/click/2012/04/review-dragonflybsd-301----the-5.html)
f378b134 647* [Instructions via Google Translate](http://www.google.com/translate_c?langpair=en&u=http://dragonflybsd.fr/index.php?page=Installation+de+Xfce4)
648* [Installing pkgsrc](http://www.dragonflybsd.org/docs/howtos/HowToPkgsrc/#index2h2)
649
2085015f 650 pkgin search xfce
651
f378b134 652**Install Xfce 4.8**
653
654*WARNING:* This workaround is not yet complete. Contributions are welcome.
655
656* [Choosing between portability and innovation](http://lwn.net/Articles/430598/)
657* [Xfce 4.8 on BSD flavors](http://gezeiten.org/post/2011/01/Xfce-4.8-on-BSD-flavors)
658* [Xfce 4.8 tour](http://xfce.org/about/tour48)
659
9ddcfc4c 660**Install Xfce 4.10**
661
662*WARNING:* This workaround is not yet complete. Contributions are welcome.
663
664* [Xfce 4.10 released](http://www.xfce.org/about/news/?post=1335571200)
665* [Xfce 4.10 tour](http://xfce.org/about/tour)
666
a7b44ded 667**Set the GUI Keyboard Layout**
668
669Edit the file /etc/X11/xorg.conf.
670
671 ee /etc/X11/xorg.conf
672
673Set the XkbVariant option to your keyboard variant.
674
675 Section "InputDevice"
676 Identifier "Keyboard0"
677 Driver "kbd"
678 Option "XkbVariant" "dvorak"
679 EndSection
680
681Valid 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.
682
683 grep --color -n -r dvorak /usr/pkg/share/X11/xkb/symbols
684
685If 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.
686
74c82ddf 687Tested in DragonFly 3.0.2.
6848ea64 688
b1839790 689## Contribute
690
691**Port VirtualBox to DragonFly BSD**
692
b2a6f092 693 - Build VirtualBox in GhostBSD (GhostBSD is FreeBSD with Gnome or LXDE installed out of the box.)
694 - Install GhostBSD (Gnome version 3.0 RC1 in VirtualBox)
695 - It's easier to change the keyboard layout in the Gnome version.
696 - If your keyboard stops working during the install then do the following.
697 - Restart GhostBSD LiveCD/LiveUSB
698 - Applications > Accessories > Text Editor
699 - Type your answers to the following fields.
700 - root password
701 - username
702 - full name of user
703 - user password
704 - hostname.
705 - Copy and paste your answers into the installer.
706 - Initialize build environment: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html
707 - Handbook Instructions: http://www.freebsd.org/doc/handbook/updating-upgrading-portsnap.html
708 - portsnap fetch (68 MB as root)
709 - portsnap extract (as root)
710 - portsnap update (as root)
711 - Install Guest Additions (from FreeBSD, not from Oracle)
712 - Initialize build environment (See above)
713 - Wiki Instructions: http://wiki.freebsd.org/VirtualBox#Installing_Guest_Additions_for_FreeBSD_guests
714 - Handbook Instructions: http://www.freebsd.org/doc/handbook/virtualization-guest.html
715 - Notes: http://forums.ghostbsd.org/viewtopic.php?f=8&t=693
716 - More Notes: http://forums.freebsd.org/showthread.php?t=29172
717 - Create a supfile.
718 - ee /root/9rel-supfile (as root)
719 - Firefox within VM http://www.dragonflybsd.org/varialus/
720 - Copy and paste the following into your supfile.
721 *default host=CHANGE_THIS.FreeBSD.org
722 *default base=/var/db
723 *default prefix=/usr
724 *default release=cvs tag=RELENG_9_1
725 *default delete use-rel-suffix
726 *default compress
727 src-all
728 - Firefox http://www.freebsd.org/doc/en/books/handbook/cvsup.html#CVSUP-MIRRORS
729 - Pick close server and change line *default host=CHANGE_THIS.FreeBSD.org
730 - Optionally pick fastest server: http://www.freshports.org/sysutils/fastest_cvsup
731 - Ctrl-[
732 - a) leave editor
733 - a) save changes
734 - cd /root/ (as root)
735 - csup 9rel-supfile (as root)
0eb38dce 736 - If outgoing connections to port 5999 are blocked, here are a few possible solutions which I have not yet tried.
737 - http://lists.freebsd.org/pipermail/freebsd-stable/2005-August/017991.html
738 - http://lists.freebsd.org/pipermail/freebsd-questions/2004-February/034761.html
739 - http://lists.freebsd.org/pipermail/freebsd-questions/2004-March/041566.html
b2a6f092 740 - cd /usr/ports/emulators/virtualbox-ose-additions && make install clean (as root)
d3c598d8 741 - The following console dialog will be be displayed.
742 - Options for virtualbox-ose-additions 4.1.22
743 - [ ] DEBUG Install debug symbols
744 - [ ] OPENGL OpenGL support
745 - [X] X11 X11 support (graphics)
746 - < OK > <Cancel>
747 - Highlight < OK > and press enter.
9b3baec9 748 - The first time I ran this I got a missing dependency error because there had been a minor version update recently. The dependency error was fixed a few hours later. Right after that, the official version of 4.2 was released. To see the original error error, see the edit from 01:48:39 09/13/12.
749 - The following console dialog will be be displayed.
750 - Options for help2man1.40.11
751 - [X] NLS Native Language Support
752 - < OK > <Cancel>
753 - Highlight < OK > and press enter.
754 - The following console dialog will be be displayed.
755 - Options for m4 1.4.16_1,1
756 - [ ] LIBSIGSEGV Use libsigsegv for better diagnostics
757 - < OK > <Cancel>
758 - Highlight < OK > and press enter.
759 - Wait for a little while until it successfully finishes.
760 - Restart virtual machine. (This probably wasn't needed yet.)
761 - Screen resolution increased, but no mouse integration nor copy and paste. Host is Debian Squeeze.
762 - ee /etc/rc.conf (as root)
763 - Add the following lines
be07e999 764
9b3baec9 765 vboxguest_enable="YES"
766 vboxservice_enable="YES"
be07e999 767
9b3baec9 768 - The notes at the URL above mention adding lines to xorg.conf for mouse integration, but I didn't see an xorg.conf in /etc/X11 or in /etc so I skipped this step for now.
769 - The notes also mentioned creating a file for HAL users or copying it, but I didn't see a file at /usr/local/share/hal/fdi/policy/10osvendor/90-vboxguest.fdi so I am skipping this step for the moment.
770 - Restart.
771 - I just noticed that the lines had already been added to /etc/rc.conf, so I removed the extra ones that I had added.
772 - Changed to terminal without X server. Host+F2 in VirtualBox, Ctrl-Alt-F2 on hardware.
773 - Log in as root.
774 - The following didn't work.
775 - killall -9 gdm gdm-binary Xorg
776 - Xorg -configure
777 - Xorg -config /root/xorg.conf.new
778 - X started with black screen, no mouse.
779 - I've run out of time to look into this at the moment. I'll return to it later.
b2a6f092 780 - Build VirtualBox
781 - Initialize build environment (See above)
782 - Build Guest Additions
783 - Build VirtualBox in DragonFly BSD
784 - Install DragonFly BSD (Xfce IMG/ISO Installer)
785 - Build VirtualBox
786 - Install VirtualBox
787 - Test VirtualBox
788 - Build Guest Additions
789 - Install Guest Additions
790 - Test Guest Additions
791 - Package for pkgsrc
792 - Upload to pkgsrc
b1839790 793
794**Port Xfce 4.10 to DragonFly BSD**
795
b2a6f092 796 - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
797 - Build Instructions: http://docs.xfce.org/xfce/building
798 - Package for pkgsrc
799 - Upload to pkgsrc
b1839790 800
801**DragonFly BSD Network Shares Walkthrough**
802
b2a6f092 803 - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
b1839790 804
805**Port bxpkg to DragonFly BSD**
806
b2a6f092 807 - Install DragonFly BSD (Xfce IMG/ISO Installer in VirtualBox)
e54b47aa 808
809## Not Yet Formatted Text Dump
810
811**Project HAMMER Debian**
812The goal of project HAMMER Debian is to recreate Debian Squeeze using the MATE desktop environment, the DragonFly BSD kernel, and the newer of the frozen Debian testing repository or the Debian stable repository.
813
814Parallel Sub-Project Documentation
8150. Setup Common to Subsequent Sub-Project Documentation
8161. Recreate Debian Squeeze using the MATE desktop environment and the newer of the frozen Debian testing repository or the Debian stable repository.
8172. Recreate Debian Squeeze using the MATE desktop environment and DragonFly BSD.
8183. Recreate Debian Squeeze using the MATE desktop environment and the newer of the frozen kFreeBSD testing repository or the kFreeBSD stable repository.
8194. Recreate Debian Squeeze using the MATE desktop environment and FreeBSD.
8205. Recreate Debian Squeeze using the MATE desktop environment, the DragonFly BSD kernel, and the newer of the frozen Debian testing repository or the Debian stable repository.
821
8220.1. Default values implied where steps are skipped.
8230.2. Installation steps are given using the apt command, but using the aptitude command instead of apt is recommended.
8240.3. These instructions sudo for root user authentication, but some systems may use su or some other method instead.
8250.4.0. The use of the nano terminal command is implied for steps which involve editing text files.
8260.4.1. The Ctrl-x shortcut can be used to bring up the save prompt and then exit from nano.
8270.5.0. Set up a development machine.
8280.5.1.0. The Oracle build of VirtualBox is recommended for its ease of use and highly active development.
8290.5.1.1. Here's a link to the VirtualBox download page. https://www.virtualbox.org/wiki/Downloads
8300.5.1.2. Here's a link to the VirtualBox Linux download page. https://www.virtualbox.org/wiki/Linux_Downloads
8310.5.1.3. Here's the /etc/apt/sources.list repository line for Debian Wheezy. deb http://download.virtualbox.org/virtualbox/debian wheezy contrib
8320.5.1.4. Here's the command to authenticate the Oracle Virtualbox repository. wget -q http://download.virtualbox.org/virtualbox/debian/oracle_vbox.asc -O- | sudo apt-key add -
8330.5.1.5. Here's the authentication fingerprint for the Oracle Virtualbox repository. 7B0F AB3A 13B9 0743 5925 D9C9 5442 2A4B 98AB 5139
834Oracle Corporation (VirtualBox archive signing key) <info@virtualbox.org>
8350.5.1.6. Here are the commands to install VirtualBox. sudo apt-get update
836sudo apt-get install dkms
837sudo apt-get install virtualbox-4.2
8380.5.1.7. It's recommended to add your regular user to the vboxusers group and the following is the recommended method. Gnome 2 Menu > System > Administration > Users and Groups > Manage Groups > vboxusers > Properties > Select Check Box of Your Regular User > OK > Password: > Your Regular User Password > Authenticate > Close > Close
8390.5.2. The recommended host software environment is a recreation of Debian Squeeze using the MATE desktop environment and the newer of the frozen Debian testing repository or the Debian stable repository.
8400.5.3. The recommended host hardware environment is an x64 computer with at least a dual core processor, 2 GB memory, a 250 GB hard disk and an Internet connection.
8410.6.