SYSPIP - Patch Installation Tool

The script SYSPIP supplies the possibility to apply a patch directly from the command line. Therefore, in Windows environments even the executables like Trade2.exe could be installed with the standard patch handling procedure.

The main features of the patch handling are

• Distributed patch files (e.g. .zip) are automatically unpacked
• Every installation is logged in an install.log
• Backup copies of the new files are automatically taken
• Errors during the application of the patch are logged
• After resolving the reasons for the errors a retry of the patch application is fully supported
• No other patches might be applied before the canceled patch is successfully applied to avoid inconsistent contents of the target
• Different targets (e.g. Customer Overlay, Workenvironment, Product) might be used
• The handling of INI files out of patches is described in detail in Taking over INI Files out of Patches.

1. ———————————————————————–

SYSPIP Patch Installation Tool 1.00 / 24.02.04

------------------------------------------------------------------------


This script is the command line version of the TradeDesign transaction

SYSPIP.


Usage: SYSPIP insbase tarbase patch


insbase This argument holds the absolute base directory of the base

        installation. This is the directory where the bin, log and patch

        directory are located.


tarbase This argument holds the absolute directory where the patch is to

        be applied to. This might be the same as insbase or in case of

        overlays the full file path of the overlay, where the patch shall

        be applied.


patch   This argument holds the name of the patch to be applied. This name

        is either the name of the ZIP file (without the .zip extension)

        or the name of the directory holding the already unpacked patch.


SYSPIP first tries to unzip the ZIP file of the patch and then applies

the patch. The steps in there sequence are: create patch dir, unzip

ZIP file, rename ZIP file to .zip.bak, archive old versions of the

patch files in the directory patch.old, copy all files of the patch to

the target directory.


The following log files below the specified installation base are used:


log\install.log        Installation log of all installed patches

log\syspip.(patch).log Processing log of the application of (patch)

patch\(patch).log      Unzip log of (patch).zip

patch\lasterr.log      Semaphore reflecting incomplete or running patches


CAUTION: Currently SYSPIP does not support path and/or file names with

         embedded blanks.

Sample:

To install the patch p030408 in the installation in D:\DOK5 itself the following command could be used and could create the following output:

D:\DOK5\BIN>syspip d:\dok5 d:\dok5 p030408


SYSPIP is about to handle the patch p030408

to be finally installed in d:\dok5.


Did you check, that all necessary resources are not in use and nobody

else is installing a patch concurrently?


Are you sure that the target of the patch is selected correctly?


You might cancel SYSPIP with CTRL-C now.

Press any key to continue . . .

SYSPIP started to handle patch p030408 with target d:\dok5.

SYSPIP successfully applied patch p030408

in target d:\dok5.