Updated update-manager
This commit is contained in:
Rubén Rodríguez
parent
c18f9d6df1
commit
78028ba7a9
5 changed files with 935 additions and 278 deletions
931
helpers/DATA/update-manager/index.docbook
Normal file
931
helpers/DATA/update-manager/index.docbook
Normal file
|
|
@ -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>
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
#!/bin/sh
|
#!/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
|
# 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
|
# 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
|
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||||
#
|
#
|
||||||
|
|
||||||
# Note that you would need to publish and sign the upgrade tarball
|
VERSION=2
|
||||||
# gpg -ba release_name.tar.gz
|
|
||||||
# Also, don't forget to update the meta-release files at archive and packages.t.i
|
|
||||||
|
|
||||||
VERSION=1
|
|
||||||
|
|
||||||
. ./config
|
. ./config
|
||||||
|
|
||||||
#%FSDG: Remove functions to deal with proprietary drivers
|
cp $DATA/index.docbook help/C/index.docbook
|
||||||
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
|
replace Ubuntu Trisquel .
|
||||||
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/<2F>~Lubuntu/<2F>~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$')
|
|
||||||
|
|
||||||
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
|
|
||||||
|
|
||||||
changelog "Compiled for Trisquel"
|
changelog "Compiled for Trisquel"
|
||||||
|
|
||||||
compile
|
compile
|
||||||
|
|
||||||
cp ../dist-upgrader* /root
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue