Please fix it so that non-privileged users will be able to report bugs.

And here's the bug I wanted to report: I have been unable to install PC-BSD 7.1.1 on a Virtual Box VM (running on top of a Pentium 4 2.4GHz with 2.5GB of RAM running Mandriva Linux Cooker ) either from the first CD or both the first and second CD. It keeps asking me for the next CD with only an "OK" button and if I don't give it this CD, then the installation needs to be aborted, and the installed partition is left at an unusable state. As far as I recall, no installation of any Linux distribution I tried ever required more than one essential CD, and could always finish with just one CD, including today, so I think PC-BSD should follow suit, and not require more than one CD for installation.

Accessibility of handbook & possible confusion

Houston we have a problem. There are a few things we may not have considered that may cause trouble for users seeking help, especially those who either prefer to use google or online help, and/or those who have not yet installed it and therefore do not have the pdf or link on their desktop. There are further problems in the situation where a firewall is involved, since the most accurate version of the handbook (8.2) for anyone not working with/on the eventual upcoming release (v9.0) may be denied them due to its location on ftp.

I have tried to improve clarity on the pcbsd users handbook page but that only helps when reaching that page from other wiki links or the main wiki url. When google is used to locate help for example: 'google pcbsd multimedia' then your first result is a link within the new v9.0 handbook. This may be for two reasons, the v9.0 is using the same former locations (urls) of the 8.2 handbook, and secondly, Google may not (or does not) reference/"crawl" ftp sites.

It seems something should be changed, but I am not certain what/how, some ideas:

An indication in the sidebar for versions of the handbook.

A background image for the v9.0 handbook to indicate 'not for prime-time' but this would need to be a global background only affecting the unfinished/unpublished v9.0 handbook and/or other non-finalized things.

Similar to and possibly in addition to above. A global footer (possibly a floating footer which stays on the bottom of the viewing window) that provides a notice and link to the current 8.2 handbook.

Give the 8.2 version a static location. This may not be necessary to prevent confusion, but there may need to be a workaround for those locked out of the ftp site by firewalls.

Translations

I have made some adjustments to the NavHeader which should remove the need for the localized version. Please take a look at how the newer NavHeader template reacts when traversing within the localized segment, such as /de. I switched Ziele und Funktionen to use the standard NavHeader. As you may notice, the new templates 'Next' and 'Previous' and 'returnTOC' and 'TOC' will contain a list of the appropriate translated words for each language id.

I plan to add further refinements for the rest of the wiki as needed. I had been attempting to solve the challenges of localizing the wiki when a site malfunction seemed to have taken away all my efforts, but I happen to have run across some breadcrumbs that survived. I have also been away from doing much editing or template work on the wiki for quite some time- at least in part due to sorrow over the loss of hard gained success (with a template relating to localized links).

I noticed how you have managed to translate many different things by using "custompagename" and other similar variables that exist in a number of templates. I hope to make further improvements on the wiki so that those changes might not be needed. I have to think a bit more on some wrinkles as they appear.

An additional new template 'References' is now available to localize the word "References" and is used (transcluded) by the Refheading template. As with the other templates which exist to localize specific words, it will give a message directed toward translators instructing them where and what to localize.

Some odd template issues

We may have to fly with what we have for the moment. As near as I can tell, the /en pages have some small template-induced errors with the hover link text on the NavHeader but this is due to the translation system's lag time which acts like a cache. Once the system catches up, I will look at it again to verify whether it is still an issue. I hope that everything continues to work properly in Ziele und Funktionen.

I am currently baffled and must be getting hindered by cache somewhere. The one /de page that I switched back to the standard NavHeader continues to work regardless of the modifications I make, while the 'base' page and /en page continue to have the weird bug. The main good news is that it is not a functional problem, only an aesthetic one.

