- Table of contents
- Installation instructions
git clone git://github.com/theforeman/smart-proxy.git
You can get a the stable rpm Here
We provide packages for Smart-Proxy for the following Debian-based Linux distributions:
- Debian Linux 6.0 (Squeeze)
- Ubuntu Linux 12.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
# 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
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 <firstname.lastname@example.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)¶
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
apt-get -t lenny-backports install libsinatra-ruby.
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¶
Or if you installed it via a package simply start the foreman-proxy service.
Add the smart-proxy to the Foreman's Smart Proxy page¶
Go to [FOREMAN_URL]/smart_proxies and klick New Proxy
Then you type in the Name for your Proxy and the URL of your Proxy, with the Port you use.
Name: Puppet-Proxy URL: http://puppet.your-domain.com:8443