Заметки консультанта

Шамрай Александр Владимирович

Вложенные UCM Project VOB в ClearCase

Posted by Шамрай Александр на Август 24, 2010

Оригинал: Understanding Nested UCM Project VOB Environments

Введение

IBM ® Rational ® ClearCase ® Unified Unified Change Management (UCM) позволяет делать расширение с использованием ассоциации административных проектных VOB-ов (PVOB). В этом документе приводятся детали и передовой опыт для сред, которые реализуют структуру административных VOB-ов, которая включает использование нескольких PVOB-ов (вложенные PVOB). В этом документе также рассматриваются дополнительные варианты для среды ClearCase MultiSite. Документ не отображает всех возможных конфигураций с участием UCM PVOB в среде UCM.

Этот документ предназначен для администраторов ClearCase UCM, ответственных за организацию конфигурации UCM.

Прежде чем приступить вы должны иметь глубокое понимание общих концепций UCM, которые приведены в разделе Understanding UCM руководства IBM Rational ClearCase Managing Software Projects.

Обзор

Вложенные проектные VOB-ы могут добавить дополнительный уровень масштабируемости и функциональности для среды UCM, которая позволяет администраторам разделять метаданные по нескольким проектным структурам UCM. Такая вложенная конфигурация может помочь разделить метаданные между несколькими административными VOB-ами и избежать больших баз данных для VOB-ов. Она также может быть полезна для повышения производительности за счет перевода вновь созданных проектов в отдельные проектные VOB-ы. Эта статья должна помочь избежать многих проблем, которые могут возникнуть при связывании проектных VOB-ов.

В этом документе будет рассматриваться следующее:

  • Стандартная разработка с одним проектным UCM VOB-ом
  • Создание структуры вложенных проектных VOB-ов
    • Использование существующего проектного VOB-а в качестве административного VOB-а для дочерних проектных VOB-ов.
    • Использование общих административных VOB-ов для нескольких проектных VOB-ов
  • Использование ucmutil link_pvob
  • Среда MultiSite и общие проблемы, которые могут возникнуть

Стандартная разработка с одним проектным UCM VOB-ом

Стандартная UCM разработка требует связи между проектным VOB-ом и компонентным VOB-ом. Компонентный VOB может содержать один или более корневых хранилищ компонент в зависимости от его конфигурации. Стандартная практика разработки во многом зависит от целостности связей между этими VOB-ами. Каждый VOB содержит различные гиперссылки для обеспечения доступа и размещения в необходимых местах. Создание данных в VOB-е, который является членом структуры административных VOB-ов, требует применения общего доступа к данным. Общие данные создаются в административных VOB-ах или в дочерних VOB-ах в зависимости от типа данных.

Ниже на рисунке отображена ассоциация проектного VOB-а и компонентного VOB-а для стандартного UCM. Рисунок отображает некоторые основные данные, сгенерированные в обоих VOB-ах, что более подробно раскрывается ниже.

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

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

Проекты создаются в рамках проектного VOB-а и могут быть использованы для организации и применения политик доступа для группы потоков. Когда разработка достигает ключевых моментов жизненного цикла проекта, создается базовая линия UCM как временной штамп.

Базовая линия UCM является объектом, созданным в рамках проектного VOB-а. Она связана с обычным типом метки, созданным в компонентном VOB-е. Тип метки применяется для единственной последней версии для каждого элемента в выбранной конфигурации. Как правило, эта конфигурация определяется потоком, в котором создается базовая линия.

Создание структуры вложенных проектных VOB-ов

Данный раздел описывает добавление нового проектного VOB-а в существующую среду разработки UCM. Новый проектный VOB не содержит существующих проектов или компонентов. Целью создания нового проектного VOB-а является объединение с существующей средой UCM. Если два или более проектных VOB-а связаны в общую административную иерархию VOB-ов, то это называется вложенной структурой проектных VOB-ов. Во вложенной структуре должен быть только один общий административный VOB. Все VOB-ы в административной иерархии VOB-ов должны указывать на один высокоуровневый VOB. На верхнем уровне административный VOB содержит объекты, необходимые для обеспечения создания распределенной UCM разработки.

