To generate a log file for troubleshooting, please create a temp folder in the system (C:\) drive and create an INI file named PrnDebug.ini into (C:\) root.
With Notepad please add the following entries to the PrnDebug.ini file.
[Setting]
Debug=1
If the folder and ini file exists, every InstallShield installation generates a detailed log file automatically in the C:\temp folder named BIDriverInstall.log. The generated log file contains all the steps performed during the installation and also lists any errors that may occur. This is useful for Developers and System Integrators when troubleshooting any problems during the installation.
The Install dll, Install dll (legacy) and Uninstall dll have a built-in feature to generate detailed log files of the Black Ice Printer Drivers installations.
Note:
Install dll name conversion:
BiInstall32.dll
Install dll (legacy) name conversion:
MyDll_NT.dll
Uninstall dll name conversion:
Color Desktop printer
BiARmvNT.dll
ColorPlus Desktop printer
BiCRmvNT.dll
EMF Desktop printer
BiERmvNT.dll
Monochrome Desktop printer
BiMRmvNT.dll
PDF Desktop printer
BiPRmvNT.dll
Color Server printer
BiARmvTS.dll
ColorPlus Server printer
BiCRmvTS.dll
EMF Server printer
BiERmvTS.dll
Monochrome Server printer
BiMRmvTS.dll
PDF Server printer
BiPRmvTS.dll
Example for install log file:
537.20474556 04/08/16 14:55:48: [5532] [8176] MyDLL_NT.dll: * Install DLL for Windows NT x86
537.31679245 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: * devmode.h version: 1441
537.35378760 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: * Loading Module: C:\Windows\system32\MsiExec.exe
537.37870077 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Attempting to parse CAData:
537.43322758 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: PrinterInstallWithMSI called
537.46125125 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: InitializeMSIVariable called - Reading install parameters from registry.
537.49447433 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Reading parameters from 32-bit registry key 'HKEY_LOCAL_MACHINE\SOFTWARE\Black Ice Software LLC\ColorPlusNT\PrinterVariablesValues'.
537.51888185 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Reading parameters from 64-bit registry key 'HKEY_LOCAL_MACHINE\SOFTWARE\Black Ice Software LLC\ColorPlusNT\PrinterVariablesValues'.
537.55194072 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Reading parameters from 32-bit registry key 'HKEY_CURRENT_USER\SOFTWARE\Black Ice Software LLC\ColorPlusNT\PrinterVariablesValues'.
537.60081773 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Reading parameters from 64-bit registry key 'HKEY_CURRENT_USER\SOFTWARE\Black Ice Software LLC\ColorPlusNT\PrinterVariablesValues'.
537.72810723 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value DRIVER_CONFIG_INI_MSI: BuAIniNT.ini
537.79602259 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value DRIVER_FILE_MSI: BuADrvNT.dll
537.83466181 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value MONITOR_FILE_MSI: BuAMonNT.dll
537.89244004 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value MONITOR_NAME_MSI: Ice Monitor A
537.97252778 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value PORT_NAME_MSI: IcePortAR:
538.03037035 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value PROCESSOR_FILE_MSI: BuAProNT.dll
538.11247320 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value PROCESSOR_NAME_MSI: ColorPlus Print Processor
538.17858148 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value RESOURCE_DLL_MSI: BuAResNT.DLL
538.22197367 04/08/16 14:55:49: [5532] [8176] MyDLL_NT.dll: Read registry value USER_INTERFACE_NAME_MSI: BuAUifNT.dll
538.38386466 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: Read registry value PRINTER_NAME_MSI: Send to Digital Alternatives
538.45079359 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: Read registry value DRIVER_NAME_MSI: Send to Digital Alternatives
538.47537992 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: Read registry value TIFF_DLL_MSI: Tiff32.dll
538.54528355 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: Read registry value JPEG_DLL_MSI: Jpeg32.dll
538.56594585 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: InitializeMSIVariable succeeded (return 0)
538.59915353 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: dInstallBlackIcePrinter called. parameters:
538.62362263 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - DRIVER_CONFIG_INI: BuAIniNT.ini
538.67498132 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - DRIVER_FILE: BuADrvNT.dll
538.80778326 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - MONITOR_FILE: BuAMonNT.dll
538.84717089 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - MONITOR_NAME: Ice Monitor A
538.87138380 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - PORT_NAME: IcePortAR:
538.90367571 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - PROCESSOR_FILE: BuAProNT.dll
538.92840099 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - PROCESSOR_NAME: ColorPlus Print Processor
538.96732283 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - RESOURCE_DLL: BuAResNT.DLL
539.00571336 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - USER_INTERFACE_NAME: BuAUifNT.dll
539.09028527 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - PRINTER_NAME: Send to Digital Alternatives
539.11813051 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - DRIVER_NAME: Send to Digital Alternatives
539.15097465 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - TIFF_DLL: Tiff32.dll
539.18393722 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - JPEG_DLL: Jpeg32.dll
539.20862578 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: - DRIVER_TYPE: 8
539.24174663 04/08/16 14:55:50: [5532] [8176] MyDLL_NT.dll: dAddPortMonitor called. Adding Port Monitor BuAMonNT.dll, Monitor name: Ice Monitor A
539.26638270 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: CreateRegistryEntriesforPort called. Creating registry entry SYSTEM\CurrentControlSet\Control\Print\Monitors\Ice Monitor A\PortList
539.31815546 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: CreateRegistryEntriesforPort succeeded (return TRUE)
539.34881791 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: ! Error: AddMonitor failed! Error code: 1722
539.38186810 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: dAddPortMonitor: Verifying added monitor.
539.40664627 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: ! Error: Verification failed!
539.43954331 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: dAddPortMonitor finished (return 1722)
539.46426030 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: dInstallBlackIcePrinter failed (return 2)
539.49731522 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: Error in call dInstallBlackIcePrinter(), Error code: 2
539.52774597 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: PrinterInstallWithMSI failed (5)
Troubleshooting occurring errors based on the log file
Please find the problem function on Install dll page or Windows standard code and check the error code description.
For Example:
If the following error line appears in the log file:
539.49731522 04/08/16 14:55:51: [5532] [8176] MyDLL_NT.dll: Error in call dInstallBlackIcePrinter(), Error code: 2
Then the dInstallBlackIcePrinter() function returned with an error code: 2.
Find the dInstallBlackIcePrinter() function on Install dll page and check the error code description.
2; failed dAddPortMonitor();
In this example, the error code 2 means, that the dAddPortMonitor() function failed.
If the error code is over 100 that error code is Windows standard code
1722: The Print Spooler service is not running.
Example for uninstall log file:
586.14388114 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: * Uninstall DLL for Windows NT x86
586.16901394 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: * Loading Module: C:\Windows\system32\MsiExec.exe
586.17208947 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: StartUninstallMSI called
586.19065971 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Driver type: ColorPlusNT
586.19260800 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Reading parameters from 32-bit registry key 'HKEY_LOCAL_MACHINE\SOFTWARE\Black Ice Software LLC\ColorPlusNT\PrinterVariablesValues'.
586.22199274 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Reading parameters from 64-bit registry key 'HKEY_LOCAL_MACHINE\SOFTWARE\Black Ice Software LLC\ColorPlusNT\PrinterVariablesValues'.
586.28142124 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Reading parameters from 32-bit registry key 'HKEY_CURRENT_USER\SOFTWARE\Black Ice Software LLC\ColorPlusNT\PrinterVariablesValues'.
586.28301949 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Reading parameters from 64-bit registry key 'HKEY_CURRENT_USER\SOFTWARE\Black Ice Software LLC\ColorPlusNT\PrinterVariablesValues'.
586.28483872 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Read registry value MONITOR_NAME_MSI: Ice Monitor A
586.28580755 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Read registry value PROCESSOR_NAME_MSI: ColorPlus Print Processor
586.28762203 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Read registry value PRINTER_NAME_MSI: Black Ice ColorPlus
586.28965776 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Read registry value DRIVER_NAME_MSI: Black Ice ColorPlus Driver
586.31465452 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: StartUninstall called
586.31770435 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Creating uninstall dialog
586.33586196 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Calling CDlgUninstall::Uninstall
586.33923753 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: CDlgUninstall::Uninstall called
586.44708001 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: SYSTEM directory: C:\Windows\system32
586.44969654 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: Spooler status: 1
586.45203119 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: The spooler is not running, attempting to start it!
586.45349535 07/04/16 11:48:29: [3244] [3312] BuXRmvXX.dll: dDeletePrinterDriver : DeletePrinterDriver successfull - nothing to remove
586.66412938 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: PortMonitor not found, not uninstalled
586.67707516 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: ! Error: DeletePrintProcessor failed! Last error: 1722, Return Value: 0
586.68085469 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: The spooler was not running before, attempting to stop it!
586.68371036 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: StopTheSpooler: Error stopping the spooler service, ControlService function failed with the following error: 1062
586.68543404 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: ! Error: Failed to stop the spooler!
586.68685154 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: CDlgUninstall::Uninstall succeeded (return 0)
586.68908618 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: CDlgUninstall::Uninstall returned 0
586.69045870 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: Calling EndDialog
586.74753495 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: StartUninstall finished (return 0)
586.75099992 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: StartUninstallMSI succeeded (return 0)
Troubleshooting occurring errors based on the log file
Please find the problem function on Uninstall dll page or Windows standard code and check the error code description.
For Example:
If the following error line appears in the log file:
586.67707516 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: ! Error: DeletePrintProcessor failed! Last error: 1722, Return Value: 0
586.68085469 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: The spooler was not running before, attempting to stop it!
586.68371036 07/04/16 11:48:30: [3244] [3312] BuXRmvXX.dll: StopTheSpooler: Error stopping the spooler service, ControlService function failed with the following error: 1062
In this example, the error code 2 means, that the dAddPortMonitor() function failed.
If the error code is over 100 that error code is Windows standard code
1722: The Print Spooler service is not running.
1062: The Print Spooler service has not been started (Example: The Print Spooler is disabled).