Category Archives: Nexenta

Installing rTorrent on Illumian

Illumian is the successor to the open source Nexenta Core Platform. It’s an operating system that combines the power of OpenSolaris with the ease of Debian/Ubuntu’s Avanced Packaging Tool (apt).

I used to use NCP, but hadn’t messed with it in a long time. I’m trying out Illumian, and one of the things I need is a torrent client. The excellent rTorrent client is perfect for a bare-bones server. It took several hours to figure out how to get rTorrent built and running on Illumian. Now, I present the instructions to the web at large in hopes that others can make use of them.

Guide Steps
This guide is divided into the following steps.

  1. Install Dependencies
  2. Download Files/Patches
  3. Install libsigc++
  4. Install CPPUnit
  5. Prepare Environment
  6. Install libTorrent
  7. Install rTorrent

Note on formatting: Due to the blog’s style, some of the lines in the preformatted text blocks are chopped off. In order to get these lines, you can just triple click to highlight the entire line. Then just copy + paste it.

Install Dependencies

We need a number of programs and dependencies from the Illumian apt repositories. Note the \ at the end of each line, indicating that this is a single line to be pasted into bash.

sudo apt-get install system-header developer-build-autoconf text-gnu-patch \
developer-build-make developer-build-gnu-make \
developer-build-automake-110 developer-build-libtool \
developer-build-autoconf text-gnu-patch \
developer-gcc-44 system-library-math-header-math

Note: We must use GCC 4.4, as 4.5 and 4.6 seem to be missing bootstrap libraries (ctr1.o, etc).

Several dependencies will be coming from OpenCSW’s pkgutil because the Illumian repositories are either missing these dependencies, or they don’t work correctly. We need to install pkgutil and download some more dependencies.

# pkgadd -d
# pkgutil -y -i pkgconfig openssl xmlrpc_c libcurl_dev libncurses_dev

The path must be set properly as well:

export PATH=/opt/csw/bin/:/usr/gcc/4.4/bin/:/usr/gnu/bin/:$PATH

Download Files/Patches

Now, to download all of the files. We have to download some final dependencies, as well as libTorrent and rTorrent themselves.

Note: This article is written with specific versions of rTorrent, libTorrent, and their dependencies in mind. To get more up-to-date versions of the above files, visit the following sites:

Solaris Patches
We will also need the Solaris-specific patches for these dependencies. They are available as a download. They can also be downloaded individually (see Sources at the bottom). The patches will need to be extracted.

tar xvf rtorrent-solaris-patches.tar

Install libsigc++

First, libsigc++ must be installed. This is a dependency required by rTorrent. OpenCSW has the current version of this library, but rTorrent does not seem to like it.

tar xjvf libsigc++-2.2.10
cd libsigc++-2.2.10/
./configure --prefix=/opt/csw
sudo make install

Install CPPUnit

CPPUnit is a unit testing framework that is apparently required to build libTorrent (and probably rTorrent). To install it, follow these steps.

tar zxvf cppunit-1.12.1
cd cppunit-1.12.1/
cp ../rtorrent-solaris-patches/cppunit.patch .
patch -p1 < cppunit.patch
./configure --prefix=/opt/csw
sudo make install

Set Up Environment

We must prepare the shell environment for building libTorrent and rTorrent. This will force the build process to use the OpenCSW and locally-installed dependencies, as well as the GNU linker, which are all required for building.

export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"
export PKG_CONFIG_PATH=/opt/csw/lib/pkgconfig/:/usr/local/lib/pkgconfig/:/usr/lib/pkgconfig/
export LD_LIBRARY_PATH=/opt/csw/lib:/usr/local/lib/:/usr/lib/
export LD_ALTEXEC=/opt/csw/bin/gld

Install libTorrent

Next, we build and install libTorrent.

export CFLAGS="-std=c99"
tar zxvf libtorrent-0.12.9.tar.gz
cd libtorrent-0.12.9/
cp ../rtorrent-solaris-patches/libtorrent.patch .
patch -p1 < libtorrent.patch
./configure --prefix=/opt/csw
sudo make install

Install rTorrent

Finally, we can install rTorrent.

tar zxvf rtorrent-0.8.9.tar.gz
cd rtorrent-0.8.9/
export CPPFLAGS="-march=i686 -I /opt/csw/include -I /opt/csw/include/ncurses -I /usr/local/include"
export LDFLAGS="-lncurses"
cp ../rtorrent-solaris-patches/rtorrent.patch .
patch -p1 < rtorrent.patch
./configure --prefix=/opt/csw --with-xmlrpc-c=/opt/csw/bin/xmlrpc-c-config
sudo make install


