RTMix
<< | 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:

Since I am not sure how often the other two sources update their packages (although, from what I heard both of them are rather prompt about it), the safest assumption is that the most up-to-date version will be usually available on my own website (first option).

 

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) Configure the makefiles by doing:

./configure

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

make

5) 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 "6", it will fail because you do not have permissions to write to the destination directories.

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

rtmix

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. If such is the case, simply use your 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 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 | >>