• Table of contents
• Installation instructions
  • Source code
  • RPM
  • Debian/Ubuntu packages
    • Debian Linux 5.0 (Lenny)
  • Configuration file
  • Start the daemon

Installation instructions¶

Source code¶

You can get the latest stable code from GitHub (via git).

git clone git://github.com/ohadlevy/smart-proxy.git

RPM¶

You can get a the stable rpm Here

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)
• 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/:

# Stable packages
deb http://deb.theforeman.org/ stable main

# Testing packages
deb http://deb.theforeman.org/ testing main

# Nightly builds. Beware: HERE BE DRAGONS
deb http://deb.theforeman.org/ nightly main

The public key for secure APT can be downloaded here

You can add the key after its download with

# Debian Linux (as root)
apt-key add foreman.asc

# Ubuntu Linux (as normal user)
sudo apt-key add foreman.asc

or combine downloading and registering:

# 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 -

The key fingerprint is

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

To install Smart-Proxy, run

# 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

Debian Linux 5.0 (Lenny)¶

Users of Debian Lenny will have to use rake, rack, and Sinatra 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.

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.

Start the daemon¶

bin/smart-proxy.rb

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