# Upgrade Data Catalog to a patch version This document provides the steps required to upgrade Pentaho Data Catalog (PDC) to a specific patch version. Applying a patch ensures that your environment receives the latest defect fixes, performance improvements, and security updates, while maintaining compatibility with the corresponding GA version. Each patch release includes two components: * **pdc-\-cp.\-images.tgz**: A file containing the Docker images included in the patch release. * **pdc-\-cp.\.patch**: A smaller text file with the Docker image tags that need updating. **Prerequisites** Before you begin, ensure: * You have administrative access to the server where Data Catalog is installed. * The GA version related to the patch must be installed on your server. For example, if you are installing a PDC 10.2.7 patch, you must first have PDC 10.2.7 GA installed. * You have a backup of your configuration and data. * The `pdc--cp.-images.tgz` and `pdc--cp..patch` files must be placed in the Data Catalog server. * PDC is installed via Docker at `/opt/pentaho/pdc-docker-deployment`. **Assumptions** It is assumed that Data Catalog has been installed with Docker at the installation path: `/opt/pentaho/pdc-docker-deployment` **Procedure** Perform the following steps to upgrade Data Catalog to a specific patch version: 1. Go to the Data Catalog installation folder, where Data Catalog is installed. ```bash cd /opt/pentaho/pdc-docker-deployment/ ``` 2. Stop the currently running Data Catalog services. ```bash ./pdc.sh stop ``` 3. Back up configuration files: 1. Create a backup folder in `/opt` to store the container data and configuration backups. ```bash mkdir /opt/pdc_backup_ ``` 2. Copy the `config` folder to the backup folder you have created. ```bash cp -a /opt/pentaho/pdc-docker-deployment/conf/ /opt/pdc_backup_ ``` 3. Copy the `vendor` folder to the backup folder you have created: ```bash cp -a /opt/pentaho/pdc-docker-deployment/vendor/ /opt/pdc_backup_ ``` 4. Back up Docker volumes: 1. Identify Data Catalog Docker volumes. ```bash docker volume ls | grep pdc* ``` 2. Go to the Docker volumes path. ```bash cd /var/lib/docker/volumes ``` 3. Copy Data Catalog Docker volumes to the backup folder: ```bash cp -a pdc* /opt/pdc_backup_/ ``` 5. Verify that all configuration files and Docker volumes are backed up correctly in the backup folder. 6. Load the new images into the Docker repository. ```bash docker load -i pdc--cp.-images.tgz ``` 7. Apply the patch using the correct method for your version. * **For versions prior to 10.2.8**: back up `.env.default` and update it with the new tags from the patch file. ```bash cp vendor/.env.default vendor/.env.default.bkp ``` 
awk -F= 'NR==FNR {a[$1]=$2; next} $1 in a {$2=a[$1]}1' OFS== \
       <path-to-patch>/pdc-<version>-cp.<patch number>.patch \
       vendor/.env.default.bkp > vendor/.env.default
* **For versions 10.2.8 and later**: run the patch helper. ```bash ./pdc.sh apply-patch pdc--cp..patch ``` 8. Start PDC services. ```bash ./pdc.sh up ``` 9. Log in to Data Catalog and navigate to the Management section, then confirm that the version has been updated to match the patch version.
10. Repeat steps from 1 to 9 on each server that runs a PDC remote worker. **Result** You have successfully upgraded the Data Catalog patch version. You can also refer to the [Advanced configuration](/pdc-admin/ldc-advanced-configuration-ut_cp.md) section in the [Administer Pentaho Data Catalog](https://docs.pentaho.com/pdc-admin/) guide for additional configurations required. --- # 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.pentaho.com/pdc-10.2-install/install-pentaho-data-catalog/upgrade-data-catalog/upgrade-data-catalog-to-a-patch-version.md?ask= ``` 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.