Project

General

Profile

Edit History

Installation instructions » History » Version 9

Ohad Levy, 03/25/2011 07:43 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
    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
    
    
    
<pre>





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





    10
    
    
    
</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
    
    
    





    25
    
    
    





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





    27
    
    
    





    28
    
    
    
<pre>





    29
    
    
    
# For stable packages





    30
    
    
    
deb http://deb.theforeman.org/ stable main





    31
    
    
    





    32
    
    
    
# For testing packages





    33
    
    
    
deb http://deb.theforeman.org/ testing main





    34
    
    
    
</pre>





    35
    
    
    





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





    37
    
    
    





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





    39
    
    
    
<pre># Debian Linux (as root)





    40
    
    
    
apt-key add foreman.asc





    41
    
    
    





    42
    
    
    
# Ubuntu Linux (as normal user)





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





    44
    
    
    
</pre>





    45
    
    
    





    46
    
    
    
or combine downloading and registering:





    47
    
    
    
<pre># Debian Linux (as root)





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





    49
    
    
    





    50
    
    
    
# Ubuntu Linux (as normal user)





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





    52
    
    
    
</pre>





    53
    
    
    





    54
    
    
    
The key fingerprint is





    55
    
    
    
<pre>





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





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





    58
    1
    Ohad Levy
    
</pre>





    59
    
    
    





    60
    
    
    
To install Smart-Proxy, run





    61
    7
    Jochen Schalanda
    





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





    63
    
    
    
apt-get update





    64
    
    
    
apt-get install foreman-proxy





    65
    7
    Jochen Schalanda
    





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





    67
    
    
    
sudo aptitude update





    68
    
    
    
sudo aptitude install foreman-proxy





    69
    7
    Jochen Schalanda
    
</pre>





    70
    
    
    





    71
    
    
    
h3. Debian Linux 5.0 (Lenny)





    72
    
    
    





    73
    
    
    
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
    
    
    





    75
    
    
    
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
    
    
    





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





    80
    6
    Ohad Levy
    
h2. Configuration file





    81
    3
    Jochen Schalanda
    





    82
    1
    Ohad Levy
    
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
    Ohad Levy
    





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





    86
    2
    Jochen Schalanda
    





    87
    1
    Ohad Levy
    





    88
    
    
    
h2. Start the daemon





    89
    
    
    





    90
    
    
    
<pre>





    91
    
    
    
bin/smart-proxy.rb





    92
    
    
    
</pre>





    93
    9
    Ohad Levy
    





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