Starting Tectia Server in Debug Mode on Windows


On Windows, to get debug output from the Windows server using Tectia Server Configuration GUI, you need to have appropriate Windows policy rights to have the "Debug programs" policy enabled. The admin user has the policy enabled by default.

To start the Tectia Server in debug mode, follow these instructions:

  1. Open the Tectia Server Configuration tool from the Start menu by selecting: Start → Program Files (x86) → SSH Tectia Server → SSH Tectia Server Configuration

    The following window appears:

    Tectia Server Configuration - Tectia Server page

    Figure 9.2. Tectia Server Configuration - Tectia Server page

  2. Stop the server, if it is currently running, by clicking the Stop Server button. This will enable the Troubleshooting Options button.

  3. Click the Troubleshooting Options button and select the Run server in troubleshooting mode option. Additionally, you can go under Troubleshooting string and specify the level of information to display. The string can be a filter or a number from 1 to 99 (the default is 2). The higher the number, the more detailed the troubleshooting output will be, and the more the debugging will affect performance.


    The levels 1-9 are the recommended debug levels. Important: if <debug_level> above 4 is needed, it is recommended to use a filter instead of enabling global level for all modules. For example "4,SshUser*=9" or "*Cert*=4,*Ocsp*=7" can be used to limit debug only to specific modules for user authentication.

    In case you define a filter with several modules with overlapping names, list the modules in increasing levels of detail (highest level last).

    Editing troubleshooting options

    Figure 9.3. Editing troubleshooting options

  4. Click OK to close the Troubleshooting Options window.

  5. Click the View Troubleshooting Log button to open a window where the troubleshooting information will be displayed.

    Viewing troubleshooting log

    Figure 9.4. Viewing troubleshooting log

    You can store the log contents into a file by clicking the Log to a File button. Define the file name and location as applicable.

  6. Start the server by clicking the Start Server button.

    The troubleshooting information will now be displayed in a window named Tectia Server Troubleshooting Log.

After troubleshooting the server follow these steps to disable the troubleshooting:

  1. Stop the server by clicking the Stop Server button.

  2. Click Troubleshooting Options and unselect the Run server in troubleshooting mode option.

  3. Start the server by clicking the Start Server button.