Читайте также статьи и материалы о технологиях Rational и Microsoft в блоге Новичкова Александра и Шамрая Александра

Использование командной строки в IBM Rational ClearCase

 Командная строка IBM Rational ClearCase открывает по сути безграничные возможности по управлению проектом. Имеется ряд операций, для которых нет графического модуля,  соответственно вызывать команды данного типа можно только из cleartool.
Автор: Новичков Александр

Видео и презентационные материалы в тему статьи

Позволяет интегрировать ClearQuest и MS Project. Модуль позволяет осуществлять более глубокую интеграцию, чем стандартный модуль Rational. При формировании интеграции между базой ClearQuest и планом MS Project модуль дает гибкие возможности по выбору полей и их соответствий (синхронизируемые данные).
Принципиальная возможность модуля заключена в том, что он позволяет синхронизировать любые поля плана с репозиторием ClearQuest, а также синхронизировать иерархию между пунктами плана и зависимость пунктов!!!
Данная часть демонстрирует возможности модуля интеграции при планировании работ менеджером из MS Project.

Использование командной строки в IBM Rational ClearCase

По роду деятельности нам на семинарах и встречах приходится отвечать на вопросы, связанные с  необходимостью использования  командной строки. Очень часто слушатели и клиенты спрашивают можно ли обойтись без нее. Ответить на этот вопрос однозначно очень сложно. Мы думаем, что в природе может существовать проект, для решения задач которого командная строка не пригодится, но лично наша группа с подобными проектами не встречалась.

Командная строка IBM Rational ClearCase открывает по сути безграничные возможности по управлению проектом. Имеется ряд операций, для которых нет графического модуля,  соответственно вызывать команды данного типа можно только из cleartool.exe.

Любые команды можно группировать вместе, создавая скрипты. Скрипт как полноценная рабочая единица может заниматься рутинными задачами, такими как насыщение, однотипными данными репозиториев или управление дополнительной политикой доступа к данным. В качестве примера можно привести ситуацию с одним из заказчиков, которому было необходимо поддерживать версионность для WEB-портала. Суть заключалась в том, что портал состоял из ряда краткосрочных, но однотипных проектов (под однотипностью модно понимать метаданные VOB (Version Object Base): одинаковые типы меток, ответвлений, атрибутов, триггеров и т.д.). Единственным эффективным решением было не  ручное повторение действий по созданию контента, а перепоручение их скрипту, который на основании команд СС будет создавать необходимый контент. Это общий случай использования командной строки. Рассмотрим основные случаи, в которых оправдано использование командной строки:

• управление правами на уровне групп элементов;
• управление триггерами, и формирование на их основе сложных логических действий, расширяющих стандартный IBM Rational ClearCase;
• применение операций отката для случайно испорченного проекта;
• формирование скриптов;
• создание распределенной структуры репозиториев, с формированием сложных и эффективных связей;
• объединение команд разработчиков, работающих на разных платформ;
• объединение регионально удаленных команд разработчиков;
• формирование однотипного контента для множества репозиториев;
• любые действия по администрированию элементов, репозиториев и представлений.

Практика применения командной строки IBM Rational ClearCase

На практике приходится часто прибегать к командной строке, особенно при расширении функций IBM Rational ClearCase, а также для выполнения рутинных операций, таких как сборка релиза, отправка почтовых нотификаций, синхронизации удаленных групп, сбор проектных метрик и так далее. Для более подробного ознакомления рекомендуем прочитать следующие материалы нашего сайта:

• Метрики кода и их практическая реализация в IBM Rational ClearCase
• Сбор и публикация проектных метрик в процессе разработки Программного Обеспечения. Отчетность в IBM Rational ClearCase  
• IBM Rational ClearCase. Управление версиями файлов, сборкой.
• Зачем нам нужен план управления конфигурациями? Основные понятия и концепции документа

 Общие принципы работы с командной строкой в IBM Rational ClearCase

IBM Rational ClearCase поддерживает два режима работы пользователя  с данными: из графической оболочки и из командной строки. Оба режима функционально пересекаются лишь в наиболее часто используемых операциях. Во всех же сложных  манипуляциях, таких как: удаление элементов, принудительное проведение ответвлений, администрирование, глобальные манипуляции, а также многое другое, вынесено именно в командную строку.

Сделано так по нескольким причинам: во-первых, возможно четкое разделение участников проекта, то есть можно ограничить доступ определенной группы участников проекта к определенным типам операций. Например, разработчики могут проводить только операции сравнения, но не слияния.

Большая часть функциональности IBM Rational ClearCase находится именно в командах командной строки.

Для осуществления взаимодействия пользователя с системой предусмотрены два командных интерпретатора:

• cleartool.exe - для всех команд IBM Rational ClearCase
• multitool.exe - для управления модулем синхронизации регионально удаленных команд – MultiSite.

Интерпретаторы работают в консольном режиме. После  инсталляции IBM Rational ClearCase все интерпретаторы будут находиться в директории bin. Для простоты использования можно их переименовать, сократив имя до 2-3 букв, поскольку при интенсивном обращении  к командной строке набирать полное наименование не всегда представляется возможным и целесообразным.

С интерпретатором можно работать в двух режимах: интерактивном и пакетном. В первом случае, вызывается интерпретатор, и все остальные манипуляции по вводу команд и получению результатов, производится из него.

В пакетном режиме указывается имя интерпретатора и через пробел команду и ее параметры, например, cleartool lsvob –l.

Преимущества пакетного режима состоит в том, что определенные команды можно группировать в отдельные скрипты, либо обращаться к IBM Rational ClearCase из языков программирования высокого уровня.

