Skip to main content
Kofax

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

Article # 3035220 - Page views: 82

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  

Product Version Build Environment Hardware
Kofax TotalAgility 7.9      

 

Article # 3035220