	current
Line 1:	Line 1:
	+	====== Overview ======
	+	One of the best advantages to having a dedicated torrent server is automating the process of downloading torrents. At the same time, having a Web UI to the torrent client makes managing active torrents and uploading new torrents a lot easier.
	+
	+	This guide will provide instructions on how to setup wTorrent and FlexGet as your preferred WebUI/RSS downloader for rTorrent. There are other WebUI's available for rTorrent - the author of this guide prefers wTorrent because:
	+
	+	- wTorrent has it's own authentication mechanism which allows for multiple users to share the rTorrent client.
	+	- wTorrent will eventually have cookie support, allowing for direct downloads from private trackers.
	+
	+	Please read the [[howto:installing_rtorrent_addons_-_wtorrent_and_flexget#TODO\|TODO]] to see what still needs fixing.
	+
	+	===== Assumptions =====
	+
	+	* rTorrent installed and configured based on [[howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps\|the guide]] provided in this Wiki
	+	* Apache2 and PHP5 installed

howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps

1276677093		current
Line 1:		Line 1:
	====== Overview ======		====== Overview ======
-
	The aim of this guide is to walk through the process of getting rTorrent and hellanzb working on a VPS running CentOS5 (64-bit version).		The aim of this guide is to walk through the process of getting rTorrent and hellanzb working on a VPS running CentOS5 (64-bit version).
-
-

	In the interests of the author's sanity, It is assumed that the reader has some familiarity with Unix command-line operations, and that the reader knows what the various permissions octals mean in Unix.		In the interests of the author's sanity, It is assumed that the reader has some familiarity with Unix command-line operations, and that the reader knows what the various permissions octals mean in Unix.
-
-

	Please read the [[howto:installing_rTorrent_and_hellanzb_on_centos5_64-bit_vps#TODO\|TODO]] to see what still needs fixing.		Please read the [[howto:installing_rTorrent_and_hellanzb_on_centos5_64-bit_vps#TODO\|TODO]] to see what still needs fixing.
-
-

	===== Assumptions =====		===== Assumptions =====
-
-

	* Operating System is CentOS5 64-bit, kernel 2.6.1x series (( I'm guessing the guide will still work for higher kernel versions in the 2.6 series, but experience has taught me to hedge my bets ))		* Operating System is CentOS5 64-bit, kernel 2.6.1x series (( I'm guessing the guide will still work for higher kernel versions in the 2.6 series, but experience has taught me to hedge my bets ))
-
	* CentOS5 is running on a OpenVZ VPS.		* CentOS5 is running on a OpenVZ VPS.
-
	* gcc, make, automake and autoconf installed		* gcc, make, automake and autoconf installed
-
	* A good text editor (nano is recommended (( nano is not installed by default )) but you can always use vi if you are hardcore)		* A good text editor (nano is recommended (( nano is not installed by default )) but you can always use vi if you are hardcore)
-
	* Working FTP Server ([[http://www.proftpd.org/\|ProFTPD]] is highly recommended)		* Working FTP Server ([[http://www.proftpd.org/\|ProFTPD]] is highly recommended)
-
	* Installing software while logged in as root does not strike you as heresy.		* Installing software while logged in as root does not strike you as heresy.
-
	* Patience - lots of it.		* Patience - lots of it.
-
-

	===== VPS Specifications/Providers =====		===== VPS Specifications/Providers =====
-
-

	The best feature of rTorrent and hellanzb is their memory footprint. For a single-user (or 1-3 user) instance, the following configuration is the (modest) minimum requirements:		The best feature of rTorrent and hellanzb is their memory footprint. For a single-user (or 1-3 user) instance, the following configuration is the (modest) minimum requirements:
-
-

	* CPU - 100 Mhz		* CPU - 100 Mhz
-
	* Memory - 256MB Guaranteed, 384MB Burst		* Memory - 256MB Guaranteed, 384MB Burst
-
	* Disk Space - 40GB		* Disk Space - 40GB
-
	* Bandwidth Allowance - 300GB (Monthly)		* Bandwidth Allowance - 300GB (Monthly)
-
	* Downlink Speed - 10Mb/sec		* Downlink Speed - 10Mb/sec
-
	* Uplink Speed - 500Kb/sec		* Uplink Speed - 500Kb/sec
-
-

	What does bumping some of the specs higher get you?		What does bumping some of the specs higher get you?
-
-

	* Faster CPU means less compiling time		* Faster CPU means less compiling time
-
	* More memory allows for more torrents/usenet files to run in parallel		* More memory allows for more torrents/usenet files to run in parallel
-
	* Faster Uplink speeds gets you better FTP download speeds even when seeding torrents.		* Faster Uplink speeds gets you better FTP download speeds even when seeding torrents.
-
-

	==== Choosing a VPS Provider ====		==== Choosing a VPS Provider ====
-
-

	It is simply not possible to come up with a definitive "list" of the best VPS providers - there are too many factors at work here. I will just offer a few suggestions:		It is simply not possible to come up with a definitive "list" of the best VPS providers - there are too many factors at work here. I will just offer a few suggestions:
-
-

	* The minimum configuration listed above should not cost more than 9-10 USD a month.		* The minimum configuration listed above should not cost more than 9-10 USD a month.
-
	* [[http://www.webhostingtalk.com/forumdisplay.php?f=104\|The Web Hosting Talk forums]] are the best place for checking out deals on VPS packages. If you see a package that almost fits your needs, send a mail to the VPS provider asking about special offers. A lot of the smaller VPS providers are pretty flexible.		* [[http://www.webhostingtalk.com/forumdisplay.php?f=104\|The Web Hosting Talk forums]] are the best place for checking out deals on VPS packages. If you see a package that almost fits your needs, send a mail to the VPS provider asking about special offers. A lot of the smaller VPS providers are pretty flexible.
-
	* Important: Check the VPS provider's Terms & Conditions of Service. Some VPS providers have strict clauses on the storage and/or distribution of copyrighted material. Other providers block some pornography and nothing else. It pays to go through the ToS, even if they tend to be filled with mind-numbing legalese.		* Important: Check the VPS provider's Terms & Conditions of Service. Some VPS providers have strict clauses on the storage and/or distribution of copyrighted material. Other providers block some pornography and nothing else. It pays to go through the ToS, even if they tend to be filled with mind-numbing legalese.
-
-

	===== Installing rTorrent =====		===== Installing rTorrent =====
-
	==== The Easy Way ====		==== The Easy Way ====
-
	You need rpmforge in your list of repositories for this method to work. [[http://wiki.centos.org/AdditionalResources/Repositories/RPMForge\|This article]] provides instructions if you do not have rpmforge in your repository list already.		You need rpmforge in your list of repositories for this method to work. [[http://wiki.centos.org/AdditionalResources/Repositories/RPMForge\|This article]] provides instructions if you do not have rpmforge in your repository list already.
-
-

	Once you have rpmforge in your repository list, all that's required is to issue the command <code bash>yum install rtorrent</code> and all dependencies are automatically handled.		Once you have rpmforge in your repository list, all that's required is to issue the command <code bash>yum install rtorrent</code> and all dependencies are automatically handled.
-
-

	Obviously, there's a catch to this. The problem is that the version available on rpmforge has been compiled without XMLRPC support, which means all those nice UIs such as [[http://code.google.com/p/rtgui/\|rtgui]], [[http://www.wtorrent-project.org/trac/\|wTorrent]] etc. won't work. If you are not interested in Web-based torrent management, you can skip ahead to the section on [[howto:installing_rTorrent_and_hellanzb_on_centos5_64-bit_vps#running_rtorrent_as_a_service\|running rtorrent in the background]]		Obviously, there's a catch to this. The problem is that the version available on rpmforge has been compiled without XMLRPC support, which means all those nice UIs such as [[http://code.google.com/p/rtgui/\|rtgui]], [[http://www.wtorrent-project.org/trac/\|wTorrent]] etc. won't work. If you are not interested in Web-based torrent management, you can skip ahead to the section on [[howto:installing_rTorrent_and_hellanzb_on_centos5_64-bit_vps#running_rtorrent_as_a_service\|running rtorrent in the background]]
-
-

	If you are keen on getting a Web UI for rTorrent, you'll need to read on.		If you are keen on getting a Web UI for rTorrent, you'll need to read on.
-
-

	==== The Old-fashioned way ====		==== The Old-fashioned way ====
-
	rTorrent's dependency tree is fairly long and very specific on the minimum versions required. The core dependency list is as follows:		rTorrent's dependency tree is fairly long and very specific on the minimum versions required. The core dependency list is as follows:
-
-

	* pkg-config		* pkg-config
-
	* libsigc++		* libsigc++
-
	* curl 7.19.2 or higher		* curl 7.19.2 or higher
-
	* xmlrpc-c		* xmlrpc-c
-
-
-


	Reminder: The rest of this section assumes you will be executing the commands as root		Reminder: The rest of this section assumes you will be executing the commands as root
-
-

	=== pkg-config ===		=== pkg-config ===
-
-

	The current version of pkg-config (at the time of writing this guide) is 0.23. You can check the version information on the [[http://pkg-config.freedesktop.org/wiki/\|pkg-config website]] while the actual source tarballs are in the [[http://pkgconfig.freedesktop.org/releases/\|release directory]].		The current version of pkg-config (at the time of writing this guide) is 0.23. You can check the version information on the [[http://pkg-config.freedesktop.org/wiki/\|pkg-config website]] while the actual source tarballs are in the [[http://pkgconfig.freedesktop.org/releases/\|release directory]].
-
-

	The following set of commands will install pkg-config:		The following set of commands will install pkg-config:
-
	<code bash>		<code bash>
-
	wget http://pkgconfig.freedesktop.org/releases/pkg-config-0.23.tar.gz		wget http://pkgconfig.freedesktop.org/releases/pkg-config-0.23.tar.gz
-
	tar zxf pkg-config-0.23.tar.gz		tar zxf pkg-config-0.23.tar.gz
-
	cd pkg-config-0.23		cd pkg-config-0.23
-
	./configure		./configure
-
	make		make
-
	make install		make install
-
	</code>		</code>
-
-

	=== libsigc++ ===		=== libsigc++ ===
-
-

	Make sure you have rpmforge in your list of repositories. See [[howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps#the_easy_way\|this section]] for instructions if you are not sure how to proceed. If you have rpmforge already installed, you need to execute the following command:		Make sure you have rpmforge in your list of repositories. See [[howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps#the_easy_way\|this section]] for instructions if you are not sure how to proceed. If you have rpmforge already installed, you need to execute the following command:
-
	<code bash>yum install libsigc++20 libsigc++20-devel</code>		<code bash>yum install libsigc++20 libsigc++20-devel</code>
-
-

	Now to check if everything went ok with the libsigc++ install. Open the file ld.so.conf<code>nano -w /etc/ld.so.conf</code> and add the following lines:		Now to check if everything went ok with the libsigc++ install. Open the file ld.so.conf<code>nano -w /etc/ld.so.conf</code> and add the following lines:
-
	<code>		<code>
-
	/usr/local/lib/		/usr/local/lib/
-
	/usr/include/		/usr/include/
-
	/usr/lib64/		/usr/lib64/
-
	/usr/lib		/usr/lib
-
	/usr/local/include/		/usr/local/include/
-
	</code>		</code>
-
-

	Save and exit. Now run the following commands:		Save and exit. Now run the following commands:
-
	<code bash>		<code bash>
-
	/sbin/ldconfig		/sbin/ldconfig
-
	pkg-config --cflags --libs sigc++-2.0		pkg-config --cflags --libs sigc++-2.0
-
	</code>		</code>
-
-

	If everything went well, you should see something similar to the output below:		If everything went well, you should see something similar to the output below:
-
	<xterm>[root@centos]# pkg-config --cflags --libs sigc++-2.0		<xterm>[root@centos]# pkg-config --cflags --libs sigc++-2.0
-
	-I/usr/local/include/sigc++-2.0 -I/usr/local/lib/sigc++-2.0/include -L/usr/local/lib -lsigc-2.0		-I/usr/local/include/sigc++-2.0 -I/usr/local/lib/sigc++-2.0/include -L/usr/local/lib -lsigc-2.0
-
	</xterm>		</xterm>
-
-

	=== curl ===		=== curl ===
-
-

	Older versions of curl have bugs with some advanced features that libtorrent uses (( http://libtorrent.rakshasa.no/wiki/LibTorrentKnownIssues#Inabilitytoconnecttotrackersorannouncestimeout )). Hence, rtorrent requires curl 7.19.2 or higher to be installed. However, CentOS 5 only ships with 7.15.5 and there are no updates available on the standard repositories.		Older versions of curl have bugs with some advanced features that libtorrent uses (( http://libtorrent.rakshasa.no/wiki/LibTorrentKnownIssues#Inabilitytoconnecttotrackersorannouncestimeout )). Hence, rtorrent requires curl 7.19.2 or higher to be installed. However, CentOS 5 only ships with 7.15.5 and there are no updates available on the standard repositories.
-
-

	The current version of curl (at the time of writing this guide) is 7.19.3. You can check the version information on the [[http://curl.haxx.se/\|curl website]] while the actual source tarballs are available on the [[http://curl.haxx.se/download.html\|download page]].		The current version of curl (at the time of writing this guide) is 7.19.3. You can check the version information on the [[http://curl.haxx.se/\|curl website]] while the actual source tarballs are available on the [[http://curl.haxx.se/download.html\|download page]].
-
-

	Installing curl is fairly standard:		Installing curl is fairly standard:
-
	<code bash>		<code bash>
-
	wget http://curl.haxx.se/download/curl-7.19.3.tar.gz		wget http://curl.haxx.se/download/curl-7.19.3.tar.gz
-
	tar zxf curl-7.19.3.tar.gz		tar zxf curl-7.19.3.tar.gz
-
	cd curl-7.19.3		cd curl-7.19.3
-
	./configure		./configure
-
	make		make
-
	make install		make install
-
	</code>		</code>
-
-

	The curl make process can take a very long time, so this might be a good time to go get yourself a sandwich. Once the install process finishes, we need to check if the libraries are visible to pkg-config:		The curl make process can take a very long time, so this might be a good time to go get yourself a sandwich. Once the install process finishes, we need to check if the libraries are visible to pkg-config:
-
	<code bash>		<code bash>
-
	/sbin/ldconfig		/sbin/ldconfig
-
	pkg-config --cflags --libs libcurl		pkg-config --cflags --libs libcurl
-
	</code>		</code>
-
-

	You should see the following output after the pkg-config command listed above:		You should see the following output after the pkg-config command listed above:
-
	<xterm>[root@centos]# pkg-config --cflags --libs libcurl		<xterm>[root@centos]# pkg-config --cflags --libs libcurl
-
	-I/usr/local/include -L/usr/local/lib -lcurl		-I/usr/local/include -L/usr/local/lib -lcurl
-
	</xterm>		</xterm>
-
-

	Now we move to the most important dependency for rtorrent, XMLRPC-C.		Now we move to the most important dependency for rtorrent, XMLRPC-C.
-
-

	=== XMLRPC-C ===		=== XMLRPC-C ===
-
-

	XMLRPC-C comes in 3 flavours: Super-Stable, Stable and Advanced. While the Super-Stable version is available as a regular tarball, it seems like getting that version to work reliably is a hit-and-miss affair (( http://libtorrent.rakshasa.no/ticket/1028 )). We are instead going to build the Advanced version for use with rtorrent.		XMLRPC-C comes in 3 flavours: Super-Stable, Stable and Advanced. While the Super-Stable version is available as a regular tarball, it seems like getting that version to work reliably is a hit-and-miss affair (( http://libtorrent.rakshasa.no/ticket/1028 )). We are instead going to build the Advanced version for use with rtorrent.
-
-

	To get the Advanced version source files, we need to install the subversion client:		To get the Advanced version source files, we need to install the subversion client:
-
	<code bash>yum install subversion</code>		<code bash>yum install subversion</code>
-
-

	Next, we need to install a missing dependency for XMLRPC-C (( http://fr.rpmfind.net/linux/RPM/fedora/updates/testing/7/i386/xmlrpc-c-1.06.25-1.fc7.i386.html )):		Next, we need to install a missing dependency for XMLRPC-C (( http://fr.rpmfind.net/linux/RPM/fedora/updates/testing/7/i386/xmlrpc-c-1.06.25-1.fc7.i386.html )):
-
	<code bash>yum install libxml2-devel</code>		<code bash>yum install libxml2-devel</code>
-
-

	Now, we start the XMLRPC-C build process:		Now, we start the XMLRPC-C build process:
-
	<code bash>		<code bash>
-
	REPOS=http://xmlrpc-c.svn.sourceforge.net/svnroot/xmlrpc-c/advanced		REPOS=http://xmlrpc-c.svn.sourceforge.net/svnroot/xmlrpc-c/advanced
-
	svn checkout $REPOS xmlrpc-c #This puts the source tree in a directory called xmlrpc-c in your current directory#		svn checkout $REPOS xmlrpc-c #This puts the source tree in a directory called xmlrpc-c in your current directory#
-
	svn up		svn up
-
	cd xmlrpc-c		cd xmlrpc-c
-
	./configure --disable-cplusplus		./configure --disable-cplusplus
-
	make		make
-
	make install		make install
-
	</code>		</code>
-
-

	The following command must execute without any errors:		The following command must execute without any errors:
-
	<xterm>[root@centos]# xmlrpc-c-config server-util --libs		<xterm>[root@centos]# xmlrpc-c-config server-util --libs
-
	-L/usr/local/lib -lxmlrpc_server -lxmlrpc -lxmlrpc_util -lxmlrpc_xmlparse -lxmlrpc_xmltok		-L/usr/local/lib -lxmlrpc_server -lxmlrpc -lxmlrpc_util -lxmlrpc_xmlparse -lxmlrpc_xmltok
-
	</xterm>		</xterm>
-
-

	Any errors at this stage means the rtorrent install will fail. Double-check that you have executed all the commands listed above starting from the section on installing [[howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps#curl\|curl]].		Any errors at this stage means the rtorrent install will fail. Double-check that you have executed all the commands listed above starting from the section on installing [[howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps#curl\|curl]].
-
-

	Now that we have all the dependencies for rtorrent in place, it's time to get started with installing rtorrent.		Now that we have all the dependencies for rtorrent in place, it's time to get started with installing rtorrent.
-
-

	=== libtorrent/rTorrent ===		=== libtorrent/rTorrent ===
-
	The latest build of rTorrent has a lot of functionality for managing torrents automatically. Plus, wTorrent (discussed in the wiki article [[howto:installing_rtorrent_addons_-_wtorrent_and_flexget\|Installing rTorrent adddons]]) relies on the latest build of rTorrent for much of it's functionality.		The latest build of rTorrent has a lot of functionality for managing torrents automatically. Plus, wTorrent (discussed in the wiki article [[howto:installing_rtorrent_addons_-_wtorrent_and_flexget\|Installing rTorrent adddons]]) relies on the latest build of rTorrent for much of it's functionality.
-
-

	Start by checking out the latest rTorrent build from the repository:		Start by checking out the latest rTorrent build from the repository:
-
	<code bash>		<code bash>
	mkdir rtorrent-svn		mkdir rtorrent-svn
Line 337:		Line 172:

	Next we install some dependencies for libtorrent to compile successfully:		Next we install some dependencies for libtorrent to compile successfully:
-
	<code bash>		<code bash>
	yum install openssl-devel libidn-devel		yum install openssl-devel libidn-devel
Line 343:		Line 177:

	Run the following commands to install libtorrent:		Run the following commands to install libtorrent:
-
	<code bash>		<code bash>
	cd trunk		cd trunk
Line 352:		Line 185:
	make install		make install
	</code>		</code>
-
-

	Check if the libtorrent install took:		Check if the libtorrent install took:
-
	<code bash>		<code bash>
-
	/sbin/ldconfig		/sbin/ldconfig
-
	pkg-config --cflags --libs libtorrent		pkg-config --cflags --libs libtorrent
-
	</code>		</code>
-
-

	You should see the following output after the pkg-config command listed above:		You should see the following output after the pkg-config command listed above:
-
	<xterm>[root@centos]# pkg-config --cflags --libs libtorrent		<xterm>[root@centos]# pkg-config --cflags --libs libtorrent
-
	-I/usr/local/include -L/usr/local/lib -ltorrent		-I/usr/local/include -L/usr/local/lib -ltorrent
-
	</xterm>		</xterm>
-
-

	If everything is in order, it's time to start the rTorrent install:		If everything is in order, it's time to start the rTorrent install:
-
	<code bash>		<code bash>
-
	cd ../rtorrent		cd ../rtorrent
-
	./autogen.sh		./autogen.sh
-
	./configure --with-xmlrpc-c		./configure --with-xmlrpc-c
-
	make		make
-
	make install		make install
-
	</code>		</code>
-
-

	If everything executes without errors, congratulations! You have a working rTorrent install ready for use. Before you can start using rTorrent though, you need to setup the rTorrent configuration file.		If everything executes without errors, congratulations! You have a working rTorrent install ready for use. Before you can start using rTorrent though, you need to setup the rTorrent configuration file.
-
-

	===== Creating a basic .rtorrent.rc file=====		===== Creating a basic .rtorrent.rc file=====
-
	rTorrent looks a file called ".rtorrent.rc" in the home directory of the user launching rTorrent. A sample .rtorrent.rc file is included below. A few things to note about this sample file:		rTorrent looks a file called ".rtorrent.rc" in the home directory of the user launching rTorrent. A sample .rtorrent.rc file is included below. A few things to note about this sample file:
-
-

	* Download/Upload speeds are set to unlimited (You may want to limit this to around 60-70% of your total VPS link speed)		* Download/Upload speeds are set to unlimited (You may want to limit this to around 60-70% of your total VPS link speed)
-
	* Downloads are saved in ~/downloads		* Downloads are saved in ~/downloads
-
	* Make sure to point the session variable to a directory that exists.		* Make sure to point the session variable to a directory that exists.
-
	* rTorrent listens for XMLRPC connection on localhost, port 5000		* rTorrent listens for XMLRPC connection on localhost, port 5000
-
-

	<code>		<code>
-
	# This is an example resource file for rTorrent. Copy to		# This is an example resource file for rTorrent. Copy to
-
	# ~/.rtorrent.rc and enable/modify the options as needed. Remember to		# ~/.rtorrent.rc and enable/modify the options as needed. Remember to
-
	# uncomment the options you wish to enable.		# uncomment the options you wish to enable.
-
-

	# Maximum and minimum number of peers to connect to per torrent.		# Maximum and minimum number of peers to connect to per torrent.
-
	#min_peers = 40		#min_peers = 40
-
	#max_peers = 100		#max_peers = 100
-
-

	# Same as above but for seeding completed torrents (-1 = same as downloading)		# Same as above but for seeding completed torrents (-1 = same as downloading)
-
	# Don't set this too high, otherwise you will be seeding very slowly.		# Don't set this too high, otherwise you will be seeding very slowly.
-
	min_peers_seed = 5		min_peers_seed = 5
-
	max_peers_seed = 15		max_peers_seed = 15
-
-

	# Maximum number of simultanious uploads per torrent.		# Maximum number of simultanious uploads per torrent.
-
	# Don't set this too high, otherwise you will be seeding very slowly.		# Don't set this too high, otherwise you will be seeding very slowly.
-
	max_uploads = 10		max_uploads = 10
-
-

	# Global upload and download rate in KiB. "0" for unlimited.		# Global upload and download rate in KiB. "0" for unlimited.
-
	# Change this based on the total bandwidth available for your VPS		# Change this based on the total bandwidth available for your VPS
-
	download_rate = 0		download_rate = 0
-
	upload_rate = 0		upload_rate = 0
-
-

	# Default directory to save the downloaded torrents.		# Default directory to save the downloaded torrents.
-
	# make sure the path exists!		# make sure the path exists!
-
	directory = ~/downloads		directory = ~/downloads
-
-

	# Default session directory. Make sure you don't run multiple instance		# Default session directory. Make sure you don't run multiple instance
-
	# of rtorrent using the same session directory.		# of rtorrent using the same session directory.
-
	# Absolute path used here to enable "stop" functionality in the rtorrent init.d script		# Absolute path used here to enable "stop" functionality in the rtorrent init.d script
-
	session = /home/rt/sessions/		session = /home/rt/sessions/
-
-

	#exec log		#exec log
-
	execute_log = ~/rtorrentexec.log		execute_log = ~/rtorrentexec.log
-
-

	# Close torrents when diskspace is low.		# Close torrents when diskspace is low.
-
	#schedule = low_diskspace,5,60,close_low_diskspace=100M		#schedule = low_diskspace,5,60,close_low_diskspace=100M
-
-

	# Stop torrents when reaching upload ratio in percent,		# Stop torrents when reaching upload ratio in percent,
-
	# when also reaching total upload in bytes, or when		# when also reaching total upload in bytes, or when
-
	# reaching final upload ratio in percent.		# reaching final upload ratio in percent.
-
-

	# Enable the default ratio group.		# Enable the default ratio group.
-
	ratio.enable=		ratio.enable=
-
-

	# Change the limits, the defaults should be sufficient.		# Change the limits, the defaults should be sufficient.
-
	ratio.min.set=100		ratio.min.set=100
-
	ratio.max.set=200		ratio.max.set=200
-
	ratio.upload.set=20M		ratio.upload.set=20M
-
-

	# The ip address the listening socket and outgoing connections is		# The ip address the listening socket and outgoing connections is
-
	# bound to.		# bound to.
-
	#bind = 127.0.0.1		#bind = 127.0.0.1
-
	#bind = rakshasa.no		#bind = rakshasa.no
-
-

	# Port range to use for listening.		# Port range to use for listening.
-
	port_range = 6890-6999		port_range = 6890-6999
-
-

	# Start opening ports at a random position within the port range.		# Start opening ports at a random position within the port range.
-
	#port_random = no		#port_random = no
-
-

	# Check hash for finished torrents. Might be usefull until the bug is		# Check hash for finished torrents. Might be usefull until the bug is
-
	# fixed that causes lack of diskspace not to be properly reported.		# fixed that causes lack of diskspace not to be properly reported.
-
	#check_hash = no		#check_hash = no
-
-

	# Set whetever the client should try to connect to UDP trackers.		# Set whetever the client should try to connect to UDP trackers.
-
	#use_udp_trackers = yes		#use_udp_trackers = yes
-
-

	# Alternative calls to bind and ip that should handle dynamic ip's.		# Alternative calls to bind and ip that should handle dynamic ip's.
-
	#schedule = ip_tick,0,1800,ip=rakshasa		#schedule = ip_tick,0,1800,ip=rakshasa
-
	#schedule = bind_tick,0,1800,bind=rakshasa		#schedule = bind_tick,0,1800,bind=rakshasa
-
-

	# Encryption options, set to none (default) or any combination of the following:		# Encryption options, set to none (default) or any combination of the following:
-
	# allow_incoming, try_outgoing, require, require_RC4, enable_retry, prefer_plaintext		# allow_incoming, try_outgoing, require, require_RC4, enable_retry, prefer_plaintext
-
	#		#
-
	# The example value allows incoming encrypted connections, starts unencrypted		# The example value allows incoming encrypted connections, starts unencrypted
-
	# outgoing connections but retries with encryption if they fail, preferring		# outgoing connections but retries with encryption if they fail, preferring
-
	# plaintext to RC4 encryption after the encrypted handshake		# plaintext to RC4 encryption after the encrypted handshake
-
	#		#
-
	# encryption = allow_incoming,enable_retry,prefer_plaintext		# encryption = allow_incoming,enable_retry,prefer_plaintext
-
	encryption = allow_incoming,try_outgoing,enable_retry		encryption = allow_incoming,try_outgoing,enable_retry
-
-

	# Enable DHT support for trackerless torrents or when all trackers are down.		# Enable DHT support for trackerless torrents or when all trackers are down.
-
	# May be set to "disable" (completely disable DHT), "off" (do not start DHT),		# May be set to "disable" (completely disable DHT), "off" (do not start DHT),
-
	# "auto" (start and stop DHT as needed), or "on" (start DHT immediately).		# "auto" (start and stop DHT as needed), or "on" (start DHT immediately).
-
	# The default is "off". For DHT to work, a session directory must be defined.		# The default is "off". For DHT to work, a session directory must be defined.
-
	#		#
-
	# dht = auto		# dht = auto
-
-

	# UDP port to use for DHT.		# UDP port to use for DHT.
-
	#		#
-
	# dht_port = 6881		# dht_port = 6881
-
-

	# Enable peer exchange (for torrents not marked private)		# Enable peer exchange (for torrents not marked private)
-
	#		#
-
	# peer_exchange = yes		# peer_exchange = yes
-
-

	#XMLRPC		#XMLRPC
-
	scgi_port = localhost:5000		scgi_port = localhost:5000
-
-

	#umask		#umask
-
	umask = 0022		umask = 0022
-
-

	#		#
-
	# Do not modify the following parameters unless you know what you're doing.		# Do not modify the following parameters unless you know what you're doing.
-
	#		#
-
-

	# Hash read-ahead controls how many MB to request the kernel to read		# Hash read-ahead controls how many MB to request the kernel to read
-
	# ahead. If the value is too low the disk may not be fully utilized,		# ahead. If the value is too low the disk may not be fully utilized,
-
	# while if too high the kernel might not be able to keep the read		# while if too high the kernel might not be able to keep the read
-
	# pages in memory thus end up trashing.		# pages in memory thus end up trashing.
-
	#hash_read_ahead = 10		#hash_read_ahead = 10
-
-

	# Interval between attempts to check the hash, in milliseconds.		# Interval between attempts to check the hash, in milliseconds.
-
	#hash_interval = 100		#hash_interval = 100
-
-

	# Number of attempts to check the hash while using the mincore status,		# Number of attempts to check the hash while using the mincore status,
-
	# before forcing. Overworked systems might need lower values to get a		# before forcing. Overworked systems might need lower values to get a
-
	# decent hash checking rate.		# decent hash checking rate.
-
	#hash_max_tries = 10		#hash_max_tries = 10
-
	</code>		</code>
-
-

	If you are not comfortable with copying and pasting a big chunk of text, you can download the same file using the following command:		If you are not comfortable with copying and pasting a big chunk of text, you can download the same file using the following command:
-
	<code bash>		<code bash>
-
	cd ~		cd ~
-
	wget http://wiki.theaveragegeek.com/samples/rtorrent.rc		wget http://wiki.theaveragegeek.com/samples/rtorrent.rc
-
	mv rtorrent.rc .rtorrent.rc		mv rtorrent.rc .rtorrent.rc
-
	</code>		</code>
-
-

	Now that you have a .rtorrent.rc file setup, it's time to actually launch rTorrent.		Now that you have a .rtorrent.rc file setup, it's time to actually launch rTorrent.
-
-

	===== Working with rTorrent =====		===== Working with rTorrent =====
-
	Launch rTorrent by running the following command:		Launch rTorrent by running the following command:
-
	<code bash>/usr/local/bin/rtorrent</code>		<code bash>/usr/local/bin/rtorrent</code>
-
-

	You should find yourself looking a fairly spartan window:		You should find yourself looking a fairly spartan window:
-
-

	{{:howto:rtorrent-main.jpg \|}}		{{:howto:rtorrent-main.jpg \|}}
-
	~~CL~~		~~CL~~
-
	\\		\\
-
	Let's start by loading a new torrent meta-file. Torrent meta-files can be loaded into rTorrent using the <key>Backspace</key> key. Auto-completion of directories using the <key>Tab</key> key and wildcards (example: *.torrent) is supported.		Let's start by loading a new torrent meta-file. Torrent meta-files can be loaded into rTorrent using the <key>Backspace</key> key. Auto-completion of directories using the <key>Tab</key> key and wildcards (example: *.torrent) is supported.
-
-

	Once you have a torrent loaded, you can use the following list of commands to manage rTorrent:		Once you have a torrent loaded, you can use the following list of commands to manage rTorrent:
-
-

	^ Command ^ Description ^		^ Command ^ Description ^
-
	\| <key>Ctrl</key>+<key>s</key> \| Start download. Runs hash first unless already done. \|		\| <key>Ctrl</key>+<key>s</key> \| Start download. Runs hash first unless already done. \|
-
	\| <key>Ctrl</key>+<key>d</key> \| Stop an active download, or remove a stopped download. \|		\| <key>Ctrl</key>+<key>d</key> \| Stop an active download, or remove a stopped download. \|
-
	\| <key>Ctrl</key>+<key>q</key> \| Initiate shutdown \|		\| <key>Ctrl</key>+<key>q</key> \| Initiate shutdown \|
-		+	\| <key>-^</key>/<key>-d</key> \| Select item \|
-	\| <key>Up</key>/<key>Down</key> \| Select item \|	+	\| <key>-> </key> \| Go back to the previous screen. \|
-		+	\| <key><- </key> \| Switch to Download View. \|
-	\| <key>Left </key> \| Go back to the previous screen. \|	+	\| <key>l</key> \| View log. Exit by pressing <key>space</key>. \|
-		+
-	\| <key>Right </key> \| Switch to Download View. \|	+
-		+
-	\| <key>l</key> \| View log. Exit by pressing <key>Space</key> \|	+
-		+
-	essing <key>space</key>. \|	+
-		+

	There is one problem with launching rTorrent from a regular shell window. Once you type in <key>Ctrl</key>+<key>q</key> to exit from rTorrent, it shuts down completely, stopping all your in-progress torrents. The next section will deal with how to keep rTorrent running in the background as well as how to launch rTorrent on startup.		There is one problem with launching rTorrent from a regular shell window. Once you type in <key>Ctrl</key>+<key>q</key> to exit from rTorrent, it shuts down completely, stopping all your in-progress torrents. The next section will deal with how to keep rTorrent running in the background as well as how to launch rTorrent on startup.
-
-

	===== Running rTorrent as a Service=====		===== Running rTorrent as a Service=====
-
-

	We will be using dtach to keep rTorrent running in the background (( The other option is screen, which is a better screen-multiplexer program but requires a lot more privileges to run )). To install dtach, execute the following command:		We will be using dtach to keep rTorrent running in the background (( The other option is screen, which is a better screen-multiplexer program but requires a lot more privileges to run )). To install dtach, execute the following command:
-
	<code bash>yum install dtach</code>		<code bash>yum install dtach</code>
-
-

	Now you can launch rtorrent using screen:		Now you can launch rtorrent using screen:
-
	<code bash>dtach -c /tmp/dtach-rtorrent rtorrent</code>		<code bash>dtach -c /tmp/dtach-rtorrent rtorrent</code>
-
-

	Once rTorrent launches, press <key>Ctrl</key>+<key>\</key>. You will get the following message at the shell:		Once rTorrent launches, press <key>Ctrl</key>+<key>\</key>. You will get the following message at the shell:
-
	<xterm>[root@centos]# dtach -c /tmp/dtach-rtorrent rtorrent		<xterm>[root@centos]# dtach -c /tmp/dtach-rtorrent rtorrent
-
	[detached]		[detached]
-
	</xterm>		</xterm>
-
-

	You can verify that rTorrent is still running by running the following command:		You can verify that rTorrent is still running by running the following command:
-
	<xterm>[root@centos]# ls -l /tmp/dtach*		<xterm>[root@centos]# ls -l /tmp/dtach*
-
	srw------- 1 root root 0 Apr 2 01:33 /tmp/dtach-rtorrent		srw------- 1 root root 0 Apr 2 01:33 /tmp/dtach-rtorrent
-
	</xterm>		</xterm>
-
-

	To reconnect the rTorrent session in the background, type <code bash>dtach -a /tmp/dtach-rtorrent</code>		To reconnect the rTorrent session in the background, type <code bash>dtach -a /tmp/dtach-rtorrent</code>
-
-

	In order to launch rTorrent at startup, we need to create an entry in the init.d folder as well as a configuration file that the init.d script can read.		In order to launch rTorrent at startup, we need to create an entry in the init.d folder as well as a configuration file that the init.d script can read.
-
-

	These commands need to be executed while logged in as root		These commands need to be executed while logged in as root
-
-

	The configuration file can be created as follows:		The configuration file can be created as follows:
-
	<code bash>touch /etc/rtorrent.init.conf		<code bash>touch /etc/rtorrent.init.conf
-
	nano -w /etc/rtorrent.init.conf</code>		nano -w /etc/rtorrent.init.conf</code>
-
-

	Now copy and paste the following text into your rtorrent.init.conf file:		Now copy and paste the following text into your rtorrent.init.conf file:
-
	<code>		<code>
-
	##Start Configuration##		##Start Configuration##
-
	#Do not put a space on either side of the equal signs e.g.		#Do not put a space on either side of the equal signs e.g.
-
	# user = user		# user = user
-
	# will not work		# will not work
-
-

	# system user to run as		# system user to run as
-
	user="rt"		user="rt"
-
-

	# the full path to the filename where you store your rtorrent configuration		# the full path to the filename where you store your rtorrent configuration
-
	config="/home/rt/.rtorrent.rc"		config="/home/rt/.rtorrent.rc"
-
-

	# set of options to run with		# set of options to run with
-
	options=""		options=""
-
-

	# file to log to (makes for easier debugging if something goes wrong)		# file to log to (makes for easier debugging if something goes wrong)
-
	logfile="/home/rt/rtorrentInit.log"		logfile="/home/rt/rtorrentInit.log"
-
	</code>		</code>
-
-

	Save and exit. If you want, you can get the file directly on your server as follows:		Save and exit. If you want, you can get the file directly on your server as follows:
-
	<code bash>		<code bash>
-
	cd /etc		cd /etc
-
	wget http://wiki.theaveragegeek.com/samples/rtorrent.init.conf		wget http://wiki.theaveragegeek.com/samples/rtorrent.init.conf
-
	</code>		</code>
-
-
-


	Make sure to also create the logfile <code bash>touch /home/rt/rtorrentInit.log</code>		Make sure to also create the logfile <code bash>touch /home/rt/rtorrentInit.log</code>
-
-

	The next step is to create the entry in the init.d folder:		The next step is to create the entry in the init.d folder:
-
	<code bash>touch /etc/init.d/rtorrent		<code bash>touch /etc/init.d/rtorrent
-
	nano -w /etc/init.d/rtorrent		nano -w /etc/init.d/rtorrent
-
	</code>		</code>
-
-

	Add the following text to your rtorrent file in the init.d folder:		Add the following text to your rtorrent file in the init.d folder:
-
	<code>		<code>
-
	#!/bin/sh		#!/bin/sh
-
	#		#
-
	#		#
-
	#############		#############
-
	###<Notes>###		###<Notes>###
-
	#############		#############
-
	# This script depends on dtach.		# This script depends on dtach.
-
	# Based on the script created by lostnihilist at http://libtorrent.rakshasa.no/attachment/wiki/RTorrentCommonTasks/rtorrentInit.sh		# Based on the script created by lostnihilist at http://libtorrent.rakshasa.no/attachment/wiki/RTorrentCommonTasks/rtorrentInit.sh
-
	# Licensed under the GPLv2 by average_geek: contact_at_theaveragegeek_dot_com		# Licensed under the GPLv2 by average_geek: contact_at_theaveragegeek_dot_com
-
	##############		##############
-
	###</Notes>###		###</Notes>###
-
	##############		##############
-
	#/etc/rc.d/init.d/rtorrent		#/etc/rc.d/init.d/rtorrent
-
	# chkconfig: 235 80 30		# chkconfig: 235 80 30
-
	# description: Run rtorrent as a Daemon service using dtach		# description: Run rtorrent as a Daemon service using dtach
-
	# processname: rtorrent		# processname: rtorrent
-
	# Source function library.		# Source function library.
-
	. /etc/rc.d/init.d/functions		. /etc/rc.d/init.d/functions
-
	# Source networking configuration.		# Source networking configuration.
-
	. /etc/sysconfig/network		. /etc/sysconfig/network
-
	#VARIABLES#		#VARIABLES#
-
	. /etc/rtorrent.init.conf		. /etc/rtorrent.init.conf
-
	PATH=/usr/bin:/usr/local/bin:/usr/local/sbin:/sbin:/bin:/usr/sbin		PATH=/usr/bin:/usr/local/bin:/usr/local/sbin:/sbin:/bin:/usr/sbin
-
	DESC="rtorrent via dtach"		DESC="rtorrent via dtach"
-
	NAME=rtorrent		NAME=rtorrent
-
	DAEMON=$NAME		DAEMON=$NAME
-
	SCRIPTNAME=/etc/init.d/$NAME		SCRIPTNAME=/etc/init.d/$NAME
-
	RETVAL=0		RETVAL=0
-
	lockfile=${LOCKFILE-/var/lock/subsys/rtorrent}		lockfile=${LOCKFILE-/var/lock/subsys/rtorrent}
-
-

	# Check that networking is up.		# Check that networking is up.
-
	[ ${NETWORKING} = "no" ] && exit 0		[ ${NETWORKING} = "no" ] && exit 0
-
-

	#Functions		#Functions
-
	checkconfig() {		checkconfig() {
-
	exists=0		exists=0
-
-

	for i in `echo "$PATH" \| tr ':' '\n'` ; do		for i in `echo "$PATH" \| tr ':' '\n'` ; do
-
	if [ -f $i/$NAME ] ; then		if [ -f $i/$NAME ] ; then
-
	exists=1		exists=1
-
	appdir=$i		appdir=$i
-
	apppath=$i/$NAME		apppath=$i/$NAME
-
	break		break
-
	fi		fi
-
	done		done
-
-

	if ! [ -x "$apppath" ] ; then		if ! [ -x "$apppath" ] ; then
-
	echo "cannot find executable rtorrent binary in PATH $appdir" \| tee -a "$logfile" >&2		echo "cannot find executable rtorrent binary in PATH $appdir" \| tee -a "$logfile" >&2
-
	exit 3		exit 3
-
	fi		fi
-

-
	if [ $exists -eq 0 ] ; then		if [ $exists -eq 0 ] ; then
-
	echo "cannot find rtorrent binary in PATH $PATH" \| tee -a "$logfile" >&2		echo "cannot find rtorrent binary in PATH $PATH" \| tee -a "$logfile" >&2
-
	exit 3		exit 3
-
	fi		fi
-
-

	if ! [ -r "${config}" ] ; then		if ! [ -r "${config}" ] ; then
-
	echo "cannot find readable config ${config}. check that it is there and permissions are appropriate" \| tee -a "$logfile" >&2		echo "cannot find readable config ${config}. check that it is there and permissions are appropriate" \| tee -a "$logfile" >&2
-
	exit 3		exit 3
-
	fi		fi
-
-

	session=`getsession "$config"`		session=`getsession "$config"`
-
	if ! [ -d "${session}" ] ; then		if ! [ -d "${session}" ] ; then
-
	echo "cannot find readable session directory ${session} from config ${config}. check permissions" \| tee -a "$logfile" >&2		echo "cannot find readable session directory ${session} from config ${config}. check permissions" \| tee -a "$logfile" >&2
-
	exit 3		exit 3
-
	fi		fi
-
	}		}
-
-

	getsession() {		getsession() {
-
-

	session=`awk '/^[[:space:]]session[[:space:]]=[[:space:]]*/{print($3)}' "$config"`		session=`awk '/^[[:space:]]session[[:space:]]=[[:space:]]*/{print($3)}' "$config"`
-
	echo $session		echo $session
-
	}		}
-
-

	start() {		start() {
-
-

	daemon `su -c "dtach -n /tmp/dtach-"${DAEMON}" rtorrent ${options} 2>&1 1>/dev/null" ${user} \| tee -a "$logfile" >&2`		daemon `su -c "dtach -n /tmp/dtach-"${DAEMON}" rtorrent ${options} 2>&1 1>/dev/null" ${user} \| tee -a "$logfile" >&2`
-
-

	RETVAL=$?		RETVAL=$?
-
	echo		echo
-
	[ $RETVAL -eq 0 ] && touch ${lockfile}		[ $RETVAL -eq 0 ] && touch ${lockfile}
-
-

	}		}
-
-

	stop() {		stop() {
-

-
	killproc $NAME		killproc $NAME
-

-
	RETVAL=$?		RETVAL=$?
-
	echo		echo
-
	[ $RETVAL -eq 0 ] && rm -f ${lockfile}		[ $RETVAL -eq 0 ] && rm -f ${lockfile}
-
-

	}		}
-
	#End Functions		#End Functions
-
	#Script		#Script
-
-

	checkconfig		checkconfig
-
-

	case "$1" in		case "$1" in
-
-

	start)		start)
-
	echo -n "Starting $DESC: $NAME"		echo -n "Starting $DESC: $NAME"
-
	start		start
-
	;;		;;
-
-

	stop)		stop)
-
	echo -n "Stopping $DESC: $NAME"		echo -n "Stopping $DESC: $NAME"
-
	stop		stop
-
	;;		;;
-
-

	restart\|force-reload)		restart\|force-reload)
-
	echo -n "Restarting $DESC: $NAME"		echo -n "Restarting $DESC: $NAME"
-
	stop		stop
-
	sleep 1		sleep 1
-
	start		start
-
	;;		;;
-
-

	*)		*)
-
	echo "Usage: $SCRIPTNAME {start\|stop\|restart\|force-reload}" >&2		echo "Usage: $SCRIPTNAME {start\|stop\|restart\|force-reload}" >&2
-
	exit 1		exit 1
-
	;;		;;
-
-

	esac		esac
-
-

	exit 0		exit 0
-
	</code>		</code>
-
-

	Now we need to make the rtorrent file executable:		Now we need to make the rtorrent file executable:
-
	<code bash>chmod 755 /etc/init.d/rtorrent</code>		<code bash>chmod 755 /etc/init.d/rtorrent</code>
-
-

	If you would like to skip copying and pasting text into your shell session, you can run the following commands instead:		If you would like to skip copying and pasting text into your shell session, you can run the following commands instead:
-
	<code bash>		<code bash>
-
	cd /etc/init.d/		cd /etc/init.d/
-
	wget http://wiki.theaveragegeek.com/samples/rtorrent.sh		wget http://wiki.theaveragegeek.com/samples/rtorrent.sh
-
	mv rtorrent.sh rtorrent		mv rtorrent.sh rtorrent
-
	chmod 755 /etc/init.d/rtorrent		chmod 755 /etc/init.d/rtorrent
-
	</code>		</code>
-
-
-


	Next we add rTorrent to the list of startup services:		Next we add rTorrent to the list of startup services:
-
	<code bash>chkconfig --add rtorrent</code>		<code bash>chkconfig --add rtorrent</code>
-
-

	Now you can start rTorrent using the following command:		Now you can start rTorrent using the following command:
-
	<code bash>/etc/init.d/rtorrent start</code>		<code bash>/etc/init.d/rtorrent start</code>
-
-

	If there are no problems with your configuration file, you should see the following:		If there are no problems with your configuration file, you should see the following:
-
	<xterm>		<xterm>
-
	[root@centos]# /etc/init.d/rtorrent start		[root@centos]# /etc/init.d/rtorrent start
-
	Starting rtorrent via dtach: rtorrent [ OK ]		Starting rtorrent via dtach: rtorrent [ OK ]
-
	</xterm>		</xterm>
-
-

	Verify that rTorrent is running with the following command:		Verify that rTorrent is running with the following command:
-
	<code bash>ls -l /tmp/dtach*</code>		<code bash>ls -l /tmp/dtach*</code>
-
-

	You should see the following:		You should see the following:
-
	<xterm>[root@centos]# ls -l /tmp/dtach*		<xterm>[root@centos]# ls -l /tmp/dtach*
-
	srw------- 1 root root 0 Apr 2 01:33 /tmp/dtach-rtorrent		srw------- 1 root root 0 Apr 2 01:33 /tmp/dtach-rtorrent
-
	</xterm>		</xterm>
-
-

	=== Caveats ===		=== Caveats ===
-
	Unfortunately, launching rTorrent as a starup service this way comes with some limitations:		Unfortunately, launching rTorrent as a starup service this way comes with some limitations:
-
-

	* The startup script launches rTorrent through a couple of layers of redirection. This means that sometimes, rTorrent can fail to start but the startup script still says "Starting rtorrent via dtach: rtorrent [ OK ]"		* The startup script launches rTorrent through a couple of layers of redirection. This means that sometimes, rTorrent can fail to start but the startup script still says "Starting rtorrent via dtach: rtorrent [ OK ]"
-
	* Another problem is that if rTorrent finds any problems in the .rtorrent.rc file, it does not send the message to stderr but rather to stdout (i.e. on-screen)		* Another problem is that if rTorrent finds any problems in the .rtorrent.rc file, it does not send the message to stderr but rather to stdout (i.e. on-screen)
-
	* So if you make a change to your .rtorrent.rc file you might want to check for any problems by launching rTorrent the usual way, i.e., <code bash>/usr/local/bin/rtorrent</code>		* So if you make a change to your .rtorrent.rc file you might want to check for any problems by launching rTorrent the usual way, i.e., <code bash>/usr/local/bin/rtorrent</code>
-
-

	===== What else can I do with rTorrent?=====		===== What else can I do with rTorrent?=====
-
-

	To learn how to add a WebUI for rTorrent and to use FlexGet to automatically download your torrents, see the wiki article on [[howto:installing_rtorrent_addons_-_wtorrent_and_flexget\|rTorrent addons]]		To learn how to add a WebUI for rTorrent and to use FlexGet to automatically download your torrents, see the wiki article on [[howto:installing_rtorrent_addons_-_wtorrent_and_flexget\|rTorrent addons]]
-
-

	If you would like to have rTorrent watch a directory for new torrents or move completed torrents to another folder after completion, see the wiki article on [[howto:rtorrent_advanced_tasks\|Advanced options in rTorrent]].		If you would like to have rTorrent watch a directory for new torrents or move completed torrents to another folder after completion, see the wiki article on [[howto:rtorrent_advanced_tasks\|Advanced options in rTorrent]].
-
-

	The rest of this Wiki article will discuss how to install and configure hellanzb.		The rest of this Wiki article will discuss how to install and configure hellanzb.
-
-

	===== Installing hellanzb =====		===== Installing hellanzb =====
-
	In case you are wondering what hellanzb is, it "is a Python application designed for *nix environments that retrieves [[http://www.hellanzb.com/trac/hellanzb/wiki/nzb\|nzb]] files and fully processes them. The goal being to make getting files from Usenet as hands-free as possible." (( http://www.hellanzb.com/trac/ ))		In case you are wondering what hellanzb is, it "is a Python application designed for *nix environments that retrieves [[http://www.hellanzb.com/trac/hellanzb/wiki/nzb\|nzb]] files and fully processes them. The goal being to make getting files from Usenet as hands-free as possible." (( http://www.hellanzb.com/trac/ ))
-
-

	hellanzb's dependency list is deceptively simple:		hellanzb's dependency list is deceptively simple:
-
	* Twisted		* Twisted
-
	* unrar/unzip		* unrar/unzip
-
	* par2cmdline		* par2cmdline
-
	* pyOpenSSL (if you want to use SSL connections to your Usenet provider)		* pyOpenSSL (if you want to use SSL connections to your Usenet provider)
-
-

	The reality of course is a bit more complicated. Let's get started with Twisted.		The reality of course is a bit more complicated. Let's get started with Twisted.
-
-

	==== hellanzb dependencies ====		==== hellanzb dependencies ====
-
	hellanzb's core dependency is Twisted - a networking stack written in Python. Twisted in turn, relies on zope.interface and python headers. Let's start with the core python headers install:		hellanzb's core dependency is Twisted - a networking stack written in Python. Twisted in turn, relies on zope.interface and python headers. Let's start with the core python headers install:
-
	<code bash>yum install python-devel</code>		<code bash>yum install python-devel</code>
-
-

	While zope.interface is available as a simple tarball, I never managed to get the build to work. The only thing that did work was a <ttip:default>RPM \| Redhat Package Manager </ttip> file that I located on a 3rd-party repository (( http://rpm.pbone.net/index.php3/stat/4/idpl/10370620/com/python-ZopeInterface-3.3.0-1.el5.pp.x86_64.rpm.html)):		While zope.interface is available as a simple tarball, I never managed to get the build to work. The only thing that did work was a <ttip:default>RPM \| Redhat Package Manager </ttip> file that I located on a 3rd-party repository (( http://rpm.pbone.net/index.php3/stat/4/idpl/10370620/com/python-ZopeInterface-3.3.0-1.el5.pp.x86_64.rpm.html)):
-
	<code bash>		<code bash>
-
	wget ftp://ftp.pbone.net/mirror/ftp.pramberger.at/systems/linux/contrib/rhel5/x86_64/python-ZopeInterface-3.3.0-1.el5.pp.x86_64.rpm		wget ftp://ftp.pbone.net/mirror/ftp.pramberger.at/systems/linux/contrib/rhel5/x86_64/python-ZopeInterface-3.3.0-1.el5.pp.x86_64.rpm
-
	rpm -ivh python-ZopeInterface-3.3.0-1.el5.pp.x86_64.rpm		rpm -ivh python-ZopeInterface-3.3.0-1.el5.pp.x86_64.rpm
-
	</code>		</code>
-
-

	Now we can get started with Twisted. The current version of Twisted (at the time of writing this article) is 8.2.0 . You can find the latest version info on [[http://twistedmatrix.com/trac/wiki\|the Twisted website]], and a link to the source tarball is available on the home page as well. Installation is as follows:		Now we can get started with Twisted. The current version of Twisted (at the time of writing this article) is 8.2.0 . You can find the latest version info on [[http://twistedmatrix.com/trac/wiki\|the Twisted website]], and a link to the source tarball is available on the home page as well. Installation is as follows:
-
-

	<code bash>		<code bash>
-
	wget http://tmrc.mit.edu/mirror/twisted/Twisted/8.2/Twisted-8.2.0.tar.bz2#md5=c85f151999df3ecf04c49a781b4438d2		wget http://tmrc.mit.edu/mirror/twisted/Twisted/8.2/Twisted-8.2.0.tar.bz2#md5=c85f151999df3ecf04c49a781b4438d2
-
	tar jxf Twisted-8.2.0.tar.bz2		tar jxf Twisted-8.2.0.tar.bz2
-
	cd Twisted-8.2.0/		cd Twisted-8.2.0/
-
	python setup.py install --install-lib /usr/lib/python2.4/site-packages		python setup.py install --install-lib /usr/lib/python2.4/site-packages
-
	</code>		</code>
-
-

	The odd install path for Twisted is due to a bug in the way Python packages get installed on 64-bit OS'es. See [[http://twistedmatrix.com/trac/ticket/2873\|this bug report]]		The odd install path for Twisted is due to a bug in the way Python packages get installed on 64-bit OS'es. See [[http://twistedmatrix.com/trac/ticket/2873\|this bug report]]
-
-

	The next set of dependencies for hellanzb are for unrar/unzip. If you have been using the instructions listed in this article on how to install rTorrent, you should have the rpmforge repository installed. The only thing left to do is to execute the following command:		The next set of dependencies for hellanzb are for unrar/unzip. If you have been using the instructions listed in this article on how to install rTorrent, you should have the rpmforge repository installed. The only thing left to do is to execute the following command:
-
	<code bash>yum install unrar unzip</code>		<code bash>yum install unrar unzip</code>
-
-

	Now we move par2cmdline. In case you are wondering what this program does, you should read [[http://www.techsono.com/faq/par.html\|this article]] on PAR files. The latest version of the par2cmdline client for UNIX (at the time of writing this article) is 0.3. You can download the source tarball from the clients section of [[http://parchive.sourceforge.net/#clients\|the parchive website]].		Now we move par2cmdline. In case you are wondering what this program does, you should read [[http://www.techsono.com/faq/par.html\|this article]] on PAR files. The latest version of the par2cmdline client for UNIX (at the time of writing this article) is 0.3. You can download the source tarball from the clients section of [[http://parchive.sourceforge.net/#clients\|the parchive website]].
-
-

	Unfortunately, a bug in gcc 4.x.x prevents par2cmdline from compiling properly unless a patch is applied (( http://slackbuilds.org/repository/12.2/system/par2cmdline/ )). The complete process for building par2cmdline goes like this:		Unfortunately, a bug in gcc 4.x.x prevents par2cmdline from compiling properly unless a patch is applied (( http://slackbuilds.org/repository/12.2/system/par2cmdline/ )). The complete process for building par2cmdline goes like this:
-
	<code bash>		<code bash>
-
	wget http://prdownloads.sourceforge.net/parchive/par2cmdline-0.3.tar.gz?download		wget http://prdownloads.sourceforge.net/parchive/par2cmdline-0.3.tar.gz?download
-
	tar zxf par2cmdline-0.3.tar.gz		tar zxf par2cmdline-0.3.tar.gz
-
	cd par2cmdline-0.3/		cd par2cmdline-0.3/
-
	wget http://slackbuilds.org/slackbuilds/12.2/system/par2cmdline/par2cmdline-0.4-gcc4.patch		wget http://slackbuilds.org/slackbuilds/12.2/system/par2cmdline/par2cmdline-0.4-gcc4.patch
-
	yum install patch		yum install patch
-
	patch reedsolomon.cpp par2cmdline-0.4-gcc4.patch		patch reedsolomon.cpp par2cmdline-0.4-gcc4.patch
-
	./configure		./configure
-
	make		make
-
	make install		make install
-
	</code>		</code>
-
-

	Optional:Finally, we install PyOpenSSL:		Optional:Finally, we install PyOpenSSL:
-
	<code bash>yum install PyOpenSSL</code>		<code bash>yum install PyOpenSSL</code>
-
-

	==== Building hellanzb ====		==== Building hellanzb ====
-
	At the time of writing this article, the latest version of hellanzb was 0.13. You can check the version info on hellanzb's [[http://www.hellanzb.com/trac/hellanzb/wiki\|website]] while the actual source tarballs are available in [[http://www.hellanzb.com/distfiles/\|the distfiles folder]]. You could be adventurous and try the nightly builds in the distfiles folder, but the stable version works well enough.		At the time of writing this article, the latest version of hellanzb was 0.13. You can check the version info on hellanzb's [[http://www.hellanzb.com/trac/hellanzb/wiki\|website]] while the actual source tarballs are available in [[http://www.hellanzb.com/distfiles/\|the distfiles folder]]. You could be adventurous and try the nightly builds in the distfiles folder, but the stable version works well enough.
-
	<code bash>		<code bash>
-
	wget http://www.hellanzb.com/distfiles/hellanzb-0.13.tar.gz		wget http://www.hellanzb.com/distfiles/hellanzb-0.13.tar.gz
-
	tar zxf hellanzb-0.13.tar.gz		tar zxf hellanzb-0.13.tar.gz
-
	cd hellanzb-0.13		cd hellanzb-0.13
-
	python setup.py install		python setup.py install
-
	</code>		</code>
-
-

	If everything went well, you have a working hellanzb install. Now it's time to configure hellanzb.		If everything went well, you have a working hellanzb install. Now it's time to configure hellanzb.
-
	===== Creating a hellanzb.conf file=====		===== Creating a hellanzb.conf file=====
-
	hellanzb looks for a configuration file called "hellanzb.conf" in the /usr/etc folder. A sample hellanzb.conf file is given below. You should note the following about this sample conf file:		hellanzb looks for a configuration file called "hellanzb.conf" in the /usr/etc folder. A sample hellanzb.conf file is given below. You should note the following about this sample conf file:
-
-

	* Download speeds are set to 150kB/s (You may want to limit this to around 30% of your total VPS link speed) (( hellanzb 0.13 has a problem with speed limits due to a bug in the underlying twisted network stack ))		* Download speeds are set to 150kB/s (You may want to limit this to around 30% of your total VPS link speed) (( hellanzb 0.13 has a problem with speed limits due to a bug in the underlying twisted network stack ))
-
	* Finished Downloads are saved in /home/nzb/downloads/completed_files		* Finished Downloads are saved in /home/nzb/downloads/completed_files
-
	* hellanzb listens for XMLRPC connection on localhost, port 8760		* hellanzb listens for XMLRPC connection on localhost, port 8760
-
-
-


	<code>		<code>
-
	#		#
-
	# hellanzb.conf - sample hellanzb configuration file		# hellanzb.conf - sample hellanzb configuration file
-
	#		#
-
	# To quickly get started, change the default defineServer() call and the		# To quickly get started, change the default defineServer() call and the
-
	# Hellanzb.PREFIX_DIR directory		# Hellanzb.PREFIX_DIR directory
-
	#		#
-
	# This is actually interpreted python code: strings must be surrounded by		# This is actually interpreted python code: strings must be surrounded by
-
	# quotes, numbers and the 'None' keyword should not		# quotes, numbers and the 'None' keyword should not
-
	#		#
-
	# $Id: hellanzb.conf.sample 1057 2007-03-27 04:13:53Z pjenvey $		# $Id: hellanzb.conf.sample 1057 2007-03-27 04:13:53Z pjenvey $
-
-

	# Log output to this file, set to None (no single quotes) for no logging		# Log output to this file, set to None (no single quotes) for no logging
-
	Hellanzb.LOG_FILE = '/var/tmp/hellanzb.log'		Hellanzb.LOG_FILE = '/var/tmp/hellanzb.log'
-
-

	# Uncomment this line to log DEBUG messages to the specified file		# Uncomment this line to log DEBUG messages to the specified file
-
	#Hellanzb.DEBUG_MODE = '/var/tmp/hellanzb-debug.log'		#Hellanzb.DEBUG_MODE = '/var/tmp/hellanzb-debug.log'
-
-

	# Automatically roll over both log files when they reach LOG_FILE_MAX_BYTES		# Automatically roll over both log files when they reach LOG_FILE_MAX_BYTES
-
	# size		# size
-
	Hellanzb.LOG_FILE_MAX_BYTES = 131072		Hellanzb.LOG_FILE_MAX_BYTES = 131072
-
-

	# Save LOG_FILE_BACKUP_COUNT of those rolled over log files		# Save LOG_FILE_BACKUP_COUNT of those rolled over log files
-
	Hellanzb.LOG_FILE_BACKUP_COUNT = 0		Hellanzb.LOG_FILE_BACKUP_COUNT = 0
-
-
-


	# Define server connections. Servers can have multiple hosts, hellanzb will		# Define server connections. Servers can have multiple hosts, hellanzb will
-
	# persist the number of connections to each specified server. There may be		# persist the number of connections to each specified server. There may be
-
	# multiple defineServer lines.		# multiple defineServer lines.
-
-

	# Set both the username and password to 'None' (without the quotes) if your		# Set both the username and password to 'None' (without the quotes) if your
-
	# usenet server does not require authorization		# usenet server does not require authorization
-
-

	#Following is an example of a standard Usenet server		#Following is an example of a standard Usenet server
-
	defineServer(id = 'ChangeMe',		defineServer(id = 'ChangeMe',
-
	hosts = [ 'news.changeme.com:119' ],		hosts = [ 'news.changeme.com:119' ],
-

-
	username = 'user',		username = 'user',
-
	password = 'pass',		password = 'pass',
-
	#username = None, # no auth		#username = None, # no auth
-
	#password = None,		#password = None,
-
-

	connections = 4,		connections = 4,
-
	antiIdle = 4.5 * 60, # 4 minutes, 30 seconds, 0 to disable		antiIdle = 4.5 * 60, # 4 minutes, 30 seconds, 0 to disable
-
	#bindTo = '204.31.33.7', # connect FROM this ip address		#bindTo = '204.31.33.7', # connect FROM this ip address
-
	#enabled = False, # disable this server		#enabled = False, # disable this server
-
	#skipGroupCmd = False, # skip sending nntp GROUP commands		#skipGroupCmd = False, # skip sending nntp GROUP commands
-
	#fillserver = 0, # defaults to 0 (a main server).		#fillserver = 0, # defaults to 0 (a main server).
-
	# fillservers must have values > 0		# fillservers must have values > 0
-
	# (priority)		# (priority)
-
	ssl = False		ssl = False
-
	)		)
-
-

	#Following is an example of a Secure Usenet server		#Following is an example of a Secure Usenet server
-
	#defineServer(id = 'SecureMe',		#defineServer(id = 'SecureMe',
-
	# hosts = [ 'secure.news.changeme.com:443' ],		# hosts = [ 'secure.news.changeme.com:443' ],
-
	#		#
-
	# username = 'ssluser',		# username = 'ssluser',
-
	# password = 'sslpass',		# password = 'sslpass',
-
	# #username = None, # no auth		# #username = None, # no auth
-
	# #password = None,		# #password = None,
-
	#		#
-
	# connections = 4,		# connections = 4,
-
	# antiIdle = 4.5 * 60, # 4 minutes, 30 seconds, 0 to disable		# antiIdle = 4.5 * 60, # 4 minutes, 30 seconds, 0 to disable
-
	# #bindTo = '204.31.33.7', # connect FROM this ip address		# #bindTo = '204.31.33.7', # connect FROM this ip address
-
	# #enabled = False, # disable this server		# #enabled = False, # disable this server
-
	# #skipGroupCmd = False, # skip sending nntp GROUP commands		# #skipGroupCmd = False, # skip sending nntp GROUP commands
-
	# #fillserver = 0, # defaults to 0 (a main server).		# #fillserver = 0, # defaults to 0 (a main server).
-
	# # fillservers must have values > 0		# # fillservers must have values > 0
-
	# # (priority)		# # (priority)
-
	# ssl = True		# ssl = True
-
	# )		# )
-
-

	# Uncomment this line to limit all server connections to the specified KB/s		# Uncomment this line to limit all server connections to the specified KB/s
-
	# bandwidth		# bandwidth
-
	Hellanzb.MAX_RATE = 150 # limit to 150kB/s		Hellanzb.MAX_RATE = 150 # limit to 150kB/s
-
-
-


	# Important locations		# Important locations
-
	# Make sure the path mentioned in Hellanzb.PREFIX_DIR exists!		# Make sure the path mentioned in Hellanzb.PREFIX_DIR exists!
-
	Hellanzb.PREFIX_DIR = '/home/nzb/downloads/'		Hellanzb.PREFIX_DIR = '/home/nzb/downloads/'
-
-

	# Where to put queued .nzb files		# Where to put queued .nzb files
-
	Hellanzb.QUEUE_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.queue/'		Hellanzb.QUEUE_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.queue/'
-
-

	# Where the fully processed archives go		# Where the fully processed archives go
-
	Hellanzb.DEST_DIR = Hellanzb.PREFIX_DIR + 'completed_files/'		Hellanzb.DEST_DIR = Hellanzb.PREFIX_DIR + 'completed_files/'
-
-

	# The .nzb currently being downloaded is stored here		# The .nzb currently being downloaded is stored here
-
	Hellanzb.CURRENT_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.current/'		Hellanzb.CURRENT_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.current/'
-
-

	# The archive currently being downloaded is stored here		# The archive currently being downloaded is stored here
-
	Hellanzb.WORKING_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.inprogress/'		Hellanzb.WORKING_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.inprogress/'
-
-

	# Archives interrupted in the middle of downloading are stored here temporarily		# Archives interrupted in the middle of downloading are stored here temporarily
-
	Hellanzb.POSTPONED_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.postponed/'		Hellanzb.POSTPONED_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.postponed/'
-
-

	# Archives currently being processed. May contains archive directories, or		# Archives currently being processed. May contains archive directories, or
-
	# symbolic links to archive directories		# symbolic links to archive directories
-
	Hellanzb.PROCESSING_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.processing/'		Hellanzb.PROCESSING_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.processing/'
-
-

	# Temp storage		# Temp storage
-
	Hellanzb.TEMP_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.temp/'		Hellanzb.TEMP_DIR = Hellanzb.PREFIX_DIR + 'nzb/daemon.temp/'
-
-

	# Filename to store hellanzb state in between CTRL-Cs. The state (includes the		# Filename to store hellanzb state in between CTRL-Cs. The state (includes the
-
	# order of the queue, and smart par recovery information) is intermittently		# order of the queue, and smart par recovery information) is intermittently
-
	# written out as XML to this file		# written out as XML to this file
-
	Hellanzb.STATE_XML_FILE = Hellanzb.PREFIX_DIR + 'nzb/hellanzbState.xml'		Hellanzb.STATE_XML_FILE = Hellanzb.PREFIX_DIR + 'nzb/hellanzbState.xml'
-
-
-


	# _Sub directory within the nzb archive dir_ to move processed files to		# _Sub directory within the nzb archive dir_ to move processed files to
-
	Hellanzb.PROCESSED_SUBDIR = 'processed'		Hellanzb.PROCESSED_SUBDIR = 'processed'
-
-

	# Remove the PROCESSED_SUBDIR if the archive was successfully post processed.		# Remove the PROCESSED_SUBDIR if the archive was successfully post processed.
-
	# Warning: The normal Hellanzb.LOG_FILE should be enabled with this option --		# Warning: The normal Hellanzb.LOG_FILE should be enabled with this option --
-
	# for a record of what hellanzb deletes		# for a record of what hellanzb deletes
-
	Hellanzb.DELETE_PROCESSED = True		Hellanzb.DELETE_PROCESSED = True
-
-
-


	# Maximum amount of memory used to cache encoded Article data segments.		# Maximum amount of memory used to cache encoded Article data segments.
-
	# hellanzb will write article data to disk when this cache is exceeded		# hellanzb will write article data to disk when this cache is exceeded
-
	# Available settings:		# Available settings:
-
	# -1: Unlimited size		# -1: Unlimited size
-
	# 0: Disable cache (only cache to disk)		# 0: Disable cache (only cache to disk)
-
	# >0: Limit cache to this size, in bytes, KB, MB, e.g.:		# >0: Limit cache to this size, in bytes, KB, MB, e.g.:
-
	# 1024 '1024KB' '100MB' '1GB'		# 1024 '1024KB' '100MB' '1GB'
-
	#Hellanzb.CACHE_LIMIT = '2048KB'		#Hellanzb.CACHE_LIMIT = '2048KB'
-
-
-


	# Save archives into a sub directory of DEST_DIR named after their newzbin.com		# Save archives into a sub directory of DEST_DIR named after their newzbin.com
-
	# category (when queued using the enqueuenewzbin XMLRPC call); e.g. Apps,		# category (when queued using the enqueuenewzbin XMLRPC call); e.g. Apps,
-
	# Movies, Music		# Movies, Music
-
	Hellanzb.CATEGORIZE_DEST = False		Hellanzb.CATEGORIZE_DEST = False
-
-

	# Disable SMART_PAR (download all PAR files)		# Disable SMART_PAR (download all PAR files)
-
	#Hellanzb.SMART_PAR = False		#Hellanzb.SMART_PAR = False
-
-

	# Supply a path to the (un)rar command		# Supply a path to the (un)rar command
-
	Hellanzb.UNRAR_CMD = '/usr/local/bin/unrar'		Hellanzb.UNRAR_CMD = '/usr/local/bin/unrar'
-
-

	# Supply a path to the par2 command		# Supply a path to the par2 command
-
	Hellanzb.PAR2_CMD = '/usr/local/bin/par2'		Hellanzb.PAR2_CMD = '/usr/local/bin/par2'
-
-

	# Skip unraring during post processing		# Skip unraring during post processing
-
	#Hellanzb.SKIP_UNRAR = False		#Hellanzb.SKIP_UNRAR = False
-
-

	# Supply a path to the optional macbinconv command (for converting MacBinary		# Supply a path to the optional macbinconv command (for converting MacBinary
-
	# files)		# files)
-
	#Hellanzb.MACBINCONV_CMD = None		#Hellanzb.MACBINCONV_CMD = None
-
-

	# hellanzb inherits the umask from the current user's environment (unless it's		# hellanzb inherits the umask from the current user's environment (unless it's
-
	# running in daemon mode). The umask can be forced with this option		# running in daemon mode). The umask can be forced with this option
-
	#IMPT NOTE: Following mask works in CentOS. Default UMASK is 0022		#IMPT NOTE: Following mask works in CentOS. Default UMASK is 0022
-
	#Hellanzb.UMASK = 022		#Hellanzb.UMASK = 022
-
-
-


	# Supported music types (case insensitive) and optionally their decompression		# Supported music types (case insensitive) and optionally their decompression
-
	# executables		# executables
-
	# and the file type that executable will decompress to (case insensitive). The		# and the file type that executable will decompress to (case insensitive). The
-
	# exes must be in the PATH.		# exes must be in the PATH.
-
	#		#
-
	# <FILE> will be replaced with the name of music file		# <FILE> will be replaced with the name of music file
-
	# optional <DESTFILE> is <FILE> with the specified extension		# optional <DESTFILE> is <FILE> with the specified extension
-
	#		#
-
	# None means these files don't need to be decompressed		# None means these files don't need to be decompressed
-
	defineMusicType('wav', None, None)		defineMusicType('wav', None, None)
-
	defineMusicType('mp3', None, None)		defineMusicType('mp3', None, None)
-
	#defineMusicType('ape', 'mac <FILE> <DESTFILE> -d', 'wav')		#defineMusicType('ape', 'mac <FILE> <DESTFILE> -d', 'wav')
-
	#defineMusicType('flac', 'flac -d -- <FILE>', 'wav')		#defineMusicType('flac', 'flac -d -- <FILE>', 'wav')
-
	#defineMusicType('shn', 'shorten -x < <FILE> > <DESTFILE>', 'wav')		#defineMusicType('shn', 'shorten -x < <FILE> > <DESTFILE>', 'wav')
-
-

	# Max files we should decompress at the same time		# Max files we should decompress at the same time
-
	Hellanzb.MAX_DECOMPRESSION_THREADS = 2		Hellanzb.MAX_DECOMPRESSION_THREADS = 2
-
-
-


	# Enable Mac OS X Growl notifications		# Enable Mac OS X Growl notifications
-
	Hellanzb.GROWL_NOTIFY = False		Hellanzb.GROWL_NOTIFY = False
-
-

	# The growl notification server, in the format 'hostname'		# The growl notification server, in the format 'hostname'
-
	Hellanzb.GROWL_SERVER = 'IP'		Hellanzb.GROWL_SERVER = 'IP'
-
-

	# The growl password		# The growl password
-
	Hellanzb.GROWL_PASSWORD = 'password'		Hellanzb.GROWL_PASSWORD = 'password'
-
-
-


	# Enable libNotify Daemon notifications		# Enable libNotify Daemon notifications
-
	Hellanzb.LIBNOTIFY_NOTIFY = False		Hellanzb.LIBNOTIFY_NOTIFY = False
-
-
-


	# Disable ANSI color codes in the main screen (preserves the in place scroller)		# Disable ANSI color codes in the main screen (preserves the in place scroller)
-
	#Hellanzb.DISABLE_COLORS = False		#Hellanzb.DISABLE_COLORS = False
-
-

	# Disable ALL ANSI color codes in the main screen (for terminals that don't		# Disable ALL ANSI color codes in the main screen (for terminals that don't
-
	# support ANY ANSI codes		# support ANY ANSI codes
-
	#Hellanzb.DISABLE_ANSI = False		#Hellanzb.DISABLE_ANSI = False
-
-
-


	# Hostname for the XMLRPC client to connect to. By default, localhost		# Hostname for the XMLRPC client to connect to. By default, localhost
-
	# Do not change this		# Do not change this
-
	Hellanzb.XMLRPC_SERVER = 'localhost'		Hellanzb.XMLRPC_SERVER = 'localhost'
-
-

	# Port number the XML RPC server will listen on, and the client will connect to.		# Port number the XML RPC server will listen on, and the client will connect to.
-
	# Set to 'None' (without the quotes!) for no XML RPC server		# Set to 'None' (without the quotes!) for no XML RPC server
-
	# Following port is default for hellanzb. Change it to head off potential bot-attacks		# Following port is default for hellanzb. Change it to head off potential bot-attacks
-
	# hellanzb will listen on this port ON ALL IPS (incl. public facing ones)		# hellanzb will listen on this port ON ALL IPS (incl. public facing ones)
-
	Hellanzb.XMLRPC_PORT = 8760		Hellanzb.XMLRPC_PORT = 8760
-
-

	# Password for the XML RPC server. You might probably never use this, but the		# Password for the XML RPC server. You might probably never use this, but the
-
	# command line XML RPC calls do -- it should definitely be changed from its		# command line XML RPC calls do -- it should definitely be changed from its
-
	# default value. The XML RPC username is hardcoded as 'hellanzb' -- E.g. URL:		# default value. The XML RPC username is hardcoded as 'hellanzb' -- E.g. URL:
-
	# http://hellanzb:changeme@localhost:8760		# http://hellanzb:changeme@localhost:8760
-
	Hellanzb.XMLRPC_PASSWORD = 'changemenow'		Hellanzb.XMLRPC_PASSWORD = 'changemenow'
-
-
-


	# Username/Password to http://www.newzbin.com for automatic NZB downloading		# Username/Password to http://www.newzbin.com for automatic NZB downloading
-
	Hellanzb.NEWZBIN_USERNAME = 'newzbin'		Hellanzb.NEWZBIN_USERNAME = 'newzbin'
-
	Hellanzb.NEWZBIN_PASSWORD = 'password'		Hellanzb.NEWZBIN_PASSWORD = 'password'
-
-
-


	# If any of the following file types are missing from the archive and cannot be		# If any of the following file types are missing from the archive and cannot be
-
	# repaired, continue processing because they're unimportant (case insensitive)		# repaired, continue processing because they're unimportant (case insensitive)
-
	Hellanzb.NOT_REQUIRED_FILE_TYPES = [ 'log', 'm3u', 'nfo', 'nzb', 'sfv', 'txt' ]		Hellanzb.NOT_REQUIRED_FILE_TYPES = [ 'log', 'm3u', 'nfo', 'nzb', 'sfv', 'txt' ]
-
-

	# Don't get rid of (move into the PROCESSED dir) the following file types when		# Don't get rid of (move into the PROCESSED dir) the following file types when
-
	# finished post processing (case insensitive)		# finished post processing (case insensitive)
-
	#Hellanzb.KEEP_FILE_TYPES = [ 'log', 'm3u', 'nfo', 'nzb', 'sfv', 'txt' ]		#Hellanzb.KEEP_FILE_TYPES = [ 'log', 'm3u', 'nfo', 'nzb', 'sfv', 'txt' ]
-
	Hellanzb.KEEP_FILE_TYPES = [ 'nfo', 'txt' ]		Hellanzb.KEEP_FILE_TYPES = [ 'nfo', 'txt' ]
-
-
-


	# List of alternative file extensions matched as NZB files in the QUEUE_DIR.		# List of alternative file extensions matched as NZB files in the QUEUE_DIR.
-
	# The 'nzb' file extension is always matched		# The 'nzb' file extension is always matched
-
	#Hellanzb.OTHER_NZB_FILE_TYPES = [ 'xml' ]		#Hellanzb.OTHER_NZB_FILE_TYPES = [ 'xml' ]
-
-

	# Support extracting NZBs from ZIP files with this suffix (case insensitive) in		# Support extracting NZBs from ZIP files with this suffix (case insensitive) in
-
	# QUEUE_DIR. Defaults to '.nzb.zip'. Set to False to disable.		# QUEUE_DIR. Defaults to '.nzb.zip'. Set to False to disable.
-
	#Hellanzb.NZB_ZIPS = '.nzb.zip'		#Hellanzb.NZB_ZIPS = '.nzb.zip'
-
-

	# Support extracting NZBs from GZIP files with this suffix (case insensitive)		# Support extracting NZBs from GZIP files with this suffix (case insensitive)
-
	# in QUEUE_DIR. Defaults to '.nzb.gz'. Set to False to disable.		# in QUEUE_DIR. Defaults to '.nzb.gz'. Set to False to disable.
-
	#Hellanzb.NZB_GZIPS = '.nzb.gz'		#Hellanzb.NZB_GZIPS = '.nzb.gz'
-
-

	# Delay enqueueing new, recently modified NZB files added to the QUEUE_DIR until		# Delay enqueueing new, recently modified NZB files added to the QUEUE_DIR until
-
	# this many seconds have passed since the NZB's last modification time (defaults		# this many seconds have passed since the NZB's last modification time (defaults
-
	# to 10 seconds)		# to 10 seconds)
-
	#Hellanzb.NZBQUEUE_MDELAY = 10		#Hellanzb.NZBQUEUE_MDELAY = 10
-
-

	# Optional external handler script. hellanzb will run this script after post		# Optional external handler script. hellanzb will run this script after post
-
	# processing an archive, with the following arguments:		# processing an archive, with the following arguments:
-
	#		#
-
	# handler_script type archiveName destDir elapsedTime parMessage		# handler_script type archiveName destDir elapsedTime parMessage
-
	#		#
-
	# type: post processing result, either 'SUCCESS' or 'ERROR'		# type: post processing result, either 'SUCCESS' or 'ERROR'
-
	# archiveName: name of the archive, e.g. 'Usenet_Post5'		# archiveName: name of the archive, e.g. 'Usenet_Post5'
-
	# destDir: where the archive ended up, e.g. '/ext2/usenet/Usenet_Post5'		# destDir: where the archive ended up, e.g. '/ext2/usenet/Usenet_Post5'
-
	# elapsedTime: a pretty string showing how long post processing took, e.g.		# elapsedTime: a pretty string showing how long post processing took, e.g.
-
	# '10m 37s'		# '10m 37s'
-
	# parMessage: optional post processing message. e.g. '(No Pars)'		# parMessage: optional post processing message. e.g. '(No Pars)'
-
	# Hellanzb.EXTERNAL_HANDLER_SCRIPT = '~/bin/post_hellanzb.sh'		# Hellanzb.EXTERNAL_HANDLER_SCRIPT = '~/bin/post_hellanzb.sh'
-
	</code>		</code>
-
-

	You can also get a hellanzb.conf file directly on your VPS as follows:		You can also get a hellanzb.conf file directly on your VPS as follows:
-
	<code bash>		<code bash>
-
	cd /usr/etc		cd /usr/etc
-
	wget http://wiki.theaveragegeek.com/samples/hellanzb.conf		wget http://wiki.theaveragegeek.com/samples/hellanzb.conf
-
	</code>		</code>
-
-
-


	===== Working with hellanzb =====		===== Working with hellanzb =====
-
	It might not seem possible, but hellanzb boasts an interface even more spartan than rTorrent. hellanzb can be launched with the following command:		It might not seem possible, but hellanzb boasts an interface even more spartan than rTorrent. hellanzb can be launched with the following command:
-
	<code bash>/usr/bin/hellanzb.py</code>		<code bash>/usr/bin/hellanzb.py</code>
-
-

	Once hellanzb starts, you will see the following in your SSH session:		Once hellanzb starts, you will see the following in your SSH session:
-
-

	{{:howto:hellanzb-main.jpg\|}}		{{:howto:hellanzb-main.jpg\|}}
-
	~~CL~~		~~CL~~
-
	\\		\\
-
	In order to have hellanzb process nzb files, you need to place them in the "Hellanzb.QUEUE_DIR" folder (( That would be /home/nzb/usenet/nzb/daemon.queue/ if you used the sample hellanzb.conf from this wiki ))		In order to have hellanzb process nzb files, you need to place them in the "Hellanzb.QUEUE_DIR" folder (( That would be /home/nzb/usenet/nzb/daemon.queue/ if you used the sample hellanzb.conf from this wiki ))
-
-

	Unlike rTorrent, hellanzb ships with a "daemon" mode built-in, so you can start it as a service very easily by issuing the following command:		Unlike rTorrent, hellanzb ships with a "daemon" mode built-in, so you can start it as a service very easily by issuing the following command:
-
	<code bash>/usr/bin/hellanzb.py -D</code>		<code bash>/usr/bin/hellanzb.py -D</code>
-
-

	In order to see what hellanzb is currently doing, you can use the following command:		In order to see what hellanzb is currently doing, you can use the following command:
-
	<code bash>/usr/bin/hellanzb.py status</code>		<code bash>/usr/bin/hellanzb.py status</code>
-
-

	Let's now see how to add hellanzb to the list of services on startup.		Let's now see how to add hellanzb to the list of services on startup.
-
-

	===== Running hellanzb as a Service=====		===== Running hellanzb as a Service=====
-
	In order to launch hellanzb at startup, we use a process identical to the one used for [[howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps#running_rtorrent_as_a_service\|rTorrent]]. First, we create an entry in the init.d folder and then add a configuration file that the init.d script can read.		In order to launch hellanzb at startup, we use a process identical to the one used for [[howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps#running_rtorrent_as_a_service\|rTorrent]]. First, we create an entry in the init.d folder and then add a configuration file that the init.d script can read.
-
-

	These commands need to be executed while logged in as root		These commands need to be executed while logged in as root
-
-

	The configuration file can be created as follows:		The configuration file can be created as follows:
-
	<code bash>touch /etc/hellanzb.init.conf		<code bash>touch /etc/hellanzb.init.conf
-
	nano -w /etc/hellanzb.init.conf</code>		nano -w /etc/hellanzb.init.conf</code>
-
-

	Now copy and paste the following text into your hellanzb.init.conf file:		Now copy and paste the following text into your hellanzb.init.conf file:
-
	<code>		<code>
-
	##Start Configuration##		##Start Configuration##
-
	#Do not put a space on either side of the equal signs e.g.		#Do not put a space on either side of the equal signs e.g.
-
	# user = user		# user = user
-
	# will not work		# will not work
-
-

	# system user to run as		# system user to run as
-
	user="nzb"		user="nzb"
-
-

	# the full path to the filename where you store your hellanzb configuration		# the full path to the filename where you store your hellanzb configuration
-
	config="/usr/etc/hellanzb.conf"		config="/usr/etc/hellanzb.conf"
-
-

	# file to log to (makes for easier debugging if something goes wrong)		# file to log to (makes for easier debugging if something goes wrong)
-
	logfile="/home/nzb/hellanzbinit.log"		logfile="/home/nzb/hellanzbinit.log"
-
	</code>		</code>
-
-

	Save and exit. If you want, you can get the file directly on your server as follows:		Save and exit. If you want, you can get the file directly on your server as follows:
-
	<code bash>		<code bash>
-
	cd /etc		cd /etc
-
	wget http://wiki.theaveragegeek.com/samples/hellanzb.init.conf		wget http://wiki.theaveragegeek.com/samples/hellanzb.init.conf
-
	</code>		</code>
-
-
-


	Make sure to also create the logfile <code bash>touch /home/nzb/hellanzbinit.log</code>		Make sure to also create the logfile <code bash>touch /home/nzb/hellanzbinit.log</code>
-
-

	The next step is to create the entry in the init.d folder:		The next step is to create the entry in the init.d folder:
-
	<code bash>touch /etc/init.d/hellanzb		<code bash>touch /etc/init.d/hellanzb
-
	nano -w /etc/init.d/hellanzb		nano -w /etc/init.d/hellanzb
-
	</code>		</code>
-
-

	Add the following text to your rtorrent file in the init.d folder:		Add the following text to your rtorrent file in the init.d folder:
-
	<code>		<code>
-
	#!/bin/sh		#!/bin/sh
-
	#		#
-
	#############		#############
-
	###<Notes>###		###<Notes>###
-
	#############		#############
-
	# Licensed under the GPLv2 by average_geek: contact_at_theaveragegeek_dot_com		# Licensed under the GPLv2 by average_geek: contact_at_theaveragegeek_dot_com
-
	##############		##############
-
	###</Notes>###		###</Notes>###
-
	##############		##############
-
	#/etc/rc.d/init.d/hellanzb		#/etc/rc.d/init.d/hellanzb
-
	# chkconfig: 235 80 30		# chkconfig: 235 80 30
-
	# description: Run hellanzb as a Daemon service		# description: Run hellanzb as a Daemon service
-
	# processname: hellanzb		# processname: hellanzb
-
	# Source function library.		# Source function library.
-
	. /etc/rc.d/init.d/functions		. /etc/rc.d/init.d/functions
-
	# Source networking configuration.		# Source networking configuration.
-
	. /etc/sysconfig/network		. /etc/sysconfig/network
-
	#VARIABLES#		#VARIABLES#
-
	. /etc/hellanzb.init.conf		. /etc/hellanzb.init.conf
-
	PATH=/usr/bin:/usr/local/bin:/usr/local/sbin:/sbin:/bin:/usr/sbin		PATH=/usr/bin:/usr/local/bin:/usr/local/sbin:/sbin:/bin:/usr/sbin
-
	DESC="hellanzb daemon"		DESC="hellanzb daemon"
-
	NAME=hellanzb.py		NAME=hellanzb.py
-
	DAEMON=$NAME		DAEMON=$NAME
-
	SCRIPTNAME=/etc/init.d/$NAME		SCRIPTNAME=/etc/init.d/$NAME
-
	RETVAL=0		RETVAL=0
-
	lockfile=${LOCKFILE-/var/lock/subsys/hellanzb}		lockfile=${LOCKFILE-/var/lock/subsys/hellanzb}
-
-

	# Check that networking is up.		# Check that networking is up.
-
	[ ${NETWORKING} = "no" ] && exit 0		[ ${NETWORKING} = "no" ] && exit 0
-
-

	#Functions		#Functions
-
	checkconfig() {		checkconfig() {
-
	exists=0		exists=0
-
-

	for i in `echo "$PATH" \| tr ':' '\n'` ; do		for i in `echo "$PATH" \| tr ':' '\n'` ; do
-
	if [ -f $i/$NAME ] ; then		if [ -f $i/$NAME ] ; then
-
	exists=1		exists=1
-
	appdir=$i		appdir=$i
-
	apppath=$i/$NAME		apppath=$i/$NAME
-
	break		break
-
	fi		fi
-
	done		done
-
-

	if ! [ -x "$apppath" ] ; then		if ! [ -x "$apppath" ] ; then
-
	echo "cannot find executable hellanzb binary in PATH $appdir" \| tee -a "$logfile" >&2		echo "cannot find executable hellanzb binary in PATH $appdir" \| tee -a "$logfile" >&2
-
	exit 3		exit 3
-
	fi		fi
-

-
	if [ $exists -eq 0 ] ; then		if [ $exists -eq 0 ] ; then
-
	echo "cannot find hellanzb binary in PATH $PATH" \| tee -a "$logfile" >&2		echo "cannot find hellanzb binary in PATH $PATH" \| tee -a "$logfile" >&2
-
	exit 3		exit 3
-
	fi		fi
-
-

	if ! [ -r "${config}" ] ; then		if ! [ -r "${config}" ] ; then
-
	echo "cannot find readable config ${config}. check that it is there and permissions are appropriate" \| tee -a "$logfile" >&2		echo "cannot find readable config ${config}. check that it is there and permissions are appropriate" \| tee -a "$logfile" >&2
-
	exit 3		exit 3
-
	fi		fi
-
-

	dlpath=`getsession "$config"`		dlpath=`getsession "$config"`
-
	if ! [ -d "${dlpath}" ] ; then		if ! [ -d "${dlpath}" ] ; then
-
	echo "cannot find the download directory ${session} from config ${config}. check permissions" \| tee -a "$logfile" >&2		echo "cannot find the download directory ${session} from config ${config}. check permissions" \| tee -a "$logfile" >&2
-
	exit 3		exit 3
-
	fi		fi
-
	}		}
-
-

	getsession() {		getsession() {
-
-

	path=`awk '/^Hellanzb.PREFIX_DIR[[:space:]]=[[:space:]]/ { print $3 }' "$config"`		path=`awk '/^Hellanzb.PREFIX_DIR[[:space:]]=[[:space:]]/ { print $3 }' "$config"`
-
	trimpath=`echo $path \| sed -e s/\'//g`		trimpath=`echo $path \| sed -e s/\'//g`
-
	echo $trimpath		echo $trimpath
-
	}		}
-
-

	start() {		start() {
-
-

	[ -d "${base}" ] && cd "${base}"		[ -d "${base}" ] && cd "${base}"
-
-

	daemon `su -c "/usr/bin/hellanzb.py -D 2>&1 1>/dev/null" ${user} \| tee -a "$logfile" >&2`		daemon `su -c "/usr/bin/hellanzb.py -D 2>&1 1>/dev/null" ${user} \| tee -a "$logfile" >&2`
-
-

	RETVAL=$?		RETVAL=$?
-
	echo		echo
-
	[ $RETVAL -eq 0 ] && touch ${lockfile}		[ $RETVAL -eq 0 ] && touch ${lockfile}
-
-

	}		}
-
-

	stop() {		stop() {
-

-
	killproc $NAME		killproc $NAME
-

-
	RETVAL=$?		RETVAL=$?
-
	echo		echo
-
	[ $RETVAL -eq 0 ] && rm -f ${lockfile}		[ $RETVAL -eq 0 ] && rm -f ${lockfile}
-
-

	}		}
-
	#End Functions		#End Functions
-
	#Script		#Script
-
-

	checkconfig		checkconfig
-
-

	case "$1" in		case "$1" in
-
-

	start)		start)
-
	echo -n "Starting $DESC: $NAME"		echo -n "Starting $DESC: $NAME"
-
	start		start
-
	;;		;;
-
-

	stop)		stop)
-
	echo -n "Stopping $DESC: $NAME"		echo -n "Stopping $DESC: $NAME"
-
	stop		stop
-
	;;		;;
-
-

	restart\|force-reload)		restart\|force-reload)
-
	echo -n "Restarting $DESC: $NAME"		echo -n "Restarting $DESC: $NAME"
-
	stop		stop
-
	sleep 1		sleep 1
-
	start		start
-
	;;		;;
-
-

	*)		*)
-
	echo "Usage: $SCRIPTNAME {start\|stop\|restart\|force-reload}" >&2		echo "Usage: $SCRIPTNAME {start\|stop\|restart\|force-reload}" >&2
-
	exit 1		exit 1
-
	;;		;;
-
-

	esac		esac
-
-

	exit 0		exit 0
-
	</code>		</code>
-
	Now we need to make the hellanzb file executable:		Now we need to make the hellanzb file executable:
-
	<code bash>chmod 755 /etc/init.d/hellanzb</code>		<code bash>chmod 755 /etc/init.d/hellanzb</code>
-
-

	If you would like to skip copying and pasting text into your shell session, you can run the following commands instead:		If you would like to skip copying and pasting text into your shell session, you can run the following commands instead:
-
	<code bash>		<code bash>
-
	cd /etc/init.d/		cd /etc/init.d/
-
	wget http://wiki.theaveragegeek.com/samples/hellanzb.sh		wget http://wiki.theaveragegeek.com/samples/hellanzb.sh
-
	mv hellanzb.sh hellanzb		mv hellanzb.sh hellanzb
-
	chmod 755 /etc/init.d/hellanzb		chmod 755 /etc/init.d/hellanzb
-
	</code>		</code>
-
-
-


	Next we add hellanzb to the list of startup services:		Next we add hellanzb to the list of startup services:
-
	<code bash>chkconfig --add hellanzb</code>		<code bash>chkconfig --add hellanzb</code>
-
-

	Now you can start hellanzb using the following command:		Now you can start hellanzb using the following command:
-
	<code bash>/etc/init.d/hellanzb start</code>		<code bash>/etc/init.d/hellanzb start</code>
-
-

	If there are no problems with your configuration file, you should see the following:		If there are no problems with your configuration file, you should see the following:
-
	<xterm>		<xterm>
-
	[root@centos]# /etc/init.d/hellanzb start		[root@centos]# /etc/init.d/hellanzb start
-
	Starting hellanzb daemon: hellanzb.py [ OK ]		Starting hellanzb daemon: hellanzb.py [ OK ]
-
	</xterm>		</xterm>
-
-

	Verify that hellanzb is running with the following command:		Verify that hellanzb is running with the following command:
-
	<code bash>ps ax \| grep hellanzb</code>		<code bash>ps ax \| grep hellanzb</code>
-
-

	You should see the following:		You should see the following:
-
	<xterm>[root@centos]# ps ax \| grep hellanzb		<xterm>[root@centos]# ps ax \| grep hellanzb
-
	10084 ? Sl 0:00 /usr/bin/python /usr/bin/hellanzb.py -D		10084 ? Sl 0:00 /usr/bin/python /usr/bin/hellanzb.py -D
-
	10236 pts/1 R+ 0:00 grep hellanzb		10236 pts/1 R+ 0:00 grep hellanzb
-
	</xterm>		</xterm>
-
-

	===== What else can I do with hellanzb?=====		===== What else can I do with hellanzb?=====
-
-

	To learn how to add a WebUI/RSS capabilities to hellanzb, see the wiki article on [[howto:installing_hellanzb_addons_-_zussaweb_hellafox_and_hellavcr\|hellanzb addons]]		To learn how to add a WebUI/RSS capabilities to hellanzb, see the wiki article on [[howto:installing_hellanzb_addons_-_zussaweb_hellafox_and_hellavcr\|hellanzb addons]]
-
-

	The wiki article on [[howto:rtorrent_advanced_tasks\|Advanced options in rTorrent]] also includes a section on how to configure hellanzb to email you once a download completes.		The wiki article on [[howto:rtorrent_advanced_tasks\|Advanced options in rTorrent]] also includes a section on how to configure hellanzb to email you once a download completes.
-
-

	===== Other Tips=====		===== Other Tips=====
-
	==== Download files via FTP reliably ====		==== Download files via FTP reliably ====
-
	If you are using ProFTPD as your FTP server, you want to add the following line to your proftpd.conf file: (usually located in /etc)		If you are using ProFTPD as your FTP server, you want to add the following line to your proftpd.conf file: (usually located in /etc)
-
	<code>UseSendfile off</code>		<code>UseSendfile off</code>
-
-

	This is recommended as there are some issues with VPS kernels that can cause timeouts on large transfers - See [[http://www.proftpd.org/docs/howto/Sendfile.html\|this article]]		This is recommended as there are some issues with VPS kernels that can cause timeouts on large transfers - See [[http://www.proftpd.org/docs/howto/Sendfile.html\|this article]]
-
-

	==== Fixing the sudo error====		==== Fixing the sudo error====
-
	By now you would be familiar with this annoying problem every time you issue the sudo command:		By now you would be familiar with this annoying problem every time you issue the sudo command:
-
	<xterm>		<xterm>
-
	[user@centos ~]$ sudo su -		[user@centos ~]$ sudo su -
-
	Password:		Password:
-
	audit_log_user_command(): Connection refused		audit_log_user_command(): Connection refused
-
	</xterm>		</xterm>
-
-

	This is actually due to a bug in the version of sudo that ships with Red Hat. You can check out [[http://ping.hostvelocity.com/2009/02/centos-sudo-error-connection-refused/\|this blog post]] for instructions on how to upgrade your version of sudo which will fix this annoying error message.		This is actually due to a bug in the version of sudo that ships with Red Hat. You can check out [[http://ping.hostvelocity.com/2009/02/centos-sudo-error-connection-refused/\|this blog post]] for instructions on how to upgrade your version of sudo which will fix this annoying error message.
-
	===== SAFE USAGE=====		===== SAFE USAGE=====
-
	Copyright laws and laws pertaining to patents and inventions protect original works of authorship and inventions. Individuals who reproduce, distribute copies, receive copies, publicly perform or display works or inventions other than their own and without the consent of the owners or holders of rights, or their authorized agents, in original works of authorship or inventions, may be		Copyright laws and laws pertaining to patents and inventions protect original works of authorship and inventions. Individuals who reproduce, distribute copies, receive copies, publicly perform or display works or inventions other than their own and without the consent of the owners or holders of rights, or their authorized agents, in original works of authorship or inventions, may be
-
	in violation of copyright, patent or other intellectual property infringement. The authors and contributors of this article do not encourage or condone the illegal copying of copyrighted material. This is not intended to be legal counsel or advice. If you have any questions, consult your attorney. (( Taken directly from the hellanzb README at http://www.hellanzb.com/trac/hellanzb/browser/trunk/README ))		in violation of copyright, patent or other intellectual property infringement. The authors and contributors of this article do not encourage or condone the illegal copying of copyrighted material. This is not intended to be legal counsel or advice. If you have any questions, consult your attorney. (( Taken directly from the hellanzb README at http://www.hellanzb.com/trac/hellanzb/browser/trunk/README ))
-
	===== TODO=====		===== TODO=====
-
	- Fix the inevitable spelling errors/bugs in this article?		- Fix the inevitable spelling errors/bugs in this article?
-

1278236042		current
Line 102:		Line 102:

	DocumentRoot /usr/lib/cgi-bin/		DocumentRoot /usr/lib/cgi-bin/
		+	#Compression Directives
		+	AddOutputFilterByType DEFLATE application/x-perl
		+	#Additional Compression Directives
		+	BrowserMatch \bMSIE\s(7\|8) !no-gzip !gzip-only-text/html #This will need to be modified everytime a new IE version is released
		+	#Following Directives ensure mod_deflate is not used for binary file types
		+	SetEnvIfNoCase Request_URI \.(?:gif\|jpe?g\|png)$ no-gzip dont-vary
		+	SetEnvIfNoCase Request_URI \.(?:exe\|t?gz\|zip\|bz2\|sit\|rar)$ no-gzip dont-vary
		+	SetEnvIfNoCase Request_URI \.pdf$ no-gzip dont-vary
		+	SetEnvIfNoCase Request_URI \.avi$ no-gzip dont-vary
		+	SetEnvIfNoCase Request_URI \.mov$ no-gzip dont-vary
		+	SetEnvIfNoCase Request_URI \.mp3$ no-gzip dont-vary
		+	SetEnvIfNoCase Request_URI \.mp4$ no-gzip dont-vary
		+	SetEnvIfNoCase Request_URI \.rm$ no-gzip dont-vary
		+
		+	<Directory /usr/lib/cgi-bin/>
		+	AllowOverride AuthConfig
		+	Order allow,deny
		+	Allow from all
		+	Options +ExecCGI +Indexes
		+	DirectoryIndex gitweb.cgi
		+	SetEnv GITWEB_CONFIG "/etc/gitweb.conf"
		+	AddType application/x-perl .cgi
		+	AddHandler cgi-script .cgi
		+	RewriteEngine On
		+	RewriteCond %{REQUEST_FILENAME} !-f
		+	RewriteCond %{REQUEST_FILENAME} !-d
		+	RewriteRule ^.* /gitweb.cgi/$0 [L,PT]
		+	</Directory>

-	<Directory /usr/lib/cgi-bin/>
-	AllowOverride AuthConfig
-	Options +ExecCGI +Indexes
-	Order allow,deny
-	Allow from all
-	DirectoryIndex gitweb.cgi
-	SetEnv GITWEB_CONFIG "/etc/gitweb.conf"
-	AddType application/x-perl .cgi
-	AddHandler cgi-script .cgi
-	RewriteEngine On
-	RewriteCond %{REQUEST_FILENAME} !-f
-	RewriteCond %{REQUEST_FILENAME} !-d
-	RewriteRule ^.* /gitweb.cgi/$0 [L,PT]
-	#Compression Directives
-	AddOutputFilterByType DEFLATE application/x-perl
-	#Additional Compression Directives
-	BrowserMatch \bMSIE\s(7\|8) !no-gzip !gzip-only-text/html #This will need to be modified everytime a new IE version is released
-	#Following Directives ensure mod_deflate is not used for binary file types
-	SetEnvIfNoCase Request_URI \.(?:gif\|jpe?g\|png)$ no-gzip dont-vary
-	SetEnvIfNoCase Request_URI \.(?:exe\|t?gz\|zip\|bz2\|sit\|rar)$ no-gzip dont-vary
-	SetEnvIfNoCase Request_URI \.pdf$ no-gzip dont-vary
-	SetEnvIfNoCase Request_URI \.avi$ no-gzip dont-vary
-	SetEnvIfNoCase Request_URI \.mov$ no-gzip dont-vary
-	SetEnvIfNoCase Request_URI \.mp3$ no-gzip dont-vary
-	SetEnvIfNoCase Request_URI \.mp4$ no-gzip dont-vary
-	SetEnvIfNoCase Request_URI \.rm$ no-gzip dont-vary
-	</Directory>
	</VirtualHost>		</VirtualHost>
	</code>		</code>

The Average Geek's Wiki howto

howto:installing_rtorrent_addons_-_wtorrent_and_flexget

howto:installing_rtorrent_and_hellanzb_on_centos5_64-bit_vps

howto:publish_gitweb_with_nginx_reverse-proxying_for_apache