В качестве языков скриптов IBM Rational ClearCase «понимает» обычные Bat-файлы, а также Perl-файлы (сам язык Perl входит в поставку IBM Rational ClearCase

В пакетном режиме можно ставить переадресацию вывода > или >>, например, для создания текстового файла с отчетом по исполнению команды. Например, cleartoollsvob –l >> report.txt. Давайте запомним эту возможность, поскольку к ней не раз придется прибегать.

Любая команда формируется по определенным законам, справедливым для большинства команд.

Принцип построения таков:

[команда] [данные] [-ключи]

или

[команда] [-ключи] [данные]

Ключи всегда начинаются со знака минус, и представляют собой модификаторы команды. Есть общее правило на модификаторы, то есть некий набор переключателей, справедливых для большинства  команд.

Рассмотрим основные ключи:

• -graphical. Для выдачи результатов вызывает графическое окно. Интересная возможность в случае со сравнением данных. В чистом графическом сравнении, имеется возможность по сравнению только 2 версий файла и получению их разницы в окне compare. В случае командной строки можно сравнивать одновременно несколько версий – 2,3… и так далее, а выдачу результатов перенаправить в графическое окно, а не в консоль;
• -long. Подробная информация. По умолчанию ClearCase всю выдачу производит в коротком представлениее (brief). Команда используется  для получения более детального отчета;
• -full. Данный переключатель, в некоторых командах, может замещать предыдущий;
• -short. Обеспечить краткую выдачу. Используется в случаях, когда первоначальная информация оказывается перенасыщенной деталями;

·        -comment «комментарий». Для большинства операций по манипуляции данными предусмотрены комментарии. В случае, когда пользователь набирает команду, требующую комментирования, но не описывает его данным ключом, система дополнительно запросит комментарий в специальном окне. Для формирования пакетных файлов, обычно, не предусматривается взаимодействие с пользователем, соответственно команде, в качестве аргументов передается данный ключ, с комментарием, находящимся в кавычках;

• -nc. Ключ ставит операции пустой комментарий.

Дополнительно отметим, что имена команд и имена переключателей можно вводить в сокращенном представление, например, вместо  -comment использовать более короткий -с.

Единственное правило на сокращения выглядит так: если есть  две или более команд, начинающихся с одной и той же буквы, то сокращение  проводится до 2-3 букв (и более), уникально идентифицирующих команду.

ClearCase снабжается удобной справочной системой, подробно описывающей, все команды командной строки. Для вызова справки необходимо из интерпретатора набрать команду «man», а в качестве параметров имя той команды, по которой необходимо получить подсказку.

Например:

man lsvob

При работе с командной строкой используются язык запросов и язык форматного вывода

Основные команды командного интерпретатора cleartool

В этом разделе мы вкратце рассмотрим основные команды IBM Rational ClearCase которые дадут читателю представление о его возможностях.

Мы не ставили перед собой цели делать руководство по эксплуатации команд – для этого есть документация и детальная справочная система. Здесь мы описываем лишь самые основные команды, описываем их предназначение и приводим практические примеры использования.

 annotate

 Аннотирует (описывает) изменения, проведенные с элементом. Очень эффективная команда, которая позволяет просматривать разницу между несколькими версиями одного элемента. Для работы annotate создает временный текстовый файл с аннотацией (ему присваивается расширение ann). Данный файл не ставится под управление и представляется private объектом для созданного представления). Команда поддерживает форматный вывод с использованием ключа -fmt.

 annotate -fmt "%a %c" -rm –nheader  util.c
Выводит информацию о версиях файла. Для вывода используется форматный способ.

annotate -long msg.c

Описывается файл msg.c стандартным образом в расширенном варианте

annotate -short msg.c

Описывается файл msg.c стандартным образом в сокращенном варианте

catcs

Получить конфигурационную спецификацию (CS) для текущего или указанного представления

 catcs

Получить конфигурационную спецификацию для текущего представления

catcs –tag Development

Получить CS для представления с именем Development

cd

Сменить директорию. Обычная системная команда, дополнительно реализованная в интерпретаторе СС

cd ..

Перейти на уровень выше

cd m:\myvob

Перейти в указанный VOB (в корневую директорию репозитория)

checkin

Зарегистрировать элемент в репозитории. Данная операция является одной из ключевых в IBM Rational ClearCase. Только после выполнения данной команды на дереве версий элемент появится новая версия.

ci –nc .

Зарегистрировать текущую директорию. Операцию проводится без присвоения комментариев

ci –c «first out» main.cpp

Зарегистрировать файл с присвоением комментария

ci main.cpp

Зарегистрировать файл. Во время регистрации IBM Rational ClearCase дополнительно запросит комментарий для данной операции

checkout

Вывести элемент в данное состояние для внесения в него изменений. Любой элемент до подачи данной команды  имеет атрибут только для чтения, и не подлежит редактированию. Команда checkout

 Позволяет вывести элемент из данного состояния и позволить его редактировать. Редактирование проводится вплоть до применения команды checkin.

co –nc .

Вывести в режим редактирования текущую директорию (без комментария)

co –c «Правка» main.cpp

Вывод файла с предустановленным комментарием

checkvob

Проверить структуру репозитория на наличие ошибок. Позволяет проверять и исправлять ошибки связанные с хранилищем данных, с глобальными типами и с гиперссылками. Используется администраторами для восстановления функционирования репозитория.  Проверяется целостность как всего репозитория, так и его отдельных элементов. По результатам работы, в VOB, выводится директория с описанием проведенных действий. Элементы директории являются private данными, и отображаются только в представлении, с которого был инициирован процесс проверки.

checkvob main.cpp

Проверить файл на наличие ошибок

checkvob –pool –source \\compa\stg\vobs\test.vbs

Проверить все элементы указанной базы на наличие ошибок

chevent

Изменяет  комментарий для указанной версии.

Используется в тех случаях, когда комментарий, сопровождающий операцию был задан некорректно или в неправильной кодировке.

chevent main.cpp@@/main/2

Изменить комментарий для конкретной версии. Во время работы СС запросит новый комментарий и заменит существующий

chevent –c «Короткая правка» stdlib.h@@/main/1

Изменить комментарий, сопровождающий версию 1, на «Короткая правка»

сhstream

Изменить поток. Применяется при работе с IBM Rational ClearCase  в UCM для изменения набора политик, смены потока для сдачи по умолчанию и набора рекомендованных базовых линий.

chstream -c «demo» -recommended new_bl int_str@\pvob1

Изменить рекомендованную базовую линию потока «int_str@\pvob1».

chtype

Переименовать тип элемента или бренча. Используется в тех случаях, когда структурирование (определение) типов элементов репозитория  было проведено уже после постановки элементов под версионное управление.

chtype file hello.c

Приводит тип элемента hello.c к file

chtype -c "Релиз больше не используется" closed util.c@@\main\Rel2.0BugFix

Изменить ветвь  Rel2.0BugFix на closed, с сопровождающим комментарием

