Windows Install Guide

 

Introduction to V7

The new Folding@home (FAH) software is configured, controlled, and monitored through a new simpler graphical interface named Web Control. This new web browser based application has incorporated many new features, including client monitoring and configuration of all FAH clients. Web Control is now the recommended interface for all FAH types (Single core CPU, Multi-core CPU, GPU), replacing both the Systray and the Console versions of FAH.  The more advanced FAHControl application is also available.

What is new in V7?

We are pleased to say that everything is new in this version, using completely new software coding from the ground up. Our goal is to include the best features from the previous clients, make improvements where possible, discard what was no longer needed, then add new features like the quick start Express mode installer, the new FAHViewer, and the new unified interface. V7 has all of these and more, making installation and configuration much simpler and faster for new users, while continuing to support advanced options.

Note: There are too many updated and new features to list in an Installation Guide, so this section only covers What’s New when installing V7 software. Please read the V7 Introduction page for basic information and explanations of the new client features.

New Terminology

The V7 software really changes the concept of how people interact with FAH. And with new concepts come new or updated terms to describe those concepts. Learning new references is part of the process for change and improvement.

  • Web Control – This is the new simpler graphical interface (front-end). Web Control will configure and monitor one or more FAHClient slots through an easy to use web page.  This is the default control program.
  • FAHControl – This is an alternate new graphical interface (advanced front-end). FAHControl will configure and monitor one or more FAHClient (slots), on one or more computers. This more advanced interface is optional.
  • FAHClient – This is the (back-end) client software managed by FAHControl and typically runs behind the scene. This is a truly unified client (slot) manager. FAHClient starts one or multiple instances of a Fahcore and manages the work assignments for each of these client “slots.”
  • FAHSlot – aka “slot” – Each Fahcore and the data associated with it is called a slot. For example, one FAHSlot can be associated with a GPU and another slot associated with the CPU. Each folding slot can download, process, and upload results independently. The FAHClient manages each slot, and FAHControl monitors and displays their progress independently.
  • FAHViewer – This is the new and fully functional work unit viewer. FAHViewer is modeled after the very popular PS3 viewer, and continues to offer the many rendering options, ball and stick, space fill, zoom, rotation, etc., and adds snapshot capture and cycling to show folding in action.
See also the FAHControlFAHClient , and FAHViewer documents for more information about setup and customization options.

Requirements

The new V7 software has the same basic hardware and operating system requirements as the previous clients. However, a few software specific requirements have changed to support newer features. Listed by slot type:

  • CPU Slot Requirements
    • Windows XP SP3 or newer, 32 or 64 bit
    • Intel P4 1.4 GHz processor or newer, or AMD equivalent (modern multi-core processors recommended)
      • A limited selection of Projects are available for single core processors, as the End Of Life for single core projects was announced in August 2013
      • Projects for higher numbers of cores may require 64-bit and have shorter deadlines, generally requiring a client running at or close to 24/7
    • Broadband internet connection or faster

Note: Although Pande Group has yet to provide a list of software prerequisites, donors have reported three issues. First is that Microsoft .NET Framework is required by V7 FAHControl in Windows, and Windows XP does not include .NET Framework by default. Microsoft .NET 2.0 or newer should be installed to support the V7 software in Windows XP. All newer versions of Windows already include a supported version of .NET by default. In addition, Windows XP needs the 2008 C++ Redistributable (32 bit) for the FAHClient to operate. And depending on your network configuration, IPv4 may need to be given priority over IPv6 using this Microsoft Fix It tool.

  • GPU Slot Requirements
    • Windows XP SP3 or newer for NVIDA GPUs, 32 or 64 bit
    • Windows Vista SP2 or newer for AMD GPUs, 32 or 64 bit
    • FAHClient running more than part time to meet shorter deadlines
    • Broadband internet connection or faster
    • 1 or more supported GPU video cards
    • ATI/AMD
      • (GPU3 – OpenMM- fahcore_16) – End Of Life announced Sept. 2013
        • OpenCL compatible GPU, 5xxx series or newer, see full list
        • 11.4 AMD device driver or newer
      • (GPU3 – OpenCL – FAHCore_17)
        • OpenCL compatible GPU, 5xxx series or newer*, see full list
        • 13.6 AMD device driver or newer (14.4+ improves speed)
    • NVIDIA
      • (GPU2 – CUDA – fahcore_11) - End Of Life announced Aug. 2013
        • CUDA supported GPU (8xxx series and above), see full list
        • 26x.xx NV device driver or newer (327.xx is a known stable version)
      • (GPU3 – OpenMM – fahcore_15) - End Of Life announced Nov. 2013
        • CUDA supported GPU (8xxx series and above), see full list
        • 26x.xx NV device driver or newer (327.xx is a known stable version)
      • (GPU3 – OpenCL – fahcore_17)
        • OpenCL compatible GPU, 4xx series and above (Fermi and Kepler) or newer*
        • 301.xx NV device driver or newer (327.xx is a known stable version)

