Patches Installation

From AdempiereWiki

Jump to: navigation, search

Contents

[edit]

Instructions for Patches Installation

As announced stable versions are going to be maintained for some time (still not determined) for production purposes.

Here is the latest patch file from sourceforge: patches_3.4_20081031.jar (this download link is always pointing to the latest for your convenience)

You just need to download the latest released patches file, it contains all the classes patched in previous releases

[edit]

IMPORTANT NOTICE

patches.jar file is intended for official releases from Adempiere project

You can do a similar approach with your customized classes using customization.jar file in lib directory.

Just take note that customization.jar classes have greater priority than patches.jar, so if you customized a class that is patched in patches.jar file - it's your responsibility to patch it also in customization.jar (otherwise it won't be taken by the process depicted here)

[edit]

Quick Instructions

  1. Download latest patches file from sourceforge.net
  2. Backup your $ADEMPIERE_HOME/lib/patches.jar
  3. Copy the downloaded file to $ADEMPIERE_HOME/lib/patches.jar
  4. Stop the app server (RUN_Server2Stop)
  5. RUN_setup
  6. Start the app server (RUN_Server2)
  7. Reinstall local clients if needed (for java webstart clients the reinstall is automatic)
[edit]

Detailed Instructions

[edit]

Download patches file from sourceforge

Please download patches file according to the version you're running (check latest timestamp in download page)

The naming convention for patches is: 

patches_[version]_[date].jar

i.e. patches_3.4_20081031.jar can be downloaded here: patches_3.4_20081031.jar

[edit]

Backup your lib/patches.jar

Directory: $ADEMPIERE_HOME/lib (it depends where you unzipped the installation release files) 

i.e. Windows: C:\Adempiere\lib
i.e. Linux  : /home/adempiere/Adempiere/lib

In case you have problems with the new downloaded file it's good to preserve the previous (you-know-working) patches.jar.

Suggestion: just rename patches.jar to patches.jar.working_ok

[edit]

Copy the downloaded file lib/patches.jar

Now you can copy the just-downloaded file to $ADEMPIERE_HOME/lib as patches.jar

following the example: 

i.e. Windows: copy patches_3.4_20081031.jar C:\Adempiere\lib\patches.jar
i.e. Linux: cp patches_3.4_20081031.jar /home/adempiere/Adempiere/lib/patches.jar

Please take account this command is a copy and rename at the same time. The downloaded file is being copied to lib directory and renamed to patches.jar (yes, the file you just backed up)

[edit]

Stop the app server

Now you must stop the app server - it depends on your installation, it can be shutting down adempiere service or running utils/RUN_Server2Stop.[bat/sh]

[edit]

RUN_setup

Now run the RUN_setup.[bat/sh] - same as you did when you installed the stable version.

You can also run the RUN_silentsetup.[bat/sh]

[edit]

Start the app server

If the previous step finished ok, then you can now start again the app server - it depends on your installation, it can be starting adempiere service or running utils/RUN_Server2.[bat/sh]

[edit]

Reinstall local clients if needed

If you have clients installed locally (i.e. with the zip client), you must reinstall them. (They also could be used just copying patches.jar to the lib directory on client, but it is recommended to do a complete install - and in fact is better recommended to use java webstart)

For java webstart clients the reinstall is automatic.

Retrieved from "http://www.adempiere.com/wiki/index.php/Patches_Installation"
Personal tools