cptype

Копировать тип метаданных. Используется для быстрого создания однотипных записей с разными именами, но одинаковыми свойствами. Копирование особенно полезно при копировании  метаданных  между репозиториями.

cptype brtype:Rel1.0BugFix Rel2B.0ugFix

Создать новый тип ответвления  Rel2B.0ugFix , свойства которого будут идентичны имеющемуся Rel1.0BugFix,

cptype lbtype:Rel1.0@\old_vob Rel1.0@\new_vob

Скопировать тип метки из одного репозитория в другой

deliver

Сдача действия из указанного потока в поток слияний этого же, либо другого проекта. Сдачу действия можно организовать несколькими способами:

С просмотром изменений перед сдачей;

С указанием действий, потока или базовой линии, которые необходимо сдать;

С разрешением конфликтов слияния работ;

С тестированием и компилированием сданных работ в потоке слияний;

Проведение сдачи при условии существования некоторой информации в новых версиях и наборах изменений.

deliver -stream dev_str@\pvob1 -to int_view -activities dev_act –force

Сдача действия. Довольно простая ситуация - типы файлов известны ClearCase, данный процесс сдачи не пересекается с другим, подобным. Ключи в данном случае:

«stream» –поток, из которого происходит сдача действия (dev_str@\pvob1);

«to» – представление, прикреплённое к потоку слияний («int_view»);

«activities» – перечень сдаваемых действий («dev_act»);

«force» – ClearCase исключает участие пользователя в сдаче действия и процесс слияния (merge) происходит автоматически.

describe

Собирает свойства элемента. Позволяет получить полную информацию о текущем состоянии элемента или его версии. Поддерживает форматный вывод по шаблонам пользователя.

В результате работы возвращает полную информацию о состоянии элемента: от прав доступа для текущего владельца, до характеристик низкого уровня (таких как тип элемента и дата создания элемента).

desc main.cpp

Дать описание файлу main.cpp, в соответствии с установками по умолчанию

desc lbtype:Rel1.0

Дать описание свойствам метки Rel1.0

describe -fmt "ИМЯ: %Xn\nТип объекта: %m\n" main.cpp

Дать описание свойствам файла, с использованием форматного вывода (см. форматный вывод)

describe –long vob:.

Дать описание специфических характеристик текущего репозитория, таких как список добавочных и основных групп пользователей, а также список представлений и их идентификаторов, из которых ведется правка элементов

diff

Позволяет  сравнивать одну или несколько версий. При сравнении используется метод базового сравнения, при котором первый элемент в списке считается базовым, и все сравниваются не друг с другом, а с ним.

Используется в скриптах, основное применение – сравнение сразу нескольких версий одного элемента, или нескольких элементов.

diff main.cpp main.cpp@@/main/1

Сравнить две версии одного элемента в текстовом режиме

diff –g main.cpp main.cpp@@/main/1 main.cpp@@/main/3

Сравнить три версии одного элемента графически (базовой считается первая версия, остальные демонстрируют изменения по отношению к ней)

diff dir dir@@/main/2

Сравнит две версии директории. При этом можно наблюдать только  состав самих директорий (наличие или отсутствие файлов)

diffcr

Сравнивает две и более конфигурационных записей (результатов компиляции), получаемых в результате работы omake и clearmake

Применяют в случае наличия сложной истории перекомпиляций проекта

diffcr -flat release.exe release.exe@@11-aug.19:30.2002

Сравнить текущую запись с записью от  указанной даты

edcs

Редактировать конфигурационную спецификацию в редакторе по умолчанию (для windows, обычно Notepad).

Используется для локальной правки CS. Команда не воздействует на оригинальные профили и спецификации сервера и не может помешать остальным участникам проекта

edcs

Вызов конфигурационной спецификации для ее правки (вызывается редактор по умолчанию – notepad). Для текущего представления

edcs –tag Development

Вызов редактирования CS для указанного представления Development, при этом находится можно в любом View

find

Поиск и обработка данных. Одна из самых мощных команд. Обладает всеми возможностями по поиску элементов, вплоть до конкретной версии элемента. Из преимуществ можно отметить использование командой языка запросов, по которому проводится поиск и систему обработку информации, при помощи которой можно заставить исполняться определенный скрипт на найденных данных.

Используется команда во всех случаях когда надо что-нибудь найти и как-то обработать. Особенно часто данная команда применяется для исправления ошибочной проектной структуры, позволяя тем самым,  осуществить операцию отката

find . -element «eltype(directory)» -all –print

Найти и распечатать на экране все элементы, тип которых ДИРЕКТОРИЯ. Поиск осуществляется от текущей директории.

find . -ver «version(/main/0) && created_by(admin)» -all –print

Найти все элементы, у которых есть НУЛЕВАЯ версия, созданная пользователем admin. Все полученные данные распечатать на экране. Поиск осуществляется от текущей директории.

find . -name «*.txt» -exec 'cleartool describe %CLEARCASE_PN%'

Найти все файлы с расширением TXT, применить к каждому из найденных операцию описания свойств (describe). Для осуществления, команде desc передается переменная среды, отвечающая за полный путь к версии (подробно читайте в главе про триггеры). Поиск осуществляется от текущей директории.

findmerge

Проводи поиск версий элементов, которые необходимо объединить. Команда эффективна при глобальном поиске  разнице в содержимом версий с отладочных и основных релизов, с дальнейшим слиянием.

findmerge . -fversion /main/Rel1BugFix/LATEST  -all –print

Найти версии элементов,  которые  были изменены, и где требуется слияние. Поиск и сравнение ведется от последней версии отладочного релиза к текущей, специфичной для представления, в котором команда была применена. Статистическая информация выдоится на экран.

findmerge . -fversion /main/Rel1BugFix/LATEST  -all –merge

Тоже, что и предыдущий пример. Разница состоит в то, что после нахождения версий, требующих слияния, СС сам начнет объединять их.

fix_prot

Системная команда. Позволяет исправлять права доступа к файлам и директориям проекта на физическом уровне.

Используется администратором в экстренных случаях, в таких как падение сервера, или при переносе данных с одного компьютера на другой

fix_prot.exe -force -root -chown student -chgrp None c:\stg\vobs\TestCC.vbs

Изменяет права на владения репозиторием.

get

