Author Archives: rei

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 http://get.opencsw.org/now
# 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
make
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
make
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
make
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
make
sudo make install

Finishing

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.

Sources

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.

How to open mms:// links from Chrome under Ubuntu

By default, Chrome will not launch mms:// (Windows Media streaming) links under Linux. It invokes xdg-open to “launch the user’s preferred application.” Under Ubuntu, xdg-open doesn’t handle mms:// links either.

Three steps:
1. Install mplayer and your choice of frontend (smplayer, gnome-mplayer)
2. Create a desktop entry for mms links.
3. Edit a configuration file to tie it all together.

Create a file named mms.desktop in ~/.local/share/applications/:

[Desktop Entry]
Name=Mplayer
Exec=smplayer %u
Type=Application
Icon=gnome-mplayer-icon
Terminal=false
MimeType=x-scheme-handler/mms;

Edit the mimeapps.list file in the same directory and add the following to the bottom of the [Default Applications] section:

x-scheme-handler/mms=mms.desktop

After this is done, you should be able to open mms:// links from Chrome. The link will open in the application you specified in the Exec entry in the desktop file.

New blog: agnos.is

I have created a new blog, agnos.is. The name is a domain hack for the word “agnosis.” If gnosis means “knowledge,” then agnosis means “no knowledge.” The word “agnostic” derives from agnosis. In this case, the name is a nod to the idea that this new blog is about discovering new things and learning new technologies. It focuses mostly on NodeJS, but will also focus on other programming languages and technologies.

agnos.is is built on a bunch of new and exciting technologies: Node, Redis, markdown, and cloud computing. The site is written entirely in server-side Javascript, using Express and a bunch of other NPM packages. It is hosted on the Rackspace Cloud, which allows far more control over the environment than a “traditional” web host, like the one this site runs on. It’s also a lot faster. Thermetics’ web host has always been slow for some reason.

agnos.is won’t replace thermetics.net, at least not yet. Thermetics has been around for many years, and though I never really did much with the domain except use it as personal storage, it is still high up in Google’s rankings, and has even been linked to by a few other websites. Thermetics will be a random useful tips blog for awhile longer. I may mirror posts between the two. I haven’t decided.

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(
        /lib/svc/method/nexenta-sysidtool-system
        /var/svc/manifest/system/nexenta-sysidtool.xml
        /lib/svc/method/nexenta-sysidtool-net
        );

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]
pwconv
exit

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/smf_include.sh 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/smf_include.sh
[ `zonename` = global ] || sleep 3600 & exit 0

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

#
# devfsadmd and syseventconfd are started on-demand
# by syseventd. syseventd should be stopped before devfsadm and syseventconfd.
#
'stop')
	zone=`smf_zonename`
	/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
	;;

esac
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.

jyn: Simple Native Code Access in Jython

I had been wanting to mess around with native code access in Java for awhile. I’ve also been delving fairly deep into Jython, mostly out of necessity for RingMUD. So, I decided to combine these two ideas, and started work on a simple library similar to ctypes. Jython does not have a working ctypes implementation yet, but it is coming along. This was mostly for my own experimentation to learn a bit more Python as well as experiment with JNA (Java Native Access).

JNA is the much simpler alternative to JNI. In normal Java, you define an interface that corresponds to the function prototypes of the native library you want to access. You then create a new “instance” of the library by calling JNA’s special gateway method. From that point on, you can call the defined functions of the library.

The nice thing about Python is that it is a dynamic language. By overriding __getattr__ and friends, and using JNA’s reflection API, it becomes possible to have Jython lazily load the function references and call them in a much more intuitive way. The name of this simple library is jyn (No, no alcohol was involved in the creation of this library).

An example:

import jyn
lib = jyn.libc() #Load libc for Windows or Unix
printf = lib.printf
printf("Hello world! I am printing from Jython!\n")

jyn is not really suitable for production environments yet. The most glaring problem at the moment is that there is no argument checking. This means that passing wrong arguments to a native function will usually crash the JVM. I am definitely open to more experienced Python developers willing to improve the library.

jyn is intended mainly as a demonstration of what is possible with Java and Jython. The Java platform brings with it a large selection of powerful libraries, and Jython brings the dynamic power of Python. Combined, they are an unbeatable team.

