Managing Switch Variable Files
The variable files consist of a set of configuration values defined for devices in the network.
Before creating or uploading a variable file, note the following points:
- The variable names must be on the left side of condition and its value must be defined on the right side. For example, %if var=100% is supported and %if 100=var% is not supported.
- The < or <= or > or >= operators should have only numeric integer value on the right side. The variables used in these 4 operations are compared as integer after flooring. For example, if any float value is set as %if dpi_value > 2.8%, it is converted as %if dpi_value > 2 for comparison.
- The variable names should not include white space, and the and special characters. The variable names must match regular expression [a-zA-Z0-9_]. If the variables values with are defined, ensure that the variable is surrounded by space.
- The first character of the variable name must be an alphabet. Numeric values are not accepted.
- The values defined for the variable must not include spaces. If quotes are required, they must be included as part of the variable value. For example, if the intended template and variable name is wlan ssid-profile "emp ssid”, the template must be defined template as "wlan ssid-profile %ssid_name%” and variable as “ssid_name”: "\"emp ssid\"".
- If the configuration text has the percentile in it—for example, —Aruba Central treats it as a variable when you save the template. To allow the use of percentile as an escape character, use in the variable definition as shown in the following example:wlanWireless Local Area Network. WLAN is a 802.11 standards-based LAN that the users access through a wireless connection. external-captive portalA captive portal is a web page that allows the users to authenticate and sign in before connecting to a public-access network. Captive portals are typically used by business centers, airports, hotel lobbies, coffee shops, and other venues that offer free Wi-Fi hotspots for the guest users. "Splash Profile 1_#guest#_" server naw1.cloudguest.central.arubanetworks.com port 443 urlUniform Resource Locator. URL is a global address used for locating web resources on the Internet. %url%
"url": "\"/portal/scope.cust-5001098/Splash%20Profile%201/capture\""
Predefined Variables for Aruba Switches
Although all Aruba Switches can be configured by using common configuration templates, the configuration of these switches may need to change per device. Aruba Central uses the predefined variables to address the per device configuration requirements.
Aruba Central parses a set of predefined variables from the running configuration of the switches and identifies these as the variables per device. All the pre-defined variables are prefixed by .
The following is the list of predefined variables used for configuring switches.
- —Represents the first two lines of the configuration file. Ensure that this variable is the first line in the template.
- —Populates engine ID.
- —Populates module lines.
- —Populates gateway IP address.
- —Maintains unique host name.
- —Represents Out of BandBand refers to a specified range of frequencies of electromagnetic radiation. Management (OOBM) block.
- —Indicates the IP address of the device.
- —Netmask of the device.
- —DHCPDynamic Host Configuration Protocol. A network protocol that enables a server to automatically assign an IP address to an IP-enabled device from a defined range of numbers configured for a given network. status (true or false) of VLANVirtual Local Area Network. In computer networking, a single Layer 2 network may be partitioned to create multiple distinct broadcast domains, which are mutually isolated so that packets can only pass between them through one or more routers; such a domain is referred to as a Virtual Local Area Network, Virtual LAN, or VLAN. 1.
- —Untagged ports of VLAN 1.
- — Represents stack block.
The and are mandatory variables that must have the values populated, irrespective of their use in the template. If there is no value set for these variables, Aruba Central re-imports the values for these mandatory variables when it processes the running configuration of the device.
Example
The following table provides an example for the predefined variable definitions:
|
Variable Name |
Variable Value |
|---|---|
|
|
oobm ip address dhcp-bootp exit |
|
|
; J9729A Configuration Editor; Created on release #WB.16.03.0003+ ; Ver #0f:3f.f3.b8.ee.34.79.3c.29.eb.9f.fc.f3.ff.37.ef:91 |
|
|
HP-2920-48G-POEP |
|
|
10.22.159.1 |
|
|
1-28,A1-A2 |
|
|
10.22.159.201 |
|
|
0 |
|
|
module 1 type j9729a |
|
|
stacking member 1 type "J9729A" mac-address 5cb901-224c00 exit |
|
|
28-48 |
|
|
255.255.255.0 |
|
|
00:00:00:0b:00:00:5c:b9:01:22:4c:00 |
Downloading Sample Variables File
Aruba Central supports dowloading and uploading variables in the JSONJavaScript Object Notation. JSON is an open-standard, language-independent, lightweight data-interchange format used to transmit data objects consisting of attribute–value pairs. JSON uses a "self-describing" text format that is easy for humans to read and write, and that can be used as a data format by any programming language. and CSVComma-Separated Values. A file format that stores tabular data in the plain text format separated by commas. file formats.
To download a sample variables file:
- From the app selector, click .
- To download a sample variables file for the group, select a template group to which the switches are assigned.
- To download a sample variables file for a device, select the switch from the filter bar.
- Select any of the following format:
- JSON
- CSV
- Click .
Uploading Variable Files
To upload a variable file, complete the following steps:
- Click . Save the JSON file with the sample variables.
- Edit the variable file to customize the definitions.
- Ensure that the and variables are defined with the serial number and MACMedia Access Control. A MAC address is a unique identifier assigned to network interfaces for communications on a network. address of the devices, respectively.
- Click > > . The page opens.
- Click and select the variable file to upload.
- Click . The content of the variable file is displayed in the table.
- To search for a variable, specify a search term and click the Search icon.
Downloading Variable Files
To download the variable file applied for the devices, click the download icon in the table.
