Blame Manual/repository-html/repository_66.html

010b2d
010b2d
<html>
d1db00
d1db00
organization, and administration of CentOS Artwork Repository.
d1db00
d1db00
Copyright C 2009-2011 Alain Reguera Delgado
010b2d
010b2d
Permission is granted to copy, distribute and/or modify this document
010b2d
under the terms of the GNU Free Documentation License, Version 1.2 or
010b2d
any later version published by the Free Software Foundation; with no
010b2d
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
010b2d
copy of the license is included in the section entitled GNU Free
010b2d
Documentation License.  
010b2d
-->
afcfb5
010b2d
010b2d
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
010b2d
            Karl Berry  <karl@freefriends.org>
010b2d
            Olaf Bachmann <obachman@mathematik.uni-kl.de>
010b2d
            and many others.
010b2d
Maintained by: Many creative people <dev@texi2html.cvshome.org>
010b2d
Send bugs and suggestions to <users@texi2html.cvshome.org>
010b2d
010b2d
-->
010b2d
<head>
671838
<title>CentOS Artwork Repository: 2.62 The trunk/Scripts/Bash/Cli/Functions/Verify Directory</title>
010b2d
671838
<meta name="description" content="CentOS Artwork Repository: 2.62 The trunk/Scripts/Bash/Cli/Functions/Verify Directory">
671838
<meta name="keywords" content="CentOS Artwork Repository: 2.62 The trunk/Scripts/Bash/Cli/Functions/Verify Directory">
010b2d
<meta name="resource-type" content="document">
010b2d
<meta name="distribution" content="global">
010b2d
<meta name="Generator" content="texi2html 1.76">
010b2d
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
010b2d
<style type="text/css">
010b2d
010b2d
@import "/home/centos/artwork/trunk/Identity/Models/Css/Texi2html/common.css";
010b2d
010b2d
a.summary-letter {text-decoration: none}
010b2d
pre.display {font-family: serif}
010b2d
pre.format {font-family: serif}
010b2d
pre.menu-comment {font-family: serif}
010b2d
pre.menu-preformatted {font-family: serif}
010b2d
pre.smalldisplay {font-family: serif; font-size: smaller}
010b2d
pre.smallexample {font-size: smaller}
010b2d
pre.smallformat {font-family: serif; font-size: smaller}
010b2d
pre.smalllisp {font-size: smaller}
010b2d
span.sansserif {font-family:sans-serif; font-weight:normal;}
010b2d
ul.toc {list-style: none}
010b2d
-->
010b2d
</style>
010b2d
010b2d
010b2d
</head>
010b2d
010b2d
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
010b2d
010b2d
671838
[ < ]
671838
[ > ]
010b2d
   
671838
[ << ]
671838
[ Up ]
671838
[ >> ]
010b2d
   
010b2d
   
010b2d
   
010b2d
   
982d5c
[Top]
982d5c
[Contents]
671838
[Index]
982d5c
[ ? ]
010b2d
671838
671838
671838