Копирует версию элемента в статический представление, делая его доступным для локального представления.

ln

Выполняет связку объектов. В СС, как и в Unix, существует два типа связей: мягкие и жесткие. Команда применяется в тех случаях когда необходимо создать экземпляр одного элемента в нескольких директориях одного проекта, или для создания ссылки на объект из другого проекта, репозитория (символическая).

Важная особенность команды заключена в том, что только она сможет объединить несколько разрозненных репозиториев в один проект, даже если они находятся на физически разных компьютерах.

ln –slink ..\RTS .

Создать символическую связь с директорией RTS. Ссылка монтируется в текущую директорию.

ln -slink msg.c messages.c

Создать символическую связь файла  messages.c, поместить ее в текущую директорию и дать имя новому элементу msg.c

ln *.cpp subd

Создать ссылки на все файлы CPP и поместить их п в поддиректорию subd

lock

Позволяет блокировать или разблокировать элементы (все данные: от элемента до репозитория). Применяется в тех случаях, когда изменение элемента остальными участниками нежелательно. Команду может применять только владелец элемента или администратор

lock vob:.

Заблокировать для всех текущий репозиторий

lock *.cpp

Заблокировать все файлы CPP, находящиеся в текущей директории

lock  brtype:Rel2.0BugFix

Заблокировать бренч Rel2.0BugFix для всех элементов, его содержащих

ls

Выводит на экран список элементов текущей или указанной директории

ls –long

Вывести полную информацию о элементах из текущей директории

ls –nxn

Вывести сокращенную информацию о элементах из текущей директории

lsco

Выводит на экран список элементов находящихся на редактировании (в состоянии checkout)

Обычно применяется для быстрого поиска файлов, находящихся на редактировании, так как многие глобальные действия с базой СС, предусматривают, что все элементы находятся в состоянии checkin

lscheckout -short

Вывести список файлов, находящихся в данном состоянии. Поиск ведется для текущей директории, вывод осуществляется в сокращенном формате

lscheckout -recurse –user admin

Рекурсивно вывести список файлов, находящихся в состоянии СО. Вывод фильтруется для пользователя admin

lsdo

Выводит на экран список элементов типа derived-objects – объектов компиляции.

lsdo .

Простой вывод объектов компиляции для текущего репозитория и текущего представления

lsdo –long .

Расширенный вывод объектов компиляции

lshis

Список правок элемента. Работает на основе простого языка запросов. Поддерживает вывод в файл. На его основе можно составлять периодическую отчетность с ограничением по пользователям, мажорной и минорной датам

lshistory main.cpp

Вывод истории изменений для файла main.cpp. Вывод осуществляется для всех ответвлений

lshistory -long lbtype:REL1 .

Вывод истории изменений элементов текущей директории, у которых есть  метка REL1

lshistory -user admin  -a -minor -since 20-mar-99.15:00

Вывод истории изменений, которые проводил пользователь admin  начиная с указанной даты по текущую.

lslock

Выводит список заблокированных объектов. Данная команда часто используется администраторами проектов для поиска блокированных  элементов, в тех случаях когда невозможно выполнить определенные манипуляции над репозиторием.

lslock –all

Прсомотреть в текущем репозитории список заблокированных элементов

lspriv

Выводит на экран список личных элементов. Причем, в СС личные файлы выделяются не на конкретного пользователя, а на конкретный представление. Тем самым, если на локальной машине пользователя 3 разных представления, то для каждого из них выделяется свое, изолированное от остальных, личное пространство.

lsprivate -invob M:\Development\Vob\src

Выводит список личных объектов для директории src, репозитория Vob. Поиск ведется по глобальному доступу, через букву M

lsprivate -long

Выводит список личных объектов для всех репозиториев

lsreg

Выводит список доступных регионов

lsreplica

Выводит список реплик синхронизации для текущего или указанного репозитория.

lsreplica

Список репликаций для текущего репозитория

Lsreplica –invob \MyVob

Список репликаций для указанного репозитория

lstype

Просмотреть список метаданных по типам. Команда выполняет обычную роль просмотрщика данных.

lstype –kind lbtype

Вывести список типов меток с характеристиками (для текущего репозитория)

lstype –kind brtype

Вывести список типов ответвлений с характеристиками (для текущего репозитория)

lstype -fmt «%n %c \n» -kind lbtype

Вывести список типов ответвлений с использованием форматного вывода

lsview

Выводит список представлениеов. По умолчанию выводит список представлениеов для текущего компьютера, но может выводить список и отдельно по компьютерам, находящихся в домене.

lsview -long

Вывести список представлений с полной информацией  для текущего компьютера

lsview -host asteroid 

Вывести стандартный список представлений для компьютера asteroid 

lsview -properties -full

Вывести расширенный  список представлений со свойствами для компьютера asteroid 

lsvob

Выводит список репозиториев. По умолчанию выводит список репозиториев для текущего компьютера, но может также выводить список и отдельно по компьютерам, находящихся в домене

lsvob -long \vob12

Вывести полную информацию о репозитории vob12

lsvob -graphical –region windows

Отобразить графически список репозиториев региона windows

lsvob –host asteroid

Отобразить список репозиториев для указанного компьютера

lsvtree

Выводит на экран дерево версий элемента. В зависимости от настроек может выдавать дерево версий как для одного элемента, так и для группы.

lsvtree util.c

Вывести дерево версий для файла util.c  (в консоль)

lsvtree –g util.c

Вывести дерево версий для файла util.

lsvtree –all

Вывести дерево версий для каждого элемента

lsvtree -branch \main\Rel2.0BugFix -all util.c

Вывести фрагмент истории, только для версий бренча  Rel2.0BugFix

merge

Слияние одной или нескольких версий в одну. Операция может выполняться как в графическом, так и в текстовом режимах. Ценность команды – в способности слияния более двух версий одновременно. Из особенностей можно отметить, что в  результате слияния нескольких версий не отображается графическая связь между ними (отображается только для двух версий)

merge -to util.c -graphical -version \main\Rel2.0BugFix\LATEST

Провести графическое слияние двух версий файла util.c. Источником будет версия  \main\Rel2.0BugFix\LATEST, а приемником версий, выведенная предварительно в состояние checkout

mkactivity