Ok. I solved the challenge for the hover text (for the left) but I've discovered another bit of oddness. The wiki allows the pagename to be localized, BUT, the magicword I am using in the NavHeader template to shift the title below the icons does not work, it does not get localized (seems to take it from the URL). This is undoubtedly the reason for using the custompagename. I want to solve this issue as well, and see if the same translated data could be used for other templates. Currently using the standard NavHeader template without 'custompagename' causes a duplication of the pagename though non-localized. The real solution may be an adjustment to site CSS somehow. It will take a bit of exploration and effort.. so until then I will adjust the 'right' side of the NavHeader template effect to match the left.I found a solution to the localized page name issue, this: {{#if: {{getLang}}|{{:Translations:{{#titleparts: {{PAGENAME}}|1|1}}/Page display title/{{getLang}}}}|{{#titleparts: {{{custompagename|{{PAGENAME}}}}}|1}}}}

Just when i think everything is solved, the cache effect seems to bite me. I will have to look at the "solved" problems again and see whats going on.

I have done some exploration and experimentation with the wiki CSS, but I still have not figured out how to get things working as I desire. The NavHeader has been adjusted to be one large table instead of two, and some other tweaks.

There must be an easier way. I discovered another way (via CSS) to hide the page title but this affects the entire site entirely, so I will have to find another way or some method of limiting it to the handbook pages portion of the wiki. Trial and error lead me to ways of limiting the effect of this CSS attribute as well as others that I have added after.

Ok. It looks like most of the troubles have a solution. I am a bit unclear about categories, but it seems as though they ought to follow a similar rule as the translated wiki pages. This also leads me to believe that I may need to adjust some of the auto-categorizing markup in the navigation templates.

Localization infrastructure

template local allows link auto-localization and includes a method to handle anchors.

NavHeader and NavHome auto-localize and includes a method to localize descriptive text (ie "Next")

mechanism for References list text localization.

The bulk of the work is now complete. Although I am aware of a few areas that still need to be revised:

BlueTooth GUI Discussion

Errata

Should add this and also toothcomb the prior releases between what is listed and what is current now.

Taken from forum post:
Correction to sound section - pg 199 (2014-08)

The following quote is from page 199 of 304:

Quote:
In this example, the volume is less than 100% and sound is currently muted as indicated by the red “X” next to
the speaker. To see the screen shown in Figure 8.16d, click the “Mixer” button.

Figure 8.16d: Mixer Settings
The part where it says: "and sound is currently muted as indicated by the red “X” next to the speaker." is incorrect and opposite of fact.

Actually... The button indicates what will happen IF you press it. In this case: "and sound is currently on or UNmuted. The button, if pressed, will mute the sound as indicated on the button by the red “X” next to the speaker."

PBI Build Testing

PBI9 Format

PC-BSD version task list

Pkgsrc in PC-BSD

Press And Legal

Tasks Looking for People

== Translation of the Handbook - ideas from left field ==

Is it possible to have a dual-pane wiki?

In this arrangement, the left pane would always be the English version, and the right pane would be an identical but translated version. This might allow earlier access for the translators while continuing access to further the changes to the original. It could help in some cases where the original English is not worded clearly enough to allow a coherent translation. To further this concept would be similar to the Google translate how it highlights on mouse-over the words/phrase that are meant to be equivalent. Of course, being that any page might not be finalized until the system itself has been frozen, it may mean more repeated work but then with anything in transition it implies continued work.

✔ Yes. There is a Mediawiki extension which enables such a feature.

A cvsup sort of situation

This could be an alternative to the previous thought, or perhaps used in conjunction with it. This perceived solution is to allow quicker updates specific to the translation process. This way the entire handbook that the translator works with is kept current locally and also remotely.

Dual language pdf?

How is the conversion to pdf handled? Could this be configured to have each set of facing pages be, left English and right its translation or blank for editing? This is functionally identical to the dual-pane wiki concept above, but would both more easily mesh with the cvs idea and a local/remote environment.

Local/remote

This is to say that a nearly constant internet connection would not be required. It would only be necessary to update periodically.

Encheferization

Also, though I do not propose any official translation to 'Swedish chef,' the concept of encheferization may be helpful as described at wikipedia below.

