How to collect Portnox Docker container logs for support
In this topic, you will learn how to access and collect Portnox Docker container log files using the SSH protocol and the PuTTY application on Windows so that you can attach them to your support ticket.
This topic applies to logs from the following Portnox Docker images:
These instructions assume that you are running your Docker containers on Linux and we tested them using Ubuntu 22. If you are running your Docker containers on a different operating system, you may need to modify the shell commands.
- Install and run the PuTTY application on your Windows computer.
-
Use the PuTTY application to connect to the virtual or physical machine that you use to run your Docker image.
Note: The exact steps needed to connect to the machine depend fully on your environment.
- Optional:
Restart the Docker container using the --debug option.
Note: Does not apply to the following Docker containers because their logs contain debugging information by default: UniFi agent, automatic update.
-
Collect the Docker container logs by copying them to a temporary file:
-
Local RADIUS:
sudo docker logs portnox-radius > /tmp/docker.log
-
Local TACACS+:
sudo docker logs portnox-tacacs > /tmp/docker.log
-
ZTNA gateway:
sudo docker logs portnox-gateway_name > /tmp/docker.log
where gateway_name is the name of your ZTNA gateway.
-
DHCP relay:
sudo docker logs portnox-dhcp-relay > /tmp/docker.log
-
SIEM gateway:
sudo docker logs portnox-siem > /tmp/docker.log
-
UniFi agent:
sudo docker logs portnox-unifi-agent > /tmp/docker.log
-
Automatic update:
sudo docker logs portnox-autoupdate > /tmp/docker.log
-
-
Collect the internal logs by copying them to a temporary compressed file:
Important: Skip this step for the following Docker containers: DHCP relay, SIEM integration, UniFi agent, automatic update. These containers do not save extra internal logs and do not provide shell access.
-
Copy the log files from the Docker host machine to your Windows machine:
Note: You can use any SCP or SFTP client to copy the file to your Windows machine. In this example, we are showing you how to do it using PuTTY’s command-line client.
Result: Your Downloads folder on your Windows machine contains either the docker.log or both this file and the logs.tgz file, which you can attach to your support ticket.