How-To Join the Folding Frogs!

The first step is to go to Stanford's Download Page. At the bottom of the page is a search box. Enter the user name you would like to have and click the search button. Spaces are not allowed in the name so use the underscore character “_” as a replacement. If the name you have chosen is in use, you will need to select a different name.

Downloading the software

Go to Stanford's Download Page. Select the version of the software that fits your operating system. For Windows and Macintosh you will have a choice between a command line version and a graphical version. The choice is yours but it is generally accepted that the command line version is slightly faster as it doesn’t have graphical calculations to perform. It is always a good idea to download the latest version. The command line version is what most of the frogs use and the latest version can always be found on the Links page.

Installing the software

Installing the Windows GUI can be found here.

Windows Command Line Version 2.1X

Single Processor:

Create a directory to hold the client program (example: C:\Folding). Copy the client program (FAH2Console.exe) to your new directory. Create a shortcut to the client program.

Dual Processor:
Create two directories to hold the client program (example: C:\Folding1, C:\Folding2). Copy the client program (FAH2Console.exe) to your new directories. Create shortcuts to the client programs. Edit each shortcut. Add -local to the end of the Target line (example: "C:\Folding1\FAH2Console.exe" –local)

NOTE: It is recommended to help alleviate trouble during upgrades later to rename the EXE file to FAH2.exe or some other easy name. This needs to be doubled in a dual processor config. i.e. FAH2-1.exe and FAH2-2.exe.

Running the command line client

The command line client does not start automatically with Windows. If you would like it to, you need to create shortcuts in the Startup folder. The first time you run the client, a series of prompts will appear. Brackets surround the current settings []. They are:

User Name [anonymous]?
Enter your user name

Team Number [0]?
Enter 734 for the amdmb folding frogs.

Ask before fetching/sending work [no]?
If you are on dial-up access and only have one phone line you should probably enter yes. Otherwise press enter.

Use proxy [no]?
If you do not use a proxy, press enter and the program will begin to download a work unit. If you use a proxy, enter yes and the next prompt will appear.

Use Internet Explorer settings [yes]?
If you enter yes, the program will use the proxy settings you have set in Internet Explorer and the program will begin to download a work unit. If you enter no, the next prompt will appear.

Proxy Name [localhost]?
Enter the name of the proxy you are using.

Proxy Port [8080]?
Enter the proxy port number.

If all has gone well the program should download a work unit and begin to perform calculations. If the program is unable to download a work unit, you will need to check your settings. See the command line switch section for instruction to reconfigure the program.

Command Line Switches

The command line client can be started with a variety of switches to perform certain functions. There are two methods you can use to run the client with a switch. You may start a dos session, navigate to the folder that contains the client, and enter the program name followed by the switch you wish to use. You may also create a shortcut to the client program, edit the shortcut, and add the switch to the end of the shortcuts Target line. The switches are as follows:

-config Steps you through the configuration outlined above.
-queueinfo Display information on queued work units.
-send x Sends a specific result to the server.
-send all Sends all results to the server.
-verbosity x Sets the output level, from 1 to 9 (max). Defaults to 3.
-pause Pause after finishing & trying to send a work unit.
-local Uses configuration files from the local directory.
-default Use configuration from the Windows directory.

Most of the time you will have no need to use these switches. If you require help using them, just post your question in the forum.

Closing the command line client

Pressing Ctrl-C will gracefully terminate the folding program. It is best to terminate the program immediately following the completion of a frame. If you terminate the program in the middle of a frame, the next time the program is started it will have to recalculate the entire frame.

Dial-up Suggestions

Users who have dial-up access to the Internet and only one phone line usually set the “Ask before sending/fetching work” prompt to Yes. This is so the client program will not try to dial out when they are using the phone. In these cases, users can follow the installation instructions for dual processors. Each protein takes twice as long to fold but since they are doing two of them the time ends up the same. This way if one finishes while they are unable to dial-in, the other protein is still folding. In effect, it reduces down time.

Windows Graphical

Locate the Folding@Home2.EXE program in your download directory and double-click the file. Once you accept the terms and conditions, a screen will appear asking for a name. Enter the user name you have selected. The rest of the prompts are standard Windows install prompts such as directory and program group. When the prompt appears with the option to run the installed program, select Yes.

Running the graphical client

The graphical client automatically starts with Windows. The installation process adds a shortcut to the startup folder.

If you selected Yes to start the client during installation you will see a red icon in the System Tray. If not, click the Start Menu, Programs, Folding@Home, Folding@Home 2.0. This will start the program and the red icon should appear in the System Tray. Right click the red icon and a menu will popup. Select “Configure” on the menu. A screen will appear where you can set your configuration. The first field is “Name or Email”. You should see the user name you entered when you installed the program. If this is incorrect, you may change it here. The next field is “Team number”. Enter 734 for the amdmb folding frogs. The rest of the prompts involve proxy settings. Most users can use the default settings.

It is suggested that you do not use the folding screensaver. In the past it has had problems with certain video card drivers.

Closing the graphical client

Right click the red icon and a menu will popup. Select “Configure” on the menu. The configuration screen will appear. There is a Quit button located on this screen. Clicking this button will terminate the client.

Linux and Macintosh

Go to Stanford's Download Page. There are instructions for installing and operating the client for those operating systems.