Note: GPU drivers, models, features, and support develop very quickly. Please note these specific issues.

  • The v11.12 AMD device driver is the last version to support OpenCL on Windows XP. 7xxx series boards and newer will need Windows Vista SP2 or newer.
  • Automatic updating of the GPUs.txt is now supported in V7.3.x and newer. A FAHClient.exe restart is required.
  • Non-GK110 GPUs may experience half speed folding when using NVidia drivers newer than 327.xx.  GK110 based GPUs experience no slow down in newer drivers.  Waiting on a driver fix from NV.  There is a potential for a fahcore workaround, in testing now.
  • See the Folding Support Forum New GPUs (whitelist/blacklist) section for more information about the GPU hardware greylist (supported HW list) with newer GPUs.
  • The end of support for ATI/AMD 4xxx series and below was announced in March 2011, and scheduled to end in September 2011. The last of the Fahcore_11 (GPU2) work units actually lasted until June 2012, more than a year after the original announcement.
  • *New GPU models with newer chip architecture may not be supported by the current software.  New fahcores and/or new drivers with updated optimizations may be required for full support.  New fahcores will not be available until some time after the new hardware products are sold to the public.  Then the fahcores and drivers may be updated, tested, and verified before released for folding.

Note: Under Windows, antivirus software can interfere with the Folding@home client files and cause errors. We suggest configuring antivirus software to exclude the FAH client directory and especially the Work directory from the antivirus scanning list. This can be done by going into the exclusion list panel that every antivirus should have. The work subdirectory contains semi-random binary data and can confuse overly aggressive heuristic virus scanning.

Quick Start

This section describes how to get started folding quickly with the new V7 software and the default FAHClient slot(s).

  • Download and run the installer.
  • Click Yes, Next, I Agree, Next, Finish.
  • Enter a name and/or team #, and Passkey.  Always use a Passkey.
  • Click Save.
  • Done.

After the download, the new V7 software is installed and folding in under 1 minute. Very quick and easy. For a more guided installation, please see the Express Install or Custom Setup sections.

Express Installation – Recommended! (All Users)

This section describes the recommended method for installing the V7 FAH software for individual FAHClient slot(s) on Windows XP and newer. A first time installation is assumed. And unless otherwise noted, the default setting for each option is the recommended setting.

Download the V7 Installer from here (see figure 1). The installer includes the new Web Control (client manager) interface software, the new FAHClient (slot manager) software, and the new FAHViewer (viewer) software.  The optional FAHClient (advanced client manager) is also included.

FAH InstallerFigure 1

Double-click the Installer icon to start the software installation.

A security warning prompt may be displayed (see figure 2).

Allow Access
Figure 2

If prompted, click Run or click Yes to acknowledge the warning and continue the installation.

The welcome screen is displayed (see figure 3).

Welcome to FoldingFigure 3

Click Next to continue the installation.

Read the License Agreement (see figure 4).

License AgreementFigure 4

If agreeable, click I Agree to continue.

The Installer Mode option screen is displayed (see figure 5).

