Use this troubleshooting guide to resolve issues with the Smokeball desktop app.
This guide is intended for Windows administrator users. Please forward it to your IT team if applicable.
System environment troubleshooting
Check system performance
Open the Performance tab in Task Manager.
- If CPU uptime > 4 days, check for Windows Updates.
- If CPU uptime < 4 days, restart the Smokeball Windows Service from the Processes tab in Task Manager.
Open the Processes tab in Task Manager. If CPU, Memory Allocation or Hard-disk Read/Write Capacity are > 90%:
- Close all open applications, including Smokeball.
- Restart Smokeball.
- Monitor hardware activity for at least a minute after Smokeball opens.
Check Windows updates
- Open the Start menu.
- Search "Check for updates" and open the Check for updates window.
- Download and install any available updates to Windows.
Smokeball's interface and performance may be affected by an outdated .NET Framework. Please indicate in your support ticket if .NET Framework updates are triggered when checked.
.NET Framework updates may be impeded by other Windows updates, such as Cumulative Updates. You may need to check for these updates multiple times, even after restarting your workstation, to see if they become available.
Check Power Status and Options
General workstation performance may vary depending on power connectivity. Ensure that portable workstations are plugged into AC power.
Ensure that a high-performance power plan is selected in Windows Power Options:
- Open the Windows Control Panel and select Hardware and Sound.
- Select Power Options.
- Choose High-performance as the Selected plan.
Antivirus and security software troubleshooting
Open the utility application of any installed antivirus on the workstation, and add the following Smokeball program folders and files to the list of exceptions:
- C:\Program Files\Smokeball
- C:\Program Files\Smokeball\binaries\Smokeball.exe
- C:\Program Files\Smokeball\binaries\Smokeball.WindowsService.Host.exe
- C:\Program Files\Smokeball\binaries\SmokeballToolbar.dll
- C:\Program Files\Smokeball\binaries\SmokeballToolbarAddIn.dll
- C:\Program Files\Smokeball\binaries\Smokeball.OutlookAddIn.dll
Account authentication troubleshooting
Before reauthenticating a user's account:
- Ensure that all Office documents or emails have been saved and closed.
- Check the Smokeball file upload queue on the top-right corner of Smokeball for failed imported files. Review and confirm any files first, then clear the queue.
- Perform a backup of C:\Program Files\Smokeball\dataAu.
To reauthenticate a user:
Log the user out of Smokeball by selecting File and Log Out from the top-left corner of Smokeball.
- If Smokeball is closed, log the user out by launching C:\Program Files\Smokeball\binaries\Logout.exe.
- Log the user back in.
Uninstalling and reinstalling Smokeball
An IT administrator should uninstall and reinstall Smokeball because User Access Control and antivirus programs require administrator permissions to override.
Before uninstalling Smokeball:
- Perform a DB file backup and save it to a stable location.
- Open Task Manager and suspend the Smokeball Update Service and Windows Service.
- Open the Windows Task Tray and close the Smokeball Tray Icon from there. Otherwise, exit the Smokeball process from the Task Manager.
- Clear all DB files from C:\Program Files\Smokeball\dataAu.
- Uninstall Smokeball from the Windows Apps & features window.
To reinstall Smokeball:
- Download the Smokeball client from https://www.smokeball.com.au/download.
- Reinstall Smokeball and log the user back into their account once the installation is complete. Ensure they can access their account.
Note: Reinstallation may take a while (> 30 minutes), depending on the system environment. Confirmation of successful login may also take some time to ensure that reinstallation has not locked the user out of their account.