Вы находитесь здесь: distributed.ru » BOINC » Настройка BOINC клиента
Содержание
Настройка BOINC клиента
Файлы конфигурации
Оригинал на сайте BOINC и далее по ссылкам.
В папке с установленным BOINC клиентом могут находиться несколько дополнительных файлов с настройками самого клиента BOINC (файл boinc.exe или boinc). Если этих файлов нет (а по умолчанию их, как правило, нет) то их можно (если нужно) создать вручную.
- global_prefs_override.xml - локальные настройки BOINC общие для всех проектов. Описание см. ниже. Оригинал объяснения на сайте BOINC. Дополнение.
- cc_config.xml - специальные настройки BOINC клиента (boinc.exe). В основном фильтры сообщений. Описание см. ниже. Оригинал объяснения на сайте BOINC.
- gui_rpc_auth.cfg - пароль BOINC. Описание см. ниже. Оригинал объяснения на сайте BOINC.
- remote_hosts.cfg - список разрешённых компьютеров. Описание см. ниже. Оригинал объяснения на сайте BOINC.
Локальные "общие настройки" BOINC
Оригинал объяснения на сайте BOINC. Дополнение.
Файл global_prefs_override.xml.
Локально хранимые настройки BOINC, общие для всех проектов (стандартный путь изменения данных настроек - через вэб-интерфейс на сайте одного из проектов в вашей учётной записи), подробнее о формате файла и самих настройках можно почитать здесь.
Настройки BOINC клиента (cc_config.xml)
Оригинал объяснения на сайте BOINC.
Файл cc_config.xml.
Формат файла:
<cc_config>
<options>
[ <save_stats_days>N</save_stats_days> ]
[ <dont_check_file_sizes>0|1</dont_check_file_sizes> ]
[ <ncpus>N</ncpus> ]
[ <max_file_xfers>N</max_file_xfers> ]
[ <max_file_xfers_per_project>N</max_file_xfers_per_project> ]
</options>
<log_flags>
[ flags ]
</log_flags>
</cc_config>
| . | XML тэг | Объяснение |
|---|---|---|
| <options> | . | |
| . | <save_stats_days> | Указывается количество дней за которые надо хранить статистику (в BOINC менеджере это страница «Статистика»). Стандартно 30 дней. |
| . | <dont_check_file_sizes> | Если задано отличное от 0 число - то не проверять размеры файлов.  |
| . | <ncpus> | Количество одновременно обрабатываемых заданий, клиенту boinc принудительно указывается количество якобы установленных процессоров. Данный тег введён для отладки, что-то вроде эмулятора многопроцессорной системы. |
| . | <max_file_xfers> | Максимальное количество одновременно передаваемых файлов (по умолчанию 8) |
| . | <max_file_xfers_per_project> | Максимальное количество одновременно передаваемых файлов для одного проекта (по умолчанию 2) |
| </options> | . | |
| <log_flags> | Фильтры сообщений передаваемых BOINC клиентом (через GUI RPC и/или в файлы). В BOINC менеджере это страница «Сообщения». <тэг>0</тэг> - выкл. сообщения <тэг>1</тэг> - вкл. сообщения | |
| Вывод данных сообщений по умолчанию включен (1): | ||
| . | <task> | Запуск, перезапуск, пауза и завершение обработки задания |
| . | <file_xfer> | Запуск, перезапуск, пауза и завершение передачи данных (через интернет) с сервера проекта |
| . | <sched_ops> | Общение с планировщиком на сервере проекта (sheduling server) |
| Вывод данных сообщений по умолчанию отключен (0): | ||
| . | <cpu_sched> | Действия связанные с распределением ресурсов поцессора (остановка обработки и возобновление) |
| . | <cpu_sched_debug> | Объяснения решения о перераспределении процессорного времени |
| . | <rr_simulation> | Results of the round-robin simulation used by CPU scheduler and work-fetch  |
| . | <debt_debug> | Изменение «размера» запрашиваемого времени для заданий на обработку в секундах для каждого проекта (размер буфера заданий) |
| . | <task_debug> | Отладочные сообщения о ходе обработки задания |
| . | <work_fetch_debug> | Изменение решения о запросе новых заданий с сервера проекта |
| . | <unparsed_xml> | Показывать все непонятные XML тэги из файлов конфигурации |
| . | <state_debug> | Изменения в структуре «client state» (скорее всего имеется в виду файл состояния работы BOINC client_state.xml) |
| . | <file_xfer_debug> | Отладочные сообщения о ходе передачи данных (через интернет) |
| . | <sched_op_debug> | Отладочные сообщения запросов и ответов сервера планировщика (sheduling server) |
| . | <http_debug> | Отладочные сообщения об HTTP операциях |
| . | <proxy_debug> | Отладочные сообщения об HTTP прокси операциях |
| . | <time_debug> | Log the passage of time. |
| . | <http_xfer_debug> | Отладочные сообщения о сетевых соединениях |
| . | <measurement_debug> | Отладочные сообщения о производительности процессора, типе операционной системы, свободном пространстве на диске и т.п. |
| . | <poll_debug> | Show what poll functions do |
| . | <guirpc_debug> | Отладочные сообщения связанные с общением через GUI RPC |
| . | <scrsave_debug> | Отладочные сообщения о экранной заставке |
| . | <app_msg_debug> | Shared-memory messages from applications. |
| . | <mem_usage_debug> | Объём памяти, используемой приложениями. |
| . | <network_status_debug> | Состояние связи с интернетом (есть связь или нет) |
| Устаревшие | ||
 | <cpu_sched_detail> | Отладочные сообщения о распределении времени ЦП |
