> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/command/get-the-app/upgrade-v4x-to-v46.md). # Upgrade from v4.x to v4.6 The mandatory clean-up update sets for customers upgrading YouDesign Command to version 4.6 from any version between 4.0 and 4.5. If you upgrade to version 4.6 from any version between 4.0 and 4.5, update the app and then apply the configuration fix update sets for each version you pass. They remove legacy content that can cause issues if it stays. Apply them on every instance. | Configuration fix | What it removes | Required? | | --------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | [V4.6](#configuration-fix-v4.6) | Unnecessary cross-scope privileges and reporting on user groups | Yes | | [V4.5](#configuration-fix-v4.5) | Legacy configuration, including two panes on the Sankey tab | Yes, in addition to the V4.4 and prior fixes | | [V4.4 and prior](#configuration-fix-v4.4-and-prior) | Legacy tables, the unused cost API and rating functions, and legacy portal configuration | Critical files only once their content is no longer in use. Recommended files in all cases. | {% hint style="info" %} **Upgrading to v26.0?** Follow [Upgrade from v4.8 to v26.0](/command/get-the-app/upgrade-v48-to-v260.md) as well. {% endhint %} {% hint style="info" %} **Mandatory for V4.x to V4.6 Upgrades** This instruction is only for customers upgrading from YouDesign Command Version 4.0, 4.1 to Version 4.2, V4.3.x, V4.4 and V4.5 and is **mandatory**. **The upgrade steps need to be followed as described below to ensure that legacy content is removed, which may cause issues if not removed.** Please apply the steps below in all instances. {% endhint %} ## Updating YouDesign Command 1. Go to **System Applications/Installed** and search for YouDesign Command. 2. Select the latest YouDesign Command version and click on **Update**. ![The Update button for YouDesign Command in System Applications](https://414746897-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx4mE784snR9Eb8oVrk4e%2Fuploads%2Fgit-blob-4e8505e4bd0ceac1771ac5ce1def0e82959df4d5%2Fbbbfa3a-UPM-X_Update.png?alt=media) {% hint style="warning" %} The Update will take some time. Wait until the update has been completed before you proceed. {% endhint %} ## Configuration Fix V4.6 This Update Set aims to enhance the application's security and efficiency by removing unnecessary Cross-Scope Privileges and reporting on user groups that have no impact on the application. * Download this "[**V4.6 UpdateSet**](https://www.ins-pi.com/hubfs/App%20Update%20Files/UPM-X%204.6%20Post%20Upgrade.xml)" XML file. * Go to "**Retrieved Update Sets**" in ServiceNow * Click on "**Import Update Set from XML**" under the related links * Select the downloaded UpdateSet and upload it * Click on "**Preview Update Set**" after the upload is completed * Accept all Warnings and Errors and click on "**Commit Update Set**"\ The Upgrade procedure has been completed. ## Configuration Fix V4.5 Download and execute this UpdateSet in addition to the V4.4 and prior upgrade instructions. This Configuration Fix will remove some legacy configuration files. To implement the Configuration Fix V4.5: * Download this "[**V4.5 UpdateSet**](https://www.ins-pi.com/hubfs/App%20Update%20Files/UPM-X%204.5%20Post%20Upgrade.xml)" XML file. * Go to "**Retrieved Update Sets**" in ServiceNow * Click on "**Import Update Set from XML**" under the related links * Select the downloaded UpdateSet and upload it * Click on "**Preview Update Set**" after the upload is completed * Accept all Warnings and Errors and click on "**Commit Update Set**"\ The Upgrade procedure has been completed. {% hint style="info" %} Changes include **Removal** of two Grid Canvas Panes from the Sankey Tab. This change is the result of upgrades to the Sankey Diagram function in the Strategic Planning Dashboard. This means the two Grid Canvas Panes are no longer necessary. {% endhint %} ## Configuration Fix V4.4 and prior {% hint style="info" %} **Import and commit the following Update Sets to delete legacy configuration** Download the [V4.4 UpdateSet](https://www.ins-pi.com/hubfs/App%20Update%20Files/UPM-X%20V4.4%20Cleanup.zip) and unzip. {% endhint %} The [V4.4 UpdateSet](https://www.ins-pi.com/hubfs/App%20Update%20Files/UPM-X%20V4.4%20Cleanup.zip) contains the following files and removes the content stated below: ### UPMX 4.4 - 20211216 - Deleted Configuration.xml {% hint style="danger" %} **CRITICAL** Do not execute if the content is still in use! Please contact the support team if you need assistance! {% endhint %} * Business Application x\_inpgh\_upmx\_business\_application * Business Capability x\_inpgh\_upmx\_business\_capability * Information Object x\_inpgh\_upmx\_information\_object * Information Object Attribute x\_inpgh\_upmx\_information\_attribute * Business Process x\_inpgh\_upmx\_business\_process * Associated suggested relationships, reports, ACLs, and more **Addendum 2022-09-26** Additionally, download and execute [the following UpdateSet](https://www.ins-pi.com/hubfs/App%20Update%20Files/UPM-X%204.5%20Post%20Upgrade%20Legacy.xml). ### UPMX 4.4 - COST API Deleted Configuration.xml **Recommended**: not critical but should be executed in all cases. * not leveraged cost API ### UPMX 4.4 - Rating Deleted Configuration.xml **Recommended**: not critical but should be executed in all cases. * not leveraged rating functionality ### UPMX 4.4 - YouDesign Command Portal Deleted Configuration.xml {% hint style="danger" %} **CRITICAL** Do not execute if the content is still in use! Please contact the support team if you need assistance! {% endhint %} For further details, please download the [UPMX V4.4 Cleanup.xlsx](https://www.ins-pi.com/hubfs/App%20Update%20Files/UPM-X%20V4.4%20Cleanup.xlsx) to see the full content of all UpdateSets in various sheets. ## Apply the steps below only to the files above required * Go to "**Retrieved Update Sets**" in ServiceNow * Click on "**Import Update Set from XML**" under the related links * Select the downloaded UpdateSet and upload it * Click on "**Preview Update Set**" after the upload is completed * Accept all Warnings and Errors and click on "**Commit Update Set**"\ The Upgrade procedure has been completed. If you face any issues, please contact us through our [support portal](https://www.ins-pi.com/support/). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.ins-pi.com/command/get-the-app/upgrade-v4x-to-v46.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.