FoldingAtHome

Differences between revisions 24 and 27 (spanning 3 versions)
Revision 24 as of 2006-05-07 20:46:46
Size: 6376
Editor: 70-57-193-50
Comment: team ubuntu wiki link
Revision 27 as of 2006-07-03 06:04:36
Size: 7160
Editor: 70-57-193-50
Comment: modified acpi section for dapper
Deletions are marked like this. Additions are marked like this.
Line 9: Line 9:
The following script will download the latest client from the Folding@Home website, and install it to opt/foldingathome, either in / or $HOME. It will ask you to set up the client (the defaults are usually sufficient), and copy that configuration for every CPU in your machine. The following script will download the latest client from the Folding@Home website, and install it to {{{opt/foldingathome}}}, either in {{{/}}} or {{{$HOME}}}. It will ask you to set up the client (the defaults are usually sufficient), and copy that configuration for every CPU in your machine.
Line 13: Line 13:
It is not possible to provide a .deb package for Folding@Home, because the client must be downloaded from Stanford's website. This is to ensure the integrity of the research. It is not possible to provide a .deb package for Folding@Home, because the client must be downloaded from Stanford's website. This is to ensure the integrity of the research. (Maybe it is possible to have a .deb; after all, this is how Macromedia Flash works. The point is that the executable has to be downloaded from Stanford.)
Line 19: Line 19:
This should extract the archive to a folder called {{{folding/}}}. Then This should extract the archive to a directory called {{{fah_install/}}}. Then
Line 31: Line 31:
You can also install to your $HOME, in case you do not have root access to the computer. Clearly, you would not have to prefix the command with sudo in this case. If you install to your $HOME, a cron job will be created to start the client automatically. If you install to the system, the client will automatically start when your computer boots up. You can also install to your {{{$HOME}}}, in case you do not have root access to the computer. Clearly, you would not have to prefix the command with sudo in this case. If you install to your {{{$HOME}}}, a cron job will be created to start the client automatically. If you install to the system, the client will automatically start when your computer boots up.
Line 33: Line 33:
You can reconfigure the client using the supplied reconfigure script. You can also give the client command line options. See the README for more details. You can reconfigure the client using the supplied {{{reconfigure}}} script, which is placed in {{{opt/foldingathome}}}. You can also give the client command line options. See the README for more details.
Line 38: Line 38:
One can configure ACPI (the power regulation subsystem) to stop the client when the system goes on battery power, and to start it again when the power cord is plugged back in.  Edit {{{/etc/acpi/power.sh}}}. Inside the {{{if [ $? = 0 ] && [ x$1 != xstop ]; then}}} block, add One can configure ACPI (the power regulation subsystem) to stop the client when the system goes on battery power, and to start it again when the power cord is plugged back in.

==== Breezy and older ====

Edit {{{/etc/acpi/power.sh}}}. Inside the {{{if [ $? = 0 ] && [ x$1 != xstop ]; then}}} block, add
Line 51: Line 55:

==== Dapper ====

Simply create two scripts in the relevant directories.

