Project

General

Profile

Installation instructions » History » Revision 15

Revision 14 (Greg Sutcliffe, 10/23/2012 10:33 AM) → Revision 15/17 (Greg Sutcliffe, 10/23/2012 10:33 AM)

{{toc}} 

 h1. Installation instructions 

 h2. Source code 

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

 h2. RPM 

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

 h2. Debian/Ubuntu packages 

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

 * Debian Linux 6.0 (Squeeze) 
 * Ubuntu Linux 11.04 (Precise Pangolin) 

 These packages may also work on (let us know if they do :P): 

 * Debian Linux 5.0 (Lenny), see notes below 
 * Ubuntu Linux 10.04 (Lucid Lynx) 
 * Ubuntu Linux 10.10 (Maverick Meerkat) 
 * Ubuntu Linux 11.04 (Natty Narwhal) 

 Add one (and only one) of the following package sources to your @/etc/apt/sources.list@ or create an appropriate file in @/etc/apt/sources.list.d/@: 

 <pre> 
 # Stable packages 

 # Debian Squeeze 
 deb http://deb.theforeman.org/ squeeze stable 
 # Ubuntu Precise 
 deb http://deb.theforeman.org/ precise stable 

 # Nightly builds. Beware: HERE BE DRAGONS 

 # Debian Squeeze 
 deb http://deb.theforeman.org/ squeeze nightly 
 

 # Ubuntu Precise 
 deb http://deb.theforeman.org/ precise nightly 
 </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 the key after its download with 
 <pre># Debian Linux (as root) 
 apt-key add foreman.asc 

 # Ubuntu Linux (as normal user) 
 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># Debian Linux (as root) 
 apt-get update 
 apt-get install foreman-proxy 

 # Ubuntu Linux (as normal user) 
 sudo aptitude update 
 sudo aptitude install foreman-proxy 
 </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 the packages from @lenny-backports@ using @apt-get -t lenny-backports install libsinatra-ruby@. 


 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 

 <pre> 
 bin/smart-proxy.rb 
 </pre> 

 Or if you installed it via a package simply start the foreman-proxy service.