Создать действие. Действие отслеживает все работы разработчика по завершению поставленной задачи. Каждый поток может иметь лишь одно текущее действие, в которое записываются все сделанные изменения. Если действие не должно использоваться немедленно, необходимо использовать ключ -nset:

mkactivity -c «demo» -in int_str@\pvob1 -nset act_int@\pvob1

Создать действие «act_int@\pvob1» в потоке «int_str@\pvob1», не устанавливая его в текущем представлениее (ключ «nset»)

mkattype

Создать тип атрибута для последующего назначения элементам

mkattype -nc Additional

Создать атрибут по умолчанию

mkattype -nc -vpbranch -vtype integer -gt 0 -le 10 Errors

Создать атрибут Errors, тип значений которого, Integer. Задать пределы для ввода: от 0 до 10

mkattype -nc –enum ‘«НЕТ», «ДА», «в процессе»’ Tested

Создать атрибут Tested, с тремя предопределенными состояниями

mkattr

Назначить имеющийся тип атрибута определенной версии элемента. Команда может выполнять действия по назначению атрибутов рекурсивно для всех каталогов проекта.

mkattr Tested \«ДА\» hello.h

Назначить созданный атрибут Tested на файл hello.h, с присвоением значения \«ДА\»

mkbl

Создать базовую линию компоненты или набор базовых линий компонент. Фактически, базовая линия представляет из себя версию компоненты.

mkbl -c "demo" -view int_view -activities act_int@\pvob1 -full new_bl

Создать новую базовую линию в представлении «int_view» (ключ -view), составив её из всех элементов компонента (ключ -full), изменённых действием act_int@\pvob1 (ключ -activities).

mkbrtype

Создать тип ответвления для последующего назначения данного типа конкретным элементам

mkbrtype -c "Отладочный релиз для версии 2.0" Rel2.0BugFix

Создать отладочный релиз Rel2.0BugFix с присвоением комментария (один релиз на элемент)

mkbrtype –pbranch -c "Отладочный релиз для версии 2.1" Rel2.1BugFix

Создать отладочный релиз Rel2.йBugFix с присвоением комментария (одно ответвление для одного бренча)

mkbranch

Назначить тип ответвления конкретному элементу, выведя его в состояние СО. Рекурсивный вызов для данной операции не поддерживается, то есть сразу сделать ответвления для всех элементов репозитория невозможно (то есть, команда не позволяет делать подобную операцию напрямую. Но через условия запроса, с помощью команды find данный недостаток легко обойти). Команда служит для принудительного создания ответвлений, что иногда является необходимым. В большинстве случаев ведение проекта УК можно считать успешным, если ответвления создаются неявным образом без применения  данной команды.

mkbranch -nc bugfix util.h

Создать ответвление bugfix для последней версии util.h, и вывести его в состояние chekout

mkbranch -version \main\1 -nco -nc Rel3.0BugFix util.c

Создать ответвление Rel3.0BugFix от версии 1 файла util.c, без комментирования операции. Результирующее состояние версии checkin

mkcomp

Создать компоненту. Используется при работе с СС в рамках UCM. При помощи данной команды создаётся компонента в проектном репозитории. Компонента обычно группирует директории или файлы, которые хранятся либо в корне компонентного репозитория, либо на один уровень ниже корня. В компоненту включаются все файлы и директории, лежащие ниже корневой директории. Команда исполняется из представления:

  mkcomp -c «demo» -root M:\temp_view\vob1 vob1@\pvob1

Создаётся компонента «vob1» в репозитории «\pvob1», в которую включен репозиторий «M:\temp_view\vob1».

mkdir

Создать директорию. Создание директорий в проектах на динамических представлениях возможно только при помощи команд СС.

mkdir –nc Source

Создать директорию Source, без применения комментария

Продемонстрируем применение ключа «nco»:

mkdir -nco -c "demo" M:\int_view\vob1\files

Создать директорию без постановки её в состояние редактирования (checkout).

mkeltype

Создать тип элемента. Используется для тонкой настройки проектных данных по типам файлов, для организации. Новый элемент может создаваться на основе супертипа. Все возможные файловые структуры описываются в Magic-файлах.

mkeltype -supertype file -nc zip_archive

Создать новый тип элемента zip_archive, свойства которого базируются на основе предопределенного типа file

mkeltype -supertype file -mergetype never  -nc grph_file

Создать новый тип элемента grph_file, свойства которого базируются на основе предопределенного типа file и задать специальные свойства конструирования версии по переменной never

mkelem

Создать элемент. Используется для постановки под контроль данных. Для постановки под управления данные должны находится в представлениее.

mkelem -nc -ci main.cpp

Создать элемент main.cpp (по умолчанию – текстовый файл), без комментирования процесса. Результирующее состояние файла после операции – checkin

mkelem -nc main.cpp

Создать элемент main.cpp (по умолчанию – текстовый файл), без комментирования процесса. Результирующее состояние файла после операции – checkout

mkelem -nc -eltype zip_archive arch.zip

Создать элемент arch.zip, с присвоением ему типа zip_archive

mkhltype

Создать тип гиперссылки для последующего назначения элементам

mkhltype -nc tested_by

Создать тип гиперссылки tested_by

mkhltype -c «исходные тексты для дизайна документов» design_spec@\docs

Создать тип гиперссылки design_spec и связать ее с директорией docs

mkhlink

Назначить тип гиперссылки на указанные объекты. Гиперссылки используются в основном для формирования логических связей, как внутри одного репозитория, так и с «внешним» миром, например, для связи с дефектами в ClearQuest, используется именно механизм гиперссылок. Также удобно применять данный метод для ссылки на внешние документы (возможно, на основании которых, разрабатывалась версия в СС). Не менее активно гиперссылки используются при работе с СС в рамках UCM для связи компонентного и административного (проектного) репозиториев.

mkhlink design_spec main.cpp@@\REL2  \users_hw\doc\util.doc@@\REL2

Связать две версии разных файлов ссылкой design_spec

mkhlink -ttext "Регрессия" tested_by  main.cpp

Назначить текстовую метку tested_by  на файл main.cpp

Репозитории связываются гиперссылкой типа AdminVob. Команду необходимо исполнять из репозитория, который должен стать компонетой:

mkhlink AdminVOB vob:\vob1 vob:\pvob1

Репозиторий «\pvob1» назначается проектным для компонентного «\vob1».