Whereas it could not be expected that a test team would know every language to which a product might be aimed, by translating the parts that were supposed to be internationalized through the encheferizer to produce a localized version for Swedish Chef speakers, testers could immediately spot mistakes in the internationalization – parts that had been missed – as anything that had not been localized (encheferized) would show up in the language of the original author of the text. All the same, a tester would be able to test the product functionally, as it takes little language skill, and no software, to be able to decheferize the text: its meaning is clear even when encheferized.

Well.. those are some thoughts I had rattling in my ballpark :) Translation of the handbook may not be going slowly but it gives me that impression. I hope that this could be done more easily or more efficiently, and also address the possible lack of a current translated handbook especially for those testing but not English fluent.

3. the pdf export? There's an option for that on pdf to do just that. However, I prefer that the user download the pdf of the locale handbook, instead of doing that. To parse the other language pages and publish the pdf, there's another extension for that.

4. Use the wiki api to connect to external editors. update via svn or the regular method.

Troubleshooting

Wireless Testing

----

I am surprised no one has used this discussion page to talk about stuff in the wireless section. Even if you have doubts something works. Well for the first post I will confirm on x86 bwn-firmware-kmod works for bcm4311. I will try later on on amd64 arch of pcbsd when i reinstall the os for tutorial purposes (and that will be when i get a decent manual focusing camera that is good on close ups (even extreme ones)). Unless you like to share another method of doing so without rewiteing on my /dev/ada0 . Well until later!

-bebuxe

I have tested the ndis driver for RTL8185 on i386. Don't use the most recent version of the driver, I could not get it to work. Instead use XP version 1.10, It is 290,944 bytes in size. Could not get it to automatically initialize the device at boot time, I have to manually load it. I'll be looking into remedying that. You might also have to manually configure your network settings as the graphical network manager did not work for me. I'll be testing it on amd64 once I download and install it. Until then Happy Wireless Configuring!

Just finished setting up amd64 system. XP64 driver version 1.10 does work (using it now). Driver is 385,536 bytes in size (before conversion). Follow the same procedures as the i386 driver to set it up.

-ikreos

Double fault panic with NDIS drivers

In case you encounter double fault panic when loading NDIS drivers that most likely point to small KSTACK_PAGES. Some Windows NDIS(r) drivers expect much bigger stack. On FreeBSD i386 KSTACK_PAGES is only 2, on FreeBSD amd64 it is 4. Increasing it to 12 and recompiling kernel(not just ndis modules) should be enough.

To change KSTACK_PAGES in your custom kernel add following line:

option KSTACK_PAGES 12

Page edits to make

Where 'this' as a link is used for a pastebin location that contains things such as lines to add to loader.conf, the content ought to be txtboxed (if possible, otherwise inline) instead of the link.

Preface

Introduction

PC-BSD's Goals and Features

What's New in 9

PC-BSD Releases

Also, the release list needs to point to the wiki copy, not the original URL as these are now deprecated. Where did you get the notes to make the wiki copies?

Dru:
The original plan was for the links to be on the righthand side and be mostly static, with the content of the remaining space be the release notes. The release note content from the olden days is via the wayback machine. The links didn't get switched because some things were not available from the wayback machine, I couldn't do what i wanted as far as having the release notes become the main content of the page, and I guess I kinda shelved this.

dru@ I actually like the idea of having a separate page for each release notes on the wiki--makes it easy to link to from other sites and in theory the URL won't change, unlike on the website. There is a way to suck the info out of the database for the old website backup if wayback won't find them.

Dru:
I think I was also sidetracked by something I could succeed at, the pretty tables in various places in the wiki. I might try looking around on other wiki sites to see how others have done things. The help pages for the wiki markup are useful, but not usually specific enough- certainly not where examples to match my crazy ideas are concerned. :) I *think* I may have gotten most of what is available via wayback machine.. all should be marked with category:historical.

lsdev vs. dmesg

