Migrate virtualization projects

You can migrate virtualization projects and archived projects located in OpenText Application Quality Management or in the file system.

Note:

Migration is supported for projects created with version 4.00 or higher.
If migration fails, the entities are not modified. You can fix the problem, and run the Resource Manager migration tool again.
To migrate projects or files stored in an OpenText Application Quality Management version-control enabled project, the OpenText Application Quality Management resources must be checked in. Resource Manager checks out the resources, and checks them back in after migration.

Migrating Virtualization Projects on Windows

Do one of the following:
- On the OpenText Service Virtualization Server, open a command prompt. Navigate to the \bin folder under the OpenText Service Virtualization Server installation folder. By default, the folder location is C:\Program Files\Micro Focus\Service Virtualization Server\Server\bin.
- On the OpenText Service Virtualization Designer machine, open a command prompt. Navigate to the \bin folder under the OpenText Service Virtualization Designer installation folder. By default, the folder location is C:\Program Files\Micro Focus\Service Virtualization Designer\Designer\bin.
Run ResourceManager.exe -migrate using the Command line options. The migration process generates a log file, which indicates the success or failure status of each entity. The file is located in the OpenText Service Virtualization Server or Designer log folder, accessible from the Windows Start menu.

Tip: You can also open the Designer log directly from OpenText Service Virtualization by selecting Open Designer Log from the Help menu.

Migrating Virtualization Projects on Linux

To perform a migration on Linux, run sv-ResourceManager -migrate using the Command line options.

The migration process generates a log file which indicates the success or failure status of each entity. The file is located in the $HOME/.cache/sv-server/logs folder, for example /root/.cache/sv-server/logs.

Note: When working in Linux, you need to use an escape backslash in the path names. For example, "Resources\\My Project".

Command line options

Use these options when running the migration script:

Note: If an argument contains spaces, it must be enclosed in quotation marks. For example, "Resources\My Project".

General options

Option	Description
/f [source_path]	Source path. The path to the project file (.vproj) or project archive file (.vproja). If you specify a folder, all relevant project entities inside the folder are migrated. The files may be located in the file system or in OpenText Application Quality Management. To specify a resource stored in OpenText Application Quality Management, use the following format: Resources\[path to file or folder] For example, Resources\MyVirtualProject\VirtualProject1.vproja Tip: To locate and copy an OpenText Application Quality Management folder path, in the Designer, from the main menu, select File > Open Project/Solution. On the sidebar, select OpenText Application Quality Management Resources, and navigate to the desired folder. Copy the path from the Look in box.

Option

Description

/f [source_path]

Source path. The path to the project file (.vproj) or project archive file (.vproja).

If you specify a folder, all relevant project entities inside the folder are migrated.
The files may be located in the file system or in OpenText Application Quality Management.
To specify a resource stored in OpenText Application Quality Management, use the following format: Resources\[path to file or folder]

For example, Resources\MyVirtualProject\VirtualProject1.vproja

Tip: To locate and copy an OpenText Application Quality Management folder path, in the Designer, from the main menu, select File > Open Project/Solution. On the sidebar, select OpenText Application Quality Management Resources, and navigate to the desired folder. Copy the path from the Look in box.

ALM connection options

Option	Description
/s [ALM_URL]	OpenText Application Quality Management URL. The URL of the OpenText Application Quality Management server on which the files are located, in the following format: <OpenText Application Quality Management server IP or hostname>:<port number>/qcbin. The path must contain /qcbin at the end.
/d [ALM domain]	ALM domain. The OpenText Application Quality Management domain name in which the files are located.
/p [ALM project]	OpenText Application Quality Management project. The OpenText Application Quality Management project name in which the files are located.
/u [ALM user]	ALM user. The OpenText Application Quality Management user for the OpenText Application Quality Management connection.
/pw [ALM user password]	ALM user password. The password for the OpenText Application Quality Management user. The password is case-sensitive.
/c [Check- in comment]	Check-in comment. When migration is performed in a version-control enabled OpenText Application Quality Management project, a default check-in comment is added, indicating that the resource was modified by the OpenText Service Virtualization migration tool. Use this option to override the default comment and enter your own comment.

For example:

Windows

ResourceManager.exe -migrate /f Resources\MyVirtualProject /s http://MyALMServer:8080/qcbin /d Default /p MyProject /u myalmusername /pw mypwd

Linux

sv-ResourceManager -migrate /f Resources\\MyVirtualProject /s http://MyALMServer:8080/qcbin /d Default /p MyProject /u myalmusername /pw mypwd

This command migrates projects and services located on the OpenText Application Quality Management Server http://MyALMServer:8080/qcbin, in the domain Default, in the project MyProject, in the Resources module under the folder MyVirtualProject.