Changes between Version 10 and Version 11 of InstallationGuide


Ignore:
Timestamp:
02/16/08 01:54:51 (16 years ago)
Author:
Gabor Hudiczius
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • InstallationGuide

    v10 v11  
    9292Edit your .rtorrent.rc (create on into your home directory, if it's a fresh install):
    9393 * set up how rtorrent should listen for connections (there are 3 ways to do this)
    94   * to use a unix socket, add the line "scgi_local = ~/torrent/.socket/rpc.socket" (this is the recommended way)
    95   * to listen for connections from localhost on port 12345 add the line "scgi_port = :12345"
    96   * to listen for connections from a specific interface on port 12345 add the line "scgi_port = 123.123.123.123:12345"
     94  * to use a unix socket, add the line ''scgi_local = ~/torrent/.socket/rpc.socket'' (this is the recommended way)
     95  * to listen for connections from localhost on port 12345 add the line ''scgi_port = :12345''
     96  * to listen for connections from a specific interface on port 12345 add the line ''scgi_port = 123.123.123.123:12345''
    9797 * if you have more than one user, set a different scgi_port/scgi_local value in each user's .rtorrent.rc file
    98  * set your download directory "directory = ~/torrent/
     98 * set your download directory ''directory = ~/torrent/''
    9999 * absolute paths are always welcome, however rTWi should handle relative paths, like above (if it does not, submit a [/rtwi/newticket ticket]
    100  * make sure, you have your session directory set and it exists, so rtorrent will remember your torrents after it's restarted "session = ~/torrent/.session" (be aware to set different session directories for the users)
     100 * make sure, you have your session directory set and it exists, so rtorrent will remember your torrents after it's restarted ''session = ~/torrent/.session'' (be aware to set different session directories for the users)
    101101 
    102102Now, you can start rTorrent. On the bottom, you should see something like this:
     
    111111Download the [/rtwi/downloads/rtwi-latest.tar.gz latest rTWi] from the [wiki:Download Download] section, extract it to some place where your webserver can see it.
    112112Edit your configuration file (includes/rtwi.conf):
    113  * set the "base" variable to your rTWi installation's URL (without index file, and with a trailing slash) "base = http://example.com/"
    114  * set the "user_conf" variable to the path of your user.conf file (it's always safe, to keep it outside your webroot)
    115  * if your want to rename your index.php and/or input.php you need to set the "index" and/or "input" variable(s)
     113 * set the ''base'' variable to your rTWi installation's URL (without index file, and with a trailing slash) ''base = "http://example.com/"''
     114 * set the ''user_conf'' variable to the path of your user.conf file (it's always safe, to keep it outside your webroot)
     115 * if your want to rename your index.php and/or input.php you need to set the ''index'' and/or ''input'' variable(s)
     116 * If a value in the conf file contains any non-alphanumeric characters it needs to be enclosed in double-quotes (")
    116117
    117118==== Adding users ==== #addingusers
    118119
    119120Edit your users.conf file:
    120  * create a new section for every user "[user1]" (this will be your login name - this must be the *nix username)
     121 * create a new section for every user ''[user1]'' (this will be your login name - this must be the *nix username)
    121122 * set the address rTWi can connect to the user's rTorrent (there are 3 ways to do it)
    122   * if you're using a unix socket enter "address = !unix://~/torrent/.socket/rpc.socket"
    123   * if you're using scgi_port enter "address = 123.123.123.123:12345" ("address = :12345" works for localhost)
    124   * if you're using an SCGI gateway enter "address = !http://example.com/RPC2" (also works when Basic HTTP Authentication is on for the URL)
    125  * enter "pass = 1234567890abcdef1234567890abcdef12345678" where the right side is the sha1 hash of the choosen password for the user (you can generate the sha1 hash [http://www.johnmaguire.us/tools/hashcalc/index.php online])
    126  * If a value in the conf file contains any non-alphanumeric characters it needs to be enclosed in double-quotes (")
     123  * if you're using a unix socket enter ''address = "!unix://~/torrent/.socket/rpc.socket"''
     124  * if you're using scgi_port enter ''address = "123.123.123.123:12345"'' (''address = ":12345"'' works for localhost)
     125  * if you're using an SCGI gateway enter ''address = "!http://example.com/RPC2"'' (also works when Basic HTTP Authentication is on for the URL)
     126 * enter ''pass = "1234567890abcdef1234567890abcdef12345678"'' where the right side is the sha1 hash of the choosen password for the user (you can generate the sha1 hash [http://www.johnmaguire.us/tools/hashcalc/index.php online])
     127 * if a value in the conf file contains any non-alphanumeric characters it needs to be enclosed in double-quotes (")
    127128 * 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:
    128129
    129130{{{
    130131[user1]
    131 address =  "address = unix://~/torrent/.socket/rpc.socket"
     132address =  "unix://~/torrent/.socket/rpc.socket"
    132133pass =     "1234567890abcdef1234567890abcdef12345678"
    133134