Installation and Configuration Guide - CiscoWorks 1030 WLSE Express, 2.11 - Configuration File Reference [CiscoWorks Wireless LAN Solution Engine (WLSE) Express]

Configuration File Reference

Configuration File Components

DTD File

Example .xml File

Tags and Attributes in the .xml File

Configuration File Reference

This appendix provides information on WLSE configuration files.

•Components of the configuration file—See Configuration File Components

•Parameters that can be saved in the .xml file—See Tags and Attributes in the .xml File

Configuration File Components

The WLSE configuration file consists of the following files:

•A binary .dat file, which contains the AP configuration template settings (except for custom commands)

•An editable .xml file, which contains most of the saved parameters—See Example .xml File

•A .info file

Also included in this appendix is the DTD file—See DTD File.

DTD File

The following DTD file defines the parameters that can appear in the .xml file. Special characters after names indicate how many instances are permitted:


none	1 time
?	0 or 1 times
*	0 to many times
+	1 or more times

<?xml version="1.0" encoding="UTF-8"?>

<!ELEMENT StartupConfig (Faults?, Devices?, APConfiguration?, Administration?, 
APLocations?, RMConfiguration?) >

<!ATTLIST StartupConfig

	version CDATA "3.0"

	model (1030|1130) "1030"

	configId CDATA "0"

<!ELEMENT Faults (NotificationSettings?, FaultPolicy*, FaultThreshold*, AAAServerInfo*) >

<!ELEMENT NotificationSettings (TrapNotification*, SyslogNotification*, 
EmailNotification*) >

<!ATTLIST NotificationSettings

	format (PlainText|XML) "XML"

<!ELEMENT TrapNotification EMPTY >

<!ATTLIST TrapNotification

	host CDATA #REQUIRED

	port CDATA "162"

	community CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

<!ELEMENT SyslogNotification EMPTY >

<!ATTLIST SyslogNotification

	host CDATA #REQUIRED

<!ELEMENT EmailNotification EMPTY >

<!ATTLIST EmailNotification

	address CDATA #REQUIRED

	priority (P1|P2|P3|P4|P5|OK) #REQUIRED

<!ELEMENT FaultPolicy (FSMState+, FSMStateTransition*)>

<!ATTLIST FaultPolicy

	name CDATA #REQUIRED

	type CDATA #REQUIRED

	enabled (YES|NO) "YES"

	pollFrequencyInSeconds CDATA #REQUIRED

<!ELEMENT FSMState EMPTY>

<!ATTLIST FSMState

	name CDATA #REQUIRED

	severity (P1|P2|P3|P4|P5|OK) #REQUIRED

<!ELEMENT FSMStateTransition EMPTY>

<!ATTLIST FSMStateTransition

	fromState CDATA #REQUIRED

	toState CDATA #REQUIRED

	parameters CDATA #REQUIRED

	formula CDATA #REQUIRED

	formulaType (numeric|string-in|string-equals|string-like) #REQUIRED

<!ELEMENT FaultThreshold (FSMRange+)>

<!ATTLIST FaultThreshold

	name CDATA #REQUIRED

	type CDATA #REQUIRED

	enabled (YES|NO) "YES"

	pollFrequencyInSeconds CDATA #REQUIRED

<!ELEMENT FSMRange EMPTY>

<!ATTLIST FSMRange

	stateName CDATA #REQUIRED

	fromRange CDATA #REQUIRED

	toRange CDATA #REQUIRED

	fromComparator CDATA #REQUIRED

	toComparator CDATA #REQUIRED

	count CDATA #REQUIRED

	severity (P1|P2|P3|P4|P5|OK) #REQUIRED

<!ELEMENT AAAServerInfo EMPTY >

<!ATTLIST AAAServerInfo

	hostNameOrIP CDATA #REQUIRED

	port CDATA #REQUIRED

	protocol (EAPMD5|LEAP|PEAP|RADIUS) #REQUIRED

	user CDATA #REQUIRED

	password CDATA #REQUIRED

	secret CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

<!ELEMENT Devices (DeviceCredentials?, Discovery?, Inventory?, Groups?) >

<!ELEMENT DeviceCredentials 
(SNMPCredentials*,HTTPCredentials*,HTTPPort*,CLICredentials*,WLCCPCredentials?) >

<!ELEMENT SNMPCredentials EMPTY >

<!ATTLIST SNMPCredentials

	ipAddressRange CDATA #REQUIRED

	readCommunity CDATA #REQUIRED

	writeCommunity CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

	timeoutSeconds CDATA "10"

	retries CDATA "1"

<!ELEMENT HTTPCredentials EMPTY >

