How to Collect StellarOne Logs
  • 07 May 2025
  • 3 Minutes to read

How to Collect StellarOne Logs


Article summary

Summary

This document contains the steps for the collection of StellarOne debug logs.


Details

When troubleshooting StellarOne issues, collecting debug logs is crucial for identifying the root cause. Follow these steps:

Step 1: Access the RDQA Page

  • Open your web browser and navigate to https://<StellarOne_Server>/rdqa.

StellarOneRDQA.png

Step 2: Set Debug Log Level to Verbose

  • Select the Verbose option from the Debug Log Level dropdown menu.
  • Click the Save button.
Important Warning:

Set the Debug Log Level to Verbose before reproducing the issue. If the level is too low, you may need to repeat the process and capture the logs again with a higher level for more detailed information.

Step 3: Reproduce the Issue

  • Perform the steps that originally led to the issue so that the debug logs can capture all necessary details.

Step 4: Collect Debug Logs

  • Click the Collect Debug Log button.

StellarOnerdqa2.png

Step 5: Reset Debug Log Level

  • Switch the Debug Log Level back to Warn (the default setting).
  • Click Save to finalize the change.


Uploading Server Debug Logs via SCP/SFTP from the vShell Console

This method serves as a backup option for retrieving the server debug log in situations where the customer is unable to access the StellarOne console.

image2021-10-18_15-46-0.png



SCP
Similar to scp tool, it use ssh protocol to sent file. Since this is for debug log transfer, no source argument required

scp dlog <USER_NAME> <IP> <DIRECTORY>

For Windows 10 and above, follow below step to install Openssh:

  1. Go to Windows Setting > System > Manage optional features > Add a feature
  2. Select OpenSSH Server and click Install
  3. If you cannot install OpenSSH Server using this way, try download and manually install PowerShell
  4. For more installation methods, please check windows document.
  5. Enable port 22 for OpenSSH Server (income) or disable Firewall
  6. Go to Windows Service and make sure OpenSSH service are running

image2021-10-18_14-41-3.png



On StellarOne, use "/" to replace "" for Windows file path , as shown in the example below

scp dlog zen 192.168.15.133 C:/Users/zen/Desktop

Input windows user password. If success you will see below message

image2021-10-18_14-34-57.png



SFTP

This command supports the SFTP protocol, which operates under an SSH server. It is different from FTP, and we do not support the FTP protocol

sftp dlog <USER_NAME> <IP> <DIRECTORY>

For Windows 10 and above, follow below step to setup SFTP:

  1. Go to Windows Setting > System > Manage optional features > Add a feature
  2. Select OpenSSH Server and click Install
  3. Enable port 22 for OpenSSH Server (income) or disable Firewall
  4. Go to C:\ProgramData\ssh
  5. Find below block inside file sshd_config
# Example of overriding settings on a per-user basis
#Match User anoncvs
#   AllowTcpForwarding no
#   PermitTTY no
#   ForceCommand cvs server
 
Match Group administrators
       AuthorizedKeysFile __PROGRAMDATA__/ssh/administrators_authorized_keys
  1. Modify block content as below
# Example of overriding settings on a per-user basis
#Match User anoncvs
#   AllowTcpForwarding no
#   PermitTTY no
#   ForceCommand cvs server
 
Match Group administrators
       AuthorizedKeysFile __PROGRAMDATA__/ssh/administrators_authorized_keys
       ForceCommand internal-sftp
       Match User <Windows username allow to use this service>
       ChrootDirectory <root location of sftp server>

For example

# Example of overriding settings on a per-user basis
#Match User anoncvs
#   AllowTcpForwarding no
#   PermitTTY no
#   ForceCommand cvs server
 
Match Group administrators
       AuthorizedKeysFile __PROGRAMDATA__/ssh/administrators_authorized_keys
       ForceCommand internal-sftp
       Match User zen
       ChrootDirectory C:\Users\zen\Desktop\
  1. Restart or Start OpenSSH service
    On StellarOne, the command below will send log.tar.gz to C:\Users\zen\Desktop\ as configured above
sftp dlog zen 192.168.15.133 /



Troubleshooting
Q: Failed without Compressing
A: Authenticate failed. Please check network, Openssh server and username/password
image2021-10-18_14-43-52.png


Q: Failed with Compressing
A: Path issue. Please make sure the folder is exists on server and user have permission to write on that folder.
image2021-10-18_14-45-57.png


For support assistance, please contact us at support@txone.com or your support provider.

Was this article helpful?