| <sched_cpu_debug> | Отладочные сообщения о распределении ресурсов процессора |
| <net_xfer_debug> | Отладочные сообщения о сетевых соединениях |
| </log_flags> | . | |
Пример файла:
<cc_config> <options> <save_stats_days>50</save_stats_days> <dont_check_file_sizes>0</dont_check_file_sizes> <ncpus>3</ncpus> <max_file_xfers>8</max_file_xfers> <max_file_xfers_per_project>1</max_file_xfers_per_project> </options> <log_flags> <task>1</task> <file_xfer>1</file_xfer> <sched_ops>1</sched_ops> <cpu_sched>1</cpu_sched> <cpu_sched_debug>1</cpu_sched_debug> <rr_simulation>0</rr_simulation> <debt_debug>1</debt_debug> <task_debug>0</task_debug> <work_fetch_debug>0</work_fetch_debug> <unparsed_xml>1</unparsed_xml> <state_debug>0</state_debug> <file_xfer_debug>0</file_xfer_debug> <sched_op_debug>0</sched_op_debug> <http_debug>0</http_debug> <proxy_debug>0</proxy_debug> <time_debug>0</time_debug> <http_xfer_debug>0</http_xfer_debug> <measurement_debug>1</measurement_debug> <poll_debug>0</poll_debug> <guirpc_debug>0</guirpc_debug> <scrsave_debug>0</scrsave_debug> <app_msg_debug>1</app_msg_debug> <mem_usage_debug>1</mem_usage_debug> <network_status_debug>1</network_status_debug> </log_flags> </cc_config>
Удалённое управление BOINC клиентом
Описание GUI RPC на сайте BOINC.
Удалённое управление BOINC клиентом осуществляется через механизм сообщений RPC. Для того чтобы управлять boinc.exe другие программы должны соединиться с ним по TCP протоколу на порт 31416 (в ранних версиях 1043). При необходимости номер порта можно изменить с помощью ключей запуска BOINC клиента.
Из соображений безопасности было придумано два уровня защиты. Подключиться к BOINC клиенту можно только с явно заданных компьютеров (правда с помощью ключей запуска BOINC клиента можно как разрешить доступ со всех компьютеров, так и вообще запретить обмен сообщениями RPC) и только при указании правильного пароля BOINC.
Пароль BOINC
Пароль для соединения с BOINC клиентом хранится в файле gui_rpc_auth.cfg - по умолчанию создаётся произвольный пароль (запомнить невозможно), его лучше изменить. Без данного пароля управлять BOINC клиентом с удалённого компьютера не получится. В BOINC менеджере данный пароль указывается в диалоге «Дополнительно»\»Сменить компьютер…«\»BOINC менеджер - подключение к компьютеру».
Пример файла gui_rpc_auth.cfg (по умолчанию):
5bb1fd6744cb9c062aa5bf9a66922f3a
PS просьба не забывать - пробелы это тоже символы.
Список разрешённых компьютеров
По умолчанию в BOINC отключена возможность удалённого управления, для её активации надо в папке с утановленным BOINC клиентом создать файл remote_hosts.cfg со списком компьютеров, которым разрешено удалённое управление BOINC клиентом. Формат файла remote_hosts.cfg - одно сетевое имя или IP компьютера в строке, можно добавлять строки комментариев - начинаются с символа # или ;.
Пример файла remote_hosts.cfg:
# компьютер номер один 169.254.254.1 ; компьютер номер два HOME1 # компьютер номер три 169.254.254.2 ; компьютеры закончились
PS если BOINC клиент запустить с ключом -allow_remote_gui_rpc, то будет разрешено удалённое управление с любого компьютера (данный вариант, мягко говоря, не рекомендуется).
Ключи запуска BOINC клиента
Оригинал на сайте BOINC.
Формат запуска BOINC клиента с ключами:
boinc [options]
Пример:
boinc -help
| Тест | Ключ [options] | Объяснение |
|---|---|---|
| ok | -help | На экран выводится почти полный список поддерживаемых ключей |
| ok | -version | На экран выводится номер версии BOINC клиента |
| . | -attach_project URL account_key | Добавление ещё одного проекта на компьютер с установленным BOINC клиентом. Вместо URL указывается интернет адрес проекта, вместо account_key указывается ваш «код доступа» для выбранного проекта (узнать ваш код доступа можно в вашей учётной записи на сайте проекта). |
| ok | -show_projects | На экран выводится список подключенных к данному BOINC клиенту проектов |
| ok | -detach_project URL | Вместо URL указывается интернет адрес проекта. BOINC клиент удаляет указанный проект (отключение от проекта). После удаления файлов проекта, BOINC клиент завершает свою работу (проверял в оффлайне). |
| ok | -reset_project URL | Вместо URL указывается интернет адрес проекта. Переподключение к проекту - удаляются все файлы связанные с проектом и производится их повторная закачка (на случай неустранимых глюков с проектом). После удаления файлов проекта, BOINC клиент завершает свою работу (проверял в оффлайне). |
| ok | -update_prefs URL | Вместо URL указывается интернет адрес проекта. Обновить информацию с сервера проекта (настройки, запрос новых заданий, отчёт об обработанных заданиях). |
| . | -return_results_immediately | Отправлять запрос планировщику сразу после завершения обработки (и передачи) задания. По умолчанию, после отправки результатов, BOINC клиент выдерживает паузу (зачем не понятно). |
| ok | -run_cpu_benchmarks | Сразу после запуска BOINC клиента запускается тест производительности, затем BOINC клиент продолжает работу в обычном режиме.. |
| . | -check_all_logins | Если в общих настройках на сайте проекта в пункте «обрабатывать задания когда компьютер используется для работы?» указано «нет», т.е. обработка запущена только когда пользователь не работает, то обработка приостанавливается при любой активности всех подключенных к компьютеру пользователей, по умолчанию BOINC клиент следит за активностью только локальных средств ввода данных (мыши/клавиатуры). |
| . | -exit_when_idle | BOINC клиент выполняет все не завершённые задания, отправляет результаты, получает подтверждения о приёме результатов и после этого завершает работу. |
| ok | -gui_rpc_port N | Вместо N указать номер нестандартного порта для GUI RPC (по умолчанию BOINC использует порт 31416 или в ранних версиях 1043) |
| ok | -allow_remote_gui_rpc | Разрешается удалённое управление BOINC клиентом с ЛЮБОГО компьютера в сети |
| ok | -dir abs_path | Вместо abs_path указывается полный путь до произвольной папки с данными BOINC, т.е. всеми файлами кроме исполнимых (*.exe, *.dll). |
 ok | -detach | После запуска BOINC клиента появляется консольное окно и тут же исчезает (окно). Без данного ключа консольное окно висит посреди экрана и так и просит «закрой меня». (Работает в операционной системе Windows®). |