I have been a full-time Linux user for five years. I have never heard of lsdev, and typing it at the command line (both as normal user and as root) on my Debian 6.0 system produces a command not found error, yet typing dmesg spits out the expected hardware-related kernel messages. I have always used dmesg regardless of distribution (some Debian based, some based on other distributions, some independent), and have never gotten a command not found error. Since I have not used any of the BSDs (I plan to when I can replace my dead hard disk), I cannot say if dmesg exists in PC-BSD, so I do not feel comfortable editing the table. Piki 15:23, 22 January 2012 (PST)

A storage place for this info which has vastly changed.

Commands

If you're comfortable with the command line, you may find that some of the commands that you are used to have different names on BSD. Table 1.4c lists some common commands and their equivalents.

Table 1.4c: Common BSD and Linux Commands

Please provide a caption: {{tbl-init|caption=a. is the caption}}
Please use alternative templates.
Please use alternative templates.
Please use alternative templates.

Pre-Installation Tasks

Migrating to PC-BSD

Minimum Hardware Requirements

Hardware Compatibility

== Firewire issue on some motherboard models ==

Not sure where to put this, right now:

Trouble booting 8.2 with motherboard model "Gigabyte GA-X58A-UD (revision 1)" is fixed by disabling the built-in Firewire from BIOS.
The error message at boot is "run_interrupt_driven_hooks: still waiting after 300 seconds for xpt_config" and seems to be an old issue also affecting 7.2 since May. Also, since the exact trouble does not seem to have been traced, the above motherboard had an "intel core i7" processor installed.

Do you know if this is still an issue in 9.0 or has it been fixed?

Nope. I don't know that it has been corrected, but I think I may have still seen mention of the above as a solution.

Laptops

It would be helpful to have any idea what some of the errors these various problems give as output, even if it is a panic shortly after an attempted boot. Knowing what the problem looks like in those situations where the hardware may not be fully known, would be a great help in making suggestions for possible fixes- and also might help with generalizing with errors that have similar solutions.

A truly odd situation with CQ62-410us compaq/hp laptop which fails due to some kind of apparent BIOS error- pressing escape in order to cause a boot device selection of DVD seems to solve the problem and allow boot to continue. Reference forum post near the end, last 2-3 comments, http://forums.pcbsd.org/archive/index.php/t-13590.html

Some have issues with suspend ob lind close which may be solved by an edit to /boot/loader.conf

#trying to disable suspend on lid close
debug.acpi.enable_debug_objects="YES"
debug.acpi.disabled="lid"

Partitioning the Hard Drive

Obtaining PC-BSD

This will need to be adjusted to a new hash checking program when sha256 replaces md5. Md5deep at http://md5deep.sourceforge.net/ is compatible with Windows(7, Vista, XP, 2003, 2000), Mac OS X(DarwinPorts, Fink), Linux (Ubuntu, Fedora, Gentoo, Slackware), and FreeBSD, plus it has been updated recently.

md5sum

On (my) Linux the command line tool is md5sum. Maybe the text can be changed to "md5 or md5sum".
✔Thanks for the comment, page adjusted.--Tigersharke 03:36, 1 February 2012 (PST)

Burning the Installation Media

==helpful for USB sticks==

no need to zero the entire thing, can be a limited zero that will be as effective- dd if=/dev/zero of=/dev/usbstick bs=1024 count=10

If KDE or Dolphin or Device Notifier succeed to mount a USB stick but you cannot unmount it, even when you are not actively using it, switch to root and then issue the shell command.

A USB stick can be subdivided as any other HDD could: first gpart create, then newfs. So, gpart create -s MBR /dev/usbstick then gpart add -t freebsd -s <size you want> /dev/usbstick and finally, mount -t ufs /dev/usbstick /mount/point. If a USB stick might be used for an installer image, one slice could be 5120M and the remaining space is chosen by leaving off the size designation, such as gpart add -t freebsd /dev/usbstick. To use the first partition of the usb stick for the image, use dd if=<image> of=/dev/da0s1 bs=512M.

