CloudConnexa: Increase Logging Level for Linux Connector

Introduction

To troubleshoot connectivity issues with the Linux Connector in OpenVPN3, you can increase the log verbosity level for the referenced services to 6, which will show all reported events.

You can do this in three ways:

• Option 1: Attach a logger to one terminal and restart the session in another to capture the full connection process in real-time.

• Option 2: Permanently increase the logging level of the background services and the profile configuration.

• Option 3: Start the session directly in the foreground using the openvpn2 emulation utility.

Global service settings

The OpenVPN 3 central logging service (openvpn3-service-log) acts as a system-wide gatekeeper (receiver filter) for log verbosity. Regardless of the option you choose, you must ensure the central service allows level six logs by running the following command:

sudo openvpn3-admin log-service --log-level 6

Additionally, you can increase the log level of the network configuration service (openvpn3-service-netcfg):

sudo openvpn3-admin netcfg-service --config-set log-level 6

Important: To activate the network configuration service settings, you must restart the openvpn3-service-netcfg service. To avoid potential connection issues, ensure all active VPN sessions are stopped before restarting the service.

To stop active sessions and restart the service:

1. Stop any active VPN sessions (replace CloudConnexa with your profile name if it differs):

sudo openvpn3 session-manage --config CloudConnexa --disconnect

Note: The default profile name is CloudConnexa. Older deployments might use OpenVPN Cloud. Run sudo openvpn3 sessions-list to verify your active profile name.

2. Terminate the network configuration service (it automatically restarts on the next connection request):

sudo killall -INT openvpn3-service-netcfg

Option 1: Interactive real-time logging

To capture real-time initialization logs, use a two-terminal approach:

1. Open Terminal 1 and start the log utility at verbosity level six for your configuration:

sudo openvpn3 log --log-level 6 --config CloudConnexa

2. Open Terminal 2 and restart the session to trigger a new connection sequence:

sudo openvpn3 session-manage --config CloudConnexa --restart

3. Return to Terminal 1 to view the detailed connection logs as they occur.

Option 2: Persistent log level configuration

Use this option if you need background services to run at a higher verbosity level on an ongoing basis:

1. Set the configuration profile name:

CONFIG_NAME='CloudConnexa'

2. Configure the profile override to use log level six:

sudo openvpn3 config-manage --config $CONFIG_NAME --log-level 6

3. View the logs:

• Using the OpenVPN3 Admin Tool:

sudo openvpn3-admin journal --since today

• Using the system journal:

journalctl --since today --grep openvpn

Option 3: Real-time logging with the openvpn2 emulation utility

If you have the .ovpn configuration file available, you can start the session directly in the foreground using the openvpn2 command-line emulation wrapper:

openvpn2 --config config.ovpn --verb 6