Changes between Version 1 and Version 2 of InstallationGuide


Ignore:
Timestamp:
09/13/07 20:14:57 (17 years ago)
Author:
Gabor Hudiczius
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • InstallationGuide

    v1 v2  
    77== Prerequisites == #prerequisites
    88
    9  * rtorrent 0.7.8
     9 * rTorrent 0.7.8
    1010  * compiled with "--with-xmlrpc-c"
    1111  * sigc++-2.0
    12  * xmlrpc >= 1.07
     12 * XMLRPC-C >= 1.07
    1313 * some webserver
    1414  * php5, with the following extensions:
    … …  
    3434You'll need the following packages to install xmlrpc-c, libtorrent and rtorrent
    3535 * make
    36  * libcurl-openssl-dev
    3736 * pkg-config
    3837 * sigc++-2.0-dev
    3938 * libncurses-dev
     39 * libcurl-openssl-dev
    4040
    4141==== Installing XMLRPC-C ==== #xmlrpc
    4242
    43 To install xmlrpc, get the source from [http://sourceforge.net/project/showfiles.php?group_id=16847 The xmlrpc-c page]
     43To install xmlrpc, get the source from [http://sourceforge.net/project/showfiles.php?group_id=16847 The XMLRPC-C page]
    4444In my case, i could only compile the 1.11.00 version (due to a known bug, you may try to configure with --disable-cplusplus, if the compiling stops with some syntax error)
    4545Of course, you can try any version, over 1.07 (or any version over 1.00, but you'll get incorrect data for values bigger than 2^31-1^, since it does not support 64bit integers)
    4646
    4747Follow the next steps:
    48 `cd /usr/src
     48{{{
     49cd /usr/src
    4950wget http://dfn.dl.sourceforge.net/sourceforge/xmlrpc-c/xmlrpc-c-1.11.00.tgz
    5051tar xvf xmlrpc-c-1.11.00.tgz
    … …  
    5253./configure --disable-cplusplus
    5354make
    54 make install`
     55make install
     56}}}
    5557
    5658==== Installing libTorrent ==== #libtorrent
    5759
    5860To install libtorrent, follow the next steps:
    59 `mkdir /usr/src/libtorrent
     61{{{
     62mkdir /usr/src/libtorrent
    6063wget http://libtorrent.rakshasa.no/downloads/libtorrent-0.11.8.tar.gz
    6164tar xvf libtorrent-0.11.8.tar.gz
    … …  
    6366./configure
    6467make
    65 make install`
     68make install
     69}}}
    6670
    6771==== Installing rTorrent ==== #rtorrent
    6872
    6973To install rtorrent, follow the next steps:
    70 `mkdir /usr/src/rtorrent
     74{{{
     75mkdir /usr/src/rtorrent
    7176wget http://libtorrent.rakshasa.no/downloads/rtorrent-0.7.8.tar.gz
    7277tar xvf rtorrent-0.7.8.tar.gz
    … …  
    7479./configure --with-xmlrpc-c
    7580make
    76 make install`
     81make install
     82}}}
    7783
    78 ==== Setting up rTorrent ====
     84==== Setting up rTorrent ==== #rtorrentsetup
    7985
    8086If you don't have a .rtorrent.rc file, create one into your home directory.
    81 You can find an example .rtorrent.rc file [http://libtorrent.rakshasa.no/browser/trunk/rtorrent/doc/rtorrent.rc?rev=latest here].
     87You can find an example [http://libtorrent.rakshasa.no/browser/trunk/rtorrent/doc/rtorrent.rc?rev=latest .rtorrent.rc] file.
    8288Open .rtorrent.rc, and edit it (for each user):
    83  * add this line to your .rtorrent.rc `scgi_port = 127.0.0.1:12345` where 12345 can be replaced by your choice
     89 * add this line to your .rtorrent.rc "scgi_port = 127.0.0.1:12345" where 12345 can be replaced by your choice
    8490 * and restart rtorrent
    8591 * if you have more than one user, set a different port for each user's .rtorrent.rc file (be aware, to set different session directories for the users)
    … …  
    8793 * make sure, you have your session directory set and it exists, so rtorrent will remember your torrents after it's restarted
    8894 
    89 Now, you can start rtorrent, and on the bottom, you should see something like this:
    90 `(20:55:52) XMLRPC initialized with 356 functions.`
     95Now, you can start rtorrent. On the bottom, you should see something like this:
     96{{{
     97(20:55:52) XMLRPC initialized with 356 functions.
     98}}}
    9199
    92100=== rTWi side === #rtwiside
    … …  
    106114 * find row 44, and change it:
    107115 * replace "userX" with the actual linux username
    108  * replace "1234567890abcdef1234567890abcdef12345678" with the sha1 hash of the choosen password for the webui (you can generate the sha1 hash here => http://www.johnmaguire.us/tools/hashcalc/index.php)
     116 * replace "1234567890abcdef1234567890abcdef12345678" with the sha1 hash of the choosen password for the webui (you can generate the sha1 hash [http://www.johnmaguire.us/tools/hashcalc/index.php online])
    109117 * replace "12345", with the port, you've set in the user's .rtorrent.rc file
    110118 * keep the quotes in the last three steps
    111  * if you have more than one user, you have to repeat these steps, for each one of them, so you'll get something like this:
    112 `       $users = array(
    113                 "user1"         => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port"  => "12345" ),
    114                 "user2"         => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port"  => "12346" ),
    115                 "user3"         => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port"  => "12347" ),
    116         );`
     119 * if you have more than one user, you have to repeat these steps for each one of them, so you'll get something like this:
     120{{{
     121$users = array(
     122        "user1"         => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port"  => "12345" ),
     123        "user2"         => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port"  => "12346" ),
     124        "user3"         => array( "pass" => "1234567890abcdef1234567890abcdef12345678", "port"  => "12347" ),
     125);
     126}}}
    117127
    118 Important
     128'''Important! '''
    119129 * all users, using this webui will need an "!rtwi_files" directory into their download directory (set by "directory = some/path" in the .rtorrent.rc) with 0777 rights
    120130 * the download directory should be inside your home directory (this might change later, as soon as i find out something secure)
    … …  
    123133== Troubleshooting == #troubleshooting
    124134
    125 >XMLRPC-C 1.11 compilation stops with some syntax error
    126 >>Configure with --disable-cplusplus
     135'''XMLRPC-C 1.11 compilation stops with some syntax error'''
     136 * Configure with --disable-cplusplus
    127137
    128 >rTorrent compilation stops with an errer, which says, i have no libtorrent installed (No package 'libtorrent' found)
    129 >>Find your libtorrent.pc file (try /usr/local/lib/pkgconfig), and set the PKG_CONFIG_PATH environmental variable to it's path (export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig)
     138'''rTorrent compilation stops with an errer, which says, i have no libtorrent installed (No package 'libtorrent' found)'''
     139 * Find your libtorrent.pc file (try /usr/local/lib/pkgconfig), and set the PKG_CONFIG_PATH environmental variable to it's path (export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig)
    130140
    131 >rTorrent compilation stops with an error, which says, my libtorrent's version is an empty string (Requested 'libtorrent >= 0.11.8' but version of libtorrent is)
    132 >>Upgrade you automake (you need 1.5+)
     141'''rTorrent compilation stops with an error, which says, my libTorrent's version is an empty string (Requested 'libtorrent >= 0.11.8' but version of libtorrent is )'''
     142 * Upgrade you automake (you need 1.5+)
    133143
    134 >I can see the php code in the browser
    135 >>Your php settings does not allows you to to have a php file named .html - change these settings, or rename the index.html to index.php, and set the $default_ext variable to "php" in rtwi's /includes/config.inc.php
    136 >>Php modul is not loaded by the webserver, take a look at your webserver's manual, to find out, how to enable it
     144'''I can see the php code in the browser'''
     145 * Your php settings does not allows you to to have a php file named .html - change these settings, or rename the index.html to index.php, and set the $default_ext variable to "php" in rtwi's /includes/config.inc.php
     146 * Php modul is not loaded by the webserver, take a look at your webserver's manual, to find out, how to enable it
    137147
    138 >I get some php errors about xsl...
    139 >>Install (or if it's installed, than enable) the xsl php extension
     148'''I get some php errors about XSL, or XSLT...'''
     149 * Install (or if it's installed, than enable) the xsl php extension
    140150
    141 >I get some php errors about xmlrpc...
    142 >>Install (or if it's installed, than enable) the xmlrpc php extension
     151'''I get some php errors about XMLRPC-C...'''
     152 * Install (or if it's installed, than enable) the xmlrpc php extension
    143153
    144 >I've set my username and my password in the config.inc.php, but i cannot log in
    145 >>Did you use the password? you need to use the password's sha1 hash (you can generate one here =>you can generate the sha1 hash here => http://www.johnmaguire.us/tools/hashcalc/index.php)
    146 >>Enable cookies (or at least session cookies)
     154'''I've set my username and my password in the config.inc.php, but i cannot log in'''
     155 * Did you use the password? You should use the password's sha1 hash (you can generate the sha1 hash [http://www.johnmaguire.us/tools/hashcalc/index.php online])
     156 * Enable cookies (or at least session cookies)
    147157
    148 >I get the "No connection" message in rtwi
    149 >>Set the same port in your .rtorrent.rc file, at the scgi_port=, and in the rtwi's /includes/config.inc.php at your user's line
    150 >>Check, if rtottent is listening on the port, you've set (netstat -na | grep 12345)
    151 >>>If it is
    152 >>>>Check your firewall
    153 >>>>Recheck the port set in rtwi's incudes/config.inc.php
    154 >>>Of it is not
    155 >>>>Recheck your .rtorrent.rc - it should have a line like this: scgi_port = 127.0.0.1:12345
    156 >>>>Try to set the scgi port in runtime (ctrl+x, then entre "scgi_port = 127.0.0.1:12345")
    157 >>>>>If rtorrent stops with an error, that says xmlrpc is not supported, configure xmlrpc-c with --with-xmlrpc-c, and recompile
    158 
    159 >The add torrent menu does not work (at all - it shows me an empty page)
    160 >>Your download directory should be in your home directory
     158'''I get the "No connection" message in rTWi'''
     159 * Set the same port in your .rtorrent.rc file, at the scgi_port=, and in the rTWi's /includes/config.inc.php at your user's line
     160 * Check, if rTottent is listening on the port, you've set (netstat -na | grep 12345)
     161  * '''It is'''
     162   * Check your firewall
     163   * Recheck the port set in rtwi's incudes/config.inc.php
     164  * '''It is not'''
     165   * Recheck your .rtorrent.rc - it should have a line like this: scgi_port = 127.0.0.1:12345
     166   * Try to set the scgi port in runtime (Ctrl+X, then entre "scgi_port = 127.0.0.1:12345")
     167   * If rtorrent stops with an error, that says xmlrpc is not supported, configure xmlrpc-c with --with-xmlrpc-c, and recompile