Difference between revisions of "Convert a FreeBSD System to PC-BSD®/10.0"

From PC-BSD Wiki
Jump to: navigation, search
(Switching to the PC-BSD{{R}} pkgng Repository)
 
(28 intermediate revisions by 3 users not shown)
Line 2: Line 2:
  
 
<!--T:1-->
 
<!--T:1-->
{{UseTOC{{putVers}}|Nav|title=Convert a FreeBSD System to PC-BSD{{R}}}}</noinclude>
+
{{UseTOC{{putVers}}|Nav|title=Convert a FreeBSD System to {{pcbsd}}}}</noinclude>
  
An existing FreeBSD 10.0 installation can be easily converted to either a PC-BSD® desktop or server through the installation of a package which is available from the PC-BSD{{R}} package repository. The converted desktop will contain all of the graphical utilities that come with PC-BSD® and the converted server will contain all of their command line equivalents.
+
<!--T:43-->
 +
An existing FreeBSD 10.0 installation can be easily converted to either a PC-BSD® desktop or server. This can happen through the installation of a package which is available from the PC-BSD{{R}} package repository. The converted desktop will contain all of the graphical utilities that come with PC-BSD®. The converted server will contain all of their command line equivalents.
  
== Switching to the PC-BSD{{R}} pkgng Repository ==  
+
== Switching to the PC-BSD{{R}} pkgng Repository == <!--T:44-->
  
This section demonstrates how to configure a FreeBSD 10.0 system to use the PC-BSD{{R}} pkgng repository. Once this configuration is complete, you can then convert that FreeBSD system to either a PC-BSD{{R}} desktop or server as described in the next two sections.
+
<!--T:45-->
 +
This section demonstrates how to configure a FreeBSD 10.0 system to use the PC-BSD{{R}} pkgng repository. Once this configuration is complete, you can then convert that FreeBSD system to either a PC-BSD{{R}} desktop or a TrueOS® server as described in the next two sections.
  
Start by creating the file ''/usr/local/etc/pkg/repos/pcbsd.conf'' with the following contents:
+
<!--T:46-->
 +
Start by creating this directory:
  
 +
<!--T:47-->
 +
{{txtbox|box='''mkdir -p /usr/local/etc/pkg/repos'''}}
 +
 +
<!--T:48-->
 +
Then, create the file ''/usr/local/etc/pkg/repos/pcbsd.conf'' with the following contents:
 +
 +
<!--T:49-->
 
{{txtbox|box=<nowiki>pcbsd: {
 
{{txtbox|box=<nowiki>pcbsd: {
 
         url: "http://pkg.cdn.pcbsd.org/10.0-RELEASE/amd64",
 
         url: "http://pkg.cdn.pcbsd.org/10.0-RELEASE/amd64",
Line 19: Line 29:
 
       }</nowiki>}}
 
       }</nowiki>}}
  
 +
<!--T:50-->
 
Next, create the following directories:
 
Next, create the following directories:
  
'''mkdir /usr/local/etc/pkg/fingerprints/pcbsd/revoked'''
+
<!--T:51-->
'''mkdir/usr/local/etc/pkg/fingerprints/pcbsd/trusted'''
+
{{txtbox|box='''mkdir -p /usr/local/etc/pkg/fingerprints/pcbsd/revoked'''
 +
'''mkdir -p /usr/local/etc/pkg/fingerprints/pcbsd/trusted'''}}
  
Then, download the repository's fingerprint file from {{citelink|url=https://github.com/pcbsd/pcbsd/raw/master/src-sh/pc-extractoverlay/ports-overlay/usr/local/etc/pkg/fingerprints/pcbsd/trusted/pkg.cdn.pcbsd.org.20131209|txt=public fingerprint file}}, and copy it to ''/usr/local/etc/pkg/fingerprints/pcbsd/trusted/''.
+
<!--T:52-->
 +
Then, download the repository's fingerprint file:
  
The system is now configured and you now update your packages to the latest versions from the pkgng repository using the following command:
+
<!--T:53-->
 +
{{txtbox|box='''fetch --no-verify-peer {{https}}github.com/pcbsd/pcbsd/raw/master/src-sh/pc-extractoverlay/ports-overlay/usr/local/etc/pkg/fingerprints/pcbsd/trusted/pkg.cdn.pcbsd.org.20131209'''
 +
'''mv pkg.cdn.pcbsd.org.20131209 /usr/local/etc/pkg/fingerprints/pcbsd/trusted/'''}}
  
 +