After building and installing rTorrent, it will be located at /usr/local/bin/rtorrent. A sample config file (rtorrent.rc) will be located in the doc/ of the downloaded soure code. Consult the user guide and the Arch Wiki for information on creating a good .rtorrent.rc file.


This guide was compiled from a lot of my own trial and error, as well as help from these sources. The patches as well as a bit of extra helpful information came from these places.

Fixing Nexenta Zones: Update

According to Comment #10 on Nexenta bug 203, some of the more glaring problems with Zones in Nexenta have been fixed in version 3.0.1. The most tedious fixes have been put in place. The only thing necessary to do now is simply dpkg-reconfigure sunwcsd once the zone is installed. I also did a reimport of sysevent.xml. It seems to be necessary (at least on my dist-upgraded system). In order to do the reconfiguring, you will need to be in maintenance mode. The zone should already have dropped into maintenance mode to begin with, so just zlogin and do the reconfigure. After that you will need to reboot the zone. Everything should then be working correctly. To get Nexenta 3.0.1, either dist-upgrade your existing system, or download the ISO from here.

Fixing Nexenta Zones

Update: Some of the bugs in this post have been fixed, rendering a lot of the steps unnecessary. If you are running the latest version of Nexenta (3.0.1), you should only need to perform the last steps, where you dpkg-reconfigure sunwcsd and reimport the sysevent.xml file. See the new post for more details.

There is a nasty bug in Nexenta 3.0 that causes zones to function improperly. Services such as SSH are broken, packages may not install properly, etc. This is caused by a missing sysidtool, and a missing sysevent service. Two fix this problem, a few steps are required. First, in the global zone, you must edit /usr/bin/createzone and make the following changes:

1. Replace elatte-unstable with hardy-unstable. This should be found around line 41, in the default_config() subroutine.
2. Update the @source_files array as follows:

my @source_files = qw(

You are simply changing “elatte” to “nexenta” here.

Now, go through the normal zone creation process. If you don’t know how to do that, see here for a decent tutorial. The zone creation process should go off without a hitch, and sysidtool should install properly. Without our fixes, you would probably see an error that looks something like this.

There are still two more steps to be done. We must log in to the zone, but regular zlogin will not work until we fix another small bug. Boot the zone with “zoneadm -z yourZone boot”, then log in with “zlogin -S yourZone” instead of the normal zlogin. This will bring us to maintenance mode. Run pwconv:

zoneadm -z yourZone boot
zlogin -S yourZone

[In yourZone]

After this, regular zlogin should work. Now, we need to get the sysevent service working. Many services depend on this service. Without it, all of them will fail to start. To fix this, edit (from within the zone) the /lib/svc/method/svc-syseventd.

After the line . /lib/svc/share/ put
add [ `zonename` = global ] || sleep 3600 & exit 0

When finished, your zone’s /lib/svc/method/svc-syseventd file should look something like this. The bolded line is the one you added.

# CDDL Header
# ...

. /lib/svc/share/
[ `zonename` = global ] || sleep 3600 & exit 0

case "$1" in
	/usr/lib/sysevent/syseventd >/dev/msglog 2>&1
	if [ $rc -ne 0 ]; then
		echo "WARNING: /usr/lib/sysevent/syseventd failed: exit status $rc"

# devfsadmd and syseventconfd are started on-demand
# by syseventd. syseventd should be stopped before devfsadm and syseventconfd.
	/usr/bin/pkill -x -u 0 -P 1 -z $zone rcm_daemon
	/usr/bin/pkill -x -u 0 -P 1 -z $zone syseventd
	/usr/bin/pkill -x -u 0 -P 1 -z $zone devfsadm
	/usr/bin/pkill -x -u 0 -P 1 -z $zone syseventconfd

	# Since pkill is not atomic (may miss forking processes), also
	# kill entire service contract.
	smf_kill_contract $2 TERM 1
	[ $? -ne 0 ] && exit 1

	echo "Usage: $0 { start | stop }"
	exit 1

exit 0

Finally, you will need to enter two more commands as the super-user:

dpkg-reconfigure sunwcsd
svccfg import /var/svc/manifest/system/sysevent.xml

Exit the zone and reboot it. Log in again, and everything should be magically working!

This information was compiled from several Nexenta bug reports (203, 173, LP #347937) after I ran into problems getting SSH working in my new zone. Apparently, the problems are bigger than SSH. I can’t take credit for discovering these fixes.