[Ubuntu] Easy install client v7

Easy Install of Client v7 for Ubuntu 10.10 and 12.04

Goal of this guide:

This guide covers:

• the installation of FAHClient v7.3.6 in Ubuntu 10.10 as well as in Ubuntu 12.04
• the installation of FAHControl [optional]
• configuration of the client to be able to remotely monitor and control your client from your local network

--note: this guide does not cover the installation of HFM or Ubuntu natively or in a Virtual Machine. [1]

Contents of this guide:

0 - Intro:

• A-1) Some useful background information
• A-2) Conventions used in this guide

I - FAHClient:

• B-1) Installing FAHClient
• B-2) Configuring FAHClient
• B-3) Run FAHClient on startup

II - FAHControl:

• C) [Optional] Installing FAHControl

0 - Intro:

A-1) Some useful background information:

Basically FAHClient is the back-end software that handles all of the folding processes like downloading WUs, communicating with the a4 FAHCores, managing the FAHSlots (mapping the WUs on the GPUs and or CPUs) and eventually uploading the WUs back to the work server. So FAHClient is actually the only piece of software you need to fold WUs. You can download FAHControl as well on your UNIX box to get a GUI to control FAHClient for some more ease of use, but is absolutely not necessary!

A-2) Conventions used in this guide

--note:

Denotes that the reader should take caution

->

Denotes that the reader should take action

I - FAHClient:

B-1) Installing FAHClient:

-> After booting into your Ubuntu installation open a new terminal and copy-paste this all at once in the newly opened terminal:

Ubuntu 10.10

mkdir fahv7; cd fahv7; wget --no-check-certificate https://fah-web.stanford.edu/file-releases/beta/release/fahclient/debian-testing-64bit/v7.3/fahclient_7.3.6-64bit-release.tar.bz2; tar -jxvf *.tar.bz2; rm *.tar*; mv fahclient_7.3.6-64bit-release v7; cd v7; ./FAHClient --configure

Ubuntu 12.04

sudo apt-get install libssl0.9.8; mkdir fahv7; cd fahv7; wget --no-check-certificate https://fah-web.stanford.edu/file-releases/beta/release/fahclient/debian-testing-64bit/v7.3/fahclient_7.3.6-64bit-release.tar.bz2; tar -jxvf *.tar.bz2; rm *.tar.bz2; mv fahclient_7.3.6-64bit-release v7; cd v7; ./FAHClient --configure

What this command line does is:

• create a directory called fahv7 in your home directory (/home/user_name/fahv7)
• fetch a tarball from Stanford containing FAHClient v7.3.6 *last update @03/28/2013*
• extract the tarball in fahv7
• place the extracted files in a directory v7 (/home/user_name/fahv7/v7)
• configure the client

In case of Ubuntu 12.04, the dependancies need to be fixed so it needs to install libssl0.9.8 first

-> Now fill in your folding username, team number and passkey. For all other questions simply hit Enter/Return. Keep the terminal open

--note: GPU folding does not work in Ubuntu yet, you need to run WINE to get it working!

B-2) Configuring FAHClient:

Okay, so now we have a v7 client ready to fold aside from the fact that we still need to enable remote monitoring and control. To enable this, we need to edit the configuration file, config.xml,  located in /home/user_name/fahv7/v7/.

-> Go back to the terminal and copy-paste this

gedit config.xml

The text editor will be started with config.xml opened in it.

-> Copy-paste these lines into your file

<checkpoint v='3'/>
<command-allow v="127.0.0.1 192.168.1.100-192.168.1.149"/>
<command-allow-no-pass v="127.0.0.1 192.168.1.100-192.168.1.149"/>
<command-port v="36330"/>