<!ATTLIST HTTPCredentials

	ipAddressRange CDATA #REQUIRED

	user CDATA #REQUIRED

	password CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

<!ELEMENT HTTPPort EMPTY >

<!ATTLIST HTTPPort

	ipAddressRange CDATA #REQUIRED

	port CDATA "80"

<!ELEMENT CLICredentials EMPTY >

<!ATTLIST CLICredentials

	ipAddressRange CDATA #REQUIRED

	user CDATA #REQUIRED

	password CDATA #REQUIRED

	enableUser CDATA #REQUIRED

	enablePassword CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

<!ELEMENT WLCCPCredentials EMPTY >

<!ATTLIST WLCCPCredentials

	user CDATA #REQUIRED

	password CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

<!ELEMENT Schedule EMPTY >

<!ATTLIST Schedule

	enabled (YES|NO) "YES"

	repeatIntervalInMinutes CDATA #REQUIRED

<!ELEMENT Discovery (Schedule, CDPDiscovery?) >

<!ATTLIST Discovery

	displayNameFormat CDATA "%dns%"

	reverseDNSLookup (YES|NO) "NO"

	autoManage (YES|NO) "YES"

<!ELEMENT CDPDiscovery (CDPSeed*) >

<!ATTLIST CDPDiscovery

	cdpDistance CDATA "1"

<!ELEMENT CDPSeed EMPTY >

<!ATTLIST CDPSeed

	ipAddress CDATA #REQUIRED

<!ELEMENT Inventory (FullInventory?, ClientInventory?, PerformanceInventory?, 
APRebootDetection?, AggregationSettings?, SystemSettings?, ClientTrackingSettings?)>

<!ELEMENT FullInventory (Schedule) >

<!ELEMENT ClientInventory (Schedule) >

<!ELEMENT PerformanceInventory (Schedule) >

<!ELEMENT APRebootDetection EMPTY >

<!ATTLIST APRebootDetection

	repeatIntervalInMinutes CDATA #REQUIRED

<!ELEMENT AggregationSettings EMPTY >

<!ATTLIST AggregationSettings

	daysToKeepHourlyData CDATA "7"

	daysToKeepDailyData CDATA "30"

	daysToKeepWeeklyData CDATA "180"

	daysToKeepMonthlyData CDATA "365"

<!ELEMENT SystemSettings EMPTY >

<!ATTLIST SystemSettings

	daysToKeepJobHistoryData CDATA "30"

	daysToKeepFaultHistoryData CDATA "30"

<!ELEMENT ClientTrackingSettings EMPTY >

<!ATTLIST ClientTrackingSettings

	enabled (YES|NO) "YES"

<!ELEMENT APConfiguration (ConfigTemplate*, StartupTemplate*, AutoTemplates?)>

<!ELEMENT ConfigTemplate (SupportedDevice*, IOS*) >

<!ATTLIST ConfigTemplate

	name CDATA #REQUIRED

	description CDATA #IMPLIED

	type CDATA "IOS"

	configFile CDATA #IMPLIED

	customConfigFile CDATA #IMPLIED

<!ELEMENT SupportedDevice EMPTY>

<!ATTLIST SupportedDevice

	deviceType CDATA #REQUIRED

	versions CDATA #REQUIRED

<!ELEMENT IOS EMPTY >

<!ATTLIST IOS

	command CDATA #REQUIRED

<!ELEMENT StartupTemplate EMPTY >

<!ATTLIST StartupTemplate

	name CDATA #REQUIRED

	configTemplateName CDATA #REQUIRED

	description CDATA #IMPLIED

	writeToNVRAM (YES|NO) "NO"

<!ELEMENT AutoTemplates (AutoTemplate*, AutoTemplateOptions?) >

<!ELEMENT AutoTemplate 
(DeviceSerialNumberRule?|DeviceMACRule?|(DeviceTypeRule?,DeviceSubnetRule?,DeviceVersionRu
le?))>

<!ATTLIST AutoTemplate

	name CDATA #REQUIRED

	configTemplateName CDATA #REQUIRED

	description CDATA #IMPLIED

	enabled (YES|NO) "YES"

	writeToNVRAM (YES|NO) "NO"

<!ELEMENT DeviceSerialNumberRule (DeviceSerialNumber+) >

<!ELEMENT DeviceMACRule (DeviceMAC+) >

<!ELEMENT DeviceTypeRule (DeviceType+) >

<!ELEMENT DeviceSubnetRule (DeviceSubnet+) >

<!ELEMENT DeviceVersionRule (DeviceVersion+) >

