This guide is meant to show you how to set up FahMon in Linux. I'll be using Ubuntu for this example because I'm familiar with it and I know that a lot of people use it. Even though I'll be using Ubuntu this guide can be easily transferred for use in many other Linux distro's.
I've decided to split this guide into three parts. Part 1 will have all of the prerequisite info, Part 2 will be the actual installation and set up of FahMon, and Part 3 will have some tips other helpful info.
**Part 1: Prerequisites**
Open up a Terminal and paste the following into it. Hit enter and that should download everything you need to install FahMon.
**Part 2: Setting up and installing FahMon**
Download FahMon to your home folder from here: http://www.fahmon.net/downloads/current.php?linux
Once the download is finished you need to extract the files. Double click the file to open it up, then proceed to extract the files to your specified destination.
After the files are finished extracting you should see a new folder in your Home folder called FahMon-2.3.4. It should look like this:

Next we need to compile the source for FahMon. To do this go back to your terminal and type "cd FahMon-2.3.4" This will navigate you to the FahMon folder that we just created.

Now type "./configure" and hit enter. If you get an error make sure that you've installed all of the prerequisite packages as stated above. If you didn't get any errors then you should see this:

Once that is done type "make". Again if you get any errors check if you've got everything installed correctly. Here is what it should look like when done:

After that we need to type "sudo make install". It will ask for your password, type the password that you use when you log in. Hit enter and it will begin the install process. It will take a little while to finish.

When that is done type
Then close down your terminal and reboot your machine. After the reboot go to Applications>System Tools>FahMon.
FahMon will pop up and you'll see this screen:

Right click on the white area to the left. Click "Add new client". You should then see this small box pop up:

Enter a name for your client. I choose "SMP" because I'm using the Linux SMP client. Then point FahMon to your Folding@Home install. It should be something like /home/username/folding.

After that hit enter and you should see your client's progress displayed up top.

Congratulations! You've just successfully installed FahMon on Ubuntu. Now just sit back, relax and watch as you rake in the points.
**Part Three: Tips, tricks and helpful info**
FahMon show my clients as "Hung"
If FahMon shows your clients as "Hung" then there are a couple things you can do to try and fix it. First let's explain why your getting the "Hung" status. If the machine running FahMon doesn't have the same time as another machine that it's monitoring then FahMon won't know what to do and sets them to the 'Hung' state.
You can possibly fix this by turning Ignore Asynchronous Clocks on (FahMon>Prefrences>Monitoring>Ignore Asynchronous Clocks) then it will ignore the time difference and it should be good. FahMon will change the status color from yellow to blue. You could also manually synchronize the clocks on the different computers to the same time.
Please, if you've got any comments, questions or concerns leave a post in this thread.
8/31/2008: Title change, spelling errors fixed
9/1/2008: Fixed broken screen shots
9/8/2008: Updated screens
11/28/2009: Refined prerequisite section, added info to post-installation process
Edited by Roke - 11/28/09 at 9:42pm
I've decided to split this guide into three parts. Part 1 will have all of the prerequisite info, Part 2 will be the actual installation and set up of FahMon, and Part 3 will have some tips other helpful info.
**Part 1: Prerequisites**
Open up a Terminal and paste the following into it. Hit enter and that should download everything you need to install FahMon.
Code:
sudo apt-get install g++ libwxgtk2.8-dev libcurl3 libcurl4-openssl-dev
Download FahMon to your home folder from here: http://www.fahmon.net/downloads/current.php?linux
Once the download is finished you need to extract the files. Double click the file to open it up, then proceed to extract the files to your specified destination.
After the files are finished extracting you should see a new folder in your Home folder called FahMon-2.3.4. It should look like this:

Next we need to compile the source for FahMon. To do this go back to your terminal and type "cd FahMon-2.3.4" This will navigate you to the FahMon folder that we just created.

Now type "./configure" and hit enter. If you get an error make sure that you've installed all of the prerequisite packages as stated above. If you didn't get any errors then you should see this:

Once that is done type "make". Again if you get any errors check if you've got everything installed correctly. Here is what it should look like when done:

After that we need to type "sudo make install". It will ask for your password, type the password that you use when you log in. Hit enter and it will begin the install process. It will take a little while to finish.

When that is done type
Code:
sudo ldconfig
FahMon will pop up and you'll see this screen:

Right click on the white area to the left. Click "Add new client". You should then see this small box pop up:

Enter a name for your client. I choose "SMP" because I'm using the Linux SMP client. Then point FahMon to your Folding@Home install. It should be something like /home/username/folding.

After that hit enter and you should see your client's progress displayed up top.

Congratulations! You've just successfully installed FahMon on Ubuntu. Now just sit back, relax and watch as you rake in the points.
**Part Three: Tips, tricks and helpful info**
FahMon show my clients as "Hung"
If FahMon shows your clients as "Hung" then there are a couple things you can do to try and fix it. First let's explain why your getting the "Hung" status. If the machine running FahMon doesn't have the same time as another machine that it's monitoring then FahMon won't know what to do and sets them to the 'Hung' state.
You can possibly fix this by turning Ignore Asynchronous Clocks on (FahMon>Prefrences>Monitoring>Ignore Asynchronous Clocks) then it will ignore the time difference and it should be good. FahMon will change the status color from yellow to blue. You could also manually synchronize the clocks on the different computers to the same time.
Please, if you've got any comments, questions or concerns leave a post in this thread.
8/31/2008: Title change, spelling errors fixed
9/1/2008: Fixed broken screen shots
9/8/2008: Updated screens
11/28/2009: Refined prerequisite section, added info to post-installation process
Edited by Roke - 11/28/09 at 9:42pm








