> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/harness-solutions-factory/new-to-hsf/hsf-upgrade/manual-upgrade-for-versions-older-than-225-hsf-upgrade.md).

# Manual Upgrade for Versions Older Than 2.2.5

{% @harness-package-selector/package-selector platforms="%5B%7B%22label%22%3A%22PR%20Process%20Upgrade%22%2C%22slug%22%3A%22pr-process-upgrade%22%2C%22path%22%3A%22harness-solutions-factory%2Fnew-to-hsf%2Fhsf-upgrade%2Fpr-process-upgrade-hsf-upgrade%22%7D%2C%7B%22label%22%3A%22Manual%20Upgrade%20for%20Versions%20Older%20than%202.2.5%22%2C%22slug%22%3A%22manual-upgrade-for-versions-older-than-225%22%2C%22path%22%3A%22harness-solutions-factory%2Fnew-to-hsf%2Fhsf-upgrade%2Fmanual-upgrade-for-versions-older-than-225-hsf-upgrade%22%7D%5D" selectedPlatform="manual-upgrade-for-versions-older-than-225" %}

### Manual Upgrades for Versions Older Than 2.2.5 <a href="#manual-upgrades-for-versions-older-than-225" id="manual-upgrades-for-versions-older-than-225"></a>

*If you have a version older than 2.2 go into IDP and remove all HSF workflows from IDP. You will need to do this because of IDP 2.0 changes we will need to reregister new workflows.*

#### To Update: <a href="#to-update" id="to-update"></a>

1. Go into the `Solutions Factory` project → Pipelines and run `Mirror Harness Official Solutions Factory`
2. Go into `Solutions Factory` project → IaCM Workspaces → `Pilot Light`
   * Go into Configuration → Change the OpenTofu version to at least 1.10.0 → Save Changes (because we restructured how things are deployed and need the ability to
   * Go into Connectors and Variables
     * Remove `delegate_selectors` as it is no longer used
     * Change the `provider_version` to match the version of OpenTofu that you set above
3. Run `Manage Pilot Light`
4. Run `Manage Pilot Light` again because the above run introduces a new step in the post configuration that is needed for the upgrade
5. Go into IaCM Workspaces → `Harness Solutions Factory`
   * Go into Configurations and add tags `source:hsf_system` and `type:solutions-factory`
   * Update the OpenTofu version to the same version that you set above
   * Modify Default Pipelines for all four pipelines to be `Deploy Solutions Factory` → Save Changes
   * Go into Connectors and Variables

     * Remove `delegate_selectors` , `project_id` , and `organization_id` and `organizations` these are no longer needed and should not be modified.
     * Change the `provider_version` to match the version of OpenTofu that was set
     * Verify these variables exist, if not add:

     | Variable Key                   | Value                                                       |
     | ------------------------------ | ----------------------------------------------------------- |
     | hsf\_pipeline\_connector\_ref  | org.hsf\_dockerhub\_connector                               |
     | hsf\_script\_mgr\_image        | harnesssolutionfactory/harness-python-api-sdk:latest        |
     | hsf\_idp\_resource\_mgr\_image | harnesssolutionfactory/harness-idp-resource-manager:latest  |
     | hsf\_iacm\_manager\_plugin     | harnesssolutionfactory/harness-manage-iacm-workspace:latest |
     | enable\_hsf\_mini\_factory     | false                                                       |
     | should\_use\_hsf\_hub          | false                                                       |
     | should\_use\_harness\_idp      | true                                                        |

     * Save Changes
6. Run `Deploy Solutions Factory`
7. If you’re doing an upgrade from pre 2.2 run `Bulk Workspace IDP Registration`
8. The upgrade is now complete!