<!--T:54-->
 +
Finally, update the package database and any installed packages using the following command:
 +
 +
<!--T:55-->
 
{{txtbox|box= '''pkg upgrade -fy'''{{nbsp|65}}}}
 
{{txtbox|box= '''pkg upgrade -fy'''{{nbsp|65}}}}
  
Depending upon what is already installed, you may have to resolve some error messages in order to successfully upgrade all packages.
+
<!--T:56-->
 
+
Depending upon what is already installed, you may have to resolve some error messages in order to successfully upgrade all packages. To install and delete packages, use the '''pkg''' command as described in {{citelink|fbsdh|url=pkgng-intro.html|txt=Section 5.5.3 of the FreeBSD Handbook}}.
To install and delete packages, use the '''pkg''' command as described in {{citelink|fbsdh|url=pkgng-intro.html|txt=Section 5.5.3 of the FreeBSD Handbook}}.
+
  
 
== Converting FreeBSD to a PC-BSD{{R}} Desktop == <!--T:16-->
 
== Converting FreeBSD to a PC-BSD{{R}} Desktop == <!--T:16-->
  
 
<!--T:17-->
 
<!--T:17-->
To convert a FreeBSD system into a PC-BSD® desktop, install the following port as the superuser:
+
Once the repository configuration is complete, it is now easy to convert a FreeBSD system into a PC-BSD® desktop using the following commands as the superuser:  
  
<!--T:36-->
+
<!--T:57-->
{{txtbox|box= '''cd /usr/ports/sysutils/pcbsd-utils-qt4'''{{nbsp|54}}
+
{{txtbox|box='''fetch --no-verify-peer -o /etc/freebsd-update.conf '<nowiki>https://github.com/pcbsd/freebsd/raw/master/etc/freebsd-update.conf'</nowiki>'''
'''make install clean'''
+
'''freebsd-update fetch'''
}}
+
'''freebsd-update install'''
 
+
'''pkg install -fy pcbsd-base'''
If the ports collection is not yet installed, meaning that the above directory does not exist, install it by typing '''portsnap fetch extract'''. You can then run the above commands. Once the port compile is complete, run the following commands to extract the installed desktop:
+
'''rehash'''
 
+
 
+
{{txtbox|box='''rehash'''
+
 
'''pbreg set /PC-BSD/SysType PCBSD'''
 
'''pbreg set /PC-BSD/SysType PCBSD'''
'''pc-extractoverlay desktop'''
+
'''pc-extractoverlay ports'''
'''pc-extractoverlay ports'''}}
+
'''pc-extractoverlay desktop'''}}
  
 
<!--T:37-->
 
<!--T:37-->
Next, reboot the system and the PC-BSD® login manager will start, allowing you to login to the desktop. If you want to {{local|link=Post Installation Configuration and Installation Troubleshooting |set the PC-BSD® display wizard and first boot wizards to run first}}, run these commands before rebooting:
+
Next, reboot the system. The PC-BSD® login manager will start, allowing you to login to the desktop. If you want to {{local|link=Post Installation Configuration and Installation Troubleshooting |set the PC-BSD® display wizard and first boot wizards to run first}}, run these commands before rebooting:
  
 
<!--T:38-->
 
<!--T:38-->
Line 59: Line 74:
 
'''touch /var/.pcbsd-firstboot'''
 
'''touch /var/.pcbsd-firstboot'''
 
'''touch /var/.pcbsd-firstgui'''}}
 
'''touch /var/.pcbsd-firstgui'''}}
 
<!--T:39-->
 
If you are running FreeBSD 10-CURRENT, specify the PBI version to pull from.  To do so, edit ''/usr/local/etc/pbi.conf'' and add this line:
 
 
{{txtbox|box=PBI_FBSDMAJOR: 9{{nbsp|64}}}}
 
  
 
<!--T:40-->
 
<!--T:40-->
Line 74: Line 84:
  
 
<!--T:41-->
 
<!--T:41-->
{{txtbox|box= '''pkg install pcbsd-utils'''{{nbsp|53}}
+
{{txtbox|box= '''pkg install -fy pcbsd-utils'''{{nbsp|53}}
 
'''rehash'''
 
'''rehash'''
 
'''pbreg set /PC-BSD/SysType TRUEOS'''
 
'''pbreg set /PC-BSD/SysType TRUEOS'''
'''pc-extractoverlay server'''
+
'''pc-extractoverlay ports'''
'''pc-extractoverlay ports'''}}
+
'''pc-extractoverlay server'''}}
  
 
<!--T:42-->
 
