<html><body>
<a href="doc076.htm"><img src=../icons/next.gif alt="Next"></a>
<a href="doc000.htm"><img src=../icons/up.gif alt="Up"></a>
<a href="doc074.htm"><img src=../icons/previous.gif alt="Previous"></a>
<a href="doc000.htm"><img src=../icons/contents.gif alt="Contents"></a>
<a href="doc136.htm"><img src=../icons/index.gif alt="Index"></a>
<hr>

<title>Package Manipulation</title>
<h2><a name="s10.4">10.4 Package Manipulation</a></h2>
<a name="i597">
<a name="i598">

<p><h3><a name="s10.4.1">10.4.1 Querying Packages</a></h3>
<a name="i599">
<a name="i600">
<a name="i601">

<p>The easiest way to query a single package or group is to use the query
option from the icon's context sensitive menu. If you want to query
a more diverse set of packages, select them all and use the <tt>Query</tt>
button in one of the windows.

<p>Using either of these methods creates a window like the one shown in 
figure <a href="doc075.htm#f73">73</a>. If you choose only one package, it will look a 
bit different however, so some of this won't apply.

<p><p><a name="f73"></a><center><img src="img069.gif"></center><p><center>Figure 73: Query Window</center><p>

<p>On the very left of the window is a list of the packages that have been
queried. Selecting one of them will change the information in the
rest of the window. You may step through them in order by using the
<tt>Next</tt> and <tt>Previous</tt> buttons on the right side of the window.

<p>The name, version, and release of the current package are in the top
middle of the query window. Immediately below this is the description
of the package, which can be quite large. A scroll bar is there
to let you read the whole thing.

<p>Below the description is a list of the files contained in the package.
Along with the full path to the file, the file list tells you a couple
of other things. If a <tt>D</tt> appears to the left of the path, that
file is a documentation file and would be a good thing to read. If 
a <tt>C</tt> appears there, then the file is a configuration file. A <tt>*</tt>
means that the correct version of that file is not installed on your
system. This can occur because a more recent version of a package
was installed or because two packages contain different versions of the 
same file.

<p><p><a name="f74"></a><center><img src="img070.gif"></center><p><center>Figure 74: Query Details</center><p>

<p>More information on a package can be seen by clicking on the <tt>Details</tt>
pushbutton. A window like the one in figure <a href="doc075.htm#f74">74</a> will then 
appear. This lists more information about the package being displayed 
in the main query window.  When you select a new package in the query
window, the information in the details window will change to reflect 
your new choice.

<p>You may also select, unselect, or verify a package while querying it by using
the buttons provided. Click on the <tt>Close</tt> button when
you are finished looking at the packages.

<p><h3><a name="s10.4.2">10.4.2 Verifying Packages</a></h3>
<a name="i602">
<a name="i603">
<a name="i604">

<p>Verifying a package checks all of the files in the package to
insure they match the ones present on your system. The checksum, file size,
permissions, and owner attributes are all checked against the database. 
This check can be used when you suspect that one of programs files has
become corrupted due to the installation of new programs.

<p>Choosing the packages to verify is the same as choosing the packages to
query. Select the packages and use the <tt>Verify</tt> button or 
choose the <tt>Verify</tt> entry from a context sensitive menu. A window opens
like the one in figure <a href="doc075.htm#f75">75</a>.

<p><p><a name="f75"></a><center><img src="img071.gif"></center><p><center>Figure 75: Verify Window</center><p>

<p>The three columns in this window describe the package with a problem in
it, the file that has the problem, and a brief description of the
discrepancies that were found. While the check is running, the current
file being checked appears as the last element in the list, and the
problem is listed as <tt>(checking)</tt>. A full list of the problems
that can be found through verification appears in figure <a href="doc075.htm#f76">76</a>.

<p><p><a name="f76"></a>
<center>
<table cellpadding=0 cellspacing=0 border=1>
<tr valign=top>
<td colspan=1 align=left nowrap>
<b>Problem</b></td>
<td colspan=1 align=left nowrap><b>Description</b> </td></tr>
<tr valign=top>
<td colspan=1 align=left nowrap> 
missing</td>
<td colspan=1 align=left nowrap>The file is no longer on your system </td></tr>
<tr valign=top>
<td colspan=1 align=left nowrap>
mode</td>
<td colspan=1 align=left nowrap>permission bits have changed </td></tr>
<tr valign=top>
<td colspan=1 align=left nowrap>
size</td>
<td colspan=1 align=left nowrap>file's size has changed </td></tr>
<tr valign=top>
<td colspan=1 align=left nowrap>
uid</td>
<td colspan=1 align=left nowrap>owner's uid has changed </td></tr>
<tr valign=top>
<td colspan=1 align=left nowrap>
gid</td>
<td colspan=1 align=left nowrap>owner's gid has changed </td></tr>
<tr valign=top>
<td colspan=1 align=left nowrap>
md5</td>
<td colspan=1 align=left nowrap>the md5 checksum has changed </td></tr>
<tr valign=top>
<td colspan=1 align=left nowrap>
link</td>
<td colspan=1 align=left nowrap>the file is a symlink to the wrong place
</td></tr>
</table>
<p><center>Figure 76: Possible Problems found by Verification</center>

