Docker container build results in "Install Failed with Errors" but no specific errors or log files

Issue

When building a docker image with the sample scripts included with Kofax TotalAgility, the output includes the phrase "Install failed with errors," but no specific errors are listed.  No log files are found either.

Cause

KTA 7.8 and earlier write install errors to a file named KofaxTotalAgilityInstallErrorLog.txt on the desktop of the user running Setup.exe, and this is what the docker scripts expect.

KTA 7.9 writes install errors to a file named KofaxTotalAgilityInstallErrorLog.log in the same folder as Setup.exe.

The docker scripts also delete the folder that contains the install source, and thus they delete any error log that may have been written. 

Solution

Open [Install source]\Utilities\Docker\ContainerFiles\PowershellScripts\ConfigureContainer.ps1 and find the following line:

Get-ChildItem -Path "C:\Users\ContainerAdministrator\Desktop" | Where-Object {$_.Name.StartsWith("KofaxTotalAgility")} | ForEach-Object {get-content $_.FullName}

After that line, add the following:

if(Test-Path -path "C:\KTA\TotalAgilityInstall") {
    Get-ChildItem -Path "C:\KTA\TotalAgilityInstall" | Where-Object {$_.Name.StartsWith("KofaxTotalAgility")} | ForEach-Object {get-content $_.FullName}
}
if(Test-Path -path "C:\KTA\OnPremiseMultiTenancyInstall") {
    Get-ChildItem -Path "C:\KTA\OnPremiseMultiTenancyInstall" | Where-Object {$_.Name.StartsWith("KofaxTotalAgility")} | ForEach-Object {get-content $_.FullName}
}
if(Test-Path -path "C:\KTA\IntegrationServerInstall") {
    Get-ChildItem -Path "C:\KTA\IntegrationServerInstall" | Where-Object {$_.Name.StartsWith("KofaxTotalAgility")} | ForEach-Object {get-content $_.FullName}
}

With this change, install errors will get displayed in the docker output.

Alternatively, since install source should not get removed when an error occurs, retrieve the file KofaxTotalAgilityInstallErrorLog.log from the container in the folder applicable to the type of installation:

• C:\KTA\TotalAgility\TotalAgilityInstall
• C:\KTA\OnPremiseMultiTenancyInstall
• C:\KTA\IntegrationServerInstall

Level of Complexity 

High

Applies to  

References

Kofax TotalAgility - Location of the KofaxTotalAgilityInstallErrorLog after a failed install/upgrade

​