Dolphin/Device Notifier caveat: It may allow a mount point within /media to be created, but it is possible that the ownership or permissions could be wrong. Best case is that /media/mountname is owned by you and wheel group. chown username:wheel /media/mountname.

Live media caveat: This method may not be compatible with booting the usb on any random system. In that situation, simply zero and then dd the image to the stick. Perhaps if the BSD boot selector is added it may work, but that has not yet been verified.

Starting the PC-BSD Installation

Language Selection Screen

I am wondering about how we could include configuration for ntpd (ntp.conf) in a way that is more specific to the localization setting chosen by the user during installation. I am also thinking that this could be set automatically without interaction or only to choose a more specific server.

We have the ntp.conf file which includes the FreeBSD time server pools, but also in there is mention of how specific country time server pools could be defined, which I did manually as in the snippet below: ( 'us' had been 'CC' )

In my opinion, it may be best to keep the numbers of questions or options and configurations during installation to a minimum. I see the potential for this time server pool to be chosen automatically, based upon the user's choice of localization.. at least it seems perfectly reasonable to me.

So, anyone who would be implementing this or has knowledge of what is involved, is welcomed/encouraged to chime in.. I suppose this is at heart a feature request/suggestion.

Keyboard Selection Screen

System Selection Screen

What would be the process of adding or changing window managers/environments?

Is there an automated or GUI method outside of the initial install?

Are other window managers/environments added via PBI or Ports or just the installer?

There should be a place in the wiki to address this situation. It is possible that someone with limited understanding could choose only one window manager and then decide later to add another or switch from one to another. In 8.2 it is an involved process and depending upon what is chosen, it can cause conflicts or instability. In 9.0 the installer offers further options during install and multiple selections can be made.

Listing of Desktop/window environments

Is the order of the desktop/window environments given as they are listed on the interface? If XFCE is meant to be seperate from the 'unsupported/expert' section, perhaps it should be mentioned above that.

Fluxbox

Since fluxbox is included (even with v8.2) I am curious where it is actually mentioned. If it is not indicated anywhere, someone might get the impression that it is not an option- even though it is already installed by default.

Disk Selection Screen

Users Creation Screen

Desktop Selection Screen

What would be the process of adding or changing window managers/environments?

Is there an automated or GUI method outside of the initial install?

Are other window managers/environments added via PBI or Ports or just the installer?

There should be a place in the wiki to address this situation. It is possible that someone with limited understanding could choose only one window manager and then decide later to add another or switch from one to another. In 8.2 it is an involved process and depending upon what is chosen, it can cause conflicts or instability. In 9.0 the installer offers further options during install and multiple selections can be made.

Listing of Desktop/window environments

Is the order of the desktop/window environments given as they are listed on the interface? If XFCE is meant to be seperate from the 'unsupported/expert' section, perhaps it should be mentioned above that.

Fluxbox

Since fluxbox is included (even with v8.2) I am curious where it is actually mentioned. If it is not indicated anywhere, someone might get the impression that it is not an option- even though it is already installed by default.

You need...

Preparing the Server

