Difference between revisions of "PC-BSD® Users Handbook"
From PC-BSD Wiki
Drulavigne (Talk | contribs) (→Table of Contents) |
Drulavigne (Talk | contribs) |
||
| (44 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | {{swapTitle|custompagename=PC-BSD{{r}} Users Handbook|custompagecategory={{PAGENAME}}}} | |
| + | <!-- '''[[PC-BSD{{r}}]''' --> | ||
| − | <onlyinclude>Beginning with PC- | + | This is the wiki area for the collaborative editing of the ''' ''upcoming edition (version 9.2)'' ''' of the PC-BSD® Users Handbook. If you are beta testing the upcoming 9.2 release or would like to assist in documenting this release, use this wiki version of the PC-BSD® 9.2 Handbook. Otherwise, you instead want to use the version of the PC-BSD® Users Handbook that matches your version of PC-BSD®. |
| + | |||
| + | <onlyinclude>Beginning with PC-BSD® version 8.2, a PDF of the Users Handbook matching the released version is included as an icon on the PC-BSD® desktop. In addition, the Users Handbook is published in various formats as listed below. Translations of the Handbook are added as they become available and any downloadable file name will indicate the language with a [http://reference.sitepoint.com/html/lang-codes 2-letter ISO code]. If you are interested in translating a released version of the documentation, send an email to the [http://lists.pcbsd.org/mailman/listinfo/translations PC-BSD® translations mailing list]. | ||
<blockquote style="border: 2px solid #666; padding: 10px; background-color: #ccc;"> | <blockquote style="border: 2px solid #666; padding: 10px; background-color: #ccc;"> | ||
<h2>Published Versions (in reverse chronological order):</h2> | <h2>Published Versions (in reverse chronological order):</h2> | ||
| − | '''PC- | + | '''PC-BSD® 9.1''' will be released on {{#dateformat:XX December 2012}}. The 9.1 Users Handbook is available in the following formats: |
| + | |||
| + | * [ftp://ftp.pcbsd.org/pub/handbook/9.1/handbook_en_ver9.1.epub EPUB (English)] | ||
| + | |||
| + | * [ftp://ftp.pcbsd.org/pub/handbook/9.1/handbook_en_ver9.1.pdf PDF (English)] | ||
| + | |||
| + | |||
| + | '''PC-BSD® 9.0''' was released on {{#dateformat:13 January 2012}}. The 9.0 Users Handbook is available in the following formats: | ||
* [ftp://ftp.pcbsd.org/pub/handbook/9.0/handbook_en_ver9.0.epub EPUB (English)] | * [ftp://ftp.pcbsd.org/pub/handbook/9.0/handbook_en_ver9.0.epub EPUB (English)] | ||
| Line 20: | Line 30: | ||
* [ftp://ftp.pcbsd.org/pub/handbook/9.0/handbook_in_ver9.0.pdf PDF (Indonesian)] | * [ftp://ftp.pcbsd.org/pub/handbook/9.0/handbook_in_ver9.0.pdf PDF (Indonesian)] | ||
| − | * For those who prefer to purchase a copy of the Handbook for their Kindle, "PC- | + | * For those who prefer to purchase a copy of the Handbook for their Kindle, "PC-BSD® 9.0 Handbook (English Version)" is available from Amazon. The ASIN is B006W0EHN8 and this version is text-to-speech enabled. |
* For those who prefer a "dead tree" version of the Handbook, the [http://www.freebsdmall.com/cgi-bin/fm/pcbsdhbk9.0?id=wrKa8VE5&mv_pc=95 book version] as well as a [http://www.freebsdmall.com/cgi-bin/fm/pcbsdhbk.bn?id=wrKa8VE5&mv_pc=51 book and DVD bundle] are available from FreeBSD Mall. The ISBN for the book is 1-57176-398-8. | * For those who prefer a "dead tree" version of the Handbook, the [http://www.freebsdmall.com/cgi-bin/fm/pcbsdhbk9.0?id=wrKa8VE5&mv_pc=95 book version] as well as a [http://www.freebsdmall.com/cgi-bin/fm/pcbsdhbk.bn?id=wrKa8VE5&mv_pc=51 book and DVD bundle] are available from FreeBSD Mall. The ISBN for the book is 1-57176-398-8. | ||
| − | '''PC- | + | '''PC-BSD® 8.2''' was released on {{#dateformat:24 February 2011}}. The 8.2 Users Handbook is available in the following formats: |
* [ftp://ftp.pcbsd.org/pub/handbook/8.2/handbook_en_ver8.2.epub EPUB (English)] | * [ftp://ftp.pcbsd.org/pub/handbook/8.2/handbook_en_ver8.2.epub EPUB (English)] | ||
| Line 41: | Line 51: | ||
* [ftp://ftp.pcbsd.org/pub/handbook/8.2/handbook_en_ver8.2.pdf PDF (English)] | * [ftp://ftp.pcbsd.org/pub/handbook/8.2/handbook_en_ver8.2.pdf PDF (English)] | ||
| − | * [ftp://ftp.pcbsd.org/pub/handbook/8.2/handbook_in_ver8.2.pdf PDF (Indonesian] | + | * [ftp://ftp.pcbsd.org/pub/handbook/8.2/handbook_in_ver8.2.pdf PDF (Indonesian)] |
| − | * For those who prefer to purchase a copy of the Handbook for their Kindle, "PC- | + | * For those who prefer to purchase a copy of the Handbook for their Kindle, "PC-BSD® 8.2 Handbook (English Version)" is available from Amazon. The ASIN is B004SP6PXY and this version is text-to-speech enabled. |
</blockquote> | </blockquote> | ||
| Line 49: | Line 59: | ||
{{:License}}</onlyinclude><!-- the 'onlyinclude' tag is for transclusion control and does not affect the page otherwise. --> | {{:License}}</onlyinclude><!-- the 'onlyinclude' tag is for transclusion control and does not affect the page otherwise. --> | ||
| − | The Handbook grows into a useful resource when users (meaning you!) contribute to it. You | + | The Handbook grows into a useful resource when users (meaning you!) contribute to it. You do not have to write large sections of the Handbook in order to be a contributor. You also do not need to have a lot of time on your hands. You simply have to create a login account in order to assist with any of the following tasks: |
* proofread existing pages and fix any typos, grammos, or unclearly worded sections. | * proofread existing pages and fix any typos, grammos, or unclearly worded sections. | ||
| Line 63: | Line 73: | ||
We are emailed whenever edits are made and will contact you for clarification if an edit is unclear. You can also be notified when specified pages are edited--simply click the "my preferences" or "my watchlist" links whenever you are logged into the wiki. | We are emailed whenever edits are made and will contact you for clarification if an edit is unclear. You can also be notified when specified pages are edited--simply click the "my preferences" or "my watchlist" links whenever you are logged into the wiki. | ||
| − | ''<center>Copyright 2011, 2012, The PC- | + | ''<center>Copyright 2011, 2012, The PC-BSD® Project. PC-BSD® and the PC-BSD® logo are trademarks of [http://www.ixsystems.com iXsystems].</center>'' |
| − | ''<center>All other content within the PC- | + | ''<center>All other content within the PC-BSD® Users Handbook is freely available for sharing under the terms of the [http://creativecommons.org/licenses/by/3.0/ Creative Commons Attribution License].</center>'' |
<br> | <br> | ||
| − | <span style="font-size: 188%">Work in Progress: PC-BSD 9. | + | <span style="font-size: 188%">Work in Progress: PC-BSD{{r}} 9.2 Users Handbook</span> |
| − | ''' ''If the information and screenshots on the wiki do not match what you are seeing on your PC- | + | ''' ''If the information and screenshots on the wiki do not match what you are seeing on your PC-BSD® system, it means it has changed between your version and the upcoming 9.2 version. You should instead refer to the Users Handbook that came with your version of PC-BSD®.'' ''' |
<br> | <br> | ||
=Table of Contents= | =Table of Contents= | ||
{{hierB|title=Preface}} | {{hierB|title=Preface}} | ||
{{hierB|1.|title=Introduction}} | {{hierB|1.|title=Introduction}} | ||
| − | {{hier|1.1|title= | + | {{hier|1.1|title=Goals and Features}} |
| − | {{hier|1.2|title=What's New in 9. | + | {{hier|1.2|title=What's New in 9.2}} |
| − | {{hier|1.3|title=PC- | + | {{hier|1.3|title=PC-BSD® Releases}} |
| − | {{hier|1.4|title=PC- | + | {{hier|1.4|title=PC-BSD® for Linux Users}} |
{{hierB|2.|title=Pre-Installation Tasks}} | {{hierB|2.|title=Pre-Installation Tasks}} | ||
{{hier|2.1|title=Hardware Requirements}} | {{hier|2.1|title=Hardware Requirements}} | ||
{{hier|2.2|title=Laptops}} | {{hier|2.2|title=Laptops}} | ||
{{hier|2.3|title=Partitioning the Hard Drive}} | {{hier|2.3|title=Partitioning the Hard Drive}} | ||
| − | {{hier|2.4|title=Obtaining PC- | + | {{hier|2.4|title=Obtaining PC-BSD®}} |
{{hier|2.5|title=Burning the Installation Media}} | {{hier|2.5|title=Burning the Installation Media}} | ||
| − | {{hier|2.6|title=PC- | + | {{hier|2.6|title=PC-BSD® Live Mode}} |
{{hier|2.7|title=Using VirtualBox}} | {{hier|2.7|title=Using VirtualBox}} | ||
| − | {{hierB|3.|title=Installing PC- | + | {{hierB|3.|title=Installing PC-BSD®}} |
| − | {{hier|3.1|title=Starting the PC- | + | {{hier|3.1|title=Starting the PC-BSD® Installation}} |
{{hier|3.2|title=Language Selection Screen}} | {{hier|3.2|title=Language Selection Screen}} | ||
| − | {{hier|3.3|title= | + | {{hier|3.3|title=System Selection Screen}} |
{{hier|3.4|title=Disk Selection Screen}} | {{hier|3.4|title=Disk Selection Screen}} | ||
{{hier|3.5|title=Installation Progress Screen}} | {{hier|3.5|title=Installation Progress Screen}} | ||
{{hier|3.6|title=Installation Finished Screen}} | {{hier|3.6|title=Installation Finished Screen}} | ||
{{hierB|4.|title=Post Installation Configuration and Installation Troubleshooting}} | {{hierB|4.|title=Post Installation Configuration and Installation Troubleshooting}} | ||
| − | {{hier|4.1|title=Booting Into PC- | + | {{hier|4.1|title=Booting Into PC-BSD®}} |
{{hier|4.2|title=Language Screen}} | {{hier|4.2|title=Language Screen}} | ||
{{hier|4.3|title=Time Zone Selection Screen}} | {{hier|4.3|title=Time Zone Selection Screen}} | ||
| Line 103: | Line 113: | ||
{{hier|4.9|title=Installation Troubleshooting}} | {{hier|4.9|title=Installation Troubleshooting}} | ||
{{hierB|5.|title=Advanced Installation Topics}} | {{hierB|5.|title=Advanced Installation Topics}} | ||
| − | {{hier|5.1|title=Install | + | {{hier|5.1|title=Install a Server}} |
{{hier|5.2|title=Dual Booting}} | {{hier|5.2|title=Dual Booting}} | ||
{{hier|5.3|title=Multiple Boot Environments}} | {{hier|5.3|title=Multiple Boot Environments}} | ||
| − | {{hier|5.4|title=Upgrading PC- | + | {{hier|5.4|title=Upgrading PC-BSD®}} |
{{hier|5.5|title=Creating an Automated Installation with pc-sysinstall}} | {{hier|5.5|title=Creating an Automated Installation with pc-sysinstall}} | ||
{{hierB|6.|title=Desktops}} | {{hierB|6.|title=Desktops}} | ||
| − | {{hier|6.1|title=GNOME2}} | + | {{hier|6.1|title=GNOME2}}<!-- First are the 'supported' desktops --> |
{{hier|6.2|title=KDE4}} | {{hier|6.2|title=KDE4}} | ||
{{hier|6.3|title=LXDE}} | {{hier|6.3|title=LXDE}} | ||
{{hier|6.4|title=XFCE4}} | {{hier|6.4|title=XFCE4}} | ||
| − | {{hier|6.5|title=Awesome}} | + | {{hier|6.5|title=Awesome}}<!-- Next are the 'unsupported' desktops --> |
| − | {{hier|6.6|title= | + | {{hier|6.6|title=Enlightenment}} |
| − | {{hier|6.7|title= | + | {{hier|6.7|title=evilwm}} |
| − | {{hier|6.8|title= | + | {{hier|6.8|title=Fluxbox}} |
| − | {{hier|6.9|title= | + | {{hier|6.9|title=FVWM}} |
| − | {{hier|6.10|title= | + | {{hier|6.10|title=i3}} |
| − | {{hier|6.11|title= | + | {{hier|6.11|title=IceWM}} |
| − | {{hier|6.12|title= | + | {{hier|6.12|title=Openbox}} |
| − | {{hier|6.13|title= | + | {{hier|6.13|title=Ratpoison}} |
| − | {{hier|6.14|title=Window Maker}} | + | {{hier|6.14|title=spectrwm}} |
| − | {{hierB|7.|title=Installing Applications and Keeping PC- | + | {{hier|6.15|title=WindowLab}} |
| + | {{hier|6.16|title=Window Maker}} | ||
| + | {{hierB|7.|title=Installing Applications and Keeping PC-BSD® Updated}} | ||
{{hier|7.1|title=Using AppCafe®}} | {{hier|7.1|title=Using AppCafe®}} | ||
{{hier|7.2|title=PBI Manager}} | {{hier|7.2|title=PBI Manager}} | ||
{{hier|7.3|title=Update Manager}} | {{hier|7.3|title=Update Manager}} | ||
{{hier|7.4|title=Meta Package Manager}} | {{hier|7.4|title=Meta Package Manager}} | ||
| − | {{hierB|8.|title=Control Panel}} | + | {{hier|7.5|title=Create Your Own PBI Repository}} |
| + | {{hierB|8.|title=Control Panel}}<!-- This section follows the order the items are listed in the control panel --> | ||
{{hier|8.1|title=EasyPBI}} | {{hier|8.1|title=EasyPBI}} | ||
{{hier|8.2|title=About}} | {{hier|8.2|title=About}} | ||
| − | {{hier|8.3|title=Hardware Compatibility}} | + | {{hier|8.3|title=Active Directory & LDAP}} |
| − | {{hier|8. | + | {{hier|8.4|title=Hardware Compatibility}} |
| − | {{hier|8. | + | {{hier|8.5|title=GDM Configuration}} |
| − | {{hier|8. | + | {{hier|8.6|title=Service Manager}} |
| − | {{hier|8. | + | {{hier|8.7|title=System Manager}} |
| − | {{hier|8.8|title=Mount Tray}} | + | {{hier|8.8|title=User Manager}} |
| − | {{hier|8. | + | {{hier|8.9|title=Bluetooth Manager}} |
| − | {{hier|8. | + | {{hier|8.10|title=Mount Tray}} |
| − | {{hier|8. | + | {{hier|8.11|title=Sound Configuration}} |
| − | {{hier|8. | + | {{hier|8.12|title=Display}} |
| − | {{hier|8. | + | {{hier|8.13|title=Printing}} |
| − | {{hier|8. | + | {{hier|8.14|title=Scanner}} |
| − | {{hier|8. | + | {{hier|8.15|title=Network Configuration}} |
| − | {{hier|8. | + | {{hier|8.16|title=Firewall Manager}} |
| − | {{hierB|9.|title= | + | {{hier|8.17|title=Life Preserver}} |
| + | {{hier|8.18|title=Adobe Flash Player preferences}} | ||
| + | {{hier|8.19|title=Warden®}}<!-- End control panel section - special item order --> | ||
| + | {{hierB|9.|title=Using PC-BSD®}} | ||
{{hier|9.1|title=Java, Flash, and Fonts}} | {{hier|9.1|title=Java, Flash, and Fonts}} | ||
{{hier|9.2|title=Multimedia}} | {{hier|9.2|title=Multimedia}} | ||
| Line 152: | Line 168: | ||
{{hier|9.5|title=XBMC}} | {{hier|9.5|title=XBMC}} | ||
{{hier|9.6|title=Windows Emulation}} | {{hier|9.6|title=Windows Emulation}} | ||
| − | |||
{{hier|9.7|title=Remote Desktop}} | {{hier|9.7|title=Remote Desktop}} | ||
| − | {{hier|9.8|title=Security}} | + | {{hier|9.8|title=Thin Client}} |
| + | {{hier|9.9|title=ownCloud}} | ||
| + | {{hier|9.10|title=Security}} | ||
| + | {{hier|9.11|title=Accessibility}} | ||
{{hierB|10.|title=Finding Help}} | {{hierB|10.|title=Finding Help}} | ||
| − | {{hier|10.1|title=PC- | + | {{hier|10.1|title=PC-BSD® Forums}} |
| − | {{hier|10.2 | + | {{hier|10.2|title=IRC Channel}} |
| − | + | {{hier|10.3|title=Mailing Lists}} | |
| − | {{hier|10. | + | {{hier|10.4|title=FreeBSD Handbook and FAQ}} |
| − | {{hier|10. | + | {{hier|10.5|title=Social Media}} |
| − | {{hier|10. | + | {{hier|10.6|title=Search and Portals}} |
| − | {{hier|10. | + | {{hier|10.7|title=Other Resources}} |
| − | {{hier|10. | + | {{hierB|11.|title=Supporting PC-BSD®}} |
| − | {{hierB|11.|title=Supporting PC- | + | |
{{hier|11.1|title=Become a Beta Tester}} | {{hier|11.1|title=Become a Beta Tester}} | ||
{{hier|11.2|title=Become a Translator}} | {{hier|11.2|title=Become a Translator}} | ||
| Line 172: | Line 189: | ||
{{hier|11.6|title=Test PBIs}} | {{hier|11.6|title=Test PBIs}} | ||
:[[PBI Module Builder Guide|11.7 Create PBIs]] <!-- alt text capability is not in the template --> | :[[PBI Module Builder Guide|11.7 Create PBIs]] <!-- alt text capability is not in the template --> | ||
| − | {{hier|11.8|title=Purchase PC- | + | {{hier|11.8|title=Purchase PC-BSD® Swag}} |
{{hier|11.9|title=Host a Mirror}} | {{hier|11.9|title=Host a Mirror}} | ||
{{hier|11.10|title=Seed a Torrent}} | {{hier|11.10|title=Seed a Torrent}} | ||
{{hier|11.11|title=Become an Advocate}} | {{hier|11.11|title=Become an Advocate}} | ||
| + | <!-- The above chapter titles should also be placed in the 'flat html' page; when changes are made here, please make them there --> | ||
<noinclude> | <noinclude> | ||
| − | [[category:PC- | + | [[category:PC-BSD® Wiki]] |
[[category:Handbook]] | [[category:Handbook]] | ||
</noinclude> | </noinclude> | ||
Revision as of 14:05, 4 December 2012
| PC-BSD® Users Handbook |
This is the wiki area for the collaborative editing of the upcoming edition (version 9.2) of the PC-BSD® Users Handbook. If you are beta testing the upcoming 9.2 release or would like to assist in documenting this release, use this wiki version of the PC-BSD® 9.2 Handbook. Otherwise, you instead want to use the version of the PC-BSD® Users Handbook that matches your version of PC-BSD®.
Beginning with PC-BSD® version 8.2, a PDF of the Users Handbook matching the released version is included as an icon on the PC-BSD® desktop. In addition, the Users Handbook is published in various formats as listed below. Translations of the Handbook are added as they become available and any downloadable file name will indicate the language with a 2-letter ISO code. If you are interested in translating a released version of the documentation, send an email to the PC-BSD® translations mailing list.
Published Versions (in reverse chronological order):
PC-BSD® 9.1 will be released on XX December 2012. The 9.1 Users Handbook is available in the following formats:
PC-BSD® 9.0 was released on 13 January 2012. The 9.0 Users Handbook is available in the following formats:
- For those who prefer to purchase a copy of the Handbook for their Kindle, "PC-BSD® 9.0 Handbook (English Version)" is available from Amazon. The ASIN is B006W0EHN8 and this version is text-to-speech enabled.
- For those who prefer a "dead tree" version of the Handbook, the book version as well as a book and DVD bundle are available from FreeBSD Mall. The ISBN for the book is 1-57176-398-8.
PC-BSD® 8.2 was released on 24 February 2011. The 8.2 Users Handbook is available in the following formats:
- For those who prefer to purchase a copy of the Handbook for their Kindle, "PC-BSD® 8.2 Handbook (English Version)" is available from Amazon. The ASIN is B004SP6PXY and this version is text-to-speech enabled.
All versions of the PC-BSD® Handbook are released under the Creative Commons Attribution License. This means that you are free to distribute, modify, translate, and convert the Handbook to other formats, as long as your version retains the following attribution text:
| Copyright 2011-2013, The PC-BSD® Project.
PC-BSD® and the PC-BSD® logo are trademarks of iXsystems. |
| If you translate the handbook to another language, or convert it to other formats, please let us know so that we can help you spread the word and include it on the FTP server. |
The Handbook grows into a useful resource when users (meaning you!) contribute to it. You do not have to write large sections of the Handbook in order to be a contributor. You also do not need to have a lot of time on your hands. You simply have to create a login account in order to assist with any of the following tasks:
- proofread existing pages and fix any typos, grammos, or unclearly worded sections.
- add to sections containing missing, outdated, or incomplete content.
- update any screenshots that are out of date.
- every page has a Discussion tab. You can use this if you would like to suggest further information that should appear in that section of the Handbook.
- create a new section for content that is not yet covered in the Handbook. If you are not sure where to do this, ask on a semi-related Discussion tab.
We are emailed whenever edits are made and will contact you for clarification if an edit is unclear. You can also be notified when specified pages are edited--simply click the "my preferences" or "my watchlist" links whenever you are logged into the wiki.
Work in Progress: PC-BSD® 9.2 Users Handbook
If the information and screenshots on the wiki do not match what you are seeing on your PC-BSD® system, it means it has changed between your version and the upcoming 9.2 version. You should instead refer to the Users Handbook that came with your version of PC-BSD®.
Table of Contents
4. Post Installation Configuration and Installation Troubleshooting
5. Advanced Installation Topics
