# Upgrade from v4.x to v4.6

{% 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**.

![Image](/files/0HXBquS1qSpW0cMZvWKR)

{% 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: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ins-pi.com/command/get-the-app/upgrade-v4x-to-v46.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