На данный момент есть два способа добавления нового проектного VOB-а в существующую среду UCM.

  • Добавить новый проектный VOB и выбрать любой проектный VOB (существующий или новый) в качестве единой административного VOB-а. Однако этот вариант не очень масштабируем. Эта конфигурация представляет риск разрастания одного проектного VOB-а. Это также увеличивает значимость существующего проектного VOB-а.

Рисунок А.1

  • Добавить новый проектный VOB и новый общий административный VOB. Эта конфигурация становится масштабируемой и предусматривает равное значение для обоих проектных VOB-ов. Это помогает сохранить специфические объекты проектного VOB-а отдельно от общих глобальных метаданных, таких как тип ветви. Такая структура также будет держать метаданные организованными в общем административном VOB-е. Такая конфигурация потребует использования утилиты поставляемой в комплекте с ClearCase. Утилита называется «ucmutil» и далее о ней будет рассказываться более подробно.

Рисунок А.2

Использование ucmutil link_pvob

В выше указанной конфигурации необходимо использование «ucmutil». Утилита имеет подкоманду «link_pvob». Эта подкоманда позволяет администраторам связать существующий проектный VOB с верхнеуровневым административным VOB-ом. Утилита требует, чтоб существующий проектный VOB не был связан с любыми другими административными VOB-ами. Целью этой утилиты является выполнение следующих операций.

  • Передать все существующие глобальные определения типов ветви существующего проектного VOB-а в административный VOB
  • Переопределить ассоциацию всех существующих потоков с глобальными определениями типов ветви перемещенными в административный VOB
  • Перенаправить связи с административным VOB-ом любых соответствующих компонентных VOB-ов к новому административному VOB-у. Как вы можете видеть на рисунке выше, компонентный VOB теперь указывает на общий административный VOB, что является результатом запуска «ucmutil link_pvob». Необходимо также отметить, что ассоциации компонентов остаются с первоначальным проектным VOB-ом.

Утилиту «ucmutil» можно найти в следующих каталогах:

  • Windows: %CLEARCASE_HOME%\etc\utils\ucmutil.exe
  • Linux/Unix: /opt/rational/clearcase/etc/utils/ucmutil

Для более подробной информации об этой утилите смотрите Technote 1237620 About ucmutil.

Примечание: В приведенном ниже примере вы должны установить свой путь к утилите ucmutil в переменную среды (или обеспечить полный путь к ucmutil) и установить контекст в представление для выполнения команд.

Пример использования:

——————————————————————————————————————
M:\adminView>ucmutil link_pvob -verbose -from vob:\pvobing -to vob:\commonAdminVOB
Checking branch type ccrc_deliver.
Checking branch type composite_Integration.
Checking branch type deliver_Integration.
Checking branch type william_child_deliver.
Checking branch type william_child2_deliver.
Checking branch type william_deliver.
Total of 6 global branch types in VOB \pvobing.
Total of 6 UCM branch types checked.
M:\adminView>
——————————————————————————————————————

Как можно увидеть в приведенном выше примере, подкоманда link_pvob будет находить все глобальные определения типа ветви для дочернего проектного VOB-а. Этот пример выполнен в -verbose (предварительном) режиме. Рекомендуется всегда использовать этот инструмент в режиме предварительного просмотра, перед тем как выполнить саму операцию. Также полезно перенаправить вывод команды в лог-файл для дальнейшего анализа. Эта команда необратима. После выполнения команды запуска с флагом «-fix «, гиперссылка административного VOB изменяется, и все метаданные изменяют структуру для представления иерархических изменений. Существуют некоторые проблемы, которые могут возникнуть в процессе проведения операции, поэтому инструмент проверяет, обеспечена ли блокировка VOB-а с ключом «-nuser». Только пользователь, выполняющий команду, должны быть в состоянии получить доступ к VOB-у при запуске операции «ucmutil link_pvob». Для этого вы должны заблокировать VOB с исключением пользователя, который запустил операцию, с ключом «-nuser».

Пример блокировки проектного VOB-а с ключом «nuser»:

——————————————————————————————————————
M:\adminView>ucmutil link_pvob -fix -verbose -from vob:\pvobing -to vob:\commonAdminVOB
ucmutil: Error: VOB \pvobing should be locked with «-nuser» before running this tool.

M:\adminView>cleartool lock -nuser DOMAIN1\william vob:\pvobing
Locked versioned object base «\pvobing».

M:\adminView>ucmutil link_pvob -fix -verbose -from vob:\pvobing -to vob:\commonAdminVOB
ucmutil: Error: VOB \commonAdminVOB should be locked with «-nuser» before running this tool.

M:\adminView>cleartool lock -nuser DOMAIN1\william vob:\commonAdminVOB
Locked versioned object base «\commonAdminVOB».
——————————————————————————————————————

В приведенном выше примере можно увидеть, что утилита проверяет блокировку обоих проектных VOB-ов. Она будет рекомендовать, чтобы вы заблокировали VOB с ключом -nuser.

Напомним, что перед запуском ucmutil link_pvob с ключом -fix, вы должны выполнить следующие операции:

  1. Заблокировать проектные VOB-ы с ключом –nuser
  2. Выполнить ucmutil link_pvob –verbose и перенаправить вывод в лог-файл для дальнейшего анализа. (Это также может быть полезно для устранения неполадок)
  3. Убедитесь, что все типы ветвей, перечисленные в режиме предварительного просмотра, имеют локальную мастер реплику на сайте выполняющему операции. (Эта тема будет рассмотрена в разделе Среда MultiSite далее)
  4. Убедитесь, что все компонентные VOB-ы, связанные с дочерним проектным VOB, НЕ заблокированы. Блокировка компонентных VOB не даст утилите доступ и возможность изменить необходимые данные (Вы можете заблокировать компонентные VOB-ы с ключом -nuser при блокировке проектных VOB-ов, чтобы избежать проблем).

Ниже приведен пример запуска утилиты для связывания проектного VOB-а «\pvobing» с общим административным VOB-ом «\commonAdminVOB»:

Вот список метаданных перед операцией:

  1. Список глобальных типов ветвей в «\commonAdminVOB»
    M:\adminView>cleartool lstype -s -kind brtype -invob \commonAdminVOB
    main
  2. Список глобальных типов ветвей в «\pvobing»
    M:\adminView>cleartool lstype -s -kind brtype -invob \pvobing
    ccrc_deliver
    composite_Integration
    deliver_Integration
    main
    william_child_deliver
    william_child2_deliver
    william_deliver
  3. Список гиперссылок на административные VOB-ы для ассоциированных компонентных VOB-ов в «\pvobing»
    M:\adminView>cleartool describe -l -ahlink -all vob:\pvobing
    Hyperlinks:
    AdminVOB@42@\brokeComp <- vob:\brokeComp
    AdminVOB@42@\cvobing <- vob:\cvobing
  4. Пример ассоциации потоков UCM с глобальными типами ветвей перед связыванием двух проектных VOB-ов
    M:\adminView>cleartool describe -l -ahlink –all stream:deliver_Integration@\pvobing
    deliver_Integration
    Hyperlinks:
    IndependentGuard@306@\pvobing -> brtype:deliver_Integration@\pvobing
    UseBaseline@114@\pvobing -> baseline:cvobing_INITIAL@\pvobing
  5. Гиперссылка на административный VOB, указывающая из ассоциированного компонентного VOB-а
    M:\adminView>cleartool describe -l -ahlink -all vob:\cvobing
    \cvobing
    Hyperlinks:
    AdminVOB@42@\cvobing -> vob:\pvobing

