---
schema_version: "1"
id: 218b036d82fa60738dd88e792fafd979ae78569e22ba246dccf0041f51da89b1
title: Install the Omnistudio Migration Assistant
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_migrate_install_oma.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_install_oma.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 72caa46969c8b71457d770d76351f97c5a92f8a504b9db0be36157c581c5485b
description: The Omnistudio Migration Assistant is a command-line interface (CLI) plug-in that you install using Salesforce CLI.
products:
  - Omnistudio
release: "264"
---
# Install the Omnistudio Migration Assistant

The Omnistudio Migration Assistant is a command-line interface (CLI) plug-in that you install using Salesforce CLI.

If you’re migrating your components from Vlocity Industries managed packages and Custom data model to Omnistudio standard runtime, the Omnistudio Migration Assistant creates records for your components on the Salesforce standard objects and gives the components valid unique names.

If you’re migrating your components from Vlocity Industries managed packages and standard data model to Omnistudio standard runtime, the Omnistudio Migration Assistant updates records for your components on the Salesforce standard objects and gives the components valid unique names.

If you’re migrating your components from Omnistudio Foundation packages and standard data model to Omnistudio standard runtime, the Omnistudio Migration Assistant updates records for your components on the Salesforce standard objects and gives the components valid unique names.

To install the latest version of the Omnistudio Migration Assistant:

1. Open a Terminal window.
2. Authenticate Salesforce CLI in your migration sandbox:
    
    ```
    sf org login web --instance-url=<your_sandbox_URL>
    ```
3. In the new browser tab that appears, enter your org username and password.
4. Open the [Omnistudio Migration Assistant tool](https://www.npmjs.com/package/@salesforce/plugin-omnistudio-migration-tool?activeTab=versions) Versions page.
5. In the **Current Tags** table, search for a tool version where the **Tag** column shows `rc`, and note down the version number.
6. If a previous version of the Omnistudio Migration Assistant is installed, uninstall it before installing the latest version:
    
    ```
    sf plugins uninstall omnistudio-migration-tool
    ```
7. To install the latest version of the Omnistudio Migration Assistant, run this command, replacing `<tool_version>` with the version number you noted down earlier:
    
    ```
    sf plugins install
          @salesforce/plugin-omnistudio-migration-tool@<tool_version>
    ```
    
    Example: `sf plugins install @salesforce/plugin-omnistudio-migration-tool@2.0.0-rc.59`