Blame Manuals/en/Html/Repository/repository_47.html

4c79b5
4c79b5
<html>
09d4f2
09d4f2
09d4f2
The CentOS Artwork Repository exists to organize and automate The
09d4f2
CentOS Project corporate visual identity (, to
09d4f2
start on).
4c79b5
6c4982
Copyright C 2009, 2010 Alain Reguera Delgado. 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
-->
09d4f2
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>
2c8180
<title>CentOS Artwork Repository: 3.44 trunk/Scripts/Bash/Functions/Verify</title>
4c79b5
2c8180
<meta name="description" content="CentOS Artwork Repository: 3.44 trunk/Scripts/Bash/Functions/Verify">
2c8180
<meta name="keywords" content="CentOS Artwork Repository: 3.44 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
09d4f2
[ < ]
09d4f2
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
09d4f2
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
09d4f2
[Index]
4c79b5
[ ? ]
4c79b5
2c8180
09d4f2
2c8180

3.44 trunk/Scripts/Bash/Functions/Verify

54264c
4c79b5
09d4f2
081970

3.44.1 Goals

4c79b5
2d7726

This section exists to organize files related to <tt>`centos-art.sh'</tt>

efa7b7
script <samp>`verify'</samp> functionality.  The <samp>`verify'</samp>
efa7b7
functionality of <tt>`centos-art.sh'</tt> script helps you to verify the
efa7b7
workstation configuration you are planning to use as host for your
efa7b7
working copy of CentOS Artwork Repository.
2c8180

4c79b5
09d4f2
081970

3.44.2 Description

6aec21
2c8180

The first time you download CentOS Artwork Repository you need to

2c8180
configure your workstation in order to use <tt>`centos-art.sh'</tt>
2c8180
script.  These preliminar configurations are based mainly on auxiliar
2c8180
RPM packages installation, symbolic links creations, and environment
efa7b7
variables definitions.  The <samp>`verify'</samp> functionality of
2c8180
<tt>`centos-art.sh'</tt> script guides you through this preliminar
2c8180
configuration process.  
2c8180

2bb528

If this is the first time you run <tt>`centos-art.sh'</tt> script, the

efa7b7
appropriate way to use its <samp>`verify'</samp> functionality is not using
2bb528
the <tt>`centos-art.sh'</tt> script directly, but the absolute path to
2c8180
centos-art.sh script instead (i.e.,
2c8180
<tt>`~/artwork/trunk/Scripts/Bash/centos-art.sh'</tt>).  This is necessary
2bb528
because <tt>`centos-art'</tt> symbolic link, under <tt>`~/bin/'</tt>
2c8180
directory, has not been created yet.
2c8180

6aec21
09d4f2
2c8180

3.44.2.1 Packages

6aec21
2c8180

Installation of auxiliar RPM packages provides the software required

2c8180
to manipulate files inside the repository (e.g., image files,
2c8180
documentation files, translation files, script files, etc.). Most of
2c8180
RPM packages centos-art.sh script uses are shipped with
2c8180
CentOS distribution, and can be installed from CentOS base repository.
2c8180
The only exception is <samp>`inkscape'</samp>, the package we use to
2c8180
manipulate SVG files.  The <samp>`inkscape'</samp> package is not inside
2c8180
CentOS distribution so it needs to be installed from third party
2c8180
repositories.
2c8180

2c8180
info

Note

Configuration of third party repositories inside CentOS

2c8180
distribution is described in CentOS wiki, specifically in the
2c8180
following URL:
09d4f2
http://wiki.centos.org/AdditionalResources/Repositories
2c8180

38bcd9
2c8180

Before installing packages, the <tt>`centos-art.sh'</tt> script uses

2c8180
sudo to request root privileges to execute yum's
2c8180
installation functionality.  If your user isn't defined as a
2c8180
privileged user--at least to run yum commands-- inside
2c8180
<tt>`/etc/sudoers'</tt> configuration file, you will not be able to
2c8180
perform package installation tasks as set in <tt>`centos-art.sh'</tt>
efa7b7
script <samp>`verify'</samp> functionality. 
2c8180

2c8180

Setting sudo privileges to users is an administrative task you have to

2c8180
do by yourself. If you don't have experience with sudo
2c8180
command, please read its man page running the command: man
2c8180
sudo. This reading will be very useful, and with some practice, you
2c8180
will be able to configure your users to have sudo
2c8180
privileges.
2c8180

6aec21
09d4f2
2c8180

3.44.2.2 Links

2c8180
2c8180

Creation of symbolic links helps us to alternate between different