Grab jyn from GitHub.

Mutliple Events with Jython Event Properties


At first glance, Jython event properties seem magical–almost too magical. They allow you to bypass the massive Java boilerplate required to set up event listeners. What is normally something along these lines:

public class Test extends JFrame {
    private JButton button;

    public Test() {
         super("A Frame");
         setSize(200, 200);
         setupEvents();
         setVisible(true);
    }

    public void setupEvents() {
          button = new JButton("Click me");
          button.addActionListener(new ActionListener() {
                @Override
                public void actionPerformed(ActionEvent e) {
                      System.out.println("Button pressed");
                }
          });

         this.add(button);
    }
}

Instead becomes something like this, when using Jython:

class Test(JFrame):
    def __init__(self):
        JFrame.__init__(self, "A Frame")
        button = JButton("Hello", actionPerformed=self.buttonPress)

        self.add(button)
        self.setSize(200, 200)
        self.visible = true

    def buttonPress(self, event):
        print "Button pressed"

if __name__=="__main__":
    Test()

The Python version of this is far briefer and much more compact than its Java counterpart. That’s all well and good, you say, but what if you want to add multiple event handlers? At first glance, it does not look like Jython’s event properties would allow for such a thing. Luckily, it is possible. However, it is not documented. Indeed, documentation of Jython’s Java API and specialized features is a bit … lacking.

This undocumented feature was discovered after some chatting in the Jython IRC channel, and a bit of experimentation. It turns out that the event properties are actually an object type called CompoundCallable. These objects, as their name implies, store a set of functions that are executed one after another in sequence when called. Observe:

class Test(JFrame):
    def __init__(self):
        JFrame.__init__(self, "Hello Jython")
        button = JButton("Hello")
        button.actionPerformed = self.hello
        button.actionPerformed.append(self.otherEvent)
        self.add(button)

        self.setSize(200, 200)
        self.visible = true

    def hello(self, event):
        print "Hello, world!"

    def otherEvent(self, event):
        print "this is the other event"

if __name__=="__main__":
      Test()

When the button is clicked, both the “hello” and “otherEvent” functions will execute. Any Jython event property (including ones you create yourself) has two useful methods: append() and clear(). They do what their names say. The append method takes a function as a parameter, and adds it to the list of functions to be executed. The clear() methods clears all the functions out of the property.

Unfortunately, there do not appear to be ways to iterate over the functions contained within the CompoundCallable, or access specific event handlers directly. In a similar vein, you cannot delete individual event handlers out of the CompoundCallable. Your only option is the clear() method.

The source code for the PyCompoundCallable object is very simple. It doesn’t look like it would be too hard to add some more methods for getting and deleting specific event handlers. (Scroll way down to the bottom of that page to view the code.)

Internet Explorer 6 Disappearing Images and Text

There is a strange bug in Internet Explorer 6 that causes images or text to disappear. This generally happens if there are floated elements within the element that is disappearing. This website (see #3) shows that by putting position: relative into the CSS style for the element that is disappearing, it will once again cause everything inside it to show up. Very strange.

Install Greasemonkey Scripts in Chromium the Easy Way

Simple tip: You want to install a Greasemonkey user script that isn’t hosted on www.userscripts.org. Or, you have the script residing on your hard drive and you want to install it from there. If you open the .js file directly in the browser, Chromium (I’m assuming Chrome will do the same) will pick it up as a script and install it.

MiXer Library: mixins in JavaScript

Mixins in JavaScript certainly aren’t a new idea. However, I noticed a lack of libraries for implementing this pattern. JavaScript libraries like Dojo allow the developer to create something akin to traditional classes. Such a thing is an unnatural pattern for the language. It doesn’t have any base support for classical OOP, so the libraries have to implement tricky functions to mimic inheritance. Even these functions have their limits though.

Mixins are another way to do inheritance in JavaScript. It can be a radical departure from the “regular” inheritance model that many developers are used to. However, once one wraps their brain around it, one may find that it’s a good pattern, and perhaps even a better one for JavaScript. As always, the nature of the system should determine what kind of development patterns are used. This is just one more way of doing it. Check out MiXer to learn more.