|
|
|
|
Updates configuration information for one or more existing devices. If deviceSerial and deviceName are both given, then the device name is updated.
To change the IP address of a host, you must specify the new IP address in the newaddress parameter. An error is generated if more than one host matches the search criteria while changing the IP address.
For rediscovery options, specify the rediscovery frequency in minutes. 720 (or 12 hours) is the minimum value accepted by the system.
You can use the device.update command to enable rediscovery for one or more devices using the rediscoveryEnabled=true parameter. If you do not specify action and frequency parameters, department/global defaults values are used. If you specify action and frequency parameters without the rediscoveryEnabled parameter, only devices that already have rediscovery enabled are affected by the action and frequency parameters.
device.update <"deviceName=<regexp>" | "deviceSerial=<value>" |
[, "newaddress=<ip_addr>"]
[, "snmpCid=<new_value>"]
[, "comment=<new_value>"]
[, "deviceType=<nt|windows|unix|linux|solaris|vmware|xen|hyperv|router|switch|firewall|slb|proxy|san|nas|vpnc|printer|wireless|other>"]
[, "parentNames=<new_value,new_value,..>"]
[, "clearOnOk=<true|false>"]
[, "smartNotify=<true|false>"]
[, "showOnSummary=<true|false>"]
[, "tag1=<string>", "tag2=<string>", ... ,"tag5=<string>"]
[, rediscoveryEnabled=<true|false>]
[, rediscoveryNewTestsAction=<logOnly|updateAndLog|ignore>]
[, rediscoveryUpdatedTestsAction=<logOnly|updateAndLog|ignore>]
[, rediscoveryDeletedTestsAction=<logOnly|updateAndLog|ignore>]
[, rediscoveryFrequency=<new_value>]
Examples:
To change the name of a device, you have to use the deviceSerial as the match, so first find the serial number.
device.List "deviceName=[MyOldDevice]"
device.update "deviceSerial=12345" "deviceName=myNewName"
To change the IP address, you should set the newAddress value, not the IPaddress.
This following example changes the rediscoveryUpdatedTestsAction and rediscoveryFrequency for devices that have rediscovery enabled using in the web application. The other fields remain unchanged and devices with rediscovery disabled are not affected.
device.update "deviceName=*", "rediscoveryUpdatedTestsAction=updateAndLog","rediscoveryFrequency=100000"
Setting Default SNMP Query Optimization
Note: You can enable/disable SNMP Query Optimization when you create SNMP tests. See the Traverse User Guide for more information on the SNMP monitor and query optimization.You can specify the default setting for SNMP Query Optimization with the device.update command and snmpOptimize=<0|1>.
When enabled, SNMP Query Optimization increases the performance and efficiency of the SNMP monitor and reduces Traverse-initiated network communications.
When disabled, the DGE to stops grouping SNMP queries targeted for that device in a single packet. Each test is executed through a new UDP packet with a single SNMP GET request. This allows Traverse to monitor older devices that are unable to process multiple queries in a single request, or devices that restrict packet sizes. Disabling SNMP Query Optimization adversely affects overall scalability and should only be done when absolutely necessary.
Enter:
device.update "devicename=LAN Switch (1-6 Net)", "snmpOptimize=0"
OK 201 1 [NetworkDevice](s) updated.
1 enables optimization and 0 disables optimization. device.list output indicates the setting:
device.list "devicename=LAN Switch (1-6 Net)"
OK 203 request accepted, records returned: 1
"serialNumber=270019", "deviceName=LAN Switch (1-6 Net)",
"address=10.1.6.1", "snmpCid=public", "snmpPort=161", "snmpVersion=2",
"snmpOptimize=0", [...]