--note: IP range listed here is default. If you assigned a different subnet to your local IP adresses you should change these values!

 <config>

 <checkpoint v='3'/>

 <command-allow v="127.0.0.1 192.168.1.100-192.168.1.149"/>
 <command-allow-no-pass v="127.0.0.1 192.168.1.100-192.168.1.149"/>
 <command-port v="36330"/>

  <!-- Configuration file created by FAHClient on 2012-09-02T14:22:05Z -->
  <user value='my_username'/>
  <team value='37726'/>
  <passkey value='my_passkey'/>
  <smp value='true'/>
  <gpu value='false'/>
</config>

-> Now save your file and close the text editor and the terminal

B-3) Run FAHClient on startup:

Your client is now ready to fold and be able to be controlled and monitored via a remote connection. If you want v7 to run from startup, do one of the following.

--note: I do recommend running the client in a shell for new users, although it's less reliable you can determine the problems more easily if they occur.

sudo gedit /etc/rc.local

cd /home/user_name/fahv7/v7; ./FAHClient

cd fahv7/v7/; gedit fahv7.sh

gnome-terminal --profile=fahv7

cd fahv7/v7/; chmod +x fahv7.sh; chmod +x FAHClient; chmod +x FAHCoreWrapper

/home/user_name/fahv7/v7/FAHClient

After following one of the above you can now install FAHControl on any PC on your local network and control the client. Also you can setup a remote connection with HFM to monitor your PPD and stats.

II - FAHControl:

C) [Optional] Installing FAHControl:

-> If you want a GUI to control FAHClient just copy-paste the following line in a new terminal:

wget --no-check-certificate https://fah-web.stanford.edu/file-releases/beta/release/fahcontrol/debian-testing-64bit/v7.3/fahcontrol_7.3.6-1_all.deb; sudo dpkg -i --force-depends fahcontrol_7.3.6-1_all.deb 

-> To launch FAHControl, just go to: Applications -> Science -> FAHControl

I hope this was helpful. Please note that there may always be issues depending on the configuration (especially ubuntu 12.04), so if there are questions, remarks or corrections please post them

Also make sure add some frametimes, PPD number and more WU information to the PPD Database

[1] Courtesy of WonderMutt

Quote:

Originally Posted by Kevdog 

Very nicely written guide
but I have a problem, Im using 12.04 and I get this

Okay, first of all thanks for giving this guide a try. I might need to change it step by step if things go wrong.

Can you tell me what you did and when it happned?

I assume it happened when installing FAHControl and hitting configure in FAHControl? In that case, you need FAHClient running too as the back end. FAHControl will pick up automatically and you can control it from there on. You might need to allow local IP 127.0.0.1 too, but lets try it without first.

Like I said in the background information the GUI is the front-end controlling the back-end FAHClient, so FAHClient needs to be running too

Quote:

Originally Posted by a 6 foot rabbit 

been meaning to try v7, thanks for making it simple. gonna install tonite, will post if I run into any problems

Thanks

Quote:

Originally Posted by Kevdog 


FAHClient would run with the line command, but when I typed FAHControl, the control box would pop up and none of my user info was showing up, and it would stop the client from working and give me that error when I would try to start it from the control box.
I did get it running or I should say "xaviergzz" got it running for me but we had to reinstall it 3 times

But did you do it in the right order? So installing FAHClient, configuring it to accept 127.0.0.1 (not sure if this is necessary) and then install FAHControl? Nice to see that you've got it going though.

Quote:

Originally Posted by labnjab 

I dont know if anyone else has noticed this, but v7 seems to stress the cpu more then v6 in both native and windows. I noticed a 5C increase in cpu temperature in both of my rigs since switching to v7. I've also had to bump up vcore a few notches on both rigs in order to run it without random crashes / bsod (temp rise was before vcore increase) Despite this i still love v7 over v6, and its greatly increased my ppd average compared to v6

It's not v7 that stresses the CPU more, it's those WUs from 129.74.85.15 (e.g 700x, 701x, 702x, 100xx). But yeah they run about 5-8*C hotter and caused my client to crash eventually. That was on clocks stable throughout the summer for BA-12 too...