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 0000000..2fde169 --- /dev/null +++ b/helpers/DATA/update-manager/index.docbook @@ -0,0 +1,931 @@ + + + +]> + + + +
+ + + + Software Updater Manual + + 2006 + In Words + + + + + + + In Words Techdoc Solutions + + &legal; + + + + Sean + Wheller + + In Words +
+ sean@inwords.co.za +
+
+
+ + Jeff + Schering + Editor + + + Jerome + Gotangco + Maintainer + + +
+ + + + + + + + + + + + + + + V0.0.1 + 06/03/2005 + + First version of the manual created in accordance + with Software Updater V0.37.1+svn20050301. Documentation Writer + sean@inwords.co.za + + + InWords Techdoc + Solutions + + + + + V0.0.2 + 26/03/2005 + + Edit of V0.0.1 to make some nodes shorter. + Editor jeffschering@gmail.com + + + InWords Techdoc + Solutions + + + + + V0.0.3 + 26/03/2005 + + Added Help, Add CD, Settings options. + sean@inwords.co.za + + + InWords Techdoc + Solutions + + + + + This manual explains how to use Software Updater, an apt update + management application for the GNOME desktop created by the Ubuntu + project. + + Feedback + + To report a bug or make a suggestion regarding this package or this + manual, send mail to trisquel-devel@listas.trisquel.info. + + +
+ + + + Introduction + + Software Updater is a graphical interface to the + software update features of Advanced Packaging + Tool (APT). APT is a + command line tool for installing, updating, and removing software. + + Software Updater makes the task of checking for + and installing software updates as effortless as possible. + Software Updater 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. + + Software Updater 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 Software Updater + notifies you that an update is available, you may choose to install the + update immediately, or to ignore the update. + + Software Updater 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. + + + Getting Started + + Installation + + Software Updater is installed as part of the + Trisquel standard installation, and should already be on your system. The + application is known as Trisquel Update + Manager. If you need to install Update + Manager, you can use Synaptic Package + Manager. Choose + System + Administration + Synaptic Package Manager + to start Synaptic. The package + you need to install is update-manager. + You may also install Software Updater from the command line using + apt-get. To install Update + Manager from the command line: + +sudo apt-get install update-manager + + + Software Updater is dependent on the following + packages: 'python,' 'python-gnome2,' + 'python-apt,' 'synaptic,' and + 'lsb-release.' + + + Starting Software Updater + Choose + System + Administration + Trisquel Software Updater + to start the application. Enter your password when + prompted. + You may also start Software Updater from + the command line: + +update-manager + + + + Main Window + The Software Updater main window is used for + managing the update process and setting preferences. + When you open Software Updater, 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." + + + + + + + Available Updates + + + + + + + Performing Updates + + Updating Your Computer + When you open Software Updater, 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." + + + + + + + Available Updates + + + + 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. + To un-mark a package for installation, clear the check box + for the package. + To see additional information about a package, click on + Details. + (see ) + When you are ready to install the selected packages, + click on Install. + If Software Updater detects one or more + packages without a digital signature, the + Summary dialog is displayed. + The Summary dialog lists three groups of update + categories: + + + + NOT AUTHENTICATED + + + Packages without a digital signature. + + + + + To be upgraded + + + Packages that will be upgraded. + + + + + Unchanged + + + Packages that will not be upgraded due to dependency issues. + The packages will be upgraded in a future Update + Manager session, once the developers have + resolved the package dependencies. + + + + If you do not want to install non-authenticated packages, click + Cancel. The Summary + dialog will close, and you can + deselect the packages in the Software Updater + main window. + + If a deselected package is required as a dependency for a selected + package, Software Updater will install the + deselected package to satisfy the dependency. + + + Software Updater 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, + Software Updater displays a dialog box that + monitors the download progress. (See ). + + + Expanded Update Information + To see additional information about a package: + + + Click on the package in the main window. + + + Click on Details.A tabbed section + opens within the main window. + + + The tabs are as follows: + + + + Changes + + + A list of the changes incorporated in the package. The list + is the contents of the ChangeLog file for the + package. + + + + + Description + + + A short description of each program in the package. + + + + + + Monitoring Download Progress + Software Updater displays the + Installing updates window while the + packages are downloading. The progress bar in the + Installing updates window shows the progress + of the entire update. + To display the download progress of each package, click on + Show progress of individual files. + To cancel the download, click Cancel. + + All files must be downloaded before + Software Updater can proceed to the installation stage. If + the network connections fails or if you cancel the download, the update + will not be installed. + + To resume a canceled or failed download, click on Install in the + main window. Software Updater will resume the + download from the last successfully downloaded file. + + + + Monitoring Installation Progress + Software Updater displays the + Installation updates window while the updates are + being installed. The progress bar inside the Installation + updates window shows the progress of the entire installation. + + To display the installation progress of each package, click on + Terminal. 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. + + Do not terminate the installation process. This may lead to + corruption of installed programs and general system + instability. + + + + + Setting Preferences + The Software Updater + Preferences button displays the Software + Preferences dialog. From this dialog you can perform the + following tasks: + + + Manage software sources (see ). + + + Manage authentication keys (see ). + + + Manage settings (see ). + + + + Managing Software Sources + 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. + + The operations described here modify /etc/apt/sources.list using the Update + Manager graphical user interface. Software sources can + also be managed by making direct modifications in /etc/apt/sources.list. This is only + advised for advanced users. + + + Adding Software Sources + Software may be installed using various access methods: + + + + CD-ROM - Compact Disk Read Only Memory, + normally directly connected to the computer system and mounted + locally by the operating system. + + + + + + + FTP - File Transfer Protocol, a secure and + reliable protocol designed specifically for the purpose of + transferring large files across the Internet. + + + + HTTP - HyperText Transfer Protocol, commonly + used to request and receive Web pages, but can also be used for + file transfer. + + + + SMB - Server Management Block is used to + access shared resources on computers running Microsoft + Windows or Samba + Server. + + + + NFS - Network File System is used to access + shared resources on Linux/UNIX computers. + + + + 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 + . + + A new software source can be defined by clicking + the Add button located on the + Software Preferences dialog. This will + display the Edit Repository dialog. + + + + + + + Adding Software Sources + + + + Complete the Edit Repository dialog to add + a new Software source. + + + + Repository + + + The Trisquel software repository contains thousands of + software packages that comply with the Free Software Philosophy. + + + + + + Creating Custom Software Sources + It is also possible to define custom software sources. + To define a custom software source click the + Custom button located on the Edit + Repository dialog. This will display a dialog in which + the custom repository can be defined using + apt command syntax. + Apt is an Advanced Packaging Tool and + front-end to dpkg the Debian Package + Management System. Once the apt line is entered + click the Add repository + button. + + + + + + + Creating Custom Software Sources + + + + The apt command syntax defines the + 'type,' 'location,' and + 'content' of the repository. Example of the command + syntax could look like this. + +deb ftp://archive.trisquel.info/trisquel/ belenos main + + This example would define the software sources as a Debian source + at trisquel.info containing the belenos release. + + + + Removing Software Sources + Software sources can be removed from the sources list by selecting + the software source then clicking the + Remove button located on the + Software Preferences dialog. + Removal of a software source requires that the + apt file (/etc/apt/sources.list) that contains the a list of + software sources is updated. Before modifying this file + Software Updater prompts to confirm the + operation. If the operation is confirmed a backup copy is create in + /etc/apt/sources.list.save. + + + Editing Software Sources + To change the values defining a software source, select the source + record then click the edit button. This will display + the Edit Repository dialog. + + + + + + + Editing Software Sources + + + + + + + Type + + + Software sources may contain software in + 'Binary' or 'Source Code' + format. Select the option correlating to the repository + format. + + + + + URI + + + Enter a valid Uniform Resource Indicator + (URI). Following is a list of examples for + each of the possible access methods: + + + + + CD-ROM - + cdrom:[description_of_cd]/ + + + + + + + + FTP - + ftp://ftp.domain.ext/path/to/repository + + + + + HTTP - + http://www.domain.ext/path/to/repository + + + + + SMB - 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 + smbclient //hostname/sharename -U + username. + The SMB share is accessed from the local file system + once the local system is connected. + file://path/to/sharefile + + + + + NFS - 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: mount -o [options] [host]:[/remote/export] + [/local/directory] + + Once mounted Software Updater + can access the share using the following command + file://path/to/local/directory + + + + + If accessing a SMB or NFS shares by manually issuing the + mount commands, the file system must be + remounted manually after the system is rebooted. Failing to + remount will result in Update + Manager not being able to access the + resource. + + + + + + Distribution + + + The name of the distribution or name of the distribution + version. + + + + + Sections + + + The section of the distribution repository to access. + + + + + Comment + + + Add a comment to describe the repository. + + + + + Repositories defined using Synaptic, + another package management tool, are automatically displayed in the + Software Updater Software Sources + list. + + + + + Managing Authentication Keys + Authentication keys make it possible to verify the integrity of + update software. From the Authentication Keys + dialog it is possible to view and manage the list authentication keys. + Each key corresponds to a Software Source defined in the + Software Preference dialog (see ). 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. + + + + + + + + Managing Authentication Keys + + + + + Adding Authentication Keys + 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 www.keyserver.net. The key + can then be retrieved using the command gpg + -recv-key. When the key resides on a key server the option + must be used to give the name of this + key server. + +gpg -recv-key --keyserver www.keyserver.net + + + 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. + + Once the key is downloaded, select it using the Choose + a key-file dialog that is displayed when the + Add button. + + + + + + + Adding Authentication Keys + + + + + + Removing Authentication Keys + Authentication keys can be removed by selecting a record item then + clicking the Remove + button. + + + Restoring Default Keys + During installation the default Trisquel Authentication keys are + added to the Trisquel GPG Keyring package. In + the even of a key being accidentally deleted it can be restored by + clicking the Restore default keys + button. + + + + Managing Settings + The Settings button, located on the + Software Preferences dialog, displays the + Settings dialog. From this interface you can + manage the behavior of the application and pre-update process. + + + + + + + Managing Settings + + + + The following options are available: + + User Interface + + + Show disabled software sources: - When checked + software sources that are not checked in the Software + Preferences dialog are displayed. When unchecked, + these items are not displayed in the list. + + + + Updates + + + + + + Automatically check for software updates: + - When checked the Update interval in + days option is enabled. Update + Manager will poll all enabled software sources + for updates according to the value specified in the + scroll-box. + + + + Download upgradable packages: - When + checked Software Updater will + automatically download any available software update packages. + It will not install them until the user has defined the + installation list (see ). + + + + + + + Temporary files + + + Automatically clean temporary packages files: - + When checked the Clean interval in days option + is enabled. Software Updater automatically + removes any temporary files created by the upgrade process according + to the value specified in the scroll-box. + + + Set maximum size of the package cache: When checked the size of + the package cache is limited to the value specified in the Maximum size in + MB spin-box. + + + Delete old packages in the package cache: When checked cached + packaged with a date older than the value specified in the Maximum age in + days spin-box will be automatically purged from the cache. + + + + + Install Progress for Terminal View Only + 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. + + + + + + + Monitoring Installation Progress + + + + + Do not terminate the installation process. This may lead to + corruption of installed programs and general system + instability. + + Changing between 'Progress Bar' and + 'Terminal View,' modes is managed via + Synaptic. To change modes proceed as + follows: + + + Start Synaptic by selecting + System + Administration + Synaptic Package Manager + from the Desktop menu system. + + + When prompted, enter your password. + + + From the main menu, select + Settings + Preferences + . The Preferences dialog is + displayed. + + + From the General tab, Apply + Changes group, check or + uncheck the Apply changes in terminal + window checkbox. + + + + + + + Synaptic Preferences - General Tab + + + + + + + Click + OK and exit + Synaptic. + + + + + + About Software Updater + The Software Updater was written by Michiel + Sikkes michiel@eyeopened.nl and Michael Vogt + michael.vogt@ubuntu.com as an + apt Software Updater for the GNOME Desktop of the + Ubuntu distribution. The user manual was written by Sean Wheller + sean@inwords.co.za. + To report a bug or make a suggestion regarding this package or this + manual, send mail to ubuntu-users@lists.ubuntu.com. + &GFDL;
diff --git a/helpers/make-update-manager b/helpers/make-update-manager index 5dbb952..b28a042 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 +# Copyright (C) 2008-2014 Rubén Rodríguez # # 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 +cp $DATA/index.docbook help/C/index.docbook -#% 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 < 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/