Project

General

Profile

Installation instructions » History » Revision 7

Revision 6 (Ohad Levy, 03/17/2011 02:43 PM) → Revision 7/17 (Jochen Schalanda, 03/20/2011 12:04 PM)

{{toc}} 

 h1. Installation instructions 

 h2. Source code 

 You can get the latest stable code from "GitHub":https://github.com/ohadlevy/smart-proxy ("via git":git://github.com/ohadlevy/smart-proxy.git). 
 <pre> 
 git clone git://github.com/ohadlevy/smart-proxy.git 
 </pre> 

 h2. RPM 

 You can get a the stable rpm "Here":http://yum.theforeman.org/stable/RPMS/ 

 h2. Debian/Ubuntu packages 

 We provide packages for Smart-Proxy for the following Debian-based Linux distributions: 

 * Debian Linux 5.0 (Lenny), see notes below 
 * Debian Linux 6.0 (Squeeze) 
 * Ubuntu Linux 10.04 (Lucid Lynx) 
 * Ubuntu Linux 10.10 (Maverick Meerkat) 


 Add one of the following package sources to your @/etc/apt/sources.list@: 

 <pre> 
 # For stable packages 
 deb http://deb.theforeman.org/ stable main 

 # For testing packages 
 deb http://deb.theforeman.org/ testing main 
 </pre> 

 The public key for "secure APT":http://wiki.debian.org/SecureApt can be downloaded "here":http://deb.theforeman.org/foreman.asc 

 You can add this key with 
 <pre> 
 sudo apt-key add foreman.asc 
 </pre> 

 or combine downloading and registering: 
 <pre># Debian Linux (as root) 
 wget -q http://deb.theforeman.org/foreman.asc -O- | apt-key add - 

 # Ubuntu Linux (as normal user) 
 wget -q http://deb.theforeman.org/foreman.asc -O- | sudo apt-key add - 
 </pre> 

 The key fingerprint is 
 <pre> 
 1DCB 15D1 2CA1 40EE F494    7E57 66CF 053F E775 FF07 
 Foreman Archive Signing Key <packages@theforeman.org> 
 </pre> 

 To install Smart-Proxy, run 

 <pre> 
 sudo apt-get update 

 # Depending on the database you want to use with Foreman, 
 # install one of these: 
 sudo apt-get install foreman-mysql 
 sudo apt-get install foreman-pgsql 
 sudo apt-get install foreman-sqlite3 
 </pre> 

 h3. Debian Linux 5.0 (Lenny) 

 Users of Debian Lenny will have to use "rake":http://packages.debian.org/lenny-backports/rake, "rack":http://packages.debian.org/lenny-backports/librack-ruby, and "Sinatra":http://packages.debian.org/lenny-backports/libsinatra-ruby from @lenny-backports@. 

 See http://backports.debian.org/Instructions/ for instructions on how to add @lenny-backports@ to your list of repositories and install a package from it. 

 Please note that you'll have to install @rack@ from @lenny-backports@ using @apt-get -t lenny-backports install librack-ruby@. @libsinatra-ruby@ will not be installable otherwise. 


 h2. Configuration file 

 Usually can be found at /etc/foreman-proxy/settings.yml or on the config/settings.yml subdirectory. 
 You can use the @settings.yml.example@ file inside the @config@ directory as a template for your own [[settings.yml]]. 

 If you don't plan to use one of the subsystems, please disable them in this configuration file. 


 h2. Start the daemon 

 until a service file will be created simply execute 
 <pre> 
 bin/smart-proxy.rb 
 </pre>