Project

General

Profile

Edit History

Installation instructions » History » Version 12

Ohad Levy, 02/21/2012 07:48 AM

1 7 Jochen Schalanda 
{{toc}}
2 





    3
    1
    Ohad Levy
    
h1. Installation instructions





    4
    
    
    





    5
    2
    Jochen Schalanda
    
h2. Source code





    6
    1
    Ohad Levy
    





    7
    12
    Ohad Levy
    
You can get the latest stable code from "GitHub":https://github.com/theforeman/smart-proxy ("via git":git://github.com/theforeman/smart-proxy.git).





    8
    2
    Jochen Schalanda
    
<pre>





    9
    12
    Ohad Levy
    
git clone git://github.com/theforeman/smart-proxy.git





    10
    2
    Jochen Schalanda
    
</pre>





    11
    1
    Ohad Levy
    





    12
    4
    Ohad Levy
    
h2. RPM





    13
    
    
    





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





    15
    7
    Jochen Schalanda
    





    16
    
    
    
h2. Debian/Ubuntu packages





    17
    
    
    





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





    19
    
    
    





    20
    
    
    
* Debian Linux 5.0 (Lenny), see notes below





    21
    
    
    
* Debian Linux 6.0 (Squeeze)





    22
    
    
    
* Ubuntu Linux 10.04 (Lucid Lynx)





    23
    
    
    
* Ubuntu Linux 10.10 (Maverick Meerkat)





    24
    11
    Jochen Schalanda
    
* Ubuntu Linux 11.04 (Natty Narwhal)





    25
    7
    Jochen Schalanda
    





    26
    1
    Ohad Levy
    





    27
    11
    Jochen Schalanda
    
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/@:





    28
    1
    Ohad Levy
    





    29
    7
    Jochen Schalanda
    
<pre>





    30
    11
    Jochen Schalanda
    
# Stable packages





    31
    7
    Jochen Schalanda
    
deb http://deb.theforeman.org/ stable main





    32
    1
    Ohad Levy
    





    33
    11
    Jochen Schalanda
    
# Testing packages





    34
    1
    Ohad Levy
    
deb http://deb.theforeman.org/ testing main





    35
    11
    Jochen Schalanda
    





    36
    
    
    
# Nightly builds. Beware: HERE BE DRAGONS





    37
    
    
    
deb http://deb.theforeman.org/ nightly main





    38
    7
    Jochen Schalanda
    
</pre>





    39
    
    
    





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





    41
    
    
    





    42
    8
    Jochen Schalanda
    
You can add the key after its download with





    43
    
    
    
<pre># Debian Linux (as root)





    44
    
    
    
apt-key add foreman.asc





    45
    
    
    





    46
    
    
    
# Ubuntu Linux (as normal user)





    47
    7
    Jochen Schalanda
    
sudo apt-key add foreman.asc





    48
    
    
    
</pre>





    49
    
    
    





    50
    
    
    
or combine downloading and registering:





    51
    
    
    
<pre># Debian Linux (as root)





    52
    
    
    
wget -q http://deb.theforeman.org/foreman.asc -O- | apt-key add -





    53
    
    
    





    54
    
    
    
# Ubuntu Linux (as normal user)





    55
    
    
    
wget -q http://deb.theforeman.org/foreman.asc -O- | sudo apt-key add -





    56
    
    
    
</pre>





    57
    
    
    





    58
    
    
    
The key fingerprint is





    59
    
    
    
<pre>





    60
    
    
    
1DCB 15D1 2CA1 40EE F494  7E57 66CF 053F E775 FF07





    61
    
    
    
Foreman Archive Signing Key <packages@theforeman.org>





    62
    1
    Ohad Levy
    
</pre>





    63
    
    
    





    64
    
    
    
To install Smart-Proxy, run





    65
    7
    Jochen Schalanda
    





    66
    8
    Jochen Schalanda
    
<pre># Debian Linux (as root)





    67
    
    
    
apt-get update





    68
    
    
    
apt-get install foreman-proxy





    69
    7
    Jochen Schalanda
    





    70
    8
    Jochen Schalanda
    
# Ubuntu Linux (as normal user)





    71
    
    
    
sudo aptitude update





    72
    
    
    
sudo aptitude install foreman-proxy





    73
    7
    Jochen Schalanda
    
</pre>





    74
    
    
    





    75
    
    
    
h3. Debian Linux 5.0 (Lenny)





    76
    
    
    





    77
    1
    Ohad Levy
    
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@.





    78
    7
    Jochen Schalanda
    





    79
    
    
    
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.





    80
    
    
    





    81
    11
    Jochen Schalanda
    
Please note that you'll have to install the packages from @lenny-backports@ using @apt-get -t lenny-backports install libsinatra-ruby@.





    82
    2
    Jochen Schalanda
    





    83
    1
    Ohad Levy
    





    84
    6
    Ohad Levy
    
h2. Configuration file





    85
    3
    Jochen Schalanda
    





    86
    1
    Ohad Levy
    
Usually can be found at /etc/foreman-proxy/settings.yml or on the config/settings.yml subdirectory.





    87
    2
    Jochen Schalanda
    
You can use the @settings.yml.example@ file inside the @config@ directory as a template for your own [[settings.yml]].





    88
    1
    Ohad Levy
    





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





    90
    2
    Jochen Schalanda
    





    91
    1
    Ohad Levy
    





    92
    
    
    
h2. Start the daemon





    93
    
    
    





    94
    
    
    
<pre>





    95
    
    
    
bin/smart-proxy.rb





    96
    
    
    
</pre>





    97
    9
    Ohad Levy
    





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