Пример выполнения команды связывания двух VOB-ов

  1. Выполнение команды в режиме предварительность просмотра с флагом –verbose и перенаправление вывода в лог-файл:
    M:\adminView>ucmutil link_pvob -verbose -from vob:\pvobing -to vob:\commonAdminVOB > c:\link_pvob_log.txt
  2. Запуск инструмента для создания связи между VOB-ами с флагом –fix:
    M:\adminView>ucmutil link_pvob -fix -verbose -from vob:\pvobing -to vob:\commonAdminVOB
    Checking branch type ccrc_deliver.
    Moving branch type ccrc_deliver.
    Checking branch type composite_Integration.
    Moving branch type composite_Integration.
    Checking branch type deliver_Integration.
    Moving branch type deliver_Integration.
    Checking branch type william_child_deliver.
    Moving branch type william_child_deliver.
    Checking branch type william_child2_deliver.
    Moving branch type william_child2_deliver.
    Checking branch type william_deliver.
    Moving branch type william_deliver.
    Reconnecting the moved global branch types.
    There is no global type in source VOB. Do you want to redirect the AdminVOB hyperlink? [no] yes
    Redirecting AdminVOB hyperlink.Total of 6 global branch types in VOB \pvobing.
    Total of 6 UCM branch types checked.
    Total of 6 UCM branch types moved.
    Total of 6 Stream hyperlinks reconnected.
    Total of 2 VOBs has been reconnected to new Admin VOB.

    M:\adminView>

Ниже представлен список мигрированных и измененных метаданных как результат операции:

  1. Список глобальных типов ветвей, которые сейчас существуют в «\commonAdminVOB»
    M:\adminView>cleartool lstype -s -kind brtype -invob \commonAdminVOB
    ccrc_deliver
    composite_Integration
    deliver_Integration
    main
    william_child_deliver
    william_child2_deliver
    william_deliver

    (Заметьте, что все глобальные типы ветвей, которые до этого существовали в «\pvobing», мигрировали в «\commonAdminVOB»)

  2. Список гиперссылок Admin VOB в «\pvobing» после выполнения ucmutil link_pvob
    M:\adminView>cleartool desc -l -ahlink -all vob:\pvobing
    \pvobing
    Hyperlinks:
    AdminVOB@310@\pvobing -> vob:\commonAdminVOB(Заметьте, что гиперссылки Admin VOB для всех ассоциированных компонентных VOB-ах более не указывает на проектный VOB. Существует только гиперссылка Admin VOB, которая была создана утилитой ucmutil link_pvob)
  3. Пример ассоциации потоков UCM с глобальными типами ветвей после связывания двух проектных VOB-ов:
    M:\adminView>cleartool desc -l -ahlink -all stream:deliver_Integration@\pvobing
    deliver_Integration
    Hyperlinks:
    UseBaseline@114@\pvobing -> baseline:cvobing_INITIAL@\pvobing
    IndependentGuard@306@\pvobing -> brtype:deliver_Integration@\commonAdminVOB(Заметьте, что гиперссылка IndependentGuard сейчас указывает на глобальный тип ветви мигрированный в commonadministrativeVOB)
  4. Список гиперссылок Admin VOB в «commonAdminVOB» после работы утилиты ucmutil
    M:\adminView>cleartool desc -l -ahlink -all vob:\commonAdminVOB
    \commonAdminVOB
    Hyperlinks:
    AdminVOB@43@\brokeComp <- vob:\brokeComp
    AdminVOB@310@\pvobing <- vob:\pvobing
    AdminVOB@225@\cvobing <- vob:\cvobing(Заметьте, что гиперссылки Admin VOB, ранее указывающие на «\pvobing», теперь указывают на «\commonAdminVOB», который содержит все глобальные типы ветвей.)
  5. Измененная гиперссылка Admin VOB, указывающая из компонентного VOB-а ассоциированного с «\pvobing»
    M:\adminView>cleartool desc -l -ahlink -all vob:\cvobing
    \cvobing
    Hyperlinks:
    AdminVOB@225@\cvobing -> vob:\commonAdminVOB(Заметьте, что даже этот VOB, содержащий компонентные данные ассоциированные с «\pvobing», указывает на «\commonAdminVOB» для получения любых определений глобальных типов. )

MultiSite среды и общие вопросы, которые могут возникнуть