Mount the .iso image or DVD burned (This option is high recommended if you install PCBSD over a network with too PCS, because, the file is local, is not CDROM. The CDROM driver pains and very work slow installation (Read, send the information, work very slowly)

mdconfig -a -t vnode -f /directory_you_have_a_isoimage.iso -u 0

mount -t cd9660 /dev/md0 /mnt

Mount the DVD burned (X is the cdrom device)

mount -t cd9660 /dev/acdX /mnt

Install Apache

cd /usr/ports/www/apache13 && make install clean

Edit the /usr/local/etc/apache/httpd.conf (change the DocumentRoot to mount DVD or .iso image and port)

DocumentRoot "/usr/local/www/data" -> DocumentRoot "/example"

Run apache

/usr/local/sbin/apachectl start

See you local server ip

$ ifconfig -a

Preparing the netbook

Create a PCBSD live-USB

Download the bootonly-USB.iso image and create the live-USB using dd command.

dd if=PCBSD-x86-bootonly-USB.iso of=/dev/da0 bs=10240 conv=sync

Setting your BIOS, USB first boot and run the live USB

Note: If you experimental ethernet card not turn up in the Auto-DHCP of install process, you can turn up ethernet card from # sysinstall in Configure->Network->Interfaces
In the network installation proccess you must set your Local IP+Port and the directory "/example" in HTTP modeExample:FreeBSD Machine

mount -t cd9660 /dev/acd0 /mnt

cd /usr/ports/www/apache13

make install clean

vi /usr/local/etc/apache/httpd.conf

DocumentRoot "/mnt"

/usr/local/sbin/apachectl start

ifconfig -a

nfe0: 192.168.1.65

dd if=PCBSD-USB-bootonly.iso of=/dev/da0 bs=10420 conv=sync

Netbook
In Network Parameters to install PCBSD (over network)

HTTP 192.168.1.65 /

netSys---

Using a Custom Partition Layout

ZFS raidz pool install attempt. Failed.

Attempting to create an rpool in PC-BSD using the 8.1 installer. This doesn't work, but here's what I tried - perhaps it'll work in the 9.x release

So, my machine is a Dell Optiplex 765 with 3 sata 250G drives. I'd like to get these drive all in a single raidz as I find this to be a suitable setup. Booting from a RAIDZ works as this has been done many times over in the FreeBSD 8.1 release.

What I tried to do was to boot the PC BSD disk and have it see my setup and just install to that zpool. Again, this doesn't work. I don't know how to make the gui pick up the zpool.

these were joined together with
zpool create -f rpool raidz /dev/gpt/disk0 /dev/gpt/disk1 /dev/gpt/disk2

So, I was expecting the SysInstaller to find this setup and be able to use it. This isn't the case.

I would have liked for sys installer to help me out with the creation of raidz, but as such, it doesn't yet seem able to which is why I chose this route.

SysInstaller sees the slices on the drives, but doesn't seem to know what to do about them. The advanced setup presumes you want a bare drive, and doesn't show you the slices. I find this to be an incorrect assumption, as there might have been reasons for me to choose those begin marks. If i want the drive empty, I can pointy-clicky my way to deleting all the partitions.

Not sure if these are already fixed, or just plain invalid requests, but.. there it is.

ADD SECTION ON ZFS POOLS, MIRRORING
At the moment the GUI portion of the installer is going to expect you to provide the raidz configuration you want from within it. For example, you would go to "custom partition", and from there create a new ZFS partition on ad0, at the bottom of the GUI, you'll be able to select your additional devices, such as ada1, ada2 for inclusion into the "raidz" pool. That should get you to an install similar to what you described. For 9 I have it on my list to improve the installer to more easily work with pre-existing partitioning, but its not in the current snapshot yet

Disk Encryption

Dual Booting

The option to install a boot loader during PC-BSD installation is no longer present in the GUI, hence the mods to the discussion around recovering from "accidental use" of that previously available option.

Unsure exactly how/where to fit this in:

boot0cfg

Grub 2

I noticed the section on Grub 2 is a little out of date. The map command is a legacy command. In Grub 2, it was renamed to drivemap. Also, the device names changed slightly in Grub 2: the partitions of the hard drive are counted from 1 instead of 0: so, (hd0,msdos1) is the first partition of the first hard drive.

drivemap isn't actually needed to boot PC-BSD if it's on the second disk, at least for me. My menuentry is something like this:

I have just gone through the pain of configuring a dual boot using Grub2 for PC-BSD 9.1. FWIW, here is my experience.

Computer HDD Setup

I have Debian Linux (wheezy) on the first primary partition, with PC-BSD on the second primary partition using the zfs filesystem. When I installed PC-BSD, I installed its bootloader which overwrote Grub2 on the MBR.

Recovering Debian Grub2

To re-install Grub2 on the MBR in a Debian system, the installation cd/dvd have the tools specifically built in. Google on the Debian Wiki and it directs you to the appropriate section of the Debian installation guide.

Boot using the Debian Install Disk
Advanced Options
Recovery Mode
You will progress through various screens which are the first part of the Debian Installer - don't worry too much because none of the info will be written to the disk. Eventually ....
A screen will present the available partitions - select the one you want to be the root partition.
Select the menu entry to re-install Grub

Manual Menu Entries in Debian Grub2

Debian automatically builds the Grub2 config file " /boot/grub/grub.cfg" . There is no point editing it (and they warn you about this - it is a text file that you can read) because it is over-written the next time grub.cfg is created. Instead, if you look at the end of the file, you will see that they point you to a customisation file " /etc/grub.d/40_custom " . Open it in an editor (as superuser) and you can add your manual entries to the bottom. Save the file and then once again as superuser:
" update-grub "
This will incorporate your custimisations in a new grub.cfg file.

Adding PC-BSD to Grub2

The entry I eventually found was for me (after piecing things together) was:

menuentry "PC-BSD 9.1" {
set root='(hd0,2)'
chainloader +1
}

"hd0,2" -

0 stands for the first hard disk, because you count your disks from zero.
2 stands for the second partition because you count your partitions from one.

chainloader +1 allows grub to go to the bootloader for PC-BSD which I installed initially if you remember and which is loaded at the start of the PC-BSD partition.

Upgrading PC-BSD

Creating an Automated Installation with pc-sysinstall

We should include an example, even if it is relatively basic, to give context to the variables and how they would be used.

It highly bothers me that '=' is shown to be part of the variable names here. An improved explanation along with the example mentioned above, would allow the table to be fixed (removal of the '=' from variable names.)

I have a sample pc-sysinstall.cfg that could be used, if you like. It's a little more complex than normal, but it does show how multiple network interfaces are configured:

Desktops

==Fluxbox==

A fluxbox page does exist, but is it considered supported or similar to Awesome and therefore grouped with it? Fluxbox is not mentioned on this page, but it is also included by default. (This is not the only talk page I mentioned fluxbox)

XFCE4

Awesome

Fluxbox

FVWM

IceWM

Openbox

ScrotWM

Window Maker

Installing Applications and Keeping PC-BSD Updated

Another item to consider is installation of rpm files.

Some things that are designed as rpm may load as from ports and install in their proper location. However, other items (most notably flash) are an rpm file downloaded from a 3rd party site which requires an understanding of how to get it installed and/or where to drop it so it will get recognized.

Using AppCafe™

PBI Manager

Clarity issue?

Umm.. between 'PBI Module builder guide' and 'PBI Manager' wiki pages, there seems to be some disagreement of duplicated topics- specifically the pbi.conf file. One may be incomplete, therefore only tells of like 5 variables to use within the pbi.conf file, while the other shows the firefox pbi.conf file containing those and more stuff.

How?!

My *primary* need, is to know how to build a PBI from a port, and have it use the options I choose (as 'make config' would allow) if building directly from ports. I have tried unsuccessfully to get Quassel (irc client/core/mono suite) to successfully build just the mono[lithic] version.

At this time, you would need to add additional ports or make options into a PBI module by hand.
For your example:
1) Use EasyPBI to create a module for mail/claws-mail
2) Open up (home-dir)/EasyPBI/Modules/claws-mail/pbi.conf
3) Edit the PBI_MAKEOPTS line to read: [PBI_MAKEOPTS="WITH_SPAMASSASSIN=yes"] (quotes needed)
4) Save the file and then use that module to build your PBI with EasyPBI
(in our example freshports only lists SPAMASSASSIN as a make option, the actual makefile shows the actual variable that needs to be set is WITH_SPAMASSASSIN).