Express InstallFigure 5

Click Next to continue the Express (Recommended) installation.

Note: Express Install will automatically install one or more FAHClient slots to match the computer hardware detected. If multiple CPU cores are detected, an multicore CPU slot is installed, otherwise a single core CPU slot is installed as the fall back option. If one or more GPUs are detected, one or more GPU slots are also installed automatically. If neither multicores or GPU are detected, a single core CPU slot is installed by default. The separate SMP and Uniprocessor slot types are now combined and known as a CPU slot, supporting one to many CPU cores.

Please wait while the installation finishes (see figure 6).

Installation ProgressFigure 6

V7 installation is almost complete (see figure 7).

Installation Complete
Figure 7

Note: Do not uncheck the box to Start Folding@home so the software will start automatically with Windows.  If unchecked, FAHClient will need to be started manually each time.

Click Finish.

A prompt from Windows Firewall or another security software may be displayed (see figure 8).

Firewall PromptFigure 8

If prompted, select Unblock or Allow Access for V7 software to connect to the internet.

The Web Control (client manager) interface will start automatically after a few seconds. The Web Control page will prompt to configure a FAH user identity (see figure 9).

Configure IDFigure 9

Click the Configure an Identity button unless choosing to fold Anonymously.

The Web Control Identity tab is displayed (see figure 10).

Web Control, Enter IDFigure 10

Enter a FAH user Name, Team #, and Passkey as needed.  Always use a Passkey.

Note: Using a Passkey adds an extra level of security, and is also a requirement to receive Quick Return Bonus points.

Click Save to continue.

The Web Control Home tab is displayed (see figure 11).

Web ControlFigure 11

V7 software is now installed and folding.

Please read the V7 Introduction page for basic information and further explanations of the new client features.

See also the FAHControl (client manager), FAHClient (slot), and FAHViewer (viewer) documents for more information about setup and customization options.

While the default options are typically the recommended options, see the Configuration FAQ for additional setup options.

 

Custom Installation – Optional (Advanced Users)

This section describes V7 FAH custom options available when installing FAHClient slot(s) on Windows XP and newer. This procedure assumes advanced knowledge of Windows and V7 Folding@home software. A first time installation is assumed, and unless otherwise noted, the default setting for each option is the recommended setting.

Note: To install a V7 FAHClient slot to run as a service (an option a bit later in the setup), the Windows XP user account running the installer must have Administrator privileges. In Windows Vista and newer, the installer must be opened with the Run As Administrator option. Do this by right-clicking on the installer icon and then click Run as Administrator. If prompted for an administrator password or confirmation, enter the password or provide confirmation. If a service install is the goal, this would be a good time to change to a user account with Administrative rights in XP, or to use the Run As option in Vista/7/8.

Note: Windows Vista, Windows 7/8, and newer do not support running a GPU FAHClient slot as a service (a Microsoft security limitation).

Download the V7 Installer from here (see figure 1). The installer includes the new simpler Web Control (client manager), the new FAHClient (slot) software, and the new FAHViewer (viewer) software.  V7 also includes the optional FAHControl (advanced client manager) interface software.

FAH InstallerFigure 1

Double-click the Installer icon to start the software installation.

A security warning prompt may be displayed (see figure 2).

WIG01FCInstall7Figure 2

If prompted, click Run or click Yes to acknowledge the warning and continue the installation.

The welcome screen is displayed (see figure 3).

Welcome to FAHClient Setup
Figure 3

Click Next to continue the installation.

Read the License Agreement (see figure 4).

License Agreement
Figure 4

If agreeable, click I Agree to continue.

The Installer Mode option screen is displayed (see figure 5).

WIG04cFCInstall7
Figure 5

Select the Custom Install (Advanced) option as pictured. Click Next to proceed.

The Choose Users screen is shown (see figure 6).

WIG05cFCInstall7
Figure 6

Select an option for which users will run V7 software. Install just for me is recommended. Click Next.

The client location screen is shown (see figure 7).

Program Destination FolderFigure 7