mklbtype

Создать тип метки

mklbtype -c "Релиз 2.0" Rel2.0

Создать тип метки Rel2.0 (с комментарием, одну на элемент)

mklbtype -nc -pbranch Rel3.0

Создать тип метки Rel3.0 (без комментария, одну на ответвление)

mklabel

Присвоить метку одному  элементу или группе элементов по определенному признаку. Механизм меток используется для получения компилирующегося релиза, а впоследствии, при редактировании релиза, для создания ответвлений.

mklabel -recurse Rel6.0 .

Назначить тип метки  Rel6.0 для всех элементов, расположенных в текущей директории и во всех  дочерних поддиректориях

mklabel -recurse -version /main/1 Rel1.0 *.cpp

Назначить метку Rel1.0 всем файлам, с расширением cpp, расположенным в текущем репозитории

mkproject

Создать проект. Активно используется при работе с СС в рамках UCM. Проект создаётся в какой-либо директории (можно в корневой директории репозитория), и должен содержать компоненты (одну или несколько):

mkproject -c «demo» -modcomp vob1@\pvob1 -in RootFolder@\pvob1 demo_project@\pvob1

Создаётся проект demo_project@\pvob1 в корневой директории репозитория \pvob1, содержащий изменяемую (ключ -modcomp) компоненту vob1@\pvob1.

mkregion

Создать новый регион. Регионы используются для структуризации репозиториев (для каждого региона можно создавать одинаковые имена репозиториев). Но чаще регионы применяются при одновременной работе на распределенных платформах (Unix\Windows).

mstream

Создать поток. Используется при работе с СС в рамках UCM-проекта. Поток состоит из имени, набора базовых линий, записи о наборе действий, связанных с потоком. Различают два представления потоков – поток слияний и поток разработчика. Интеграционный поток создаётся с использованием ключа «int». Для потока слияний указывается проект, для потока разработчика указывается родительский поток (обычно – поток слияний):

mkstream -int -in demo_project@\pvob1 -baseline vob1_INITIAL@\pvob1 int_str@\pvob1

Создаётся поток слияний «int_str@\pvob1» в проекте «demo_project@\pvob1» с базовой линией «vob1_INITIAL@\pvob1».

mktag

Создать логическое имя представления или воба в регионе. Позволяет присваивать физически имеющимся представлениям и репозиториям новые логические имена. В основном используется в распределенных системах для связи с UNIX репозиториями, но также применяется при переносе VOB и VIEW с сервера на сервер (совместно с командой Register).

 mktag -view –tag Rel1.0  -region Windows  \\comp1\stg\views\Rel1.0.vws

Создать тег (логическое имя) для представления Rel1.0  в регионе Windows, основываясь на физической базе Rel1.0.vws

mktrtype

Создать тип триггера. СС обладает событийно-ориентированнм интерфейсом. Триггер поможет дополнить функциональность (более подробно, см. главу про триггеры)

mktrtype -element -all postop checkout -exec ‘net send comp1 %CLEARCASE_PN%-is CO' co_send

Создать тип триггера co_send для всех элементов, выводящихся в состояние checkout. Триггер срабатывает после работы стандартного обработчика событий СС. Триггер инициирует, системной командой net send, отправку сообщения на консоль с именем comp1, в качестве дополнительных параметров, на консоль отправляется адрес элемента, выводимого в CO (через переменную среды)

mktrtype -element -all -preop checkout -eltype zip_file -nusers admin,manager -exec ‘ccperl -e \«exit(-1);\»' exept_trigg

Создать тип триггера exept_trigg для всех элементов, выводящихся в состояние checkout.

Триггер срабатывает для всех пользователей, кроме перечисленных в теле команды. Передача управления триггеру производится до стандартного обработчика. В случае совпадения несовпадения имени пользователя выполнится условие exit (-1) - команда на прерывание действия, и СС не выведет элемент в данное состояние

mktrtype -element -preop checkout -nusers admin,manager -exec ‘ccperl -e \«exit(-1);\»' exept_trigg_for_file

Создать тип триггера exept_trigg_for_file. Тип триггера повторяет предыдущий пример, за тем исключением, что на этапе создания не известен конкретный элемент, на который необходимо назначить триггер

mktrtype -nc -element -all -preop rmver -brtype main -nusers admin,manager -exec ‘ccperl -e \«exit(-1);\»' exept_trigg_for_branch

Создать тип триггер, запрещающий удалять версии с основного дерева версий. Исключение составляют пользователи admin и manager.

mktrigger

Создать триггер для элемента (более подробно триггеры описываются в главе 6.5)

mktrigger exept_trigg_for_file  main.cpp

Назначить созданный тип триггера exept_trigg_for_file  на файл main.cpp

mkview

Создать представление. В зависимости от параметров создает либо статический, либо динамический представление. При создании динамического представления данной командой создается лишь само представление, но не создается ассоциация с буквой диска. Следует отметить ключ «stream» данной команды. Он применяется при работе с СС в рамках UCM для прикрепления представления к какому-либо потоку.

mkview -tag Development  \\alex-golder\stg\views\Development.vws

Создать представление с именем Development, сохранив его по указанному адресу

net use * \\view\Development

Создать сетевой диск Development, с присвоением произвольной буквы (данная команда является системной и используется потому, что ClearCase не может сам автоматически присваивать созданным представлениям буквы сетевых подключений)

mkview -tag int_view -region Windows -stream int_str@\pvob1 \\host\stg\views\int_view.vws

Создать представление и прикрепить его к потоку «int_str@\pvob1».

mkvob

 Cоздание репозитория. Основная команда СС, без особых отличительных способностей. Исключение составляет платформа UNIX, так как там формат команды намного сложнее Windows-аналога

mkvob -nc -tag \Allo \\comp1\stg\vobs\ssa.vbs

Создать репозиторий с именем \Allo, расположив его по указанному пути.

Обратим внимание на ключ команды -ucmproject. Он необходим при работе с СС в рамках UCM. При использовании данного ключа создаётся проектный репозиторий:

mkvob -tag \pvob1 -ucmproject -c «demo» -region Windows \\host\stg\vobs\pvob1.vbs

mount

Смонтировать один или несколько репозиториев. Присутствие пользователя в том или ином репозитории определяется списком смонтированных репозиториев.

