Creating a Project - Adding applications

From Unofficial BOINC Wiki

Building & adding applications is a difficult task so we will use a prebuilt application. It is located in the following folder of the boinc_public or boinc tree.

apps/upper_case.C

If you have done everything correctly you will have a file named upper_case in the apps folder too. This is the actual program.

Take that upper_case program and copy it to

$PROJECTROOT/apps/upper_case

where $PROJECTROOT is the path to the project root folder, the one that looks like this:

PROJECTNAME/
    apps
    bin
    cgi-bin
    download
    html
    templates
    upload

You will need to create the folder.

Next, go to the file $PROJECTROOT/project.xml add the following to it in the <boinc> tags.

<app>
  <name>upper_case</name>
  <user_friendly_name>Convert to Upper Case</user_friendly_name>
</app>

and go to your shell console, where you cd to the PROJECTROOT and type

./bin/xadd

and press

y<enter>

to commit the application the database. This will create the app in the database.

PROBLEM: the xadd program wants the MySQL socket in the default location so you need just

mysqld_safe

as the MySQL command line

Now you have run xadd, you need to move the MySQL socket back to /var/lib/mysql/mysql.sock for running

./update_versions

But before we do that, we need to correct the filename of the application and digitally sign it.

To get the application to the right filename format go the PROJECTROOT/apps/upper_case folder and rename upper_case to upper_case_4.00_i686-pc-linux-gnu

This will give the update_versions script something to think about!!!

Now you must sign the application you have, either run sign_executable or run this script (from my BOINC Tools site and change the keys path to that of the project) on apps/upper_case/upper_case_4.00_i686-pc-linux-gnu

The command line looks like this for sign_executable:

./bin/sign_executable apps/upper_case/upper_case_4.00_i686-pc-linux-gnu /path/to/keys/code_sign_priva
te >> apps/upper_case/upper_case_4.00_i686-pc-linux-gnu.sig

or

./bin/boinc_sign apps/upper_case/upper_case_4.00_i686-pc-linux-gnu

for my script.

When you created the project, you created a set of keys, called the public and private key for download and upload. You must keep the private keys safe!!!

Now we have one fully signed version of upper_case for the i686-pc-linux-gnu platform and we can send it to the db.

move the MySQL socket to /var/lib/mysql/mysql.sock and then run