To start Tectia Server in debug mode, follow these instructions:
Stop the server, if it is currently running. Use the start-stop script described in Starting and Stopping the Server:
Start the server executable by entering the following command with root privileges:
# ssh-server-ctl start --server-log-file /tmp/server-debug.txt \
--server-debug-level <filter>
Note | |
---|---|
Recommended on Linux with systemd and on SELinux-enabled systems where manually starting the service is not supported. |
Or manually, on other Unix systems:
# /opt/tectia/sbin/ssh-server-g3 -D<filter>
In the command:
filter
is an expression that takes the following syntax:
"module=level,module=level,..."
for example
"*Cert*=4,*Ocsp*=7"
.
In case you define a filter with
several modules with overlapping names, list the modules in increasing levels of
detail (highest level last).
module
is an optional expression. It can be used to restrict the
debug output to only a particular module or to allow the use of varying debug levels
for different modules, for example "2,SecShServer*=4"
or
"6,*Nio*=0"
level
is an integer from 0 (no debug info) to 99 that specifies the
desired amount of debug information.
Note | |
---|---|
The levels 1-9 are the recommended debug levels. The higher the number, the more detailed the troubleshooting output will be, and the more the debugging will affect performance. |
The following example command starts the server with a global debug level 4 and outputs the debug information to the screen:
# /opt/tectia/sbin/ssh-server-g3 -D4
The following example command
starts the server listening on port 777, using only 1 servant process, and using filters
to display level 2 output from everything else, but level 4 output from modules starting
with "SecShServer". The debug output is redirected to file
server.log
.
# /opt/tectia/sbin/ssh-server-g3 -l 777 -n 1 -D"2,SecShServer*=4" > server.log 2>&1
To view all options available for ssh-server-g3
, enter the following
command:
# ssh-server-g3 -h