An alternate destination folder may be entered, but this default is recommended. Click Next to continue.

The client data files location screen is shown. The current Windows account name will appear in place of [User_Name] (see figure 8).

Data Directory
Figure 8

An alternate data directory folder may be entered for V7 configuration and data files location. However, this is the recommended default. Click Next.

The Start Software options are displayed (see figure 9). These are very important for determining how the FAHClient will start. It also selects if and how the FAHClient slots are controlled and monitored by FAHControl on this computer.

Startup OptionsFigure 9

How would you like to start the folding client?
The options pictured in figure 9 match the default settings used in the Express install, and are the recommended settings. Or select custom startup options below.

  • The first option sets the FAHClient slot(s) to start at Windows login.  Any FAHClient slot is only visible in the Web Control or Advanced Control interfaces.
  • The second option sets the FAHClient slot to run as a service, and is only visible in the FAHControl interface. Service Mode is not available to GPU clients in Windows Vista and Windows 7/8 (a Microsoft security limitation).
  • The third option is used to start the FAHClient manually from a shortcut.
  • This check box enables the Folding@home screensaver.  It is a recommended option, but may use some computer resources that might otherwise be used for folding, depending on the system configuration.

Note: The installer will automatically install one or more FAHClient slots to match the computer hardware detected. If multiple CPU cores are detected, an a multi-core CPU slot is installed, otherwise a single core CPU slot is installed as the fall back option. If one or more GPUs are detected, one or more GPU slots are also installed automatically. If neither multicores or GPU are detected, a single CPU slot is installed by default.

Note: This section describes how to add an additional slot: Multi-client Installation – Adding slots

Click Install to continue.

Please wait while Folding@home is finishing the installation (see figure 10).

Installing FilesFigure 10

V7 client installation is almost complete (see figure 11).

Installation CompleteFigure 11

Note: Do not uncheck the box to Start Folding@home so the software will start automatically with Windows.  If unchecked, FAHClient will need to be started manually each time.

Click Finish.

A prompt from Windows Firewall or another security software may be displayed (see figure 12).

Firewall
Figure 12

If prompted, select unblock or Allow access for V7 software to connect to the internet.

The Web Control (client manager) interface will start automatically after a few seconds. The Web Control page will prompt to configure a FAH user identity (see figure 14).

Configure IDFigure 14

Click the Configure an Identity button unless choosing to fold Anonymously.

The Web Control Identity tab is displayed (see figure 15).

Web Control, Enter IDFigure 15

Enter a FAH user Name, Team #, and Passkey as needed.  Always use a Passkey.

Note: Using a Passkey adds an extra level of security, and is also a requirement to receive Quick Return Bonus points.

Click Save to continue.

The Web Control Home tab is displayed (see figure 16).

Web ControlFigure 16

V7 software is now installed and folding.

Please read the V7 Introduction page for basic information and further explanations of the new client features.

See also the FAHControl (client manager), FAHClient (slot), and FAHViewer (viewer) documents for more information about setup and customization options.

While the default options are typically the recommended options, see the Configuration FAQ for  additional setup options.

 

Multi-client Installation – Adding slots (Expert Users)

This section describes how to add one or more additional FAHClient slots for Windows XP and newer using the FAHControl interface. When mixing GPU and CPU slots, the setup is quicker and easier to use the V7 installer to add both at the same time. Even after a hardware upgrade, uninstalling and reinstalling is often easier and faster for adding slots for the new hardware.

In the rare event the installer does not add a slot, the procedure to add a slot manually is shown below.

This procedure assumes expert user knowledge of Windows and V7 Folding@home software, and at least one other working and running FAHClient slot. Unless otherwise noted, the default setting for each option is the recommended setting.

Note: Additional slots can be added manually by editing the FAHClient configuration file. However, this is very risky as incorrect settings or typing mistakes may cause the current work unit to abort, the client to crash, or future points to be credited to someone else.

The recommended procedure for adding additional FAHClient slots is through the FAHControl Configuration settings.  Right-click the FAHControl system tray icon to open FAHControl (see figure 1).

