<< | table of contents | >>

2. Installation

The second chapter will provide you with a quick overview of how to obtain and install RTMix on your machine.


2.1 Obtaining RTMix

RTMix is currently available in following formats/locations:


2.2 Requirements

In order to have RTMix up-and-running, you will need the following:


2.3 Installation

Installation should be rather straightforward. Please use shell to do the following:

1) First you need to decompress the downloaded tarball by typing:

tar -zxvf rtmix-<version>.tar.gz

This will create a folder in the current location with the name "RTMix-<version>"

2) Go to the newly created folder by typing

cd RTMix-<version>

3) Make sure that there are no leftover binaries, .moc files, and other compiled objects by doing:

make distclean

IMPORTANT: if you encounter any errors at this point, simply disregard them -- they simply mean that the source tree is already clean.

4) Configure the makefiles by doing:


5) If everything went well you should now have makefiles ready, so type:


6) After everything has been compiled, as a SUPERUSER (root) simply type:

make install

This will install all files into appropriate folders. If you are not a superuser and try to do the step "5", it will fail because you do not have permissions to write to the destination directories.

7) Now you are ready to start RTMix by typing:


This should work from any location. You might even want to create a shortcut in the start-up menu of your favorite desktop environment (shortcut should be linked directly to the binary, i.e. "/usr/local/bin/rtmix").


2.4 Troubleshooting

Most problems will arise from the step "3". If such is the case, check the error. It will usually state that you are missing a particular library or a development tool. Simply use your Linux install cd's and install appropriate packages (i.e. if your configure script reports an error that you are missing -libjpeg, simply go look for a jpeg library on your install cd's or online, one of possible sources would be http://rpmfind.net/ RPM repository). After installing the packages you can simply re-run the step "3".

Other issues might arise if you don't have the rtmix binary available. First check any build errors (this should not happen, but due to vastly varying Linux distributions, just about anything is possible), then go to the install directory, and make sure that your binary does not have a different name (i.e. go to /usr/local/bin/ directory and find rtmix there by typing:

ls *rtmix*

Sometimes the binary gets a funny name like i386-linux-rtmix (usually due to use of some flags at configure-time), in which case you need to rename it to "rtmix" by simply typing (as a SUPERUSER):

mv i386-linux-rtmix rtmix

That ought to do it.

If you encounter any other problems, the best thing is to simply contact me, or (even better) post the question on the RTMix forum (http://meowing.ccm.uc.edu/cgi-bin/ico/yabb/YaBB.cgi?board=Rtmix_id) -- this way your problem (and potentially its resolution) will be available for others to see and will help minimize redundant questions. Furthermore it will help generate a kind of an online RTMix FAQ.

<< | table of contents | >>