> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/install/9.3-install/pentaho-upgrade-cp/post-upgrade-tasks-pentaho-ugrade-cp/apply-customizations-post-upgrade-tasks/address-customizations-to-upgraded-archive-installation-post-upgrade-customization-task.md).

# Address customizations with post-upgrade versions

For items listed in the CSV file that you want to keep in the 9.3 upgrade, you must address how your customizations are applied with the 9.3 features available in post-upgrade versions of these items.

Perform the following steps to address your customizations with Pentaho 9.3 versions of items listed in the post-install report:

1. Navigate to the `<root installation directory>/Pentaho__Installation` directory.
2. Open the `postInstallConfigReport.txt` file in a text editor.

   This report contains the following sections:

   * `These config files need merged`
   * `These config files were not updated by the upgrade, but were changed pre-upgrade`
   * `These config files were not found in the upgrade`
   * `These config files were identical to the upgraded files`
3. For each item listed in the `These config files need merged` section of the post-install report, open both the existing version and the version with the `.merge.post_upgrade` extension to compare their differences.
4. Verify the differences between the item's two versions and perform one of the following actions:
   1. If the upgrade process changes are minor, such as a single date change, then retain your existing version by deleting the post-upgrade version.
   2. If your existing content and the Pentaho 9.3 changes both apply for your setup, then merge the differences of the two versions into one item with the same name as the existing version.
   3. If your existing content can be overwritten by the upgrade process changes, then replace the existing version with the post-upgrade version.

Your customizations now appear in your 9.3 Pentaho products.


---

# 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 dynamically by asking a question.

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

```
GET https://docs.pentaho.com/install/9.3-install/pentaho-upgrade-cp/post-upgrade-tasks-pentaho-ugrade-cp/apply-customizations-post-upgrade-tasks/address-customizations-to-upgraded-archive-installation-post-upgrade-customization-task.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