mount \Allo

Смонтировать репозиторий \Allo

mv

 Перенос элементов в пределах одного репозитория. При работе с репозиторием бывает необходимо переместить файл или директорию из одного места в другое, причем использовать для этого можно только команды СС

mv main.cpp src1

Перенести файл main.cpp из текущей директории в src1

protect

Данная команда используется администраторами и служит для установки строго регламента на доступ к данным репозитория.

protect -chmod +r main.cpp

Разрешить чтение данных из файла main.cpp

protect -recurse -chgrp user src

Поменять группу владельца элементов с user на src (операция передачи прав)

protect -chown tester brtype:Rel1.0BugFix

Поменять владельца ответвления

pwd и pwv

rebase

Изменить конфигурацию потока. С помощью команды можно добавить, удалить или заменить одну, или несколько базовых линий потока.

rebase -view dev_view -baseline bl_after_test

Представление наполняется версиями файлов базовой линии, указанной за ключом -baseline («bl_after_test»).

register

Зарегистрировать имеющийся репозиторий или представление. Применяется при переносе баз данных и представлений между машинами, а также для при переносе репозиториев или представлений между регионами. Суть команды проста – она регистрирует в записях ClearCase физически существующую базу (репозиторий или представление). После регистрации репозитория или представления необходимо дать команду mktag, чтобы дать зарегистрированному представлению или репозиторию верхнеуровневое имя, которое в дальнейшем будет использоваться для работы.

register –vob \\comp1\stg\vobs\ssa.vbs

Зарегистрировать репозиторий по указанному адресу

relocate

Переносит  данные  из одного репозитория в другой. При переносе полностью учитываются все  метаданные репозитория. История версий элементов и их комментарии также переносятся полностью. Очень эффективная команда для дробления репозитория на подразделы с выделением их в отдельные базы. Применяется особенно часто, когда необходимо разгрузить сервер, перенеся редко используемые данные на другую машину (см. описание команды ln, при помощи которой можно создать логическую связь между репозиториями)

relocate  src ../vob2

Перенести элементы из директории src (текущего репозитория) в репозиторий vob2

rename

Переименовывает элемент. Как и для многих операций над элементами репозитория, применять можно только встроенную в СС команду. Командами системы переименовывать элементы нельзя.

rename main.cpp supermain.cpp

reserve

Конвертирует  статус элемента, переводя его из не резервного состояния в резервное. Перевод статуса применяется в тех случаях, когда нужно повысить или понизить командный статус для элемента, находящегося в состоянии checkout

reserve main.cpp

rgy_passwd

 Устанавливает  пароль на работу с данными на регистрационном сервере.

rmattr

Удалить атрибут

rmattr Tested main.cpp

Удалить атрибут Tested с элемента main.cpp

rmattr -version '\main\{Tested==«Нет»}' Tested main.cpp

Удалить значение НЕТ атрибута Tested с элемента main.cpp

rmattr -version \main\3 Tested main.cpp

Удалить атрибут Tested с 3 версии файла main.cpp

rmbranch

Удалить ответвление

mbranch main.cpp@@/main/Rel1.0BugFix

Удалить ответвление Rel1.0BugFix с дерева версий файла main.cpp

rmelem

Удаление элемента с деревом версий из репозитория без возможности восстановления. Очень опасная команда,  безвозвратно уничтожающая элементы репозитория. Исключения составляют случаи, удаления директорий, когда все вложенные в директорию элементы перемещаются в папку lost+founds.

rmelem main.cpp

Удалить файл main.cpp

rmelem dir1

Удалить директорию dir1

rmhlink

Удалить внешнюю связь

rmlabel

Удалить метку с элемента

rmlabel -version \main\Rel2.0 Rel2.0 main.cpp

Удалить версию Rel2.0 с указанного адреса (подразумевается, что меток с именем Rel2.0 несколько, а удаление необходимо произвести только той, которая расположена  основной ветви)

rmlabel  Rel2.0  main.cpp

Удалить метку с элемента (подразумевается, что метка одна на элемент)

rmmerge

Удалить ранее проведенное слияние объектов. При удалении версии элементов и их содержимое остаются неизменными. Особенность команды заключается в том, что удаляется только визуальная связь на дереве версий. При этом, версия созданная в результате слияния остаетс нетронутой. Если необходимо удалить е Ии, то применяется команда rmver.

rmmerge main.cpp @@/main/Rel2.0BugFix/LATEST main.cpp

Удалить слияние текущей версии элемента main.cpp с последней версией отладочного релиза Rel2.0BugFix

rmname

Удалить имя элемента. Данная команда может быть использована для удаления элемента из текущей версии директории (при вводе команды директория должна находиться в состоянии checkout). Рекомендуется к использованию вместо rmelem, так как не удаляет данные физически из репозитория.

rmname main.cpp

Удалить элемент из состава текущей директории

rmname -nco  .@@\main\2\main.cpp

Удалить элемент main.cpp из второй версии текущей директорий, без вывода ее в состояние checkout

rmtag

Удалить логическое имя репоизитория или представления. Команда удаляет только логическое имя, оставляя нетронутыми физические базы VOB и VIEW (stg\vobs и stg\views). Применяется в тех случаях, когда необходимо отделить физическое хранилище данных от его представления в СС.

rmtag -view Rel2.0BugFix

Удалить имя представления Rel2.0BugFix

rmtag –vob \Sem

Удалить имя репозитория \Sem

rmtrigger

Удалить поставленный триггер

rmtrigger my_trig

Удалить триггер my_trig

rmtype

Удалить тип  метаданных. Отметим, что удаления типа метаданных приводит к их уничтожению на версиях элементов в репозитории.

rmtype brtype:Rel1.0BugFix

Удалить тип ответвления

 rmtype -rmall lbtype:Rel1.0

Удалить тип метки

rmver

Удаление конкретной версии или диапазона версий с дерева версий элемента. Используется в крайних случаях, как мера по приведению версионного дерева в порядок. Команда rmver  по умолчанию удаляет только одну версию или диапазон независимых версий, то есть таких версий, от которых нет ответвлений и на которых нет меток.

rmver main.cpp

Удалить текущую версию элемента для данного представления

rmver –version /main/3 main.cpp

Удалить версию 3 с основного ответвления

rmver –xla –xbr –version /main/3 main.cpp

