Shortened MATE and dfly walkthroughs
[ikiwiki.git] / varialus / index.mdwn
CommitLineData
f66ddf87 1# et
ed370e87 2# Anisoptera
9c48a1fc 3*The following is an unpaid personal wiki page about my experiences, issues, and workarounds related to DragonFly BSD.*
5e91eec6 4
c2c5c660 5## Table of Contents
6
2d13be07 7### 1. Featured
c2c5c660 8
2d13be07 9* **Walkthrough Prerequisite Knowledge**
10* Walkthrough of **Enlightenment** Installation and Configuration
11* Walkthrough of **MATE** Installation and Configuration
12* Walkthrough of **DragonFly BSD** Installation and Configuration
13* (In Progress) Walkthrough of **Applications** Installation and Configuration
14* (In Progress) Walkthrough of **KDE** Installation and Configuration
15* (In Progress) Walkthrough of **Xfce** Installation and Configuration
16* (In Progress) Walkthrough of **LXDE** Installation and Configuration
17* (Not Yet Started) Walkthrough of **C** and **Go** Development Environment Installation and Configuration
9c48a1fc 18
2d13be07 19### 2. Tidbits
c2c5c660 20
52ea7cc8 21* Shell/Console/Command-Line-Prompt: tcsh/bash, ctrl-d/tab-tab, partial-previous-command-up-key/ctrl-r-partial-previous-command, rehash
dec46885 22* Package-Management: pkgng/apt-get
23* Text-Editor: ee/nano, vi :q!
52ea7cc8 24* Manual: man man
52ea7cc8 25* Power-Down: shutdown -p now
dec46885 26* Find File: grep, find / -name fileName
27* Process Management: top, ps, pkill, kill
52ea7cc8 28* File-System: Hammer
29* Operating System: DragonFly BSD
52ea7cc8 30
2d13be07 31### 3. Issues
c2c5c660 32
33* Disclaimer
dec46885 34* Installer Supported Desktops: dfly 3.8.1
35* Early Keyboard Selection: dfly 3.8.1
36* Encryption Keyboard Selection: dfly 3.0.2
37* Random Key for Encrypted Swap: dfly 3.0.2
38* Stay Decrypted for Configuration: dfly 3.0.2
39* No Confirmation for Decryption: dfly 3.0.2
40* Plain Text Password in Install Log: dfly 3.8.1
41* USB Installation Media Named Uniquely: dfly 3.0.2
42* 3TB+ HD Install: dfly 3.0.2, fixed in snapshot on 8/14/2012
43* Overwrite 3TB+ Partition Table: snapshot 8/14/2012
44* Wiki Centered Text: 8/25/2012
45* XOrg Quit Errors: dfly 3.0.2, VirtualBox 4.1.20
c2c5c660 46
2d13be07 47### 4. Workarounds
c2c5c660 48
c2c5c660 49* Install Non-GUI on 3TB+ Hard Drive
c2c5c660 50
2d13be07 51### 5. Contribute
6848ea64 52
b1839790 53* Port VirtualBox to DragonFly BSD
dec46885 54* Update and Fix Bugs of Desktop Environments in DPorts
b1839790 55* DragonFly BSD Network Shares Walkthrough
e54b47aa 56
2d13be07 57# Featured
5e91eec6 58
2d13be07 59## Varialus Walkthrough Prerequisite Knowledge
ceb7af01 60
2d13be07 61When I write documentation I prefer to target as wide an audience as possible by assuming as little prior knowledge as possible. This preference previously caused some of my documentation to be unwieldingly long. In an effort to condense my documentation, I have factored out the most frequently repeated concepts below.
62
631. "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."
64
652. "Search for the given pattern in the remote package repositories."
66
67 pkg search PackageName
68
693. "Show ``full'' information about the package."
70
71 pkg search -f PackageName-Version.Number
72
734. "Install a package from a remote package repository."
74
75 pkg install PackageName-Version.Number
76
775. "The command ee is a simple screen oriented text editor." Press Esc or Ctrl-[ to be prompted to exit and optionally save changes to disk.
78
79 ee /path/to/new/or/existing/text/file
80
816. "To shut down the system properly, use shutdown. It notifies all users and processes of the impending shutdown, blocks new logins, and brings the system down cleanly."
82
83 "The system is halted and the power is turned off (hardware support required) at the specified time."
84
85 shutdown -p now
86
87 "The system is rebooted at the specified time."
88
89 shutdown -r now
90
917. "Sudo is a program designed to let system administrators allow some users to execute some commands as root (or another user)."
92
93 sudo CommandToRunAsRoot
94 sudo pkg install PackageName-Version.Number
95 sudo ee /path/to/new/or/existing/text/file
96 sudo shutdown -p now
97 sudo shutdown -r now
98
99## Walkthrough of Enlightenment Installation and Configuration
100
101This 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 "Walkthrough of DragonFly BSD Installation and Configuration" by Varialus.
ceb7af01 102
103Enlightenment 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.
104
2d13be07 105* DPorts has Enlightenment E17 0.17.5 but Enlightenment E18 0.18.8 is the current stable release. Until MATE or Xfce issues are resolved, I prefer that the version of Enlightenment in DPorts not be updated unless the current stable release of Enlightenment has been confirmed to work at least as well as the version currently in DPorts.
ceb7af01 106* 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.
107* The Enlightenment initial graphical configuration of keyboard layouts doesn't include the Dvorak keyboard layout.
108* The System > Restart and System > Power Off menu options don't work unless the Composite module is unloaded.
109
110I hope this walkthrough will make it easier for developers to properly fix these issues.
111
1121. From DPorts install the following packages and their dependencies.
113
2d13be07 114* xorg
115* xdm
116* enlightenment
117* e17-modules
118* slock
ceb7af01 119
1202. Add the following line to /etc/rc.conf and save the change to disk.
121
122 dbus_enable="YES"
123
1243. Skim through /etc/ttys to find the following line.
125
126 ttyv8 "/usr/local/bin/xdm -nodaemon" xterm off secure
127
128 Then edit the previous line to match the following line and save the change to disk.
129
130 ttyv8 "/usr/local/bin/xdm -nodaemon" xterm on secure
131
1324. Skim through /usr/local/lib/X11/xdm/Xsetup_0 to find the following line.
133
134 xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
135
136 Then edit the previous line to match the following line and save the change to disk.
137
138 #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
139
1405. 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.
141
142 setxkbmap dvorak
143
1446. Skim through /usr/local/lib/X11/xdm/xdm-config to find the following line.
145
146 DisplayManager*authorize: true
147
148 Then edit the previous line to match the following line and save the change to disk.
149
150 DisplayManager*authorize: false
151
1527. 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.
153
154 exec enlightenment_start
155
1568. 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."
157
158 sudo chmod u+s /usr/local/lib/enlightenment/utils/enlightenment_sys
159
2d13be07 1609. Restart DragonFly BSD and log in as user. The Enlightenment initial graphical configuration will be displayed. Select the following options.
ceb7af01 161
162* Language: English
163* Keyboard: English (US)
164* Profile: Computer (Standard Enlightenment)
165* Sizing: 1.2 Title
166* Window Focus: Click
167* Updates: Enable update checking
168* Taskbar: Enable Taskbar
169
2d13be07 17010. 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.
171
17211. 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.
ceb7af01 173
2d13be07 17412. 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.
ceb7af01 175
2d13be07 17613. Click on the left side of the screen and select Settings > All > Screen > Screen Lock, then type 'slock' without quotes within the Custom Screenlock Command text field, click to enable the check box labeled Use Custom Screenlock Command, and click OK.
ceb7af01 177
2d13be07 178## Walkthrough of MATE Installation and Configuration
ceb7af01 179
2d13be07 180This 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 "Walkthrough of DragonFly BSD Installation and Configuration" by Varialus.
1a393eb8 181
1a393eb8 182MATE is my favorite desktop environment. When currently installed and configured as described in this walkthrough, MATE works but has the following issues.
ceb7af01 183
1a393eb8 184* DPorts has MATE 1.6.1 but MATE 1.8 is the current stable release.
185* DPorts currently does not include the MATE meta package.
186* Enabling hald prevents applications from launching via the MATE menu.
187* Many non-fatal errors are logged in the /home/user and /var/log directories.
ceb7af01 188* The console-kit-daem command in the CLI program top has high CPU utilization.
189* One of the post installation messages mentions devstat, but devstat is not in DPorts.
1a393eb8 190
191I hope this walkthrough will make it easier for developers to properly fix these issues.
192
2d13be07 1931. From DPorts install the following packages and their dependencies.
1a393eb8 194
2d13be07 195* xorg
196* xdm
197* mate
1a393eb8 198
2d13be07 199 Because DPorts currently does not include the MATE meta package, use the following command to install it.
1a393eb8 200
2d13be07 201 sudo pkg install -x "mate-[a-z]+"
1a393eb8 202
2d13be07 2032. Add the following lines to /etc/rc.conf and save the change to disk.
1a393eb8 204
2d13be07 205 hald_enable="NO"
206 dbus_enable="YES"
1a393eb8 207
2d13be07 2083. Skim through /etc/ttys to find the following line.
1a393eb8 209
2d13be07 210 ttyv8 "/usr/local/bin/xdm -nodaemon" xterm off secure
1a393eb8 211
2d13be07 212 Then edit the previous line to match the following line and save the change to disk.
9c48a1fc 213
2d13be07 214 ttyv8 "/usr/local/bin/xdm -nodaemon" xterm on secure
fd010ab7 215
2d13be07 2164. Skim through /usr/local/lib/X11/xdm/Xsetup_0 to find the following line.
fd010ab7 217
2d13be07 218 xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
fd010ab7 219
2d13be07 220 Then edit the previous line to match the following line and save the change to disk.
fd010ab7 221
2d13be07 222 #xconsole -geometry 480x130-0-0 -daemon -verbose -fn fixed -exitOnFail
223
2245. 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.
225
226 setxkbmap dvorak
227
2286. Skim through /usr/local/lib/X11/xdm/xdm-config to find the following line.
229
230 DisplayManager*authorize: true
231
232 Then edit the previous line to match the following line and save the change to disk.
233
234 DisplayManager*authorize: false
235
2367. 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.
237
238 exec mate-session
239
2408. Restart DragonFly BSD and log in as user. The MATE desktop will be displayed.
241
242## Walkthrough of DragonFly BSD Installation and Configuration
243
244This 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.
245
2461. Create a virtual machine in VirtualBox using the FreeBSD (64 bit) template with 4 GB memory, 128 GB dynamically allocated VDI virtual disk image. Set the the virtual hardware clock set to UTC time, then download and extract the x86_64 CD [installation media](http://www.dragonflybsd.org/download/) and add it to the virtual machine, but remember to remove it before taking VirtualBox snapshots. Start the virtual machine. Before it finishes booting, the will be greeted with the following boot menu.
fd010ab7 247
fd010ab7 248 DragonFly/i386 bootstrap loader, Revision 1.1
249 (justin@pkgbox64.dragonflybsd.org, Mon Jun 16 21:33:12 PDT 2014)
250 |
251 1. Boot DragonFly [kernel] | ,--, | ,--,
252 2. Boot DragonFly in Safe Mode | | `-, ,^, ,-' |
253 3. Boot DragonFly without AHCI driver | `, `-, (/ \) ,-' ,'
254 4. Boot DragonFly without ACPI driver | `-, `-,/ \,-' ,-'
255 9. Escape to loader prompt (also ESC) | `------( )------'
256 r. Boot DragonFly to a rescue ramdisk | ,----------( )----------,
257 s. Boot DragonFly in single user mode | | _,-( )-,_ |
258 v. Boot DragonFly with verbose logging | `-,__,-' \ / `-,__,-'
259 R. Reboot | | |
260 | | |
261 | | |
262 | | |
263 | | |
264 | | |
265 | `|'
266 |
267 Booting in 10 seconds... _
268
2d13be07 269 After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
fd010ab7 270
271 Welcome to DragonFly!
272
273 To start the installer, login as 'installer'. To just get a shell prompt,
274 login as 'root'.
275
276 DragonFly/x86_64 (Amnesiac) (ttyv0)
277
278 login: _
279
2d13be07 2802. Type 'installer' without quotes and press enter. The following menu will be displayed.
fd010ab7 281
282 F10=Refresh Display .
283 .
284 ,--, | ,--, .
285 ------------------------| Welcome to DragonFly BSD |------------------------- .
286 | |.
287 | Welcome to the DragonFly BSD Live CD. |.
288 | |.
289 | DragonFly BSD is an efficient and elegant BSD Unix-derived operating |.
290 | system. For more information, see http://www.dragonflybsd.org |.
291 | |.
292 | From this CD, you can boot into DragonFly BSD ``live'' (without installing |.
293 | it) to evaluate it, to install it manually, or to troubleshoot problems |.
294 | with an existing installation, using either a command prompt or menu-driven |.
295 | utilities. |.
296 | |.
297 | Also, you can use this automated application to assist you in installing |.
298 | DragonFly BSD on this computer and configuring it once it is installed. |.
299 | |.
300 | < Install DragonFly BSD >_ < Configure an Installed System > |.
301 | < Live CD Utilities > < Exit to Live CD > < Reboot this Computer > |.
302 | < Setup NetBoot Install Services > |.
303 ----------------------------------------------------------------------------- .
304 .
305 .
306 Install DragonFly BSD on a HDD or HDD partition on this computer .
307
2d13be07 3083. The bottom line changes depending on which option is selected. Highlight the option < Install DragonFly BSD > and press enter. The following menu will be displayed.
fd010ab7 309
310 F10=Refresh Display .
311 .
312 ,--, | ,--, .
313 | `-, ,^, ,-' | .
314 `, `-, (/ \) ,-' ,' .
315 --------------------------| Begin Installation |----------------------------- .
316 | |.
317 | This application will install DragonFly BSD on one of the hard disk drives |.
318 | attached to this computer. It has been designed to make it easy to install |.
319 | DragonFly BSD in the typical case. If you have special requirements that |.
320 | are not addressed by this installer, or if you have problems using it, you |.
321 | are welcome to install DragonFly BSD manually. To do so select Exit to Live |.
322 | CD, login as root, and follow the instructions given in the file /README . |.
323 | |.
324 | NOTE! As with any installation process, YOU ARE STRONGLY ENCOURAGED TO BACK |.
325 | UP ANY IMPORTANT DATA ON THIS COMPUTER BEFORE PROCEEDING! |.
326 | |.
327 | < Install DragonFly BSD >_ < Return to Welcome Menu > < Exit to Live CD > |.
328 ----------------------------| Press F1 for Help |---------------------------- .
329 .
330 .
331 .
332 .
333 .
334 .
335 .
336
2d13be07 3374. Highlight the option < Install DragonFly BSD > and press enter. The following menu, specific to your hardware, will be displayed.
fd010ab7 338
339 F10=Refresh Display .
340 .
341 ,--, | ,--, .
342 | `-, ,^, ,-' | .
343 `, `-, (/ \) ,-' ,' .
344 `-, `-,/ \,-' ,-' .
345 `------( )------' .
346 ,----------( )----------, .
347 | _,-( )-,_ | .
348 -----------------------| Select Disk |----------------------- _,-' .
349 | | .
350 | Select a disk on which to install DragonFly BSD | .
351 | | .
352 | < ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33 >_| .
353 | < Return to Begin Installation > | .
354 ------------------------------------------------------------- .
355 `|' .
356 .
357 .
358 .
359 .
360 .
361 .
362 .
363 .
364
2d13be07 3655. Highlight the disk on which to install DragonFly BSD and press Enter. The following menu will be displayed.
fd010ab7 366
367 F10=Refresh Display .
368 .
369 ,--, | ,--, .
370 | `-, ,^, ,-' | .
371 `, `-, (/ \) ,-' ,' .
372 `-, `-,/ \,-' ,-' .
373 `------( )------' .
374 ,----------( )----------, .
375 ------------------------| How Much Disk? |------------------------ | .
376 | |' .
377 | Select how much of this disk you want to use for DragonFly BSD. | .
378 | | .
379 | ad0: 131072MB <VBOX HARDDISK 1.0> at ata0-master UDMA33 | .
380 | | .
381 | < Use Entire Disk >_ < Use Part of Disk > | .
382 | < Return to Select Disk > | .
383 ------------------------------------------------------------------ .
384 .
385 .
386 .
387 .
388 .
389 .
390 .
391 .
392
2d13be07 3936. If you would like to use your entire disk, then highlight < Use Entire Disk > and press enter. The following menu will be displayed.
fd010ab7 394
395 F10=Refresh Display .
396 .
397 ,--, | ,--, .
398 | `-, ,^, ,-' | .
399 ------| Are you absolutely sure? |------ \) ,-' ,' .
400 | | \,-' ,-' .
401 | WARNING! ALL data in ALL partitions on | )------' .
402 | the disk | )----------, .
403 | | )-,_ | .
404 | ad0: 131072MB <VBOX HARDDISK 1.0> at | / `-,__,-' .
405 | ata0-master UDMA33 | | .
406 | | | .
407 | will be IRREVOCABLY ERASED! | | .
408 | | | .
409 | Are you ABSOLUTELY SURE you wish to | | .
410 | take this action? This is your LAST | | .
411 | CHANCE to cancel! ||' .
412 | | .
413 | < OK >_ < Cancel > | .
414 ---------------------------------------- .
415 .
416 .
417 .
418 .
419 .
420
2d13be07 4217. If you are absolutely sure, highlight < OK > and press enter. The following menu will be displayed.
fd010ab7 422
423 F10=Refresh Display .
424 .
425 ,--, | ,--, .
426 | `-, ,^, ,-' | .
427 `, `-, (/ \) ,-' ,' .
428 `-, `-,/ \,-' ,-' .
429 `------( )------' .
430 -----------| Information |------------ )----------, .
431 | | )-,_ | .
432 | The disk | / `-,__,-' .
433 | || | .
434 | ad0: 131072MB <VBOX HARDDISK 1.0> at || | .
435 | ata0-master UDMA33 || | .
436 | || | .
437 | was formatted. || | .
438 | || | .
439 | < OK > |`|' .
440 -------------------------------------- .
441 .
442 .
443 .
444 .
445 .
446 .
447 .
448
2d13be07 4498. Press enter. The following menu will be displayed.
fd010ab7 450
451 F10=Refresh Display .
452 .
453 ,--, | ,--, .
454 | `-, ,^, ,-' | .
455 `, `-, (/ \) ,-' ,' .
456 `-, `-,/ \,-' ,-' .
457 `------( )------' .
458 -----------------| Select file system |------------------ -----, .
459 | | | .
460 | Please select the file system you want to use with |,__,-' .
461 | DragonFly BSD. | .
462 | | .
463 | HAMMER is the new DragonFly BSD file system. UFS is the | .
464 | traditional BSD file system. | .
465 | | .
466 | < Use HAMMER >_ < Use UFS > < Return to Select Disk > | .
467 --------------------------------------------------------- .
468 .
469 .
470 .
471 .
472 .
473 .
474 .
475 .
476
2d13be07 4779. If you want to use HAMMER, and honestly why wouldn't you, then highlight HAMMER and press enter. The following menu will be displayed.
fd010ab7 478
479 F10=Refresh Display .
480 .
481 ,--, | ,--, .
482 --------------------| Create Subpartitions |--------------------- | .
483 | | ,' .
484 | Set up the partitions (also knows as just `partitions' in |' .
485 | BSD tradition) you want to have on this primary partition. In | .
486 | most cases you should be fine with the default settings. |-, .
487 | | | .
488 | For Capacity, use 'M' to indicate megabytes, 'G' to indicate |-' .
489 | gigabytes, and so on (up to 'E'.) A single '*' indicates 'use | .
490 | the remaining space on the primary partition'. | .
491 | | .
492 | Mountpoint Capacity Encrypted | .
493 | [/boot_ ] [768M ] [ ] < Ins > < Del > | .
494 | [swap ] [8192M ] [ ] < Ins > < Del > | .
495 | [/ ] [* ] [ ] < Ins > < Del > | .
496 | < Add > | .
497 | | .
498 | < Accept and Create > < Return to Select Disk > | .
499 -------------------| Press F1 for Help |------------------------- .
500 .
501 .
502 .
503 .
504
2d13be07 50510. Highlight < Accept and Create > and press enter. The following menu will be displayed.
fd010ab7 506
507 F10=Refresh Display .
508 .
509 ,--, | ,--, .
510 | `-, ,^, ,-' | .
511 `, `-, (/ \) ,-' ,' .
512 `-, `-,/ \,-' ,-' .
513 -------------------------| Install OS |-------------------------- .
514 | |-, .
515 | Everything is now ready to install the actual files which | | .
516 | comprise the DragonFly BSD operating system on the selected |-' .
517 | partition of the selected disk. | .
518 | | .
519 | Note that this process will take quite a while to finish. You | .
520 | may wish to take a break now and come back to the computer in a | .
521 | short while. | .
522 | | .
523 | < Begin Installing Files >_ < Return to Create Subpartitions > | .
524 ----------------------------------------------------------------- .
525 .
526 .
527 .
528 .
529 .
530 .
531 .
532 .
533
2d13be07 53411. Highlight < Begin Installing Files > and press enter. The following progress bar will be displayed.
fd010ab7 535
536 F10=Refresh Display .
537 .
538 ,--, | ,--, .
539 | `-, ,^, ,-' | .
540 `, `-, (/ \) ,-' ,' .
541 `-, `-,/ \,-' ,-' .
542 `------( )------' .
543 ,----------( )----------, .
544 -------------------| Executing Commands |------------------- | .
545 | |_,-' .
546 | /bin/cpdup -o -vvv -u /usr/share /mnt/usr/share | .
547 | | .
548 | [*#################65%### ] | .
549 | | .
550 | < Cancel >_ | .
551 ------------------------------------------------------------ .
552 `|' .
553 .
554 .
555 .
556 .
557 .
558 .
559 .
560 .
561
2d13be07 562 When it finishes, the following menu will be displayed.
fd010ab7 563
564 F10=Refresh Display .
565 .
566 ,--, | ,--, .
567 | `-, ,^, ,-' | .
568 ---------------| Install Bootblock(s) |----------------,-' ,' .
569 | | ,-' .
570 | You may now wish to install bootblocks on one or more |--' .
571 | disks. If you already have a boot manager installed, |------, .
572 | you can skip this step (but you may have to configure | | .
573 | your boot manager separately.) If you installed |-,__,-' .
574 | DragonFly BSD on a disk other than your first disk, | .
575 | you will need to put the bootblock on at least your | .
576 | first disk and the DragonFly BSD disk. | .
577 | | .
578 | Disk Drive Install Bootblock? Packet Mode? | .
579 | [ad0_ ] [X] [X] | .
580 | | .
581 | < Accept and Install Bootblocks > | .
582 | < Skip this Step > | .
583 -----------------| Press F1 for Help |----------------- .
584 .
585 .
586 .
587 .
588 The disk on which you wish to install a bootblock .
589
2d13be07 59012. Highlight < Accept and Install Bootblocks > and press enter. The following dialog box will be displayed.
fd010ab7 591
592 F10=Refresh Display .
593 .
594 ,--, | ,--, .
595 | `-, ,^, ,-' | .
596 `, `-, (/ \) ,-' ,' .
597 `-, `-,/ \,-' ,-' .
598 `------( )------' .
599 ,----------( )----------, .
600 | _,-( )-,_ | .
601 -------------| Information |------------- / `-,__,-' .
602 | | | .
603 | Bootblocks were successfully installed! | | .
604 | | | .
605 | < OK > | | .
606 ----------------------------------------- | .
607 | | .
608 `|' .
609 .
610 .
611 .
612 .
613 .
614 .
615 .
616 .
617
2d13be07 61813. Press enter. The following menu will be displayed.
fd010ab7 619
620 F10=Refresh Display .
621 .
622 ,--, | ,--, .
623 | `-, ,^, ,-' | .
624 `, `-, (/ \) ,-' ,' .
625 `-, `-,/ \,-' ,-' .
626 -----------------| DragonFly BSD is Installed! |----------------- .
627 | |-, .
628 | Congratulations! | | .
629 | |-' .
630 | DragonFly BSD has successfully been installed on this computer. | .
631 | You may now proceed to configure the installation. Alternately, | .
632 | you may wish to reboot the computer and boot into the installed | .
633 | system to confirm that it works. | .
634 | | .
635 | < Configure this System >_ < Reboot > | .
636 | < Return to Welcome Menu > | .
637 ----------------------------------------------------------------- .
638
2d13be07 63914. Highlight < Configure this System > and press enter. The following menu will be displayed.
fd010ab7 640
641 F10=Refresh Display .
642 .
643 ,--, | ,--, .
644 ---| Configure an Installed System |---- ^, ,-' | .
645 | | \) ,-' ,' .
646 | The options on this menu allow you to | \,-' ,-' .
647 | configure a DragonFly BSD system after | )------' .
648 | it has already been installed. | )----------, .
649 | | )-,_ | .
650 | < Select timezone >_ | / `-,__,-' .
651 | < Set date and time > | | .
652 | < Set keyboard map > | | .
653 | < Set root password > | | .
654 | < Add a user > | | .
655 | < Configure network interfaces > | | .
656 | < Configure hostname and domain > | | .
657 | < Set console font > ||' .
658 | < Set screen map > | .
659 | < Remove software packages > | .
660 | < Return to Welcome Menu > | .
661 ---------------------------------------- .
662 .
663 .
664 .
5a38262a 665Set the Time Zone of your physical location .
fd010ab7 666
2d13be07 66715. Highlight < Select timezone > and press enter. The following menu will be displayed.
66660ae6 668
669 F10=Refresh Display .
670 .
671 ,--, | ,--, .
5a38262a 672 | `-, ,^, ,-' | .
673 `, `-, (/ \) ,-' ,' .
674 `-, `-,/ \,-' ,-' .
675 `------( )------' .
676 ,----------( )----------, .
677 | Local or UTC (Greenwich Mean Time) clock | )-,_ | .
678 | |/ `-,__,-' .
679 | Is this machine's CMOS clock set to | .
680 | UTC? | .
681 | | .
682 | If it is set to local time, or you | .
683 | don't know, please choose NO here! | .
684 | | .
685 | < Yes >_ < No > | .
686 -------------------------------------------- .
687 .
688 .
689 .
690 .
691 .
692 .
693 .
694
2d13be07 69516. Highlight < Yes > and press enter. The following menu will be displayed.
5a38262a 696
697 F10=Refresh Display ----------| Select Time Zone |---------- .
698 | # .
699 | Select a Time Zone appropriate to your #| ,--, .
700 | physical location. #^, ,-' | .
701 | # \) ,-' ,' .
702 | < Africa >_ # \,-' ,-' .
703 | < America > # )------' .
704 | < Antarctica > # )----------, .
705 | < Arctic > # )-,_ | .
706 | < Asia > # / `-,__,-' .
707 | < Atlantic > # | .
708 | < Australia > # | .
709 | < CET > # | .
710 | < CST6CDT > # | .
711 | < EET > # | .
712 | < EST > # | .
713 | < EST5EDT > #|' .
714 | < Etc > # .
715 | < Europe > * .
716 | < GMT > * .
717 | < HST > * .
718 | < Indian > * .
719 | < MET > * .
720 | < MST > * .
721 ---------------------------------------- .
66660ae6 722
2d13be07 72317. Highlight < GMT > and press enter. The following dialog box will be displayed.
66660ae6 724
725 F10=Refresh Display .
726 .
727 ,--, | ,--, .
728 | `-, ,^, ,-' | .
729 `, `-, (/ \) ,-' ,' .
5a38262a 730 `-, `-,/ \,-' ,-' .
731 `------( )------' .
732 ,----------( )----------, .
733 | _,-( )-,_ | .
734 --------| Information |-------- \ / `-,__,-' .
735 | | | | .
736 | The Time Zone has been set to | | | .
737 | /mnt/usr/share/zoneinfo/GMT. | | | .
738 | | | | .
739 | < OK >_ | | | .
740 ------------------------------- | | .
741 `|' .
742 .
66660ae6 743 .
744 .
745 .
746 .
747 .
748 .
749 .
750
2d13be07 75118. Press enter. The menu from step 33 will be displayed. Highlight < Set keyboard map > and press enter. The following menu will be displayed.
5a38262a 752
753 F10=Refresh Display -------| Select Keyboard Map |-------- .
754 | # .
755 | Select a keyboard map appropriate to # | ,--, .
756 | your keyboard layout. #,^, ,-' | .
757 | #/ \) ,-' ,' .
758 | < be.iso.acc.kbd >_ # \,-' ,-' .
759 | < be.iso.kbd > # )------' .
760 | < bg.bds.ctrlcaps.kbd > * )----------, .
761 | < bg.phonetic.ctrlcaps.kbd > * )-,_ | .
762 | < br275.cp850.kbd > * / `-,__,-' .
763 | < br275.iso.acc.kbd > *| | .
764 | < br275.iso.kbd > *| | .
765 | < by.cp1131.kbd > *| | .
766 | < by.cp1251.kbd > *| | .
767 | < by.iso5.kbd > *| | .
768 | < ce.iso2.kbd > *| | .
769 | < colemak.iso15.acc.kbd > *'|' .
770 | < cs.latin2.qwertz.kbd > * .
771 | < cz.iso2.kbd > * .
772 | < danish.cp865.kbd > * .
773 | < danish.iso.kbd > * .
774 | < el.iso07.kbd > * .
775 | < estonian.cp850.kbd > * .
776 | < estonian.iso.kbd > * .
777 -------------------------------------- .
778
2d13be07 77919. Highlight < us.dvorak.kbd > and press enter. The menu from step 33 will be displayed. Highlight < Add a user > and press enter. The following menu will be displayed.
5a38262a 780
781 F10=Refresh D -------------------| Add user |-------------------- .
782 | | .
783 | Here you can add a user to an installed system. | ,--, .
784 | | ,-' | .
785 | You can leave the Home Directory, User ID, and | ,-' ,' .
786 | Login Group fields empty if you want these items |' ,-' .
787 | to be automatically allocated by the system. |----' .
788 | |--------, .
789 | Note: this user's password will appear in the |_ | .
790 | install log. If this is a problem, please add the | `-,__,-' .
791 | user manually after rebooting into the installed | .
792 | system instead. | .
793 | | .
794 | Username [_ ] | .
795 | Real Name [ ] | .
796 | Password [ ] | .
797 | Password (Again) [ ] | .
798 | Shell [/bin/tcsh ] | .
799 | Home Directory [ ] | .
800 | User ID [ ] | .
801 | Login Group [ ] | .
802 | Other Group Memberships [ ] | .
803 | | .
804 | < Accept and Add > < Return to Configure Menu > | .
805 Enter the use --------------------------------------------------- .
806
2d13be07 80720. In the following fields type the following values without quotes and then highlight < Accept and Add > and press enter.
5a38262a 808
809* Username: 'user'
810* Real Name: 'User'
811* Password: 'ChangeMe'
812* Password (Again): 'ChangeMe'
813
2d13be07 81421. The following dialog box will be displayed.
66660ae6 815
816 F10=Refresh Display .
817 .
818 ,--, | ,--, .
819 | `-, ,^, ,-' | .
820 `, `-, (/ \) ,-' ,' .
821 `-, `-,/ \,-' ,-' .
822 `------( )------' .
823 ,----------( )----------, .
824 | _,-( )-,_ | .
5a38262a 825 -----| Information |---- ,-' \ / `-,__,-' .
826 | | | | .
827 | User `user' was added. | | | .
828 | | | | .
829 | < OK >_ | | | .
830 ------------------------ | | .
831 | | .
66660ae6 832 `|' .
833 .
834 .
835 .
836 .
837 .
838 .
839 .
840 .
841
2d13be07 84222. Press enter. The menu from step 33 will be displayed. Highlight < Set root password > and press enter. The following menu will be displayed.
66660ae6 843
844 F10=Refresh Display .
845 .
846 ,--, | ,--, .
847 | `-, ,^, ,-' | .
848 `, `-, (/ \) ,-' ,' .
5a38262a 849 -------------------| Set Root Password |------------------- ,-' .
850 | |' .
851 | Here you can set the super-user (root) password. |----, .
852 | | | .
853 | Note: root's new password will appear in the install log. |__,-' .
854 | If this is a problem, please set root's password manually | .
855 | after rebooting into the installed system instead. | .
856 | | .
857 | Root password [_ ] | .
858 | Root password again [ ] | .
859 | | .
860 | < Accept and Set Password > | .
861 | < Return to Configure Menu > | .
862 ----------------------------------------------------------- .
66660ae6 863 .
864 .
865 .
866 .
867 .
868 .
5a38262a 869 Enter the root password you would like to use .
66660ae6 870
2d13be07 87123. In the following fields type the following values without quotes and then highlight <Accept and Set Password > and press enter.
5a38262a 872
873* Root password: 'ChangeMe'
874* Root password again: 'ChangeMe'
875
2d13be07 87624. The following dialog box will be displayed.
66660ae6 877
878 F10=Refresh Display .
879 .
880 ,--, | ,--, .
881 | `-, ,^, ,-' | .
5a38262a 882 `, `-, (/ \) ,-' ,' .
883 `-, `-,/ \,-' ,-' .
884 `------( )------' .
885 ,----------( )----------, .
886 | _,-( )-,_ | .
887 ------------| Information |----------- \ / `-,__,-' .
888 | | | | .
889 | User root password has been changed. | | | .
890 | | | | .
891 | < OK >_ | | | .
892 -------------------------------------- | | .
893 | | .
894 `|' .
895 .
896 .
897 .
66660ae6 898 .
899 .
900 .
901 .
902 .
903
2d13be07 90425. Press enter. The menu from step 33 will be displayed. Highlight < Configure network interfaces > and press enter. The following menu will be displayed.
66660ae6 905
906 F10=Refresh Display .
907 .
908 ,--, | ,--, .
909 | `-, ,^, ,-' | .
910 `, `-, (/ \) ,-' ,' .
911 `-, `-,/ \,-' ,-' .
5a38262a 912 ----------| Assign IP Address |---------- )------' .
913 | | )----------, .
914 | Please select which interface you would | )-,_ | .
915 | like to configure: | / `-,__,-' .
916 | | | .
917 | < em0 >_ | | .
918 | < faith0 > | | .
919 | < lo0 > | | .
920 | < ppp0 > | | .
921 | < sl0 > | | .
922 | < Cancel > ||' .
923 ----------------------------------------- .
66660ae6 924 .
925 .
926 .
927 .
928 .
929 .
930 .
931
2d13be07 93226. Highlight < em0 > and press enter. The following menu will be displayed.
66660ae6 933
934 F10=Refresh Display .
935 .
936 ,--, | ,--, .
937 | `-, ,^, ,-' | .
938 `, `-, (/ \) ,-' ,' .
939 `-, `-,/ \,-' ,-' .
940 `------( )------' .
5a38262a 941 --------------| Use DHCP? |-------------- )----------, .
942 | | )-,_ | .
943 | DHCP allows the interface to | / `-,__,-' .
944 | automatically obtain an IP address from | | .
945 | a nearby DHCP server. | | .
946 | | | .
947 | Would you like to enable DHCP for em0? | | .
948 | | | .
949 | < Use DHCP >_ < Configure Manually > | | .
950 ----------------------------------------- |' .
66660ae6 951 .
952 .
953 .
954 .
955 .
956 .
957 .
958 .
959
2d13be07 96027. Highlight < Use DHCP > and press enter. The following menu, specific to your hardware and network connection, will be displayed.
66660ae6 961
962 F10=Refresh Display .
963 .
964 ,--, | ,--, .
5a38262a 965 -------------| Information |------------- ^, ,-' | .
966 | | \) ,-' ,' .
967 | em0: | \,-' ,-' .
968 | flags=8843<UP,BROADCAST,RUNNING,SIMPLEX | )------' .
969 | MULTICAST> mtu 1500 | )----------, .
970 | options=1b<RXCSUM,TXCSUM,VLAN_MTU,VLAN_ | )-,_ | .
971 | WTAGGING> | / `-,__,-' .
972 | inet6 fe80::a00:27ff:fe98:67cc%em0 | | .
973 | prefixlen 64 scopeid 0x1 | | .
974 | inet 10.0.2.15 netmask 0xffffff00 | | .
975 | broadcast 10.0.2.255 | | .
976 | ether 08:00:27:98:67:cc | | .
977 | media: Ethernet autoselect (1000baseT | | .
978 | <full-duplex>) ||' .
979 | status: active | .
980 | | .
981 | | .
982 | < OK >_ | .
983 ----------------------------------------- .
66660ae6 984 .
985 .
986 .
987
2d13be07 98828. Press enter. The menu from step 33 will be displayed. Highlight < Configure hostname and domain > and press enter. The following menu will be displayed.
66660ae6 989
990 F10=Refresh Display .
991 .
992 ,--, | ,--, .
993 | `-, ,^, ,-' | .
994 `, `-, (/ \) ,-' ,' .
995 `-, `-,/ \,-' ,-' .
5a38262a 996 `------( )------' .
997 -------| Set Hostname/Domain |-------- )----------, .
998 | | )-,_ | .
999 | Please enter this machine's hostname | / `-,__,-' .
1000 | and domain name. || | .
1001 | || | .
1002 | Hostname [_ ] || | .
1003 | Domain [ ] || | .
1004 | || | .
1005 | || | .
1006 | < OK > < Cancel > |`|' .
1007 -------------------------------------- .
66660ae6 1008 .
1009 .
1010 .
1011 .
1012 .
1013 .
5a38262a 1014 Enter the Hostname (e.g. `machine') .
1015
2d13be07 101629. In the following fields type the following values without quotes and then highlight <OK > and press enter.
5a38262a 1017
1018* Hostname: 'dfly'
1019* Domain: 'localhost'
66660ae6 1020
2d13be07 102130. The menu from step 33 will be displayed. Highlight < Return to Welcome Menu > and press enter. The menu from step 7 will be displayed. Highlight < Reboot this Computer > and press enter. The following menu will be displayed.
66660ae6 1022
1023 F10=Refresh Display .
1024 .
1025 ,--, | ,--, .
1026 | `-, ,^, ,-' | .
1027 `, `-, (/ \) ,-' ,' .
1028 `-, `-,/ \,-' ,-' .
1029 `------( )------' .
5a38262a 1030 ---------------| Reboot |--------------- )----------, .
1031 | | )-,_ | .
1032 | This machine is about to be shut down. | / `-,__,-' .
1033 | After the machine has reached its | | .
1034 | shutdown state, you may remove the CD | | .
1035 | from the CD-ROM drive tray and press | | .
1036 | Enter to reboot from the HDD. | | .
1037 | | | .
1038 | < Reboot > | | .
1039 | < Return to Welcome Menu > ||' .
1040 ---------------------------------------- .
66660ae6 1041 .
1042 .
1043 .
1044 .
1045 .
1046 .
1047 .
1048
2d13be07 104931. Highlight < Reboot > and press enter. The following message will be displayed.
5a38262a 1050
1051 The operating system has halted.
1052 Please press any key to reboot.
1053
2d13be07 105432. Remove the virtual CD installation media from the virtual machine. Press any key to reboot. Before it finishes booting, the will be greeted with the menu from step 4. After the computer finishes booting, you will be greeted with the following welcome message and login prompt.
5a38262a 1055
1056 DragonFly/x86_64 (dfly.localhost) (ttyv0)
1057
1058 login: _
1059
2d13be07 106033. Log in as root. You will be greeted with the following message and shell prompt.
5a38262a 1061
1062 Copyright (c) 2003-2014 The DragonFly Project. .
1063 Copyright (c) 1992-2003 The FreeBSD Project. .
1064 Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994 .
1065 The Regents of the University of California. All rights reserved. .
1066 .
1067 DragonFly v3.8.1-RELEASE (X86_64_GENERIC) #16 Mon Jun 16 21:36:15 PDT 2014 .
1068 .
1069 Welcome to DragonFly! .
1070 .
1071 dfly# _ .
1072
2d13be07 107334. Type 'passwd' without quotes and press enter. Type in a new root password and press enter and then retype the new root password and press enter again.
5a38262a 1074
2d13be07 107535. Skim through /etc/hosts to find the following lines.
5a38262a 1076
2d13be07 1077 ::1 localhost.my.domain
1078 127.0.0.1 localhost.my.domain
5a38262a 1079
2d13be07 1080 Then edit the previous lines to match the following lines and save the change to disk.
5a38262a 1081
2d13be07 1082 ::1 dfly.localhost
1083 127.0.0.1 dfly.localhost
dec46885 1084
2d13be07 108536. Skim through /home/user/.cshrc to find the following lines.
dec46885 1086
2d13be07 1087 setenv EDITOR vi
dec46885 1088
2d13be07 1089 Then edit the previous lines to match the following lines and save the change to disk.
dec46885 1090
2d13be07 1091 setenv EDITOR ee
dec46885 1092
2d13be07 1093 To apply this change to the current shell, type 'source .cshrc' without quotes and press enter.
1a393eb8 1094
2d13be07 109537. Type 'pkg update' without quotes and press enter. The following output will be displayed.
dec46885 1096
1097 Updating repository catalogue
1098 digests.txz 100% 995KB 497.6KB/s 845.1KB/s 00:02
1099 packagesite.txz 100% 4398KB 1.4MB/s 1.8MB/s 00:03
1100 Incremental update completed, 21327 packages processed:
1101 0 packages updated, 0 removed and 21327 added.
1102
2d13be07 110338. From DPorts install the sudo package and its dependencies. To apply this change to the current shell, type 'rehash' without quotes and press enter.
5a38262a 1104
2d13be07 110539. Type 'visudo' without quotes and press enter. This will open a sudo configuration file within ee, the default text editor. Skim through the file to find the following line.
5a38262a 1106
2d13be07 1107 # %wheel ALL=(ALL) ALL
dec46885 1108
2d13be07 1109 Then edit the previous line to match the following line and save the change to disk.
dec46885 1110
2d13be07 1111 %wheel ALL=(ALL) ALL
dec46885 1112
2d13be07 111340. Add user to the administrative wheel group by typing 'pw usermod user -G wheel' without quotes and press enter. Type 'exit' without quotes and press enter. Log in as user. You will be greeted with the following message and shell prompt.
5a38262a 1114
1115 Copyright (c) 2003-2014 The DragonFly Project. .
1116 Copyright (c) 1992-2003 The FreeBSD Project. .
1117 Copyright (c) 1979, 1980, 1983, 1986, 1988, 1989, 1991, 1992, 1993, 1994 .
1118 The Regents of the University of California. All rights reserved. .
66660ae6 1119 .
5a38262a 1120 DragonFly v3.8.1-RELEASE (X86_64_GENERIC) #16 Mon Jun 16 21:36:15 PDT 2014 .
66660ae6 1121 .
5a38262a 1122 Welcome to DragonFly! .
66660ae6 1123 .
5a38262a 1124 Man pages are divided into section depending on topic. There are 9 different .
1125 sections numbered from 1 (General Commands) to 9 (Kernel Developer's Manual). .
1126 You can get an introduction to each topic by typing .
66660ae6 1127 .
5a38262a 1128 man <number> intro .
66660ae6 1129 .
5a38262a 1130 In other words, to get the intro to general commands, type .
1131 .
1132 man 1 intro .
1133 > _ .
1134
2d13be07 113541. Type 'passwd' without quotes and press enter. 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.
1a393eb8 1136
2d13be07 113742. Skim through /home/user/.cshrc to find the following lines.
66660ae6 1138
2d13be07 1139 setenv EDITOR vi
0befd86f 1140
2d13be07 1141 Then edit the previous lines to match the following lines and save the change to disk.
52ea7cc8 1142
2d13be07 1143 setenv EDITOR ee
52ea7cc8 1144
2d13be07 1145 To apply this change to the current shell, type 'source .cshrc' without quotes and press enter.
52ea7cc8 1146
2d13be07 1147# Tidbits
52ea7cc8 1148
dec46885 1149* 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.
1150* Package-Management: **pkg**, also known as pkgng, is roughly equivalent to **apt-get**. They are both fairly straightforward command line package management utilities.
1a393eb8 1151* 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.
dec46885 1152* 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.
1153* 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.
1154* Find File: **grep** is great for finding text in a file and **find** is great for finding a file by name.
1155* Process Management: Some good commands are top, ps, pkill and kill. There are no doubt others.
1156* 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.
1157* 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.
c73a5f26 1158
2d13be07 1159# Issues
1160
dec46885 1161* 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.
1162* 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.
1163* Early Keyboard Selection: The installer should set the keyboard layout before any typing is required. Observed in DragonFly 3.8.1.
1164* Encryption Keyboard Selection: The installer should set the keyboard layout for the encryption password prompt. Observed in DragonFly 3.0.2.
1165* 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.
1166* 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.
1167* 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.
1168* 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.
1169* 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.
1170* 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.
1171* 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.
1172* Wiki Centered Text: ->Excepting the bullet point, this syntax should center text in this wiki.<- Observed on 8/25/2012.
1173* XOrg Quit Errors: The following errors should not occur when quitting from the GUI.
12e7194b 1174
1175 waiting for X server to shut down xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server ":0.0"
1176 xterm: fatal IO error 35 (Resource temporarily unavailable) or KillClient on X server "0.0"
1177 failed to unset mtrr: Device not configured
1178
1179
1180 xauth: (argv):1: bad display name "myhostname.mysubdomain.mytld:0" in "remove" command
1181
1182 Observed in DragonFly BSD 3.0.2 64-bit on VirtualBox 4.1.20 in Debian Squeeze.
a7b44ded 1183
2d13be07 1184# Workarounds
1185## Install Non-GUI on 3TB+ Hard Drive
c1758fdf 1186
1187*WARNING:* This workaround includes instructions which will delete all data from a hard drive.
1188
1189Delete 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).
1190
1191Install from a [snapshot version of DragonFly](http://avalon.dragonflybsd.org/snapshots/). Be aware that snapshot versions are less thoroughly tested than stable releases.
1192
1193Tested in snapshot on 8/14/2012.
1194
2d13be07 1195# Contribute
1196## Port VirtualBox to DragonFly BSD
b1839790 1197
dec46885 1198 - Build VirtualBox in FreeBSD
1199 - Install FreeBSD
1200 - Compile VirtualBox
1201 - Compile Guest Additions
b2a6f092 1202 - Build VirtualBox in DragonFly BSD
1203 - Install DragonFly BSD (Xfce IMG/ISO Installer)
dec46885 1204 - Compile VirtualBox
b2a6f092 1205 - Install VirtualBox
1206 - Test VirtualBox
dec46885 1207 - Compile Guest Additions
b2a6f092 1208 - Install Guest Additions
1209 - Test Guest Additions
dec46885 1210 - Package for DPorts
1211 - Upload to DPorts
b1839790 1212
2d13be07 1213## Update and Fix Bugs of Desktop Environments in DPorts
b1839790 1214
dec46885 1215 - Install DragonFly BSD
1216 - Compile Updated Desktop Environments
1217 - Install Updated Desktop Environments
1218 - Test, Log Bugs, and Fix Bugs in Updated Desktop Environments
1219 - Package for DPorts
1220 - Upload to DPorts
b1839790 1221
2d13be07 1222## DragonFly BSD Network Shares Walkthrough
b1839790 1223
dec46885 1224 - Install DragonFly BSD
1225 - Figure out network shares and write a walkthrough.