Обновление подключений
Система начинает использовать содержимое в целевой системе после обновления подключений. Для обновления подключений выполните следующие действия:
1. Подготовьте входной файл.
2. Обновите подключения.
Предварительное условие
• Учетная запись хранилища Azure сконфигурирована с помощью Windchill.
• Сервер Windchill запущен и работает.
Подготовка входного файла
Используйте утилиту командной строки PrepareInputDataForMountMigrationTool, чтобы создать отчет в формате CSV. Затем этот CSV-отчет можно использовать в качестве входных данных для MountMigrationTool, чтобы обновить подключения. Отчет сохраняется в папке <Windchill>/logs/MountMigration/. Этот отчет содержит следующую информацию:
• Корневые папки: список всех доступных корневых папок.
• Хост-компьютер источника
• Исходный путь подключения
• Тип подключения источника
• Целевой путь подключения
• Тип подключения цели: по умолчанию тип подключения целевого значения - azureBlob.
Чтобы перечислить все возможные опции командной строки, выполните следующую команду в оболочке Windchill:
windchill wt.fv.tools.datamigration.PrepareInputDataForMountMigrationTool mount -h
Ниже приведен список допустимых аргументов:
• -h = <help> - справка
• -u = <username> - имя пользователя администратора
• -p = <password> - пароль администратора
• -v = <verbose> - запуск утилиты в режиме отладки
• -c = <container> - наименование целевого контейнера
• -a = <storageAccount> - имя целевой учетной записи хранилища
• -t = <mountType> - тип целевого подключения (тип подключения по умолчанию - azureBlob)
Чтобы создать отчет, выполните следующую команду из оболочки Windchill:
windchill wt.fv.tools.datamigration.PrepareInputDataForMountMigrationTool mount -u <userName> -p <password> -t <mountType>
Имя целевой учетной записи хранилища и имя целевого контейнера являются необязательными аргументами. Чтобы перенести подключения из одного хранилища Azure в другое хранилище Azure, укажите имя целевой учетной записи хранилища и имя целевого контейнера с помощью аргументов -a и -c. Если типом подключения источника является azureBlob, инструмент автоматически генерирует целевой путь подключения на основе имени целевой учетной записи хранилища, имени целевого контейнера и той же структуры каталогов, что и у пути подключения источника.
При переносе подключений из архивов на основе файлов или хранилища Amazon S3 в хранилище Azure введите целевой путь подключения вручную в CSV-отчет. В этом случае инструмент не генерирует целевой путь подключения автоматически.
 |
• Для создания правильных целевых путей подключения с помощью аргументов -a и -c структуры каталогов архива в хранилище Azure и целевом хранилище Azure должны совпадать. Если структура каталогов не совпадает, целевой путь подключения должен быть введен вручную.
• Если найдена корневая папка со свойством AutoFolderCreation=false, в оболочке Windchill отображается ошибка. Чтобы устранить эту ошибку, запустите инструмент wt.fv.tools.FolderToRootFolderConverter.
• При переносе подключений из архивов на основе файлов в другие архивы, созданные на основе файлов, введите целевой путь подключения вручную в CSV-отчет. В этом случае инструмент не генерирует целевой путь подключения автоматически.
|
Обновление подключений
CSV-отчет, созданный на предыдущем шаге, можно использовать в качестве входного файла для обновления подключений с помощью MountMigrationTool.
Чтобы перечислить все возможные опции командной строки, выполните следующую команду:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -h
Ниже приведен список допустимых аргументов:
• -h = <help> - справка
• -u = <username> - имя пользователя администратора
• -p = <password> - пароль администратора
• -v = <verbose> - запуск утилиты в режиме отладки
• -r = <rootFolderName> - имя корневой папки
• -t = <newMountType> - тип подключения. Допустимыми значениями являются amazonS3 и azureBlob.
• -m = <newMountPath> - путь подключения в Amazon S3 или хранилище BLOB-объектов
• -i = <inputFile> - путь к входному CSV-файлу
Выполните следующую команду из оболочки Windchill, чтобы изменить тип подключения и путь подключения для всех корневых папок:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -i <inputFile>
Выполните следующую команду в оболочке Windchill, чтобы изменить тип подключения и путь подключения для одной корневой папки за один раз:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -r <RootFolder name> -m <mount path on Azure Blob Storage Container> -t azureBlob
Например:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -r defaultuploadfolder1 -m storageaccountname/testcontainer/defaultup -t azureBlob
После выполнения утилиты с аргументом -i в сводке отображается следующий статус:
• Successful - имена корневых папок успешно перенесены.
• Failed - не удалось перенести имена корневых папок.
• Skipped - имена корневых папок пропущены, так как они были успешно перенесены в предыдущем выполнении.
Можно также просмотреть статус переноса подключений во входном CSV-файле после выполнения утилиты. Можно выполнять MountMigrationTool несколько раз с одним и тем же входным CSV-файлом.
|
|
Если в процессе переноса для существующей корневой папки во входном файле существует зеркальный корневой путь подключения, обрабатывается только основной путь, а дополнительные пути отбрасываются.
|
Вместо использования инструмента командной строки можно отсоединить корневую папку и подключить ее для хранилища BLOB-объектов Azure из пользовательского интерфейса конфигурации архива. Отметим, что при выполнении этих операций из пользовательского интерфейса конечные пользователи не должны получать доступ к содержимому в корневой папке. При переносе одиночного подключения с помощью аргументов -r, -t и -m удалите флаг Read Only перенесенной корневой папки из пользовательского интерфейса конфигурации архива. Новая корневая папка, созданная на шаге Подготовка системы для переноса, может содержать файлы, которые не требуется удалять из корневой папки в ходе выполнения этого процесса переноса архива.
По завершении процесса переноса архива восстановите расписания репликации и репликации содержимого и настройте свойство wt.fv.faultTolerantVaultsAutoRestore.