{{{
sudo -i
echo "/etc/init.d/foldingathome stop" > /etc/acpi/battery.d/fah
echo "/etc/init.d/foldingathome start" > /etc/acpi/ac.d/fah
exit
}}}
Line 54: Line 70:
For questions and bug reports, go to the [http://ubuntuforums.org/showthread.php?t=101817 forum thread]. For questions and bug reports, go to the [http://ubuntuforums.org/showthread.php?t=101817 HowTo forum thread].  For casual talk about Folding@Home, use the [http://ubuntuforums.org/showthread.php?t=102313 Team Recuiting thread].
Line 63: Line 79:
A competitive folding@home team called Team Ubuntu (FoldingAtHomeTeamUbuntu) has formed to represent the Ubuntu community and organize to have fun while doing some good. The team number is 45104. To join the team, simply enter 45104 when the setup dialog requests a team number. Those wishing to get optimal performance from their folding box should review the Hackaday blog entry on competitive folding linked below. A competitive Folding@Home team called Team Ubuntu (FoldingAtHomeTeamUbuntu, [http://ubuntuforums.org/showthread.php?t=102313 forum thread]) has formed to represent the Ubuntu community and organize to have fun while doing some good. The team number is 45104. To join the team, simply enter 45104 when the setup dialog requests a team number. Those wishing to get optimal performance from their folding box should review the Hackaday blog entry on competitive folding linked below.
Line 73: Line 89:
 * [http://ubuntuforums.org/showthread.php?t=102313 Team Ubuntu Recruiting forum thread]

Overview

When proteins are created, they undergo a complex process known as folding, so-called because the protein molecule transforms from a long chain of amino acids to a complex shape (it "folds up"). The final shape of the protein is absolutely critical to determining its properties and function. Scientists have created software to simulate the folding process to better understand how proteins work, which in turn makes it possible to develope new drugs, cure diseases, etc.

Folding@Home is a project from Stanford University that uses millions of networked PCs to form a supercomputer for protein folding simulations. The client software is loaded on a PC, it contacts the central servers, and receives "work units". The client then runs on spare CPU time, and uploads finished work units to the server.

Folding@Home is a great way to make your computer do useful work even when you're not using it. Since it runs at a very low priority, you should never realize it's running when you're using the computer to do your work. Note that "using the computer" refers to doing heavy computations. Generally, tasks like web browsing and word processing involve very little CPU usage, so the Folding@Home client will be running at near 100% even when doing those kinds of tasks. It helps to leave you computer on at all times, but is not necessary, as the project will benefit from virtually any time that the client runs on your computer.

Installation

The following script will download the latest client from the Folding@Home website, and install it to opt/foldingathome, either in / or $HOME. It will ask you to set up the client (the defaults are usually sufficient), and copy that configuration for every CPU in your machine.

  • attachment:fah_install-20060421.tar.gz

It is not possible to provide a .deb package for Folding@Home, because the client must be downloaded from Stanford's website. This is to ensure the integrity of the research. (Maybe it is possible to have a .deb; after all, this is how Macromedia Flash works. The point is that the executable has to be downloaded from Stanford.)

To install, download the tarball and do

tar zxvf fah_install-version.tar.gz

This should extract the archive to a directory called fah_install/. Then

cd fah_install
less README

to read the documentation. Finally,

sudo ./folding_install.sh install

to install the client.

You can also install to your $HOME, in case you do not have root access to the computer. Clearly, you would not have to prefix the command with sudo in this case. If you install to your $HOME, a cron job will be created to start the client automatically. If you install to the system, the client will automatically start when your computer boots up.

You can reconfigure the client using the supplied reconfigure script, which is placed in opt/foldingathome. You can also give the client command line options. See the README for more details.

Laptop Systems

Because the client runs at low priority, the client should not cause the CPU governor to kick up the frequency. In other words, even though the client runs at 100% CPU usage, it should not cause the CPU frequency to go up, which keeps the fan slow and quiet. If this is not the case, then the frequency governor should be reconfigured.

One can configure ACPI (the power regulation subsystem) to stop the client when the system goes on battery power, and to start it again when the power cord is plugged back in.

Breezy and older

Edit /etc/acpi/power.sh. Inside the if [ $? = 0 ] && [ x$1 != xstop ]; then block, add

    # stop folding at home
    if [[ -x /etc/init.d/foldingathome ]] ; then 
        /etc/init.d/foldingathome stop
    fi

and inside the else block, add

    if [[ -x /etc/init.d/foldingathome ]] ; then 
        /etc/init.d/foldingathome start
    fi

Dapper

Simply create two scripts in the relevant directories.

sudo -i
echo "/etc/init.d/foldingathome stop" > /etc/acpi/battery.d/fah
echo "/etc/init.d/foldingathome start" > /etc/acpi/ac.d/fah
exit

This assumes that the client has been installed for the entire system, which it should be if you are able to edit files in /etc in the first place!

Other Issues

For questions and bug reports, go to the [http://ubuntuforums.org/showthread.php?t=101817 HowTo forum thread]. For casual talk about Folding@Home, use the [http://ubuntuforums.org/showthread.php?t=102313 Team Recuiting thread].

Security

Folding@Home is secure. The Stanford team has gone to great lengths to ensure security, both for the integrity of their research and the safety of donors' computers. However, the more secure the better. The Gentoo ebuild for Folding@Home creates a new user foldingathome whose sole purpose is to run the client. Now this installer offers same. It creates a user whose account is disabled, and runs the client as this user when the init script is run as root, so the client is never run as root.

Hyper Threading

For those with Hyper Threading CPUs, you probably know that an SMP kernel sees two processors. Then clearly, if you run two clients, you will get more work done than if you only run one (probably about 10-30% more). However, results that are done quickly are more useful than more results done slowly. The reason is that each work unit is a step in a giant simulation, with future steps depending on past ones. So the faster you get your work done, the faster the simulation can move along. Long story short, run one client for each physical CPU, not for each logical CPU. The installer should automatically count the number of CPUs in your system. See this [http://forum.folding-community.org/viewtopic.php?t=10427 post] in the Folding@Home forums.

Team Ubuntu

A competitive Folding@Home team called Team Ubuntu (FoldingAtHomeTeamUbuntu, [http://ubuntuforums.org/showthread.php?t=102313 forum thread]) has formed to represent the Ubuntu community and organize to have fun while doing some good. The team number is 45104. To join the team, simply enter 45104 when the setup dialog requests a team number. Those wishing to get optimal performance from their folding box should review the Hackaday blog entry on competitive folding linked below.

FoldingAtHome (last edited 2008-08-06 17:00:30 by localhost)