Blame Manuals/en/Html/Repository/repository_48.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
-->
008ee0
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>
3d6160
<title>CentOS Artwork Repository: 3.45 trunk/Scripts/Bash/Functions/Verify</title>
4c79b5
3d6160
<meta name="description" content="CentOS Artwork Repository: 3.45 trunk/Scripts/Bash/Functions/Verify">
3d6160
<meta name="keywords" content="CentOS Artwork Repository: 3.45 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
3d6160
[ < ]
3d6160
[ > ]
4c79b5
   
4c79b5
[ << ]
4c79b5
[ Up ]
3d6160
[ >> ]
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
   
4c79b5
[Top]
4c79b5
[Contents]
3d6160
[Index]
4c79b5
[ ? ]
4c79b5
3d6160
3d6160
3d6160

3.45 trunk/Scripts/Bash/Functions/Verify

2c8180
2c8180
3d6160
273af8

3.45.1 Goals

e68a7a
3d6160

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

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

e68a7a
3d6160
273af8

3.45.2 Description

60c152
3d6160

The first time you download CentOS Artwork Repository you need to

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

3d6160

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

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

60c152
3d6160
3d6160

3.45.2.1 Packages

60c152
3d6160

Installation of auxiliar RPM packages provides the software required

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

3d6160
info

Note

Configuration of third party repositories inside CentOS

3d6160
distribution is described in CentOS wiki, specifically in the
3d6160
following URL:
3d6160
http://wiki.centos.org/AdditionalResources/Repositories
3d6160

3d6160
3d6160

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

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

3d6160

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

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

3d6160
3d6160
3d6160

3.45.2.2 Links

3d6160
3d6160

Creation of symbolic links helps us to alternate between different

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

3d6160

Creation of symbolic links helps us to reuse components from repository

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

3d6160

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

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

3d6160
3d6160
3d6160

3.45.2.3 Environment variables

3d6160
3d6160

Definition of environemnt variables helps us to set default values to

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

3d6160

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

3d6160
evaluates the following environment variables:
54b5a5

3d6160
3d6160
EDITOR
3d6160

Default text editor.

831389

3d6160

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

3d6160
pre-commit subversion messages, translation files, configuration
3d6160
files, script files, and similar text-based files.
831389

3d6160

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

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

3d6160
    3d6160
  • <tt>`/usr/bin/vim'</tt>
  • 3d6160
  • <tt>`/usr/bin/emacs'</tt>
  • 3d6160
  • <tt>`/usr/bin/nano'</tt>
  • 3d6160
    3d6160
    3d6160

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

    3d6160
    <tt>`centos-art.sh'</tt> uses <tt>`/usr/bin/vim'</tt> text editor by default. 
    273af8

    273af8
    3d6160
    TZ
    3d6160
    3d6160

    Default time zone representation.

    273af8

    3d6160

    Time representation inside repository server is set to Coordinated

    3d6160
    Universal Time (UTC).  Time represetation inside repository working
    3d6160
    copies is set as their administrators personally define.  
    273af8

    3d6160

    When repository working copies time representation be defined, it

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

    3d6160
    Info

    Tip

    Coordinated Univeral Time (UTC) representation can be

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

    3d6160
    3d6160
    info

    Note

    If you set your system clock to use UTC representation,

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

    export TZ=UTC
    3d6160

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

    3d6160
    time information of your zone, taking UTC representation as reference.
    3d6160

    3d6160
    54b5a5
    3d6160
    TEXTDOMAIN
    3d6160
    3d6160

    Default domain used to retrieve translated messages. This value is

    3d6160
    set in <tt>`initFunctions.sh'</tt> and shouldn't be changed.
    54b5a5

    54b5a5
    3d6160
    TEXTDOMAINDIR
    3d6160
    3d6160

    Default directory used to retrieve translated messages. This value is

    3d6160
    set in <tt>`initFunctions.sh'</tt> and shouldn't be changed.
    54b5a5

    54b5a5
    3d6160
    LANG
    3d6160
    3d6160

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

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

    54b5a5
    54b5a5
    63f275
    e68a7a
    63f275

    3.45.3 Usage

    63f275
    63f275
    3d6160
    <samp>`centos-art verify --packages'</samp>
    3d6160

    Verify required packages your workstation needs in order to run the

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

    3d6160

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

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

    60c152
    3d6160
    <samp>`centos-art verify --links'</samp>
    3d6160

    Verify required links your workstation needs in order to run the

    3d6160
    centos-art command correctly.  If any required link is missing, the
    3d6160
    centos-art.sh script asks you to confirm their installation.
    3d6160
    To install required links, the centos-art.sh script uses the
    3d6160
    ln command.
    273af8

    3d6160

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

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

    3d6160

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

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

    3d6160
    3d6160
    <samp>`centos-art verify --environment'</samp>
    3d6160
    <samp>`centos-art verify --environment --filter='regex''</samp>
    3d6160

    Output a brief description of environment variables used by

    3d6160
    <tt>`centos-art.sh'</tt> script. 
    273af8

    3d6160

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

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

    3d6160
    3d6160
    e68a7a
    e68a7a
    300762

    3.45.4 See also

    4c79b5
    2c8180
    63f275
    3.36 trunk/Scripts/Bash  
    54b5a5
    63f275
    3.37 trunk/Scripts/Bash/Functions  
    2c8180
    2c8180
    4c79b5
    4c79b5
    4c79b5
    e68a7a
    [ < ]
    e68a7a
    [ > ]
    4c79b5
       
    4c79b5
    [ << ]
    3d6160
    [ Up ]
    3d6160
    [ >> ]
    4c79b5
    4c79b5

    4c79b5
     <font size="-1">
    008ee0
      This document was generated on December, 2 2010 using texi2html 1.76.
    4c79b5
     </font>
    4c79b5
     
    4c79b5
    4c79b5

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