<!--T:42-->
These steps will install the following: {{local|link=PBI Manager}}, the command line version of '''{{local|link=Warden®|anchor=Using the Command Line Version of Warden® | warden}}''', and the command line versions of most of the {{local|link=Control Panel}} utilities. You will find those utilities in ''/usr/local/bin/pc-*''. It also installs  {{citelink|tracpo|url=misc/trueos-base/Makefile|txt=these additional shells and utilities}}.
+
These steps will install the following: {{local|link=PBI Manager}}, the command line version of {{local|link=Warden®|anchor=Using the Command Line Version of Warden®|'''warden'''}}, and the command line versions of most of the {{local|link=Control Panel}} utilities. You will find those utilities in ''/usr/local/bin/pc-*''.  
 
</translate>
 
</translate>
 
<noinclude>
 
<noinclude>

Latest revision as of 01:48, 7 March 2014


Contents


An existing FreeBSD 10.0 installation can be easily converted to either a PC-BSD® desktop or server. This can happen through the installation of a package which is available from the PC-BSD® package repository. The converted desktop will contain all of the graphical utilities that come with PC-BSD®. The converted server will contain all of their command line equivalents.

[edit] Switching to the PC-BSD® pkgng Repository

This section demonstrates how to configure a FreeBSD 10.0 system to use the PC-BSD® pkgng repository. Once this configuration is complete, you can then convert that FreeBSD system to either a PC-BSD® desktop or a TrueOS® server as described in the next two sections.

Start by creating this directory:

mkdir -p /usr/local/etc/pkg/repos

Then, create the file /usr/local/etc/pkg/repos/pcbsd.conf with the following contents:

pcbsd: { url: "http://pkg.cdn.pcbsd.org/10.0-RELEASE/amd64", signature_type: "fingerprints", fingerprints: "/usr/local/etc/pkg/fingerprints/pcbsd", enabled: true }

Next, create the following directories:

mkdir -p /usr/local/etc/pkg/fingerprints/pcbsd/revoked mkdir -p /usr/local/etc/pkg/fingerprints/pcbsd/trusted

Then, download the repository's fingerprint file:

fetch --no-verify-peer https://github.com/pcbsd/pcbsd/raw/master/src-sh/pc-extractoverlay/ports-overlay/usr/local/etc/pkg/fingerprints/pcbsd/trusted/pkg.cdn.pcbsd.org.20131209 mv pkg.cdn.pcbsd.org.20131209 /usr/local/etc/pkg/fingerprints/pcbsd/trusted/

Finally, update the package database and any installed packages using the following command:

pkg upgrade -fy                                                                 

Depending upon what is already installed, you may have to resolve some error messages in order to successfully upgrade all packages. To install and delete packages, use the pkg command as described in Section 5.5.3 of the FreeBSD Handbook[1].

[edit] Converting FreeBSD to a PC-BSD® Desktop

Once the repository configuration is complete, it is now easy to convert a FreeBSD system into a PC-BSD® desktop using the following commands as the superuser:

fetch --no-verify-peer -o /etc/freebsd-update.conf 'https://github.com/pcbsd/freebsd/raw/master/etc/freebsd-update.conf'

freebsd-update fetch freebsd-update install pkg install -fy pcbsd-base rehash pbreg set /PC-BSD/SysType PCBSD pc-extractoverlay ports

pc-extractoverlay desktop

Next, reboot the system. The PC-BSD® login manager will start, allowing you to login to the desktop. If you want to set the PC-BSD® display wizard and first boot wizards to run first, run these commands before rebooting:

touch /var/.runxsetup                                                           

touch /var/.pcbsd-firstboot

touch /var/.pcbsd-firstgui
NOTE: If you are using NVIDIA video hardware, load the driver before rebooting into the display wizard by running the command pc-metapkgmanager add NVIDIA.

[edit] Converting FreeBSD to a TrueOS® Server

If you wish to convert a FreeBSD server to TrueOS®, install the server package instead, then extract the installed utilities:

pkg install -fy pcbsd-utils                                                     

rehash pbreg set /PC-BSD/SysType TRUEOS pc-extractoverlay ports

pc-extractoverlay server

These steps will install the following: PBI Manager, the command line version of warden, and the command line versions of most of the Control Panel utilities. You will find those utilities in /usr/local/bin/pc-*.

References


  1. http://www.freebsd.org/doc/en/books/handbook/pkgng-intro.html
Other languages:German 8% • ‎English 100%