How to Migrate Virtualization Projects

You can migrate virtualization projects and archived projects located in ALM (Windows only) or in the file system.

Note:  

  • 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.
  • You must turn off FIPS before migrating encrypted projects that were created before Service Virtualization version 4.20. This is not required for .vproja project archives.
  • The migration process generates a log file, which indicates the success or failure status of each entity. The log file is located in the Service Virtualization Server or Designer log folder, accessible from the Windows Start menu.

This topic includes:

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, 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, C:\Program Files\Micro Focus\Service Virtualization Designer\Designer\bin.
  2. Run ResourceManager.exe -migrate at the command line, using the following options:

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

    Option Description

    General Options

    /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
    /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.

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

    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.

Migrating Virtualization Projects on Linux

Run sv-ResourceManager -migrate at the command line, using the following option:

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 must be located in the file system, for example: resources/my-virtual-project/virtual-project1.vproja

sv-ResourceManager -migrate /f resources/my-virtual-project