2.62 The <tt>`trunk/Scripts/Bash/Cli/Functions/Verify'</tt> Directory

671838
671838
671838
671838

2.62.1 Goals

671838
671838

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

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

671838
063806
671838

2.62.2 Description

063806
671838

The first time you download CentOS Artwork Repository you need to

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

671838

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

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

063806
063806
671838

2.62.2.1 Packages

063806
671838

Installation of auxiliar RPM packages provides the software required

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

671838
info

Note

Configuration of third party repositories inside CentOS

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

671838
671838

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

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

671838

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

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

063806
063806
671838

2.62.2.2 Links

063806
671838

Creation of symbolic links helps us to alternate between different

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

671838

Creation of symbolic links helps us to reuse components from repository

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

671838

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

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

063806
063806
671838

2.62.2.3 Environment variables

063806
671838

Definition of environemnt variables helps us to set default values to

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

671838

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

671838
evaluates the following environment variables:
063806

063806
671838
EDITOR
671838

Default text editor.

063806

671838

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

671838
pre-commit subversion messages, translation files, configuration
671838
files, script files, and similar text-based files.
063806

671838

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

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

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

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

    671838
    <tt>`centos-art.sh'</tt> uses <tt>`/usr/bin/vim'</tt> text editor by default. 
    063806

    063806
    671838
    TEXTDOMAIN
    671838
    671838

    Default domain used to retrieve translated messages. This variable is

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

    f66721
    671838
    TEXTDOMAINDIR
    671838
    671838

    Default directory used to retrieve translated messages. This variable

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

    f66721
    671838
    LANG
    671838
    671838

    Default locale information.

    063806

    671838

    This variable is initially set in the configuration process of CentOS

    671838
    distribution installer (i.e., Anaconda), specifically in the
    671838
    <samp>`Language'</samp> step; or once installed using the
    671838
    system-config-language tool.
    063806

    671838

    The <tt>`centos-art.sh'</tt> script uses the LANG environment

    671838
    variable to know in which language the script messages are printed
    671838
    out.
    063806

    f66721
    671838
    TZ
    671838
    671838

    Default time zone representation.

    063806

    671838

    This variable is initially set in the configuration process of CentOS

    671838
    distribution installer (i.e., Anaconda), specifically in the
    671838
    <samp>`Date and time'</samp> step; or once installed using the
    671838
    system-config-date tool.
    063806

    671838

    The <tt>`centos-art.sh'</tt> script doesn't use the TZ environment

    671838
    variable information at all. Instead, this variable is used by the
    671838
    system shell to show the time information according to your phisical
    671838
    location on planet Earth.  
    671838

    671838

    Inside your computer, the time information is firstly set in the BIOS

    671838
    clock (which may need correction), and later in the configuration
    671838
    process of CentOS distribution installer (or later, by any of the
    671838
    related configuration tools inside CentOS distribution).  Generally,
    671838
    setting time information is a straight-forward task and configuration
    671838
    tools available do cover most relevant location. However, if you need
    671838
    a time precision not provided by the configuration tools available
    671838
    inside CentOS distribution then, using TZ variable may be
    671838
    necessary.
    671838

    671838
    Convenction

    Convenction

    In order to keep changes syncronized between

    671838
    central repository and its working copies: configure both repository
    671838
    server and workstations (i.e., the place where each working copy is
    671838
    set on) to use Coordinated Universal Time (UTC) as base time
    671838
    representation.  Later, correct the time information for your specific
    671838
    location using time zone correction.
    671838

    671838
    671838

    The format of TZ environment variable is described in

    671838
    <tt>`tzset(3)'</tt> manual page.
    063806

    063806
    063806
    063806
    063806
    063806
    671838

    2.62.3 Usage

    f66721
    f66721
    671838
    centos-art verify --packages
    671838
    671838

    Verify required packages your workstation needs in order to run the

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

    671838

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

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

    671838
    671838
    centos-art verify --links
    671838
    671838

    Verify required links your workstation needs in order to run the

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

    671838

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

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

    671838

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

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

    671838
    671838
    centos-art verify --environment
    671838
    centos-art verify --environment --filter='regex'
    671838
    671838

    Output a brief description of environment variables used by

    671838
    <tt>`centos-art.sh'</tt> script. 
    671838

    671838

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

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

    063806
    063806
    063806
    063806
    671838
    671838

    2.62.4 See also

    063806
    063806
    671838
    2.50 The <tt>`trunk/Scripts/Bash'</tt> Directory  
    063806
    982d5c
    982d5c
    010b2d
    010b2d
    671838
    [ < ]
    671838
    [ > ]
    010b2d
       
    671838
    [ << ]
    671838
    [ Up ]
    671838
    [ >> ]
    010b2d
    010b2d

    010b2d
     <font size="-1">
    afcfb5
      This document was generated on March, 2 2011 using texi2html 1.76.
    010b2d
     </font>
    010b2d
     
    010b2d
    010b2d

    010b2d
    </body>
    010b2d
    </html>