Changeset 2631f77


Ignore:
Timestamp:
05/12/15 08:55:01 (4 months ago)
Author:
dlavigne <dru@…>
Branches:
master, releng/10.2, stable/10
Children:
cf7eb94
Parents:
2c479c1
git-author:
dlavigne <dru@…> (05/12/15 08:54:37)
git-committer:
dlavigne <dru@…> (05/12/15 08:55:01)
Message:

Review of Chapter 7. Also start to update some desktop screenshots.

Location:
src-qt5/docs
Files:
4 edited

Legend:

Unmodified
Added
Removed
  • src-qt5/docs/update.rst

    rdd87b4b r2631f77  
    88provides the graphical :ref:`AppCafe®` and :ref:`Update Manager` utilities for managing and upgrading software from the local system or from a web browser or 
    99mobile device. Since TrueOS® is a command-line only install and some users prefer to use command-line utilities, both PC-BSD® and TrueOS® provide the 
    10 :ref:`PBI Manager` suite of command line utilities and :command:`pkg` to manage software and :command:`pc-updatemanager` to manage updates. If you install 
     10:ref:`PBI Manager` suite of command line utilities and :command:`pkg` to manage software, as well as :command:`pc-updatemanager` to manage updates. If you install 
    1111software using any of the tools described in this chapter, you will automatically be notified whenever a newer version of software is available. 
    1212 
     
    2020========= 
    2121 
    22 AppCafe® provides an intuitive, graphical method for installing and managing PBIs and packages. PBIs are FreeBSD packages that contain extra meta-data which 
     22AppCafe® provides an intuitive, graphical method for installing and managing PBIs and packages. PBIs are packages that contain extra meta-data which 
    2323is displayed in AppCafe®, such as screenshots and lists of similar applications. 
    2424 
     
    7171on the system. Click "Apply" to complete the configuration. You will be prompted to input your password to save the configuration. 
    7272 
    73 When using AppCafe® to access a system with a public network it is highly recommended to configure the network firewall to only allow connections over 
     73When using AppCafe® to access a system from a public network, it is highly recommended to configure the local firewall to only allow connections over 
    7474the specified port number and from allowed IP address(es). 
    7575 
     
    8282The :file:`/usr/local/etc/appcafe.conf` file stores the configuration used by AppCafe® and can be edited in a text editor. By default, the "remote", 
    8383"port", and "ssl" options are set using the information you provided either during a server installation or using the screen shown in Figure 7.1c. 
    84 The "mode" option is not set by default, but can be by removing the comment symbol (";") from that option and setting its value to either 
     84The "mode" option is not set by default, but can be configured by removing the comment symbol (";") from that option and setting its value to either 
    8585"desktop", "server", or "appliance". Here are the descriptions of the available modes as listed in that file:: 
    8686 
     
    116116PBIs within that category. 
    117117 
    118 To view all of the applications installed on the system or jail you are "Viewing Apps for:", click "Installed Apps" in the top bar. The applications will be 
     118To view all of the applications installed on the system or jail you are "Viewing Apps for:", click the "Installed Apps" tab. The applications will be 
    119119listed in alphabetical order. Click the name of an application to view more information about the application. 
    120120 
     
    133133* A hyperlink to the application's website. In this example, clicking "Mozilla" will open the application's website in the user's default web browser. 
    134134 
    135 * A hyperlink to the application's information at `freshports.org <freshports.org>`_. Click the arrow icon next to Mozilla to open that website in the user's default web browser. 
     135* A hyperlink to the application's information at `freshports.org <freshports.org>`_. Click the arrow icon next to "Mozilla" to open the FreshPorts website in the user's 
     136  default web browser. 
    136137 
    137138* A rating of up to five stars. Click the stars to open the PC-BSD® wiki page for the application. If you login to the wiki and hover the mouse over the 
     
    174175software with "browser" in the name as well as applications which provide browser functionality, such as Firefox.  
    175176 
    176 By default, only PBIs are searched. To search for all available software, include packages, check the "Search all available PBI and packages" box. 
     177By default, only PBIs are searched. To search for all available software, including packages, check the "Search all available PBI and packages" box. 
    177178 
    178179.. index:: AppCafe® 
     
    183184 
    184185To create, delete, and manage jails, click the "Warden" tab. If you have not yet created any jails on the system, a message will appear. Click the "create a new jail" 
    185 link in the message which will open the screen shown in Figure 7.1f. 
     186link in the message, or the "Create Jail" tab, to open the screen shown in Figure 7.1f. 
    186187 
    187188**Figure 7.1f: Adding a New Jail** 
     
    219220.. image:: images/remote8.png 
    220221 
    221 .. note:: if any updates are available for the software installed within any of the jails, an "Updates available" link with a yellow triangle icon will appear 
    222    just under the orange bar. Clicking this link will display a hyperlink for each jail that has updates. For example, click the link "Update packages for 
    223    jail1" to see the update details for "jail1".  
    224  
     222.. note:: if any updates are available for the software installed within any of the jails, an "Updates available" link with a yellow triangle icon will appear. 
     223   Clicking this link will display a hyperlink for each jail that has updates. For example, click the link "Update packages for jail1" to see the update details for "jail1".  
    225224 
    226225.. index:: pkg 
     
    230229=========================== 
    231230 
    232 For managing packages from the command line, PC-BSD® uses :command:`pkg`, the next generation package management system for FreeBSD. To manage PBIs from the 
    233 command line, refer to :ref:`PBI Manager`. If you are used to using the traditional FreeBSD package system, take note that the commands used to install and 
    234 manage software differ slightly. For example, instead of using :command:`pkg_add` to install a package from a remote repository, use :command:`pkg install` or 
    235 :command:`pc-pkg install` (notice there is now a space instead of an underscore). 
    236  
    237 The `FreeBSD Handbook <http://www.freebsd.org/doc//books/handbook/pkgng-intro.html>`_ provides an introduction to using :command:`pkg`. Section 5.4.1 is not 
     231PC-BSD® uses :command:`pkg` to manage packages from the command line. To manage PBIs from the command line, instead refer to :ref:`PBI Manager`. 
     232 
     233The `FreeBSD Handbook <http://www.freebsd.org/handbook/pkgng-intro.html>`_ provides an introduction to using :command:`pkg`. Section 5.4.1 is not 
    238234needed on a PC-BSD® or TrueOS® system as the operating system installation does this for you. The various :command:`pkg` commands have associated man pages. 
    239235Type :command:`man pkg` for an overview of general usage; the names of the associated man pages will be found towards the bottom of this man page. Once you 
     
    309305* **Routing through Tor:** check this box to start browsing the Internet anonymously as described in :ref:`Tor Mode`. 
    310306 
    311 * **Check Tor connection:** click this to determine if the system is currently routing all traffic through the Tor network. 
     307* **Check Tor connection:** click this to determine if the system is currently routing all Internet traffic through the Tor network. 
    312308 
    313309* **Quit:** to remove Update Manager from the system tray, click this entry. You can put the icon back into the tray by typing :command:`pc-systemupdatertray &`. 
     
    322318version 10.1.1, the following steps occur automatically during an update:  
    323319 
    324 * the update automatically creates a copy of the current operating system, known as a snapshot or boot environment (BE), and mounts that snapshot in the 
     320* The update automatically creates a copy of the current operating system, known as a snapshot or boot environment (BE), and mounts that snapshot in the 
    325321  background. All of the updates then occur in the snapshot. This means that you can safely continue to use your system while it is updating as no changes are 
    326322  being made to the operating system or any of the applications currently in use. Instead, all changes are being made to the mounted copy. 
     
    329325   not enough space to perform the update. 
    330326 
    331 * while the update is occurring, and until you reboot after the update, you won't be able to use AppCafe® to manage software. This is a safety measure to prevent 
     327* While the update is occurring, and until you reboot after the update, you won't be able to use AppCafe® to manage software. This is a safety measure to prevent 
    332328  package conflicts. Also, the system shutdown and restart buttons will be greyed out until the update is complete and the system is ready for reboot. Should a power 
    333329  failure occur in the middle of an update, the system will reboot into the current boot environment, returning the system to the point before the upgrade started. 
    334330  Simply restart the update to continue the update process. 
    335331 
    336 * once the update is complete, the new boot environment, or updated snapshot, is added as the first entry in the boot menu and activated so that the system 
     332* Once the update is complete, the new boot environment, or updated snapshot, is added as the first entry in the boot menu and activated so that the system 
    337333  will boot into it, unless you pause the boot menu and specify otherwise. A pop-up message, shown in Figure 7.3b, will indicate that a reboot is required. 
    338334  You can either finish what you are doing and reboot now into the upgraded snapshot, or ask the system to remind you again at a later time. To configure the 
     
    341337  until you reboot. 
    342338 
    343 * as the update is running, a log is written to :file:`/var/log/pc-updatemanager.log` and this log is displayed in the "View Log" tab of the graphical Update 
     339* As the update is running, a log is written to :file:`/var/log/pc-updatemanager.log` and this log is displayed in the "View Log" tab of the graphical Update 
    344340  Manager utility, shown in Figure 7.3c. This way you can see which software is being updated and if there are any updating errors. The next time an update occurs, 
    345341  the previous log is written to :file:`/var/log/pc-updatemanager.log.prev`, so that you also have a copy of the previous update's log. 
    346342 
    347 * you no longer need to initiate updates manually. PC-BSD® now uses an automated updater that automatically checks for updates, no more than once per day, 20 
     343* You no longer need to initiate updates manually. PC-BSD® now uses an automated updater that automatically checks for updates, no more than once per day, 20 
    348344  minutes after a reboot and then every 24 hours. You can configure what gets updated using the "Configure Automatic Updates" tab of Update Manager, shown in 
    349345  Figure 7.3d. Choices are "Security & Packages" (all updates), "Security" (only security patches and operating system updates), "Packages" (only installed 
     
    397393Due to its schedule, the automatic updater will never check for new updates more than once in a 24 hour period. To manually check for updates, right-click the 
    398394Update Manager in system tray and click "Check for Updates". Alternatively, start Update Manager. If any updates are available, an "Updates Available" tab 
    399 will appear, as seen in the example in Figure 7.3g. If no updates are available, this tab will not appear. 
     395will appear, as seen in the example in Figure 7.3g. If no updates are available, of if the system is currently updating, this tab will not appear. 
    400396 
    401397**Figure 7.3g: System Updates are Available** 
     
    465461 ------------------------------------ 
    466462 
    467 If any updates are available, follow the instructions to install the updateh:: 
     463If any updates are available, follow the instructions to install the update:: 
    468464 
    469465 sudo pc-updatemanager fbsdupdate 
     
    594590-------------------------- 
    595591 
    596 PC-BSD® has switched to ZFS-only. This means that you can **not** upgrade a system that is either 32-bit or formatted with UFS. If the hardware supports 
     592PC-BSD® 10.x has switched to 64-bit and ZFS-only. This means that you can **not** upgrade a system that is either 32-bit or formatted with UFS. If the hardware supports 
    59759364-bit, you will need to backup your important data to another system or external drive and then perform a new installation. The new installation will perform 
    598594a format of the selected disk(s) with ZFS. 
     
    610606Manager as a package update, for both "Edge" and "Production" users, or in the listing of :command:`pc-updatemanager pkgcheck`. 
    611607 
    612 .. note:: a fresh install, rather than an update, is required if you wish to take advantage of any of the following features: UEFI boot (on a current non-UEFI 
    613    installation), disk encryption, or the 
     608.. note:: a fresh install, rather than an update, is only required if you wish to take advantage of any of the following features: UEFI boot (on a current non-UEFI 
     609   installation), full disk encryption, or the 
    614610   `improved encryption key generation provided by GELIv7 <https://github.com/freebsd/freebsd/commit/38de8ef1dd0e468ff1e3ec1c431f465e270beba3>`_. This means 
    615    that you will have to backup your data to an external drive or another system, perform the install, than restore your data from backup. 
     611   that you will have to backup your data to an external drive or another system, perform the new install, then restore your data from the backup. 
    616612 
    617613.. index:: software 
     
    709705 sudo pbi_add alpine 
    710706 Password: 
    711  Updating repository catalogue  
    712  Installing: alpine The following 2 packages will be installed:  
    713  Installing pico-alpine: 2.00_1 
    714  Installing alpine: 2.00_4 
    715  The installation will require 9 MB more space  
    716  2 MB to be downloaded  
    717  pico-alpine-2.00_1.txz 100% 314KB 313.9KB/s 313.9KB/s 00:01  
    718  alpine-2.00_4.txz 100% 1701KB 1.7MB/s 1.4MB/s 00:01  
    719  Checking integrity... done The following 2 packages will be installed:  
    720  Installing pico-alpine: 2.00_1 
    721  Installing alpine: 2.00_4 
    722  The installation will require 9 MB more space  
    723  0 B to be downloaded  
    724  Checking integrity... done  
    725  [1/2] Installing pico-alpine-2.00_1... done  
    726  [2/2] Installing alpine-2.00_4... done  
    727  ****************************************************************  
    728  *** To use GnuPG with Alpine, take a look at the mail/pine-pgp-filters port ***  
    729  ****************************************************************  
     707 Updating pcbsd-major repository catalogue... 
     708 pcbsd-major repository is up-to-date. 
     709 All repositories are up-to-date. 
     710 Installing: alpine 
     711 Updating pcbsd-major repository catalogue... 
     712 pcbsd-major repository is up-to-date. 
     713 All repositories are up-to-date. 
     714 The following 2 package(s) will be affected (of 0 checked): 
     715 New packages to be INSTALLED: 
     716        alpine: 2.20 
     717        pico-alpine: 2.20_1 
     718 The process will require 9 MiB more space. 
     719 2 MiB to be downloaded. 
     720 Fetching alpine-2.20.txz: 100%    2 MiB   1.8MB/s    00:01     
     721 Fetching pico-alpine-2.20_1.txz: 100%  319 KiB 326.9kB/s    00:01     
     722 Checking integrity... done (0 conflicting) 
     723 [1/2] Installing pico-alpine-2.20_1... 
     724 [1/2] Extracting pico-alpine-2.20_1: 100% 
     725 [2/2] Installing alpine-2.20... 
     726 [2/2] Extracting alpine-2.20: 100% 
     727 Message for alpine-2.20: 
     728 ******************************************************************************* 
     729 *** To use GnuPG with Alpine, take a look at the mail/pine-pgp-filters port *** 
     730 ******************************************************************************* 
     731 Pruning: /usr/local/share/xsessions/[0-9a-zA-Z]*.desktop 
     732 Extracting ports overlay data...DONE 
     733 compat.linux.osrelease: 2.6.18 -> 2.6.18 
    730734 
    731735.. index:: PBI Manager 
     
    735739----------- 
    736740 
    737 The :command:`pbi_delete` command removes an installed PBI from the system. Table 7.4d summarizes its one available option:  
     741The :command:`pbi_delete` command removes an installed PBI from the system. Table 7.4d summarizes its available options. 
    738742 
    739743**Table 7.4d: pbi_delete Options** 
     
    753757 sudo pbi_delete alpine 
    754758 Password:  
    755  Updating repository catalogue  
    756  Deinstallation has been requested for the following 1 packages:  
    757  alpine-2.00_4 
    758  The deinstallation will free 8 MB  
    759  [1/1] Deleting alpine-2.00_4... done  
    760  Deinstallation has been requested for the following 2 packages:  
    761  openjpeg-2.1.0 
    762  pico-alpine-2.00_1 
    763  The deinstallation will free 2 MB  
    764  [1/2] Deleting openjpeg-2.1.0... done  
    765  [2/2] Deleting pico-alpine-2.00_1... done 
     759 Updating pcbsd-major repository catalogue... 
     760 All repositories are up-to-date. 
     761 Checking integrity... done (0 conflicting) 
     762 Deinstallation has been requested for the following 1 package (of 0 packages in the universe):  
     763 Installed packages to be REMOVED: 
     764 alpine-2.20 
     765 The operation will free 8 MiB  
     766 [1/1] Deinstalling alpine-2.20... 
     767 [1/1] Deleting files for alpine-2.20: 100% 
    766768 
    767769.. index:: PBI Manager 
     
    814816 
    815817.. index:: PBI Manager 
     818.. _pbi install: 
     819 
     820pbi install 
     821----------- 
     822 
     823The :command:`pbi install` command provides an alternative to :command:`pbi_add` and is also used to install PBIs. Table 7.4g summarizes its available options. 
     824 
     825**Table 7.4g: pbi install Options** 
     826 
     827+------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ 
     828| Switch                 | Description                                                                                                                       | 
     829+========================+===================================================================================================================================+ 
     830| **-f**                 | force installation, overwriting an already installed copy of the application                                                      | 
     831+------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ 
     832| **-i**                 | display information about specified PBI; if combined with **-v**, will display all of the files that will be installed with the   | 
     833|                        | PBI                                                                                                                               | 
     834+------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ 
     835| **-j <jailname>**      | installs the PBI into the specified jail                                                                                          | 
     836+------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ 
     837| **-J**                 | used to create a new jail and install specified PBI into it                                                                       | 
     838+------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ 
     839| **-l**                 | display :file:`LICENSE` text for specified PBI                                                                                    | 
     840+------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ 
     841| **-v**                 | enable verbose output                                                                                                             | 
     842+------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ 
     843| **--licagree**         | if the PBI has a license, agree to it                                                                                             | 
     844+------------------------+-----------------------------------------------------------------------------------------------------------------------------------+ 
     845 
     846.. index:: PBI Manager 
    816847.. _pbi_makeindex: 
    817848 
     
    840871create a custom repository. 
    841872 
    842 The :file:`INDEX` of a PBI repository must be digitally signed for security and identification purposes. In order to sign the :file:`INDEX`, first create an 
     873The :file:`INDEX` of a PBI repository should be digitally signed for security and identification purposes. In order to sign the :file:`INDEX`, first create an 
    843874OpenSSL key pair using the following commands:: 
    844875 
     
    854885These commands will create the files :file:`privkey.pem` and :file:`pub.key`. 
    855886 
    856 To create the customized PBI modules, follow the instructions in :ref:`Bulk Module Creator`. If the repository directory is :file:`~/myrepo/`, make sure that 
     887To create the customized PBI modules, follow the instructions in :ref:`Bulk Module Creator`. For example, if the repository directory is :file:`~/myrepo/`, make sure that 
    857888all of the custom modules are listed as subdirectories of that directory. 
    858889 
     
    882913.. _Import the Repository: 
    883914 
    884 Finally, to configure  to use the custom repository, go to :menuselection:`Configure --> Repository Settings`. Click "Custom" in the screen shown in Figure 7.5a, then 
    885 the "+" button. Input the URL to the repository and click "OK".  
     915Finally, on each client, configure :ref:`Appcafe®` to use the custom repository. Go to :menuselection:`Configure --> Repository Settings`. Click "Custom" in the screen 
     916shown in Figure 7.5a, then the "+" button. Input the URL to the repository and click "OK".  
    886917 
    887918**Figure 7.5a: Add the Custom Repository to AppCafe®** 
     
    897928============================= 
    898929 
    899 The official PC-BSD® package repository is hosted ad a `ScaleEngine <http://www.scaleengine.com/>`_ CDN (Content Delivery Network). It provides 
    900 the ability to :command:`rsync` your own copy of the package repository, which means you can have a locally hosted, complete package repository 
    901 available for your own clients. 
     930The official PC-BSD® package repository is hosted as a `ScaleEngine <http://www.scaleengine.com/>`_ CDN (Content Delivery Network). It is possible to 
     931:command:`rsync` a copy of the package repository, which means you can have a locally hosted, complete package repository available for your own clients. 
    902932 
    903933To create a local package mirror, first setup a directory which is served over HTTP. The web server can be a public URL on the Internet or a 
Note: See TracChangeset for help on using the changeset viewer.