3.6. Исполняемые файлы распределенного приложения
В подкаталоге apps/ каталога проекта находятся файлы приложения, которые будут выполняться на клиент-компьютерах участников проекта. Для этого необходимо создать в каталоге apps/ подкаталог с именем приложения (которое совпадает с именем в фале project.xml: uppercase). В новый каталог надо скопировать исполняемые файлы приложений разработанных для различных платформ, описанных выше.
Имя исполняемого файла должно строго соответствовать следующему формату:
<�имя приложения>_<�версия>_<�платформа>[.<�расширение>]
Именно этот формат используется для записи имени в нашем случае:
имя приложения: meapp;
версия: 1.0;
платформа: windows_intelx86;
расширение: .exe;
В каталоге ~/server_stable/apps располагаются исполняемые файлы для платформ и исходные коды приложений uppercase, которые можно использовать и собирать проекты для любой интересующей вас платформы.
Если все исполняемые файлы расположены в указанном месте и были внесены необходимые правки в project.xml, следует занести новую информацию в базу данных.
Для этой цели есть специальная утилита называемая update_version:
boincadm@boincserver:~/projects/meapp> ./bin/update_version
Утилита идентифицирует исполняемые файлы и подбирает для них подходящие платформы:
Found version 100 for
: meapp _1.0_ windows_intelx86
Далее предлагается формирование электронной подписи для исполняемых файлов. Заканчивается процесс добавления приложения следующими строками:
Committed:
Touched trigger file to make feeder re-read app_version table from database
Done
Проверить список поддерживаемых платформ можно перейдя по ссылке *server-ip*/apps.php (рисунок 4).
Рисунок 4. Приложения и поддерживаемые платформы
3.7. Создание рабочих единиц проекта
После завершения этапа по созданию проекта. Следующим будет этап создания рабочей единицы (Work Unit) для нашего проекта.
Сначала создаем текстовый документ в каталоге download, файл будет содержать исходные данные для приложения meapp:
boincadm@boincserver:~/projects/ meapp > echo
"Hello BOINC World" > download/in
Теперь нужно создать шаблоны входных и выходных данных в подкаталоге templates.
Шаблоны входных и выходных данных
Различные свойства заданий, таких, как количество и наименование их входных и выходных файлов, описываются парой XML документов, называемых шаблонами ввода и вывода. Обычно те же шаблоны используются нескольких заданий.
Шаблоны входных данных
Файл шаблона ввода описывает входные файлы задания: потребности в ресурсах и параметры планирования.
Он имеет вид:
«
0
[ ]
[ ]
[ ]
[ ]
[ ... ]
[ ... ]
[ ... ]
[ ... ]
[... other files ]
0
NAME
[ ]
[... other files ]
[ -flags xyz ]
[ x ]
[ x ]
[ x ]
[ x ]
[ x ]
[ x ]
[ x ]
[ x ]
[ x ]
[ x ]
[ N ]
» [12]
Элементы и теги должны быть на отдельных строках, как показано.
Каждый описывает входной файл:
Используйте 0, 1, ...
переводит файл в формат gzipp (сжатым), чтобы уменьшить нагрузку на сеть. Вы должны поставить файл с ключом --gzip. Только 7.0+ клиенты могут обращаться с сжатыми файлами; старые клиенты будут скачивать файлы в несжатом виде.
если он присутствует, файл остается в клиенте после завершения задания.
если он присутствует, файл не удаляется с сервера после завершения задания. Используйте это, если файл используется в качестве входных данных для более чем в одной работе.
если он присутствует, файл отчета будет в каждом запросе планировщика. Включите это для совместимости со старыми (до 7.x) клиентов; 7.0+ клиенты сообщают какие файлы должны остаться.
Следующие ключи используются для файлов, которые располагаются на сервере (или серверах), которые находятся вне вашего сервера BOINC:
задает каталог (т.е. он должен заканчиваться /), в котором имя файла будет добавлено, чтобы дать ему URL. Если файл копируется, вы можете поставить больше, чем один.
Проверка контрольной суммы MD5
Размер файла. : если задается, размер файла GZIP.
описывает путь файла, на который ссылается:
0, 1, и т.д.
Логическое имя файла
Если присутствует, файл копируется в папку “рабочего слота”
Рабочие параметры включают:
Аргументы командной строки, которые передаются в главную программу.
Примечание: если вы используете оболочку BOINC, используйте в файле job.xml, чтобы передать аргументы командной строки из обертки (the wrapper) к завернутый приложениям(the wrapped application).
и т.д.
Работа имеет атрибуты, такие как объем дискового пространства будет использоваться. BOINC будет поставлять разумные значения по умолчанию для них, но вы должны поставить правильные значения; в противном случае, например, BOINC может попробовать запустить работу на хост с недостаточным дисковым пространством.
Укажите класс на размер задания.
Шаблон ввода (замещенный с именами файлов и URL-адресов) хранятся в поле базы данных с лимитом 64 КБ. Этого достаточно для примерно 200 входных файлов, меньше, если вы используете длинные имена файлов или несколько URL ссылок. Если этого не достаточно, вы можете использовать BOINC сжатие файлов, чтобы поместись несколько файлов в одну ссылку на для скачивания, а также расширение их до запуска на клиентской машине.
Шаблоны вывода
Файл шаблона вывода описывает выходные файлы задания. Оно имеет вид:
32768
[ ]
result.sah
[ 0|1 ]
[ 0|1 ]
[ 0|1 ]
[ ]
[ ]
Элементы и теги должны быть на отдельных строках, как показано на рисунке. Элементы включают в себя:
описывает выходной файл.
физическое имя файла. Обычно используют , и т.д.; BOINC заменит сгенерированным именем на основе имени задания.
устарел, но вам нужно включить это чтобы работать с старыми версиями клиентов ниже 7.0.
использовать это, чтобы сжать выходной файл перед загрузкой,
Описывает, как как выходной файл будет распознан приложением.
логическое имя, по которому приложение будет ссылаться на файл.
если он присутствует, файл будет создан в каталоге слот, и скопировать в каталог проекта, после работы закончен. Используйте это для унаследованных приложений.
всегда включают это для выходных файлов.
Максимальный размер файла. Если фактический размер превышает этот, файл не будет загружен, и работа будет отмечена как ошибка.
Адрес обработчика загрузки файла. Вы можете вставить это в явном виде, или использовать , чтобы использовать URL-адрес в файле config.xml вашего проекта.
если 0 или отсутствует, ваше приложение должно создать файл, в противном случае работа будет отмечена как ошибка.
если это true, не включайте этот файл в процессе проверки (результат относится только если вы используете простой побитовый валидатор).
если он присутствует, файл не будет удален на сервере даже после завершения задания.
если он присутствует, клиенты будут сообщать работу сразу же после того как выходные файлы загружены. В противном случае они могут ждать до дня. (Реализовано в 6.12.27+ клиентах только).
Примечание: при его создании, имя его шаблона выходного файла сохраняется в базе данных. Файл читается, когда выходные файлы создаются, которые могут использоваться в течении нескольких дней или недель спустя. Таким образом, редактирование файла шаблона вывода может повлиять на существующие файлы вывода. Если это не желательно, необходимо создать новый файл шаблона вывода.
Вы можете безопасно удалить файл шаблона ввода после создания последнего файла работы с ним. Тем не менее, файлы шаблонов вывода должен существовать до тех пор, пока любая задача, что относится к нему, не будет завершена (т.е. копии больше не будут созданы).
Шаблон вывода, связаны с именами файлов и URL-адресов, хранится в поле базы данных с лимитом 64 КБ. Это накладывает ограничение около 50 выходных файлов; Точное количество зависит от длины ваших файлов и URL-адресов. Если вам нужно больше файлов, вы можете использовать BOINC сжатие файлов, чтобы поместись несколько файлов в одну ссылку на файл для загрузки, до завершения каждой задачи на клиентской машине. После того как вы запустите несколько рабочих мест за счет вашего проекта, вы можете сравнить размер расширенного XML с 65535 предела, выполнив следующую MySQL запрос:
select max(length(xml_doc_in)), max(length(xml_doc_out)) from result;
Теперь все готово к созданию рабочего задания нашего проекта. Запускаем следующую команду:
boincadm@boincserver:~/projects/meapp> ./bin/create_work
-appname meapp -wu_name test -wu_template templates/meapp_wu
-result_template templates/meapp_result in
Где:
--appname <�название> – название приложения;
--wu_name <�название> – название рабочего задания;
--wu_template <�имя файла> – локальный путь и имя файла шаблона рабочего задания, принадлежащего проекту. Обычно шаблоны располагается в templates/ ;
--result_template <�имя файла> – локальный путь и имя файла шаблона результата, принадлежащего к проекту.
В утилите create_work имеется множество дополнительных, но необязательных, параметров, узнать о которых можно на странице BONC-wiki.
|
