<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!--This manual describes the CentOS Artwork Repository.
The CentOS Artwork Repository exists to organize and automate The
CentOS Project corporate visual identity (, to
start on).
Copyright C 2009, 2010 Alain Reguera Delgado. All rights
reserved.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
copy of the license is included in the section entitled GNU Free
Documentation License.
-->
<!-- Created on December, 2 2010 by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people <dev@texi2html.cvshome.org>
Send bugs and suggestions to <users@texi2html.cvshome.org>
-->
<head>
<title>CentOS Artwork Repository: 3.48 trunk/Scripts/Bash/Functions/Verify</title>
<meta name="description" content="CentOS Artwork Repository: 3.48 trunk/Scripts/Bash/Functions/Verify">
<meta name="keywords" content="CentOS Artwork Repository: 3.48 trunk/Scripts/Bash/Functions/Verify">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.76">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<style type="text/css">
<!--
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
a.summary-letter {text-decoration: none}
pre.display {font-family: serif}
pre.format {font-family: serif}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: serif; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: serif; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.sansserif {font-family:sans-serif; font-weight:normal;}
ul.toc {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="repository_50.html#SEC280" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="#SEC282" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="repository_3.html#SEC3" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="repository_3.html#SEC3" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="repository_66.html#SEC372" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="repository.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="repository_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="repository_66.html#SEC372" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="repository_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="trunk-Scripts-Bash-Functions-Verify"></a>
<a name="SEC281"></a>
<h2 class="section"> 3.48 trunk/Scripts/Bash/Functions/Verify </h2>
<a name="SEC282"></a>
<h3 class="subsection"> 3.48.1 Goals </h3>
<p>This section exists to organize files related to <tt>`centos-art.sh'</tt>
script <samp>`verify'</samp> functionality. The <samp>`verify'</samp>
functionality of <tt>`centos-art.sh'</tt> script helps you to verify the
workstation configuration you are planning to use as host for your
working copy of CentOS Artwork Repository.
</p>
<a name="SEC283"></a>
<h3 class="subsection"> 3.48.2 Description </h3>
<p>The first time you download CentOS Artwork Repository you need to
configure your workstation in order to use <tt>`centos-art.sh'</tt>
script. These preliminar configurations are based mainly on auxiliar
RPM packages installation, symbolic links creations, and environment
variables definitions. The <samp>`verify'</samp> functionality of
<tt>`centos-art.sh'</tt> script guides you through this preliminar
configuration process.
</p>
<p>If this is the first time you run <tt>`centos-art.sh'</tt> script, the
appropriate way to use its <samp>`verify'</samp> functionality is not using
the <tt>`centos-art.sh'</tt> script directly, but the absolute path to
<code>centos-art.sh</code> script instead (i.e.,
<tt>`~/artwork/trunk/Scripts/Bash/centos-art.sh'</tt>). This is necessary
because <tt>`centos-art'</tt> symbolic link, under <tt>`~/bin/'</tt>
directory, has not been created yet.
</p>
<a name="SEC284"></a>
<h4 class="subsubsection"> 3.48.2.1 Packages </h4>
<p>Installation of auxiliar RPM packages provides the software required
to manipulate files inside the repository (e.g., image files,
documentation files, translation files, script files, etc.). Most of
RPM packages <code>centos-art.sh</code> script uses are shipped with
CentOS distribution, and can be installed from CentOS base repository.
The only exception is <samp>`inkscape'</samp>, the package we use to
manipulate SVG files. The <samp>`inkscape'</samp> package is not inside
CentOS distribution so it needs to be installed from third party
repositories.
</p>
<blockquote class="blue"><img src="/home/centos/artwork/trunk/Identity/Widgets/Img/icon-admonition-info.png" alt="info"><h3>Note</h3><p> Configuration of third party repositories inside CentOS
distribution is described in CentOS wiki, specifically in the
following URL:
<a class="www" href="http://wiki.centos.org/AdditionalResources/Repositories">http://wiki.centos.org/AdditionalResources/Repositories</a>
</p></blockquote>
<p>Before installing packages, the <tt>`centos-art.sh'</tt> script uses
<code>sudo</code> to request root privileges to execute <code>yum</code>'s
installation functionality. If your user isn't defined as a
privileged user--at least to run <code>yum</code> commands-- inside
<tt>`/etc/sudoers'</tt> configuration file, you will not be able to
perform package installation tasks as set in <tt>`centos-art.sh'</tt>
script <samp>`verify'</samp> functionality.
</p>
<p>Setting sudo privileges to users is an administrative task you have to
do by yourself. If you don't have experience with <code>sudo</code>
command, please read its man page running the command: <code>man
sudo</code>. This reading will be very useful, and with some practice, you
will be able to configure your users to have <code>sudo</code>
privileges.
</p>
<a name="SEC285"></a>
<h4 class="subsubsection"> 3.48.2.2 Links </h4>
<p>Creation of symbolic links helps us to alternate between different
implementations of <tt>`centos-art.sh'</tt> script-line (e.g.,
<tt>`centos-art.sh'</tt>, for Bash implementation; <tt>`centos-art.py'</tt>,
for Python implementation; <tt>`centos-art.pl'</tt>, for Perl
implementation; and so on for other implementations). The
<tt>`centos-art.sh'</tt> script-line definition takes place inside your
personal binary (<tt>`~/bin/'</tt>) directory in order to make the script
implementation --the one that <tt>`centos-art'</tt> links to-- available
to <var>PATH</var> environment variable.
</p>
<p>Creation of symbolic links helps us to reuse components from repository
working copy. For example, color information files maintained inside
your working copy must never be duplicated inside program-specific
configuration directories that uses them in your workstation (e.g.,
Gimp, Inkscape, etc.). Instead, a symbolic link must be created for
each one of them, from program-specific configuration directories to
files in the working copy. In this configuration, when someone
commits changes to color information files up to central repository,
they--the changes committed-- will be immediatly available to your
programs the next time you update your working copy --the place
inside your workstation those color information files are stored--.
</p>
<p>Creation of symbolic links helps us to make <tt>`centos-art.sh'</tt>
script functionalities available outside <tt>`trunk/'</tt> repository
directory structure, but at its same level in repository tree. This is
useful if you need to use the "render" functionality of
<code>centos-art.sh</code> under <tt>`branches/'</tt> repository directory
structure as you usually do inside <tt>`trunk/'</tt> repository directory
structure. As consequence of this configuration, automation scripts
cannot be branched under <tt>`branches/Scripts'</tt> directory structure.
</p>
<a name="SEC286"></a>
<h4 class="subsubsection"> 3.48.2.3 Environment variables </h4>
<p>Definition of environemnt variables helps us to set default values to
our user session life. The user session environment variable defintion
takes place in the user's <tt>`~/.bash_profile'</tt> file. The
<samp>`verify'</samp> functionality of <tt>`centos-art.sh'</tt> script doesn't
modify your <tt>`~/.bash_profile'</tt> file.
</p>
<p>The <samp>`verify'</samp> functionality of <tt>`centos-art.sh'</tt> script
evaluates the following environment variables:
</p>
<dl compact="compact">
<dt> <code>EDITOR</code></dt>
<dd><p>Default text editor.
</p>
<p>The <tt>`centos-art.sh'</tt> script uses default text <code>EDITOR</code> to edit
pre-commit subversion messages, translation files, configuration
files, script files, and similar text-based files.
</p>
<p>If <code>EDITOR</code> environment variable is not set, <tt>`centos-art.sh'</tt>
script uses <tt>`/usr/bin/vim'</tt> as default text editor. Otherwise, the
following values are recognized by <tt>`centos-art.sh'</tt> script:
</p>
<ul class="toc">
<li> <tt>`/usr/bin/vim'</tt>
</li><li> <tt>`/usr/bin/emacs'</tt>
</li><li> <tt>`/usr/bin/nano'</tt>
</li></ul>
<p>If no one of these values is set in <code>EDITOR</code> environment variable,
<tt>`centos-art.sh'</tt> uses <tt>`/usr/bin/vim'</tt> text editor by default.
</p>
</dd>
<dt> <code>TZ</code></dt>
<dd>
<p>Default time zone representation.
</p>
<p>Time representation inside repository server is set to Coordinated
Universal Time (UTC). Time represetation inside repository working
copies is set as their administrators personally define.
</p>
<p>When repository working copies time representation be defined, it
would be a very good convention to follow if working copies
administrators would set their systems clock to use UTC. Otherwise it
would be difficult for working copies users to find out when changes
were committed up to repository server exactly in time.
</p>
<blockquote class="orange"><img src="/home/centos/artwork/trunk/Identity/Widgets/Img/icon-admonition-idea.png" alt="Info"><h3>Tip</h3><p> Coordinated Univeral Time (UTC) representation can be
configured when you install CentOS distribution; or later, runing the
<code>system-config-date</code> command at a shell prompt from your
graphical interface.
</p></blockquote>
<blockquote class="blue"><img src="/home/centos/artwork/trunk/Identity/Widgets/Img/icon-admonition-info.png" alt="info"><h3>Note</h3><p> If you set your system clock to use UTC representation,
you also need to set the <code>TZ</code> environment variable inside
<tt>`~/.bash_profile'</tt> as follows:
</p><pre class="verbatim">export TZ=UTC
</pre><p>This is required in order for your terminal to display the correct
time information of your zone, taking UTC representation as reference.
</p></blockquote>
</dd>
<dt> <code>TEXTDOMAIN</code></dt>
<dd>
<p>Default domain used to retrieve translated messages. This value is
set in <tt>`initFunctions.sh'</tt> and shouldn't be changed.
</p>
</dd>
<dt> <code>TEXTDOMAINDIR</code></dt>
<dd>
<p>Default directory used to retrieve translated messages. This value is
set in <tt>`initFunctions.sh'</tt> and shouldn't be changed.
</p>
</dd>
<dt> <code>LANG</code></dt>
<dd>
<p>Default locale information. This value is set when you start your
session and can be changed using the <samp>`locale'</samp> functionality of
<tt>`centos-art.sh'</tt> script (see section <a href="repository_45.html#SEC240">trunk/Scripts/Bash/Functions/Locale</a>, for more information).
</p></dd>
</dl>
<a name="SEC287"></a>
<h3 class="subsection"> 3.48.3 Usage </h3>
<dl compact="compact">
<dt> <samp>`centos-art verify --packages'</samp></dt>
<dd><p>Verify required packages your workstation needs in order to run the
<tt>`centos-art.sh'</tt> script correctly. If there are missing packages,
the <tt>`centos-art.sh'</tt> script asks you to confirm their
installation. When installing packages, the <tt>`centos-art.sh'</tt>
script uses the <code>yum</code> application in order to achieve the
task.
</p>
<p>In case all packages required by <tt>`centos-art.sh'</tt> script are
already installed in your workstation, the message <samp>`The required
packages are already installed.'</samp> is output for you to know.
</p>
</dd>
<dt> <samp>`centos-art verify --links'</samp></dt>
<dd><p>Verify required links your workstation needs in order to run the
centos-art command correctly. If any required link is missing, the
<code>centos-art.sh</code> script asks you to confirm their installation.
To install required links, the <code>centos-art.sh</code> script uses the
<code>ln</code> command.
</p>
<p>In case all links required by <tt>`centos-art.sh'</tt> script are already
created in your workstation, the message <samp>`The required links are
already installed.'</samp> is output for you to know.
</p>
<p>In case a regular file exists with the same name of a required link,
the <tt>`centos-art.sh'</tt> script outputs the <samp>`Already exists as
regular file.'</samp> message when listing required links that will be
installed. Of course, as there is already a regular file where must be
a link, no link is created. In such cases the <tt>`centos-art.sh'</tt>
script will fall into a continue installation request for that missing
link. To end this continue request you can answer <samp>`No'</samp>, or
remove the existent regular file to let <tt>`centos-art.sh'</tt> script
install the link on its place.
</p>
</dd>
<dt> <samp>`centos-art verify --environment'</samp></dt>
<dt> <samp>`centos-art verify --environment --filter='regex''</samp></dt>
<dd><p>Output a brief description of environment variables used by
<tt>`centos-art.sh'</tt> script.
</p>
<p>If <samp>`--filter'</samp> option is provided, output is reduced as defined in
the <samp>`regex'</samp> regular expression value. If <samp>`--filter'</samp> option
is specified but <samp>`regex'</samp> value is not, the <tt>`centos-art.sh'</tt>
script outputs information as if <samp>`--filter'</samp> option had not been
provided at all.
</p></dd>
</dl>
<a name="SEC288"></a>
<h3 class="subsection"> 3.48.4 See also </h3>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top"><a href="repository_41.html#SEC216">3.38 trunk/Scripts/Bash</a></td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top"><a href="repository_42.html#SEC221">3.39 trunk/Scripts/Bash/Functions</a></td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#SEC287" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="repository_52.html#SEC289" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="repository_3.html#SEC3" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="#SEC281" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="repository_66.html#SEC372" title="Next chapter"> >> </a>]</td>
</tr></table>
<p>
<font size="-1">
This document was generated on <i>December, 2 2010</i> using <a class="www" href="http://texi2html.cvshome.org/"><i>texi2html 1.76</i></a>.
</font>
<br>
</p>
</body>
</html>