HCL Sametime Debug utility

HCL Sametime Sametime Forum
1

Hi, I have created small shell file, that collect logs for HCL Support.

https://github.com/vtatarincev/debug_sametime

if you provide feedback I can improve it. in addition to collection of logs, utility also does local backup of configuration files with timestamps. ideas and feedback is welcome. I even did that SCP command to copy file is generated.

[root@meet sametime]# ./debug_sametime.sh

*******************************************

welcome to CYONE HCL Sametime debug utility

v.1.2 vlaad cyone . eu

*******************************************

Uptime 2.4 hours

Creating support folder HCL_TECHNICAL_SUPPORT

Checking system requirements:

Number of processors: Minimum should be 8! You have 8

Amount of memory : minimum should be 16GB! You have 19GB

1/7. Debug filename: HCL_TECHNICAL_SUPPORT/sametime_logs_2022_09_09_14_33.txt

2/7. Running docker-compose logs

3/7. Gathering Netstat output, adding to debug information

4/7. Generating MD5 hashes of files, so support can verify. This may take 20-30 sec

4/7. Gathering server network config.

5/7. Zipping files, please wait 1 sec

adding: HCL_TECHNICAL_SUPPORT/sametime_logs_2022_09_09_14_33.txt (deflated 97%)

adding: custom.env (deflated 54%)

adding: .env (deflated 56%)

adding: docker-compose.yml (deflated 84%)

adding: HCL_TECHNICAL_SUPPORT/netstat_2022_09_09_14_33.txt (deflated 89%)

adding: HCL_TECHNICAL_SUPPORT/md5sum.txt (deflated 65%)

adding: HCL_TECHNICAL_SUPPORT/network.txt (deflated 61%)

adding: HCL_TECHNICAL_SUPPORT/about.txt (deflated 19%)

adding: HCL_TECHNICAL_SUPPORT/sysinfo.txt (deflated 86%)

6/7. Lets backup important files. Dont forget to backup them outside this server!

Backuping .env docker-compose.yml custom.env to HCL_TECHNICAL_SUPPORT with timestamp 2022_09_09_14_33

7/7. Information: Size of debug directory: HCL_TECHNICAL_SUPPORT

44K HCL_TECHNICAL_SUPPORT/BACKUP

41M HCL_TECHNICAL_SUPPORT

*********

File /opt/hcl/sametime/HCL_TECHNICAL_SUPPORT/sametime_logs_2022_09_09_14_33.zip has all information to debug issue.

Powered by CYONE.EU. Check out www for great products for Notes/Domino/Traveler/Sametime

use following command to download ZIP to your local PC

scp root@meet.acme.local:/opt/hcl/sametime/HCL_TECHNICAL_SUPPORT/sametime_logs_2022_09_08_12_58.zip sametime_logs_2022_09_08_12_58.zip

debug_sametime.zip
2

@Anthony Payne do you think it makes sense such script?

3

Yes - I think the script can be very helpful.

4

Viadislav, Nice debug gather script !

5

Hello Vladislav,

Tried this out on my ST 12 test environment, the data collection looks great, good job + thank you!

Keith

6

I was struggling with Youtube streaming issue, and .. I was able to solve it with my script.

I added auto parsing of logs, so errors are filtered and I found that I don't have recorders and that recorders are responsible for streaming. https://help.hcltechsw.com/sametime/12/admin/configure_virtual_devices.html

so in last 1.4 version also info on recorders and containers.

debug_sametime.zip