Foreman » Smart Proxy

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