| ok bug | -no_gui_rpc | Не обмениваться сообщениями через GUI RPC. |
| . | -daemon | Запуск BOINC клиента в режиме демона. (для тех кто не в курсе это для Linux). Или в качестве службы в Windows (т.е. если при установке BOINC клиента выбрали установку в качестве сервиса (Service Installation), то BOINC клиент будет запускаться именно с этим ключом). |
| ok | -redirectio | Перенаправляет все текстовые сообщения BOINC клиента в файлы stderrdae.txt, stdoutdae.txt. По умолчанию текстовые сообщения выводятся в консольном окне. BOINC менеджер запускает клиент именно с этим ключом. |
| Отладочные ключи | ||
| -exit_when_idle | |
| -no_time_test | |
| -exit_after N | |
| -giveup_after N | |
| -limit_transfer_rate N | |
| . | -min | |
| Данные приведены для версии BOINC 5.4.9 | ||
Управление BOINC клиентом из консоли
Источник на сайте BOINC.
Для оригиналов, которые не хотят использовать программы управления с графическим интерфейсом (BOINC менеджер и т.п.) в папке BOINC имеется консольная программа управления boinccmd.exe или boinc_cmd (причём у неё есть по крайней мере один плюс - можно завершить работу BOINC клиента на удалённом компьютере).
Формат запуска данной программы:
boinc_cmd [--host hostname] [--passwd passwd] command
или
boinccmd [--host hostname] [--passwd passwd] command
Пример:
boinccmd --host 169.254.254.1 --passwd qwerty --quit
Если на компьютере, к которому идёт обращение boinc_cmd не запущен BOINC клиент появится сообщение вида:
connect: No error can't connect to local host
| Тест | Ключ | Объяснение |
|---|---|---|
| ok | --help или -h | На экран выводится полный список поддерживаемых ключей |
| ok | --version или -V | На экран выводится номер версии поддерживаемого BOINC клиента |
| ok | --host hostname[:port] | Вместо hostname указывается имя компьютера (сетевое имя или IP) на котором установлен BOINC клиент и, при необходимости, через : можно указать номер нестандартного порта (пример --host 169.254.254.1:30000). Если не указывать данный ключ, то будет использоваться значение localhost (локальный компьютер) или по-русски - будет осуществляться управление BOINC клиентом на том же самом компьютере. |
| ok | --passwd password | Вместо password указывается пароль BOINC клиента к которому осуществляется обращение. Если не указывать данный ключ, то будет использоваться пароль из файла gui_rpc_auth.cfg в папке с boinc_cmd |
| ok | --get_state | На экран выводится ВСЯ информация о подключенных проектах, используемых приложениях, заданиях и результатах (просто море информации, на экран не влезет, лучше перенаправить вывод в файл) |
| ok | --get_results | На экран выводится информация о текущих заданиях (информация аналогична –get_state, но только пункт ======== Results ========) |
| ok | --get_file_transfers | На экран выводится информация о передаваемых файлах данных (в BOINC менеджере это страница «Передача») |
| ok | --get_project_status | На экран выводится информация о подключенных проектах (информация аналогична –get_state, но только пункт ======== Projects ========) |
| ok | --get_disk_usage | На экран выводится информация о занятом проектами дисковом пространстве |
| ok | --result URL result_name {suspend | resume | abort | graphics_window | graphics_fullscreen} {--window_station ws} {--desktop dt} {--display dp} | Манипуляции с загруженными заданиями на обработку. Вместо URL указывается интернет адрес проекта, а вместо result_name имя задания. suspend - «Приостановить» обработку задания, resume - «Запустить» обработку задания, abort - «Прервать обработку» задания, graphics_window - «Показать графику», graphics_fullscreen - показать графику в полноэкранном режиме. Пример запуска: boinccmd.exe --result http://setiweb.ssl.berkeley.edu/beta/ 01jn01aa.13689.12977.467332.3.84_1 suspend |
| ok | --project URL {reset | detach | update | suspend | resume | nomorework | allowmorework} | Вместо URL указывается интернет адрес проекта. Манипуляции с подключенными проектами: reset - «Перезапустить проект», detach - «Удалить проект», update - «Обновить» информацию с сервера проекта, suspend - «Приостановить» обработку проекта, resume - «Запустить» обработку проекта, nomorework - «Не запрашивать задания», allowmorework - «Получать новые задания». Пример запуска: boinccmd.exe --project http://ufluids.net/ nomorework |
| ok | --project_attach URL auth | Добавление ещё одного проекта на компьютер с установленным BOINC клиентом. Вместо URL указывается интернет адрес проекта, а вместо auth указывается ваш «код доступа» для выбранного проекта (узнать ваш код доступа можно в вашей учётной записи на сайте проекта). |
| ok | --file_transfer URL filename {retry | abort} | Манипуляции с передаваемыми файлами (через интернет). Вместо URL указывается интернет адрес проекта, а вместо filename - имя передаваемого файла. retry - «Повторить» передачу файла, abort - «Удалить» передаваемый файл. Пример запуска: boinccmd.exe --file_transfer http://setiweb.ssl.berkeley.edu/beta/ setiathome_5.15_windows_intelx86.exe retry |
| ok | --get_run_mode | На экран выводится информация о текущем расписании обработки (<allow/>-«Постоянная обработка», <auto/>-«График работы определяется настройками», <never/>-«Приостановить обработку») |
| ok | --set_run_mode {always | auto | never} | Установить график работы: «always» - «Постоянная обработка», «auto» - «График работы определяется настройками», «never» - «Приостановить обработку». Пример запуска: boinccmd.exe --set_run_mode always |
| ok | --get_network_mode | На экран выводится информация о состоянии доступа в интернет (<allow/>-«Подключен к интернету», <auto/>-«Доступ в интернет определяется настройками», <never/>-«Работать автономно») |
| ok | --set_network_mode {always | auto | never} | Установить режим доступа в интернет: «always»-«Подключен к интернету», «auto»-«Доступ в интернет определяется настройками», «never»-«Работать автономно». Пример запуска: boinccmd.exe --set_network_mode never |
| --get_proxy_settings | |
| . | --set_proxy_settings http_server_name http_server_port http_user_name http_user_passwd socks_server_name socks_server_port socks_version socks5_user_name socks5_user_passwd | Изменить настройки прокси. Все поля обязательны. |
| ok | --get_messages seqno | Вместо seqno указывается целое число. На экран выводятся текстовые сообщения с порядковыми номерами больше seqno (в BOINC менеджере это страница «Сообщения») |
| ok | --get_host_info | На экран выводится информация о компьютере на котором установлен BOINC клиент (процессор, IP, память) |
| . | --acct_mgr_rpc URL name password | |
| ok | --run_benchmarks | Запускает тест производительности |
| ok | --get_screensaver_mode | Выводит на экран примерно следующее screensaver mode: 0 |
| . | --set_screensaver_mode on|off blank_time {--desktop desktop} {--window_station window_station} {--display display} | Настройка экранной заставки BOINC. |
| ok | --read_global_prefs_override | Команда клиенту BOINC перечитать файл с локальными общими настройками global_prefs_override.xml (изменение общих настроек без перезапуска BOINC) |
| new | --get_project_config url | |
| new | --get_project_config_poll | |
| new | --lookup_account url email passwd | |
| new | --lookup_account_poll | |
| new | --create_account url email passwd name | |
| new | --create_account_poll | |
| ok | --quit | Завершает работу BOINC клиента (в том числе и на удалённом компьютере) |
| Данные приведены для версии BOINC 5.4.9 | ||
boinc/client.txt · Последние изменения: 2007-11-18 10:07 RM
