|
 |
4c79b5 |
|
|
|
4c79b5 |
<html>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
can you do inside it.
|
|
|
4c79b5 |
|
|
|
4c79b5 |
Copyright C 2009, 2010 CentOS Artwork SIG. All rights
|
|
|
4c79b5 |
reserved.
|
|
|
4c79b5 |
|
|
|
4c79b5 |
Permission is granted to copy, distribute and/or modify this document
|
|
|
4c79b5 |
under the terms of the GNU Free Documentation License, Version 1.2 or
|
|
|
4c79b5 |
any later version published by the Free Software Foundation; with no
|
|
|
4c79b5 |
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
|
|
|
4c79b5 |
copy of the license is included in the section entitled GNU Free
|
|
|
4c79b5 |
Documentation License.
|
|
|
4c79b5 |
-->
|
|
|
ca45c0 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
|
|
|
4c79b5 |
Karl Berry <karl@freefriends.org>
|
|
|
4c79b5 |
Olaf Bachmann <obachman@mathematik.uni-kl.de>
|
|
|
4c79b5 |
and many others.
|
|
|
4c79b5 |
Maintained by: Many creative people <dev@texi2html.cvshome.org>
|
|
|
4c79b5 |
Send bugs and suggestions to <users@texi2html.cvshome.org>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
-->
|
|
|
4c79b5 |
<head>
|
|
|
b8013f |
<title>CentOS Artwork Repository: 3.47 trunk/Scripts/Bash/Functions/Verify</title>
|
|
|
4c79b5 |
|
|
|
b8013f |
<meta name="description" content="CentOS Artwork Repository: 3.47 trunk/Scripts/Bash/Functions/Verify">
|
|
|
b8013f |
<meta name="keywords" content="CentOS Artwork Repository: 3.47 trunk/Scripts/Bash/Functions/Verify">
|
|
|
4c79b5 |
<meta name="resource-type" content="document">
|
|
|
4c79b5 |
<meta name="distribution" content="global">
|
|
|
4c79b5 |
<meta name="Generator" content="texi2html 1.76">
|
|
|
4c79b5 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
|
4c79b5 |
<style type="text/css">
|
|
|
4c79b5 |
|
|
|
1e9202 |
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
|
|
|
4c79b5 |
|
|
|
4c79b5 |
a.summary-letter {text-decoration: none}
|
|
|
4c79b5 |
pre.display {font-family: serif}
|
|
|
4c79b5 |
pre.format {font-family: serif}
|
|
|
4c79b5 |
pre.menu-comment {font-family: serif}
|
|
|
4c79b5 |
pre.menu-preformatted {font-family: serif}
|
|
|
4c79b5 |
pre.smalldisplay {font-family: serif; font-size: smaller}
|
|
|
4c79b5 |
pre.smallexample {font-size: smaller}
|
|
|
4c79b5 |
pre.smallformat {font-family: serif; font-size: smaller}
|
|
|
4c79b5 |
pre.smalllisp {font-size: smaller}
|
|
|
4c79b5 |
span.sansserif {font-family:sans-serif; font-weight:normal;}
|
|
|
4c79b5 |
ul.toc {list-style: none}
|
|
|
4c79b5 |
-->
|
|
|
4c79b5 |
</style>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
</head>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
12494b |
[ < ]
|
|
|
12494b |
[ > ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[ << ]
|
|
|
4c79b5 |
[ Up ]
|
|
|
ca45c0 |
[ >> ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[Top]
|
|
|
4c79b5 |
[Contents]
|
|
|
ca45c0 |
[Index]
|
|
|
4c79b5 |
[ ? ]
|
|
|
4c79b5 |
|
|
|
b8013f |
|
|
|
12494b |
|
|
|
b8013f |
3.47 trunk/Scripts/Bash/Functions/Verify
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
12494b |
|
|
|
fe989b |
3.47.1 Goals
|
|
|
4c79b5 |
|
|
|
b8013f |
This section exists to organize files related to "verify"
|
|
|
ca45c0 |
functionality of <tt>`centos-art.sh'</tt> script. The "verify"
|
|
|
ca45c0 |
functionality of <tt>`centos-art.sh'</tt> script helps you to prepare the
|
|
|
ca45c0 |
workstation you are planning to use <tt>`centos-art.sh'</tt> script.
|
|
|
38bcd9 |
|
|
|
4c79b5 |
|
|
|
12494b |
|
|
|
fe989b |
3.47.2 Description
|
|
|
cb2a5d |
|
|
|
b8013f |
The first time you download CentOS Artwork Repository you need to
|
|
|
ca45c0 |
configure your workstation in order to use <tt>`centos-art.sh'</tt>
|
|
|
ca45c0 |
script. These preliminar configurations are based mainly on auxiliar
|
|
|
ca45c0 |
RPM packages installation, symbolic links creations, and environment
|
|
|
ca45c0 |
variables definitions. The "verify" functionality of
|
|
|
ca45c0 |
<tt>`centos-art.sh'</tt> script guides you through this preliminar
|
|
|
ca45c0 |
configuration process.
|
|
|
ca45c0 |
|
|
|
ca45c0 |
If this is the first time you run centos-art command, the
|
|
|
ca45c0 |
appropriate way to use its "verify" functionality is not using the
|
|
|
ca45c0 |
centos-art command directly, but the absolute path to
|
|
|
ca45c0 |
centos-art.sh script instead (i.e.,
|
|
|
ca45c0 |
<tt>`~/artwork/trunk/Scripts/Bash/centos-art.sh'</tt>). This is necessary
|
|
|
ca45c0 |
because centos-art symbolic link, under <tt>`~/bin/'</tt>
|
|
|
ca45c0 |
directory, has not been created yet.
|
|
|
38bcd9 |
|
|
|
eae802 |
|
|
|
eae802 |
|
|
|
eae802 |
3.47.2.1 Packages
|
|
|
eae802 |
|
|
|
b8013f |
Installation of auxiliar RPM packages provides the software required
|
|
|
b8013f |
to manipulate files inside the repository (e.g., image files,
|
|
|
b8013f |
documentation files, translation files, script files, etc.). Most of
|
|
|
ca45c0 |
RPM packages centos-art.sh script uses are shipped with
|
|
|
ca45c0 |
CentOS distribution, and can be installed from CentOS base repository.
|
|
|
ca45c0 |
The only exception is <samp>`inkscape'</samp>, the package we use to
|
|
|
ca45c0 |
manipulate SVG files. The <samp>`inkscape'</samp> package is not inside
|
|
|
ca45c0 |
CentOS distribution so it needs to be installed from third party
|
|
|
eae802 |
repositories.
|
|
|
38bcd9 |
|
|
|
eae802 |
 Note Configuration of third party repositories inside CentOS
|
|
|
eae802 |
distribution is described in CentOS wiki, specifically in the
|
|
|
eae802 |
following URL:
|
|
|
eae802 |
http://wiki.centos.org/AdditionalResources/Repositories
|
|
|
eae802 |
|
|
|
eae802 |
|
|
|
494aa1 |
Before installing packages, the <tt>`centos-art.sh'</tt> script uses
|
|
|
494aa1 |
sudo to request root privileges to execute yum's
|
|
|
494aa1 |
installation functionality. If your user isn't defined as a
|
|
|
494aa1 |
privileged user--at least to run yum commands-- inside
|
|
|
494aa1 |
<tt>`/etc/sudoers'</tt> configuration file, you will not be able to
|
|
|
494aa1 |
perform package installation tasks as set in <tt>`centos-art.sh'</tt>
|
|
|
494aa1 |
script "verify" functionality.
|
|
|
494aa1 |
|
|
|
494aa1 |
Setting sudo privileges to users is an administrative task you have to
|
|
|
494aa1 |
do by yourself. If you don't have experience with sudo
|
|
|
494aa1 |
command, please read its man page running the command: man
|
|
|
494aa1 |
sudo. This reading will be very useful, and with some practice, you
|
|
|
494aa1 |
will be able to configure your users to have sudo
|
|
|
494aa1 |
privileges.
|
|
|
494aa1 |
|
|
|
eae802 |
|
|
|
eae802 |
|
|
|
eae802 |
3.47.2.2 Links
|
|
|
eae802 |
|
|
|
ca45c0 |
Creation of symbolic links helps us to alternate between different
|
|
|
eae802 |
implementations of centos-art command-line (e.g.,
|
|
|
b8013f |
<tt>`centos-art.sh'</tt>, for Bash implementation; <tt>`centos-art.py'</tt>,
|
|
|
b8013f |
for Python implementation; <tt>`centos-art.pl'</tt>, for Perl
|
|
|
eae802 |
implementation; and so on for other implementations). The
|
|
|
eae802 |
centos-art command-line definition takes place inside your
|
|
|
ca45c0 |
personal binary (<tt>`~/bin/'</tt>) directory in order to make the script
|
|
|
ca45c0 |
implementation --the one that centos-art links to--
|
|
|
ca45c0 |
available to PATH environment variable.
|
|
|
ca45c0 |
|
|
|
ca45c0 |
Creation of symbolic links helps us to reuse components from repository
|
|
|
ca45c0 |
working copy. For example, color information files maintained inside
|
|
|
ca45c0 |
your working copy must never be duplicated inside program-specific
|
|
|
ca45c0 |
configuration directories that uses them in your workstation (e.g.,
|
|
|
ca45c0 |
Gimp, Inkscape, etc.). Instead, a symbolic link must be created for
|
|
|
ca45c0 |
each one of them, from program-specific configuration directories to
|
|
|
ca45c0 |
files in the working copy. In this configuration, when someone
|
|
|
ca45c0 |
commits changes to color information files up to central repository,
|
|
|
ca45c0 |
they--the changes committed-- will be immediatly available to your
|
|
|
ca45c0 |
programs the next time you update your working copy --the place
|
|
|
ca45c0 |
inside your workstation those color information files are stored--.
|
|
|
ca45c0 |
|
|
|
ca45c0 |
Creation of symbolic links helps us to make <tt>`centos-art.sh'</tt>
|
|
|
ca45c0 |
script functionalities available outside <tt>`trunk/'</tt> repository
|
|
|
ca45c0 |
directory structure, but at its same level in repository tree. This is
|
|
|
ca45c0 |
useful if you need to use the "render" functionality of
|
|
|
ca45c0 |
centos-art.sh under <tt>`branches/'</tt> repository directory
|
|
|
ca45c0 |
structure as you usually do inside <tt>`trunk/'</tt> repository directory
|
|
|
ca45c0 |
structure. As consequence of this configuration, automation scripts
|
|
|
ca45c0 |
cannot be branched under <tt>`branches/Scripts'</tt> directory structure.
|
|
|
b8013f |
|
|
|
eae802 |
|
|
|
eae802 |
|
|
|
eae802 |
3.47.2.3 Environment variables
|
|
|
eae802 |
|
|
|
ca45c0 |
Definition of environemnt variables helps us to set default values to
|
|
|
ca45c0 |
our user session life. The user session environment variable defintion
|
|
|
ca45c0 |
takes place in the user's <tt>`~/.bash_profile'</tt> file. The "verify"
|
|
|
ca45c0 |
functionality of <tt>`centos-art.sh'</tt> script doesn't modify your
|
|
|
ca45c0 |
<tt>`~/.bash_profile'</tt> file.
|
|
|
38bcd9 |
|
|
|
ca45c0 |
The "verify" functionality of <tt>`centos-art.sh'</tt> script evaluates
|
|
|
ca45c0 |
the following environment variables:
|
|
|
ca45c0 |
|
|
|
ca45c0 |
|
|
|
ca45c0 |
Default text editor (EDITOR)
|
|
|
ca45c0 |
|
|
|
ca45c0 |
The EDITOR environment variable defines your user session
|
|
|
ca45c0 |
default text editor.
|
|
|
ca45c0 |
|
|
|
ca45c0 |
If EDITOR environment variable is not set --or it uses one
|
|
|
ca45c0 |
value other than <tt>`/usr/bin/vim'</tt>, <tt>`/usr/bin/emacs'</tt>, or
|
|
|
ca45c0 |
<tt>`/usr/bin/nano'</tt>-- the <tt>`centos-art.sh'</tt> script uses
|
|
|
ca45c0 |
<tt>`/usr/bin/vim'</tt> as default text editor.
|
|
|
ca45c0 |
|
|
|
ca45c0 |
Default text editor is used by <tt>`centos-art.sh'</tt> script whenever it
|
|
|
ca45c0 |
needs to edit text-based files (e.g., subversion's pre-commit
|
|
|
ca45c0 |
messages, translation files, configuration files, script files, etc.)
|
|
|
ca45c0 |
|
|
|
ca45c0 |
|
|
|
ca45c0 |
Default time representation (TZ)
|
|
|
ca45c0 |
|
|
|
ca45c0 |
The TZ environment variable defines your user session default
|
|
|
ca45c0 |
time zone representation.
|
|
|
ca45c0 |
|
|
|
ca45c0 |
Time representation inside repository server is set to Coordinated
|
|
|
ca45c0 |
Universal Time (UTC). Time represetation inside repository working
|
|
|
ca45c0 |
copies is set as their administrators personally define.
|
|
|
ca45c0 |
|
|
|
ca45c0 |
When repository working copies time representation be defined, it
|
|
|
ca45c0 |
would be a very good convention to follow if working copies
|
|
|
ca45c0 |
administrators would set their systems clock to use UTC. Otherwise it
|
|
|
ca45c0 |
would be difficult for working copies users to find out when changes
|
|
|
ca45c0 |
were committed up to repository server exactly in time.
|
|
|
eae802 |
|
|
|
180cc5 |
 Tip Coordinated Univeral Time (UTC) representation can be
|
|
|
180cc5 |
configured when you install CentOS distribution, or later in your
|
|
|
eae802 |
graphical interface using the following command:
|
|
|
eae802 |
system-config-date
|
|
|
eae802 |
|
|
|
eae802 |
|
|
|
180cc5 |
Note If you set your system clock to use UTC representation,
|
|
|
ca45c0 |
you also need to set the TZ environment variable inside
|
|
|
180cc5 |
<tt>`~/.bash_profile'</tt> as follows:
|
|
|
eae802 |
export TZ=UTC
|
|
|
eae802 |
This is required in order for your terminal to display the correct
|
|
|
180cc5 |
time information of your zone, taking UTC representation as reference.
|
|
|
eae802 |
|
|
|
eae802 |
|
|
|
ca45c0 |
|
|
|
ca45c0 |
|
|
|
eae802 |
|
|
|
ca45c0 |
|
|
|
ca45c0 |
|
|
|
6aec21 |
3.47.3 Usage
|
|
|
6aec21 |
|
|
|
38bcd9 |
|
|
|
b8013f |
<samp>`centos-art verify --packages'</samp>
|
|
|
eae802 |
This command verifies required packages your workstation needs in
|
|
|
ca45c0 |
order to run the centos-art command correctly. If there are
|
|
|
ca45c0 |
missing packages, the <tt>`centos-art.sh'</tt> script asks you to confirm
|
|
|
ca45c0 |
their installation. When installing packages, the <tt>`centos-art.sh'</tt>
|
|
|
ca45c0 |
script uses the yum application in order to achieve the
|
|
|
ca45c0 |
task.
|
|
|
38bcd9 |
|
|
|
38bcd9 |
|
|
|
eae802 |
<samp>`centos-art verify --links'</samp>
|
|
|
eae802 |
This command verifies required links your workstation needs in order
|
|
|
ca45c0 |
to run the centos-art command correctly. If there are
|
|
|
ca45c0 |
missing links, the <tt>`centos-art.sh'</tt> script asks you to confirm
|
|
|
ca45c0 |
their creation. When creating links, the <tt>`centos-art.sh'</tt> script
|
|
|
ca45c0 |
uses the ln application in order to achieve the task.
|
|
|
eae802 |
|
|
|
eae802 |
|
|
|
eae802 |
<samp>`centos-art verify --environment'</samp>
|
|
|
eae802 |
This command verifies required environment variables your workstation
|
|
|
ca45c0 |
needs in order to run centos-art command correctly. If
|
|
|
ca45c0 |
environment variables evaluated by <tt>`centos-art.sh'</tt> script are
|
|
|
ca45c0 |
emtpy, the <tt>`centos-art.sh'</tt> script informs you about it and
|
|
|
ca45c0 |
nothing else happens.
|
|
|
38bcd9 |
|
|
|
38bcd9 |
|
|
|
6aec21 |
|
|
|
6aec21 |
|
|
|
ca45c0 |
|
|
|
4c79b5 |
3.47.4 See also
|
|
|
4c79b5 |
|
|
|
eae802 |
|
|
|
eae802 |
3.35 trunk/Scripts/Bash/Functions
|
|
|
eae802 |
|
|
|
eae802 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
ca45c0 |
[ < ]
|
|
|
ca45c0 |
[ > ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
[ << ]
|
|
|
12494b |
[ Up ]
|
|
|
ca45c0 |
[ >> ]
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
<font size="-1">
|
|
|
ca45c0 |
This document was generated on October, 30 2010 using texi2html 1.76.
|
|
|
4c79b5 |
</font>
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
|
|
|
4c79b5 |
</body>
|
|
|
4c79b5 |
</html>
|