Share this page

# How to migrate virtualization projects

You can migrate virtualization projects and archived projects located in ALM 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 ALM version-control enabled project, the ALM resources must be checked in. Resource Manager checks out the resources, and checks them back in after migration.

In this topic:

## Migrating Virtualization Projects on Windows

1. Do one of the following:

   - On the Service Virtualization Server, open a command prompt. Navigate to the \bin folder under the Service Virtualization Server installation folder. By default, the folder location is C:\Program Files\Micro Focus\Service Virtualization Server\Server\bin.
   - On the Service Virtualization Designer machine, open a command prompt. Navigate to the \bin folder under the Service Virtualization Designer installation folder. By default, the folder location is C:\Program Files\Micro Focus\Service Virtualization Designer\Designer\bin.

2. 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 Service Virtualization Server or Designer log folder, accessible from the Windows Start menu.

   Tip: In version 5.4.1, you can also open the Designer log directly from Service Virtualization by selecting Open Designer Log from the Help menu.

Back to top

## 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".

Back to top

## 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 ALM. To specify a resource stored in ALM, use the following format: Resources\[path to file or folder] For example, Resources\MyVirtualProject\VirtualProject1.vproja Tip: To locate and copy an ALM folder path, in the Designer, from the main menu, select File > Open Project/Solution. On the sidebar, select ALM Resources, and navigate to the desired folder. Copy the path from the Look in box.

ALM connection options

Option | Description
--- | ---
/s [ALM_URL] | ALM URL. The URL of the ALM server on which the files are located, in the following format: <ALM server IP or hostname>:<port number>/qcbin. The path must contain /qcbin at the end.
/d [ALM domain] | ALM domain. The ALM domain name in which the files are located.
/p [ALM project] | ALM project. The ALM project name in which the files are located.
/u [ALM user] | ALM user. The ALM user for the ALM connection.
/pw [ALM user password] | ALM user password. The password for the ALM user. The password is case-sensitive.
/c [Check- in comment] | Check-in comment. When migration is performed in a version-control enabled ALM project, a default check-in comment is added, indicating that the resource was modified by the 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 ALM Server http://MyALMServer:8080/qcbin, in the domain Default, in the project MyProject, in the Resources module under the folder MyVirtualProject.

Back to top

https://admhelp.microfocus.com Service Virtualization 8942
Tips to improve your search results... Service Virtualization Help Center SV Help 5.4-5.4.1 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: