====== Интерфейс командной строки системы управления выполнением заданий ====== Данная инструкция описывает процесс установки и настройки программной среды ГридННС, необходимой для работы с сервисом распределения и контроля заданий Пилот (СРКЗ Пилот) и для работы с серверами хранения данных (на основе GridFTP) через интерфейс командной строки (ИКС). Инструкция предполагает, что на компьютере пользователя установлен один из следующих Linux-дистрибутивов: CentOS 5.x, Red Hat Enterprise Linux 5.x, или Scientific Linux 5.x. Для других дистрибутивов Linux установка существующих бинарных файлов с ИКС-клиентами может либо потребовать дополнительных действий, либо оказаться невозможной. **Внимание!** Для выполнения ряда команд Вам понадобится права пользователя root. В случае возникновения проблем, сообщите о них через [[http://www.ngrid.ru/trac/newticket|систему билетов ГридННС]] или обсудите со своими коллегами через список рассылки для [[http://lists.ngrid.ru/mailman/listinfo/users|пользователей]] ГридННН. ===== Предварительные требования ===== Для работы ИКС-клиента СРКЗ Пилот необходимы пакеты ПО, входящие в репозиторий ПО [[http://fedoraproject.org/wiki/EPEL|Extra Packages for Enterprise Linux (EPEL)]]. Чтобы подключить этот репозиторий воспользуйтесь [[http://fedoraproject.org/wiki/EPEL/FAQ#howtouse|инструкцией]] с сайта репозитория, а так же [[http://wiki.centos.org/PackageManagement/Yum/Priorities|инструкцией]] по использованию yum-priorities. Кратко эти инструкции изложены далее. Если к вашей системе уже подключен репозиторий EPEL, шаги из данного раздела можно пропустить. Все действия, описываемые далее в настоящем разделе необходимо выполнять от пользователя ''root''. * Установка и настройка yum-priorities - Установите пакет ''yum-priorities'': yum install yum-priorities - Убедитесь, что плагин активен. Для этого откройте в редакторе файл ''/etc/yum/pluginconf.d/priorities.conf'' и убедитесь, что в нем есть строки: [main] enabled=1 Добавьте их при необходимости. - Настройте приоритеты системных репозиториев. В файле ''/etc/yum.repos.d/CentOS-Base.repo'' добавьте следующие строки: в каждой из секций ''[base]'', ''[updates]'', ''[addons]'', ''[extras]'' добавьте строку priority=1 в каждой из секций ''[centosplus]'', ''[contrib]'' добавьте строку priority=2 * Установка и настройка репозитория EPEL - Установите пакет ''epel-release-5-4.noarch.rpm'': rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm rm -f epel-release-5-4.noarch.rpm //Замечание//: Если при попытке установить этот пакет появляется сообщение об ошибке типа "transfer failed", зайдите с помощью веб-браузера на сайт http://download.fedora.redhat.com/pub/epel/5/i386 и уточните название пакета: возможно изменение последней цифры в обозначении релиза (например, вместо пакета epel-release-5-4.noarch.rpm окажется пакет epel-release-5-5.noarch.rpm). - Отредактируйте файл ''/etc/yum.repos.d/epel.repo'', добавьте строчку priority=20 в секцию ''[epel]''. * Установка репозитория ngrid: wget -O /etc/yum.repos.d/ngrid.repo http://koji.ngrid.ru/ngrid.repo ===== Установка ИКС-клиента СРКЗ Пилот ===== После установки и настройки системных репозиториев (см. предыдущий раздел) для установки pilot cli достаточно выполнить команду (от пользователя root): yum install pilot-cli Обновления pilot cli будут устанавливаться автоматически при обновлении системы (например, командой ''yum update''). Установите переменную окружения в соответствии адресом сервера СРКЗ Пилот (его можно найти на сайте службы регистрации ресурсов и грид-сервисов ГридННС (https://reg.ngrid.ru)). Например, $ export PILOT_SERVER='https://tb01.ngrid.ru:5053/' Для того, чтобы не делать этого при каждом входе в систему, включите указанные строки с экспортом значений переменных в rc-файл соответствующей Linux-оболочки, например, в файл .bashrc (в случае использования оболочки bash). Переодически выпускаются обновления для pilot-cli, которые публикуются в репозитории ngrid. При возникновении любых проблем рекомендуется сначала проверить наличие обновлений и установить их, если они есть. Для этого необходимо выполнить команду: yum update pilot-cli ===== Установка ИКС-клиента GridFTP ===== Для передачи файлов с данными (входные данные для задач и результаты вычислений) с компьютера пользователя в среду ГридННС и обратно используется протокол GridFTP. Поэтому на компьютере пользователя должен быть установлена клиентская программа GridFTP, которая находится в репозитории EPEL (см. Предварительные требования). Для ее установки необходимо выполнить команду (от пользователя root): yum install uberftp ===== Установка и настройка подсистемы безопасности ===== Для работы с сертификатами ГридННС необходимо установить пакет ''ca_GridNNN'', это можно сделать выполнив команды: wget http://rep.grid.kiae.ru/nng/noarch/ca/ca_GridNNN-1.0-0.noarch.rpm rpm -ivh ca_GridNNN-1.0-0.noarch.rpm rm -f ca_GridNNN-1.0-0.noarch.rpm Кроме того, необходимо установить пакеты для работы с прокси-сертификатами и сервисами VOMS и MyProxy: yum install voms-clients myproxy-client Эти пакеты доступны в репозитории EPEL (см. Предварительные требования). Цифровой сертификат и закрытый ключ пользователя необходимо поместить (скопировать) в директорию ''.globus'', находящуюся в домашней директории пользователя, который будет запускать задания на ресурсы ГридННС: $ ls -l $HOME/.globus -rw-------. 1 xxx xxx 4767 2010-03-16 19:28 usercert.pem -r--------. 1 xxx xxx 1041 2010-03-16 19:28 userkey.pem ==== Настройка клиента сервиса виртуальных организаций voms.ngrid.ru ==== Для настройки VOMS-клиентов на использование виртуальных организаций, размещенных на сервере [[https://voms.ngrid.ru/pva/|voms.ngrid.ru]], можно установить пакет ''ngrid-voms'', который доступен в репозитории ГридННС: yum install ngrid-voms ===== Использование интерфейса командной строки ===== Использование ИКС СРКЗ Пилот для запуска и контроля выполнения заданий на ресурсах ГридННС почти не отличается от работы с помощью ПИКС. Поэтому для осуществления дальнейших необходимых подготовительных действий и собственно запуска и контроля заданий пользователь должен следовать указаниям [[support:user:ucli|Руководства по работе в среде ГридННС через Пользовательский интерфейс командной строки (ПИКС)]]. Единственным, но важным отличием является работа с входными и выходными данными. Таким образом, отличия при работе с ИКС от "Руководства по работе в среде ГридННС через ПИКС" касаются **только** подраздела //"Запуск задания с входными и выходными файлами"//. Так как в состав ИКС не входит сервер хранения данных, а только его клиентская программа (uberftp), для запуска заданий с входными данными и получения результатов пользователь ИКС должен иметь доступ по протоколу GridFTP на какой-либо сервер хранения данных, входящий в инфраструктуру ГридННС. Список и URL серверов грид-инфраструктуры можно получить на веб-странице [[https://reg.ngrid.ru/sites.aspx | сервиса регистрации ресурсов и грид-сервисов]]. Для получения консультаций о возможности получения такого доступа необходимо связаться с менеджером своей виртуальной организации. При наличии такого доступа все входные файлы задания предварительно (до запуска задания) должны быть переданы на доступный сервер хранения данных с помощью команды uberftp, например: uberftp file:///home/ivanov/tst.txt gsiftp://tb05.ngrid.ru/home/ivanov/tst1.txt (здесь tst.txt - файл с входными данными). Соответственно в описании задания (как и в случае ПИКС) необходимо указать URI этих файлов на сервере хранения данных, куда они были переданы. То же самое касается выходных данных, которые аналогичным обзом - с помощью команды uberftp - могут быть получены с сервера хранения данных на компьютер пользователя после успешного завершения выполнения задания.