FAHControl Tray IconFigure 1

The FAHControl interface is displayed (see figure 2).
FAHControl - Configure
Figure 2

Click the Configure button (on toolbar).

The Configure window and Identity tab are displayed by default (see figure 3).

Identity TabFigure 3

Select the Slots tab.

The current Folding Slots are listed (see figure 4).

Slots TabFigure 4

Click the Add button.

The Configure Folding Slots screen is displayed (see figure 5).

Configure Folding SlotsFigure 5

Select the slot type to be added, CPU or GPU.  When adding a CPU slot, please select the correct number of processing cores to match the computer. When adding a GPU slot, the recommended setting is -1 as the client will autodetect the correct GPU device number.

Click OK to continue. The Slots tab is displayed again, with the new FAHClient slot in the list (see figure 6).

GPU SlotFigure 6

Repeat as needed to add additional new FAHClient slots, or click Save to finish the configuration and return to the main FAHControl screen.

Note: The new FAHClient slots will use the same performance settings (CPU percentage, Checkpoint frequency, etc.) as defined on the Advanced Tab of the Configuration settings.

The new slot will download a new work unit and starting folding automatically.

Exit the FAHControl application when done.

Command Line Only Option

The command line only stand alone FAHClient tarball is available for download from here.

Note: There is no install guide or support in the forum for this type of expert only installation. The only support for command-line only installs is this:

Documentation:

 FAHClient --help

Configuration using config.xml:

 FAHClient --configure

Configuration with no config file (minimum flags):

 FAHClient --user=Anonymous --team=0 --passkey=1385yourpasskeyhere5924 --gpu=true --smp=true

Table of Options

This Client Differences v6 to V7 table lists some of the more common V7 options.

 

How to Uninstall V7 – Partial (for Upgrades) or Complete Removal

This section describes how to uninstall V7 FAH application, either partially for upgrading the V7 software version, or completely for a full removal of the software.

Please exit the application, then begin (see figure 1).

Start Button
Figure 1

Click on the Start button.

The Programs menu is displayed (see figure 2).

All Programs
Figure 2

Click on the All Programs menu. It will expand to show more items (see figure 3).

FAHClient Menu
Figure 3

Click on FAHClient menu. It will expand to show more items (see figure 3). Click on Uninstall menu item.

A security warning prompt may be displayed (see figure 4).

User Access Control
Figure 4

If prompted, click run or Yes to acknowledge the warning to continue the uninstall.

The optional components screen is displayed (see figure 5).

Data
Figure 5

The Data component consists of the current work unit if any, log files, fahcores, and FAHClient slot configuration. Check the box for Data to have these removed as well. If only uninstalling and reinstalling, or upgrading versions, do NOT check the data box to keep the data files and client configuration.

Click the Uninstall button to continue.

Note: If FAHControl or a FAHClient slot is still running, a prompt to Please stop all running Folding@home software is shown. Please exit all FAH software. Then click Retry to continue.

Please wait as the files are deleted or removed (see figure 6).

Completed
Figure 6

Click Close when prompted.

Uninstall is complete.

 

Install Guide Updates

I found a better way to install the V7 client, where can I make a suggestion?

The install guides are written and updated by the folding community, and managed by the Pande Group. Please post any suggestions, corrections, or update recommendations to the corresponding Guides topic in the Folding Forum. And thank you for helping to improve the install guides.

For More Information, Please See:

Last Updated on May 07, 2014 at 11:50 AM

 

Add your computer's power to over 327,000 others that are helping us find cures to Alzheimer's, Huntington's, Parkinson's and many cancers ...

... in just 5 minutes.

Step 1.

Download protein folding simulation software called

Folding@home

.

Step 2.

Run the installation. The software will automatically start up and open a web browser with your control panel.

Step 3.

Follow the instructions to Start Folding.

Stanford University

will send your computer a folding problem to solve. When your first job is completed, your computer will swap the results for a new job.

Download the protein folding simulation software that fits your machine.

()


Installation guide