<!ELEMENT DeviceSerialNumber (#PCDATA) >

<!ELEMENT DeviceMAC (#PCDATA) >

<!ELEMENT DeviceType (#PCDATA) >

<!-- DeviceType ("AP 1100"|"AP 1200"|"AP 1210"|"AP 340"|"AP 350"|"AP 350-IOS"|"BR 
1310"|"BR 1410"|"AP 1210-SR")-->

<!ELEMENT DeviceSubnet (#PCDATA) >

<!ELEMENT DeviceVersion (#PCDATA) >

<!ELEMENT AutoTemplateOptions (SendEmailList?) >

<!ATTLIST AutoTemplateOptions

	IOSProtocol (SSH|TELNET) "TELNET"

<!ELEMENT SendEmailList EMPTY >

<!ATTLIST SendEmailList

	enabled (YES|NO) "YES"

	emailList CDATA #IMPLIED

<!ELEMENT Groups (RuleBasedGroup+) >

<!ELEMENT RuleBasedGroup (GroupRule+) >

<!ATTLIST RuleBasedGroup

	name CDATA #REQUIRED

	path CDATA #REQUIRED

	description CDATA #IMPLIED

<!ELEMENT GroupRule EMPTY >

<!ATTLIST GroupRule

	name CDATA #REQUIRED

	op CDATA #REQUIRED

	value CDATA #IMPLIED

<!ELEMENT Administration (Role*, User*, Redundancy?,  AAAServerConfig?, 
ApplianceSettings?, CLIBlock?, SplashScreenMessage?) >

<!ELEMENT Role (Task*) >

<!ATTLIST Role

	name CDATA #REQUIRED

	creator CDATA "admin"

<!ELEMENT Task EMPTY >

<!ATTLIST Task

	tab CDATA #REQUIRED

	subtab CDATA #REQUIRED

<!ELEMENT User (Role+) >

<!ATTLIST User

	name CDATA #REQUIRED

	password CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

	cliAccess (None|0|15) "None"

	creator CDATA "admin"

	email CDATA #IMPLIED

<!ELEMENT Redundancy EMPTY >

<!ATTLIST Redundancy

	enabled (YES|NO) "NO"

	httpPort (1741|80) #REQUIRED

	adminPassword CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

	notificationEmail CDATA #REQUIRED

	virtualIPeth0 CDATA #REQUIRED

	primaryIP CDATA #REQUIRED

	secondaryIP CDATA #REQUIRED

	minutesBetweenSync CDATA #REQUIRED

	secondsBetweenCheck CDATA #REQUIRED

<!ELEMENT AAAServerConfig (AAAClient*, AAAUser*) >

<!ELEMENT AAAClient EMPTY >

<!ATTLIST AAAClient

	name CDATA #REQUIRED

	ipAddress CDATA #REQUIRED

	secret CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

<!ELEMENT AAAUser EMPTY >

<!ATTLIST AAAUser

	name CDATA #REQUIRED

	password CDATA #REQUIRED

	isEncrypted (YES|NO) "YES"

<!ELEMENT ApplianceSettings (WLSEManager?, NTPServer*, NameServer*) >

<!ATTLIST ApplianceSettings

	telnetEnabled (YES|NO) "NO"

	sshProtocol (SSH1|SSH2|SSH1_SSH2) "SSH1"

	httpServerPort (1741|80) #REQUIRED

	webTimeoutInSeconds CDATA #REQUIRED

	mailServer CDATA #REQUIRED

<!ELEMENT WLSEManager (#PCDATA)>

<!ATTLIST WLSEManager

    protocol (HTTP|HTTPS) "HTTPS"

    httpPort CDATA "1741"

<!ELEMENT NTPServer EMPTY>

<!ATTLIST NTPServer

	server CDATA #REQUIRED

<!ELEMENT NameServer EMPTY>

<!ATTLIST NameServer

	server CDATA #REQUIRED

<!ELEMENT CLIBlock (CLI*)>

<!ELEMENT CLI EMPTY >

<!ATTLIST CLI

	command CDATA #REQUIRED

<!ELEMENT SplashScreenMessage EMPTY >

<!ATTLIST SplashScreenMessage

	enabled (YES|NO) "NO"

	message CDATA #REQUIRED

<!ELEMENT APLocations (Site+)>

<!ELEMENT RMConfiguration (RadioMonitoring?, SelfHealing?, AutoReSiteSurvey?, 
RogueAPDetection?, AdHocNetworkDetection?, UnregisteredClientMonitoring?, RMJobList?, 
InitialRMSetup?)>

<!ELEMENT FloorSelection EMPTY>

<!ATTLIST FloorSelection

	siteName CDATA #REQUIRED

	buildingName CDATA #REQUIRED

	floorName CDATA #REQUIRED

<!ELEMENT ARSSFloorSelection EMPTY>

<!ATTLIST ARSSFloorSelection

	siteName CDATA #REQUIRED

	buildingName CDATA #REQUIRED

	floorName CDATA #REQUIRED

	select11a NMTOKEN "false"

	select11b11g NMTOKEN "false"

<!ELEMENT DeviceSelection EMPTY>

<!ATTLIST DeviceSelection

	identifier CDATA #REQUIRED

	identifierType (NAME | DESCRIPTION | IP_ADDRESS | MAC_ADDRESS) #IMPLIED

<!ELEMENT DeviceSelectionList (DeviceSelection*)>

<!ATTLIST DeviceSelectionList

	includeAllAccessPoints NMTOKEN "false"

<!ELEMENT RadioInterfaceSelection EMPTY>

<!ATTLIST RadioInterfaceSelection

	select11a NMTOKEN "true"

	select11b11g NMTOKEN "true"

<!ELEMENT RMJob (RadioScan | ClientWalkAbout | RadioParameterGeneration)>

<!ATTLIST RMJob

	name CDATA #REQUIRED

	description CDATA #IMPLIED

	startDate CDATA #IMPLIED

	startTime CDATA #IMPLIED

	repeatIntervalInMinutes NMTOKEN #IMPLIED

<!ELEMENT RadioScan (DeviceSelectionList?, RadioInterfaceSelection?)>

<!ATTLIST RadioScan

	maximumTransmitPower NMTOKEN #IMPLIED

<!ELEMENT ClientWalkAbout (DeviceSelectionList?, RadioInterfaceSelection?, 
ClientMACAddressSelection)>

<!ATTLIST ClientWalkAbout

	useAPMaximumPowerSetting NMTOKEN "true"

	maximumTransmitPower NMTOKEN #IMPLIED

<!ELEMENT RadioParameterGeneration (DeviceSelectionList?)>

<!ATTLIST RadioParameterGeneration

	radioInterfaceType (11a | 11bg) #REQUIRED

	channelSet CDATA #IMPLIED

	minimumTransmitPower NMTOKEN #IMPLIED

	maximumTransmitPower NMTOKEN #IMPLIED

	ignoreRogueAccessPoints NMTOKEN "false"

	enableBlackHoleMitigation NMTOKEN "true"

	writeToNVRAMOnApply NMTOKEN "true"

<!ELEMENT ClientMACAddressSelection EMPTY>

<!ATTLIST ClientMACAddressSelection

	macAddress1 CDATA #REQUIRED

	macAddress2 CDATA #IMPLIED

	macAddress3 CDATA #IMPLIED

	macAddress4 CDATA #IMPLIED

	macAddress5 CDATA #IMPLIED

<!ELEMENT Site (Building+)>

<!ATTLIST Site

	name CDATA #REQUIRED

<!ELEMENT RadioMonitoring (ServingChannelMonitoring?, NonServingChannelMonitoring?, 
RadioInterfaceSelection?, DeviceSelectionList?)>

<!ATTLIST RadioMonitoring

	enabled (YES | NO) "YES"

	enabledForNewAccessPoints (YES | NO) "YES"

<!ELEMENT SelfHealing (FloorSelectionList?)>

<!ATTLIST SelfHealing

	enabled (YES | NO) "NO"

	faultPriority (P1 | P2 | P3 | P4 | P5) "P2"

	changeNeighborAPs NMTOKEN "true"

	minimumTimeToWait NMTOKEN #IMPLIED

<!ELEMENT AutoReSiteSurvey (ARSSFloorSelectionList?)>

<!ATTLIST AutoReSiteSurvey

	enabled (YES | NO) "NO"

	faultPriority (P1 | P2 | P3 | P4 | P5) "P1"

	threshold NMTOKEN "20"

<!ELEMENT RogueAPDetection (SwitchPortSuppression?)>

<!ATTLIST RogueAPDetection

	enabled (YES | NO) "YES"

	faultPriority (P1 | P2 | P3 | P4 | P5) "P1"

	rssiThreshold NMTOKEN "-95"

<!ELEMENT AdHocNetworkDetection EMPTY>

<!ATTLIST AdHocNetworkDetection

	enabled (YES | NO) "YES"

	faultPriority (P1 | P2 | P3 | P4 | P5) "P2"

<!ELEMENT UnregisteredClientMonitoring EMPTY>

<!ATTLIST UnregisteredClientMonitoring

	enabled (YES | NO) "YES"

	faultPriority (P1 | P2 | P3 | P4 | P5) "P2"

	requestCountThreshold (100 | 200 | 300 | 400 | 500) "100"

<!ELEMENT RMJobList (RMJob+)>

<!ELEMENT InitialRMSetup (RadioScan, (RadioParameterGeneration, RadioParameterGeneration, 
RadioParameterGeneration?))>

<!ELEMENT Building (Floor+)>

<!ATTLIST Building

	name CDATA #REQUIRED

	contact CDATA #IMPLIED

	address CDATA #IMPLIED

<!ELEMENT Floor (Device+)>

<!ATTLIST Floor

	name CDATA #REQUIRED

	width NMTOKEN #REQUIRED

	length NMTOKEN #REQUIRED

	metric (FEET | METERS) "FEET"

	imageURL CDATA #IMPLIED

<!ELEMENT Device ((Antenna, Antenna, Antenna?, Antenna?))>

<!ATTLIST Device

	identifier CDATA #REQUIRED

	identifierType (NAME | DESCRIPTION | IP_ADDRESS | MAC_ADDRESS) "NAME"

	x NMTOKEN #REQUIRED

	y NMTOKEN #REQUIRED

	z NMTOKEN #IMPLIED

<!ELEMENT Antenna EMPTY>

<!ATTLIST Antenna

	radioInterfaceType (2.4GHZ | 5GHZ) #REQUIRED

	type (AJAX-2.4GHZ | AJAX-5GHZ | AIR-ANT1728 | AIR-ANT1729 | AIR-ANT2012 | 
AIR-ANT2410Y-R | AIR-ANT3351 | AIR-ANT3549 | AIR-ANT4941 | AIR-ANT570-R | AIR-ANT5959 | 
AP1100 | BR1310 | KODIAK-DIRECTIONAL | KODIAK-OMNI | OSPREY-DIRECTIONAL | OSPREY-OMNI | 
Unspecified-2.4GHz | Unspecified-5GHz) #REQUIRED

	azimuth NMTOKEN #REQUIRED

	downtilt NMTOKEN #REQUIRED

	height NMTOKEN #IMPLIED

	cableLoss NMTOKEN #IMPLIED

<!ELEMENT ServingChannelMonitoring EMPTY>

<!ATTLIST ServingChannelMonitoring

	enableForAccessPoints (YES | NO) "NO"

	enableForClients (YES | NO) "NO"

<!ELEMENT NonServingChannelMonitoring EMPTY>

<!ATTLIST NonServingChannelMonitoring

	enableForAccessPoints (YES | NO) "NO"

	enableForClients (YES | NO) "NO"

<!ELEMENT FloorSelectionList (FloorSelection*)>

<!ATTLIST FloorSelectionList

	includeAllFloors NMTOKEN "false"

<!ELEMENT ARSSFloorSelectionList (ARSSFloorSelection*)>

<!ATTLIST ARSSFloorSelectionList

	includeAllFloors NMTOKEN "false"

<!ELEMENT SwitchPortSuppression EMPTY>

<!ATTLIST SwitchPortSuppression

	enabled (YES | NO) "NO"

	cdpHopCount NMTOKEN "1"

	skipGigabitEthernetPort NMTOKEN "false"

	skipManagedAPPort NMTOKEN "false"

	skipPortChannelingPort NMTOKEN "false"

	skipPortGroupingPort NMTOKEN "false"

	skipNonAccessPointCDPNeighbor NMTOKEN "false"

Example .xml File

An example .xml file follows.

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE StartupConfig SYSTEM "startup.dtd">

<StartupConfig>

<Faults>

      <NotificationSettings format="PlainText">

      <SyslogNotification host="sysloghost"/>

      <EmailNotification address="jim@cisco.com" priority="P2"/></Faults>

<DeviceCredentials>

      <SNMPCredentials retries="1" timeoutSeconds="9" readCommunity="public"

             writeCommunity="public">

            <IPAddressRange>*.*.*.*</IPAddressRange>

      </SNMPCredentials>

      <HTTPCredentials user="httpuser" password="httppassword">

            <IPAddressRange>10.223.3.[4-8]</IPAddressRange>

      </HTTPCredentials>

      <HTTPCredentials user="httpuser9" password="httppassword9">

            <IPAddressRange>10.2.3.[9-11]</IPAddressRange>

      </HTTPCredentials>

      <HTTPCredentials user="httpuserold" password="httppassword">

            <IPAddressRange>10.2.3.[200-220]</IPAddressRange>

      </HTTPCredentials>

      <HTTPPort port="898">

            <IPAddressRange>10.*.[11-55].*</IPAddressRange>

      </HTTPPort>

      <CLICredentials enablePassword="enablepP" user="cliP" password="userpP"

                 enableUser="enable">

            <IPAddressRange>*.*.*.*</IPAddressRange>

      </CLICredentials>

      <CLICredentials enablePassword="enableP" user="cli1O" password="userpK"

                 enableUser="enable1">

            <IPAddressRange>172.16.[7-11].*</IPAddressRange>

      </CLICredentials>

      <WLCCPCredentials user="WLCCPUSER" password="WLCCPPASSWORD"/>

</DeviceCredentials>

<Discovery displayNameFormat="%dns%(%ip%)" reverseDNSLookup="YES" autoManage="NO">

        <Schedule enabled="YES" repeatIntervalInMinutes="120"/>

        <CDPDiscovery cdpDistance="1">

            <CDPSeed ipAddress="172.20.11.101"/>

            <CDPSeed ipAddress="172.20.13.102"/>

            <CDPSeed ipAddress="172.20.13.103"/>

        </CDPDiscovery>

</Discovery>

<Inventory>

        <FullInventory>

            <Schedule enabled="YES" repeatIntervalInMinutes="720"/>

        </FullInventory>

        <ClientInventory>

            <Schedule enabled="YES" repeatIntervalInMinutes="51"/>

        </ClientInventory>

        <PerformanceInventory>

            <Schedule enabled="YES" repeatIntervalInMinutes="13"/>

        </PerformanceInventory>

        <APRebootDetection>

            <Schedule enabled="NO" repeatIntervalInMinutes="0"/>

        </APRebootDetection>

        <AggregationSettings daysToKeepMonthlyData="360" daysToKeepWeeklyData="180"

                 daysToKeepDailyData="30" daysToKeepHourlyData="7"/>

</Inventory>

<SystemSettings daysToKeepJobHistoryData="15" daysToKeepFaultHistoryData="45"/>

<AAAServerMonitoring>

        <AAAServerInfo secret="leapsecret" user="leap" port="0" password="leappassword"

               hostNameOrIP="10.2.2.2" protocol="LEAP"/>

        <AAAServerInfo secret="777S" user="777" port="0" password="777P"

               hostNameOrIP="10.7.7.7" protocol="LEAP"/>

        <AAAServerInfo secret="peapsecret" user="peap" port="0" password="peappassword"

               hostNameOrIP="10.3.3.3" protocol="PEAP"/>

        <AAAServerInfo secret="secret" user="user" port="0" password="password"

               hostNameOrIP="10.2.3.4" protocol="EAPMD5"/>

        <AAAServerInfo secret="radiussecret" user="radius" port="0"

               password="radisupassword" hostNameOrIP="10.4.4.4" protocol="RADIUS"/>

</AAAServerMonitoring>

<ClientTrackingSettings enabled="NO"/>

<ConfigurationSettings>

      <ConfigTemplate name="startup-ios" description="This is a startup template">

            <IOS>cdp run</IOS>

      </ConfigTemplate>

      <ConfigTemplate name="custom" description="this is custom template">

         <IOS>line 0 16no access-class 111 interminal-type teletypewidth 80length 40</IOS>

      </ConfigTemplate>

      <StartupTemplate name="iostartup.cfg" description="Startup file for ios APs"

                configTemplateName="startup-ios" writeToNVRAM="NO"/>

      <StartupTemplate name="forthd" description="" configTemplateName="bldg1-ap1200"

                writeToNVRAM="NO"/>

      <AutoTemplate enabled="YES" name="custom" description="MAC Address Serial Number"

                configTemplateName="ios1" writeToNVRAM="NO">

            <DeviceMACRule>

                <DeviceMAC>111213141516</DeviceMAC>

                <DeviceMAC>111213141517</DeviceMAC>

            </DeviceMACRule>

            <DeviceSerialNumberRule>

                <DeviceSerialNumber>abcdef34343</DeviceSerialNumber>

                <DeviceSerialNumber>abcdef34346</DeviceSerialNumber>

       </AutoTemplate>

      <AutoTemplate enabled="NO" name="auto4" description="Various"

                     configTemplateName="startup-ios" writeToNVRAM="YES">

            <DeviceTypeRule>

                <DeviceType>AP 350</DeviceType>

                <DeviceType>BR 1310</DeviceType>

            </DeviceTypeRule>

            <DeviceSubnetRule>

                <DeviceSubnet>192.168.98.0</DeviceSubnet>

                <DeviceSubnet>172.20.110.64</DeviceSubnet>

            </DeviceSubnetRule>

            <DeviceVersionRule>

                <DeviceVersion>12.02T1</DeviceVersion>

                <DeviceVersion>12.2(13)JA1</DeviceVersion>

            </DeviceVersionRule>

       </AutoTemplate>

       <AutoTemplateOptions>

            <SendEmailList enabled="YES">arora@abc.com, viking@thor.net</SendEmailList>

       </AutoTemplateOptions>

</ConfigurationSettings>

<Redundancy secondsBetweenCheck="16" adminPassword="admin" httpPort="1741" enabled="YES"

    primaryIP="192.168.98.107" notificationEmail="yushu@cisco.com"

    virtualIPeth0="192.168.98.109" minutesBetweenSync="15" secondaryIP="192.168.98.108" />

<Appliance>

    <SplashScreenMessage enabled="YES">Welcome to WLSE Express</SplashScreenMessage>

</Appliance>

<Users>

    <User isEncrypted="YES" email="admin@abc.com"

           password="$1$d3niWPWT$DVQKhU40t09s2qRqhACf21" name="admin" creator="admin"

           cliAccess="15">

    <Role name="System Admin" />

    </User>

    <User isEncrypted="YES" email="kim@jungle.com"

           password="$1$Gg9oWPWT$hyC5V99JbIOUpgW/Tk9uI1" name="kim" creator="admin"

           cliAccess="0" />

    <Role name="Help Desk" />

    <User isEncrypted="YES" email="hedwig@hogwarts.com"

           password="$1$eNfyAFGH$mTPJ10ervL3Z/9jhHU.hf." name="hedwig" creator="admin"

           cliAccess="None">

    <Role name="familiar"/>

    </User>

</Users>

<CLIBlock>

    <CLI>http-server port 1741</CLI>

    <CLI>hostname thishostname</CLI>

    <CLI>mailroute mailer.abc.com</CLI>

    <CLI>snmp-server location london</CLI>

    <CLI>snmp-server contact snape</CLI>

    <CLI>import host wlseexpress 198.71.131.209</CLI>

</CLIBlock>

</StartupConfig>

Tags and Attributes in the .xml File

This section provides information about all of the tags that are permitted in a configuration .xml file. See the online help or the User Guide for the CiscoWorks Wireless LAN Solution Engine, Release 2.11 for details on these parameters.

Use this information along with the example .xml file and DTD file.

Table A-1 Configuration File Tags
Tag	Attributes	Description and UI Reference
StartupConfig		Container for configuration parameters
Faults		Container for fault notification settings
NotificationSettings	format	Message format: plainText or XML	Faults > Notification Settings
TrapNotification	host	SNMP trap receiver
	port	Port on trap receiver
	community	Community string
SyslogNotification	host	Syslog server(s)
EmailNotification	address	User(s) receiving fault notifications
EmailNotification	priority	Priority of faults to be mailed
Discovery		Container for discovery settings
Discovery (Schedule)	enabled	Enable/disable repeat discoveries	Devices > Discover > Discovery Wizard
Discovery (Schedule)	repeatInvervalInMinutes	Repeat interval for scheduled discoveries
CDPDiscovery	cdpDistance	CDP distance
CDPSeed	ipAddress	Address of discovery seed device
DeviceCredentials		Container for credentials
SNMPCredentials (IPAddressRange	(IP address)	IP addresses of devices using this community	Devices > Discover > Device Credentials > SNMP Communities
SNMPCredentials	readCommunity	Read-only community
	writeCommunity	Read/write community
	timeoutSeconds	SNMP timeout
HTTPCredentials (IPAddressRange)	(IP address or range)	IP addresses of devices using this user and password.	For configuring non-IOS APs Devices > Discover > Device Credentials > HTTP User/Password
HTTPCredentials	user	Username
HTTPCredentials	password	User password
HTTPPort (IPAddressRange)	(IP address or range)	IP address of devices using this port	Devices > Discover > Device Credentials > IOS HTTP Port Settings
HTTPPort	port	Port for links to IOS APs from reports
DeviceCredentials (continued)		Container for credentials
CLICredentials (IPAddressRange)	(IP address or range)	IP addresses of devices with these credentials	Credentials for uploading configuration and firmware to IOS APs Devices > Discover > Device Credentials > Telnet/SSH User/Password
CLICredentials	user	Telnet/SSH username
	password	Telnet/SSH password
	enableUser	Telnet/SSH enable username
	enablePassword	Telnet/SSH enable password
WLCCPCredentials	user	RADIUS username for WDS	Devices > Discover > Device Credentials > WLCCP Credentials
WLCCPCredentials	password	RADIUS password
Inventory		Container for inventory settings
FullInventory (Schedule)	enabled	Enable/disable repeat polling	Devices > Inventory > Polling
FullInventory (Schedule)	repeatIntervalInMinutes	Polling interval	Devices > Inventory > Polling
ClientInventory (Schedule)	enabled	Enable/disable repeat polling	Devices > Inventory > Polling
ClientInventory (Schedule)	repeatIntervalInMinutes	Polling interval	Devices > Inventory > Polling
PerformanceInventory (Schedule)	enabled	Enable/disable repeat polling	Devices > Inventory > Polling
PerformanceInventory (Schedule)	repeatIntervalInMinutes	Polling interval	Devices > Inventory > Polling
APRebootDetection	repeatIntervalInMinutes	Polling interval for AP reboot detection	Not in the UI
Inventory (continued)		Container for inventory settings
AggregationSettings	daysToKeepHourlyData	How long to keep data for reports	Devices > Inventory > Polling
	daysToKeepDailyData
	daysToKeepWeeklyData
	daysToKeepMonthlyData
SystemSettings	daysToKeepJobHistoryData	How long to keep job and fault history	Devices > Inventory > Polling
SystemSettings	daysToKeepFaultHistoryData	How long to keep job and fault history	Devices > Inventory > Polling
AAAServerMonitoring		Container for AAA server monitoring
AAAServerInfo	hostNameOrIP	AAA server	AAA servers to be monitored by the WLSE Devices > Discover > AAA Server-
	port	Port used for authentication
	protocol	Authentication protocol
	user	Client username
	password	Client password
	secret	Shared secret
ClientTracking Settings	enabled	Enable/disable advanced client tracking for all WDS devices	Devices > Discover > Client Tracking
ConfigurationSettings		Container for AP configuration
ConfigTemplate	name	Template name	Configure > Templates
ConfigTemplate	description	Template description
ConfigTemplate (IOS)	IOS commands	Custom commands in the template
ConfigurationSettings (continued)		Container for AP configuration
Startup Template	name	Name of bootfile associated with the startup template	Configuration template for newly installed APs Configuration > Templates > Auto Update > Startup Configuration
	configTemplateName	Name of template
	description	Description of template
	writeToNVRAM	Whether to write configuration to NVRAM
AutoTemplate		Container for assigning templates for auto-managed configuration
AutoTemplate	name	Name of auto-managed configuration	Configure > Templates > Auto-Update > Auto-Managed Configuration > Assign Templates
	configTemplateName	Name of template
	description	Description of template
	enabled	Enable/disable application of template to matching devices
	writeToNVRAM	Write configuration to NVRAM
AutoTemplate (continued)		Container for assigning templates for auto-managed configuration
DeviceMACRule (DeviceMAC)	Container for MAC addresses	Matching rules for apply templates to auto-managed APs	Configure > Templates > Auto-Update > Auto-Managed Configuration > Assign Templates
DeviceTypeRule (DeviceType)	Container for device types
DeviceSubnetRule (DeviceSubnet)	Container for subnets
DeviceVersionRule (Device Version)	Container for firmware version
DeviceSerialNumberRule (DeviceSerialNumber)	Container for serial number
AutoTemplateOptions		Container for auto-managed configuration options
	IOSProtocol	Use SSH or Telnet	Not in the UI
SendEmailList	enabled	Enable/disable email on results of auto-configuration	Configure > Templates > Auto-Update > Auto-Managed Configuration > Auto-Managed Options
Redundancy	enabled	Enable/disable redundancy	Settings for redundant WLSEs Administration > Appliance > Redundancy
	httpPort	HTTP port on both systems
	adminPassword	Admin password on both systems
	notificationEmail	Address for notifications
	virtualIPeth0	Virtual IP address of ethernet port
	primaryIP	Static IP address of primary system
	secondaryIP	Static IP address of secondary system
	minutesBetweenSync	Synchronization interval
	secondsBetweenCheck	How often standby checks status of primary system
Appliance		Container for Administration > Appliance settings
SplashScreenMessage	enabled	Enable/disable logon message	Administration > Appliance > Splash Screen
Users		Container for users
User (Role)	name	Name(s) of role(s) assigned to user	User accounts on WLSE Administration > User Admin > Manage Users
User	name	Username
	password	Password
	cliAccess	CLI access privileges
	creator	User who created this account
	email	Email address of user
CLIBlock		Container for WLSE CLI commands
CLIBlock(CLI)	(WLSE CLI commands)	Any CLI command for setting appliance parameters. You can use this section to set parameters that cannot be saved in the configuration files from the UI.

Table Of Contents

Configuration File Reference

Configuration File Components

DTD File

Example .xml File

Tags and Attributes in the .xml File