You are viewing limited content. For full access, please sign in.

Announcement

Announcement

Introducing Laserfiche Support Tools, Or: How I Learned To Stop Worrying And Press "4" To Gather Logs

posted on February 16 • Show version history

Download from the Support site: Laserfiche Support Tools

The short: Support Engineer @████████and I spent a few hundred hours scripting nearly every common diagnostic check and log collection request from Laserfiche support cases in PowerShell and bundling them into an application. You simply select the function you want to run from a menu and off it goes. Laserfiche Support Tools runs checks, tests, and data/log collection tasks in seconds that would take ~5-30 minutes each to do manually and bundles up all the clearly labeled structured outputs for you. We hope it will help the community collect high-quality diagnostic data quickly and easily, and in doing so, resolve issues faster.

-------------

The long:

Laserfiche Support Tools provides a guided, menu-driven experience that helps you collect diagnostic information about a Laserfiche environment. It has functions relevant to both self-hosted and Laserfiche Cloud systems. In many cases, the diagnostic output will point you directly to the problem. Output is automatically saved to an organized session folder with clear, consistent filenames, making it easy to review and share findings. Having this diagnostic data ready when contacting support engineers can also help expedite the troubleshooting process.

The tool includes detailed built-in help for every function, and the interface is available in English, Spanish, French, and German (diagnostic outputs are in English).

Support Tools has over 30 functions across five categories:


  • System Information – Listing installed programs, discovering Laserfiche services and IIS applications, getting network configuration, checking Windows Defender status, analyzing TLS/cipher settings, and more.

  • Network Tests – Predefined connectivity tests to the internet, Laserfiche Cloud, and the Laserfiche license activation service; custom target tests for DNS lookups and TCP/HTTPS connectivity; and specialized tests to check TLS certificates, proxy interception, and Windows firewall status.

  • Service Diagnostics – Webtools Agent analysis, retrieving a primary license file from Laserfiche Directory Server, collecting Forms configuration files, and more.

  • Log Collection – Collecting Windows Event Logs (including Laserfiche-specific logs), IIS logs, Workflow logs, and Webtools Agent logs, all organized into clearly labeled subfolders.

  • SQL Server – Testing connections to server instances and specific databases, querying SQL Server version and configuration info, collecting SQL Server error logs, and running standard reports for disk usage, index fragmentation, and query performance.


As a diagnostic tool, most functions are read-only, aside from writing or copying logs to the output directory. Two functions, Webtools Agent Analyzer and Collect IIS Logs, may need to restart that process or service to proceed and will always prompt for approval before doing so. No Support Tools functions modify any Laserfiche, system, or database configurations.

The download is a zip file containing two files: a launcher executable LFSupportToolsLauncher.exe and a README.md with documentation on getting started. Double-click the launcher to open a PowerShell window with no additional setup. For best results, run as Administrator on the machine you're diagnosing – some functions require elevation.

Support Tools was built by Laserfiche support engineers for the Laserfiche community. Gathering diagnostics by hand can be tedious, error-prone, and a major cause of delays resolving issues. Support Tools is intended to make that process as fast, accurate, and painless as possible.

We welcome discussion and feedback about Support Tools here on Laserfiche Answers.

--------------

Additional screenshots of sub-menus showing available functions:

System Information

Network & Connectivity Tests

Service Diagnostics

Log Collection

SQL Server

SQL Server Reports

29 0

Replies

replied on February 17

This is amazing, and me and my team appreciate the effort put into this to make troubleshooting easier for all involved!

3 0
replied on February 17

Hi Sam and Cameron,

I've been running through some of the options on one of my vm's. The informational prompts and auto-naming of the output files are both excellent!

Thank you very much for making this valuable set of tools available!

Rob

3 0
replied on February 17

Gentlemen,
This is a fantastic advancement for the support gang. Kudos to yall for whipping this up and creating some sick radical ascii art. I'm gonna put that art in all my goofball scripts! Gonna take this for a spin on an omega old VM (xp lf 8.3.2) to see what happens!

Thanks so much!

3 0
replied on February 17

Thank you! We used this online Text to ASCII Art Generator to create the header: https://patorjk.com/software/taag/

It's unlikely LF Support Tools will run on Windows XP. It requires PowerShell 5.x, and the latest supported version of PowerShell on XP is 2.0. Fun idea though. 

4 0
replied on February 19

Adventure Time Jake It's So Beautiful Sticker - Sticker Mania

3 0
replied on June 8

This is a fantastic tool Sam, and in my opinion should be built into the core product suite. Could this possibly be merged into the Admin hub somehow? Certainly makes sense, and also provides a bit of 'comfort' to those more security conscious customers that it's part of the standard LF suite and not some rogue PowerShell tool doing funky stuff?

3 0
replied on June 8

Love to hear it! The tool does need to run locally on a given machine (PowerShell Remoting capability is a whole can of worms we intentionally decided against), so Admin Hub isn't the right home for it. We are exploring if it could be made available through the official Laserfiche Installer though, which would hopefully check that "part of the standard LF suite" box. 

Do note that we made the PowerShell script exportable specifically so that security conscious customers can inspect it themselves if desired. Or, more likely, hand it to an AI agent and ask, "is this a rogue PowerShell tool doing funky stuff?" since no one really wants to read eighteen thousand lines of PowerShell laugh

2 0
replied on February 17

Excellent work gentlemen yes

2 0
replied on March 23

Just used this for a support case. Made my job 1000x easier.

2 0
replied on March 24

Love to hear it! Which functions did you use?

1 0
replied on March 24

Honestly, it was just gathering the logs from different servers, but still way easier than gathering each log one by one.

1 0
You are not allowed to follow up in this post.

Sign in to reply to this post.