In February, 2013, PC-BSD® switched to a rolling release model. This is intended to make it easier for users to keep the packages that came with the operating system up-to-date and to make new features and drivers available for testing before the next major version is released. The rolling release is based on FreeBSD-STABLE. For terminology purposes, a release version is referred to as RELEASE and a rolling release version is referred to as STABLE.

In February, 2013, PC-BSD® switched to a rolling release model. This is intended to make it easier for users to keep the packages that came with the operating system up-to-date and to make new features and drivers available for testing before the next major version is released. The rolling release is based on FreeBSD-STABLE. For terminology purposes, a release version is referred to as RELEASE and a rolling release version is referred to as STABLE.

−

'''NOTE:''' PC-BSD 9.1-RELEASE was released on December 18, 2012. Users on this RELEASE will not see any of the [[What's_New_Since_9.1|new features]] until they upgrade to 9.2-RELEASE which is expected around August 31, 2013. Due to some new features which required ZFS layout changes, a new RELEASE version was made available for download from the PC-BSD website on July 19, 2013. 9.1-RELEASE users who wish to take advantage of these new features prior to the release of PC-BSD 9.2-RELEASE have the option of reinstalling using this latest version.

+

<!--T:22-->

+

'''NOTE:''' PC-BSD 9.1-RELEASE was released on December 18, 2012. Users on this RELEASE will not see any of the {{local|link=What's_New_Since_9.1|new features}} until they upgrade to 9.2-RELEASE which is expected around August 31, 2013. Due to some new features which required ZFS layout changes, a new RELEASE version was made available for download from the PC-BSD website on July 19, 2013. 9.1-RELEASE users who wish to take advantage of these new features prior to the release of PC-BSD 9.2-RELEASE have the option of reinstalling using this latest version.

<!--T:4-->

<!--T:4-->

−

The rolling release model is optional. This means that users can choose to either remain on a RELEASE or to upgrade an existing RELEASE to STABLE. Users that remain on RELEASE will still be notified of security updates and updates to software installed using AppCafe®. However, they will not receive updates to the packages installed with the operating system or any new features until they upgrade to the next RELEASE.

+

The rolling release model is optional. This means that users can choose to either remain on a RELEASE or to upgrade an existing RELEASE to STABLE. Users that remain on RELEASE will still be notified of security updates and updates to software installed using PC-BSD® utilities. However, they will not receive any new drivers or features until they upgrade to the next RELEASE.

+

<!--T:23-->

Currently, the schedule for updates is as follows:

Currently, the schedule for updates is as follows:

−

* '''RELEASE:''' pkgng software repository is updated on or about the 1st and 15th of each month.

+

<!--T:24-->

+

* '''RELEASE:''' PC-BSD® software repository is updated on or about the 1st and 15th of each month.

−

* '''STABLE:''' pkgng software repository is updated on or about the 5th and 20th of each month. In addition, a new update patch is issued on the 1st of each month which can be used to update to the latest STABLE.

+

<!--T:25-->

+

* '''STABLE:''' PC-BSD® software repository is updated on or about the 5th and 20th of each month. In addition, a new update patch is issued on the 1st of each month which can be used to update to the latest STABLE.

<!--T:5-->

<!--T:5-->

−

Users who wish to install a version of PC-BSD® which contains the latest operating system software and features can choose to install STABLE instead of RELEASE.

+

Users who wish to install a version of PC-BSD® which contains the latest operating system features can choose to install STABLE instead of RELEASE.

<!--T:6-->

<!--T:6-->

Line 25:

Line 29:

<!--T:7-->

<!--T:7-->

−

{{note|icon64=The rolling release model is new to PC-BSD® and glitches should be expected. RELEASE is recommended for users who prefer stability over the latest versions of software and who do not wish to test new features. STABLE is recommended for users who prefer to have the latest versions of software and who are willing to look for and [[Report Bugs |report bugs]].}}

+

{{note|icon64=The rolling release model is new to PC-BSD® and glitches should be expected. RELEASE is recommended for users who prefer stability and who do not wish to test new features. STABLE is recommended for users who are comfortable with finding and {{local|link=Report Bugs |reporting bugs}}.}}

−

=== Upgrading a 9.1-RELEASE System to STABLE === <!--T:8-->

+

=== Upgrading a RELEASE to STABLE === <!--T:8-->

<!--T:9-->

<!--T:9-->

−

To upgrade a PC-BSD® 9.1-RELEASE system to STABLE, become the superuser and edit the file

+

To upgrade a PC-BSD® RELEASE system to STABLE, become the superuser and edit the file

Once the edit is saved, you can use either [[Update Manager]] or [[Package Manager|'''pc-updatemanager''']] to upgrade to the latest STABLE. Once the upgrade is complete, it will automatically change the above line so that it looks like this:

+

Once the edit is saved, you can use either {{local|link=Update Manager}} or {{local|link=Package Manager|'''pc-updatemanager'''}} to upgrade to the latest STABLE. Once the upgrade is complete, it will automatically change the above line so that it looks like this:

−

<!--T:14-->

+

<!--T:14-->

−

PATCHSET: updates

+

{{txtbox|box=PATCHSET: updates}}

<!--T:15-->

<!--T:15-->

−

Around the 1st of each month, the upgrade to the next STABLE will appear in Update Manager. If you find a bug in a rolling release, please send an email with the details to the [http://lists.pcbsd.org/mailman/listinfo/testing testing mailing list].

+

Around the 1st of each month, the upgrade to the next STABLE will appear in Update Manager. If you find a bug in a rolling release, please report it using the [[PC-BSD® Bug Reporting]] utility.

<!--T:16-->

<!--T:16-->

−

{{note|icon64= As with any upgrade, always backup your data first. [[Life Preserver]] can be used to backup your home directory to another system in your network.}}

+

{{note|icon64= As with any upgrade, always backup your data first. {{local|link=Life Preserver}} can be used to backup your home directory to another system in your network.}}

−

=== Installing a Rolling Release === <!--T:17-->

+

=== Installing STABLE === <!--T:17-->

<!--T:18-->

<!--T:18-->

−

To install a rolling release from DVD or USB media, or to try a live USB image, select the desired architecture and media type from this [http://mirrors.isc.org/pub/pcbsd/9.1-RELEASE/ FTP server]. Rolling releases will always have a date in the media name and you should choose the most recent date. After downloading the desired file, you can install or use the live image as usual, as described in Chapters 2-4 of this Handbook.

+

To install the latest STABLE version from DVD or USB media, or to try a live USB image, select the desired media type from the [http://iso.cdn.pcbsd.org/9-STABLE/amd64/ PC-BSD CDN]. Rolling releases always have a date in the media name and you should choose the most recent date. After downloading the desired file, you can install or use the live image as usual, as described in Chapters 2-4 of this Handbook.

<!--T:19-->

<!--T:19-->

−

Once installed, a rolling release will automatically notify you when a newer rolling release becomes available. You can use either [[Update Manager]] or [[Meta Package Manager | '''pc-updatemanager''']] to upgrade to the newer rolling release.

+

Once installed, STABLE will automatically notify you when a newer STABLE version becomes available. You can use either {{local|link=Update Manager}} or {{local|link=Package Manager|'''pc-updatemanager'''}} to upgrade to the latest STABLE.

<!--T:20-->

<!--T:20-->

−

Before upgrading, backup your data and check the announcement on the [http://blog.pcbsd.org|PC-BSD® blog] to see which features are new and any known caveats. If you find a bug in that rolling release, either leave a comment on the associated blog post or send an email with the details to the [http://lists.pcbsd.org/mailman/listinfo/testing testing mailing list].

+

Before upgrading, always backup your data. If you find a bug in a STABLE version, please report it using the [[PC-BSD® Bug Reporting]] utility.

<!--T:21-->

<!--T:21-->

<noinclude>

<noinclude>

−

<!-- {{refheading}} --><!-- uncomment this when citelink is used on this page. -->

+

{{refheading}}

[[category:Using a Rolling Release]]

[[category:Using a Rolling Release]]

[[category:Advanced Installation Topics]]

[[category:Advanced Installation Topics]]

Revision as of 12:23, 26 September 2013

(Sorry for the inconvenience)

Editor: please update template:UseTOC/9.2

Translator: please use {{UseTOC{{putVers}}|TOC}}

Protection (edit): sysopEdited by: Drulavigne

In February, 2013, PC-BSD® switched to a rolling release model. This is intended to make it easier for users to keep the packages that came with the operating system up-to-date and to make new features and drivers available for testing before the next major version is released. The rolling release is based on FreeBSD-STABLE. For terminology purposes, a release version is referred to as RELEASE and a rolling release version is referred to as STABLE.

NOTE: PC-BSD 9.1-RELEASE was released on December 18, 2012. Users on this RELEASE will not see any of the new features until they upgrade to 9.2-RELEASE which is expected around August 31, 2013. Due to some new features which required ZFS layout changes, a new RELEASE version was made available for download from the PC-BSD website on July 19, 2013. 9.1-RELEASE users who wish to take advantage of these new features prior to the release of PC-BSD 9.2-RELEASE have the option of reinstalling using this latest version.

The rolling release model is optional. This means that users can choose to either remain on a RELEASE or to upgrade an existing RELEASE to STABLE. Users that remain on RELEASE will still be notified of security updates and updates to software installed using PC-BSD® utilities. However, they will not receive any new drivers or features until they upgrade to the next RELEASE.

Currently, the schedule for updates is as follows:

RELEASE: PC-BSD® software repository is updated on or about the 1st and 15th of each month.

STABLE: PC-BSD® software repository is updated on or about the 5th and 20th of each month. In addition, a new update patch is issued on the 1st of each month which can be used to update to the latest STABLE.

Users who wish to install a version of PC-BSD® which contains the latest operating system features can choose to install STABLE instead of RELEASE.

The rest of this section will demonstrate how to upgrade a RELEASE to STABLE. It also describes how to install a STABLE version.

The rolling release model is new to PC-BSD® and glitches should be expected. RELEASE is recommended for users who prefer stability and who do not wish to test new features. STABLE is recommended for users who are comfortable with finding and reporting bugs.

Upgrading a RELEASE to STABLE

To upgrade a PC-BSD® RELEASE system to STABLE, become the superuser and edit the file
/usr/local/share/pcbsd/pc-updatemanager/conf/sysupdate.conf. Change this line:

PATCHSET: pcbsd

to

PATCHSET: pcbsdtest

Once the edit is saved, you can use either Update Manager or pc-updatemanager to upgrade to the latest STABLE. Once the upgrade is complete, it will automatically change the above line so that it looks like this:

PATCHSET: updates

Around the 1st of each month, the upgrade to the next STABLE will appear in Update Manager. If you find a bug in a rolling release, please report it using the PC-BSD® Bug Reporting utility.

As with any upgrade, always backup your data first. Life Preserver can be used to backup your home directory to another system in your network.

Installing STABLE

To install the latest STABLE version from DVD or USB media, or to try a live USB image, select the desired media type from the PC-BSD CDN. Rolling releases always have a date in the media name and you should choose the most recent date. After downloading the desired file, you can install or use the live image as usual, as described in Chapters 2-4 of this Handbook.

Once installed, STABLE will automatically notify you when a newer STABLE version becomes available. You can use either Update Manager or pc-updatemanager to upgrade to the latest STABLE.

Before upgrading, always backup your data. If you find a bug in a STABLE version, please report it using the PC-BSD® Bug Reporting utility.