На данный момент мы рассмотрели, как работает утилита ucmutil link_pvob для создания вложенные структуры проектных VOB-ов, однако, мы не обсуждали то, что может произойти если VOB реплицирован в среде ClearCase MultiSite.

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

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

  1. Сайт реплики не будет иметь доступ к необходимым глобальным типам ветвей связанными с потоками UCM
  2. На сайте реплики, скорее всего, будет необходимость создания потоков. Потоки не будут иметь доступ к общему административному VOB-у, где находятся связанные с ними глобальные типы ветвей.
  3. Проектный VOB и компонентный VOB будут иметь неверные гиперссылки на административный VOB, указывающие на VOB, который не существует.
    ВАЖНО: Это очень опасно. Если «cleartool checkvob –ucm или -hlinks» исполняется для VOB-а, команда увидит поврежденные гиперссылки. Checkvob фактически удалит гиперссылки для исправления. Эта операция будет реплицирована на исходный сайт. Это нарушит структуру административного VOB-а на исходном сайте и вызовет катастрофу в производственной среде. Эта ошибка не произойдет, если все VOB-ы в структуре будут реплицироваться. Как альтернатива, при необходимости, можно блокировать тип гиперссылки AdminVOB для VOB-ов с ключом -nuser. Это запретит пользователям создавать и удалять гиперссылки AdminVOB.Пример:
    cleartool lock –nuser domain\user hlink:AdminVOB@\pvobing

Далее мы переходим к возможным проблемам, которые могут произойти с существующей средой UCM. Вполне возможно, что существующий проектный VOB и связанные с ним компонентные VOB-ы уже реплицируется на нескольких сайтах. Ниже приведен список условий, которые нужно применять при планировании связывания существующих MultiSite UCM VOB-ов.

Перед запуском ucmutil link_pvob с флагом «-fix» в среде MultiSite, вы должны предусмотреть следующие.

  1. Убедитесь, что все доступные метаданные имеют мастер реплику сайта, на котором выполняется команда ucmutil.
  2. Запустите сначала программу с флагом «-verbose» и просмотрите список вовлеченных ветвей. Убедитесь, что все потоки связаны с этими типами ветвей имеют мастер реплику сайта, на котором выполняется команда. Используйте страницу помощи «cleartool chmaster» для изменения мастер реплики потока и всех его объектов.
  3. Просмотрите гиперссылки AdminVOB, связанные с существующим проектным VOB-ом, чтобы определить для каких VOB-ов должна быть установлена мастер реплика сайта, на котором выполняется команда. Гиперссылки AdminVOB связанные с каждым компонентным VOB-ом будут заново созданы, чтобы они указывали на новый связанный общий административный VOB.
  4. При запуске ucmutil link_pvob с флагом «-fix», сохраните результаты, т.к. они могут быть использованы для устранения ошибок, которые могут произойти. Для перенаправления вывода команды вы не можете быть в командной строке ucmutil. Вы должны набирать команду из контекста представления ClearCase. Вы должны отслеживать стандартные ошибки на стандартном устройстве вывода. Пример ниже покажет только стандартный поток вывода. Стандартные ошибки будут отображаться в окне командной строки.Пример:
    M:\adminView>ucmutil link_pvob –fix –from vob:\pvobing –to vob:\commonAdminVOB > c:\linkPvob_runLog.txt

Заключение

В дополнение к добавленной масштабируемости и функциональности обеспеченных с помощью вложенной структуры проектных UCM VOB-ов, существуют некоторые сложности с такой конфигурацией, которые требуют особого внимания. В настоящем документе изложены некоторые рекомендации для создания связи между проектными VOB-ами UCM, которые помогут вам избежать многих проблем, которые могут возникнуть при объединении проектных VOB-ов.

Ссылки

IBM Rational ClearCase Managing Software Projects manual

В тему статьи Using multiple PVOBs

Реклама

Добавить комментарий

Заполните поля или щелкните по значку, чтобы оставить свой комментарий:

Логотип WordPress.com

Для комментария используется ваша учётная запись WordPress.com. Выход / Изменить )

Фотография Twitter

Для комментария используется ваша учётная запись Twitter. Выход / Изменить )

Фотография Facebook

Для комментария используется ваша учётная запись Facebook. Выход / Изменить )

Google+ photo

Для комментария используется ваша учётная запись Google+. Выход / Изменить )

Connecting to %s

 
%d такие блоггеры, как: