diff --git a/helpers/DATA/update-manager/DistUpgrade.cfg b/helpers/DATA/ubuntu-release-upgrader/DistUpgrade.cfg similarity index 100% rename from helpers/DATA/update-manager/DistUpgrade.cfg rename to helpers/DATA/ubuntu-release-upgrader/DistUpgrade.cfg diff --git a/helpers/DATA/update-manager/DistUpgrade.cfg.robur b/helpers/DATA/ubuntu-release-upgrader/DistUpgrade.cfg.robur similarity index 100% rename from helpers/DATA/update-manager/DistUpgrade.cfg.robur rename to helpers/DATA/ubuntu-release-upgrader/DistUpgrade.cfg.robur diff --git a/helpers/DATA/update-manager/DistUpgrade.cfg.taranis b/helpers/DATA/ubuntu-release-upgrader/DistUpgrade.cfg.taranis similarity index 100% rename from helpers/DATA/update-manager/DistUpgrade.cfg.taranis rename to helpers/DATA/ubuntu-release-upgrader/DistUpgrade.cfg.taranis diff --git a/helpers/DATA/update-manager/index.docbook b/helpers/DATA/update-manager/index.docbook new file mode 100644 index 0000000000000000000000000000000000000000..2fde169e84198fd8feb3dca50aad39b8a16dc488 --- /dev/null +++ b/helpers/DATA/update-manager/index.docbook @@ -0,0 +1,931 @@ +<?xml version="1.0"?> +<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" + "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ +<!ENTITY legal SYSTEM "legal.xml"> +<!ENTITY GFDL SYSTEM "fdl-appendix.xml"> +]> +<!--<?yelp:chunk-depth 4?>--> +<!-- + (Do not remove this comment block.) + Version: 0.0.3 + Last modified: March 24, 2006 + Maintainers: + Sean Wheller <sean@inwords.co.za> + Jeff Schering <jeffschering@gmail.com> + Jerome S. Gotangco <jgotangco@ubuntu.com + Translators: + (translators put your name and email here) +--> +<!-- =============Document Header ============================= --> +<article id="index" lang="en"> + <!-- please do not change the id; for translations, change lang to --> + <!-- appropriate code --> + <articleinfo> + <title>Software Updater Manual</title> + <copyright> + <year>2006</year> + <holder>In Words</holder> + </copyright> + <!-- translators: uncomment this: + + <copyright> + <year>2000</year> + <holder>ME-THE-TRANSLATOR (Latin translation)</holder> + </copyright> + + --> + <!-- An address can be added to the publisher information. If a role is + not specified, the publisher/author is the same for all versions of the + document. --> + <publisher> + <!--<publishername> GNOME Documentation Project </publishername>--> + <publishername> + <ulink url="http://www.inwords.co.za">In Words Techdoc Solutions</ulink> + </publishername> + </publisher> &legal; + <!-- This file contains link to license for the documentation (GNU FDL), and + other legal stuff such as "NO WARRANTY" statement. Please do not change + any of this. --> + <authorgroup> + <author> + <firstname>Sean</firstname> + <surname>Wheller</surname> + <affiliation> + <orgname>In Words</orgname> + <address> + <email>sean@inwords.co.za</email> + </address> + </affiliation> + </author> + <othercredit role="editor"> + <firstname>Jeff</firstname> + <surname>Schering</surname> + <contrib>Editor</contrib> + </othercredit> + <othercredit role="maintainer"> + <firstname>Jerome</firstname> + <surname>Gotangco</surname> + <contrib>Maintainer</contrib> + </othercredit> + <!-- This is appropriate place for other contributors: translators, + maintainers, etc. Commented out by default. + <othercredit role="translator"> + <firstname>Latin</firstname> + <surname>Translator 1</surname> + <affiliation> + <orgname>Latin Translation Team</orgname> + <address> <email>translator@gnome.org</email> </address> + </affiliation> + <contrib>Latin translation</contrib> + </othercredit> +--> + </authorgroup> + <!-- According to GNU FDL, revision history is mandatory if you are --> + <!-- modifying/reusing someone else's document. If not, you can omit it. --> + <!-- Remember to remove the &manrevision; entity from the revision entries other +--> + <!-- than the current revision. --> + <!-- The revision numbering system for GNOME manuals is as follows: --> + <!-- * the revision number consists of two components --> + <!-- * the first component of the revision number reflects the release version of the GNOME desktop. --> + <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. --> + <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that --> + <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. --> + <!-- When the desktop release version changes to V3.x, the revision number of the manual changes --> + <!-- to V3.0, and so on. --> + <revhistory> + <revision> + <revnumber>V0.0.1</revnumber> + <date>06/03/2005</date> + <revdescription> + <para role="author">First version of the manual created in accordance + with Software Updater V0.37.1+svn20050301. Documentation Writer + <email>sean@inwords.co.za</email> + </para> + <para role="publisher"> + <ulink url="http://www.inwords.co.za">InWords Techdoc + Solutions</ulink> + </para> + </revdescription> + </revision> + <revision> + <revnumber>V0.0.2</revnumber> + <date>26/03/2005</date> + <revdescription> + <para role="author">Edit of V0.0.1 to make some nodes shorter. + Editor <email>jeffschering@gmail.com</email> + </para> + <para role="publisher"> + <ulink url="http://www.inwords.co.za">InWords Techdoc + Solutions</ulink> + </para> + </revdescription> + </revision> + <revision> + <revnumber>V0.0.3</revnumber> + <date>26/03/2005</date> + <revdescription> + <para role="author">Added Help, Add CD, Settings options. + <email>sean@inwords.co.za</email> + </para> + <para role="publisher"> + <ulink url="http://www.inwords.co.za">InWords Techdoc + Solutions</ulink> + </para> + </revdescription> + </revision> + </revhistory> + <releaseinfo>This manual explains how to use Software Updater, an apt update + management application for the GNOME desktop created by the Ubuntu + project.</releaseinfo> + <legalnotice> + <title>Feedback</title> + <!--<para>To report a bug or make a suggestion regarding this package or this + manual, follow the directions in the <ulink url="ghelp:gnome-feedback" + type="help">GNOME Feedback Page</ulink>. </para>--> + <para>To report a bug or make a suggestion regarding this package or this + manual, send mail to <email>trisquel-devel@listas.trisquel.info</email>.</para> + <!-- Translators may also add here feedback address for translations --> + </legalnotice> + </articleinfo> + <!-- ============= Document Body ============================= --> + <!-- ============= Introduction ============================== --> + <sect1 id="intro"> + <title>Introduction</title> + <para> + <application>Software Updater</application> is a graphical interface to the + software update features of <application>Advanced Packaging + Tool</application> (<acronym>APT</acronym>). <acronym>APT</acronym> is a + command line tool for installing, updating, and removing software.</para> + <para> + <application>Software Updater</application> makes the task of checking for + and installing software updates as effortless as possible. + <application>Software Updater</application> keeps your system up to date + by checking Trisquel's software repositories for new versions of installed + software. The new versions usually contain bug fixes and new features, but + may also contain security updates. Use Software Updater on a regular basis + to ensure that your system is as up to date and secure as possible.</para> + <para> + <application>Software Updater</application> decides which software needs to + be updated by comparing the version numbers of individual software files + on your computer with the software in one or more software repositories. + The software repositories are usually on remote network servers, but may + also be on a CD-ROM. Whenever <application>Software Updater</application> + notifies you that an update is available, you may choose to install the + update immediately, or to ignore the update.</para> + <para> + <application>Software Updater</application> has settings and preferences + which allow you to: set how often it checks for updates, add and remove + software repositories, and manage repository authentication keys. </para> + </sect1> + <sect1 id="getting-started"> + <title>Getting Started</title> + <sect2 id="installation"> + <title>Installation</title> + <para> + <application>Software Updater</application> is installed as part of the + Trisquel standard installation, and should already be on your system. The + application is known as <application>Trisquel Update + Manager</application>. If you need to install <application>Update + Manager</application>, you can use <application>Synaptic Package + Manager</application>. Choose <menuchoice> + <guimenu>System</guimenu> + <guisubmenu>Administration</guisubmenu> + <guimenuitem>Synaptic Package Manager</guimenuitem> + </menuchoice> to start <application>Synaptic</application>. The package + you need to install is <command>update-manager</command>.</para> + <para>You may also install Software Updater from the command line using + <command>apt-get</command>. To install <application>Update + Manager</application> from the command line:</para> +<programlisting> +sudo apt-get install update-manager +</programlisting> + <para> + <application>Software Updater</application> is dependent on the following + packages: 'python,' 'python-gnome2,' + 'python-apt,' 'synaptic,' and + 'lsb-release.'</para> + </sect2> + <sect2 id="starting-update-manager"> + <title>Starting Software Updater</title> + <para>Choose <menuchoice> + <guimenu>System</guimenu> + <guisubmenu>Administration</guisubmenu> + <guimenuitem>Trisquel Software Updater</guimenuitem> + </menuchoice> to start the application. Enter your password when + prompted.</para> + <para>You may also start <application>Software Updater</application> from + the command line:</para> +<programlisting> +update-manager +</programlisting> + </sect2> + <sect2 id="main-window"> + <title>Main Window</title> + <para>The <application>Software Updater</application> main window is used for + managing the update process and setting preferences.</para> + <para>When you open <application>Software Updater</application>, the main + window displays the list of packages that need to be installed to update + your computer. If the software on your computer is up to date, the main window contains + only the message "The software on this computer is up to date." </para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/main-system-updates-available.png" + format="PNG"/> + </imageobject> + <caption> + <para>Available Updates</para> + </caption> + </mediaobject> + </screenshot> + </sect2> + </sect1> + <sect1 id="performing-updates"> + <title>Performing Updates</title> + <sect2 id="updating"> + <title>Updating Your Computer</title> + <para>When you open <application>Software Updater</application>, the main + window displays the list of packages that need to be installed to update + your computer. If the software on your computer is up to date, the main window contains + only the message "The software on this computer is up to date." </para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/main-system-updates-available.png" + format="PNG"/> + </imageobject> + <caption> + <para>Available Updates</para> + </caption> + </mediaobject> + </screenshot> + <para>By default, all packages are marked for installation. In most + cases you will install all of the packages right away. However, if there + are a large number of updates you may want to do only a few at a time.</para> + <para>To un-mark a package for installation, <action>clear</action> the check box + for the package.</para> + <para>To see additional information about a package, <action>click</action> on + <guibutton>Details</guibutton>. + (see <xref linkend="expanding-update-info"/>)</para> + <para>When you are ready to install the selected packages, + <action>click</action> on <guibutton>Install</guibutton>.</para> + <para>If <application>Software Updater</application> detects one or more + packages without a digital signature, the + <guilabel>Summary</guilabel> dialog is displayed.</para> + <para>The <guilabel>Summary</guilabel> dialog lists three groups of update + categories:</para> + <variablelist> + <varlistentry> + <term> + <emphasis role="bold">NOT AUTHENTICATED</emphasis> + </term> + <listitem> + <para>Packages without a digital signature.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">To be upgraded</emphasis> + </term> + <listitem> + <para>Packages that will be upgraded.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Unchanged</emphasis> + </term> + <listitem> + <para>Packages that will not be upgraded due to dependency issues. + The packages will be upgraded in a future <application>Update + Manager</application> session, once the developers have + resolved the package dependencies.</para> + </listitem> + </varlistentry> + </variablelist> + <para>If you do not want to install non-authenticated packages, click + <guibutton>Cancel</guibutton>. The <guilabel>Summary</guilabel> + dialog will close, and you can + deselect the packages in the <application>Software Updater</application> + main window.</para> + <note> + <para>If a deselected package is required as a dependency for a selected + package, <application>Software Updater</application> will install the + deselected package to satisfy the dependency.</para> + </note> + <para> + <application>Software Updater</application> downloads all of the + selected packages before installing them. The entire process might take a + long time depending on the amount of data that needs to be downloaded, the + speed of your network connection, and the number of packages that need to + be installed. While downloading packages, + <application>Software Updater</application> displays a dialog box that + monitors the download progress. (See <xref + linkend="monitoring-download"/>).</para> + </sect2> + <sect2 id="expanding-update-info"> + <title>Expanded Update Information</title> + <para>To see additional information about a package:</para> + <orderedlist> + <listitem> + <para>Click on the package in the main window.</para> + </listitem> + <listitem> + <para>Click on <guibutton>Details</guibutton>.A tabbed section + opens within the main window.</para> + </listitem> + </orderedlist> + <para>The tabs are as follows:</para> + <variablelist> + <varlistentry> + <term> + <emphasis role="bold">Changes</emphasis> + </term> + <listitem> + <para>A list of the changes incorporated in the package. The list + is the contents of the <filename>ChangeLog</filename> file for the + package.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Description</emphasis> + </term> + <listitem> + <para>A short description of each program in the package.</para> + </listitem> + </varlistentry> + </variablelist> + </sect2> + <sect2 id="monitoring-download"> + <title>Monitoring Download Progress</title> + <para><application>Software Updater</application> displays the + <guilabel>Installing updates</guilabel> window while the + packages are downloading. The progress bar in the + <guilabel>Installing updates</guilabel> window shows the progress + of the entire update.</para> + <para>To display the download progress of each package, click on + <guibutton>Show progress of individual files</guibutton>.</para> + <para>To cancel the download, click <guibutton>Cancel</guibutton>. + </para> + <para>All files must be downloaded before <application> + Software Updater</application> can proceed to the installation stage. If + the network connections fails or if you cancel the download, the update + will not be installed.</para> + <note> + <para>To resume a canceled or failed download, click on Install in the + main window. <application>Software Updater</application> will resume the + download from the last successfully downloaded file.</para> + </note> + </sect2> + <sect2 id="monitoring-installation"> + <title>Monitoring Installation Progress</title> + <para><application>Software Updater</application> displays the + <guilabel>Installation updates</guilabel> window while the updates are + being installed. The progress bar inside the <guilabel>Installation + updates</guilabel> window shows the progress of the entire installation. + </para> + <para>To display the installation progress of each package, click on + <guibutton>Terminal</guibutton>. The terminal view opens within the + window. The terminal view displays the unfiltered output of the Advanced + Packaging Tool (APT). APT is the tool that Software Updater uses to + perform the update.</para> + <caution> + <para>Do not terminate the installation process. This may lead to + corruption of installed programs and general system + instability.</para> + </caution> + </sect2> + </sect1> + <sect1 id="setting-preferences"> + <title>Setting Preferences</title> + <para>The <application>Software Updater</application> + <guibutton>Preferences</guibutton> button displays the <guilabel>Software + Preferences</guilabel> dialog. From this dialog you can perform the + following tasks:</para> + <itemizedlist> + <listitem> + <para>Manage software sources (see <xref linkend="managing-sources" + />).</para> + </listitem> + <listitem> + <para>Manage authentication keys (see <xref + linkend="managing-authentication"/>).</para> + </listitem> + <listitem> + <para>Manage settings (see <xref linkend="managing-settings"/>).</para> + </listitem> + </itemizedlist> + <sect2 id="managing-sources"> + <title>Managing Software Sources</title> + <para>During installation of a distro, software repositories are + automatically added to the list of 'software sources.' + Typical sources added by the distro installation include the + installation source, update, and security repositories. Sources can be + added to and removed from the list and existing sources can be edited.</para> + <note> + <para>The operations described here modify <filename class="devicefile" + >/etc/apt/sources.list</filename> using the <application>Update + Manager</application> graphical user interface. Software sources can + also be managed by making direct modifications in <filename + class="devicefile">/etc/apt/sources.list</filename>. This is only + advised for advanced users.</para> + </note> + <sect3 id="adding-sources"> + <title>Adding Software Sources</title> + <para>Software may be installed using various access methods:</para> + <itemizedlist> + <listitem> + <para> + <emphasis>CD-ROM</emphasis> - Compact Disk Read Only Memory, + normally directly connected to the computer system and mounted + locally by the operating system.</para> + </listitem> + <!-- Currently unsupported see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=60910 --> + <!-- mvo: is handled with cdrom URIs --> + <!--<listitem> + <para> + <emphasis>DVD</emphasis> - Digital Video Disk, normally directly + connected to the computer system and mounted locally by the + operating system.</para> + </listitem>--> + <listitem> + <para> + <emphasis>FTP</emphasis> - File Transfer Protocol, a secure and + reliable protocol designed specifically for the purpose of + transferring large files across the Internet.</para> + </listitem> + <listitem> + <para> + <emphasis>HTTP</emphasis> - HyperText Transfer Protocol, commonly + used to request and receive Web pages, but can also be used for + file transfer.</para> + </listitem> + <listitem> + <para> + <emphasis>SMB</emphasis> - Server Management Block is used to + access shared resources on computers running Microsoft + <trademark>Windows</trademark> or <application>Samba + Server</application>.</para> + </listitem> + <listitem> + <para> + <emphasis>NFS</emphasis> - Network File System is used to access + shared resources on Linux/UNIX computers.</para> + </listitem> + </itemizedlist> + <note> + <para>Before software sources residing on SMB or NFS shares can be + defined, the share must be mounted by the local system. Access can + then be made via the local filesystem. For more information see + <xref linkend="editing-sources"/>.</para> + </note> + <para>A new software source can be defined by <action>clicking</action> + the <guibutton>Add</guibutton> button located on the + <guilabel>Software Preferences</guilabel> dialog. This will + display the <guilabel>Edit Repository</guilabel> dialog.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/preferences-add.png" format="PNG"/> + </imageobject> + <caption> + <para>Adding Software Sources</para> + </caption> + </mediaobject> + </screenshot> + <para>Complete the <guilabel>Edit Repository</guilabel> dialog to add + a new Software source.</para> + <variablelist> + <varlistentry> + <term> + <emphasis role="bold">Repository</emphasis> + </term> + <listitem> + <para>The Trisquel software repository contains thousands of + software packages that comply with the Free Software Philosophy.</para> + </listitem> + </varlistentry> + </variablelist> + </sect3> + <sect3 id="create-custom-sources"> + <title>Creating Custom Software Sources</title> + <para>It is also possible to define custom software sources.</para> + <para>To define a custom software source <action>click</action> the + <guibutton>Custom</guibutton> button located on the <guilabel>Edit + Repository</guilabel> dialog. This will display a dialog in which + the custom repository can be defined using + <application>apt</application> command syntax. + <application>Apt</application> is an Advanced Packaging Tool and + front-end to <application>dpkg</application> the Debian Package + Management System. Once the <guilabel>apt line</guilabel> is entered + <action>click</action> the <guibutton>Add repository</guibutton> + button.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/preferences-add-custom.png" + format="PNG"/> + </imageobject> + <caption> + <para>Creating Custom Software Sources</para> + </caption> + </mediaobject> + </screenshot> + <para>The <application>apt</application> command syntax defines the + 'type,' 'location,' and + 'content' of the repository. Example of the command + syntax could look like this.</para> + <programlisting> +<command>deb ftp://archive.trisquel.info/trisquel/ belenos main</command> + </programlisting> + <para>This example would define the software sources as a Debian source + at trisquel.info containing the belenos release. + </para> + </sect3> + <sect3 id="remove-sources"> + <title>Removing Software Sources</title> + <para>Software sources can be removed from the sources list by selecting + the software source then <action>clicking</action> the + <guibutton>Remove</guibutton> button located on the + <guilabel>Software Preferences</guilabel> dialog.</para> + <para>Removal of a software source requires that the + <application>apt</application> file (<filename class="devicefile" + >/etc/apt/sources.list</filename>) that contains the a list of + software sources is updated. Before modifying this file + <application>Software Updater</application> prompts to confirm the + operation. If the operation is confirmed a backup copy is create in + <filename class="devicefile" + >/etc/apt/sources.list.save</filename>.</para> + </sect3> + <sect3 id="editing-sources"> + <title>Editing Software Sources</title> + <para>To change the values defining a software source, select the source + record then <action>click</action> the edit button. This will display + the <guilabel>Edit Repository</guilabel> dialog.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/preferences-edit.png" format="PNG"/> + </imageobject> + <caption> + <para>Editing Software Sources</para> + </caption> + </mediaobject> + </screenshot> + <variablelist> + <varlistentry> + <term> + <emphasis role="bold">Type</emphasis> + </term> + <listitem> + <para>Software sources may contain software in + 'Binary' or 'Source Code' + format. Select the option correlating to the repository + format.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">URI</emphasis> + </term> + <listitem> + <para>Enter a valid Uniform Resource Indicator + (<acronym>URI</acronym>). Following is a list of examples for + each of the possible access methods:</para> + <itemizedlist> + <listitem> + <para> + <!-- mvo: we don't want users to add the cd manually + new CDs with trisquel will be detected + automatically when inserted and it will prompt + for action (start package manager, + upgrade from it) + *mvo* either the sources edit window needs a "add-cdrom" butotn or the user needs to run synaptic + *froud* I would say add a "Add CDROM" + *mvo* yeah + *mvo* I'll file a wishlist bug to myself + *mvo* update-manger should have "add-cdrom" is bug #7315 + --> + <emphasis>CD-ROM</emphasis> - + <command>cdrom:[description_of_cd]/</command> + </para> + </listitem> + <!-- Currently unsupported see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=60910 --> + <!-- mvo: is handled with cdrom URIs --> + <!--<listitem> + <para> + <emphasis>DVD</emphasis> - + <command>dvd:[description_of_dvd]/</command> + </para> + </listitem>--> + <listitem> + <para> + <emphasis>FTP</emphasis> - + <command>ftp://ftp.domain.ext/path/to/repository</command> + </para> + </listitem> + <listitem> + <para> + <emphasis>HTTP</emphasis> - + <command>http://www.domain.ext/path/to/repository</command> + </para> + </listitem> + <listitem> + <para> + <emphasis>SMB</emphasis> - Works only when the computer is + already connected to an SMB share. To connect to SMB share + use the following command syntax from the shell + <command>smbclient //hostname/sharename -U + username</command>. </para> + <para>The SMB share is accessed from the local file system + once the local system is connected. + <command>file://path/to/sharefile</command> + </para> + </listitem> + <listitem> + <para> + <emphasis>NFS</emphasis> - Works only when the computer is + already connected to a NFS share. To connect the NFS share + must be mounted. NFS shares are mounted on the client side + using the mount command. The format of the command is as + follows: <command>mount -o [options] [host]:[/remote/export] + [/local/directory]</command> + </para> + <para>Once mounted <application>Software Updater</application> + can access the share using the following command + <command>file://path/to/local/directory</command> + </para> + </listitem> + </itemizedlist> + <note> + <para>If accessing a SMB or NFS shares by manually issuing the + <command>mount</command> commands, the file system must be + remounted manually after the system is rebooted. Failing to + remount will result in <application>Update + Manager</application> not being able to access the + resource.</para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Distribution</emphasis> + </term> + <listitem> + <para>The name of the distribution or name of the distribution + version.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Sections</emphasis> + </term> + <listitem> + <para>The section of the distribution repository to access.</para> + </listitem> + </varlistentry> + <varlistentry> + <term> + <emphasis role="bold">Comment</emphasis> + </term> + <listitem> + <para>Add a comment to describe the repository.</para> + </listitem> + </varlistentry> + </variablelist> + <note> + <para>Repositories defined using <application>Synaptic</application>, + another package management tool, are automatically displayed in the + <application>Software Updater</application> Software Sources + list.</para> + </note> + </sect3> + </sect2> + <sect2 id="managing-authentication"> + <title>Managing Authentication Keys</title> + <para>Authentication keys make it possible to verify the integrity of + update software. From the <guilabel>Authentication Keys</guilabel> + dialog it is possible to view and manage the list authentication keys. + Each key corresponds to a Software Source defined in the + <guilabel>Software Preference</guilabel> dialog (see <xref + linkend="managing-sources"/>). Keys can be added and removed. In the + event of an error it is also possible to restore the default + authentication keys provided by the defined update repositories.</para> + <!-- I am not sure how the keys are obtained --> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/authentication.png" format="PNG"/> + </imageobject> + <caption> + <para>Managing Authentication Keys</para> + </caption> + </mediaobject> + </screenshot> + <sect3 id="adding-auth-keys"> + <title>Adding Authentication Keys</title> + <para>Authentication keys are usually obtained from the software vendor + running the repository. Often the vendor will place a copy of the + authentication key on a key server, for example <ulink + url="http://www.keyserver.net">www.keyserver.net</ulink>. The key + can then be retrieved using the command <command>gpg + -recv-key</command>. When the key resides on a key server the option + <option>--keyserver</option> must be used to give the name of this + key server.</para> + <programlisting> +gpg -recv-key --keyserver www.keyserver.net + </programlisting> + <note> + <para>If the key is fetched over a untrusted medium, like the + Internet, additional steps should be taken to verify the key. For + example, getting the fingerprint with a secure method such as by + phone, letter, or business card. Alternately you can check if the + key is signed with a known-good key.</para> + </note> + <para>Once the key is downloaded, select it using the <guilabel>Choose + a key-file</guilabel> dialog that is displayed when the + <guibutton>Add</guibutton> button.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/authentication-add.png" format="PNG"/> + </imageobject> + <caption> + <para>Adding Authentication Keys</para> + </caption> + </mediaobject> + </screenshot> + </sect3> + <sect3 id="remove-auth-keys"> + <title>Removing Authentication Keys</title> + <para>Authentication keys can be removed by selecting a record item then + <action>clicking</action> the <guibutton>Remove</guibutton> + button.</para> + </sect3> + <sect3 id="restore-auth-keys"> + <title>Restoring Default Keys</title> + <para>During installation the default Trisquel Authentication keys are + added to the <application>Trisquel GPG Keyring</application> package. In + the even of a key being accidentally deleted it can be restored by + clicking the <guibutton>Restore default keys</guibutton> + button.</para> + </sect3> + </sect2> + <sect2 id="managing-settings"> + <title>Managing Settings</title> + <para>The <guibutton>Settings</guibutton> button, located on the + <guilabel>Software Preferences</guilabel> dialog, displays the + <guilabel>Settings</guilabel> dialog. From this interface you can + manage the behavior of the application and pre-update process.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/settings.png" format="PNG"/> + </imageobject> + <caption> + <para>Managing Settings</para> + </caption> + </mediaobject> + </screenshot> + <para>The following options are available:</para> + <itemizedlist> + <title>User Interface</title> + <listitem> + <para> + <emphasis>Show disabled software sources:</emphasis> - When checked + software sources that are not checked in the <guilabel>Software + Preferences</guilabel> dialog are displayed. When unchecked, + these items are not displayed in the list.</para> + </listitem> + </itemizedlist> + <itemizedlist> + <title>Updates</title> + <listitem> + <para> + <itemizedlist> + <listitem> + <para> + <emphasis>Automatically check for software updates:</emphasis> + - When checked the <guilabel>Update interval in + days</guilabel> option is enabled. <application>Update + Manager</application> will poll all enabled software sources + for updates according to the value specified in the + scroll-box.</para> + </listitem> + <listitem> + <para> + <emphasis>Download upgradable packages:</emphasis> - When + checked <application>Software Updater</application> will + automatically download any available software update packages. + It will not install them until the user has defined the + installation list (see <xref linkend="performing-updates" + />).</para> + </listitem> + </itemizedlist> + </para> + </listitem> + </itemizedlist> + <itemizedlist> + <title>Temporary files</title> + <listitem> + <para> + <emphasis>Automatically clean temporary packages files:</emphasis> - + When checked the <guilabel>Clean interval in days</guilabel> option + is enabled. <application>Software Updater</application> automatically + removes any temporary files created by the upgrade process according + to the value specified in the scroll-box.</para> + </listitem> + <listitem> + <para><emphasis>Set maximum size of the package cache:</emphasis> When checked the size of + the package cache is limited to the value specified in the <guibutton>Maximum size in + MB</guibutton> spin-box.</para> + </listitem> + <listitem> + <para><emphasis>Delete old packages in the package cache:</emphasis> When checked cached + packaged with a date older than the value specified in the <guibutton>Maximum age in + days</guibutton> spin-box will be automatically purged from the cache.</para> + </listitem> + </itemizedlist> + </sect2> + <sect2 id="configure-terminal-only-view"> + <title>Install Progress for Terminal View Only</title> + <para>It is also possible to configure the installation progress to use + only a terminal view. That is to say, no progress bar is displayed, only + a terminal view.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/main-view-monitor-update.png" + format="PNG"/> + </imageobject> + <caption> + <para>Monitoring Installation Progress</para> + </caption> + </mediaobject> + </screenshot> + <caution> + <para>Do not terminate the installation process. This may lead to + corruption of installed programs and general system + instability.</para> + </caution> + <para>Changing between 'Progress Bar' and + 'Terminal View,' modes is managed via + <application>Synaptic</application>. To change modes proceed as + follows:</para> + <procedure> + <step> + <para>Start <application>Synaptic</application> by selecting <menuchoice> + <guimenu>System</guimenu> + <guisubmenu>Administration</guisubmenu> + <guimenuitem>Synaptic Package Manager</guimenuitem> + </menuchoice> from the Desktop menu system. </para> + </step> + <step> + <para>When prompted, enter your password.</para> + </step> + <step> + <para>From the main menu, select <menuchoice> + <guimenu>Settings</guimenu> + <guimenuitem>Preferences</guimenuitem> + </menuchoice>. The <guilabel>Preferences</guilabel> dialog is + displayed.</para> + </step> + <step> + <para>From the <guibutton>General</guibutton> tab, <guilabel>Apply + Changes</guilabel> group, <action>check</action> or + <action>uncheck</action> the <guibutton>Apply changes in terminal + window</guibutton> checkbox.</para> + <screenshot> + <mediaobject> + <imageobject> + <imagedata fileref="figures/synaptic-toggle-install-view.png" + format="PNG"/> + </imageobject> + <caption> + <para>Synaptic Preferences - General Tab</para> + </caption> + </mediaobject> + </screenshot> + </step> + <step> + <para> + <action>Click</action> + <guibutton>OK</guibutton> and exit + <application>Synaptic</application>.</para> + </step> + </procedure> + </sect2> + </sect1> + <sect1 id="about"> + <title>About Software Updater</title> + <para>The <application>Software Updater</application> was written by Michiel + Sikkes <email>michiel@eyeopened.nl</email> and Michael Vogt + <email>michael.vogt@ubuntu.com</email> as an + <application>apt</application> Software Updater for the GNOME Desktop of the + Ubuntu distribution. The user manual was written by Sean Wheller + <email>sean@inwords.co.za</email>.</para> + <para>To report a bug or make a suggestion regarding this package or this + manual, send mail to <email>ubuntu-users@lists.ubuntu.com</email>.</para> + </sect1> &GFDL; </article> diff --git a/helpers/make-update-manager b/helpers/make-update-manager index 5dbb952e10867b8ece87e6405b862b82606ea248..b28a042f39b9ce5d2caafb23f7b5e63344d2d6a4 100644 --- a/helpers/make-update-manager +++ b/helpers/make-update-manager @@ -1,6 +1,6 @@ #!/bin/sh # -# Copyright (C) 2008-2010 Rubén RodrÃguez <ruben@trisquel.info> +# Copyright (C) 2008-2014 Rubén RodrÃguez <ruben@trisquel.info> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -17,289 +17,15 @@ # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA # -# Note that you would need to publish and sign the upgrade tarball -# gpg -ba release_name.tar.gz -# Also, don't forget to update the meta-release files at archive and packages.t.i - -VERSION=1 +VERSION=2 . ./config -#%FSDG: Remove functions to deal with proprietary drivers -rm ./DistUpgrade/xorg_fix_proprietary.py -rm ./DistUpgrade/NvidiaDetector -sed s/self.checkForNvidia/#self.checkForNvidia/ DistUpgrade/DistUpgradeCache.py -i -sed s/self._test_and_warn_on_old_nvidia/#self._test_and_warn_on_old_nvidia/ -i DistUpgrade/DistUpgradeQuirks.py -sed s/self._test_and_warn_on_nvidia_and_no_sse/#self._test_and_warn_on_nvidia_and_no_sse/ -i DistUpgrade/DistUpgradeQuirks.py -sed s/self._test_and_warn_on_dropped_fglrx_support/#self._test_and_warn_on_dropped_fglrx_support/ -i DistUpgrade/DistUpgradeQuirks.py -sed '/nvidia/d' debian/control DistUpgrade/build-tarball.sh -i -rm tests/test-data/xorg.conf.fglrx - -#% Make sure nvidia-common and fglrx-modaliases are not installed -apt-get remove --purge -y nvidia-common || true -apt-get remove --purge -y fglrx-modaliases || true - -#https://bugs.launchpad.net/ubuntu/+source/python-defaults/+bug/990740 -cat << EOF >> DistUpgrade/DistUpgradeQuirks.py - - def from_taranisPostInitialUpdate(self): - logging.debug("Setting APT::Immediate-Configure=false") - apt.apt_pkg.config.set("APT::Immediate-Configure", "false") - os.system("apt-get install --force-yes -y libblkid1 lzma dpkg") - - def from_taranisPostCleanup(self): - logging.debug("Setting APT::Immediate-Configure=true") - apt.apt_pkg.config.set("APT::Immediate-Configure", "true") -EOF - - -rm ./DistUpgrade/Ubuntu.info -cat << EOF > DistUpgrade/Trisquel.info -ChangelogURI: http://packages.trisquel.info/changelogs/pool/%s/%s/%s/%s_%s/%s - -Suite: $CODENAME -RepositoryType: deb -BaseURI: http://archive.trisquel.info/trisquel/ -Description: Trisquel $CODENAME -Component: main -Enabled: 1 -CompDescription: Trisquel GNU/linux packages - -Suite: $CODENAME-security -RepositoryType: deb -BaseURI: http://archive.trisquel.info/trisquel/ -Description: Trisquel $CODENAME Security Updates -Component: main -Enabled: 1 -CompDescription: Trisquel GNU/linux packages - -Suite: $CODENAME-updates -RepositoryType: deb -BaseURI: http://archive.trisquel.info/trisquel/ -Description: Trisquel $CODENAME Updates -Component: main -Enabled: 1 -CompDescription: Trisquel GNU/linux packages - -Suite: $CODENAME-backports -RepositoryType: deb -BaseURI: http://archive.trisquel.info/trisquel/ -Description: Trisquel $CODENAME Backports -Component: main -Enabled: 1 -CompDescription: Trisquel GNU/linux packages -EOF - -rm DistUpgrade/ReleaseAnnouncement -cat << EOF > DistUpgrade/ReleaseAnnouncement -= Welcome to Trisquel GNU/Linux $REVISION '$CODENAME' = - -The Trisquel team is proud to announce Trisquel $REVISION '$CODENAME'. -We recommend to apply all pending updates to the system before upgrading. - -Trisquel is a fully free operating system based in GNU/Linux, for domestic -users, small enterprises and educational centers. - -We hope you enjoy Trisquel. - -== Feedback and Helping == - -If you would like to help shape Trisquel, take a look at the list of -ways you can participate at - - http://trisquel.info/en/wiki/how-help - -Your comments, bug reports, patches and suggestions will help ensure -that our next release is the best release of Trisquel ever. If you feel -that you have found a bug please send it to us via - - http://trisquel.info/project/issues - -If you have a question, or if you think you may have found a bug but -aren't sure, first try asking on the #trisquel IRC channel on Freenode, -on the Trisquel Users mailing list, or on the Trisquel forums: - - http://listas.trisquel.info/ - http://trisquel.info/forum - -== More Information == - -You can find out more about Trisquel on our website, IRC channel and wiki. -If you're new to Trisquel, please visit: - - http://trisquel.info - -To sign up for future Trisquel announcements, please subscribe to Trisquel's -very low volume announcement list at: - - http://listas.trisquel.info/mailman/listinfo/trisquel-announce - -EOF - -rm DistUpgrade/DevelReleaseAnnouncement -cat << EOF > DistUpgrade/DevelReleaseAnnouncement -This is a development release, do not install on production systems! - -EOF - -cat DistUpgrade/ReleaseAnnouncement >> DistUpgrade/DevelReleaseAnnouncement - -rm DistUpgrade/EOLReleaseAnnouncement -cat << EOF > DistUpgrade/EOLReleaseAnnouncement -= Trisquel GNU/Linux $REVISION '$CODENAME' is NO LONGER SUPPORTED! = - -You are atempting to upgrade to a version of Trisquel that is no longer -supported. Since we do only keep upgrade packages for decomissioned releases -for a while, this upgrade may fail. Try the sandbox method first (by running -update-manager -s) or ask in our forums, lists or irc channels if you are -unsure about this procedure. - -Even if the required upgrade packages for $CODENAME are still available, to -get a currently supported release you would need to upgrade at least once -more after this procedure ends, so we recommend you to do a clean install -using the latest LTS or STS edition. - -== Feedback and Helping == - -If you would like to help shape Trisquel, take a look at the list of -ways you can participate at - - http://trisquel.info/en/wiki/how-help - -Your comments, bug reports, patches and suggestions will help ensure -that our next release is the best release of Trisquel ever. If you feel -that you have found a bug please send it to us via - - http://trisquel.info/project/issues - -If you have a question, or if you think you may have found a bug but -aren't sure, first try asking on the #trisquel IRC channel on Freenode, -on the Trisquel Users mailing list, or on the Trisquel forums: - - http://listas.trisquel.info/ - http://trisquel.info/forum - -== More Information == - -You can find out more about Trisquel on our website, IRC channel and wiki. -If you're new to Trisquel, please visit: - - http://trisquel.info - -To sign up for future Trisquel announcements, please subscribe to Trisquel's -very low volume announcement list at: - - http://listas.trisquel.info/mailman/listinfo/trisquel-announce - -EOF - -rm DistUpgrade/removal_blacklist.cfg -cat <<EOF > DistUpgrade/removal_blacklist.cfg -# blacklist of packages that should never be removed -trisquel-base -trisquel-minimal -trisquel-desktop-common -trisquel -trisquel-mini -triskel -# update-manager should not remove itself -update-manager -update-manager-core -EOF - -rm DistUpgrade/mirrors.cfg -cat << EOF > DistUpgrade/mirrors.cfg -http://mirror.fsf.org/trisquel/ -http://es.archive.trisquel.info/trisquel/ -ftp://es.archive.trisquel.info/trisquel/ -http://fr.archive.trisquel.info/trisquel/ -ftp://fr.archive.trisquel.info/trisquel/ -http://archive.trisquel.info/trisquel/ -ftp://archive.trisquel.info/trisquel/ -http://us.archive.trisquel.info/trisquel/ -http://nl.archive.trisquel.info/ -http://in.archive.trisquel.info/ -ftp://in.archive.trisquel.info/ -EOF - -rm DistUpgrade/DistUpgrade.cfg* -cp $DATA/DistUpgrade.cfg* DistUpgrade/ - -cat << EOF1 > DistUpgrade/trisquel-postinstall.sh -#!/bin/sh - -# Making sure this is gone -apt-get remove --force-yes -y notification-daemon - -if ! [ -f /etc/grub.d/01_PASSWORD ]; then -cat << EOF > /etc/grub.d/01_PASSWORD -#! /bin/sh -e -# Trisquel enables a random password to grub during install -# Comment this file to remove the password. -# This file should only be readable by root. - -echo set superusers=grub -echo password grub \$(bash -c 'echo \$RANDOM') -EOF -fi - -# Just in case -update-initramfs -u -update-grub -EOF1 -chmod 755 DistUpgrade/trisquel-postinstall.sh - -echo "notification-daemon" > DistUpgrade/demoted.cfg - -replace changelogs.ubuntu.com packages.trisquel.info . - -/bin/sed -i 's/�~Lubuntu/�~Ltrisquel/g; s/被ubuntu/被trisquel/g; s#http://launchpad.net/ubuntu/+source/%s/%s/+changelog#http://trisquel.info/project/issues#g; s/<.*@ubuntu.com/<info@trisquel.info/g; s/ ubuntu\n/ trisquel\n/g; s/ubuntu\ /trisquel\ /g; s/\ ubuntu/\ trisquel/g; s/Ubuntu/Trisquel/g; s/ubuntu-desktop/trisquel-/g; s/www.ubuntu.com/trisquel.info/g; s/www.ubuntulinux.org/trisquel.info/g ' po/*.po $(find | grep py$) $(find | grep '\.glade$') +cp $DATA/index.docbook help/C/index.docbook -apt-get install --force-yes -y rpl -rpl 11\.04 5\.0 DistUpgrade/*.ui -rpl 11\.04 5\.0 po/* -R -rpl 11\.10 5\.5 DistUpgrade/*.ui -rpl 11\.10 5\.5 po/* -R -rpl 12\.04 6\.0 DistUpgrade/*.ui -rpl 12\.04 6\.0 po/* -R -rpl $UPSTREAM $CODENAME . -R -rpl oneiric brigantia . -R -rpl natty dagda . -R -rpl maverick slaine . -R -rpl lucid taranis . -R -rpl karmic awen . -R -rpl jaunty dwyn . -R -rpl hardy robur . -R -#mv DistUpgrade/demoted.cfg.precise DistUpgrade/demoted.cfg.brigantia -#mv DistUpgrade/demoted.cfg.natty DistUpgrade/demoted.cfg.dagda -#mv DistUpgrade/demoted.cfg.maverick DistUpgrade/demoted.cfg.slaine -mv DistUpgrade/demoted.cfg.lucid DistUpgrade/demoted.cfg.taranis -#mv DistUpgrade/demoted.cfg.karmik DistUpgrade/demoted.cfg.awen -#mv DistUpgrade/demoted.cfg.jaunty DistUpgrade/demoted.cfg.dwyn -mv DistUpgrade/demoted.cfg.hardy DistUpgrade/demoted.cfg.robur -rpl " Ubuntu " " Trisquel " . -R -rpl "Ubuntu " "Trisquel " . -R -rpl " Ubuntu" " Trisquel" . -R -rpl " ubuntu " " trisquel " . -R -rpl "ubuntu " "trisquel " . -R -rpl " ubuntu" " trisquel" . -R -rpl archive.ubuntu.com/ubuntu es.archive.trisquel.info/trisquel . -R -rpl security.ubuntu.com/ubuntu archive.trisquel.info/trisquel . -R -rpl archive.ubuntu.com es.archive.trisquel.info . -R -rpl security.ubuntu.com archive.trisquel.info . -R -sed 's/auto generated by update-manager/auto generated by update-manager\\n/g' DistUpgrade/DistUpgradeController.py -i -sed 's/main restricted" %/main\\n" %/g' DistUpgrade/DistUpgradeController.py -i -rpl "main restricted" "main" DistUpgrade -R -sed 's/,"restricted"//g' DistUpgrade/DistUpgradeController.py -i -#sed 's/","restricted"/\\n"/g' DistUpgrade/DistUpgradeController.py -i -#rpl '10.04' $REVISION DistUpgrade po -R -replace Ubuntu Trisquel . -R -replace Kubuntu Triskel . -R -replace Canonical Trisquel . -R -replace Trisquel-Gettext Ubuntu-Gettext . -R +replace Ubuntu Trisquel . changelog "Compiled for Trisquel" compile -cp ../dist-upgrader* /root