Edit History

Installation instructions

Version 9 (Ohad Levy, 03/25/2011 07:43 am)

1 7 Jochen Schalanda 
{{toc}}
2 7 Jochen Schalanda 






    3
    1
    
    
h1. Installation instructions






    4
    1
    
    






    5
    2
    Jochen Schalanda
    
h2. Source code






    6
    1
    
    






    7
    2
    Jochen Schalanda
    
You can get the latest stable code from "GitHub":https://github.com/ohadlevy/smart-proxy ("via git":git://github.com/ohadlevy/smart-proxy.git).






    8
    2
    Jochen Schalanda
    
<pre>






    9
    2
    Jochen Schalanda
    
git clone git://github.com/ohadlevy/smart-proxy.git






    10
    2
    Jochen Schalanda
    
</pre>






    11
    1
    
    






    12
    4
    Ohad Levy
    
h2. RPM






    13
    4
    Ohad Levy
    






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






    15
    7
    Jochen Schalanda
    






    16
    7
    Jochen Schalanda
    
h2. Debian/Ubuntu packages






    17
    7
    Jochen Schalanda
    






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






    19
    7
    Jochen Schalanda
    






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






    21
    7
    Jochen Schalanda
    
* Debian Linux 6.0 (Squeeze)






    22
    7
    Jochen Schalanda
    
* Ubuntu Linux 10.04 (Lucid Lynx)






    23
    7
    Jochen Schalanda
    
* Ubuntu Linux 10.10 (Maverick Meerkat)






    24
    7
    Jochen Schalanda
    






    25
    7
    Jochen Schalanda
    






    26
    7
    Jochen Schalanda
    
Add one of the following package sources to your @/etc/apt/sources.list@:






    27
    7
    Jochen Schalanda
    






    28
    7
    Jochen Schalanda
    
<pre>






    29
    7
    Jochen Schalanda
    
# For stable packages






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






    31
    7
    Jochen Schalanda
    






    32
    7
    Jochen Schalanda
    
# For testing packages






    33
    7
    Jochen Schalanda
    
deb http://deb.theforeman.org/ testing main






    34
    7
    Jochen Schalanda
    
</pre>






    35
    7
    Jochen Schalanda
    






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






    37
    7
    Jochen Schalanda
    






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






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






    40
    8
    Jochen Schalanda
    
apt-key add foreman.asc






    41
    8
    Jochen Schalanda
    






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






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






    44
    7
    Jochen Schalanda
    
</pre>






    45
    7
    Jochen Schalanda
    






    46
    7
    Jochen Schalanda
    
or combine downloading and registering:






    47
    7
    Jochen Schalanda
    
<pre># Debian Linux (as root)






    48
    7
    Jochen Schalanda
    
wget -q http://deb.theforeman.org/foreman.asc -O- | apt-key add -






    49
    7
    Jochen Schalanda
    






    50
    7
    Jochen Schalanda
    
# Ubuntu Linux (as normal user)






    51
    7
    Jochen Schalanda
    
wget -q http://deb.theforeman.org/foreman.asc -O- | sudo apt-key add -






    52
    7
    Jochen Schalanda
    
</pre>






    53
    7
    Jochen Schalanda
    






    54
    7
    Jochen Schalanda
    
The key fingerprint is






    55
    7
    Jochen Schalanda
    
<pre>






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






    57
    7
    Jochen Schalanda
    
Foreman Archive Signing Key <packages@theforeman.org>






    58
    1
    
    
</pre>






    59
    1
    
    






    60
    1
    
    
To install Smart-Proxy, run






    61
    7
    Jochen Schalanda
    






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






    63
    8
    Jochen Schalanda
    
apt-get update






    64
    8
    Jochen Schalanda
    
apt-get install foreman-proxy






    65
    7
    Jochen Schalanda
    






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






    67
    8
    Jochen Schalanda
    
sudo aptitude update






    68
    8
    Jochen Schalanda
    
sudo aptitude install foreman-proxy






    69
    7
    Jochen Schalanda
    
</pre>






    70
    7
    Jochen Schalanda
    






    71
    7
    Jochen Schalanda
    
h3. Debian Linux 5.0 (Lenny)






    72
    7
    Jochen Schalanda
    






    73
    7
    Jochen Schalanda
    
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@.






    74
    7
    Jochen Schalanda
    






    75
    7
    Jochen Schalanda
    
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.






    76
    7
    Jochen Schalanda
    






    77
    1
    
    
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.






    78
    2
    Jochen Schalanda
    






    79
    1
    
    






    80
    6
    Ohad Levy
    
h2. Configuration file






    81
    3
    Jochen Schalanda
    






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






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






    84
    1
    
    






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






    86
    2
    Jochen Schalanda
    






    87
    1
    
    






    88
    1
    
    
h2. Start the daemon






    89
    1
    
    






    90
    1
    
    
<pre>






    91
    1
    
    
bin/smart-proxy.rb






    92
    1
    
    
</pre>






    93
    9
    Ohad Levy
    






    94
    9
    Ohad Levy
    
If you installed it via a package simply start the foreman-proxy service.