This Article seeks to clarify the instruction in the accompanying READMESP:
"RECOVERING A PREVIOUS INSTALLATION" As part of the OpenEdge Service Pack or Update install routine, an option to backup the current installed version is presented. When selected, the backup routine will copy only the files that are currently installed that are being replaced by the Service Pack or Update.
These files are copied to any writable location on disk, where the following default locations are offered depending on the OpenEdge version:
- The default Windows location is %DLC%\SPBACKUP or %DLC%\Backup<version>
- The default UNIX location is $DLC/spbackup or $DLC/Backup<version>
Never select a backup location that has already been used, it is advisable to always specify a unique location.
After a Service Pack or Update has been successfully applied, it’s advisable to compress the backup directory and archive it to save space. Take particular care with backup archive naming conventions, particularly in mixed OpenEdge 32-bit 64-bit environments. To restore the previous OpenEdge version:1. Stop all OpenEdge processes.
2. If PASOE is installed, then make a backup of the %DLC%\servers\pasoe\common\lib directory and remove all the files within this directory. This is to prevent a mix of old and new libraries from being loaded at the same time when using PASOE.
3. If there is an OEMgmt sub-directory in the backup directory, then move this to another location and copy its contents to the OEM installation directory (e.g. C:\Progress\oemgmt).
4a WINDOWS: Copy the root of the backup folder (including its sub-directories) back to the %DLC% directory.
4b UNIX: Use a recursive copy of the backup directory back to the $DLC directory:
cd <path-to-backup-directory>
cp -R * <Progress-install-directory>
When restoring to a prior version only one Service Pack can be reverted at a time.Example 1:
- Service Pack 1 has been applied to the base OpenEdge 11.6.0 install and the prior install backed up to DLC/SPBACKUP11600_64
- Subsequently the later Service Pack 2 is installed and the prior install backed up to DLC/ SPBACKUP11601_64
To assure the restoration process will result in a clean install perform in the exact reverse order:
- Restore DLC/SPBACKUP11601_64 first, to revert from 11.6.2 to 11.6.1 (and stop here if the intent is to revert to the 11.6.1 Service Pack), otherwise:
- Then restore DLC/SPBACKUP11600_64, to revert from 11.6.1 to 11.6.0 FCS
If DLC/SPBACKUP11600_64 is restored first against the current 11.6.2 install, it is very likely that this will result in a corrupted install as only the changed files are part of the backup.Example 2:
- Service Packs and Hotfixes were installed in this order (and the prior install backed up):
- OpenEdge 10.2B00 + 10.2B02 == (SPBACKUP102B00)
- OpenEdge 10.2B02 + 10.2B05 == (SPBACKUP102B02)
- OpenEdge 10.2B05 + 10.2B08 == (SPBACKUP102B05)
- OpenEdge 10.2B08 + 10.2B0810 == current install.
- To revert from 10.2B0810 Hotfix to any of the previous, the 10.2B08 Service Pack media need to be re-installed
- To revert from 10.2B08 to any of the previous, the SPBACKUP files need to be copied back to the install directory (DLC) in reverse order and stop when the required SP version is reached.
When the option to backup the current installed version is not selected as part of the OpenEdge Service Pack install routine for OpenEdge 11.6 or earlier:
Service Packs and Hoftixes are cumulative forward, not backwards. To restore a previous version
, the First Commercial Shipment (FCS) or base-install version, needs to be installed followed by the Service Pack version (and related Hotfix) required. A previous Service Pack can be installed over a later Service Pack version, install integrity is not guaranteed.
In the above examples: When the SPBackup Option has not been used or that SPBackup archive is no longer available
Current install: OpenEdge 11.6.2
To revert to OpenEdge 11.6.1.x: Install OpenEdge 11.6.0 then install 11.6.1 SP and apply 11.6.1.x hotfix if required, or
Current install: OpenEdge 10.2B08
Install OpenEdge 10.2B00 then the required 10.2B Service Pack and finally apply the 10.2B hotfix if required.
Other Considerations:
1. While full client installs with a later Service Pack will still be able to connect CLIENT/SERVER to Servers with an earlier Service Pack,"Thin Clients" NetSetup installs will need to be uninstalled from the thin client machine(s) then re-run NetSetup to be sure any DLL or OCX files that may have changed within the Service Pack are updated on the local client machine(s).2. To restore ONLY the previous version of OpenEdge Architect or Progress Developer Studio for OpenEdge, refer to Article:
3. The backup feature logic has been changed starting with OpenEdge 11.7.1 where the Update install media can also be used for a full-install:
4. As an alternative, the DLC and OEMGMT directories can be backed up manually before installing the Service Pack or Update instead of using the backup option during install.
