In order to escalate a CentreStack support issue to CentreStack developers, it is usually necessary to gather information such as client audit logs, version information and potentially DebugView traces from the CentreStack Server and/or CentreStack client(s). There is a set of PowerShell scripts that have been developed to make the collection process simpler and more efficient.
- Navigate to this link:
- Click on the Download current folder button:
The Get-CSSupportInfo.zip will be downloaded (typically to your Downloads directory in your user profile).
- Extract the Get-CSSupportInfo.zip to an empty directory (if you use 7-Zip to extract the files, it is safe to ignore the "Headers Error"). You will see two files in File Explorer:
- Start an elevated PowerShell session (as Administrator).
- Make sure scripts are allowed to run. Execute:
Set-ExecutionPolicy RemoteSignedAnswer "Y" to the Execution Policy Change prompt.
- Change to the directory where the scripts were downloaded for example:
- Unblock the files in the directory:
Get-ChildItem | Unblock-File
- The script support PowerShell's "comment based help". To view this information execute:
Get-Help .\Get-CSInfo.ps1 -full
- Further instructions will be provided from the CentreStack Support Engineer
The Get-CSInfo.ps1 script gathers basic system information and optionally downloads and executes SysInternals DebugView. The script is designed to run on Windows 7 (PowerShell v2) and later. The script is not required to run with Administrator privileges, although the script can optionally start the Microsoft SysInternals DebugView tool which is required to run "as Administrator" on the CentreStack Server and Server Agent (but not the Windows Client).
The script will perform the following actions:
- The script requires the -Ticket parameter with a valid ticket number. If the -Ticket argument is not specified when the script is execute, the user will be prompted for a ticket number:
- The script will determine the CentreStack product that is running on the local machine, either:
- CentreStack Server
- Server Agent
- Windows Client
- The script gathers some basic system information in a .txt file. An example looks like this:
ComputerName : T2BRWP1004
OS : Microsoft Windows 10 Pro
OSVersion : 10.0.18362
OSArchitecture : 64-bit
TotalPhysicalRAMinMB : 3781
FreePhysicalRAMinMB : 1329
TotalVirtualRAMinMB : 4485
FreeVirtualRAMinMB : 1295
Image : C:\Program Files\Gladinet\Cloud Windows Client\GladGroupSvc.exe
ProductVersion : 10.3.2727.43357
- The script will prompt the user if the Microsoft SysInternals DebugView tool should be executed:
If No is selected, this step is skipped. However, if Yes is selected, DebugView will be downloaded from Microsoft and saved in the interactive user's %TEMP% directory. DebugView will be started and will automatically log to a file in the interactive user's %TEMP% directory. The intention is to reproduce the issue, then once the issue is reproduced, close the DebugView program. Once DebugView is terminated, the script will reactivate and perform additional steps.
- Along with a potential DebugView log, for the Windows Client and Server Agent, the script will bundle the audit logs from the last 30 days and archive them in a .zip file. For the CentreStack Server, only the web.config is bundled in the .zip (currently).
- The .txt file and .zip file will be uploaded to an AWS S3 bucket accessible to the CentreStack support staff.
The Copy-CSSupport.ps1 script is called by the Get-CSInfo.ps1 script to upload files to the CentreStack Support AWS S3 bucket. The Copy-CSSupport.ps1 script can also upload any additional arbitrary files that CentreStack Support may wish to include in the issue escalation. For example, the Install-Debugger.ps1 script is capable of saving application memory dumps to the C:\Dumps directory. These files could easily be upload to S3 using the Copy-CSSupport.ps1 script.
Execute this command to see the full comment based help for Copy-CSSupport.ps1:
Get-Help .\Copy-CSSupport.ps1 -Full
Text similar to the following will be displayed:
NAME C:\users\jeffr\downloads\Get-CSSupportInfo\Copy-CSSupport.ps1 SYNOPSIS Uploads a file to CentreStack support's S3 bucket SYNTAX C:\users\jeffr\downloads\Get-CSSupportInfo\Copy-CSSupport.ps1 [-FullName] <String> [-Ticket] <String> [<CommonParameters>] DESCRIPTION Uploads a file to CentreStack support's S3 bucket PARAMETERS -FullName <String> The full pathname to a file to be uploaded to CentreStack support's S3 bucket. Required? true Position? 1 Default value Accept pipeline input? true (ByValue, ByPropertyName) Accept wildcard characters? false -Ticket <String> The CentreStack support ticket number Required? true Position? 2 Default value Accept pipeline input? false Accept wildcard characters? false <CommonParameters> This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216). INPUTS OUTPUTS NOTES Author: Jeff Reed Name: Copy-CSSupport.ps1 Created: 2019-08-12 Version History 2019-08-12 1.0.0 Initial version 2019-08-13 1.0.1 Renamed script 2019-08-13 1.1.0 Refactored script to support the object pipeline or an array of files with the FullName parameter 2019-08-13 1.1.1 Tweaks to comment based help Requires -Version 2 -------------------------- EXAMPLE 1 -------------------------- PS C:\>.\Copy-CSSupport.ps1 -Ticket 8675309 -FullName C:\Temp\DebugView.zip Demonstrates uploading a single file. -------------------------- EXAMPLE 2 -------------------------- PS C:\>Get-ChildItem C:\Dumps -Filter *.txt | .\Copy-CSSupport.ps1 -Ticket 8675309 Demonstrates using the script with the PowerShell pipeline. Uses the Get-ChildItem (aka "dir") cmdlet to send *.txt files down the pipeline to be processed by the script -------------------------- EXAMPLE 3 -------------------------- PS C:\>.\Copy-CSSupport.ps1 -Ticket 8675309 -FullName ("C:\Dumps\1.zip", "C:\Dumps\2.zip") Demonstrates sending an array of file names to the script to be uploaded sequentially. RELATED LINKS
As you can see in the comment based help examples, there are few different ways that Copy-CSSupport.ps1 may be executed.
To upload a single file the command would look like this:
Copy-CSSupport.ps1 -Ticket 8675309 -FullName C:\Temp\DebugView.zip
You could use the Get-ChildItem cmdlet (which acts similar to the old "dir" command), to upload all *.txt files in a given directory like this:
Get-ChildItem C:\Dumps -Filter *.txt | .\Copy-CSSupport.ps1 -Ticket 8675309
You could also specify a list ("array") of files like this:
Copy-CSSupport.ps1 -Ticket 8675309 -FullName ("C:\Dumps\1.zip", "C:\Dumps\2.zip")