During an attempt to install a test patch using the ApplyPTF GUI interface, the patch install may fail with corrupted binary characters presenting in the output display. Examples shown:
Manually extracting the CAZ file and running ApplyPTF via the direct JCL file may also fail with similar results.
The ApplyPTF GUI does not function properly in select Windows 2016 servers.
Service Management Servers running Windows 2016
Issue is specific to Windows 2016 and does not present in Windows 2012.
A workaround to apply such a test fix is to use the ApplyPTF executable in silent mode on a command prompt.
APPLYPTFPATH\APPLYPTF.exe /SILENT /OUTPUTFILE=OUTPUTLOGFILEPATH /DEBUGFILE=DEBUGLOGFILEPATH /PTF=C:\PROGRA~2\CA\SERVIC~1\patches\testfix.caz /INSTALLAGAIN /INSTALLNEW /NODE=HOSTNAME
APPLYPTPATH : Full path where applyptf present or you can directly open command prompt and start from APPLYPTF.exe
OUTPUTLOGFILEPATH : You can provide output log file path with file name for /OUTPUTFILE
DEBUGLOGFILEPATH : You can provide debug log file path with file name for /DEBUGFILE
HOSTNAME : Server name where you are applying testfix for /NODE
C:\PROGRA~2\CA\SC\ApplyPTF\APPLYPTF.exe /SILENT /OUTPUTFILE=C:\patch\output1.dat /DEBUGFILE=C:\patch\debug1.dat /PTF=C:\PROGRA~2\CA\SERVIC~1\patches\T6BF002.caz /INSTALLAGAIN /INSTALLNEW /NODE=SERVER1234
The above will install patch T6BF002 to server "SERVER1234" and write output and debug files C:\patch\output1.dat and C:\patch\debug1.dat respectively.
Because the application will run silently, it is best to allow about 5 min or so for the patch installation to complete. The output/debug files would need to be examined along with the HIS file to confirm for a successful patch install (files may be read with a text editor).
We recommend manually stopping any product services that are running on the target server before running a patch install update.
The /SILENT parameter is essential as the ApplyPTF will invoke its GUI interface without this parameter and will also experience the same behaviour described above if leveraged.
COMMAND LINE SCRIPT IS AVAILABLE.
Attached to this tech doc is a script that can be used to run the above ApplyPTF command. It is meant to simplify the process of installing an SDM test patch.
The script is designed as a supplement to ApplyPTF. The following tasks are performed:
To use the attached script, download the given script file, copy the file over to your target server to the same location that ApplyPTF.exe resides, rename the file extension from "txt" to "bat., then run the script as an Administrative user.