Limitations
-
Docker installation: Auvik is providing a Docker Container of its collector to allow flexibility for installation in different environments. This image is built on an x86/x64 platform. This means installing on hardware other than that will require emulation by Docker to run. This will impact the collector's performance from what it is on native hardware. While this “emulation mode” is not fully supported by Auvik at this time, additional resources may be required for optimum performance if it is used.
-
Image auto-updates: Due to the nature of docker images, we cannot offer auto-updates of the Auvik Networks collector image. It is recommended that users manually handle pulling and updating the docker image to ensure no braking changes and that their collectors remain active.
FAQ
Docker Configuration
Environment Variables
The Auvik collector Docker container can be configured with the following environment variables:
Required Variables
-
AUVIK_DOMAIN_PREFIX– The Auvik tenant name of where the collector should be connected and installed to. -
AUVIK_USERNAME– The user email address used to authenticate the agent upon initial connection. -
AUVIK_API_KEY– Either the user API key or the one-time registration key.
Optional Variables
-
AUVIK_FTP_PORT_RANGE– Used by FTP backups; indicates the first (default: 50100-50120) -
AUVIK_SNMP_ENABLED- Control if the SNMP daemon service is enabled. When enabled, the collector will be able to identify itself as a collector on the Auvik network map (default: true)
Ports
-
161– Used by the collector to identify itself as an Auvik collector on the network map -
2055,2056,4432,4739,6343,9995,9996– Used for receiving TrafficInsights data -
10021– Used for initializing FTP backups -
10069– Used for TFTP -
54059– Used for receiving Syslog data
Volumes
-
./etc/auvik– recommended: Volume stores collector identifier information -
./config– recommended: Volume stores configuration settings used by the collector -
./logs– optional: Volume stores log files generated by the collector
Running the Docker Image
As a Docker Container
docker run --rm \
--detach \
--name nanook \
--hostname nanook \
--cap-add NET_ADMIN \
-e AUVIK_USERNAME="nanook@auvik.com" \
-e AUVIK_API_KEY="nanook-test-key" \
-e AUVIK_DOMAIN_PREFIX="nanooksmsp" \
-v './config:/config' \
-v './etc/auvik:/etc/auvik' \
-v './logs/:/usr/share/agent/logs/' \
auviknetworks/collector:latest
As a Docker Compose Service
services:
collector:
image: auviknetworks/collector:latest
container_name: "nanook"
hostname: "nanook"
environment:
AUVIK_USERNAME: "nanook@auvik.com"
AUVIK_API_KEY: "nanook-test-key"
AUVIK_DOMAIN_PREFIX: "nanooksmsp"
cap_add:
- NET_ADMIN
volumes:
- './config/:/config/'
- './etc/auvik/:/etc/auvik/'
- './logs/:/usr/share/agent/logs/'
restart: unless-stopped
As a Kubernetes Stateful Set
apiVersion: apps/v1
kind: StatefulSet
metadata:
name: auvik-collector
namespace: <namespace>
labels:
app: auvik-collector
spec:
replicas: 1
selector:
matchLabels:
app: auvik-collector
template:
metadata:
labels:
app: auvik-collector
spec:
restartPolicy: OnFailure
containers:
- name: auvik-collector
image: auviknetworks/collector:latest
env:
- name: AUVIK_USERNAME
value: "nanook@auvik.com"
- name: AUVIK_DOMAIN_PREFIX
value: "nanooksmsp"
- name: AUVIK_API_KEY
valueFrom:
secretKeyRef:
name: auvik-collector
key: nanooksmsp-api-key
resources:
requests:
memory: "4Gi"
cpu: "2"
limits:
memory: "4Gi"
cpu: "2"
volumeMounts:
- name: config
mountPath: /config/
- name: etcauvik
mountPath: /etc/auvik/
- name: logs
mountPath: /usr/share/agent/logs/
volumeClaimTemplates:
- metadata:
name: config
spec:
accessModes: [ "ReadWriteOnce" ]
resources:
requests:
storage: 16Mi
- metadata:
name: etcauvik
spec:
accessModes: [ "ReadWriteOnce" ]
resources:
requests:
storage: 32Mi
- metadata:
name: logs
spec:
accessModes: [ "ReadWriteOnce" ]
resources:
requests:
storage: 16Gi