Update Manager

Control Panel

Ports Jail

==System vs Jail ports tree confusion==

I believe the system manager needs some adjustment. There needs to be better clarification. We give two options: One under Ports Console, 'Fetch ports tree' and under System tasks advanced users,'Fetch system ports tree'. The first option needs to be explicitly defined as for the jail, such as "Fetch ports tree for jail" and the other may be fine as is.. but myself and others have not realized the distinction until the tree is not setup when trying to use the standard FreeBSD ports tree to install something. Perhaps if the ports jail is the only option/action under that 'Ports Console' heading, the heading could also be revised or removed.
--Tigersharke 20:26, 8 July 2011 (PDT)

Service Manager

System Manager

User Manager

Display

Printing

Network Configuration

Recently a user wanted to be sure that Ethernet over USB worked, which leads to these:

What drivers/kernel objects are loaded on the 'live' pseudo-install?

A step by step to troubleshoot the 'live' pseudo-install such as to enable other features or devices.

Internet connection sharing is not specifically named and does not seem to be described.

How to setup a ether to wifi hotspot/sharing is also not mentioned.

Freebsd handbook 32.3.5 describes this configuration but its a reasonable expectation for a laptop to be able to share out its wifi while attached by ethernet cable.

This section should no longer be needed in 9.0 as both modules are included with the base system.

