Collecting diagnostic information
SquaredUp Support may ask you to run the Dashboard Server Diagnostics Script
Get-SquaredUpAzureDiags.ps1 which gathers log files and information about the configuration of your Dashboard Server instance.
The resulting files are added to a zip file. Please contact SquaredUp Support and reply to the automatic response with the output.
Dashboard Server provides two scripts and may ask you to run one or both of these:
- The Dashboard Server Diagnostics Script
Get-SquaredUpDiags.ps1gathers log files and information about the configuration of your Dashboard Server instance. The resulting files are added to a zip file. Please contact SquaredUp Support and reply to the automatic response with the output.
- The Dashboard Server Kerberos Script
Debug-SquaredUpKerberos.ps1queries the Kerberos configuration when using single sign-on with Windows authentication. The results are shown on screen. Please contact SquaredUp Support and reply to the automatic response with the screenshot.
Procedure: Run the Dashboard Server diagnostics script
- On your SquaredUp server download the diagnostic script package. (The download includes a number of scripts, you only need to run
- Extract its contents to a suitable location, for example C:\Scripts or the desktop.
- Open Windows PowerShell as an administrator (Start Menu > Windows PowerShell, then right-click and select Run As Administrator).
Change location into the directory where you extracted the script, for example:
For the Diagnostics Script:
- Next type
rwhen prompted to run the script.
Enter your SquaredUp support ticket ID, and then the Dashboard Server application that you need to diagnose.
- The script saves a ZIP file(s) to
- Please contact SquaredUp Support and reply to the automatic response with this zip file along with any helpful screenshots of the errors or issue you are experiencing.
How to include your dashboard packs
SquaredUp Support may ask you to include your dashboard packs in the Diagnostics Script for further information.
To include your dashboard packs within the diagnostic zip add
-IncludePackages to the end of your script execution, for example:
Diagnostic Script parameters
You can manually specify the PowerShell path to your SquaredUp Virtual Directory if the script doesn't determine it correctly by adding
-SquaredUpVirtualDirectory to your script execution and specifying the IIS administration path manually.
For example, if the Virtual Directory was under Default Web Site > SquaredUpv5 in IIS the command would be:
.\Get-SquaredUpDiags.ps1 -SquaredUpVirtualDirectory "IIS:\Sites\Default Web Site\SquaredUpv5"
If you want to specify where the resulting ZIP files(s) are saved to add
-OutputZipFile and specify a location, for example:
.\Get-SquaredUpDiags.ps1 -OutputZipFile "C:\Users\User\Documents"
The script collects diagnostic information to a SquaredUpDiags subfolder under the temp directory before it is zipped to OutputZipFile. To change the temp directory add
.\Get-SquaredUpDiags.ps1 -TempDirectory "C:\Users\User\Documents\Temp"