|
 |
a3d7e8 |
% Part : Preparing Your Workstation
|
|
|
a3d7e8 |
% Chapter: Configuration
|
|
|
a3d7e8 |
% ------------------------------------------------------------
|
|
|
a3d7e8 |
% $Id: configuration.tex 6191 2010-08-02 02:36:14Z al $
|
|
|
a3d7e8 |
% ------------------------------------------------------------
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
This chapter describes configurations you need to set up before using
|
|
|
a3d7e8 |
CentOS Artwork Repository.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\section{Firewall}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
The CentOS Artwork Repository lives on the following URL:
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\begin{quote}
|
|
|
a3d7e8 |
https://projects.centos.org/svn/artwork/
|
|
|
a3d7e8 |
\end{quote}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
To reach this location you need to have Internet access and be sure no
|
|
|
a3d7e8 |
rule in your firewall is denying this site. Note that the URL uses the
|
|
|
a3d7e8 |
SSL protocol (port 443).
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\section{Subversion Behind Squid}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
Sometimes it is convenient to proxy Subversion client's requests
|
|
|
a3d7e8 |
through a proxy-cache server like Squid. In cases like this, the Squid
|
|
|
a3d7e8 |
proxy server is in the middle between you and CentOS Artwork
|
|
|
a3d7e8 |
Repository. If you want to proxy Subversion client's requests through
|
|
|
a3d7e8 |
Squid proxy-cache server, you need to configure your Subversion client
|
|
|
a3d7e8 |
and your Squid proxy server to do so.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\subsection{Subversion Client Configuration}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
Subversion client needs to be configured to send requests to your
|
|
|
a3d7e8 |
Squid proxy-cache server. This configuration takes place in the file
|
|
|
a3d7e8 |
\texttt{$\sim$/.subversion/servers}.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\subsection{Squid Server Configuration}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
Squid proxy-cache server needs to be configured to accept the
|
|
|
a3d7e8 |
extension methods \texttt{REPORT MERGE MKACTIVITY CHECKOUT MKCOL}.
|
|
|
a3d7e8 |
This configuration takes place in the file
|
|
|
a3d7e8 |
\texttt{/etc/squid/squid.conf}, specifically in the configuration tag
|
|
|
a3d7e8 |
illustrated in \autoref{fig:Workstation:Configuration:Squid}.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\begin{figure}[!hbp]
|
|
|
a3d7e8 |
\hrulefill
|
|
|
a3d7e8 |
\begin{verbatim}
|
|
|
a3d7e8 |
# TAG: extension_methods
|
|
|
a3d7e8 |
# Squid only knows about standardized HTTP request methods.
|
|
|
a3d7e8 |
# You can add up to 20 additional "extension" methods here.
|
|
|
a3d7e8 |
#
|
|
|
a3d7e8 |
#Default:
|
|
|
a3d7e8 |
# none
|
|
|
a3d7e8 |
extension_methods REPORT MERGE MKACTIVITY CHECKOUT MKCOL
|
|
|
a3d7e8 |
\end{verbatim}
|
|
|
a3d7e8 |
\hrulefill
|
|
|
a3d7e8 |
\caption{Squid configuration to proxy Subversion client's requests.%
|
|
|
a3d7e8 |
\label{fig:Workstation:Configuration:Squid}}
|
|
|
a3d7e8 |
\end{figure}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\section{Working Copy}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
A Subversion working copy is an ordinary directory tree on your local
|
|
|
a3d7e8 |
system, containing a collection of files (i.e. Translations, Designs,
|
|
|
a3d7e8 |
Manuals, and Scripts). You can edit these files however you wish. Your
|
|
|
a3d7e8 |
working copy is your own private work area: Subversion will never
|
|
|
a3d7e8 |
incorporate other people's changes, nor make your own changes
|
|
|
a3d7e8 |
available to others, until you explicitly tell it to do so. You can
|
|
|
a3d7e8 |
even have multiple working copies of the same project.\footnote{Even
|
|
|
a3d7e8 |
this is basically correct, doing so when using CentOS Artowrk
|
|
|
a3d7e8 |
Repository can bring some confusion when executing scripts. Presently,
|
|
|
a3d7e8 |
only one absolute path can be defined as absolute path for scripts'
|
|
|
a3d7e8 |
execution. You can have as many working copies of CentOS Artwork
|
|
|
a3d7e8 |
Repository as you want but scripts will be executed from just one
|
|
|
a3d7e8 |
working copy absolute path. That is, the one stored under
|
|
|
a3d7e8 |
\texttt{/home/centos/artwork/}}.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
Once you've made some changes to your working copy files and verified
|
|
|
a3d7e8 |
that they work properly, Subversion provides you with commands to
|
|
|
a3d7e8 |
``publish'' your changes to the other people working with you on your
|
|
|
a3d7e8 |
project (by writing to the repository). If other people publish their
|
|
|
a3d7e8 |
own changes, Subversion provides you with commands to merge those
|
|
|
a3d7e8 |
changes into your working directory (by reading from the repository).
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\begin{figure}[!hbp]
|
|
|
a3d7e8 |
\hrulefill
|
|
|
a3d7e8 |
\begin{verbatim}
|
|
|
a3d7e8 |
svn co https://projects.centos.org/svn/artwork /home/centos/
|
|
|
a3d7e8 |
\end{verbatim}
|
|
|
a3d7e8 |
\hrulefill
|
|
|
a3d7e8 |
\caption{Subversion command used to download the working copy.%
|
|
|
a3d7e8 |
\label{fig:Workstation:WC:Download}}
|
|
|
a3d7e8 |
\end{figure}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
The subversion command illustrated in
|
|
|
a3d7e8 |
\autoref{fig:Workstation:WC:Download} brings a CentOS Artwork
|
|
|
a3d7e8 |
Repository working copy down to your workstation, specifically to your
|
|
|
a3d7e8 |
home directory (\texttt{/home/centos/artwork/}). This process may take
|
|
|
a3d7e8 |
some time. Once the working copy is available in your workstation,
|
|
|
a3d7e8 |
you are ready to start exploring and improving available works.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
Note that you need to have a username called \texttt{centos} in your
|
|
|
a3d7e8 |
system. If you don't have it, you can create it using the comand
|
|
|
a3d7e8 |
\texttt{useradd} as superuser (\texttt{root}).
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\subsection{Standardizing Absolute Path}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
When using Inkscape to import raster images inside SVG files the
|
|
|
a3d7e8 |
absolute image path is required. If everyone stores the working copy
|
|
|
a3d7e8 |
on a different absolute path imported images will not be loaded in
|
|
|
a3d7e8 |
those location different from those they were conceived. There is no
|
|
|
a3d7e8 |
way to find the right absolute image path but defining a convenction
|
|
|
a3d7e8 |
about it.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
On a path string (e.g., /home/centos/artwork/trunk/) the username
|
|
|
a3d7e8 |
(`centos') is the variable component, so it is the component we need
|
|
|
a3d7e8 |
to standardize--in the sake of keeping the working copy inside user's
|
|
|
a3d7e8 |
/home/ structure. Thus, analysing which username to use, the CentOS
|
|
|
a3d7e8 |
Project is what join us all together, so the `centos' word in
|
|
|
a3d7e8 |
lower-case seems to be a nice choise for us to use as common username.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\section{User Identification}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
At this point you probably have made some changes inside your working
|
|
|
a3d7e8 |
copy and wish to publish them. To publish your changes on CentOS
|
|
|
a3d7e8 |
Artwork Repository you need to have a registered account with commit
|
|
|
a3d7e8 |
privilege in CentOS Artwork Repository.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
If you are new in CentOS Artwork Repository it is possible that you
|
|
|
a3d7e8 |
can't commit your changes. That is because new registered accounts
|
|
|
a3d7e8 |
haven't commit privilege set by default. In order for your registered
|
|
|
a3d7e8 |
account to have commit privilege inside CentOS Artwork Repository you
|
|
|
a3d7e8 |
need to request it. See section
|
|
|
a3d7e8 |
\ref{sec:Configuration:User:Privileges}.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\subsection{User Account Registration}
|
|
|
a3d7e8 |
\label{sec:Configuration:Account}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
To register a user account inside CentOS Artwork Repository, you need
|
|
|
a3d7e8 |
to go to the following URL:
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\begin{quote}
|
|
|
a3d7e8 |
\url{https://projects.centos.org/trac/artwork/}
|
|
|
a3d7e8 |
\end{quote}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\subsection{User Account Privileges}
|
|
|
a3d7e8 |
\label{sec:Configuration:User:Privileges}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
To have commit privileges in CentOS Artwork Repository it is needed
|
|
|
a3d7e8 |
that you show your interest first, preferably with something useful
|
|
|
a3d7e8 |
like a new or improved design, translation, manual, or script. As
|
|
|
a3d7e8 |
convenction, people working on CentOS Artwork Repository share ideas
|
|
|
a3d7e8 |
in the mailing list
|
|
|
a3d7e8 |
\href{mailto:centos-devel@centos.org}{centos-devel@centos.org}. If you
|
|
|
a3d7e8 |
are interested in joining us go there and express yourself.
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\section{Repository Tagged Revisions}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
The CentOS Artwork Repository is also available as tagged revisions.
|
|
|
a3d7e8 |
Tagged revisions are checkpoints on the CentOS Artwork Repository
|
|
|
a3d7e8 |
developing lifetime. They are inmutable copies of the CentOS Artwork
|
|
|
a3d7e8 |
Repository state through time. Tagged revisions contain the files
|
|
|
a3d7e8 |
used to produce images but not images themselves. Inside tagged
|
|
|
a3d7e8 |
revisions you can find scripts (\texttt{.sh}), design templates
|
|
|
a3d7e8 |
(\texttt{.svg}), translation files (\texttt{\.sed}), gimp projects
|
|
|
a3d7e8 |
(\texttt{.xcf}), and documetation files (\texttt{.tex}).
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
CentOS Artowrk Repository tagged revisions are available for
|
|
|
a3d7e8 |
downloading in the following location:
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\begin{description}
|
|
|
a3d7e8 |
\item[URL:] https://projects.centos.org/svn/artwork/tags
|
|
|
a3d7e8 |
\end{description}
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
and alternatively, you can find references in the CentOS Project's
|
|
|
a3d7e8 |
wiki, specifically in the ArtWork page:
|
|
|
a3d7e8 |
|
|
|
a3d7e8 |
\begin{description}
|
|
|
a3d7e8 |
\item[URL:] http://wiki.centos.org/ArtWork
|
|
|
a3d7e8 |
\end{description}
|