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
Product | Version | Build | Environment | Hardware |
---|---|---|---|---|
Kofax TotalAgility | 7.9 |
Article # 3035220