\documentclass{report}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{textcomp}
\usepackage{geometry}
\geometry{top=15mm, bottom=15mm, left=1cm, right=1cm}
\usepackage[french]{babel}
\usepackage{pslatex}
\usepackage[colorlinks=true,urlcolor=black]{hyperref}
\usepackage{graphicx}
\usepackage{fancyhdr}
\pagestyle{fancy}
\renewcommand{\footrulewidth}{0.4pt}
\fancyfoot[L]{Uubu.fr}
\fancyfoot[R]{lun. mars 15 19:03:25 CET 2010}
\lfoot{\Large \textit{Uubu.fr}}
\hypersetup{pdfinfo={
Title={apt-proxy},
Author={Sylvain Girod},
Creator={Bash script from uubu.fr's format version 1},
Producer={Bash script and PDFLaTeX},
Subject={Mise en place d'un proxy de dépôts},
CreationDate={D:20100315190325},
ModDate={D:20100315190325},
Keywords={package manager;apt}
}}
\begin{document}
 
\begin{center}
{\Huge apt-proxy }
\end{center}
\vspace{1cm}
 
\begin{flushleft}
 
{\large Mise en place d'un proxy de dépôts}
 
\vspace{10mm}
 
\hspace{1mm}  Apt-proxy est un mandataire écrit en python pour apt-get. Il communique via HTTP avec les clients et via HTTP, FTP et rsync vers les serveurs. Il est utile pour limiter la consommation de bande passante Internet utilisé pour les mises à jours par exemple. le fichier de configuration par défaut est /etc/apt-proxy/apt-proxy-v2.conf (modifiable avec l'option -c ou --config-file=)
\vspace{5mm} \\
 
 
\vspace{1cm}{\huge configuration }
 
\
 
\hspace{1mm}  il est divisé en plusieurs sections, chacune définissant une ressource. La section DEFAULT s'applique à toutes les sections.
\vspace{5mm} \\
 
 
\vspace{1cm}{\huge [DEFAULT] }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} address]{Adresse IP sur laquelle apt-proxy sera à l'écoute des requêtes, s'il y'a plusieurs adresses, séparez-les par un espace.}
\item[\hspace{1mm} port]{Port TCP pour l'écoute des requêtes}
\item[\hspace{1mm} min\_refresh\_delay]{les fichiers Packages et les autres fichiers de contrôle ne seront pas rafraîchis tant qu'ils n'auront pas dépassé cet âge (off pour désactiver)}
\item[\hspace{1mm} timeout]{Délai d'attente d'E/S maximale pour les transferts (défaut 30s)}
\item[\hspace{1mm} cache\_dir]{répertoire de cache (défaut : /var/cache/apt-proxy)}
\item[\hspace{1mm} cleanup\_freq]{période entre les tentatives de nettoyage : suppression des fichier > max\_age, analyse des répertoires de cache, mise à jour des tables internes, etc (off pour désactiver)}
\item[\hspace{1mm} max\_age]{age maximal des fichiers avant leur effacement du cache (off pour désactiver)}
\item[\hspace{1mm} max\_versions]{nombre maximum de version d'un paquet debian à conserver (par distribution) (off pour désactiver)}
\item[\hspace{1mm} passive\_ftp]{pour utiliser le ftp passif utiliser on, pour un actif : off (défaut : on)}
\item[\hspace{1mm} http\_proxy \texttt{[}username:passwrd@host:port\texttt{]}]{pour utiliser un proxy}
\item[\hspace{1mm} dynamic\_backends]{apt-proxy ajoutera les dorsaux HTTP dynamiquement, s'ils ne sont pas définit mettre à off pour restreindre les dorsaux disponibles à ceux listés dans le fichier de configuration (défaut : on)}
\item[\hspace{1mm} disable\_pipelining]{utiliser la canalisation HTTP pour récupérer plusieurs fichiers en une fois. laisser désactivé pour le moment.}
\item[\hspace{1mm} bandwidth\_limit = valeur]{limite la bande passante à valeur octets pas seconde lors du téléchargement sur un serveur. ne s'applique qu'à http et rsync (défaut : pas de limite)}
\end{description}
 
\vspace{1cm}{\huge [RESSOURCES] }
 
\
 
\begin{description} \normalsize
\item[\hspace{1mm} timeout]{Supplanter le temps global d’expiration}
\item[\hspace{1mm} backends = protocole ://serveur/répertoire \texttt{[}...\texttt{]}]{Une liste d’une ou plusieurs URL des serveurs hébergeant les paquets debian.}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{6mm} Protocole]{protocole à utiliser parmi http, ftp et rsync}
\item[\hspace{6mm} Serveur]{nom d’hôte du miroir à contacter}
\item[\hspace{6mm} Répertoire]{nom du répertoire où ajouter des demandes pour ce serveur}
\end{description}
 
\begin{description} \normalsize
\item[\hspace{1mm} passive\_ftp]{Supplanter la configuration globale de passive\_ftp}
\item[\hspace{1mm} bandwidth\_limit]{Spécifie une limite de bande passante pour les téléchargements utilisant cette ressource}
\item[\hspace{1mm} http\_proxy \texttt{[}nom d’utilisateur:mot de passe@\texttt{]}nom d’hôte:port]{}
\item[\hspace{1mm} min\_refresh\_delay]{Surcharge la variable globale « min\_refresh\_delay » pour cette dorsale.}
\end{description}
 
\vspace{1cm}{\huge [CLIENTS] }
 
\
 
\hspace{1mm} pour que les clients puissent se connecter au proxy, ils devrons mettre dans /etc/apt/sources.list: si vous avez la section debian comme ceci: \\
\hspace{1mm} \textbf{[debian]} \\
\hspace{1mm} \textbf{backends = http://ftp.fr.debian.org/debian} \\
\hspace{1mm} alors un client utilisera: \\
\hspace{1mm} \textbf{deb http://serveur:9999/debian/ lenny main} \\
 
\vspace{1cm}{\huge apt-proxy-import }
 
\
 
\hspace{1mm}  permet d'importer les paquets dans le cache d'apt-proxy
\vspace{5mm} \\
 
 
\begin{description} \normalsize
\item[\hspace{6mm} -v, --verbose]{mode verbeux}
\item[\hspace{6mm} -q, --quiet]{mode silencieux}
\item[\hspace{6mm} -r, --recursive]{mode récursif}
\item[\hspace{6mm} -c, --config-file=]{fichier de configuration d'apt-proxy}
\end{description}
 
\hspace{6mm} importer depuis le cache apt \\
\hspace{6mm} \textbf{apt-proxy-import /var/cache/apt/archives} \\
\hspace{6mm} importer depuis le cache apt-move \\
\hspace{6mm} \textbf{apt-proxy-import -r /var/cache/apt-move} \\
 
\hspace{1mm} exemple de fichier de configuration /etc/apt-proxy/apt-proxy-v2.conf
 
{\ttfamily
\texttt{[}DEFAULT\texttt{]}\\ address = 192.168.0.1\\ \hspace{2mm}\\ port = 9999\\ min\_refresh\_delay = 1h\\ complete\_clientless\_downloads = 1\\ debug = all:4 db:0\\ timeout = 15\\ cache\_dir = /var/cache/apt-proxy\\ cleanup\_freq = 1d\\ max\_age = 120d\\ max\_versions = 3\\ \texttt{[}debian\texttt{]}\\ timeout = 30\\ backends = http://ftp.fr.debian.org/debian\\ http://volatile.debian.org/debian-volatile\\ min\_refresh\_delay = 1d\\ \hspace{2mm}\\ \texttt{[}security\texttt{]}\\ ;;Debian security archive\\ backends = http://security.debian.org\\ http://security.debian.org/debian-security\\ min\_refresh\_delay = 1m\\ \hspace{2mm}\\ \texttt{[}ubuntu\texttt{]}\\ ;;Ubuntu archive\\ backends = http://archive.ubuntu.com/ubuntu\\ min\_refresh\_delay = 15m\\ \hspace{2mm}\\ \texttt{[}ubuntu-security\texttt{]}\\ ;;Ubuntu security updates\\ backends = http://security.ubuntu.com/ubuntu\\ min\_refresh\_delay = 1m\\
}
\vspace{8mm}
\end{flushleft}
\end{document}
