Customizing BOINC app_info.xml
We are using app_info to tell BOINC which of the WCG projects we want to run and in the case of HCC for GPU, how many instances of the app to run on each GPU. The ony real reason to do this is when your GPU utilization is less than 90% and you want to crank a little more out of your rig. Some folks have had great success, typically those running high end cards but there is room for all. That being said, if you run too many instances and stuff your GPU you may start to see some lag in your PC's response.
ATI GPU only app_info - post #3 this thread
Nvidia GPU only app_info - post #4 this thread
Combining multiple projects with GPU and CPU app_info - post #5 this thread
Main thread for working app_info files - courtesy of OldChap
An alternative to running with app_info - courtesy of Vinas
Now that I've managed to derail my own thread ... back to our 'How To' for putting together an app_info file.
General makeup of an app_info file
1.1 There are three general sections within an app_info file
1.2 <app> - this is the basic info on the WCG project you are configuring (like HCC or CEP2)
1.3 <file_info> - A list all of the files the <app> will use
1.4 <app_version> - these are the specific programs that will run each <app>
(like HCC can be both gpu and cpu so we need an app_version for each)
How to manage your app_info files
2.1 Don't work directly in the folder BOINC reads the app_info from, make your own folder so if you ever reset the project entirely or even uninstall / reinstall BOINC you won't lose your custom app_info file. Another nice thing about doing them in a separate folder is that you can keep different versions along with things like your custom account and config files
2.2 Make the file name describe what apps it will run (NV_GPU_ONLY)
2.3 Create a new app_info.xml file or make a copy of an existing file
2.4 This is also the place to store copies of the files listed in your app_info
What tools do we use to build an app_info file?
3.1 We will use Notepad to create / modify our app_info_files but Notepad tries to trick you
3.2 Notepad wants to save everything as .txt but we need .xml
3.3 When saving a file for the first time make sure to change the file type to All Files
3.4 Changing a file from .txt to .xml, use file system to rename or open in Notepad and use Save As
How to build an app_info file
4.1 We will be posting working examples of the app_info file sections below so you can mix and match
4.2 Create a new app_info file and create the overall openeing tag <app_info>
(Everythign inside the app_info_file has to go under the app_info tag)
4.4 If you want to add a new app copy the <app> section and paste it at the end of your file but before the closing </app_info> tag
4.5 if you are just adding a new version of an existing <app> you don't have to add it again
4.6 Add the <file_info> and <app_version> sections just below the <app> that will be running them
4.7 Repeat 4.2 and 4.3 for each <app_version> you want to run the <app>
4.8 For each <app> repeat 4.2 though 4.4
4.9 Create the app_info closing tag </app_info>
Getting BOINC to use it
5.1 Set your WCG device profile preferences on the website to match the projects you are going to run with your app_info file.
5.2 If you are adding a new app info for the first time complete your existing WUs (or abort them).
5.3 Stop BOINC
5.4 Put app_info into the folder you told BOINC to use for Program Data when you installed
5.4.1 Windows 7 = C\Program Data\projects\www.worldcommunitygrid.org
5.5 If the files listed inside the app_info are not already in this folder copy them in from your app_info source folder
5.6 Start BOINC
TODO
1. add xml comments
2. explain <flops>
3. explain how to use app_version to run 32 bit WUs with 64 bit executables and vice versa
4. explain how cpu_avg, cpu_max work