Skip to main content

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

Article # 3035220 - Page views: 75


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.


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. 


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 



Applies to  

Product Version Build Environment Hardware
Kofax TotalAgility 7.9      


Article # 3035220