--- schema_version: "1" id: e7b89bd6cc31f01c7257c877c73c90c97c6e1b188f9d7cb035d9c405ec4ac799 title: Assess the Migration Readiness in Your Development Sandbox (Vlocity Industries Managed Packages and Custom Data Model) collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/os_migrate_phase1_step2.md canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_phase1_step2.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 9df50b8ee15d74a5bfc47003ebcd4d617fc90ddef23d80f7f937f5e429c4a80d description: In the development sandbox, run the Omnistudio Migration Assistant in Assess mode to assess how the migration process impacts each Omnistudio component. products: - Omnistudio release: "264" --- # Assess the Migration Readiness in Your Development Sandbox (Vlocity Industries Managed Packages and Custom Data Model) In the development sandbox, run the Omnistudio Migration Assistant in Assess mode to assess how the migration process impacts each Omnistudio component. Before You Begin To run the Omnistudio Migration Assistant, you must have the Omnistudio admin and Omnistudio user permission sets assigned. See [Omnistudio Permission Sets](https://help.salesforce.com/s/articleView?id=xcloud.os_omnistudio_permission_sets_licenses.htm&language=en_US&type=5). ![phase1\_step2\_assess](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/omnistudio_for_managed_packages/images/os_oma_migrate_phase1_step2_assess.png) ![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/images/icon_important.png) Important Always run the Assess mode before running the Migrate mode to understand the impact and avoid incomplete or incorrect migration. Review the assessment report for any failed statuses and resolve them before proceeding with migration. 1. Authenticate to the migration sandbox org: ``` sf org login web --instance-url= ``` 2. When prompted, enter your username and password. The authorization successful message appears. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-omnistudio_for_managed_packages-264-0-0-production-enus/aa2554ec-624a-4ee6-8da4-6435670e6e62/images/icon_note.png) Note All prompts in the Omnistudio Migration Assistant have a timeout of five minutes. If no input is provided within this time, the command exits automatically. 3. [Install the Omnistudio Migration Assistant](https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_install_oma.htm&release=264.0.0&type=5 "The Omnistudio Migration Assistant is a command-line interface (CLI) plug-in that you install using Salesforce CLI."). 4. Run the Omnistudio Migration Assistant in Assess mode. `sf omnistudio:migration:assess [-u ] [-a] [-v ] [--only=(dm|ip|os|fc|autonumber|cl)] [--relatedobjects=(apex|lwc|expsites|flexipage) [--loglevel=(trace|debug|info|warn|error|fatal|trace)]` - To assess all versions of the components, use `-a` or `–allversions`: ``` sf omnistudio:migration:assess -u -a ``` Where, `YOUR_ORG_USERNAME@DOMAIN.COM` is your username in the sandbox. Example: `sf omnistudio:migration:assess -u asmith@sample.com -a` - To assess specific components, use the `-o` or `--only=dm` parameter: - `--only=dm`: Data Mappers - `--only=ip`: Integration Procedures - `--only=os`: Omniscripts - `--only=fc`: Flexcards - `--only=autonumber`: Omni Global Auto Numbers - `--only=cl`: Custom Labels - `--only=sfl`: Omniscript Saved Sessions (Save For Later) Example: `sf omnistudio:migration:assess -u asmith@sample.com –only=dm` Use `--only` to scope the assessment to specific component types (for example, `--only=dm,ip`). This scoping applies to assess mode only. When you migrate, always migrate all component types together. See [Migrate Your Components in Your Development Sandbox (Vlocity Industries Managed Packages and Custom Data Model)](https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_phase1_step3.htm&release=264.0.0&type=5 "Migrate all your custom components from Omnistudio for Vlocity to Omnistudio Standard using the Omnistudio Migration Assistant. It overwrites any previously migrated components.") - To assess specific or all related objects, use the `-r` or `--relatedobjects` parameter: - `--relatedobjects=apex`: Apex classes - `--relatedobjects=lwc`: Lightning web components - `--relatedobjects=expsites`: Experience Sites - `--relatedobjects=flexipage`: FlexiPages - `--relatedobjects="apex,lwc,expsites,flexipage"`: all related objects Example: `sf omnistudio:migration:assess -u asmith@sample.com --relatedobjects=apex` - To assess username or alias for the target org and to override the default target org: - `-u ` or `--targetusername=`: Username of the target org or alias you’ve set up in Salesforce CLI for that org. Example: `sf omnistudio:migration:assess -u asmith@sample.com` - To assess username or alias for the Dev Hub org and to override the default Dev Hub org: - `-v ` or `--targetdevhubusername=`: Username of the target Dev Hub org or alias you’ve set up in Salesforce CLI for that org. Example: `sf omnistudio:migration:assess -v asmith@sample.com` - To control the amount of details shown in the command output: - `--loglevel=(trace|debug|info|warn|error|fatal`) : Sets the logging level for this command invocation. Default is warn. - `trace` or `debug`: Show very detailed logs, useful for troubleshooting. - `info`: Shows general informational messages. - `warn` (default): Shows warnings and errors only. - `error` or `fatal:` Show only errors or critical failures. Example: `sf omnistudio:migration:assess -u asmith@sample.com –loglevel=debug` 5. If multiple Omnistudio packages are found, select one of the packages by entering its number. 6. When prompted, enter y or n to specify whether you already have a Salesforce project with related objects. - If you entered n: 1. The tool connects to your org and retrieves the Apex classes. 2. Enter y to proceed. 3. Create an empty project folder where the tool can retrieve and store Apex classes. 4. When prompted, enter the path to the project folder. For example: /Users//Downloads/OMA - If you entered y: 1. When prompted, enter the path to the project folder that contains the retrieved Apex classes. For example: /Users//Downloads/OMA 7. Enter y to confirm that you consent to enable the ExperienceBundle metadata API and migrate Experience Cloud sites. The assessment process is initiated. After the assessment is complete, a confirmation message appears indicating that the reports are ready for review. For example: ``` Migration assessment for org 00DDR0000008bj32AA is complete and reports are ready for review in the folder /assessment_reports ``` Where, `` is the location on your machine where the assessment reports are stored. The assessment reports also appear in a new browser window. The assessment reports are generated for these components: - Omniscripts - Flexcards - Data Mappers - Integration Procedures - Apex Classes - Omni Global Auto Numbers - FlexiPages - Experience Cloud Site Pages - Lightning Web Components - Custom Labels - Omniscript Saved Sessions 8. Click the component for which you want to view the assessment report, and review it to identify potential migration issues and determine whether any updates are required before migration. See [Review the Assessment Reports](https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_review_assess_reports.htm&release=264.0.0&type=5 "When you run the Omnistudio Migration Assistant in Assess mode, it generates assessment reports for Omniscripts, Flexcards, Data Mappers, Integration Procedures, Apex Classes, Omni Global Auto Numbers, FlexiPages, Experience Cloud Site Pages, Lightning Web Components, and Custom Labels. These assessment reports highlight several key areas that require attention before migrating Omnistudio components."). 9. To ensure a smooth migration, complete all the pending action items that are listed as **Needs Manual Intervention** in the assessment reports. 10. To validate readiness, re-run the Omnistudio Migration Assistant in Assess mode. Each time you run the Omnistudio Migration Assistant, it reruns assessments on all components and generates new reports. 11. Make sure that all records listed in the Assessment Status column in the Assessment Report are marked as either Ready for Migration or Warnings before proceeding with the migration. - **[Review the Assessment Reports (Vlocity Industries Managed Packages and Custom Data Model)](https://help.salesforce.com/s/articleView?id=xcloud.os_migrate_review_assess_reports.htm&release=264.0.0&type=5)** When you run the Omnistudio Migration Assistant in Assess mode, it generates assessment reports for Omniscripts, Flexcards, Data Mappers, Integration Procedures, Apex Classes, Omni Global Auto Numbers, FlexiPages, Experience Cloud Site Pages, Lightning Web Components, and Custom Labels. These assessment reports highlight several key areas that require attention before migrating Omnistudio components.