---
title: "Extracting Patches"
slug: "how-to-extract-upload-a-patch-for-analysis"
updated: 2021-12-28T12:03:44Z
published: 2021-12-28T12:03:44Z
canonical: "success.panaya.com/how-to-extract-upload-a-patch-for-analysis"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://success.panaya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extracting Patches

This information is relevant for standalone Patches or Upgrade projects. If you are using Release Dynamix, [follow these instructions instead](/v1/docs/how-to-extract-upload-a-patch-for-ongoing-changes-analysis)Panaya’s solution requires running a Java program on your Oracle Apps Server. This program extracts the vanilla versions of the relevant files in the patch for Panaya to present the impact on your Oracle environment.**Important**You must upload at least one [Custom Code extract](/v1/docs/how-to-extract-upload-your-custom-code-using-the-code-box) to Panaya before uploading a patch extract for analysis.Please also verify the code extraction (ETL) was uploaded in the last three months (90 days) for your system, else the Patch analysis will not succeed.Before running the Patches Extraction Process, please make sure that you meet the [requirements](/v1/docs/what-are-the-prerequisites-for-extracting-uploading-a-patch-for-analysis)

## **Extracting The Patches Files**

To upload a patch:

1. [Log in to Panaya](https://help.panaya.com/docs/how-to-log-in-to-panaya)
2. Use the **Menu button ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-1639921976563.png)**to select a **Patches Project**
3. From with the **Patches Project**, hover over the **Overview tab** and select **Changed Content**  
![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-1639921989198.png)
4. In the Project Setup **section**, select Upload Content  
 ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-1639922004182.png)
5. Click on Download the Oracle extraction tool to download the extraction tool
6. It is recommended to download the most updated version from the Panaya Upload Content screen. Do not use older versions.
7. Upload the panaya-ptl-extractor.jar file to your Oracle Application Server
8. Change your working directory to the location of the panaya-ptl-extractor.jar
9. Create a directory that will contain only the ZIP files of the patches that you want to analyze before they have been installed
10. **Do not unzip or install the files**
11. Using your Oracle Apps OS user (with access to the Oracle environments), **execute one of the following commands**:

java -jar panaya-ptl-extractor.jar [-prompt] <Patches directory>  Parameters explanation -**<APPS password>** - Mandatory - The password of your APPS schema in the DB  
**<Patches directory>** - Mandatory - The location of the patches you downloaded  
**[-prompt]** - this will open a dialog box for the user to enter the apps password. This will mask the password for cases where other users attempt to sign in to the system and execute the command ps -ef. An output directory will automatically be created for you during the patches extraction process. The directory's name will be output_<date>_<time>. When running, the screen will look like this:  
![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-1639922038272.png)  
  
At the end of the process, **one ZIP File** will be created in your output directory (e.g., PTL_20121015_1259.zip), which you’ll be asked to upload to the Panaya website.  
  
If you don’t have access from your Application server to the Panaya website, please copy the file from there.**Note**  
If you are using a [controlled release patch](/v1/docs/how-to-upload-a-patch-extract-larger-than-2gb-controlled-release-patches), please [click here](/v1/docs/how-to-upload-a-patch-extract-larger-than-2gb-controlled-release-patches) for additional instructions.  
If you are running the Patches extractor on 12c database, follow the instructions described [here](/v1/docs/unable-to-connect-to-db-error-message-while-running-the-custom-code-patches-extraction)  

---

## **Upload The Patches Extract File**

1. Select Click to browse and locate the zipped file created by the patches extraction process. You can also drop the ZIP file onto the cloud area.
2. It is also possible to drop your [**customizations**](/v1/docs/how-to-fill-out-the-customization-xls-file) XLS file here. [For more information, click here.](/v1/docs/how-to-fill-out-the-customization-xls-file)
3. Select Start upload.
4. The duration of the upload depends upon the size of the file.
5. When the upload process is complete, you will be able to view the list of uploaded files below.