bwn(4) and bwi(4) Drivers

Due to licensing restrictions, the bwn and bwi drivers require that their firmware is compiled on the individual's computer. This means that Broadcom BCM43xx IEEE 802.11b/g wireless network adapters will not “just work” after installing PC-BSD.

To compile the firmware, you will need to install both the ports tree and source on your PC-BSD system. You can do so by going to Control Panel -> System Manager. After inputting the administrative password, click on the Tasks tab, seen in Figure 7.7p:

Figure 7.7p: Using System Manager to Install Ports and Source

In the "System Tasks - Advanced Users Only" section, click "Fetch System Source" if /usr/src does not currently exist on your system.

In the "System Tasks - Advanced Users Only" section, click "Fetch System Ports Tree" if /usr/ports does not currently exist on your system.

Both src and ports are large so it will take a few minutes for each fetch to finish. When the fetch is finished, compile the firmware using the instructions for the driver that you need. You will need to be the superuser in order to compile the firmware.

For the bwn driver:

cd /usr/ports/net/bwn-firmware-kmod && make install clean

This will create two kernel modules:

bwn_v4_ucode module (used by most adapters)

bwn_v4_lp_ucode (used by low power PHY adapters)

It's a good idea to test which module is used by your adapter, so type:

kldload bwn_v4_ucode

If that command just gives your prompt back without an error, that is the correct module. If you receive an error, try loading the low power module instead which should just give you your prompt back without an error:

kldload bwn_v4_lp_ucode

Now carefully add the following two lines to /boot/loader.conf:

bwn_v4_ucode_load="YES"
if_bwn_load="YES"

Note: replace bwn_v4_ucode_load="YES" with bwn_v4_lp_ucode_load="YES" if your adapter is a low power one.

For the bwi driver:

cd /usr/ports/net/bwi-firmware-kmod && make install clean

This will create the following kernel module:

bwi_v3_ucode.ko

To load the module:

kldload bwi_v3_ucode.ko

And carefully add the following line to /boot/loader.conf so the module will automatically load whenever you boot:

bwi_v3_ucode_load="YES"

Firewall Manager

Bluetooth

Life Preserver

Warden®

When prompted to enter the nic, it is rather less than explanatory, even with it being more spelled out as below. Is the interface name /dev/re0 or simply re0? A mouse-over of the ethernet or wifi icons in the system tray gives the detail "Device Name: /dev/re0". There is also no feedback on whether the correct information was given, though note the bad syntax caused by the omission of what is being used, in the last line.
/usr/local/warden/scripts/rc.d/warden.sh
Which network interface do you want to run jails on?
nic: input your interface name here
Using for jails

This may be more of an adjustment to the script, than a significant documentation change. Perhaps 'network device' may be better than nic. Entering simply re0 may in fact not work but there is no indication of it other than the entry not being explicitly acknowledged.

This is likely another of the pages which seldom change, and ought to be adjusted to reflect that. It simply has not been done yet, but yes, surely the "versioned" page exists. I was "away" for a while and plan to get back at task on whatever is needed for the wiki.. eventually have my own local copy once more for testing/experimentation and some evaluation of newer software etc.