Here is how you can install a BOINC client and attach it to a project (SETI). We use only command line tools, not GUI involved here. You can attach to a project and do some various administrative work with
boinccmd
like to get the progress of the currently running project tasks, project info, manage tasks and more.
Steps to install and run a (SETI) project:
STEP 1) Install BOINC client
The installation of the BOINC client requires using EPEL repository. Become root user and install Epel repository and Boinc client.
sudo su yum update -y yum install -y epel-release yum install -y boinc-client systemctl start boinc-client systemctl enable boinc-client
STEP 2) Attach to a project
Here we use our SETI project to attach the server to it. There are two ways to attach to a project:
- Using URL project and account key (strong or weak – it works with both). You can get your account keys from the site project url.
- Using URL project and account info – username and password
To attach to a project your boinc client must be up and running and to use boinccmd – The command line interface to the BOINC client:
cd /var/lib/boinc boinccmd --project_attach "http://setiathome.berkeley.edu/" "111111_22222233333344444444444555555555"
The first argument of “–project_attach” is the URL address of the project site, in this case, SETI with “http://setiathome.berkeley.edu/” and the account key of our account is 111111_22222233333344444444444555555555 (this is not the real one!). After successful attach your client will start to download the project files and begin to work on units:
[myuser@compute1 ~]# boinccmd --get_tasks ======== Tasks ======== 1) ----------- name: blc36_2bit_guppi_58406_31023_HIP20352_0115.19579.818.22.45.146.vlar_0 WU name: blc36_2bit_guppi_58406_31023_HIP20352_0115.19579.818.22.45.146.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:38:07 2019 report deadline: Sat May 25 18:37:49 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4843.738587 CPU time at last checkpoint: 1326.038000 current CPU time: 1366.303000 fraction done: 0.170349 swap size: 54 MB working set size: 52 MB 2) ----------- name: blc34_2bit_guppi_58406_26949_HIP20491_0103.21476.0.21.44.1.vlar_1 WU name: blc34_2bit_guppi_58406_26949_HIP20491_0103.21476.0.21.44.1.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: uninitialized active_task_state: UNINITIALIZED app version num: 800 resources: 1 CPU estimated CPU time remaining: 5838.283108 3) ----------- ....
You can see all the tasks – the one running at the moment and those on the queue.
When the “fraction done” reaches 1.0 the tasks is ready to report.
To view all running work units and some useful links in the project site like forums, account, preferences, recent tasks, list of the computers on which you are running SETI@Home, team information and more you can use “–get_simple_gui_info” (some of the data here are changed):
[myuser@compute1 ~]# boinccmd --get_simple_gui_info ======== Projects ======== 1) ----------- name: SETI@home master URL: http://setiathome.berkeley.edu/ user_name: neoX team_name: neoX Group resource share: 150.000000 user_total_credit: 14376490.970263 user_expavg_credit: 25085.116699 host_total_credit: 0.000000 host_expavg_credit: 0.000000 nrpc_failures: 2 master_fetch_failures: 0 master fetch pending: no scheduler RPC pending: no trickle upload pending: no attached via Account Manager: no ended: no suspended via GUI: no don't request more work: no disk usage: 0.000000 last RPC: Tue Apr 2 17:19:56 2019 project files downloaded: 1554212310.422403 GUI URL: name: Message boards description: Correspond with other users on the SETI@home message boards URL: http://setiathome.berkeley.edu/forum_index.php GUI URL: name: Help description: Ask questions and report problems URL: http://setiathome.berkeley.edu/forum_help_desk.php GUI URL: name: Account description: View your account information URL: http://setiathome.berkeley.edu/home.php GUI URL: name: Preferences description: View and modify your computing preferences URL: http://setiathome.berkeley.edu/prefs.php?subset=global GUI URL: name: Tasks description: View your recent tasks URL: http://setiathome.berkeley.edu/results.php?userid=111111 GUI URL: name: Computers description: View a list of the computers on which you are running SETI@Home URL: http://setiathome.berkeley.edu/hosts_user.php?userid=111111 GUI URL: name: Team description: View information about your team: neoX Group URL: http://setiathome.berkeley.edu/team_display.php?teamid=22222 GUI URL: name: Donate description: Donate to SETI@home URL: http://setiathome.berkeley.edu/sah_donate.php jobs succeeded: 16 jobs failed: 0 elapsed time: 107328.542101 cross-project ID: 33333333333333333333333333333333 ======== Tasks ======== 1) ----------- name: blc34_2bit_guppi_58406_27281_HIP20917_0104.20977.818.21.44.184.vlar_1 WU name: blc34_2bit_guppi_58406_27281_HIP20917_0104.20977.818.21.44.184.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4658.869936 CPU time at last checkpoint: 1902.641000 current CPU time: 1949.207000 fraction done: 0.202014 swap size: 58 MB working set size: 56 MB 2) ----------- name: blc34_2bit_guppi_58406_28625_HIP21029_0108.20913.818.21.44.250.vlar_1 WU name: blc34_2bit_guppi_58406_28625_HIP21029_0108.20913.818.21.44.250.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4586.517845 CPU time at last checkpoint: 1903.475000 current CPU time: 1909.324000 fraction done: 0.214406 swap size: 58 MB working set size: 56 MB 3) ----------- name: blc34_2bit_guppi_58406_27281_HIP20917_0104.20977.818.21.44.149.vlar_0 WU name: blc34_2bit_guppi_58406_27281_HIP20917_0104.20977.818.21.44.149.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4643.434099 CPU time at last checkpoint: 1902.425000 current CPU time: 1904.189000 fraction done: 0.204658 swap size: 58 MB working set size: 56 MB 4) ----------- name: blc34_2bit_guppi_58406_26949_HIP20491_0103.21476.0.21.44.21.vlar_1 WU name: blc34_2bit_guppi_58406_26949_HIP20491_0103.21476.0.21.44.21.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4636.707813 CPU time at last checkpoint: 1845.896000 current CPU time: 1862.998000 fraction done: 0.205810 swap size: 54 MB working set size: 52 MB 5) ----------- name: blc34_2bit_guppi_58406_28965_HIP20350_0109.21465.0.22.45.59.vlar_1 WU name: blc34_2bit_guppi_58406_28965_HIP20350_0109.21465.0.22.45.59.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4665.477705 CPU time at last checkpoint: 1781.304000 current CPU time: 1805.969000 fraction done: 0.200882 swap size: 58 MB working set size: 56 MB 6) ----------- name: blc34_2bit_guppi_58406_28625_HIP21029_0108.20913.818.21.44.210.vlar_1 WU name: blc34_2bit_guppi_58406_28625_HIP21029_0108.20913.818.21.44.210.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4675.696451 CPU time at last checkpoint: 1780.113000 current CPU time: 1784.886000 fraction done: 0.199132 swap size: 58 MB working set size: 56 MB 7) ----------- name: blc34_2bit_guppi_58406_28965_HIP20350_0109.21465.0.22.45.101.vlar_1 WU name: blc34_2bit_guppi_58406_28965_HIP20350_0109.21465.0.22.45.101.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4705.804477 CPU time at last checkpoint: 1711.990000 current CPU time: 1768.862000 fraction done: 0.193975 swap size: 54 MB working set size: 52 MB 8) ----------- name: blc34_2bit_guppi_58406_28625_HIP21029_0108.20913.818.21.44.254.vlar_1 WU name: blc34_2bit_guppi_58406_28625_HIP21029_0108.20913.818.21.44.254.vlar project URL: http://setiathome.berkeley.edu/ received: Tue Apr 2 13:43:18 2019 report deadline: Sat May 25 18:42:59 2019 ready to report: no state: downloaded scheduler state: scheduled active_task_state: EXECUTING app version num: 800 resources: 1 CPU estimated CPU time remaining: 4928.870679 CPU time at last checkpoint: 1422.330000 current CPU time: 1466.627000 fraction done: 0.155767 swap size: 54 MB working set size: 52 MB
boinccmd – the management tool for the command line
Here are the options you can use in version 7.14.2:
[myuser@compute1 ~]# boinccmd --help usage: boinccmd [--host hostname] [--passwd passwd] [--unix_domain] command default hostname: localhost default password: contents of gui_rpc_auth.cfg Commands: --acct_mgr attach URL name passwd attach to account manager --acct_mgr info show current account manager info --acct_mgr sync synchronize with acct mgr --acct_mgr detach detach from acct mgr --client_version show client version --create_account URL email passwd name --file_transfer URL filename op file transfer operation op = retry | abort --get_app_config URL show app config for given project --get_cc_status --get_daily_xfer_history show network traffic history --get_disk_usage show disk usage --get_file_transfers show file transfers --get_host_info --get_message_count show largest message seqno --get_messages [ seqno ] show messages > seqno --get_notices [ seqno ] show notices > seqno --get_project_config URL --get_project_status show status of all attached projects --get_proxy_settings --get_simple_gui_info show status of projects and active tasks --get_state show entire state --get_tasks show tasks --get_old_tasks show reported tasks from last 1 hour --join_acct_mgr URL name passwd same as --acct_mgr attach --lookup_account URL email passwd --network_available retry deferred network communication --project URL op project operation op = reset | detach | update | suspend | resume | nomorework | allowmorework | detach_when_done | dont_detach_when_done --project_attach URL auth attach to project --quit tell client to exit --quit_acct_mgr same as --acct_mgr detach --read_cc_config --read_global_prefs_override --run_benchmarks --set_gpu_mode mode duration set GPU run mode for given duration mode = always | auto | never --set_host_info product_name --set_network_mode mode duration set network mode for given duration mode = always | auto | never --set_proxy_settings --set_run_mode mode duration set run mode for given duration mode = always | auto | never --task url task_name op task operation op = suspend | resume | abort
More clients in EPEL repository
[myuser@compute1 ~]# yum search boinc Loaded plugins: fastestmirror Loading mirror speeds from cached hostfile * base: mirror.checkdomain.de * epel: mirror.wiuwiu.de * extras: mirror.checkdomain.de * updates: mirror.checkdomain.de ============================================================================ N/S matched: boinc ============================================================================ boinc-client.x86_64 : The BOINC client boinc-client-devel.x86_64 : Development files for boinc-client boinc-client-doc.noarch : Documentation files for boinc-client boinc-client-static.x86_64 : Static libraries for boinc-client boinc-manager.x86_64 : GUI to control and monitor boinc-client Name and summary matches only, use "search all" for everything.
Troubleshooting
If you get the follwoing error:
root@srv ~ # boinccmd --project_attach "http://boinc.bakerlab.org/rosetta/" "1111_111111111111111111111111111" Operation failed: authentication error
You must change the directory to “/var/lib/boinc” and run the command again. You may chown the directory to the boinc user. A directory for the project is created under “projects/” and a configuration file is created with name “account_boinc.bakerlab.org_rosetta.xml”.
root@srv ~ # cd /var/lib/boinc
root@srv /var/lib/boinc # boinccmd --project_attach "https://boinc.bakerlab.org/rosetta/" "1111_111111111111111111111111111"
root@srv chown -R boinc:boinc /var/lib/boinc
root@srv /var/lib/boinc # ls -altr projects/boinc.bakerlab.org_rosetta/
total 8
drwxrwx--x 4 boinc boinc 4096 Apr 4 03:01 ..
drwxrwx--x 2 boinc boinc 4096 Apr 4 03:01 .
root@srv /var/lib/boinc # cat account_boinc.bakerlab.org_rosetta.xml
<account>
<master_url>https://boinc.bakerlab.org/rosetta/</master_url>
<authenticator>1111_111111111111111111111111111</authenticator>
<project_name>Rosetta@home</project_name>
<project_preferences>
<resource_share>15</resource_share>
<project_specific>
<color_scheme>Tahiti Sunset</color_scheme>
</project_specific>
</project_preferences>
<gui_urls>
<gui_url>
<name>Message boards</name>
<description>Correspond with other users on the Rosetta@home message boards</description>
<url>http://boinc.bakerlab.org/rosetta/forum_index.php</url>
</gui_url>
<gui_url>
<name>Your account</name>
<description>View your account information</description>
<url>http://boinc.bakerlab.org/rosetta/home.php</url>
</gui_url>
<gui_url>
<name>Your tasks</name>
<description>View the last week or so of computational work</description>
<url>http://boinc.bakerlab.org/rosetta/results.php?userid=xxxx</url>
</gui_url>
</gui_urls>
</account>