2bb528
implementations of <tt>`centos-art.sh'</tt> script-line (e.g.,
2c8180
<tt>`centos-art.sh'</tt>, for Bash implementation; <tt>`centos-art.py'</tt>,
2c8180
for Python implementation; <tt>`centos-art.pl'</tt>, for Perl
2c8180
implementation; and so on for other implementations). The
2bb528
<tt>`centos-art.sh'</tt> script-line definition takes place inside your
2c8180
personal binary (<tt>`~/bin/'</tt>) directory in order to make the script
2bb528
implementation --the one that <tt>`centos-art'</tt> links to-- available
2bb528
to PATH environment variable.
2c8180

2c8180

Creation of symbolic links helps us to reuse components from repository

2c8180
working copy. For example, color information files maintained inside
2c8180
your working copy must never be duplicated inside program-specific
2c8180
configuration directories that uses them in your workstation (e.g.,
2c8180
Gimp, Inkscape, etc.).  Instead, a symbolic link must be created for
2c8180
each one of them, from program-specific configuration directories to
2c8180
files in the working copy.  In this configuration, when someone
2c8180
commits changes to color information files up to central repository,
2c8180
they--the changes committed-- will be immediatly available to your
2c8180
programs the next time you update your working copy --the place
2c8180
inside your workstation those color information files are stored--.
2c8180

2c8180

Creation of symbolic links helps us to make <tt>`centos-art.sh'</tt>

2c8180
script functionalities available outside <tt>`trunk/'</tt> repository
2c8180
directory structure, but at its same level in repository tree. This is
2c8180
useful if you need to use the "render" functionality of
2c8180
centos-art.sh under <tt>`branches/'</tt> repository directory
2c8180
structure as you usually do inside <tt>`trunk/'</tt> repository directory
2c8180
structure. As consequence of this configuration, automation scripts
2c8180
cannot be branched under <tt>`branches/Scripts'</tt> directory structure.
2c8180

2c8180
09d4f2
2c8180

3.44.2.3 Environment variables

2c8180
2c8180

Definition of environemnt variables helps us to set default values to

2c8180
our user session life. The user session environment variable defintion
efa7b7
takes place in the user's <tt>`~/.bash_profile'</tt> file.  The
efa7b7
<samp>`verify'</samp> functionality of <tt>`centos-art.sh'</tt> script doesn't
efa7b7
modify your <tt>`~/.bash_profile'</tt> file.  
2c8180

efa7b7

The <samp>`verify'</samp> functionality of <tt>`centos-art.sh'</tt> script

efa7b7
evaluates the following environment variables:
2c8180

2c8180
41f1ec
EDITOR
2bb528

Default text editor.

2bb528

2bb528

The <tt>`centos-art.sh'</tt> script uses default text EDITOR to edit

2bb528
pre-commit subversion messages, translation files, configuration
2bb528
files, script files, and similar text-based files.
2c8180

2bb528

If EDITOR environment variable is not set, <tt>`centos-art.sh'</tt>

2bb528
script uses <tt>`/usr/bin/vim'</tt> as default text editor. Otherwise, the
2bb528
following values are recognized by <tt>`centos-art.sh'</tt> script:
2c8180

2bb528
    2bb528
  • <tt>`/usr/bin/vim'</tt>
  • 2bb528
  • <tt>`/usr/bin/emacs'</tt>
  • 2bb528
  • <tt>`/usr/bin/nano'</tt>
  • 2bb528
    2bb528
    2bb528

    If no one of these values is set in EDITOR environment variable,

    2bb528
    <tt>`centos-art.sh'</tt> uses <tt>`/usr/bin/vim'</tt> text editor by default. 
    2c8180

    2c8180
    41f1ec
    TZ
    2c8180
    ef356a

    Default time zone representation.

    2c8180

    2c8180

    Time representation inside repository server is set to Coordinated

    2c8180
    Universal Time (UTC).  Time represetation inside repository working
    2c8180
    copies is set as their administrators personally define.  
    2c8180

    2c8180

    When repository working copies time representation be defined, it

    2c8180
    would be a very good convention to follow if working copies
    2c8180
    administrators would set their systems clock to use UTC.  Otherwise it
    2c8180
    would be difficult for working copies users to find out when changes
    2c8180
    were committed up to repository server exactly in time.
    2c8180

    2c8180
    Info

    Tip

    Coordinated Univeral Time (UTC) representation can be

    2bb528
    configured when you install CentOS distribution; or later, runing the
    2bb528
    system-config-date command at a shell prompt from your
    2bb528
    graphical interface.
    2bb528

    2c8180
    2c8180
    info

    Note

    If you set your system clock to use UTC representation,

    2bb528
    you also need to set the TZ environment variable inside
    2c8180
    <tt>`~/.bash_profile'</tt> as follows:
    2c8180

    export TZ=UTC
    2c8180

    This is required in order for your terminal to display the correct

    2c8180
    time information of your zone, taking UTC representation as reference.
    2c8180

    ef356a
    ef356a
    41f1ec
    TEXTDOMAIN
    ef356a
    ef356a

    Default domain used to retrieve translated messages. This value is

    ef356a
    set in <tt>`initFunctions.sh'</tt> and shouldn't be changed.
    ef356a

    ef356a
    41f1ec
    TEXTDOMAINDIR
    ef356a
    ef356a

    Default directory used to retrieve translated messages. This value is

    ef356a
    set in <tt>`initFunctions.sh'</tt> and shouldn't be changed.
    ef356a

    2c8180
    41f1ec
    LANG
    ef356a
    ef356a

    Default locale information. This value is set when you start your

    2bb528
    session and can be changed using the <samp>`locale'</samp> functionality of
    09d4f2
    <tt>`centos-art.sh'</tt> script (see section trunk/Scripts/Bash/Functions/Locale, for more information).
    ef356a

    2c8180
    2c8180
    2c8180
    09d4f2
    2c8180

    3.44.3 Usage

    2c8180
    2c8180
    2c8180
    <samp>`centos-art verify --packages'</samp>
    2bb528

    Verify required packages your workstation needs in order to run the

    2bb528
    <tt>`centos-art.sh'</tt> script correctly.  If there are missing packages,
    2bb528
    the <tt>`centos-art.sh'</tt> script asks you to confirm their
    2bb528
    installation. When installing packages, the <tt>`centos-art.sh'</tt>
    2c8180
    script uses the yum application in order to achieve the
    2c8180
    task.
    2c8180

    b17ce8

    In case all packages required by <tt>`centos-art.sh'</tt> script are

    b17ce8
    already installed in your workstation, the message <samp>`The required
    b17ce8
    packages are already installed.'</samp> is output for you to know. 
    b17ce8

    2c8180
    2c8180
    <samp>`centos-art verify --links'</samp>
    2bb528

    Verify required links your workstation needs in order to run the

    2bb528
    centos-art command correctly.  If any required link is missing, the
    2bb528
    centos-art.sh script asks you to confirm their installation.
    2bb528
    To install required links, the centos-art.sh script uses the
    2bb528
    ln command.
    2c8180

    b17ce8

    In case all links required by <tt>`centos-art.sh'</tt> script are already

    b17ce8
    created in your workstation, the message <samp>`The required links are
    b17ce8
    already installed.'</samp> is output for you to know. 
    b17ce8

    0c6cdb

    In case a regular file exists with the same name of a required link,

    6226b1
    the <tt>`centos-art.sh'</tt> script outputs the <samp>`Already exists as
    1c7bf6
    regular file.'</samp> message when listing required links that will be
    1c7bf6
    installed. Of course, as there is already a regular file where must be
    1c7bf6
    a link, no link is created. In such cases the <tt>`centos-art.sh'</tt>
    1c7bf6
    script will fall into a continue installation request for that missing
    0c6cdb
    link.  To end this continue request you can answer <samp>`No'</samp>, or
    1c7bf6
    remove the existent regular file to let <tt>`centos-art.sh'</tt> script
    0c6cdb
    install the link on its place.
    1c7bf6

    2c8180
    2c8180
    <samp>`centos-art verify --environment'</samp>
    ef356a
    <samp>`centos-art verify --environment --filter='regex''</samp>
    2bb528

    Output a brief description of environment variables used by

    2bb528
    <tt>`centos-art.sh'</tt> script. 
    ef356a

    ef356a

    If <samp>`--filter'</samp> option is provided, output is reduced as defined in

    ef356a
    the <samp>`regex'</samp> regular expression value. If <samp>`--filter'</samp> option
    ef356a
    is specified but <samp>`regex'</samp> value is not, the <tt>`centos-art.sh'</tt>
    ef356a
    script outputs information as if <samp>`--filter'</samp> option had not been
    ef356a
    provided at all.
    2c8180

    2c8180
    2c8180
    2c8180
    09d4f2
    4c79b5

    3.44.4 See also

    4c79b5
    2c8180
    64d0d3
    3.34 trunk/Scripts/Bash  
    64d0d3
    efa7b7
    3.35 trunk/Scripts/Bash/Functions  
    2c8180
    2c8180
    4c79b5
    4c79b5
    4c79b5
    09d4f2
    [ < ]
    09d4f2
    [ > ]
    4c79b5
       
    4c79b5
    [ << ]
    09d4f2
    [ Up ]
    09d4f2
    [ >> ]
    4c79b5
    4c79b5

    4c79b5
     <font size="-1">
    09d4f2
      This document was generated on November, 21 2010 using texi2html 1.76.
    4c79b5
     </font>
    4c79b5
     
    4c79b5
    4c79b5

    4c79b5
    </body>
    4c79b5
    </html>