Agent Configuration File (Devices)
Controller Section
[controller] # <metadb> provides directory service for AOS. It must be configured properly # for a device to connect to AOS controller. metadb = tbt://aos-server:29731 # Use <web> to specify AOS web server IP address or name. This is used by # device to make REST API calls to AOS controller. It is assumed that AOS web # server is running on the same host as metadb if this option is not specified web = # <interface> is used to specify the management interface.This is currently # being used only on server devices and the AOS agent on the server device will # not come up unless this is specified. interface =
metadb
Agent Server Discovery is a client-server model. The HPE Networking Apstra
Data Center Director Device agent registers directly to the Apstra DC
Director server via the metadb connection. The Apstra DC
Director server can be discovered from static IP or DNS.
Dynamic DNS - By default, Apstra DC Director device agents point to
the DNS entry aos-server, relying on dhcp-provided DNS resolution and
hostname resolution. On the Apstra DC Director server, if the metadb
connection entry points to a DNS entry, then the Apstra DC Director agents
must be able to resolve that DNS entry as well. DNS must be configured so
aos-server resolves to an interface on the Apstra DC Director server itself,
and so the agents are configured with metadb =
tbt://aos-server:29731
Static DNS - We can add a static DNS entry pointing directly to the IP of aos-server. Add a static DNS entry, or use a DNS Nameserver configuration on the device.
Arista and Cisco Static Hostname
localhost(config)#ip host aos-server 192.168.25.250
Obtaining IP from Apstra DC Director Server
admin@aos-server:~# ip addr show dev eth0
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
link/ether 08:00:27:8a:39:05 brd ff:ff:ff:ff:ff:ff
inet 192.168.59.250/24 brd 192.168.59.255 scope global eth0
inet6 fe80::a00:27ff:fe8a:3905/64 scope link
valid_lft forever preferred_lft foreverThen the agents will be configured with metadb =
tbt://aos-server:29731.
web
In a future release, the Apstra REST API will be able to run on a separate server from the Apstra DC Director server itself. This feature is for Apstra DC Director internal usage only.
interface
The device agent source interface applies to Linux servers only (Ubuntu,
CentOS). This source IP is the server interface that the device agent uses
when registering with Apstra DC Director. For example, on a server, to bind
the device agent to eth1 instead of the default eth0, specify
interface = eth1.
Service Section
[service] # When managing device configuration AOS agent will restore backup config if it # fails to connect to AOS controller in <backup_config_restoration_timeout>, # specified as <hh:mm:ss>. Set it to 00:00:00 to disable backup restoration backup_config_restoration_timeout = 00:00:00
The service section manages specific agent configuration related to configuration rendering and telemetry services.
backup_config_restoration_timeout
Configuration is not stored on the device. This prevents a device from booting up and immediately participating in fabric that may not be properly configured yet. The Apstra DC Director device agent is configured after the discovery phase completes.
backup_restoration_timeout = 00:00:00 This disabled state
(default) keeps the Apstra DC Director device agent from replacing the
running configuration if it cannot contact the Apstra DC Director server.
Any previous configuration state is not restored.
backup_restoration_timeout = 00:15:00 Any value other than
the default 00:00:00 enables the Apstra aDC Director gent
to boot and replace the running configuration with the most known previous
state after the specified period of time (fifteen minutes in this example).
Specifically, the files from /.aos/rendered/ are restored
to the system after the configuration restore period expires.
Logrotate Section
[logrotate] # AOS has builtin log rotate functionality. You can disable it by setting # <enable_log_rotate> to 0 if you want to use linux logrotate utility to manage # your log files. AOS agent reopens log file on SIGHUP enable_log_rotate = 1 # Log file will be rotated when its size exceeds <max_file_size> max_file_size = 1M # The most recent <max_kept_backups> rotated log files will be saved. Older # ones will be removed. Specify 0 to not save rotated log files, i.e. the log # file will be removed as soon as its size exceeds limit. max_kept_backups = 5 # Interval, specified as <hh:mm:ss>, at which log files are checked for # rotation. check_interval = 1:00:00
Apstra logs to the /var/log/aos folder under a series of files.
Apstra DC Director implements its own method of log rotation to prevent
/var/log/aos from filling up. You can enable (2) or disable
(1) log rotation. Each individual log file is rotated when it approaches the
appropriate maximum size. Log rotation occurs by default every hour.
Device Info Section
[device_info] # <model> is used to specify the device's hardware model to be reported to AOS # device manager. This is only used by servers, so can be ignored for non- # server devices such as switches. By default a server reports "Generic Model" # which matches a particular HCL entry's selector::model value in AOS. Specify # another model for the server to be classified as a different HCL entry. model = Generic Model
model
The device info section is used to modify the default device model of servers
as they register to Apstra DC Director. For example, Server
2x10G changes the server to a dual-attached L3 server. All
valid options for model include:
- Generic Model
- Server 2x10G
- Server 1x25G
- Server 1x40G
- Server 4x10G
Device Profile Section
# <device_profile_id> is used to specify the device profile to be associated to # the device. Selector in the specified device profile should match the # reported device facts. device_profile_id = [credential] username = admin