</center>
<p>

<p>To get more information on the problems found with a file, double
click on the file's path. A window like the one shown in figure  
<a href="doc075.htm#f77">77</a>
lists the expected and current values of the attributes that are amiss.

<p><p><a name="f77"></a><center><img src="img072.gif"></center><p><center>Figure 77: Verification Details</center><p>

<p><h3><a name="s10.4.3">10.4.3 Installing New Packages</a></h3>
<a name="i605">
<a name="i606">
<a name="i607">

<p>Installing new packages from glint is very simple. First look at the
packages available for installation (see the section
<a href="doc073.htm#s10.2.3">10.2.3</a> for how to do this). You may select any
number of these (and query them if you're not sure what they are) for
installation (in the same manner you select packages for verification.) If
you want to install a single package or group, the context sensitive
menus provide a shortcut for doing so. Figure <a href="doc075.htm#f78">78</a> shows a 
window with some packages selected for installation.

<p><p><a name="f78"></a><center><img src="img073.gif"></center><p><center>Figure 78: Packages Selected for Installation</center><p>

<p>After you've begun the installation, a window appears like the one 
in figure <a href="doc075.htm#f79">79</a>. It tracks the progress of the 
installation so you'll know something is happening. The top bar shows how 
much of the current package (whose name is listed inside of it) has been 
installed while the bottom graph shows how much of the total installation has
been finished. The number of packages, package sizes, and time estimates
are continually updated.

<p><p><a name="f79"></a><center><img src="img074.gif"></center><p><center>Figure 79: Installation Progress</center><p>

<p>If a problem occurs during the installation, a window will appear listing
any errors that occurred. If this happens, you should correct the problems
and then try again. 

<p>After the installation has completed, the package and groups that
have been installed are moved from the available window to the main
glint window to show you that they have been successfully installed.

<p><h4><a name="s10.4.3.1">10.4.3.1 Upgrading Packages</a></h4>
<a name="i608">
<a name="i609">
<a name="i610">

<p>When a new version of a package has been released, it is easy to install it
on your system. Select the packages from the window of available packages
in the same way you select packages for installation. Both the
<tt>Upgrade</tt> button and the context sensitive menus will begin the
upgrade.

<p>During the upgrade, you'll see a progress indicator like the one for
installing packages. When it's finished, the installed packages will
appear in the the main glint windows and any old versions of the packages
will be removed.

<p>It is much better to use the upgrade option than to uninstall the old
versions of a package and then install the new one. Using upgrade
ensures that any changes you made to package configuration files
get preserved properly, while doing it manually could cause those
changes to be lost.

<p>If you run out of disk space during an installation, the install will fail.
However, the package which was being installed when the error occurred
may leave some files around. To clean this up, reinstall the package
after you've made more disk space available.

<p><h3><a name="s10.4.4">10.4.4 Uninstalling Packages</a></h3>
<a name="i611">
<a name="i612">
<a name="i613">
<a name="i614">
<a name="i615">
<a name="i616">

<p>Uninstalling a package is not the same as upgrading one. When a package
is uninstalled, any files it uses that are not needed by other packages
on your system are removed. Changed configuration files are copied to 
<tt>&lt;filename&gt;.rpmsave</tt> so you can reuse them later. 

<p>Like verifying and querying packages, you can remove a package through
the buttons on the right of the glint window or through a context sensitive
menu. Remember that when you make a choice from a group's menu, the
operation is performed on all of the packages in that group, so be
careful!

<p><p><a name="f80"></a><center><img src="img075.gif"></center><p><center>Figure 80: Uninstall Window</center><p>

<p>Once you've begun the uninstall, glint asks for confirmation,
showing a window like the one in figure <a href="doc075.htm#f80">80</a>. All of the 
packages that are about
to be uninstalled are listed. You should look at them all to ensure you're
not about to remove something you want to keep. Clicking the <tt>Yes</tt> button
will start the uninstallation process.  After it completes, the packages and
groups that have been removed will disappear from any windows they were in.


<p><hr>
<a href="doc076.htm"><img src=../icons/next.gif alt="Next"></a>
<a href="doc000.htm"><img src=../icons/up.gif alt="Up"></a>
<a href="doc074.htm"><img src=../icons/previous.gif alt="Previous"></a>
<a href="doc000.htm"><img src=../icons/contents.gif alt="Contents"></a>
<a href="doc136.htm"><img src=../icons/index.gif alt="Index"></a>
<hr>
</body></html>