Удалить 3 версию с основного ответвления, невзирая на возможные метки и ответвления.  Если от версии отходит ответвление, то оно также будет удалено со всеми собственными ответвлениями

rmver -vrange \main\1 \main\LATEST main.cpp

Удалить диапазон версий: от 1 до последней элемента main.cpp

rmview

Физическое  удаление представления, для удаления необходимо указать путь до физического расположения View. Команда уничтожает логическое имя (тег) и очищает директорию vws, используемую представлением. Для удаления можно использовать как физический путь, так и имя тега.

Из особенностей использования команды, отметим, что если в репозитории находились элементы, выведенные для данного представления в состояние checkout, то они все удаляются вместе с ним (безвозвратно). 

rmview –f –tag Development

Удалить представление по его логическому имени

rmview –f \\comp1\stg\views\Development.vws

Удалить представление по его адресу на носителе

rmview -vob \Sem -uuid 370c4440.76e311d6.a85c.00:a0:c9:3b:f1:04

Удалить все версии файлов, находящихся в состоянии checkout из репозитория \Sem. Удаляются только те версии файлов, которые принадлежат представлениеу с идентификатором 370c4440.76e311d6.a85c.00:a0:c9:3b:f1:04. Данная команда используется администраторами, в тех случаях, когда в репозитории случайно остались файлы в состоянии  checkout, зарезервированные за уже удаленными представлениями. Особенность ведения управления в СС заключается в том, что каждая версия элемента имеет уникальный uuid, основанный на имени того представления, в котором он редактировался или редактируется.

rmvob

Физическое удаление репозитория со всеми данными.

rmvob \\comp1\stg\vobs\vb.vbs

schedule

Управление расписанием выполняемых работ. Позволяет проводить расписание регламентных работ, запускаемых IBM Rational ClearCase автоматически в заданное время и с заданной периодичностью.  Данная команда позволяет активизировать процесс исполнения работ, а также их распределения и управления.  Программирование работ делится на два основных шага:

1) Редактируется файл …\ClearCase\var\scheduler\tasks\task_registry. В него вносятся задачи (tasks), в которых оговаривается наименование скрипта, подлежащего исполнению;

2) Редактируется файл …\ClearCase\config\scheduler\initial_schedule. В него вносятся необходимые представлениеы работ (jobs), указывается периодичность и дается ссылка на конкретную задачу.

Установить все работы из указанного файла

setactivity

Установить или снять текущее действие в представлении:

setactivity -c «demo» -view int_view act_int@\pvob1

Установить действие «act_int@\pvob1» в представлениее «int_view»

setcs

Установить в текущий или указанный представление конфигурационную спецификацию из заданного файла.

setcs -tag Rel1.0 –default

Установить для заданного представления конфигурационную спецификацию по умолчанию

setcs -tag Rel1.0 c:\r1.0

Установить для заданного представления конфигурационную спецификацию из файла c:\r1.0

umount

Размонтирует репозитории. Участник проекта оговаривает свое присутствие в проектах методом монтирования/размонтирования. В качестве особенности команды вынесем невозможность размонтирования репозитория в том случае если одно или несколько приложений работают с его данными.

umount -all 

Размонтировать все репиозитории

umount \Seminar

Размонтировать репозиторий с указанным именем

uncheckout

Вернуть элемент в предыдущее состояние. Команда является аналогом кнопки undo checkout из GUI. Измененный файл записывается как  личный (private object) с расширением keep.

uncheckout main.cpp

Провести команду uncheckout для файла main.cpp. Команда исполнится если файл уже находится в состоянии checkout

unlock

Снимает блокировку с элемента и делает его доступным для редактирования

unlock main.cpp@@/main/0

Снимает блокировку с указанного файла, с версии 0

update

Обновляет статический представление, приводя состояние версий элементов в соответствии с текущими проектными версиями. Команда осуществляет двунаправленный обмен данных: от сервера к пользователю и от пользователя к серверу.

update –all

Обновить данные во всех представлениях

Команды Cleartool списком

Ниже перечислены все команды  IBM Rational ClearCase, включая не рассмотренные в данной статье. Воспользуйтесь документацие на IBM Rational ClearCase для того, чтобы сориентироваться в командном интерпретаторе cleartool.

annotate, propos, catcr, catcs, cd, cha, ctivity, chbl, checkin, checkout, checkvob, chevent, chflevel, chfolder, chmaster, chpool, chproject, chstream, chtype, chview, cptype, deliver, describe, diff, , diffbl, , diffcr, dospace, edcs, endview, file, find, findmerge, get, getcache, getlog, help, hostinfo, ln, lock, ls, lsactivity, lsbl, lscheckout, lsclients, lscomp, lsdo, lsfolder, lshistory, lslock, lsmaster, lspool, lsprivate, lsproject, lsregion, lsreplica, lssite, lsstgloc, lsstream, lstype, lsview, lsvob, lsvtree, man, merge, mkactivity, mkattr, mkattype, mkbl, mkbranch, mkbrtype, mkcomp, mkdir, mkelem, mkeltype, mkfolder, mkhlink, mkhltype, mklabel, mklbtype, mkpool, mkproject, mkregion, mkstgloc, mkstream, mktag, mktrigger, mktrtype, mkview, mkvob, mount, mv, protect, protectvob, pwd, pwv, quit, rebase, recoverview, reformatview, reformatvob, register, relocate, rename, reqmaster, reserve, rmactivity, rmattr, rmbl, rmbranch, rmcomp, rmdo, rmelem, rmfolder, rmhlink, rmlabel, rmmerge, rmname, rmpool, rmproject, rmregion, rmstgloc, rmstream, rmtag, rmtrigger, rmtype, rmver, rmview, rmvob, setactivity, schedule, setcache, setcs, setplevel, setsite, setview, shell, space, startview, umount, uncheckout, unlock, unregister, unreserve, update, winkin.

05.01.2008

Добавить комментарий (анонимные комментарии не публикуются!!!)

ФИО:
E-mail:
Тема:
Комментарий:
Оценка:
Код подтверждения:

Читайте также статьи и материалы о технологиях Rational и Microsoft в блоге Новичкова Александра и Шамрая Александра

Новости и пресс-релизы СМ-Консалт

Архив "Новости и пресс-релизы СМ-Консалт"